انجمن‌ها

function WS_GetCurrentUserInf(const ADBName: String): String;

Created: Version 12.10.00

این تابع، مشخصات کاربر جاری در یک سیستم اطلاعاتی خاص را به صورت یک رشته حرفی با فرمت JSON تولید می کند.

{"_ErrNo":"0",

 "_Num":"34",

 "_Name":"\u062A\u0633\u062A",

 "_NTName":"web_service_clt",

 "_Dept":"5",

 "_Type":"3",

 "_Password":"D3E6F5EE",

 "_AuthGroups":"98, 40"

 "_FSet":"",

 "_DList":"",

 "_USetts":"",

 "_WSCL":"100"}

شرح ویژگیهای خروجی Json

function jsonToArray(jsonStr) {

  try {

    let obj = JSON.parse(jsonStr);

    function convert(value) {

      if (typeof value === "object" && value !== null) {

        if (Array.isArray(value)) {

          // اگر مقدار یک آرایه باشه، هر عضو رو جداگانه پردازش کن

          return value.map(item => convert(item));

        } else {

          // اگر مقدار یک آبجکت باشه

          return Object.entries(value).map(([key, val]) => ({

            key,

            value: convert(val)

          }));

        }

      }

      return value; // مقادیر ساده (string, number, etc.)

    }

    return convert(obj);

  } catch (e) {

      throw "JSON نامعتبر است:" + e.message;

    return [];

  }

}

function WorkTaskCurUserInf(){;

   ReposUtils.HostURL = "nosa-test";

   ReposUtils.UserName = "nosa/tariverdi";

   var res="";

   res=ReposUtils.WS_GetCurrentUserInf("_ReposXP_Workflow" ) ;

   var farsiRes=jsonToArray(res);

   WorkState.ReturnText=JSON.stringify(farsiRes);  

}

 توضیح این که در این مثال برای خوانا شدن متنهای فارسی و تفکیک ویژگیها از تابعی بنام jsonToArray  برای تبدیل خروجی  Json به یک آرایه استفاده شده است. بدیهی است که این تابع در هر برنامه گردش کار فقط یک بار درج می شود لذا در بخشهای بعدی که به توابع دیگر مرتبط با کاربران می پردازد از تکرار این بخش از اسکریپت صرف نظر می کنیم و فرض می کنیم تابع jsonToArray در برنامه گردش کار وجود دارد.

نکته مهم: آنچه در این فایل به عنوان کاربر جاری نمایش داده می شود کاربری است که برای ReposUtils.UserName تعیین شده است که در این مثال «nosa/tariverdi» است و نام فارسی آن «آقای تاریوردی» در مشخصه _Name نمایش داده شده است.

ضمنا این کاربر عضوگروههای کاربران با کلیدهای 94، 188 و 228 است که نام این گروهها را در جدول زیر مشاهده می کنید:

شماره ردیف و «نام در ویندوز» این گروهها به شکل زیر در جدول کاربران قابل مشاهده است:

2-اطلاعات یک کاربر خاص

این تابع مشخصات یک کاربر خاص را به صورت یک رشته حرفی با فرمت JSON برمی گرداند.

شرح پارامترهای تابع

• ADBName (نام پایگاه) : در این پارامتر، نام پایگاه بصورت رشته حرفی درج می شود. برای مثال "_ReposXP_Workflow"
• AKey (کلید کاربر): کلید کاربر مورد نظر خود را در این قسمت وارد کنید.
• AGetPicture (تصویر پرسنلی دارد): یک ویژگی Boolean است که مقدار 0 به معنیFalse   و عدم تولید تصویر پرسنلی در فایل خروجی است و هر عدد دیگر به معنی True و دخیره تصویر به فرم base64 در خروجی Json است.
• AGetSignature (تصویر امضا دارد): این پارامتر نیز ماهیت Boolean دارد و با مقدار 0 (False) تعیین می کند که نیازی به تولید تصویر امضای کاربر نیست و در غیر این صورت تصویر امضای کاربر نیز به فرم base64 در خروجی Json درج می گردد.

الگوی خروجی تابع

شرح ویژگیهای خروجی Json

این رشته حرفی شامل ویژگیهای زیر است:

1. _ErrNo(کدخطا): اگر اجرای تابع با خطا روبرو شود در اینجا کد خطا نمایش داده می شود. شماره 0  به معنی عدم وجود خطاست.
2. _Name (نام کاربر): توجه کنید که این مشخصه نام فارسی کاربر است که در هنگام تعریف کاربر تعیین می شود و منظور «نام در ویندوز» نیست.
3. _Sid (شماره شناسایی ویندوز کاربر): اگر کاربر به عنوان یک user در سیستم عامل ویندوز تعریف شده باشد، آنگاه یک شماره شناسایی ویندوز خواهد داشت.
4. _IsGroup (وضعیت گروه کاربر) : این مشخصه یک مقدار boolean است که اگر مقدار آن 0 باشد به معنی false است یعنی این که این کاربر از جنس گروه نیست. و در غیر این صورت هر مقدار دیگر (مثلا -1) به معنی true و نشان دهنده این است که کاربر از جنس گروه است.

