فهرست انواع محتوای منابع دیجیتال در یک پایگاه
function WS_GetContentKindList(const ADBName: String): String;
Created: Version 12.10.00
این تابع فهرست انواع محتوای منابع دیجیتال در یک پایگاه خاص را به صورت یک رشته حرفی با فرمت JSON تولید می کند.
شرح پارامترهای تابع
- ADBName (نام پایگاه) : در این پارامتر، نام پایگاه بصورت رشته حرفی درج می شود. برای مثال "_ReposXP_Workflow"
الگوی خروجی تابع
خروجی این تابع، یک رشته حرفی به فرمت JSON و شامل ویژگیهای زیر است:
{"_ErrNo":"0",
"ContentKindArray":[{
"_ID":"53",
"_Name":"\u0643\u0644 \u0627\u062B\u0631",
"_MatchKey":"COMPLETE FORM",
"_EngName":"Complete Form",
"_Code":"1",
"Thumbnail":{}},
.
.
]}
شرح ویژگیهای خروجی Json
این رشته حرفی شامل ویژگیهای زیر است:
- _ErrNo(کدخطا): اگر اجرای تابع با خطا روبرو شود در اینجا کد خطا نمایش داده می شود. شماره 0 به معنی عدم وجود خطاست.
- ContentKindArray (آرایه انواع محتوا): این ویژگی خود یک آرایه است که اعضای این آرایه هر کدام حاوی مشخصات یکی از انواع محتواست. هر عضو این آرایه حاوی داده های زیر است:
- _ID (شناسه نوع محتوا): تمام انواع محتوای پایگاه در یک جدول ذخیره شده است که هر نوع محتوا با یک شناسه (id) عددی شناخته میشود.
- _Name (نام نوع محتوا): در اینجا نام فارسی نوع محتوا به فرمت Escaped Unicode قرار می گیرد که در حالت عادی خوانا نیست اما به همین شکل قابل انتقال و پردازش است. البته به ترتیبی که در مراحل بعد شرح داده می شود می توانیم برای تست، این فرمت را بصورت فارسی خوانا تبدیل کنیم .
- _MatchKey (عبارت کلیدی): هر نوع محتوا یک عبارت کلیدی به انگلیسی دارد که در این قسمت مشخص می شود.
- _EngName (نام لاتین): نام انگلیسی نوع محتوا
- _Code (کد نوع محتوا) : کد شماره ای است که کاربر به نوع محتوا می دهد و در ستون «کد » از محاوره انواع محتوا مشاهده می شود.
- Thumbnail (عکس کوچک): اگر نوع محتوا دارای عکس کوچک باشد در فایل خروجی به فرمت base64 نمایش داده می شود.
مثال: فهرست انواع محتوای پایگاه «تست گردش کارها »
برای این کار می توانید از اسکریپت زیر در برنامه گردش کار استفاده کنید:
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 WorkTaskWFCategoryList() {
ReposUtils.HostURL = “nosa-test”;
ReposUtils.UserName = “nosa/tariverdi”;
var res=””;
res=ReposUtils.WS_GetContentKindList(“_ReposXP_workflow" ) ;
let farsiRes=jsonToArray(res);
WorkState.ReturnText=JSON.stringify(farsiRes);
}
در این مثال، مشخصات تمام انواع محتوای پایگاه تست گردش کار (_ReposXP_workflow) به شکل زیر نمایش داده می شود. که البته در این شکل به دلیل تعداد زیاد انواع محتوا، بخشی از فایل را می بینید. توضیح این که در این مثال برای خوانا شدن متنهای فارسی و تفکیک ویژگیها از تابعی بنام jsonToArray برای تبدیل خروجی Json به یک آرایه استفاده شده است:
ملاحظه می کنید که نوع محتوای «فرایند» دارای یک تصویر کوچک (Thumbnail) است که این تصویر به فرمت base64 ذخیره شده است. این همان تصویری است که در محاوره انواع محتوا برای فرایند ذخیره شده است:
