İş Axını Admini — ilişib qalmış iş axınlarını düzəltmək

Nə öyrənəcəksiniz#

• İş Axını Adminini nə vaxt və niyə istifadə etmək
• İlişib qalmış iş axınını necə tapmaq və nəyin səhv getdiyini diaqnostika etmək
• Mövcud admin əməliyyatları və hər birini nə vaxt istifadə etmək
• Nəsə ilişib qalıbsa, izləyə biləcəyiniz standart diaqnostika axını

İş Axını Admini nədir#

Əksər vaxt sənəd təsdiqdən heç bir problemlə qarşılaşmadan keçir: tapşırıqlar təyin edilir, təsdiqçilər onlar üzərində hərəkət edir və sənəd Təsdiqlənmiş və ya Rədd edilmiş statusa çatır. Amma bəzən nələrsə adi istifadəçi baxışından səssizcə iş axınını dayandıracaq şəkildə səhv gedir:

• Tapşırıq indi boş olan vəzifəyə təyin edildi (şəxs ayrıldı; heç kim onu əvəz etmədi).
• Xarici sistemə istinad edən callback URL cavab verməyi dayandırdı.
• Tapşırıqlar arasında VAT Portal-ın işlətdiyi icra skripti pis məlumat üzərində uğursuz oldu.

Bu kimi bir şey baş verdikdə, iş axını motoru nümunəni Təmir statusuna dayandırır. Adi istifadəçilər sənədlərinin əbədi olaraq "Təsdiqdə" qaldığını görürlər. İş Axını Admini məhz burada gəlir: adminlərə bir nümunənin niyə ilişib qaldığını görmək və onu azad etmək üçün hərəkət etmək imkanı verən diaqnostika və təmir alətidir.

İş Axını Adminini açmaq#

Yan paneldə Sənəd Dövriyyəsi → İş Axını Admini. Qeyd yalnız hesabınızda icazəsi varsa görünür — xüsusilə wfl_instance resursu. Görmürsünüzsə, girişiniz yoxdur.

Siyahı səhifəsi — ilişib qalmış nümunəni tapmaq#

İş Axını Admini siyahısı şirkətinizdəki hər iş axını nümunəsini göstərir.

Səhifənin yuxarısında:

• Altı status süzgəc tabı: Hamısı, Aktiv, Təsdiqlənmiş, Rədd edilmiş, FailedToInitiate və Təmir. Təmir tabı qəsdən sarı vurğulanıb — diqqət çəkir, çünki adətən bu, maraqlandığınızdır.
• Sənəd ID axtarışı sahəsi — istifadəçi sizə sənəd nömrəsini veribsə və onun iş axını nümunəsinə birbaşa atlamaq istəyirsinizsə faydalıdır.

Cədvəl göstərir:

• Nümunə ID-si
• Sənəd ID-si
• Status (rəng-kodlu nişan)
• Yaradan (şəxsin adına həll edilir)
• Yaradılma / Yenilənmə vaxt möhürləri
• Şərh (varsa qısa qeyd)

Detal səhifəsini açmaq üçün hər hansı sətirə klikləyin.

Detal səhifəsi — problemi diaqnostika etmək#

İlişib qalmış nümunəyə kliklədikdə, nəyin səhv getdiyini anlamaq üçün lazım olan hər şeyi olan ətraflı görünüş alırsınız.

Ümumi Məlumat və Callback URL-ləri#

Yuxarıda iki kart əsasları göstərir:

• Ümumi Məlumat — Nümunə ID-si, İş Axını ID-si, Sənəd ID-si (kliklənə bilən — sənədin detal səhifəsini eyni tabda açır), cari status, əlavə edilmiş hər hansı şərh.
• Callback URL-ləri — iş axınında konfiqurasiya edilmiş initUrl və completeUrl. Bunlar VAT Portal-ın iş axını başladıqda və bitdikdə çağırdığı xarici HTTP endpoint-lərdir. Səhv konfiqurasiya edilmiş URL-lər ilişib qalmış iş axınlarının ümumi mənbəsidir.

Tapşırıq Nümunələri#

İş axını nümunəsində hər tapşırığı siyahılayan yığıla bilən cədvəl:

• Tapşırıq adı, addım nömrəsi (cons), status, onu kim tamamladı (varsa), hər hansı şərh və həmin tapşırıq xəta verərsə 0-dan çox nömrə göstərən Xəta sütunu.

Tapşırıq-başına əməliyyatlar (yeniləmə icazəniz varsa):

• Push Nəticəsini Redaktə Et — tapşırıq tamamlandıqdan sonra işləyən webhook-u konfiqurasiya et.
• Təsdiqi Soruşmağı Redaktə Et — təsdiq istəmək üçün işləyən webhook-u konfiqurasiya et.
• Push Nəticəsini Tetikle — artıq təsdiqlənmiş tapşırıq üçün push-nəticə callback-i əllə işlədin. Yalnız Təsdiqlənmiş tapşırıqlar üçün görünür. Orijinal çağırış uğursuz olduqda və yenidən cəhd etmək istədikdə faydalıdır.

