CHelper Functions
Original Bizagi title: Low-code Process Automation > Studio Cloud - Authoring environment > Bizagi Studio > Process wizard > Business Rules > Bizagi Functions > CHelper Functions
اتوماسیون فرایند Low-code / محیط طراحی Studio Cloud / Bizagi Studio / Wizard فرایند / Ruleهای کسبوکار / قواعد کسبوکار / Bizagi Functions / توابع Bizagi / CHelper Functions
نمای کلی
CHelper شیئی است که مجموعهای از تابعها را برای انجام عملیات یا دریافت اطلاعات غیر وابسته به context در خود دارد. غیر وابسته به context یعنی این تابعها الزاماً به پرونده یا عنصر BPMN محل اجرای قاعده مربوط نیستند. بنابراین میتوانید روی دو عدد عملیات انجام دهید یا از عناصر دیگر پروژه اطلاعات بگیرید.
Bizagi Business Rules API را ببینید
جدول زیر تابعهای مختلفی را نشان میدهد که میتوانید در شیء CHelper پیدا کنید.
| تابع | توضیح | نحو استفاده |
|---|---|---|
|
پروندهها و پروندههای مرتبط با آنها، شامل پروندههای همسطح، فرزند و والد، را لغو میکند. |
CHelper.abortProcess(Me, CaseId, AbortOption, AbortReason) |
|
|
سندهای موجود در یک آرایه فایل را بسته به تابع انتخابشده، در یک سند PDF یا Word ادغام میکند. |
CHelper.ConcatDocumentsFromFilesArrayToPDF(filesArray)
Word CHelper.ConcatDocumentsFromFilesArrayToWord(filesArray) |
|
|
سندهای موجود در دو XPath متفاوت را بسته به تابع انتخابشده، در یک سند PDF یا Word ادغام میکند. |
CHelper.ConcatDocumentsFromTwoXpathsToPDF(Me, Xpath1, Xpath2)
Word CHelper.ConcatDocumentsFromTwoXpathsToWord(Me, Xpath1, Xpath2) |
|
|
سندهای موجود در یک XPath را بسته به تابع انتخابشده، در یک سند PDF یا Word ادغام میکند. |
CHelper.ConcatDocumentsFromXpathFileToPDF(Me, XPath)
Word CHelper.ConcatDocumentsFromXpathFileToWord(Me, XPath) |
|
|
یک تاریخ در UTC+0، یعنی زمان سرور، را به تاریخ و زمان متناظر در time zone کاربر تبدیل میکند. |
CHelper.ConvertServerTimetoUserTime(idUser, serverTime) |
|
|
یک مقدار date-time مرتبط با time zone کاربر را به زمان سرور، یعنی UTC+0، تبدیل میکند. |
CHelper.ConvertUserTimetoServerTime(idUser, Date) |
|
|
یک تاریخ در UTC+0، یعنی زمان سرور، را به تاریخ متناظر در time zone مشخصشده تبدیل میکند. |
CHelper.ConvertServerTimeToTimeZoneTime("sTimeZoneName", serverTime) |
|
|
یک مقدار date-time را از time zone مشخصشده به زمان سرور، یعنی UTC+0، تبدیل میکند. |
CHelper.ConvertTimeZoneTimeToServerTime(st"sTimeZoneName", timeZoneTime): |
|
|
شمارشs the number of elements of an Entity. |
CHelper.entityListشمارش("entityName", filter) |
|
|
این تابع id فعالیت غیرهمزمانی را که میخواهید فعال کنید به عنوان پارامتر میگیرد و آن را فعال میکند. |
CHelper.EnableAsynchExecution(WorkitemId) |
|
|
این تابع id کار زمانبندیشدهای را که میخواهید فعال کنید به عنوان پارامتر میگیرد و آن را فعال میکند. |
CHelper.EnableWaitJob(WaitJobId) |
|
|
این تابع همه فعالیتهای غیرهمزمان مسدودشده را بازیابی میکند. |
CHelper.GetAllStuckAsyncWorkitems() |
|
|
این تابع همه کارهای زمانبندیشده مسدودشده را بازیابی میکند. |
CHelper.GetAllStuckWaitJobs() |
|
|
همه WorkItemهایی را برمیگرداند که به یک کاربر مشخص تخصیص فعال دارند. |
CHelper.getAssignedWorkItems(Me, CaseId, CurrentAsigneeId, IncludeSubProcesses) |
|
|
مقدار یک attribute مشخص از یک رکورد مشخص در یک entity را برمیگرداند. |
CHelper.getAttrib(sEntityName, oEntityKey, sAttribName) |
|
|
اگر پارامتر برابر باشد true برمیگرداند 1 or true ، و در غیر این صورت false برمیگرداند. |
CHelper.getBoolean(value) |
|
|
شیء پرونده را بدون نیاز به context برمیگرداند. |
CHelper.getCaseById(CaseId) |
|
|
کاربرانی را که روی یک پرونده کار کردهاند به دست میآورد. |
CHelper.getCaseUsers(CaseNumber) |
|
|
زمان جاری کاربر را به دست میآورد. |
CHelper.GetCurrentTimeForUser(idUser) |
|
|
برمیگرداند the اختلاف زمانی را بر حسب دقیقه و فقط با در نظر گرفتن روزهای کاری برمیگرداند. |
CHelper.getEffectiveDuration(Me, Start, End) |
|
|
برمیگرداند the اختلاف زمانی را بر حسب دقیقه و فقط با در نظر گرفتن روزهای کاری کاربر مشخصشده برمیگرداند. |
CHelper.getEffectiveDurationForUser(i dUser , Start, End) |
|
|
مقداری را از یک Entity غیرمرتبط با Data Model به دست میآورد. |
CHelper.getEntityAttrib(Entity, ValueToReturn, filter, filterParameters) |
|
|
با دریافت یک تاریخ اولیه و یک بازه زمانی، و با در نظر گرفتن Working Time Schema، یک تاریخ برمیگرداند. |
CHelper.getEstimatedDate(Me, dtFromDate, iDuration) |
|
|
با دریافت user id، تاریخ شروع و تعداد دقیقهها، یک تاریخ برمیگرداند. |
CHelper.getEstimatedDateForUser(idUser, dtFromDate, iDuration) |
|
|
یک تاریخ را با در نظر گرفتن time schema و timezone کاربر محاسبه میکند. |
CHelper.getEstimatedDateFromUserDateTime(UserId,iDuration) |
|
|
مقدار یک attribute محلیسازیشده entity را با استفاده از زبان کاربر جاری برمیگرداند. |
CHelper.GetLocalizedValue(EntityName, AttribName, SurrogateKeyValue) |
|
|
مقدار بعدی یک sequence را به دست میآورد. |
CHelper.GetNextSeqValueStr("SequenceName") |
|
|
مقدار یک پارامتر سفارشی را به دست میآورد. |
CHelper.getParameterValue(parameterName) |
|
|
شناسه والد یک فرایند فرزند را بدون نیاز به context بازیابی میکند. |
CHelper.getParentProcessId(caseId, wfclassName) |
|
|
شناسههای فرایندهای همسطح یک فرایند مشخص را به دست میآورد؛ یعنی Sub-Processهایی که Process والد یکسان دارند. |
CHelper.getSiblingProcessesId(Me, WfClassName) |
|
|
با دریافت یک تاریخ اولیه و یک بازه زمانی، و با در نظر گرفتن Working Time Schema و تعطیلات، یک تاریخ برمیگرداند. |
CHelper.getSolutionDate(Me, dtFromDate, iDuration) |
|
|
با دریافت user id، تاریخ شروع و تعداد دقیقهها، یک تاریخ برمیگرداند و Working Time Schema و تعطیلات کاربر را در نظر میگیرد. |
CHelper.getSolutionDateForUser(idUser, dtFromDate, iDuration) |
|
|
مقدار ذخیرهشده در یک شیء Extended را بازیابی میکند. |
CHelper.GetStringExtended("ExtendedObjectName", Default value, Culture) |
|
|
شناسه همه فرایندهای فرزند را به دست میآورد. |
CHelper.getSubProcessesId(Me) |
|
|
شناسه همه فرایندهای فرزند مشخصشده را به دست میآورد. |
CHelper.getSubProcessesId(Me, WfClassName) |
|
|
فهرستی از کاربرانی را به دست میآورد که یک Position مشخص را در سازمان دارند. |
CHelper.getUsersForPosition(posName) |
|
|
اگر پارامتر "filterActive" برابر true باشد، فهرستی از کاربران فعالی را به دست میآورد که یک Position مشخص را در سازمان دارند. |
CHelper.getUsersForPosition(posName, filterActive) |
|
|
فهرستی از کاربرانی را به دست میآورد که یک Role مشخص را در سازمان دارند. |
CHelper.getUsersForRole(roleName) |
|
|
اگر پارامتر true باشد، فهرستی از کاربران فعالی را به دست میآورد که یک Role مشخص را در سازمان دارند. |
CHelper.getUsersForRole(roleName, filterActive) |
|
|
فهرستی از کاربرانی را به دست میآورد که یک Skill مشخص را در سازمان دارند. |
CHelper.getUsersForSkill(skillName) |
|
|
اگر پارامتر true باشد، فهرستی از کاربران فعالی را به دست میآورد که یک Skill مشخص را در سازمان دارند. |
CHelper.getUsersForSkill(skillName, filterActive) |
|
|
اختلاف time zone یک location با زمان سرور، یعنی UTC+0، را بر حسب دقیقه برمیگرداند. |
CHelper.GetOffsetForLocation(idLocation) |
|
|
اختلاف time zone یک organization با زمان سرور، یعنی UTC+0، را بر حسب دقیقه برمیگرداند. |
CHelper.GetOffsetForOrganization(idOrganization ) |
|
|
اختلاف time zone تعریفشده برای یک کاربر مشخص با زمان سرور، یعنی UTC+0، را بر حسب دقیقه برمیگرداند. |
CHelper.GetOffsetForUser(idUser) |
|
|
اختلاف بین time zone تعریفشده در WorkingTimeZone key و زمان سرور، یعنی UTC+0، را بر حسب دقیقه برمیگرداند. |
CHelper.GetOffsetForWorkingTimeZone() |
|
|
برای نام entity مربوط به Persona دادهشده، آرایهای از شیءهای Persona برمیگرداند. |
CHelper.GetUsersForPersona("PersonaName") |
|
|
همه Personaهای یک کاربر مشخص را به دست میآورد. |
GetPersonasForUser("User Id") GetPersonasForUser("User Id","PersonaName") |
|
|
schema از پیش تعریفشده هر entity را مطابق پیکربندی انجامشده در Bizagi Studio به دست میآورد. |
CHelper.getXSD(entityName, xsdName) |
|
|
فایل transformation از پیش تعریفشدهای را که برای یک entity ثبت کردهاید، مطابق پیکربندی Bizagi Studio، به دست میآورد. |
CHelper.getXSL(entityName, xslName) |
|
|
به کاربر دادهشده برای پرونده دادهشده دسترسی اعطا میکند. |
CHelper.GrantCaseAccess(idCase, idUser) |
|
|
برمیگرداند اگر شیء مشخصشده به عنوان پارامتر خالی باشد true، و در غیر این صورت false برمیگرداند. |
CHelper.IsEmpty(Variable) |
|
|
برمیگرداند true if the object specified as parameter is null; otherwise, returns false. |
CHelper.IsNull(Variable) |
|
|
بررسی میکند که یک Date روز کاری است یا نه. |
CHelper.IsWorkingDay(Me,Date) |
|
|
بررسی میکند که یک Date برای کاربر مشخص روز کاری است یا نه. |
CHelper.IsWorkingDayForUser(idUser, Date) |
|
|
برمیگرداند true if a specific date falls under the organization's working time schema; otherwise, it returns false. |
CHelper.IsWorkingMinute(Me, Date) |
|
|
برمیگرداند true if a specific date falls under the given user's working time schema; otherwise, it returns false. |
CHelper.IsWorkingMinuteForUser(idUser, Date) |
|
|
برمیگرداند the id of the next user available for assignment by load. |
CHelper.LoadAssig(AssigneeList, Me) |
|
|
یک پرونده جدید با کاربر ایجادکننده تعریفشده ایجاد میکند. |
CHelper.NewCase(idUser,WFClassName) |
|
|
بر اساس اطلاعات ارائهشده در پارامتر ورودی، یعنی رشته XML، یک پرونده جدید ایجاد میکند. |
CHelper.NewCase(XML) |
|
|
یک activity را اجرا میکند؛ معادل فشار دادن دکمه NEXT است. |
CHelper.PerformActivity(XML_ActivityInfo) |
|
|
یک cancellation ایجاد میکند و فایل log مربوط به cancellation را اضافه میکند. |
CHelper.RaiseCancelIntermediateEvent(message) |
|
|
activity جاری را متوقف میکند و مسیر عادی را به سمت مسیر خطا منحرف میکند. این تابع یک فایل log خطا اضافه میکند. |
CHelper.RaiseErrorIntermediateEvent(message) |
|
|
Sub-Process تراکنشی را متوقف میکند و مسیر عادی را به سمت مسیر cancel منحرف میکند. |
CHelper.RaiseCancelEndEvent(message) |
|
|
Sub-Process تراکنشی را متوقف میکند و مسیر عادی را به سمت مسیر خطا منحرف میکند. |
CHelper.RaiseErrorEndEvent(message) |
|
|
مقدار seed یک sequence را با دریافت نام sequence به عنوان ورودی، به مقدار اولیه آن بازنشانی میکند.
اگر از CHelper.ResetSequenceValue استفاده میکنید، اطلاعات Rules API را بخوانید، چون استفاده از این تابع ملاحظات مهمی دارد. |
CHelper.ResetSequenceValue("SequenceName") |
|
|
مقدار ذخیرهشده در یک Vocabulary مشخص را به دست میآورد. |
CHelper.resolveVocabulary(Me, VocabularyName) |
|
|
id کاربر بعدیِ در دسترس برای تخصیص بر اساس sequence را برمیگرداند. |
CHelper.SecuentialAssig(AssigneeList, Me) |
|
|
مقدارهای attribute مشخص را از رکوردهای مشخص یک entity تغییر میدهد.
اگر از CHelper.setAttrib استفاده میکنید، اطلاعات این لینک را با دقت بخوانید، چون استفاده از این تابع ملاحظات مهمی دارد. |
CHelper.setAttrib(sEntityName, oEntityKey, sAttribName, oAttribValue) |
|
|
یک intermediate Event موجود در Bizagi را که نوع مشخصی برای آن تعریف نشده است اجرا میکند. |
CHelper.setEvent(Me, Caseid, eventName, null)
CHelper.setEvent(xml) |
|
|
بررسی میکند که برای یک شماره ایجاد پرونده مشخص، پرونده باز وجود دارد یا نه. |
CHelper.thereAreOpenProcesses(CaseNumber) |
|
|
بررسی میکند که برای یک شماره ایجاد پرونده مشخص و WfClassName، پرونده باز وجود دارد یا نه. |
CHelper.thereAreOpenProcesses(caseNumber, wfclassName) |
|
|
یک پیام خطا را در Work Portal نمایش میدهد. |
CHelper.ThrowValidationError(message) |
|
|
یک پیام هشدار سفارشی را در Work Portal نمایش میدهد. |
CHelper.ThrowValidationAlert(message) |
|
|
فایلها را به base64 تبدیل میکند. |
CHelper.ToBase64(data) |
|
|
یک string را به Integer تبدیل میکند. |
CHelper.ToInt(sText) |
|
|
traceهای تعریفشده توسط کاربر را که به صورت دستی در Business Rules قرار داده شدهاند، در log ثبت میکند. |
CHelper.trace(sFileName, sText) |
|
|
اطلاعات کسبوکار را برای ذخیرهسازی در ECM به یک سند نگاشت میکند. |
CHelper.UpdateECMMetadata(Me, data, XPath) |
|
|
Bizagi را مجبور میکند attributeهایی را که در deployment لحاظ نشدهاند، وارد کند. |
CHelper.usingXPath(xpath) CHelper.usingXPath(EntityName, xpath) |
آخرین بهروزرسانی: 6/30/2025 8:20:28 PM