BAM — مرجع فنی داده و سرویس‌ها

ProcessBAM_GetAggregatedDispersions

یک ردیف شامل میانگین ایجاد روزانه، تعداد جاری و تعداد خاتمه‌یافته بازمی‌گرداند. داده از ProcessCreation و ProcessList و با حذف محیط آزمایشی نمونه خوانده می‌شود. فیلتر تاریخ روی CreateDate نمونه است.

ExcludedIds در این نسخه شناسه گروه فرآیند است. STRING_SPLIT و TRY_CAST ورودی‌های غیرقابل‌تبدیل به INT را حذف می‌کنند و DISTINCT شناسه تکراری را حذف می‌کند. پس از حذف گروه‌ها، برای تاریخ‌های NULL کمینه/بیشینه CreateDate همین دامنه انتخاب می‌شود.

تعداد روز = DATEDIFF(DAY, شروع مؤثر, پایان مؤثر)+1. بازه وارونه به تعداد روز ۱ محدود می‌شود، اما شرط تاریخ معمولاً نمونه‌ای برنمی‌گرداند. اگر تاریخ مؤثر یا مجموعه نمونه‌ها خالی باشد میانگین ۰٫۰ است.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• صورت میانگین همه نمونه‌ها، شامل لغوشده‌هاست؛ اما دو شمارنده جاری و خاتمه لغوشده‌ها را حذف می‌کنند. بنابراین مجموع این دو الزاماً صورت میانگین نیست.
• ردیف‌های ProcessList با INNER JOIN لازم‌اند؛ برخلاف بعضی مخرج‌های پراکندگی، نمونه بدون نسخه معتبر در این تجمیع قرار نمی‌گیرد.

CREATE OR ALTER PROCEDURE ProcessBAM_GetAggregatedDispersions
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @ExcludedIds VARCHAR(MAX) = NULL

ProcessBAM_GetAggregatedDispersionsByProcessGroupId

همان سه خروجی و فرمول رویه عمومی را فقط برای گروه اجباری ProcessGroupId تولید می‌کند. محدودسازی از ProcessList.FK_ProcessGroupID انجام می‌شود و بازه روی تاریخ ایجاد نمونه است.

تفاوت تعیین‌کننده: ExcludedIds در این رویه شناسه نسخه فرآیند (ProcessCreation.ProcessID / ProcessList.Id) است. حذف یک نسخه از جدول پراکندگی گروه، تجمیع را بدون نمونه‌های آن نسخه بازمی‌سازد.

تاریخ‌های مؤثر و تعداد روز پس از اعمال گروه و حذف نسخه‌ها محاسبه می‌شوند. تعداد روز فراگیر است و میانگین کل نمونه‌ها را، شامل لغوشده‌ها، در نظر می‌گیرد.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• ProcessGroupId گروه است؛ مقدار Version یا شناسه نمونه را نباید به آن فرستاد.

CREATE OR ALTER PROCEDURE ProcessBAM_GetAggregatedDispersionsByProcessGroupId
    @ProcessGroupId INT,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @ExcludedIds VARCHAR(MAX) = NULL

ProcessBAM_GetDispersions

برای هر گروه دارای نسخه غیرآزمایشی در ProcessList یک ردیف بازمی‌گرداند؛ LEFT JOIN نمونه‌ها باعث می‌شود گروه بدون نمونه در بازه نیز با صفر دیده شود. تاریخ بر CreateDate نمونه اعمال می‌شود.

جاری: Finish NULL→0 و Discard NULL→0، سپس Finish=0 و Discard≠1. خاتمه: Finish=1 و Discard≠1. ترتیب SQL ابتدا تعداد خاتمه نزولی و سپس تعداد جاری نزولی است.

مخرج هر دو درصد، تعداد تمام نمونه‌های غیرآزمایشی در بازه است؛ نه تعداد جاری‌ها یا خاتمه‌یافته‌ها و نه صرفاً گروه‌های نمایان نمودار.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• مخرج از ProcessCreation مستقل محاسبه می‌شود؛ صورت، نسخه غیرآزمایشی و پیوند معتبر گروه را لازم دارد. لغوشده‌ها در مخرج هستند اما در دو صورت نیستند؛ مجموع درصدها الزاماً ۱۰۰ نیست.

CREATE OR ALTER PROCEDURE ProcessBAM_GetDispersions
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL

ProcessBAM_GetDispersionsByProcessGroupId

برای هر نسخه غیرآزمایشی ProcessList در گروه یک ردیف می‌دهد. Id شناسه نسخه و Title مقدار Version است؛ در حالی‌که نسخه عمومی Id گروه و Title نام گروه می‌دهد.

صورت‌ها همان جاری/خاتمه بدون لغو و مخرج تمام نمونه‌های غیرآزمایشی بازه مربوط به گروه انتخابی است. بازه روی CreateDate اعمال می‌شود. نسخه بدون نمونه نیز با صفر بازمی‌گردد.

مرتب‌سازی: FinishedCreationsCount نزولی، سپس InProcessCreationsCount نزولی.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• این رویه ورودی حذف نسخه ندارد؛ حذف انتخابی در تجمیع مکمل با ExcludedIds انجام می‌شود.

CREATE OR ALTER PROCEDURE ProcessBAM_GetDispersionsByProcessGroupId
    @ProcessGroupId INT,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL

ProcessBAM_GetAggregatedGeneralInfo

این رویه یک ردیف آماری جامع برای کارت‌های وضعیت نمونه و کارت‌های خطا تولید می‌کند. هر کارت زوج تاریخ اختصاصی دارد؛ تغییر یک زوج تاریخ، مخرج همان کارت را نیز تغییر می‌دهد. چهار پارامتر ترجمه پیش‌فرض ندارند و باید هنگام فراخوانی تأمین شوند؛ امکان ارسال صریح NULL به SQL همچنان وجود دارد.

ابتدا همه نمونه‌های غیرآزمایشی در #CreationsDates، خطاهای مرتبط با همین نمونه‌ها در #Exceptions و نام متغیرهای @@StartFromService و @@StartFromESB در #VariablesLogs گردآوری می‌شوند. وضعیت‌های NULL نمونه به صفر تبدیل می‌شوند. جدول موقت Boundary از ProcessBoundaryEventConfig و ProcessElements ساخته می‌شود.

کارت‌های جاری، خاتمه، لغو، کارتابل/رونوشت و نمونه دارای خطا همگی با تاریخ ایجاد نمونه فیلتر می‌شوند. کارت‌های تعداد خطا و دسته‌های خطا با تاریخ وقوع خطا فیلتر می‌شوند. مثلاً نمونه ایجادشده در بازه که بعداً خطا داده است، در شمارنده نمونه دارای خطا می‌ماند.

نسبت هر کارت Count×100.0/TotalCount است و در مخرج صفر، مقدار صفر بازمی‌گردد. برای کارت‌های وضعیت، TotalCount کل نمونه‌های همان بازه است. برای دسته خطا، TotalCount تمام خطاهای همان بازه اختصاصی است.