Skriptlər — əsas diaqnostika aləti#

Skriptlər VAT Portal-ın iş axınını emal edərkən işlətdiyi kiçik daxili əmrlərdir — "bu tapşırığı aktivləşdir", "bu webhook-u işlət", "növbəti addıma keç" kimi şeylər. Skriptlər kartı bu nümunə üçün icra edilmiş (və ya cəhd edilmiş) hər skripti sıra ilə siyahılayır.

• Uğurlu skriptlər normal görünür.
• Uğursuz skriptlər qırmızı rəngdə vurğulanır — qırmızı sol çərçivə, fonda qırmızı rəng, skript təfərrüatlarının altında qırmızı mətndə xəta mesajı.

Bu diaqnostika üçün ən faydalı yeganə kartdır. İş axını ilişib qalıbsa, bu skriptlərdən biri uğursuz olub; xəta mesajı adətən sadə İngilis dilində nəyin səhv getdiyini sizə dəqiq deyir:

• "42 vəzifə ID-si üçün aktiv istifadəçi tapılmadı" → vəzifə boşdur, ona istifadəçi təyin edin
• "URL-ə çatmaq mümkün deyil: http://erp.internal/api/callback" → callback endpoint sönükdür və ya səhv konfiqurasiya olunub
• "Sahə dəyəri rəqəmə çevrilə bilmir" → sənəddəki məlumat şərtin gözlədiyinə uyğun gəlmir

Xətanı gördükdən sonra nəyi düzəltməli olduğunuzu bilirsiniz.

Admin Əməliyyatları#

Admin Əməliyyatları kartı dəyişikliklər etdiyiniz yerdir. Mövcud düymələr nümunə statusundan və icazələrinizdən asılıdır.

Standart diaqnostika axını#

Əksər real insidentləri əhatə edən rutin:

1. İş Axını Admini açın → Təmir-ə süzün. Heç bir şey yoxdursa, sistem ilişib qalmayıb — istifadəçi ilə həqiqi sənəd ID-si üçün yoxlayın, onu axtarın və statusuna baxın.
2. Detal səhifəsini açmaq üçün ilişib qalmış nümunəyə klikləyin.
3. Skriptlər kartına sürüşdürün. İlk qırmızı vurğulanmış skripti axtarın. Onun xəta mesajını oxuyun.
4. Kök səbəbi düzəldin — İş Axını Adminindən kənarda. Nümunələr:
   • Boş vəzifə → HR → Vəzifələr → İşçilər bölməsinə gedin və birini təyin edin.
   • Pis callback URL → bu eyni səhifədəki Admin Əməliyyatları kartına qayıdın və onu düzəltmək üçün URL-ləri Yenilə üzərinə klikləyin.
   • İstifadəçi silindi → ya HR-da yenidən təyin edin, ya da uyğun olaraq URL-ləri Yeniləyin.
   • Şərt qiymətləndirmə xətası → iş axınının dizaynı özü Axın Redaktorunda düzəldilməlidir; cari ilişib qalmış nümunə üçün Rədd etmək və istifadəçidən düzəltməsini və yenidən göndərməsini xahiş etmək çox vaxt ən sürətli yoldur.
5. Yenidən Aktivləşdir üzərinə klikləyin. İş axını dayandığı nöqtədən davam edir. Təmiz işləyərsə, status Təmirdən çıxır və ilişib qalmış sənəd davam edir.
6. Yenidən Aktivləşdir uğursuz olarsa (skript yenidən uğursuz olur), yeni xəta mesajını oxuyun və 4-cü addıma qayıdın.

Kök səbəbi düzəldilə bilmirsə və nümunə bitməlidir, səbəbini aydın izah edən şərhlə Rədd Edin. İstifadəçi sonra təzə iş axını işi kimi düzəldib yenidən göndərə bilər.

Tapşırıq-başına admin əməliyyatları (Push Nəticəsi / Təsdiqi Soruş)#

Fərdi tapşırıqlardakı webhook tənzimləmələri xarici sistemlərlə inteqrasiyalar üçün mövcuddur. Əksər adminlər bunlara toxunmayacaq — onlar iş axını dizayn edildikdə bir dəfə qurulur və sonra tək buraxılır. Aşağıdakı hallarda onlara ehtiyacınız ola bilər:

• Xarici sistem öz endpoint-ini dəyişdi və bu konkret nümunə üçün webhook URL-i yenilənməlidir.
• Push-nəticə callback-i ilkin olaraq uğursuz oldu (xarici sistem sönükdü) və indi geri qayıtdıqdan sonra yenidən cəhd etmək istəyirsiniz — callback-i əl ilə işlətmək üçün Təsdiqlənmiş tapşırıqda Push Nəticəsini Tetikle istifadə edin.

Bunları redaktə edib-etməməyi bilmirsinizsə, etməyin. Orijinal inteqrasiyanı quran şəxslə danışın.

Ümumi suallar#