5. _Dept (بخش کاربر): کلید بخش کاربر را در این ویژگی مشاهده می کنید. در اینجا منظور از بخش، بخشهای مستقل از جایگاه سازمانی است. مثلا بخش 1: مرکزی
6. _OrgPosition (کلید جایگاه سازمانی): در جدول جایگاههای سازمانی هر جایگاه دارای یک کلید است که در این ویژگی  قرار می گیرد. مثلا کلید جایگاه سازمانی پشتیبانی کتابخانه 44 است.
7. _OrgDept (بخش جایگاه سازمانی): بعضی از بخشها در درخت جایگاه سازمانی بکار می رود که در اینجا کلید بخش جایگاه سازمانی درج می شود. مثلا جایگاه سازمانی 43 (پشتیبانی مالی) به بخش تهران (کلید 7) مرتبط است
8. _OrgRole (نقش کاربر در جایگاه سازمانی): اگر کاربر از نوع عادی باشد این ویژگی برابر با عدد صفر و اگر مدیر باشد برابر با عدد 1 خواهد بود.
9. _SMSUPN (شناسه SMS کاربر): شماره موبایل کاربر که می تواند از طریق این شناسه و از طریق موبایل به سرویس وب سیستم متصل شود. مثلا: 09123456789
10. _OAuthUPN (شناسه Google کاربر): کاربران می توانند از طریق حساب گوگل خود به سرویس وب فرایند متصل شوند. anyaddress@gmail.com
11. Picture (تصویر پرسنلی کاربر) : اگر پارامتر AGetPicture را true تعیین کرده باشید آنگاه تصویر کاربر به فرم base64 در خروجی درج خواهد شد.
12. Signature (تصویر امضای کاربر): اگر پارامتر AGetSignature را true تعیین کنید آنگاه تصویر امضای کاربر نیز به فرم base64 در خروجی Json ثبت خواهد شد.

مثال: اطلاعات یک کاربر نمونه (تاریوردی با کلید 9)

برای استخراج اطلاعات یک کاربر معین می توانید از اسکریپت زیر در برنامه گردش کار استفاده کنید:

ملاحظه می کنید که در تابع WS_GetUserDataByKey پارامتر کلید کاربر (AKey)  مقدار 9 و پارامتر AGetPicture  برابر با 1- یعنی true تعیین شده و برعکس برای پارامتر AGetSignature مقدار 0 یا false تعیین شده است لذا باید همانطور که در شکل زیر مشاهده می کنید، در فایل خروجی json ، تصویر پرسنلی کاربر را نیز داشته باشیم:

function WS_GetUserDataByKeyList(const ADBName: String; const AKeyList: String;

AGetPicture, AGetSignature: Boolean): String;

Created: Version 15.50.02

{"_ErrNo":"0",

 "UserArray":[

{"_Key":"1",

 "_Name":"\u062A\u0639\u064A\u064A\u0646 \u0641\u0631\u0645\u062A",

 "_Sid":" 0105000000000005150000005df6451234567890abcdef",

 "_IsGroup":"0",

 "_Dept":"5",

 "_OrgPosition":"120",

 "_OrgDept":"5",

 "_OrgRole":"1",

 "_SMSUPN":"09121234567",

 "_OAuthUPN":"user@gmail.com",

 "Picture":{"CDATA":"…"},

 "Signature":{"CDATA":"…"}},

.

.

 ]}

function WorkTaskUserArrayInf(){;

   ReposUtils.HostURL = "nosa-test";

   ReposUtils.UserName = "nosa/tariverdi";

   var res="";

   res=ReposUtils.WS_GetUserDataByKeyList("_ReposXP_workflow","8, 13");

   var farsiRes=jsonToArray(res);

   WorkState.ReturnText=JSON.stringify(farsiRes);  

توضیح: در این مثال برای خوانا شدن متنهای فارسی و تفکیک ویژگیها از تابعی بنام jsonToArray  برای تبدیل خروجی  Json به یک آرایه استفاده شده است. برای آشنای بیشتر با محتوا و عملکرد این تابع به بخش اول این مستند مراجعه کنید.

4-اطلاعات فهرست کاربران

این تابع، مشخصات فهرست کاربران یک سیستم اطلاعاتی را به صورت یک رشته حرفی با فرمت JSON تولید می کند.

شرح پارامترهای تابع

• ADBName (نام پایگاه) : در این پارامتر، نام پایگاه بصورت رشته حرفی درج می شود. برای مثال "_ReposXP_Workflow"
• ) AURKindنوع جایگاه سازمانی کاربر): این مشخصه مقادیر زیر را در بر می گیرد:

  0(آزاد): جایگاه سازمانی در نظر گرفته نشود: یعنی تمام کاربران اعم از کاربرانی که دارای جایگاه سازمانی هستند و کاربران بدون جایگاه سازمانی فهرست شود.

 ) 1تمام جایگاه‌های سازمانی):  یعتی در فایل خروجی فقط کاربران دارای جایگاه سازمانی فهرست شود. به عبارت دیگر کاربران بدون جایگاه سازمانی از این فهرست حذف می شود.