کارتابل دو سطح دارد: شمارش نمونه یکتا با حداقل یک ارجاع اصلی یا رونوشت، و شمارش خود ردیف‌های ارجاع. یک نمونه می‌تواند هم در اصلی و هم در رونوشت قرار گیرد. کارتابل از Process_InterimInboxData فعلی خوانده می‌شود و تاریخ آن تاریخ ایجاد نمونه است.

ProcessesGroupsCount تعداد گروه‌های متمایز در نسخه‌های غیرآزمایشی است و با فیلتر تاریخ تغییر نمی‌کند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• وضعیت جاری/خاتمه/لغو وضعیت فعلی نمونه در زمان خواندن است، نه بازسازی وضعیت تاریخی آن در روز انتخاب‌شده. فقط این سه دسته با بازه یکسان، دسته‌های ناسازگار با یکدیگرند؛ کارتابل و خطا با آن‌ها هم‌پوشانی دارند.
• با وجود نام ...ExceptionCreationsCount، دسته‌های ۲ تا ۱۶ رکوردهای خطا را می‌شمارند. تنها OccurredExceptionCreationsCount نمونه یکتا می‌شمارد. یک نمونه با چند خطا می‌تواند چند بار در دسته‌های خطا شمرده شود.
• دسته‌های موضوعی خطا مستقل‌اند و ممکن است هم‌پوشانی داشته باشند؛ جمع اعداد آن‌ها الزاماً کل خطاها نیست. Other از «بدون Boundary» و خارج همه دسته‌های ۴ تا ۱۵ ساخته می‌شود، نه از تفریق ساده اعداد کارت‌ها.
• «مدیریت‌شده» در SQL به معنی وجود Boundary متصل در تعریف فرآیند است؛ این محاسبه لاگ موفقیت اجرای مسیر مدیریت خطا را بررسی نمی‌کند. خود جدول Boundary بر نوع رویداد خطا شرط صریح ندارد.
• اگر متن ترجمه لازم NULL یا با متن ذخیره‌شده متفاوت باشد، دسته‌های ۱۱ تا ۱۵ ممکن است صفر شوند و بخشی از خطاها در Other بمانند. تشخیص سرویس/ESB صرفاً با وجود نام متغیر است.
• InCartableRefsCount و CopiesInCartableRefsCount به‌علت SUM بدون ISNULL ممکن است در مجموعه خالی NULL باشند؛ سایر شمارنده‌های COUNT_BIG صفر هستند.

CREATE OR ALTER PROCEDURE ProcessBAM_GetAggregatedGeneralInfo
    @InvalidOutputServiceData_Translate NVARCHAR(500),
    @ErrorInGetValVar_Translate NVARCHAR(500),
    @AnExceptionOccurredDuringStartingOrContinuingProcess_Translate NVARCHAR(500),
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscarded_Translate NVARCHAR(500),
    @FinishedStartDate DATETIME = NULL,
    @FinishedEndDate DATETIME = NULL,
    @NewStartDate DATETIME = NULL,
    @NewEndDate DATETIME = NULL,
    @DiscardStartDate DATETIME = NULL,
    @DiscardEndDate DATETIME = NULL,
    @InCartableStartDate DATETIME = NULL,
    @InCartableEndDate DATETIME = NULL,
    @OccurredExceptionCreationStartDate DATETIME = NULL,
    @OccurredExceptionCreationEndDate DATETIME = NULL,
    @OccurredExceptionStartDate DATETIME = NULL,
    @OccurredExceptionEndDate DATETIME = NULL,
    @AutoHandledOccurredExceptionStartDate DATETIME = NULL,
    @AutoHandledOccurredExceptionEndDate DATETIME = NULL,
    @NotAutoHandledOccurredExceptionStartDate DATETIME = NULL,
    @NotAutoHandledOccurredExceptionEndDate DATETIME = NULL,
    @AccessViolationOccurredExceptionStartDate DATETIME = NULL,
    @AccessViolationOccurredExceptionEndDate DATETIME = NULL,
    @ExternalOccurredExceptionStartDate DATETIME = NULL,
    @ExternalOccurredExceptionEndDate DATETIME = NULL,
    @StartedAsServiceOccurredExceptionStartDate DATETIME = NULL,
    @StartedAsServiceOccurredExceptionEndDate DATETIME = NULL,
    @StartedAsESBOccurredExceptionStartDate DATETIME = NULL,
    @StartedAsESBOccurredExceptionEndDate DATETIME = NULL,
    @TimeoutOccurredExceptionStartDate DATETIME = NULL,
    @TimeoutOccurredExceptionEndDate DATETIME = NULL,
    @GatewayHasNoDefaultSequenceFlowOccurredExceptionStartDate DATETIME = NULL,
    @GatewayHasNoDefaultSequenceFlowOccurredExceptionEndDate DATETIME = NULL,
    @OccurredExceptionFinishedStartDate DATETIME = NULL,
    @OccurredExceptionFinishedEndDate DATETIME = NULL,
    @InvalidOutputServiceDataOccurredExceptionStartDate DATETIME = NULL,
    @InvalidOutputServiceDataOccurredExceptionEndDate DATETIME = NULL,
    @ErrorInGetValVarOccurredExceptionStartDate DATETIME = NULL,
    @ErrorInGetValVarOccurredExceptionEndDate DATETIME = NULL,
    @AnExceptionOccurredDuringStartingProcessStartDate DATETIME = NULL,
    @AnExceptionOccurredDuringStartingProcessEndDate DATETIME = NULL,
    @AnExceptionOccurredDuringContinuingProcessStartDate DATETIME = NULL,
    @AnExceptionOccurredDuringContinuingProcessEndDate DATETIME = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscardedOccurredExceptionStartDate DATETIME = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscardedOccurredExceptionEndDate DATETIME = NULL

ProcessBAM_GetAggregatedGeneralInfoByProcessGroupId

این رویه یک ردیف آماری جامع برای کارت‌های وضعیت نمونه و کارت‌های خطا تولید می‌کند. هر کارت زوج تاریخ اختصاصی دارد؛ تغییر یک زوج تاریخ، مخرج همان کارت را نیز تغییر می‌دهد. چهار پارامتر ترجمه پیش‌فرض ندارند و باید هنگام فراخوانی تأمین شوند؛ امکان ارسال صریح NULL به SQL همچنان وجود دارد.

ابتدا همه نمونه‌های غیرآزمایشی در #CreationsDates، خطاهای مرتبط با همین نمونه‌ها در #Exceptions و نام متغیرهای @@StartFromService و @@StartFromESB در #VariablesLogs گردآوری می‌شوند. وضعیت‌های NULL نمونه به صفر تبدیل می‌شوند. جدول موقت Boundary از ProcessBoundaryEventConfig و ProcessElements ساخته می‌شود.

کارت‌های جاری، خاتمه، لغو، کارتابل/رونوشت و نمونه دارای خطا همگی با تاریخ ایجاد نمونه فیلتر می‌شوند. کارت‌های تعداد خطا و دسته‌های خطا با تاریخ وقوع خطا فیلتر می‌شوند. مثلاً نمونه ایجادشده در بازه که بعداً خطا داده است، در شمارنده نمونه دارای خطا می‌ماند.

نسبت هر کارت Count×100.0/TotalCount است و در مخرج صفر، مقدار صفر بازمی‌گردد. برای کارت‌های وضعیت، TotalCount کل نمونه‌های همان بازه است. برای دسته خطا، TotalCount تمام خطاهای همان بازه اختصاصی است.

کارتابل دو سطح دارد: شمارش نمونه یکتا با حداقل یک ارجاع اصلی یا رونوشت، و شمارش خود ردیف‌های ارجاع. یک نمونه می‌تواند هم در اصلی و هم در رونوشت قرار گیرد. کارتابل از Process_InterimInboxData فعلی خوانده می‌شود و تاریخ آن تاریخ ایجاد نمونه است.

در مرحله گردآوری نمونه‌ها، گروه اجباری روی ProcessList.FK_ProcessGroupID اعمال می‌شود. به جای ProcessesGroupsCount، سه خروجی ActiveProcessesCount، InActiveProcessesCount و SuspendedProcessesCount درباره نسخه‌های همین گروه بازمی‌گردد. این سه خروجی مستقل از تاریخ هستند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• وضعیت جاری/خاتمه/لغو وضعیت فعلی نمونه در زمان خواندن است، نه بازسازی وضعیت تاریخی آن در روز انتخاب‌شده. فقط این سه دسته با بازه یکسان، دسته‌های ناسازگار با یکدیگرند؛ کارتابل و خطا با آن‌ها هم‌پوشانی دارند.
• با وجود نام ...ExceptionCreationsCount، دسته‌های ۲ تا ۱۶ رکوردهای خطا را می‌شمارند. تنها OccurredExceptionCreationsCount نمونه یکتا می‌شمارد. یک نمونه با چند خطا می‌تواند چند بار در دسته‌های خطا شمرده شود.
• دسته‌های موضوعی خطا مستقل‌اند و ممکن است هم‌پوشانی داشته باشند؛ جمع اعداد آن‌ها الزاماً کل خطاها نیست. Other از «بدون Boundary» و خارج همه دسته‌های ۴ تا ۱۵ ساخته می‌شود، نه از تفریق ساده اعداد کارت‌ها.
• «مدیریت‌شده» در SQL به معنی وجود Boundary متصل در تعریف فرآیند است؛ این محاسبه لاگ موفقیت اجرای مسیر مدیریت خطا را بررسی نمی‌کند. خود جدول Boundary بر نوع رویداد خطا شرط صریح ندارد.
• اگر متن ترجمه لازم NULL یا با متن ذخیره‌شده متفاوت باشد، دسته‌های ۱۱ تا ۱۵ ممکن است صفر شوند و بخشی از خطاها در Other بمانند. تشخیص سرویس/ESB صرفاً با وجود نام متغیر است.
• InCartableRefsCount و CopiesInCartableRefsCount به‌علت SUM بدون ISNULL ممکن است در مجموعه خالی NULL باشند؛ سایر شمارنده‌های COUNT_BIG صفر هستند.
• در شمارش نسخه غیرفعال، شرط IsActive<>1 با مقدار NULL برقرار نیست؛ نسخه با پرچم نامشخص الزاماً در سه شمارنده جای نمی‌گیرد.

CREATE OR ALTER PROCEDURE ProcessBAM_GetAggregatedGeneralInfoByProcessGroupId
    @ProcessGroupId INT,
    @InvalidOutputServiceData_Translate NVARCHAR(500),
    @ErrorInGetValVar_Translate NVARCHAR(500),
    @AnExceptionOccurredDuringStartingOrContinuingProcess_Translate NVARCHAR(500),
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscarded_Translate NVARCHAR(500),
    @FinishedStartDate DATETIME = NULL,
    @FinishedEndDate DATETIME = NULL,
    @NewStartDate DATETIME = NULL,
    @NewEndDate DATETIME = NULL,
    @DiscardStartDate DATETIME = NULL,
    @DiscardEndDate DATETIME = NULL,
    @InCartableStartDate DATETIME = NULL,
    @InCartableEndDate DATETIME = NULL,
    @OccurredExceptionCreationStartDate DATETIME = NULL,
    @OccurredExceptionCreationEndDate DATETIME = NULL,
    @OccurredExceptionStartDate DATETIME = NULL,
    @OccurredExceptionEndDate DATETIME = NULL,
    @AutoHandledOccurredExceptionStartDate DATETIME = NULL,
    @AutoHandledOccurredExceptionEndDate DATETIME = NULL,
    @NotAutoHandledOccurredExceptionStartDate DATETIME = NULL,
    @NotAutoHandledOccurredExceptionEndDate DATETIME = NULL,
    @AccessViolationOccurredExceptionStartDate DATETIME = NULL,
    @AccessViolationOccurredExceptionEndDate DATETIME = NULL,
    @ExternalOccurredExceptionStartDate DATETIME = NULL,
    @ExternalOccurredExceptionEndDate DATETIME = NULL,
    @StartedAsServiceOccurredExceptionStartDate DATETIME = NULL,
    @StartedAsServiceOccurredExceptionEndDate DATETIME = NULL,
    @StartedAsESBOccurredExceptionStartDate DATETIME = NULL,
    @StartedAsESBOccurredExceptionEndDate DATETIME = NULL,
    @TimeoutOccurredExceptionStartDate DATETIME = NULL,
    @TimeoutOccurredExceptionEndDate DATETIME = NULL,
    @GatewayHasNoDefaultSequenceFlowOccurredExceptionStartDate DATETIME = NULL,
    @GatewayHasNoDefaultSequenceFlowOccurredExceptionEndDate DATETIME = NULL,
    @OccurredExceptionFinishedStartDate DATETIME = NULL,
    @OccurredExceptionFinishedEndDate DATETIME = NULL,
    @InvalidOutputServiceDataOccurredExceptionStartDate DATETIME = NULL,
    @InvalidOutputServiceDataOccurredExceptionEndDate DATETIME = NULL,
    @ErrorInGetValVarOccurredExceptionStartDate DATETIME = NULL,
    @ErrorInGetValVarOccurredExceptionEndDate DATETIME = NULL,
    @AnExceptionOccurredDuringStartingProcessStartDate DATETIME = NULL,
    @AnExceptionOccurredDuringStartingProcessEndDate DATETIME = NULL,
    @AnExceptionOccurredDuringContinuingProcessStartDate DATETIME = NULL,
    @AnExceptionOccurredDuringContinuingProcessEndDate DATETIME = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscardedOccurredExceptionStartDate DATETIME = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscardedOccurredExceptionEndDate DATETIME = NULL

ProcessBAM_GetSummaryPerDay

چهار خانواده داده به یک جدول موقت #Facts افزوده می‌شود: وضعیت نمونه، ردیف کارتابل، ارسال فرم و خطا. هر ردیف ابتدا با EventDate خودش محدود می‌شود و سپس در دسته زمانی قرار می‌گیرد. داده نمونه آزمایشی حذف می‌شود.

BasedOnCreationDate و BasedOnCreationCount مستقل‌اند: اولی محور زمان و دومی واحد شمارش کارتابل، ارسال و خطا را تعیین می‌کند. IncludeCopies فقط نوع ردیف‌های کارتابل و ارسال را انتخاب می‌کند؛ وضعیت نمونه و خطاها را به رونوشت/اصلی تقسیم نمی‌کند.

ارسال فرم در این رویه یعنی ProcessReferences با FKFormsConfigID غیرNULL و ExitCartableDateTime غیرNULL و IsCopy انتخابی. نام UserTask در خروجی مدت دیده می‌شود، اما شرط مستقیم ItemTypeID=1 در این بخش وجود ندارد.

اگر BasedOnCreationDate=1 باشد، برای هر نمونه تعداد ارسال‌ها و میانگین ثانیه‌های ارسال محاسبه می‌شود؛ سپس بیشترین این میانگین‌ها در هر دسته خروجی می‌آید. اگر صفر باشد، هر ارجاع ارسال‌شده یک Fact دارد و بیشینه، کندترین ارجاع منفرد است.

خروجی یک مجموعه نتیجه است که شکل ستون‌های زمان آن متغیر است: اگر هر دو تاریخ NULL باشند یا هر دو مقدار داشته باشند و DATEDIFF(DAY)>1 شود، ستون‌های AtYear/AtMonth/AtDay می‌آیند؛ در سایر حالت‌ها AtHour/AtMinute/AtSecond می‌آیند. روز/ساعت بدون Fact، ردیف صفر مصنوعی در SQL ندارد.

در هر دسته، نمونه دارای خطای Boundary و خطای بدون Boundary می‌تواند در هر دو شمارنده یکتا دیده شود. شناسه نمونه متناظر با بیشترین مدت در تساوی با کوچک‌ترین شناسه تعیین می‌شود. خروجی SQL ORDER BY نهایی ندارد و نظم نمودار باید در لایه بالاتر اعمال شود.

نسخه عمومی علاوه بر شناسه نمونه بیشینه، MaximumUserTaskSubmitDurationGroupName را نیز برمی‌گرداند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

ستون‌های AtYear/AtMonth/AtDay و AtHour/AtMinute/AtSecond دو شکل جایگزین‌اند؛ هم‌زمان در یک خروجی نمی‌آیند. سایر ستون‌ها در هر دو شاخه مشترک‌اند.

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• شرط روزانه دقیقاً >1 است؛ بازه دو تاریخ مجاور، حتی اگر دو روز تقویمی را بپوشاند، وارد شاخه ساعت/دقیقه/ثانیه می‌شود. با یک مرز NULL نیز همین شاخه انتخاب می‌شود. در این شاخه تاریخ روز در GROUP BY نیست و ساعت مشابه روزهای مختلف می‌تواند ادغام شود.
• BasedOnCreationDate=1، زمان ارسال و وقوع خطا را داخل بازه انتخابی محدود نمی‌کند؛ فقط نمونه‌ای را می‌گیرد که CreateDate آن در بازه باشد. بنابراین این حالت تحلیل نسل نمونه‌هاست.
• MaximumTaskSubmissionDuration به معنی حداکثر زمان کل اجرای فرآیند نیست. DATEDIFF و AVG در این رویه INT هستند؛ مقادیر اعشاری میانگین حذف می‌شوند و بازه‌های بسیار طولانی با محدودیت INT مواجه‌اند.
• کارتابل از جدول فعلی Process_InterimInboxData خوانده می‌شود؛ این سری تاریخچه کامل ورود و خروج کارتابل را بازسازی نمی‌کند.

CREATE OR ALTER PROCEDURE ProcessBAM_GetSummaryPerDay
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @IncludeCopies BIT = 0,
    @BasedOnCreationDate BIT = 1,
    @BasedOnCreationCount BIT = 1

ProcessBAM_GetSummaryPerDayByProcessGroupId

چهار خانواده داده به یک جدول موقت #Facts افزوده می‌شود: وضعیت نمونه، ردیف کارتابل، ارسال فرم و خطا. هر ردیف ابتدا با EventDate خودش محدود می‌شود و سپس در دسته زمانی قرار می‌گیرد. داده نمونه آزمایشی حذف می‌شود.

BasedOnCreationDate و BasedOnCreationCount مستقل‌اند: اولی محور زمان و دومی واحد شمارش کارتابل، ارسال و خطا را تعیین می‌کند. IncludeCopies فقط نوع ردیف‌های کارتابل و ارسال را انتخاب می‌کند؛ وضعیت نمونه و خطاها را به رونوشت/اصلی تقسیم نمی‌کند.

ارسال فرم در این رویه یعنی ProcessReferences با FKFormsConfigID غیرNULL و ExitCartableDateTime غیرNULL و IsCopy انتخابی. نام UserTask در خروجی مدت دیده می‌شود، اما شرط مستقیم ItemTypeID=1 در این بخش وجود ندارد.

اگر BasedOnCreationDate=1 باشد، برای هر نمونه تعداد ارسال‌ها و میانگین ثانیه‌های ارسال محاسبه می‌شود؛ سپس بیشترین این میانگین‌ها در هر دسته خروجی می‌آید. اگر صفر باشد، هر ارجاع ارسال‌شده یک Fact دارد و بیشینه، کندترین ارجاع منفرد است.

خروجی یک مجموعه نتیجه است که شکل ستون‌های زمان آن متغیر است: اگر هر دو تاریخ NULL باشند یا هر دو مقدار داشته باشند و DATEDIFF(DAY)>1 شود، ستون‌های AtYear/AtMonth/AtDay می‌آیند؛ در سایر حالت‌ها AtHour/AtMinute/AtSecond می‌آیند. روز/ساعت بدون Fact، ردیف صفر مصنوعی در SQL ندارد.

در هر دسته، نمونه دارای خطای Boundary و خطای بدون Boundary می‌تواند در هر دو شمارنده یکتا دیده شود. شناسه نمونه متناظر با بیشترین مدت در تساوی با کوچک‌ترین شناسه تعیین می‌شود. خروجی SQL ORDER BY نهایی ندارد و نظم نمودار باید در لایه بالاتر اعمال شود.

تمام خانواده Facts با EXISTS روی ProcessList و ProcessGroupId محدود می‌شوند. ستون نام گروه نمونه بیشینه حذف شده، چون دامنه گزارش از قبل یک گروه است؛ سایر معانی برقرارند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

ستون‌های AtYear/AtMonth/AtDay و AtHour/AtMinute/AtSecond دو شکل جایگزین‌اند؛ هم‌زمان در یک خروجی نمی‌آیند. سایر ستون‌ها در هر دو شاخه مشترک‌اند.

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• شرط روزانه دقیقاً >1 است؛ بازه دو تاریخ مجاور، حتی اگر دو روز تقویمی را بپوشاند، وارد شاخه ساعت/دقیقه/ثانیه می‌شود. با یک مرز NULL نیز همین شاخه انتخاب می‌شود. در این شاخه تاریخ روز در GROUP BY نیست و ساعت مشابه روزهای مختلف می‌تواند ادغام شود.
• BasedOnCreationDate=1، زمان ارسال و وقوع خطا را داخل بازه انتخابی محدود نمی‌کند؛ فقط نمونه‌ای را می‌گیرد که CreateDate آن در بازه باشد. بنابراین این حالت تحلیل نسل نمونه‌هاست.
• MaximumTaskSubmissionDuration به معنی حداکثر زمان کل اجرای فرآیند نیست. DATEDIFF و AVG در این رویه INT هستند؛ مقادیر اعشاری میانگین حذف می‌شوند و بازه‌های بسیار طولانی با محدودیت INT مواجه‌اند.
• کارتابل از جدول فعلی Process_InterimInboxData خوانده می‌شود؛ این سری تاریخچه کامل ورود و خروج کارتابل را بازسازی نمی‌کند.

CREATE OR ALTER PROCEDURE ProcessBAM_GetSummaryPerDayByProcessGroupId
    @ProcessGroupId INT,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @IncludeCopies BIT = 0,
    @BasedOnCreationDate BIT = 1,
    @BasedOnCreationCount BIT = 1

ProcessBAM_GetExceptions

یک ردیف به‌ازای هر خطای واجد شرایط از ProcessErrorLogs که نمونه غیرآزمایشی معتبر دارد؛ جداول ProcessList، ProcessGroup، المان/نوع، کاربر/نقش و والدها به صورت LEFT JOIN غنی‌سازی می‌شوند. ستون Element از FK_ElementID خود خطا به دست می‌آید.

همه ورودی‌های جست‌وجوی ارائه‌شده با AND ترکیب می‌شوند؛ عنوان/پیام/نام نقش/عنوان نمونه و والد جست‌وجوی شامل متن دارند و شناسه‌ها، نوع فنی خطا و شناسه BPMN تطبیق دقیق دارند. بازه اصلی این فهرست روی زمان وقوع خطاست.

ExceptionCategory از جدول دسته‌بندی این پیوست پیروی می‌کند. جدول Boundary فقط برای ۲، ۳، ۱۶ و جدول نام متغیرهای آغاز سرویس/ESB فقط برای ۶، ۷، ۱۶ پر می‌شود. مرزهای تاریخ فراگیرند.

ExceptionOccurredDuration اختلاف ثانیه از CreateDate خطا تا GETDATE زمان اجرای SQL است. مقدار ذخیره‌شده در کش، گذر زمان بعد از دریافت را منعکس نمی‌کند. این مقدار مدت اجرای گام یا عمر نمونه نیست.

تفاوت قرارداد عمومی و گروهی: DistinctCreations=1 فقط جدیدترین خطای هر نمونه را پس از اعمال فیلترها نگه می‌دارد. StrictTranslateCheck=1 برای دسته‌های ۱۱، ۱۲، ۱۳/۱۴، ۱۵ و ۱۶ نبود ترجمه لازم را با RAISERROR گزارش می‌کند. این دو قابلیت در امضای نسخه گروهی موجود نیستند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• عنوان‌های ترجمه‌ای دسته‌های ۱۱ تا ۱۵ باید دقیقاً با داده ذخیره‌شده سازگار باشند؛ NULL باعث عدم تطبیق آن دسته می‌شود. دسته ۱۶ با ترجمه ناقص ممکن است مجموعه بزرگ‌تری بگیرد.
• تاریخ این فهرست با کارت «نمونه دارای خطا» متفاوت است: کارت با تاریخ ایجاد نمونه کار می‌کند، فهرست با زمان وقوع خطا. برای تطبیق کامل، لایه فراخوان باید فیلتر نسل نمونه را جداگانه رعایت کند.
• SQL ترتیب نهایی خروجی را تضمین نمی‌کند؛ جدیدترین‌ها باید توسط لایه سرویس/جدول مرتب شوند. ROW_NUMBER برای حذف تکرار، به معنی ORDER BY نهایی نیست.

CREATE OR ALTER PROCEDURE ProcessBAM_GetExceptions
    @InvalidOutputServiceData_Translate NVARCHAR(500) = NULL,
    @ErrorInGetValVar_Translate NVARCHAR(500) = NULL,
    @AnExceptionOccurredDuringStartingOrContinuingProcess_Translate NVARCHAR(500) = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscarded_Translate NVARCHAR(500) = NULL,
    @ExceptionId INT = NULL,
    @ExceptionOccurredDateTimeFrom DATETIME = NULL,
    @ExceptionOccurredDateTimeTo DATETIME = NULL,
    @ExceptionTitle NVARCHAR(MAX) = NULL,
    @ExceptionMessage NVARCHAR(MAX) = NULL,
    @ExceptionType NVARCHAR(500) = NULL,
    @ExceptionOwnerRoleId INT = NULL,
    @ExceptionOwnerRoleName NVARCHAR(500) = NULL,
    @ExceptionOwnerUserId INT = NULL,
    @CreationTitle NVARCHAR(MAX) = NULL,
    @HasCreationFinished BIT = NULL,
    @HasCreationDiscarded BIT = NULL,
    @ProcessGroupId INT = NULL,
    @ElementBpmnId NVARCHAR(150) = NULL,
    @ElementTypeId INT = NULL,
    @ParentProcessGroupId INT = NULL,
    @ParentStepBpmnId NVARCHAR(150) = NULL,
    @ParentStepTypeId INT = NULL,
    @ParentCreationTitle NVARCHAR(MAX) = NULL,
    
























    @ExceptionCategory TINYINT = NULL,
    @CreationId INT = NULL,
    
    @DistinctCreations BIT = 0,
    
    @StrictTranslateCheck BIT = 0

ProcessBAM_GetExceptionsByProcessGroupId

یک ردیف به‌ازای هر خطای واجد شرایط از ProcessErrorLogs که نمونه غیرآزمایشی معتبر دارد؛ جداول ProcessList، ProcessGroup، المان/نوع، کاربر/نقش و والدها به صورت LEFT JOIN غنی‌سازی می‌شوند. ستون Element از FK_ElementID خود خطا به دست می‌آید.

همه ورودی‌های جست‌وجوی ارائه‌شده با AND ترکیب می‌شوند؛ عنوان/پیام/نام نقش/عنوان نمونه و والد جست‌وجوی شامل متن دارند و شناسه‌ها، نوع فنی خطا و شناسه BPMN تطبیق دقیق دارند. بازه اصلی این فهرست روی زمان وقوع خطاست.

ExceptionCategory از جدول دسته‌بندی این پیوست پیروی می‌کند. جدول Boundary فقط برای ۲، ۳، ۱۶ و جدول نام متغیرهای آغاز سرویس/ESB فقط برای ۶، ۷، ۱۶ پر می‌شود. مرزهای تاریخ فراگیرند.

ExceptionOccurredDuration اختلاف ثانیه از CreateDate خطا تا GETDATE زمان اجرای SQL است. مقدار ذخیره‌شده در کش، گذر زمان بعد از دریافت را منعکس نمی‌کند. این مقدار مدت اجرای گام یا عمر نمونه نیست.

ProcessGroupId اجباری است؛ ProcessId اختیاری امکان محدودسازی به یک نسخه را می‌دهد. این فایل برخلاف عمومی پارامتر DistinctCreations و StrictTranslateCheck ندارد و ستون CreationCreateDate را هم برنمی‌گرداند. حذف تکرار نمونه در Drill-down گروهی باید در لایه فراخوان انجام شود.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• عنوان‌های ترجمه‌ای دسته‌های ۱۱ تا ۱۵ باید دقیقاً با داده ذخیره‌شده سازگار باشند؛ NULL باعث عدم تطبیق آن دسته می‌شود. دسته ۱۶ با ترجمه ناقص ممکن است مجموعه بزرگ‌تری بگیرد.
• تاریخ این فهرست با کارت «نمونه دارای خطا» متفاوت است: کارت با تاریخ ایجاد نمونه کار می‌کند، فهرست با زمان وقوع خطا. برای تطبیق کامل، لایه فراخوان باید فیلتر نسل نمونه را جداگانه رعایت کند.
• SQL ترتیب نهایی خروجی را تضمین نمی‌کند؛ جدیدترین‌ها باید توسط لایه سرویس/جدول مرتب شوند. ROW_NUMBER برای حذف تکرار، به معنی ORDER BY نهایی نیست.

CREATE OR ALTER PROCEDURE ProcessBAM_GetExceptionsByProcessGroupId
    @ProcessGroupId INT,
    @InvalidOutputServiceData_Translate NVARCHAR(500) = NULL,
    @ErrorInGetValVar_Translate NVARCHAR(500) = NULL,
    @AnExceptionOccurredDuringStartingOrContinuingProcess_Translate NVARCHAR(500) = NULL,
    @ThereIsNoRouteToContinueProcessCreationOrProcessCreationHasBeenDiscarded_Translate NVARCHAR(500) = NULL,
    @ExceptionId INT = NULL,
    @ExceptionOccurredDateTimeFrom DATETIME = NULL,
    @ExceptionOccurredDateTimeTo DATETIME = NULL,
    @ExceptionTitle NVARCHAR(MAX) = NULL,
    @ExceptionMessage NVARCHAR(MAX) = NULL,
    @ExceptionType NVARCHAR(500) = NULL,
    @ExceptionOwnerRoleId INT = NULL,
    @ExceptionOwnerRoleName NVARCHAR(500) = NULL,
    @ExceptionOwnerUserId INT = NULL,
    @CreationTitle NVARCHAR(MAX) = NULL,
    @HasCreationFinished BIT = NULL,
    @HasCreationDiscarded BIT = NULL,
    @ProcessId INT = NULL,
    @ElementBpmnId NVARCHAR(150) = NULL,
    @ElementTypeId INT = NULL,
    @ParentProcessGroupId INT = NULL,
    @ParentStepBpmnId NVARCHAR(150) = NULL,
    @ParentStepTypeId INT = NULL,
    @ParentCreationTitle NVARCHAR(MAX) = NULL,
    






























    @ExceptionCategory TINYINT = NULL,
    @CreationId INT = NULL

ProcessBAM_GetProcessesCreationsSummaries

فهرست نمونه‌های غیرآزمایشی از ProcessCreation، با پیوند اجباری کاربر آغازکننده، نسخه فرآیند، گروه و گروه ماژول بازگردانده می‌شود. کاربر پایان/لغو و اطلاعات والد پیوند اختیاری دارند. در خود SQL صفحه‌بندی و ORDER BY وجود ندارد.

هر سه بازه زمان مستقل‌اند: بازه آغاز روی CreateDate، بازه پایان روی EndCreateDate و بازه لغو روی DiscardProcessDate. ترکیب آن‌ها با AND است؛ با محدودکردن بازه پایان، نمونه‌های بی‌تاریخ پایان کنار می‌روند.

عنوان نمونه، شرح لغو و عنوان والد LIKE شامل متن هستند؛ باقی فیلترهای شناسه/وضعیت تطبیق مستقیم دارند. NULL ورودی یعنی فیلتر اعمال نشود. فیلتر Finish=0 یا Discard=0 در SQL برخلاف خروجی ISNULL، مقدار NULL ذخیره‌شده را صفر تلقی نمی‌کند.

فیلدهای والد مشخص می‌کنند این نمونه از کدام نمونه، نسخه، گروه و گام والد آغاز شده است. خالی‌بودن آن‌ها معمولاً یعنی والد متناظری در داده ذخیره نشده است.

در نسخه عمومی، ProcessGroupId اختیاری است و فیلتر ProcessId یا IsProcessActive در امضا وجود ندارد. Duration با DATEDIFF_BIG(SECOND) برحسب ثانیه محاسبه می‌شود و برای نمونه بدون زمان پایان NULL است.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• INNER JOIN به UsersTable و ModuleGroup سبب می‌شود نمونه فاقد رکورد مرجع معتبر در این فهرست نیاید، حتی اگر در شمارنده‌ای که فقط ProcessCreation را می‌خواند حضور داشته باشد.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetProcessesCreationsSummaries
    @CreationId INT = NULL,
    @CreationTitle NVARCHAR(MAX) = NULL,
    @ProcessGroupId INT = NULL,
    @IsProcessSuspended BIT = NULL,
    @ProcessGroupModuleGroupId INT = NULL,
    @StarterUserId INT = NULL,
    @StartRangeOfStartDateTime DATETIME2 = NULL,
    @EndRangeOfStartDateTime DATETIME2 = NULL,
    @Finish BIT = NULL,
    @FinisherUserId INT = NULL,
    @StartRangeOfEndDateTime DATETIME2 = NULL,
    @EndRangeOfEndDateTime DATETIME2 = NULL,
    @Discard BIT = NULL,
    @DiscarderUserId INT = NULL,
    @DiscardDescription NVARCHAR(MAX) = NULL,
    @StartRangeOfDiscardDate DATETIME2 = NULL,
    @EndRangeOfDiscardDate DATETIME2 = NULL,
    @ParentProcessGroupId INT = NULL,
    @ParentCreationTitle NVARCHAR(MAX) = NULL,
    @ParentStepBpmnId NVARCHAR(150) = NULL,
    @ParentStepTypeId INT = NULL

ProcessBAM_GetProcessesCreationsSummariesByProcessGroupId

فهرست نمونه‌های غیرآزمایشی از ProcessCreation، با پیوند اجباری کاربر آغازکننده، نسخه فرآیند، گروه و گروه ماژول بازگردانده می‌شود. کاربر پایان/لغو و اطلاعات والد پیوند اختیاری دارند. در خود SQL صفحه‌بندی و ORDER BY وجود ندارد.

هر سه بازه زمان مستقل‌اند: بازه آغاز روی CreateDate، بازه پایان روی EndCreateDate و بازه لغو روی DiscardProcessDate. ترکیب آن‌ها با AND است؛ با محدودکردن بازه پایان، نمونه‌های بی‌تاریخ پایان کنار می‌روند.

عنوان نمونه، شرح لغو و عنوان والد LIKE شامل متن هستند؛ باقی فیلترهای شناسه/وضعیت تطبیق مستقیم دارند. NULL ورودی یعنی فیلتر اعمال نشود. فیلتر Finish=0 یا Discard=0 در SQL برخلاف خروجی ISNULL، مقدار NULL ذخیره‌شده را صفر تلقی نمی‌کند.

فیلدهای والد مشخص می‌کنند این نمونه از کدام نمونه، نسخه، گروه و گام والد آغاز شده است. خالی‌بودن آن‌ها معمولاً یعنی والد متناظری در داده ذخیره نشده است.

ProcessGroupId اجباری است و ورودی‌های اختیاری ProcessId و IsProcessActive نیز اضافه شده‌اند؛ کاربر می‌تواند نمونه‌های یک نسخه و وضعیت فعال‌بودن آن نسخه را محدود کند.

تفاوت واحد مدت در قراردادها: تفاوت واقعی قرارداد توصیف‌شده: Duration در این نسخه با DATEDIFF_BIG(DAY) محاسبه می‌شود و تعداد عبور از مرز روز تقویمی را می‌دهد؛ این واحد با نسخه عمومی که SECOND است فرق دارد. این اختلاف در پیوست کیفیت داده ثبت شده است.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• اگر فرانت خروجی هر دو رویه را به‌عنوان ثانیه قالب‌بندی کند، مدت نمونه در تب گروه نادرست نمایش داده می‌شود. این موضوع نیازمند اصلاح کد است و سند نباید آن را مدت دقیق اجرا معرفی کند.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetProcessesCreationsSummariesByProcessGroupId
    @ProcessGroupId INT,
    @CreationId INT = NULL,
    @CreationTitle NVARCHAR(MAX) = NULL,
    @ProcessId INT = NULL,
    @IsProcessActive BIT = NULL,
    @IsProcessSuspended BIT = NULL,
    @ProcessGroupModuleGroupId INT = NULL,
    @StarterUserId INT = NULL,
    @StartRangeOfStartDateTime DATETIME2 = NULL,
    @EndRangeOfStartDateTime DATETIME2 = NULL,
    @Finish BIT = NULL,
    @FinisherUserId INT = NULL,
    @StartRangeOfEndDateTime DATETIME2 = NULL,
    @EndRangeOfEndDateTime DATETIME2 = NULL,
    @Discard BIT = NULL,
    @DiscarderUserId INT = NULL,
    @DiscardDescription NVARCHAR(MAX) = NULL,
    @StartRangeOfDiscardDate DATETIME2 = NULL,
    @EndRangeOfDiscardDate DATETIME2 = NULL,
    @ParentProcessGroupId INT = NULL,
    @ParentCreationTitle NVARCHAR(MAX) = NULL,
    @ParentStepBpmnId NVARCHAR(150) = NULL,
    @ParentStepTypeId INT = NULL

ProcessBAM_GetProcessCreationDetails

ورودی یک شناسه نمونه است و تمام ProcessReferences آن، همراه المان و نوع المان، گیرنده، نقش، زمان‌ها، فرم/موجودیت، یادداشت، متغیرها و خطاهای مرتبط بازمی‌گردد. ORDER BY بر ReferencesID صعودی است.

Duration اختلاف ثانیه شروع ارجاع تا ExitCartableDateTime است؛ ارجاع باز، Duration و EndDateTime تهی دارد. زمان مشاهده ViewedAt از خروج کارتابل مستقل است.

یادداشت از ProcessReferNotes.ReferenceNote گرفته می‌شود و اگر NULL باشد ReferencesExplain جایگزین می‌شود. تنظیم فرم و UserTask فقط برای نوع المان ۱ پیوند می‌شود.

متغیرهای خروجی با FK_ProcessReferenceId و خطاها با FK_ReferenceID به همان ارجاع وصل می‌شوند؛ فرم/موجودیت شامل Url، EntityId، EntityTitle، EntityTypeId، ElementConfigId و EntityMode است.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• چند یادداشت، چند لاگ متغیر و چند خطا برای یک ارجاع می‌توانند ضرب ردیف‌های JOIN ایجاد کنند. شمارش ساده ردیف خروجی معادل تعداد گام‌ها نیست؛ لایه نمایش باید برحسب شناسه ارجاع گروه‌بندی کند.
• این رویه در خود WHERE فقط شناسه نمونه دارد و فیلتر تاریخ یا TestEnvironmentId ندارد؛ دامنه مجاز نمونه باید در مسیر فراخوان کنترل شود.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetProcessCreationDetails @ProcessCreationId INT

ProcessBAM_GetProcessesCreationsVariablesLogs

از Process_AllProcessVariablesLog تمام تغییرات متعلق به شناسه‌های نمونه ورودی را می‌خواند؛ جدیدترین Id لاگ ابتدا می‌آید. هر ردیف یک ثبت تاریخی متغیر است و مقدار قبلی یا بعدی دیگری را حذف نمی‌کند.

نام کاربری با FK_UserId تکمیل می‌شود. OUTER APPLY المان ارجاع را از ProcessReferences می‌یابد؛ اگر لاگ ارجاع داشته باشد، عنوان گام و فرم UserTask مرتبط نیز استخراج می‌شود.

لیست ورودی با STRING_SPLIT شکسته و با CAST شناسه نمونه به NVARCHAR مقایسه می‌شود. رویه این لیست را به جدول INT تبدیل یا TRY_CAST نمی‌کند.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• این رویه فیلتر تاریخ، نوع متغیر یا محیط آزمایشی ندارد؛ تمام تاریخچه نمونه‌های ورودی را می‌گیرد. وجود چند ردیف برای یک نام متغیر طبیعی است.
• شناسه‌ها را به شکل عدد معمولی و با ویرگول ارسال کنید؛ صفرهای پیشرو و فاصله ابتدایی می‌توانند به‌علت مقایسه رشته‌ای با قالب شناسه ذخیره‌شده متفاوت شوند.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetProcessesCreationsVariablesLogs @ProcessesCreationsIds NVARCHAR(MAX)

ProcessBAM_GetExceptionsTypes

بدون ورودی؛ DISTINCT ExceptionType از کل ProcessErrorLogs را برای پرکردن انتخاب‌گر نوع خطا برمی‌گرداند. تنها یک ستون ExceptionType دارد.

همه ورودی‌ها، نوع و پیش‌فرض

بدون پارامتر ورودی.

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• فیلتر گروه، تاریخ و محیط آزمایشی ندارد؛ بنابراین گزینه‌ای ممکن است در انتخاب‌گر باشد که در گزارش فیلترشده فعلی هیچ ردیفی ندارد. NULL نیز در صورت وجود در داده می‌تواند بازگردد و ترتیب تضمین‌شده نیست.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetExceptionsTypes

ProcessBAM_GetStepsDurations

آمار روی ProcessReferences با پایان غیرNULL محاسبه می‌شود؛ یعنی فقط ارجاع‌های خارج‌شده از کارتابل. ورودی تاریخ روی ReferencesCreateDate (شروع گام) اعمال می‌شود، نه تاریخ ایجاد نمونه و نه تاریخ خروج گام.

پیوندهای اجباری شامل نمونه، المان، Lane و نسخه فرآیند هستند. نمونه‌های آزمایشی کنار گذاشته می‌شوند. IncludeCopies=0 فقط اصلی و =1 فقط رونوشت را می‌گیرد؛ ارجاع با IsCopy NULL هیچ‌یک را برآورده نمی‌کند.

هر ردیف شامل تعداد ارجاع و کمینه، میانگین و بیشینه DATEDIFF_BIG(SECOND) تا ExitCartableDateTime است. ترتیب بر MaximumDuration نزولی است؛ ردیف اول بیشترین تأخیر ثبت‌شده در میان ردیف‌ها را دارد.

گروه‌بندی با شناسه BPMN و نام و نوع گام و شناسه/نام Lane انجام می‌شود. نسخه‌های مختلف با همین کلیدها می‌توانند در یک ردیف ادغام شوند؛ برای تحلیل نسخه، ProcessId را در حالت گروهی مشخص کنید.

خروجی عمومی ProcessGroupId و ProcessGroupName را نیز دارد و این دو در GROUP BY هستند؛ نام مشابه گام در دو گروه با هم ادغام نمی‌شود.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• گام فاقد Lane معتبر به‌علت INNER JOIN حذف می‌شود. زمان منفی/غیرعادی به‌صورت خودکار پاک‌سازی نمی‌شود. AVG روی BIGINT ثانیه، دقت اعشاری ندارد.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetStepsDurations
    @StepTypeId INT = NULL,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @IncludeCopies BIT = 0

ProcessBAM_GetStepsDurationsByProcessGroupId

آمار روی ProcessReferences با پایان غیرNULL محاسبه می‌شود؛ یعنی فقط ارجاع‌های خارج‌شده از کارتابل. ورودی تاریخ روی ReferencesCreateDate (شروع گام) اعمال می‌شود، نه تاریخ ایجاد نمونه و نه تاریخ خروج گام.

پیوندهای اجباری شامل نمونه، المان، Lane و نسخه فرآیند هستند. نمونه‌های آزمایشی کنار گذاشته می‌شوند. IncludeCopies=0 فقط اصلی و =1 فقط رونوشت را می‌گیرد؛ ارجاع با IsCopy NULL هیچ‌یک را برآورده نمی‌کند.

هر ردیف شامل تعداد ارجاع و کمینه، میانگین و بیشینه DATEDIFF_BIG(SECOND) تا ExitCartableDateTime است. ترتیب بر MaximumDuration نزولی است؛ ردیف اول بیشترین تأخیر ثبت‌شده در میان ردیف‌ها را دارد.

گروه‌بندی با شناسه BPMN و نام و نوع گام و شناسه/نام Lane انجام می‌شود. نسخه‌های مختلف با همین کلیدها می‌توانند در یک ردیف ادغام شوند؛ برای تحلیل نسخه، ProcessId را در حالت گروهی مشخص کنید.

ProcessGroupId اجباری و ProcessId اختیاری است. ستون‌های هویت گروه از خروجی حذف شده‌اند؛ همان دامنه گروه از ورودی معلوم است.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• این گزارش تعداد نمونه یکتای فرآیند نیست؛ تکرار اجرای یک گام در یک نمونه یا چند ارجاع آن می‌تواند Count را افزایش دهد. ارجاع باز در آمار مدت نیست.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetStepsDurationsByProcessGroupId
    @ProcessGroupId INT,
    @ProcessId INT = NULL,
    @StepTypeId INT = NULL,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL,
    @IncludeCopies BIT = 0

ProcessBAM_GetStepsExceptions

خطاهای ProcessErrorLogs به نمونه غیرآزمایشی، نسخه و گروه وصل می‌شوند و تاریخ روی PEL.CreateDate (وقوع خطا) اعمال می‌شود. هر رکورد خطا یک واحد Count است.

انتساب گام در این رویه با CROSS APPLY و TOP(1) از آخرین ارجاع نمونه برحسب ReferencesID DESC انجام می‌شود. بنابراین گام گزارش‌شده آخرین گام ارجاعی نمونه است و الزاماً همان FK_ElementID یا FK_ReferenceID ثبت‌شده روی خطا نیست.

فیلتر StepTypeId روی نوع همین آخرین گام اعمال می‌شود. گروه‌بندی بر شناسه BPMN، نام و نوع گام است و خروجی بر Count نزولی مرتب می‌شود.

نسخه عمومی هویت گروه را نیز در خروجی و GROUP BY دارد.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• نمونه بدون ارجاع به‌علت CROSS APPLY از این گزارش حذف می‌شود. این شمارش تحلیل محل واقعی وقوع خطا نیست؛ برای آن از ستون‌های المان در فهرست خطا استفاده کنید.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetStepsExceptions
    @StepTypeId INT = NULL,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL

ProcessBAM_GetStepsExceptionsByProcessGroupId

خطاهای ProcessErrorLogs به نمونه غیرآزمایشی، نسخه و گروه وصل می‌شوند و تاریخ روی PEL.CreateDate (وقوع خطا) اعمال می‌شود. هر رکورد خطا یک واحد Count است.

انتساب گام در این رویه با CROSS APPLY و TOP(1) از آخرین ارجاع نمونه برحسب ReferencesID DESC انجام می‌شود. بنابراین گام گزارش‌شده آخرین گام ارجاعی نمونه است و الزاماً همان FK_ElementID یا FK_ReferenceID ثبت‌شده روی خطا نیست.

فیلتر StepTypeId روی نوع همین آخرین گام اعمال می‌شود. گروه‌بندی بر شناسه BPMN، نام و نوع گام است و خروجی بر Count نزولی مرتب می‌شود.

علاوه بر گروه اجباری، ProcessId اختیاری برای یک نسخه دارد. هویت گروه در خروجی تکرار نمی‌شود.

همه ورودی‌ها، نوع و پیش‌فرض

همه ستون‌های خروجی

نکات تفسیر و اختلاف‌های مهم پیاده‌سازی

• نام نمایشی «تعداد نمونه» اگر برای Count به کار رود، معنای SQL را دقیق منتقل نمی‌کند: یک نمونه با سه خطا، سه واحد است. همچنین گام ممکن است از زمان ثبت خطا جلو رفته باشد.

CREATE OR ALTER PROCEDURE dbo.ProcessBAM_GetStepsExceptionsByProcessGroupId
    @ProcessGroupId INT,
    @ProcessId INT = NULL,
    @StepTypeId INT = NULL,
    @FromDateTime DATETIME = NULL,
    @ToDateTime DATETIME = NULL