2 (جایگاه سازمانی خاص): تنها کاربرانی که دارای یک جایگاه سازمانی خاص هستند باید فهرست شوند. کلید این جایگاه سازمانی توسط پارامتر AURKey تعیین می‌شود:

• AURKey  (کلید جایگاه سازمانی کاربر): در حالتی که مقدار پارامتر نوع جایگاه سازمانی کاربر (AURKind) برابر با 2 باشد آنگاه در این پارامتر کلید جایگاه سازمانی مورد نظر را باید تعیین کنید.
• ) ADeptKind نوع بخش کاربر): انواع بخش با مقادیر زیر تعیین می شود.

0  (آزاد): بخش در نظر گرفته نشود: یعنی تمام کاربران بدون توجه به بخش آنها، فهرست شود.

1  (بخش کاربر جاری): یعنی تمام کاربران دارای بخش مشابه با بخش کاربر جاری فهرست شود.

2  (بخش خاص) : بعنی تنها کاربران یک بخش خاص فهرست شودند که کلید این بخش توسط پارامتر ADeptKey بیان می‌شود

• ADeptKey  (کلید بخش کاربر): در حالتی که مقدار پارامتر نوع بخش کاربر (ADeptKind) برابر با 2 باشد باید در این پارامتر، کلید بخش خاص مورد نظر خود را وارد کنید.

 الگوی خروجی تابع

خروجی این تابع، یک رشته حرفی به فرمت JSON و شامل ویژگیهای زیر است:

شرح ویژگیهای خروجی Json

این رشته حرفی شامل ویژگیهای زیر است:

1. _ErrNo(کدخطا): اگر اجرای تابع با خطا روبرو شود در اینجا کد خطا نمایش داده می شود. شماره 0  به معنی عدم وجود خطاست.
2. UserArray (آرایه کاربران): اطلاعات کاربران به شکل یک آرایه تولید می شود که هر عضو این آرایه حاوی یک کاربر با مشخصات زیر است:

• _Key (کلید کاربر): هر کاربر در فهرست کاربران دارای یک کلید عددی است که در این مشخصه نمایش داده می شود.
• _Name (نام کاربر): توجه کنید که این مشخصه نام کاربر است که در هنگام تعریف کاربر تعیین می شود و منظور نام در ویندوز نیست.
• _Sid (شماره شناسایی ویندوز کاربر): اگر کاربر عضو Active Directory شبکه باشد، آنگاه یک شماره شناسایی ویندوز خواهد داشت.
• _IsGroup (وضعیت گروه کاربر) : این مشخصه یک مقدار boolean است که اگر مقدار آن 0 باشد به معنی false است یعنی این که این کاربر از جنس گروه نیست. و در غیر این صورت هر مقدار دیگر (مثلا -1) به معنی true و نشان دهنده این است که کاربر از جنس گروه است.

• _Dept (بخش کاربر): کلید بخش کاربر را در این ویژگی مشاهده می کنید. در اینجا منظور از بخش، بخشهای مستقل از جایگاه سازمانی است. مثلا بخش 1: مرکزی

• _SMSUPN (شناسه SMS کاربر): کاربران می توانند از طریق این شناسه و از طریق موبایل به سرویس وب سیستم متصل شوند.
• _OAuthUPN (شناسه Google کاربر): کاربران می توانند از طریق حساب گوگل خود به سرویس وب فرایند متصل شوند.

مثالها

مثال 1: فهرست تمام کاربران سیستم اطلاعاتی «تست گردش کار»

برای این کار می توانید اسکریپت زیر را در برنامه گردش کار استفاده کنید:

ملاحظه می کنید که در تابع GetUserList تنها از پارامتر نام پایگاه استفاده شده است و این به معنی عدم محدودیت برای فهرست کاربران است و لذا از این طریق فهرست تمام انواع کاربران به شکل زیر تولید می شود:

res=ReposUtils.WS_GetUserList("_ReposXP_workflow", 2, 44);

همانطور که می بینید این فهرست کاملا منطبق با فهرست کاربران جایگاه سازمانی «پشتیبانی کتابخانه (بخش تهران)» است.

مثال 3: فهرست کاربران بخش «کاربران گوگل»

با توجه به اینکه می دانیم کلید بخش «کاربران گوگل» برابر با 6 است لذا پارامترهای تابع WS_GetUserList به شکل زیر تعیین می شود:

ملاحظه می کنید که پارامتر AdeptKind (نوع بخش) برابر با 2 و پارامتر AdeptKey (کلید بخش) برابر با 6 تعیین شده است. به این ترتیب خروجی فهرست کاربران به شکل زیر خواهد بود: