دليل مرجعي لدالات تعبير سير العمل في Azure Logic Apps وPower Automate

مقالة
12/15/2023

ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)

بالنسبة إلى تعريفات سير العمل في Azure Logic Apps وPower Automate، تحصل بعض التعبيرات على قيمها من إجراءات وقت التشغيل التي يمكن ألا تكون موجودة بعد عند بدء تشغيل سير العمل. للإشارة إلى القيم الموجودة في هذه التعبيرات أو معالجتها، يمكنك استخدام دالات التعبير التي تتيحها Workflow Definition Language.

إشعار

تنطبق هذه الصفحة المرجعية على كل من Azure Logic Apps وPower Automate، ولكنها تظهر في الوثائق الخاصة بـ Azure Logic Apps. على الرغم من أن هذه الصفحة تشير تحديدًا إلى مهام سير عمل تطبيق المنطق إلا أن هذه الدالات تعمل لكل من التدفقات ومهام سير عمل تطبيق المنطق. للمزيد من المعلومات عن الدالات والتعبيرات في Power Automate، راجع استخدام التعبيرات في الشروط.

على سبيل المثال، بإمكانك حساب القيم باستخدام الدالات الرياضية، مثل الدالة add() عندما تريد المجموع من الأعداد الصحيحة أو العشرية. فيما يلي أمثلة أخرى على المهام التي بإمكانك القيام بها باستخدام الدالات:

المهمة	صيغة الدوال	النتيجة
إرجاع سلسلة بتنسيق أحرف صغيرة.	toLower('<text>') على سبيل المثال: toLower('Hello')	"hello"
قم بإرجاع معرّف فريد عمومي (GUID).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

للعثور على الدالات استنادًا إلى الغرض العام منها، راجع الجداول الموضحة أدناه. أو للحصول على معلومات مفصلة عن كل دالة، راجع القائمة الأبجدية.

الدالات في التعبيرات

لإظهار كيفية استخدام دالة في تعبير، يوضح هذا المثال كيف بإمكانك الحصول على القيمة من المعلمة customerName وتعيين هذه القيمة إلى الخاصية accountName باستخدام الدالة parameters() في تعبير:

"accountName": "@parameters('customerName')"

فيما يلي بعض الطرق العامة الأخرى التي بإمكانك من خلالها استخدام الدالات في التعبيرات:

المهمة	بناء جملة الدالة في تعبير
تطبيق العمل مع عنصر عن طريق تمرير هذا العنصر إلى دالة.	"@<functionName>(<item>)"
1. احصل على قيمة parameterName عن طريق استخدام الدالة المتداخلة `parameters()`. 2. طبق العمل مع النتيجة عن طريق تمرير تلك القيمة إلى functionName.	"@<functionName>(parameters('<parameterName>'))"
1. احصل على نتيجة من الدالة الداخلية المتداخلة functionName. 2. مرر النتيجة إلى الدالة الخارجية functionName2.	"@<functionName2>(<functionName>(<item>))"
1. احصل على النتيجة من functionName. 2. نظرًا إلى أن النتيجة هي عنصر مع خاصية propertyName، احصل على قيمة تلك الخاصية.	"@<functionName>(<item>).<propertyName>"

على سبيل المثال، من الممكن أن تأخذ الدالة concat() قيمتين أو أكثر من قيم السلسلة كمعلمات. تجمع هذه الدالة بين هذه السلاسل في سلسلة واحدة. يمكنك إما تمرير القيم الحرفية للسلسلة، على سبيل المثال، «Sophia» و«Owen» حتى تحصل على سلسلة مجمعة، «SophiaOwen»:

"customerName": "@concat('Sophia', 'Owen')"

أو بإمكانك الحصول على قيم سلسلة من المعلمات. يستخدم هذا المثال الدالة parameters() في كل معلمة concat() والمعلمات firstName وlastName. ثم تمرر السلاسل الناتجة إلى الدالة concat() بحيث تحصل على سلسلة مدمجة، على سبيل المثال، «SophiaOwen»:

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

في كلتا الحالتين، يعين كلا المثالين النتيجة إلى الخاصية customerName.

اعتبارات لاستخدام الدالات

لا يقوم المصمم بتقييم تعبيرات وقت التشغيل التي تستخدم كمعلمات دالة في وقت التصميم. يتطلب المصمم إمكانية تقييم جميع التعبيرات بشكل كامل في وقت التصميم.
يتم تقييم معلمات الدالة من اليسار إلى اليمين.
في بناء جملة تعريفات المعلمة، علامة الاستفهام (؟) التي تظهر بعد المعلمة تعني أن المعلمة اختيارية. على سبيل المثال، يرجى مراجعة getFutureTime().
تتطلب تعبيرات الدالات التي تظهر مضمنة مع نص عادي إحاطة أقواس متعرجة ({}) لاستخدام تنسيق التعبير المستوفي القيم بدلاً من ذلك. يساعد هذا التنسيق في تجنب مشاكل التحليل. في حالة عدم ظهور تعبير الدالة مضمنًا مع نص عادي، فلا يلزم وجود أقواس متعرجة.

يوضح المثال التالي بناء الجملة الصحيح وغير الصحيح:

صحيح: "<text>/@{<function-name>('<parameter-name>')}/<text>"

غير صحيح: "<text>/@<function-name>('<parameter-name>')/<text>"

موافق: "@<function-name>('<parameter-name>')"

تنظم الأقسام التالية الدالات بناءً على غرضها العام، أو بإمكانك تصفح هذه الدالات بترتيب أبجدي.

دالات السلسلة

للعمل مع السلاسل، يمكنك استخدام دالات السلسلة هذه وكذلك بعض دالات المجموعة. تعمل دالات السلسلة فقط على السلاسل.

دالة السلسلة	المهمة
قطعه	تقسيم سلسلة أو مجموعة إلى مجموعات متساوية الطول.
concat	ضم سلسلتين أو أكثر، ثم إرجاع السلسلة المدمجة.
endsWith	التحقق مما إذا كانت سلسلة تنتهي بالسلسلة الفرعية المحددة.
formatNumber	إرجاع الرقم كسلسلة بناءً على التنسيق المحدد
دليل	إنشاء معرف فريد عمومي (GUID) كسلسلة.
indexOf	إرجاع موضع البداية لسلسلة فرعية.
isFloat	إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة.
isInt	إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن عدد صحيح.
lastIndexOf	إرجاع موضع البداية لآخر تكرار لسلسة فرعية.
الطول	إرجاع عدد العناصر في سلسلة أو مصفوفة.
nthIndexOf	إرجاع موضع البداية أو قيمة الفهرس حيث يتضح التكرار nلسلسلة فرعية في سلسلة.
replace	استبدال سلسلة فرعية بالسلسلة المحددة، ثم إرجاع السلسلة المحدثة.
slice	أرجع سلسلة فرعية بتحديد موضع أو قيمة البداية والنهاية. يرجى مراجعة السلسلة الفرعية أيضًا.
split	إرجاع مصفوفة تحتوي على سلاسل فرعية مفصولة بفاصلات من سلسلة أكبر استناداً إلى حرف محدد معين في السلسلة الأصلية.
startsWith	تحقق مما إذا كانت سلسلة تبدأ بسلسلة فرعية معينة.
substring	إرجاع أحرف من سلسلة، بدءاً من الموضع المحدد. يرجى مراجعة الشريحة أيضًا.
toLower	إرجاع سلسلة بتنسيق أحرف صغيرة.
toUpper	إرجاع سلسلة بتنسيق أحرف كبيرة.
trim	إزالة المسافة البيضاء البادئة والزائدة من سلسلة، ثم إرجاع السلسلة المحدثة.

دالات التحصيل

للعمل مع المجموعات، والصفائف عموماً، والسلاسل، والقواميس أحياناً، يمكنك استخدام دالات الجمع هذه.

دالة المجموعة	المهمة
قطعه	تقسيم سلسلة أو مجموعة إلى مجموعات متساوية الطول.
تحتوي على	التحقق مما إذا كانت المجموعة تحتوي على عنصر معين.
فارغ	التحقق مما إذا كانت المجموعة فارغة أم لا.
أولاً	إرجاع العنصر الأول من المجموعة.
intersection	إرجاع مجموعة تحتوي فقط على العناصر المشتركة عبر المجموعات المحددة.
عنصر	في حالة ظهور هذه الدالة داخل إجراء متكرر في صفيف، فأرجع العنصر الحالي في الصفيف أثناء التكرار الحالي للإجراء.
join	إرجاع سلسلة تحتوي على جميع العناصر من مصفوفة، مفصولة بالحرف المحدد.
last	إرجاع العنصر الأخير من مجموعة.
الطول	إرجاع عدد العناصر في سلسلة أو مصفوفة.
reverse	عكس ترتيب العناصر في صفيف.
تخطي	إزالة العناصر من مقدمة المجموعة، وإعادة جميع العناصر الأخرى.
sort	فرز العناصر في مجموعة.
الوقت المستغرق	إرجاع العناصر من مقدمة المجموعة.
union	إرجاع مجموعة تحتوي على جميع العناصر من المجموعات المحددة.

دالات المقارنة المنطقية

للعمل مع الشروط، ومقارنة القيم ونتائج التعبير، أو تقييم أنواع مختلفة من المنطق، يمكنك استخدام دالات المقارنة المنطقية هذه. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

إشعار

في حالة استخدامك دالات أو شروط منطقية لمقارنة القيم، تحول القيم الخالية إلى قيم سلسلة فارغة (""). يختلف سلوك الشروط عند المقارنة بسلسلة فارغة بدلاً من قيمة خالية. لمزيد من المعلومات، يرجى مراجعة الدالة string().

دالة المقارنة المنطقية	المهمة
و	التحقق مما إذا كانت جميع التعبيرات صحيحة.
equals	التحقق مما إذا كانت كلتا القيمتين متساويتين.
greater	التحقق مما إذا كانت القيمة الأولى أكبر من القيمة الثانية.
greaterOrEquals	التحقق مما إذا كانت القيمة الأولى أكبر من أو مساوية للقيمة الثانية.
if	التحقق مما إذا كان التعبير صحيحاً أم خطأ. بناءً على النتيجة، قم بإرجاع قيمة محددة.
isFloat	إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة.
isInt	إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن عدد صحيح.
less	التحقق مما إذا كانت القيمة الأولى أقل من القيمة الثانية.
lessOrEquals	التحقق مما إذا كانت القيمة الأولى أقل من أو مساوية للقيمة الثانية.
not	التحقق مما إذا كان التعبير غير صحيح.
أو	التحقق مما إذا كان هناك تعبير واحد على الأقل صحيح.

دالات التحويل

لتغيير نوع القيمة أو تنسيقها، بإمكانك استخدام دالات التحويل هذه. على سبيل المثال، بإمكانك تغيير قيمة من قيمة منطقية إلى عدد صحيح. للمزيد من المعلومات عن كيفية تعامل Azure Logic Apps مع أنواع المحتويات أثناء التحويل، يرجى مراجعة معالجة أنواع المحتوى. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

إشعار

ينفذ Azure Logic Apps تلقائيًا أو ضمنيًا ترميز وفك ترميز base64، لذلك لا يتعين عليك إجراء هذه التحويلات يدويًا باستخدام دالات الترميز وفك الترميز. ومع ذلك، إذا كنت تستخدم هذه الدالات على أي حال في المصمم، فيمكن أن تواجه سلوكيات عرض غير متوقعة في المصمم. تؤثر هذه السلوكيات على رؤية الدالات فقط وليس تأثيرها ما لم تقم بتحرير قيم معلمات الدالات، ما يزيل الدالات وتأثيراتها من التعليمات البرمجية الخاصة بك. للمزيد من المعلومات، يرجى مراجعة تحويلات نوع البيانات الضمنية.

دالة التحويل	المهمة
صفيف	إرجاع صفيف من إدخال واحد محدد. للحصول على مدخلات متعددة، انظر createArray.
قاعدة 64	إرجاع الإصدار المرمّز باستخدام base64 لإحدى السلاسل.
base64ToBinary	إرجاع الإصدار الثنائي لسلسلة مرمّزة باستخدام base64.
base64ToString	إرجاع إصدار السلسلة لسلسلة مرمّزة باستخدام base64.
binary	إرجاع الإصدار الثنائي لقيمة إدخال.
bool	إرجاع الإصدار المنطقي لقيمة إدخال.
createArray	إرجاع صفيف من مدخلات متعددة.
dataUri	إرجاع URI للبيانات لقيمة إدخال.
dataUriToBinary	إرجاع الإصدار الثنائي لـ URI للبيانات.
dataUriToString	إرجاع إصدار السلسلة لـ URI للبيانات.
عدد عشري	قم بإعادة الرقم العشري لسلسلة عشرية.
decodeBase64	إرجاع إصدار السلسلة لسلسلة مرمّزة باستخدام base64.
decodeDataUri	إرجاع الإصدار الثنائي لـ URI للبيانات.
decodeUriComponent	إرجاع سلسلة استبدال أحرف الإلغاء بإصدارات غير مرمزة.
encodeUriComponent	إرجاع سلسلة يستبدل أحرف URL غير الآمنة بأحرف الإلغاء.
تعويم	إرجاع رقم فاصلة عائمة لقيمة إدخال.
الباحث	إرجاع إصدار صحيح لسلسلة.
json	بإرجاع قيمة نوع JavaScript Object Notation (JSON) أو كائن لسلسلة أو XML.
string	إرجاع إصدار السلسلة لقيمة إدخال.
uriComponent	إرجاع إصدار URI المرمز لقيمة إدخال عن طريق استبدال أحرف URL غير الآمنة بأحرف إلغاء.
uriComponentToBinary	إرجاع الإصدار الثنائي لسلسلة URI المرمزة.
uriComponentToString	إرجاع إصدار السلسلة لسلسلة URI المرمزة.
xml	إرجاع إصدار XML لسلسلة.

تحويلات نوع البيانات الضمنية

يحول Azure Logic Apps تلقائيًا أو ضمنيًا بين بعض أنواع البيانات، لذلك لا يجب عليك إجراء هذه التحويلات يدويًا. على سبيل المثال، إذا كنت تستخدم قيمًا غير سلسلة حيث من المتوقع أن تكون السلاسل إدخالات، فإن Azure Logic Apps يحول تلقائيًا القيم غير السلسلة إلى سلاسل.

على سبيل المثال، افترض أن المشغل يُرجع قيمة عددية كإخراج:

triggerBody()?['123']

في حالة كنت تستخدم هذا الإخراج الرقمي حيث يتوقع إدخال السلسلة، مثل عنوان URL، فإن Azure Logic Apps يحول القيمة تلقائيًا إلى سلسلة باستخدام رمز الأقواس المتعرجة ({}):

@{triggerBody()?['123']}

الترميز وفك الترميز الخاص بـ Base64

ينفذ Azure Logic Apps تلقائيًا أو ضمنيًا ترميز وفك ترميز base64، لذلك لا يجب عليك إجراء هذه التحويلات يدويًا باستخدام الدالات المقابلة:

base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)

إشعار

في حالة إضافة أي من هذه الدالات يدويًا أثناء استخدام المصمم، إما مباشرة إلى المشغل أو الإجراء أو باستخدام محرر التعبير، انتقل بعيدًا عن المصمم، ثم عد إلى المصمم، تختفي الوظيفة من المصمم، تاركة وراءها فقط قيم المعلمات. يحدث هذا السلوك أيضًا في حالة قيامك بتحديد مشغل أو إجراء يستخدم هذه الدالة دون تحرير قيم معلمات الدالة. تؤثر هذه النتيجة على رؤية الدالة فقط وليس التأثير. في طريقة عرض التعليمة البرمجية، لا تتأثر الدالة. ومع ذلك، إذا قمت بتحرير قيم معلمات الدالة، فستتم إزالة كل من الدالة وتأثيرها من عرض التعليمات البرمجية، تاركة وراءها قيم معلمات الدالة فقط.

دالات رياضيات

للعمل مع الأعداد الصحيحة والعشرية، يمكنك استخدام هذه الدالات الرياضية. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

الدالة الرياضية	المهمة
add	إرجاع الناتج من إضافة رقمين.
div	إرجاع الناتج من قسمة رقمين.
max	إرجاع القيمة الأعلى من مجموعة من الأرقام أو صفيف.
دقيقه	إرجاع القيمة الأقل من مجموعة من الأرقام أو صفيف.
mod	إرجاع الباقي من قسمة رقمين.
mul	إرجاع الناتج من ضرب رقمين.
rand	إرجاع عدد صحيح عشوائي من نطاق محدد.
النطاق	إرجاع صفيف عدد صحيح يبدأ من عدد صحيح محدد.
sub	إرجاع الناتج من طرح الرقم الثاني من الرقم الأول.

دالات التاريخ والوقت

للعمل مع التواريخ والأوقات، بإمكانك استخدام دالات التاريخ والوقت هذه. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

دالة التاريخ أو الوقت	المهمة
addDays	أضف أيام إلى طابع زمني.
addHours	أضف ساعات إلى طابع زمني.
addMinutes	أضف دقائق إلي طابع زمني.
addSeconds	أضف ثواني إلي طابع زمني.
addToTime	أضف وحدات زمنية محددة إلى طابع زمني. انظر كذلك getFutureTime.
convertFromUtc	تحويل طابع زمني من تنسيق التوقيت العالمي (UTC) إلى المنطقة الزمنية الهدف.
convertTimeZone	تحويل طابع زمني من المنطقة الزمنية المصدر إلى المنطقة الزمنية الهدف.
convertToUtc	تحويل طابع زمني من المنطقة الزمنية المصدر إلى تنسيق التوقيت العالمي (UTC).
عدم الاكتراث بالتاريخ	إرجاع الفرق بين تاريخين كمدة زمنية.
dayOfMonth	إرجاع مكون أيام الشهر من الطابع زمني.
dayOfWeek	إرجاع مكون يوم الأسبوع من الطابع الزمني.
dayOfYear	إرجاع مكون أيام السنة من الطابع زمني.
formatDateTime	استعد التاريخ من الطابع الزمني.
getFutureTime	إرجاع الطابع الزمني الحالي بالإضافة إلى وحدات الوقت المحددة. انظر كذلك addToTime.
getPastTime	إرجاع الطابع الزمني الحالي مطروحاً منه الوحدات الزمنية المحددة. انظر كذلك subtractFromTime.
parseDateTime	استعد الطابع الزمني من سلسلة تحتوي على طابع زمني.
startOfDay	إرجاع بداية اليوم للحصول على طابع زمني.
startOfHour	إرجاع بداية الساعة للحصول على طابع زمني.
startOfMonth	إرجاع بداية الشهر للحصول على طابع زمني.
subtractFromTime	طرح عدد من وحدات الوقت من الطابع الزمني. انظر كذلك getPastTime.
القراد	إرجاع قيمة الخاصية `ticks` لطابع زمني محدد.
utcNow	إرجاع الطابع الزمني الحالي كسلسلة.

دالات سير العمل

من الممكن أن تساعدك دالات سير العمل هذه على:

الحصول على تفاصيل عن مثيل سير العمل في وقت التشغيل.
العمل مع الإدخالات المستخدمة لإنشاء مثيل خاص بتطبيقات المنطق أو التدفقات.
الإشارة إلى الإخراجات من المشغلات والإجراءات.

على سبيل المثال، بإمكانك الرجوع إلى إخراجات إجراء واحد واستخدام تلك البيانات في إجراء لاحق. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

دالة سير العمل	المهمة
العمل	استعد إخراج الإجراء الحالي في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى. يرجى مراجعة الإجراءات أيضًا.
actionBody	أرجع الإخراج الخاص بالإجراء `body` في وقت التشغيل. يرجى مراجعة النص الأساسي أيضًا.
actionOutputs	أعد إخراج الإجراء في وقت التشغيل. يرجى مراجعة الإخراجات والإجراءات.
الإجراءات	أرجع إخراج إجراء ما في وقت التشغيل، أو قيم من أزواج اسم وقيمة JSON أخرى. يرجى مراجعة الإجراء أيضًا.
النص الأساسي	أرجع الإخراج الخاص بالإجراء `body` في وقت التشغيل. يرجى مراجعة actionBodyأيضًا.
formDataMultiValues	أنشئ صفيفًا بالقيم التي تطابق اسم مفتاح في إخراجات الإجراء بيانات النموذج أو ترميز النموذج.
formDataValue	أعد قيمة واحدة تطابق اسم مفتاح في إخراج بيانات النموذج أو ترميز النموذج الخاص بالإجراء.
عنصر	في حالة ظهور هذه الدالة داخل إجراء متكرر في صفيف، فأرجع العنصر الحالي في الصفيف أثناء التكرار الحالي للإجراء.
items	في حالة ظهور الدالة داخل تكرار Foreach أو Until، فأعد العنصر الحالي من التكرار الحلقي المحدد.
iterationIndexes	في حالة ظهور الدالة داخل تكرار Until، فأعد قيمة الفهرس للتكرار الحالي. يمكنك استخدام هذه الدالة داخل تكرار Until المتداخل.
listCallbackUrl	أعد «عنوان URL لرد الاتصال» الذي يستدعي مشغلاً أو إجراءً.
multipartBody	أعد النص الأساسي لجزء معين في إخراج إجراء يتكون من أجزاء متعددة.
النواتج	أعد إخراج الإجراء في وقت التشغيل.
معلمات	أعد قيمة المعلمة الموضحة في تعريف سير العمل الخاص بك.
نتيجة	أعد الإدخالات والإخراجات من إجراءات المستوى الأعلى داخل الإجراء ضمن النطاق المحدد، مثل `For_each`، و`Until`، و`Scope`.
المشغل	أعد إخراج المشغل في وقت التشغيل، أو من أزواج اسم وقيمة JSON الأخرى. يرجى مراجعة أيضًا triggerOutputs وtriggerBody.
triggerBody	أعد إخراج المشغل `body` في وقت التشغيل. يرجى مراجعة المشغل.
triggerFormDataValue	أعد قيمة واحدة مطابقة لاسم مفتاح في إخراجات المشغل بيانات النموذج أو ترميز النموذج.
triggerMultipartBody	أعد النص الأساسي لجزء معين في إخراج المشغل متعدد الأجزاء.
triggerFormDataMultiValues	أنشئ صفيفًا تتطابق قيمه مع اسم مفتاح في إخراجات مشغل بيانات النموذج أو ترميز النموذج.
triggerOutputs	أعد إخراج المشغل في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى. يرجى مراجعة المشغل.
المتغيرات	أعد قيمة متغير محدد.
سير العمل	أعد جميع التفاصيل حول سير العمل نفسه أثناء وقت التشغيل.

دالات تحليل URI

للعمل مع معرفات الموارد المنتظمة (URI) والحصول على قيم خصائص مختلفة لعناوين URI هذه، يمكنك استخدام دالات تحليل URI هذه. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

دالات تحليل URI	المهمة
uriHost	أعد قيمة `host` لمعرف الموارد المنتظم (URI).
uriPath	أعد قيمة `path` لمعرف الموارد المنتظم (URI).
uriPathAndQuery	أعد قيم `path` و`query` لمعرف الموارد المنتظم (URI).
uriPort	أعد قيمة `port` لمعرف الموارد المنتظم (URI).
uriQuery	أعد قيمة `query` لمعرف الموارد المنتظم (URI).
uriScheme	أعد قيمة `scheme` لمعرف الموارد المنتظم (URI).

دوال المعالجة: JSON وXML

للعمل مع عناصر JSON وعقد XML، يمكنك استخدام دالات المعالجة هذه. للحصول على المرجع الكامل عن كل دالة، يرجى مراجعة القائمة الأبجدية.

دالة المعالجة	المهمة
addProperty	أضف خاصية وقيمتها، أو زوج الاسم-القيمة، إلى عنصر JSON، وأرجع العنصر المحدث.
coalesce	إرجاع القيمة غير الفارغة الأولى من معلمة واحدة أو أكثر.
removeProperty	أزل خاصية من عنصر JSON وأعد العنصر المحدث.
setProperty	عين قيمة لخاصية عنصر JSON وأعد العنصر المحدث.
xpath	التحقق من XML للعقد أو القيم التي تطابق تعبير XPath (لغة مسار XML)، ثم إرجاع العقد أو القيم المتطابقة.

---------------------------------

جميع الدالات - قائمة أبجدية

يسرد هذا القسم جميع الدالات المتوفرة بالترتيب الأبجدي.

ش

إجراء

أعد إخراج الإجراء الحالي في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى، والتي يمكنك تعيينها إلى تعبير. بشكل افتراضي، تشير هذه الدالة إلى عنصر الإجراء بأكمله، ولكن يمكنك اختياريًا تحديد خاصية تريد قيمتها. يرجى مراجعة actions() أيضًا.

بإمكانك استخدام الدالة action() فقط في هذه الأماكن:

الخاصية unsubscribe لإجراء إخطار على الويب حتى تتمكن من الوصول إلى النتيجة من الطلب الأصلي subscribe
الخاصية trackedProperties الخاصة بإجراء
شرط التكرار الحلقي do-until الخاص بإجراء

action()
action().outputs.body.<property>

المعلمة‬	المطلوب	نوع	‏‏الوصف
<خاصية>	لا	السلسلة‬	اسم خاصية عنصر الإجراء التي تريد قيمتها: الاسم ووقت البدء ووقت الانتهاء والإدخالات والإخراجاتوالحالة والتعليمة البرمجية ومعرف التتبع ومعرف تتبع العميل. في مدخل Microsoft Azure، بإمكانك العثور على هذه الخصائص من خلال مراجعة تفاصيل محفوظات تشغيل معينة. للمزيد من المعلومات، يرجى مراجعة واجهة برمجة تطبيقات REST - إجراءات تشغيل سير العمل.

قيمة الإرجاع	النوع	‏‏الوصف
<إخراج الإجراء>	السلسلة‬	الإخراج من الإجراء أو الخاصية الحالية

actionBody

أرجع الإخراج الخاص بالإجراء body في وقت التشغيل. اختصار لـ actions('<actionName>').outputs.body. يرجى مراجعة body() وactions().

actionBody('<actionName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم إخراج الإجراء `body` الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<action-body-output>	السلسلة‬	الإخراج `body` من الإجراء المحدد

مثال

يحصل هذا المثال على الإخراج body من إجراء Twitter Get user:

actionBody('Get_user')

وإرجاع هذه النتيجة:

"body": {
  "FullName": "Contoso Corporation",
  "Location": "Generic Town, USA",
  "Id": 283541717,
  "UserName": "ContosoInc",
  "FollowersCount": 172,
  "Description": "Leading the way in transforming the digital workplace.",
  "StatusesCount": 93,
  "FriendsCount": 126,
  "FavouritesCount": 46,
  "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

actionOutputs

أعد إخراج الإجراء في وقت التشغيل. والذي يُعد اختصارًا لـ actions('<actionName>').outputs. يرجى مراجعة actions(). تحل الدالة actionOutputs() إلى outputs() في المصمم، لذا ضع في اعتبارك استخدام outputs()، بدلاً من actionOutputs(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام outputs().

actionOutputs('<actionName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم إخراج الإجراء الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<الإخراج>	السلسلة‬	الإخراج من الإجراء المحدد

مثال

يحصل هذا المثال على الإخراج من إجراء Twitter Get user:

actionOutputs('Get_user')

وإرجاع هذه النتيجة:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

الإجراءات

أعد إخراج إجراء ما في وقت التشغيل، أو قيم من أزواج اسم وقيمة JSON أخرى، والتي يمكنك تعيينها إلى تعبير. بشكل افتراضي، تشير الدالة إلى عنصر الإجراء بأكمله، ولكن يمكنك تحديد خاصية تريد قيمتها بشكل اختياري. للحصول على إصدارات الاختصار، يرجى مراجعة actionBody() وactionOutputs() وbody(). للحصول على الإجراء الحالي، يرجى مراجعة action().

تلميح

ترجع الدالة actions() الإخراج كسلسلة. في حالة كنت بحاجة إلى العمل بقيمة مرجعة كعنصر JSON، فأنت بحاجة أولاً إلى تحويل قيمة السلسلة. يمكنك تحويل قيمة السلسلة إلى عنصر JSON باستخدام إجراء Parse JSON.

إشعار

في السابق، بإمكانك استخدام الدالة actions() أو العنصر conditions عند تحديد تشغيل إجراء استنادًا إلى الإخراج من إجراء آخر. ومع ذلك، للإعلان صراحة عن التبعيات بين الإجراءات، يلزم عليك الآن استخدام خاصية runAfter للإجراء التابع. لمعرفة المزيد عن الخاصية runAfter، يرجى مراجعة اكتشاف الأخطاء والتعامل معها من خلال خاصية runAfter.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم عنصر الإجراء الذي تريد إخراجه
<خاصية>	لا	السلسلة‬	اسم خاصية عنصر الإجراء التي تريد قيمتها: الاسم ووقت البدء ووقت الانتهاء والإدخالات والإخراجاتوالحالة والتعليمة البرمجية ومعرف التتبع ومعرف تتبع العميل. في مدخل Microsoft Azure، بإمكانك العثور على هذه الخصائص من خلال مراجعة تفاصيل محفوظات تشغيل معينة. للمزيد من المعلومات، يرجى مراجعة واجهة برمجة تطبيقات REST - إجراءات تشغيل سير العمل.

قيمة الإرجاع	النوع	‏‏الوصف
<إخراج الإجراء>	السلسلة‬	الإخراج من الإجراء أو الخاصية المحددة

مثال

يحصل هذا المثال على قيمة الخاصية status من إجراء Twitter Get user في وقت التشغيل:

actions('Get_user').outputs.body.status

وإرجاع هذه النتيجة: "Succeeded"

add

إرجاع الناتج من إضافة رقمين.

add(<summand_1>, <summand_2>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجمع_1>، <مجمع_2>	‏‏نعم‬	عدد صحيح أو عائم أو مختلط	الأرقام التي تجب إضافتها

قيمة الإرجاع	النوع	‏‏الوصف
<result-sum>	عدد صحيح أو عائم	نتيجة إضافة الأرقام المحددة

مثال

يضيف هذا المثال الأرقام المحددة:

add(1, 1.5)

وإرجاع هذه النتيجة: 2.5

addDays

أضف أيام إلى طابع زمني.

addDays('<timestamp>', <days>, '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<الأيام>	‏‏نعم‬	Integer	العدد الموجب أو السالب للأيام الذي يجب إضافته
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني بالإضافة إلى عدد الأيام المحدد

مثال 1

يضيف هذا المثال 10 أيام إلى الطابع الزمني المحدد:

addDays('2018-03-15T00:00:00Z', 10)

وإرجاع هذه النتيجة: "2018-03-25T00:00:00.0000000Z"

مثال 2

يطرح هذا المثال خمسة أيام من الطابع الزمني المحدد:

addDays('2018-03-15T00:00:00Z', -5)

وإرجاع هذه النتيجة: "2018-03-10T00:00:00.0000000Z"

addHours

أضف ساعات إلى طابع زمني.

addHours('<timestamp>', <hours>, '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<hour>s	‏‏نعم‬	Integer	العدد الموجب أو السالب للساعات التي يجب إضافتها
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني بالإضافة إلى عدد الساعات المحددة

مثال 1

يضيف هذا المثال 10 ساعات إلى الطابع الزمني المحدد:

addHours('2018-03-15T00:00:00Z', 10)

وإرجاع هذه النتيجة: "2018-03-15T10:00:00.0000000Z"

مثال 2

يطرح هذا المثال خمسة ساعات من الطابع الزمني المحدد:

addHours('2018-03-15T15:00:00Z', -5)

وإرجاع هذه النتيجة: "2018-03-15T10:00:00.0000000Z"

addMinutes

أضف دقائق إلي طابع زمني.

addMinutes('<timestamp>', <minutes>, '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<الدقائق >	‏‏نعم‬	Integer	العدد الموجب أو السالب للدقائق التي يجب إضافتها
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني بالإضافة إلى عدد الدقائق المحددة

مثال 1

يضيف هذا المثال 10 دقائق إلى الطابع الزمني المحدد:

addMinutes('2018-03-15T00:10:00Z', 10)

وإرجاع هذه النتيجة: "2018-03-15T00:20:00.0000000Z"

مثال 2

يطرح هذا المثال خمس دقائق من الطابع الزمني المحدد:

addMinutes('2018-03-15T00:20:00Z', -5)

وإرجاع هذه النتيجة: "2018-03-15T00:15:00.0000000Z"

addProperty

أضف خاصية وقيمتها، أو زوج الاسم-القيمة، إلى عنصر JSON، وأرجع العنصر المحدث. إذا كانت الخاصية موجودة بالفعل في وقت التشغيل، فستفشل الدالة وتتسبب في حدوث خطأ.

addProperty(<object>, '<property>', <value>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON حيث تريد إضافة خاصية
<خاصية>	‏‏نعم‬	السلسلة‬	اسم الخاصية التي تريد إضافتها
<قيمة>	‏‏نعم‬	أي	قيمة الخاصية

قيمة الإرجاع	النوع	‏‏الوصف
<updated-object>	‏‏الكائن	عنصر JSON المحدث بالخاصية المحددة

لإضافة خاصية أصل إلى خاصية موجودة، استخدم الدالة setProperty()، وليس الدالة addProperty(). خلاف ذلك، ترجع الدالة العنصر التابع فقط كإخراج.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON حيث تريد إضافة خاصية
<الخاصية الأصل>	‏‏نعم‬	السلسلة‬	اسم الخاصية الأصل حيث تريد إضافة الخاصية التابعة
<خاصية تابعة>	‏‏نعم‬	السلسلة‬	اسم الخاصية الفرعية المراد إضافتها
<قيمة>	‏‏نعم‬	أي	القيمة المراد تعيينها للخاصية المحددة

قيمة الإرجاع	النوع	‏‏الوصف
<updated-object>	‏‏الكائن	عنصر JSON المحدث الذي تحدد خاصيته

مثال 1

يضيف هذا المثال الخاصية middleName إلى عنصر JSON، والذي يحول من سلسلة إلى JSON باستخدام الدالة JSON(). يشمل العنصر بالفعل الخاصيتين firstName وsurName. تقوم الدالة بتعيين القيمة المحددة للخاصية الجديدة وإرجاع العنصر المحدث:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

إليك عنصر JSON الحالي:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

إليك عنصر JSON المحدث:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

مثال 2

يضيف هذا المثال الخاصية الفرعية middleName إلى الخاصية الموجودة customerName في عنصر JSON، والتي يتم تحويلها من سلسلة إلى JSON باستخدام الدالة JSON(). تقوم الدالة بتعيين القيمة المحددة للخاصية الجديدة وإرجاع العنصر المحدث:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

إليك عنصر JSON الحالي:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

إليك عنصر JSON المحدث:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

أضف ثواني إلي طابع زمني.

addSeconds('<timestamp>', <seconds>, '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<seconds>	‏‏نعم‬	Integer	العدد الموجب أو السالب للثواني التي يجب إضافتها
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني بالإضافة إلى عدد الثواني المحددة

مثال 1

يضيف هذا المثال 10 ثوانٍ إلى الطابع الزمني المحدد:

addSeconds('2018-03-15T00:00:00Z', 10)

وإرجاع هذه النتيجة: "2018-03-15T00:00:10.0000000Z"

مثال 2

يطرح هذا المثال خمس ثوانٍ من الطابع الزمني المحدد:

addSeconds('2018-03-15T00:00:30Z', -5)

وإرجاع هذه النتيجة: "2018-03-15T00:00:25.0000000Z"

addToTime

أضف الوحدات الزمنية المحددة إلى طابع زمني. انظر كذلك getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<الفاصل الزمني>	‏‏نعم‬	Integer	عدد الوحدات الزمنية المحددة المطلوب إضافتها
<timeUnit>	‏‏نعم‬	السلسلة‬	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني بالإضافة إلى عدد الوحدات الزمنية

مثال 1

يضيف هذا المثال يوم واحد إلى الطابع الزمني المحدد:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

وإرجاع هذه النتيجة: "2018-01-02T00:00:00.0000000Z"

مثال 2

يضيف هذا المثال يوم واحد إلى الطابع الزمني المحدد:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

وإرجاع النتيجة باستخدام تنسيق "D" الاختياري: "Tuesday, January 2, 2018"

و

التحقق مما إذا كانت جميع التعبيرات صحيحة. أعد صحيح عندما تكون جميع التعبيرات صحيحة، أو أعد خطأ عندما يكون تعبير واحد على الأقل خطأ.

and(<expression1>, <expression2>, ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<تعبير1>، <تعبير2>، ...	‏‏نعم‬	Boolean	التعبيرات التي يجب التحقق منها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	أعد صحيح عندما تكون جميع التعبيرات صحيحة. إرجاع false عندما يكون تعبير واحد على الأقل غير صحيح.

مثال 1

تتحقق هذه الأمثلة مما إذا كانت جميع القيم المنطقية المحددة صحيحة أم لا:

and(true, true)
and(false, true)
and(false, false)

وإرجاع هذه النتائج:

المثال الأول: كلا التعبيرين صحيحان، لذا يتم إرجاع true.
المثال الثاني: أحد التعبيرين خطأ، لذا يتم إرجاع false.
المثال الثالث: كلا التعبيرين خطأ، لذا يتم إرجاع false.

مثال 2

تتحقق هذه الأمثلة مما إذا كانت جميع التعبيرات المحددة صحيحة أم لا:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

وإرجاع هذه النتائج:

المثال الأول: كلا التعبيرين صحيحان، لذا يتم إرجاع true.
المثال الثاني: أحد التعبيرين خطأ، لذا يتم إرجاع false.
المثال الثالث: كلا التعبيرين خطأ، لذا يتم إرجاع false.

صفيف

إرجاع صفيف من إدخال واحد محدد. للحصول على مدخلات متعددة، انظر createArray().

array('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة لإنشاء صفيف

قيمة الإرجاع	النوع	‏‏الوصف
[<قيمة>]	صفيف	صفيف يحتوي على إدخال واحد محدد

مثال

ينشئ هذا المثال صفيف من سلسلة "hello":

array('hello')

وإرجاع هذه النتيجة: ["hello"]

مضمن

قاعدة 64

إرجاع الإصدار المرمّز باستخدام base64 لإحدى السلاسل.

إشعار

ينفذ Azure Logic Apps تلقائيًا أو ضمنيًا ترميز وفك ترميز base64، لذلك لا يتعين عليك إجراء هذه التحويلات يدويًا باستخدام دالات الترميز وفك الترميز. ومع ذلك، إذا كنت تستخدم هذه الدالات على أي حال، يمكن أن تواجه سلوكيات عرض غير متوقعة في المصمم. تؤثر هذه السلوكيات على رؤية الدالات فقط وليس تأثيرها ما لم تقم بتحرير قيم معلمات الدالات، ما يزيل الدالات وتأثيراتها من التعليمات البرمجية الخاصة بك. للمزيد من المعلومات، يرجى مراجعة ترميز Base64 وفك ترميزه.

base64('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	سلسلة الإدخال

قيمة الإرجاع	النوع	‏‏الوصف
<base64-string>	السلسلة‬	الإصدار المرمّز باستخدام base64 لسلسلة الإدخال

مثال

يحول هذا المثال سلسلة "hello" إلى سلسلة مرمزة باستخدام base64:

base64('hello')

وإرجاع هذه النتيجة: "aGVsbG8="

base64ToBinary

إرجاع الإصدار الثنائي لسلسلة مرمّزة باستخدام base64.

إشعار

base64ToBinary('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المرمزة باستخدام base64 لتحويل

قيمة الإرجاع	النوع	‏‏الوصف
<binary-for-base64-string>	السلسلة‬	الإصدار الثنائي لسلسلة مرمزة باستخدام base64

مثال

يحول هذا المثال السلسلة المرمزة باستخدام "aGVsbG8=" base64 إلى سلسلة ثنائية:

base64ToBinary('aGVsbG8=')

على سبيل المثال، افترض أنك تستخدم إجراء HTTP لكي ترسل طلبًا. بإمكانك استخدام base64ToBinary() لتحويل سلسلة مرمزة بـ base64 إلى بيانات ثنائية وإرسال تلك البيانات باستخدام نوع المحتوى application/octet-stream في الطلب.

base64ToString

إرجاع إصدار السلسلة للسلسلة المرمزة باستخدام base64، وفك ترميز السلسلة المرمزة باستخدام base64 على نحوٍ فعال. استخدم هذه الدالة بدلاً من decodeBase64()، والتي أهملت.

إشعار

base64ToString('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المرمزة باستخدام base64 لفك الترميز

قيمة الإرجاع	النوع	‏‏الوصف
<decoded-base64-string>	السلسلة‬	إصدار السلسلة لسلسلة مرمّزة باستخدام base64

مثال

يحول هذا المثال السلسلة المرمزة باستخدام "aGVsbG8=" base64 إلى سلسلة واحدة فقط:

base64ToString('aGVsbG8=')

وإرجاع هذه النتيجة: "hello"

binary

أعد الإصدار الثنائي المرمز بـ base64 من سلسلة.

binary('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المطلوب تحويلها

قيمة الإرجاع	النوع	‏‏الوصف
<binary-for-input-value>	السلسلة‬	الإصدار الثنائي المرمز بـ base64 للسلسلة المحددة

مثال

على سبيل المثال، أنت تستخدم إجراء HTTP يرجع ملف صورة أو ملف فيديو. بإمكانك استخدام binary() لتحويل القيمة إلى نموذج مغلف محتوى مرمز بـ base-64. بعد ذلك، بإمكانك إعادة استخدام مغلف المحتوى في إجراءات أخرى، مثل Compose. يمكنك استخدام تعبير الدالة هذا لإرسال بايت سلسلة مع نوع المحتوى application/octet-stream في الطلب.

النص الأساسي

أرجع الإخراج الخاص بالإجراء body في وقت التشغيل. اختصار لـ actions('<actionName>').outputs.body. يرجى مراجعة actionBody() وactions().

body('<actionName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم إخراج الإجراء `body` الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<action-body-output>	السلسلة‬	الإخراج `body` من الإجراء المحدد

مثال

يحصل هذا المثال على الإخراج body من إجراء Twitter Get user:

body('Get_user')

وإرجاع هذه النتيجة:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

منطقي

أعد الإصدار المنطقي لقيمة.

bool(<value>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	أي	القيمة المطلوب تحويلها إلى منطقية.

إذا كنت تستخدم bool() مع عنصر، يجب أن تكون قيمة العنصر سلسلة أو عدد صحيح يمكن تحويله إلى قيمة منطقية.

قيمة الإرجاع	النوع	‏‏الوصف
`true` أو `false`	Boolean	إصدار منطقي للقيمة المحددة.

النواتج

توضح هذه الأمثلة الأنواع المختلفة المدعومة من الإدخال من أجل bool():

قيمة الإدخال	نوع	قيمة الإرجاع
`bool(1)`	Integer	`true`
`bool(0)`	Integer	`false`
`bool(-1)`	Integer	`true`
`bool('true')`	السلسلة‬	`true`
`bool('false')`	السلسلة‬	`false`

C

قطعه

تقسيم سلسلة أو صفيف إلى أجزاء متساوية الطول.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف	المجموعة المراد تقسيمها
<الطول>	‏‏نعم‬	طول كل جزء

قيمة الإرجاع	النوع	‏‏الوصف
<مجموعة>	صفيف	صفيف من المجموعات ذات الطول المحدد

مثال 1

يقسم هذا المثال سلسلة إلى أجزاء من الطول 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

وإرجاع هذه النتيجة: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

مثال 2

يقسم هذا المثال صفيفا إلى أجزاء من الطول 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

وإرجاع هذه النتيجة: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

coalesce

إرجاع القيمة غير الفارغة الأولى من معلمة واحدة أو أكثر. السلاسل، والمصفوفات، والعناصر الفارغة ليست خالية.

coalesce(<object_1>, <object_2>, ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object_1>, <object_2>, ...	‏‏نعم‬	أي، يمكن خلط الأنواع	عنصر واحد أو أكثر للتحقق من كونه خالياً

قيمة الإرجاع	النوع	‏‏الوصف
<first-non-null-item>	أي	العنصر الأول أو القيمة ليست خالية. إذا كانت جميع المعلمات فارغة، يتم إرجاع هذه الدالة قيمة فارغة.

مثال

تُرجع هذه الأمثلة القيمة الأولى غير الفارغة من القيم المحددة، أو القيمة الفارغة عندما تكون جميع القيم فارغة:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

وإرجاع هذه النتائج:

المثال الأول: true
المثال الثاني: "hello"
المثال الثالث: null

concat

ضم سلسلتين أو أكثر، ثم إرجاع السلسلة المدمجة.

concat('<text1>', '<text2>', ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<نص1>، <نص2>، ...	‏‏نعم‬	السلسلة‬	على الأقل سلسلتان للجمع

قيمة الإرجاع	النوع	‏‏الوصف
<text1text2...>	السلسلة‬	السلسلة التي تم إنشاؤها من سلاسل الإدخال المدمجة. ملاحظة: يجب ألا يتجاوز طول النتيجة 104,857,600 حرف.

إشعار

ينفذ Azure Logic Apps تلقائيًا أو ضمنيًا ترميز وفك ترميز base64، لذلك لا يتعين عليك إجراء هذه التحويلات يدويًا عند استخدام الدالة concat() مع البيانات التي تحتاج إلى ترميز أو فك ترميز:

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

ومع ذلك، إذا كنت تستخدم هذه الدالة على أي حال في المصمم، يمكن أن تواجه سلوكيات عرض غير متوقعة في المصمم. تؤثر هذه السلوكيات على رؤية الدالة فقط وليس التأثير إلا إذا حررت قيم معلمات الدالة، ما يزيل الدالة والتأثير من التعليمات البرمجية الخاصة بك. للمزيد من المعلومات، راجع ترميز Base64 وفك ترميزه.

مثال

يجمع هذا المثال بين السلاسل "Hello" و"World":

concat('Hello', 'World')

وإرجاع هذه النتيجة: "HelloWorld"

تحتوي على

التحقق مما إذا كانت المجموعة تحتوي على عنصر معين. يتم إرجاع القيمة true عند العثور على العنصر أو إرجاع القيمة false عند عدم العثور عليه. هذه الدالة حساسة لحالة الأحرف.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

وبوجه خاص، تعمل هذه الدالة على أنواع المجموعات هذه:

سلسلة للبحث عن سلسلة فرعية
صفيف للبحث عن قيمة
قاموس للبحث عن مفتاح

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف أو قاموس	المجموعة التي يجب التحقق منها
<قيمة>	‏‏نعم‬	سلسلة أو صفيف أو قاموس على التوالي	العنصر المطلوب العثور عليه

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عند العثور على العنصر. إرجاع القيمة false عند عدم العثور عليه.

مثال 1

يتحقق هذا المثال من سلسلة "hello world" للسلسلة الفرعية "world" وإرجاع القيمة true:

contains('hello world', 'world')

مثال 2

يتحقق هذا المثال من سلسلة "hello world" للسلسلة الفرعية "universe" وإرجاع القيمة false:

contains('hello world', 'universe')

convertFromUtc

تحويل طابع زمني من تنسيق التوقيت العالمي (UTC) إلى المنطقة الزمنية الهدف.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<destinationTimeZone>	‏‏نعم‬	السلسلة‬	اسم المنطقة الزمنية الهدف. للحصول على أسماء المناطق الزمنية، يرجى مراجعة المناطق الزمنية الافتراضية لـ Microsoft Windows.
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<converted-timestamp>	السلسلة‬	الطابع الزمني المحول إلى المنطقة الزمنية المستهدفة بدون إزاحة المنطقة الزمنية بالتوقيت العالمي المتفق عليه.

مثال 1

يحول هذا المثال طابعاً زمنياً إلى المنطقة الزمنية المحددة:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

وإرجاع هذه النتيجة: "2018-01-01T00:00:00.0000000"

مثال 2

يحول هذا المثال طابعاً زمنياً إلى المنطقة الزمنية والتنسيق المحدد:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

وإرجاع هذه النتيجة: "Monday, January 1, 2018"

convertTimeZone

تحويل طابع زمني من المنطقة الزمنية المصدر إلى المنطقة الزمنية الهدف.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<sourceTimeZone>	‏‏نعم‬	السلسلة‬	اسم المنطقة الزمنية المصدر. بالنسبة لأسماء المناطق الزمنية، يرجى مراجعة Microsoft Windows Default Time Zones، ولكن يمكن تضطر إلى إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<destinationTimeZone>	‏‏نعم‬	السلسلة‬	اسم المنطقة الزمنية الهدف. بالنسبة لأسماء المناطق الزمنية، يرجى مراجعة Microsoft Windows Default Time Zones، ولكن يمكن تضطر إلى إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<converted-timestamp>	السلسلة‬	الطابع الزمني المحول إلى المنطقة الزمنية الهدف

مثال 1

يحول هذا المثال المنطقة الزمنية المصدر إلى المنطقة الزمنية الهدف:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

وإرجاع هذه النتيجة: "2018-01-01T00:00:00.0000000"

مثال 2

يحول هذا المثال منطقة زمنية إلى المنطقة الزمنية والتنسيق المحدد:

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

وإرجاع هذه النتيجة: "Monday, January 1, 2018"

convertToUtc

تحويل طابع زمني من المنطقة الزمنية المصدر إلى تنسيق التوقيت العالمي (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<sourceTimeZone>	‏‏نعم‬	السلسلة‬	اسم المنطقة الزمنية المصدر. بالنسبة لأسماء المناطق الزمنية، يرجى مراجعة Microsoft Windows Default Time Zones، ولكن يمكن تضطر إلى إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<converted-timestamp>	السلسلة‬	الطابع الزمني المحول إلى UTC

مثال 1

يحول هذا المثال طابع زمني إلى UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

وإرجاع هذه النتيجة: "2018-01-01T08:00:00.0000000Z"

مثال 2

يحول هذا المثال طابع زمني إلى UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

وإرجاع هذه النتيجة: "Monday, January 1, 2018"

createArray

إرجاع صفيف من مدخلات متعددة. للحصول على صفائف إدخال مفردة، انظر array().

createArray('<object1>', '<object2>', ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<عنصر1>، <عنصر2>، ...	‏‏نعم‬	أي، ولكن ليست مختلطة	عنصران على الأقل لإنشاء الصفيف

قيمة الإرجاع	النوع	‏‏الوصف
[<عنصر1>، <عنصر2>، ...]	صفيف	الصفيف الذي تم إنشاؤه من جميع عناصر الإدخال

مثال

ينشئ هذا المثال صفيف من هذه الإدخالات:

createArray('h', 'e', 'l', 'l', 'o')

وإرجاع هذه النتيجة: ["h", "e", "l", "l", "o"]

D

dataUri

إرجاع معرف موارد منتظم للبيانات (URI) لسلسلة.

dataUri('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المطلوب تحويلها

قيمة الإرجاع	النوع	‏‏الوصف
<data-uri>	السلسلة‬	عنوان URI للبيانات الخاصة بسلسلة الإدخال

مثال

ينشئ هذا المثال عنوان URI للبيانات الخاصة بسلسلة "hello":

dataUri('hello')

وإرجاع هذه النتيجة: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

إرجاع الإصدار الثنائي لمعرف موارد منتظم (URI) للبيانات. استخدم هذه الدالة بدلاً من decodeDataUri(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام dataUriBinary().

dataUriToBinary('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	URI للبيانات من أجل تحويل

قيمة الإرجاع	النوع	‏‏الوصف
<binary-for-data-uri>	السلسلة‬	الإصدار الثنائي لـ URI للبيانات

مثال

ينشئ هذا المثال الإصدار الثنائي لـ URI للبيانات:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

وإرجاع هذه النتيجة:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

إرجاع إصدار السلسلة لمعرف موارد منتظم (URI) للبيانات.

dataUriToString('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	URI للبيانات من أجل تحويل

قيمة الإرجاع	النوع	‏‏الوصف
<string-for-data-uri>	السلسلة‬	إصدار السلسلة لـ URI للبيانات

مثال

ينشئ هذا المثال سلسلة لـ URI للبيانات:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

وإرجاع هذه النتيجة: "hello"

عدم الاكتراث بالتاريخ

إرجاع الفرق بين طابعين زمنيين كمدى زمني. تطرح هذه الدالة startDate من endDate، وترجع النتيجة كطوابع زمنية بتنسيق سلسلة.

dateDifference('<startDate>', '<endDate>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<startDate>	‏‏نعم‬	السلسلة‬	سلسلة تحتوي على طابع زمني
<endDate>	‏‏نعم‬	السلسلة‬	سلسلة تحتوي على طابع زمني

قيمة الإرجاع	النوع	‏‏الوصف
<timespan>	السلسلة‬	الفرق بين الطابعين الزمنيين، وهو طابع زمني بتنسيق سلسلة. إذا كان `startDate` أحدث من `endDate`، تكون النتيجة قيمة سالبة.

مثال

يطرح هذا المثال القيمة الأولى من القيمة الثانية:

dateDifference('2015-02-08', '2018-07-30')

وإرجاع هذه النتيجة: "1268.00:00:00"

dayOfMonth

إرجاع أيام الشهر من الطابع الزمني.

dayOfMonth('<timestamp>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني

قيمة الإرجاع	النوع	‏‏الوصف
<day-of-month>	Integer	أيام الشهر من الطابع الزمني المحدد

مثال

يسترجع هذا المثال عدد أيام الشهر من هذا الطابع الزمني:

dayOfMonth('2018-03-15T13:27:36Z')

وإرجاع هذه النتيجة: 15

dayOfWeek

إرجاع أيام الأسبوع من الطابع الزمني.

dayOfWeek('<timestamp>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني

قيمة الإرجاع	النوع	‏‏الوصف
<day-of-week>	Integer	أيام الأسبوع من الطابع الزمني المحدد حيث الأحد هو 0، الاثنين هو 1، وهكذا

مثال

يسترجع هذا المثال عدد أيام الأسبوع من هذا الطابع الزمني:

dayOfWeek('2018-03-15T13:27:36Z')

وإرجاع هذه النتيجة: 4

dayOfYear

إرجاع أيام السنة من الطابع الزمني.

dayOfYear('<timestamp>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني

قيمة الإرجاع	النوع	‏‏الوصف
<day-of-year>	Integer	أيام السنة من الطابع الزمني المحدد

مثال

يسترجع هذا المثال عدد أيام السنة من هذا الطابع الزمني:

dayOfYear('2018-03-15T13:27:36Z')

وإرجاع هذه النتيجة: 74

عشري

أعد رقمًا عشريًا في سلسلة كرقم عشري. يمكنك استخدام هذه الدالة عند العمل مع البيانات التي تتطلب دقة عشرية وأيضًا كإدخال لدالات المقارنة المنطقية والدالات الرياضية. لالتقاط الدقة والحفاظ عليها عند استخدام النتيجة من الدالة decimal()، قم بتضمين أي إخراج عشري باستخدام دالة السلسلة. يظهر هذا الاستخدام في الأمثلة التالية الموضحة أدناه حيث يمكن أن تفقد الدقة إذا استخدمت النتيجة العشرية كرقم.

إشعار

الدقة العشرية التي تمت مناقشتها في سياق هذه الدالة ووقت تشغيل Azure Logic Apps هي نفسها الدقة العشرية NET.

decimal('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	العدد العشري في سلسلة

قيمة الإرجاع	النوع	‏‏الوصف
<عدد عشري>	رقم عشري	العدد العشري لسلسلة الإدخال

مثال 1

ينشئ هذا المثال عددًا عشريًا يُستخدم كرقم:

decimal('1.2345678912312131') // Returns 1.234567891231213.

مثال 2

ينشئ هذا المثال عددًا عشريًا ثم يحول النتيجة إلى سلسلة للحفاظ على الدقة:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

مثال 3

يستخدم هذا المثال دالة رياضية على رقمين عشريين ويستخدم النتيجة كرقم:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

مثال 4

يستخدم هذا المثال دالة رياضية على رقمين عشريين ويحول النتيجة إلى سلسلة للحفاظ على الدقة:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

فك ترميز Base64 (مهمل)

أهملت هذه الدالة، لذا استخدم base64ToString() بدلاً من ذلك.

decodeDataUri

إرجاع الإصدار الثنائي لمعرف موارد منتظم (URI) للبيانات. حاول استخدام dataUriToBinary()، بدلاً من decodeDataUri(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام dataUriToBinary().

إشعار

decodeDataUri('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	سلسلة URI للبيانات التي يجب فك ترميزها

قيمة الإرجاع	النوع	‏‏الوصف
<binary-for-data-uri>	السلسلة‬	الإصدار الثنائي لسلسلة URI للبيانات

مثال

يسترجع هذا المثال الإصدار الثنائي لـ URI للبيانات:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

وإرجاع هذه النتيجة:

decodeUriComponent

إرجاع سلسلة استبدال أحرف الإلغاء بإصدارات غير مرمزة.

decodeUriComponent('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المكونة من أحرف الإلغاء التي يجب فك ترميزها

قيمة الإرجاع	النوع	‏‏الوصف
<decoded-uri>	السلسلة‬	السلسلة المحدثة المكونة من أحرف الإلغاء التي تم فك ترميزها

مثال

يستبدل هذا المثال أحرف الإلغاء في هذه السلسلة بإصدارات تم فك ترميزها:

decodeUriComponent('https%3A%2F%2Fcontoso.com')

وإرجاع هذه النتيجة: "https://contoso.com"

div

إرجاع الناتج من قسمة رقمين. للحصول على النتيجة المتبقية، راجع mod().

div(<dividend>, <divisor>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<dividend>	‏‏نعم‬	عدد صحيح أو عائم	العدد الذي يجب قسمته على القاسم
<القاسم>	‏‏نعم‬	عدد صحيح أو عائم	الرقم الذي يقسم المقسوم، ولكن لا يمكن أن يكون صفرًا

قيمة الإرجاع	النوع	‏‏الوصف
<quotient-result>	عدد صحيح أو عائم	نتيجة قسمة الرقم الأول على الرقم الثاني. إذا كان المقسوم أو المقسوم عليه يحتوي على نوع عدد عشري، فإن النتيجة لها نوع عدد عشري. ملاحظة: لتحويل النتيجة العشرية إلى عدد صحيح، حاول إنشاء دالة واستدعائها في Azure من تطبيق المنطق الخاص بك.

مثال 1

كلا المثالين يعيدان هذه القيمة بنوع عدد صحيح: 2

div(10,5)
div(11,5)

مثال 2

كلا المثالين يعيدان هذه القيمة بنوع عدد عشري: 2.2

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

قم بإرجاع إصدار مرمز باستخدام معرّف الموارد المنتظم (URI) لسلسلة من خلال استبدال أحرف URL غير الآمنة بأحرف الإلغاء. حاول استخدام uriComponent () بدلاً من encodeUriComponent(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام uriComponent().

إشعار

encodeUriComponent('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المطلوب تحويلها إلى تنسيق مرمز بـ URI

قيمة الإرجاع	النوع	‏‏الوصف
<encoded-uri>	السلسلة‬	السلسلة المرمزة باستخدام URI مع أحرف الإلغاء

مثال

ينشئ هذا المثال إصدار مرمز باستخدام URI لهذه السلسلة:

encodeUriComponent('https://contoso.com')

وإرجاع هذه النتيجة: "https%3A%2F%2Fcontoso.com"

فارغ

التحقق مما إذا كانت المجموعة فارغة أم لا. إرجاع القيمة true عندما تكون المجموعة فارغة، أو إرجاع القيمة false عندما لا تكون فارغة.

empty('<collection>')
empty([<collection>])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف أو كائن	المجموعة التي يجب التحقق منها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما تكون المجموعة فارغة. إرجاع القيمة false عندما لا تكون فارغة.

مثال

تحقق هذه الأمثلة ما إذا كانت المجموعات المحددة فارغة:

empty('')
empty('abc')

وإرجاع هذه النتائج:

المثال الأول: تمرير سلسلة فارغة، بحيث ترجع قيمة الدالة true.
المثال الثاني: تمرير السلسلة "abc"، بحيث ترجع قيمة الدالة false.

endsWith

تحقق ما إذا كانت سلسلة تنتهي بسلسلة فرعية معينة. يتم إرجاع القيمة true عند العثور على سلسلة فرعية أو إرجاع القيمة false عند عدم العثور عليها. هذه الدالة ليست حساسة لحالة الأحرف.

endsWith('<text>', '<searchText>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي يجب التحقق منها
<searchText>	‏‏نعم‬	السلسلة‬	السلسلة الفرعية النهائية المطلوب البحث عنها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عند العثور على السلسلة الفرعية النهائية. إرجاع القيمة false عند عدم العثور عليه.

مثال 1

يتحقق هذا المثال ما إذا كانت سلسلة "hello" تنتهي بسلسلة "world":

endsWith('hello world', 'world')

وإرجاع هذه النتيجة: true

مثال 2

يتحقق هذا المثال ما إذا كانت سلسلة "hello" تنتهي بسلسلة "universe":

endsWith('hello world', 'universe')

وإرجاع هذه النتيجة: false

متساوٍ

تحقق مما إذا كانت كل من القيم أو التعبيرات أو العناصر متكافئة. إرجاع القيمة true عندما تكون كلاهما متساويين، أو إرجاع القيمة false عندما لا يكونان متساويين.

equals('<object1>', '<object2>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<عنصر1>، <عنصر2>	‏‏نعم‬	مختلف	القيم أو التعبيرات أو الكائنات التي يجب مقارنتها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما يكون كلاهما مساوياً. إرجاع القيمة false عندما لا يكون مساوياً.

مثال

تحقق هذه الأمثلة مما إذا كانت الإدخالات المحددة متساوية.

equals(true, 1)
equals('abc', 'abcd')

وإرجاع هذه النتائج:

المثال الأول: كلتا القيمتين متساويتان، وبالتالي ترجع الدالة true.
المثال الثاني: كلتا القيمتين غير متساويتين، وبالتالي ترجع الدالة false.

F

أولاً

إرجاع العنصر الأول من سلسلة أو صفيف.

first('<collection>')
first([<collection>])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف	المجموعة التي يمكن العثور فيها على العنصر الأول

قيمة الإرجاع	النوع	‏‏الوصف
<first-collection-item>	أي	العنصر الأول في المجموعة

مثال

تبحث هذه الأمثلة عن العنصر الأول في هذه المجموعات:

first('hello')
first(createArray(0, 1, 2))

وإرجاع هذه النتائج:

المثال الأول: "h"
المثال الثاني: 0

عائم

تحويل إصدار سلسلة لرقم الفاصلة العائمة إلى رقم فاصلة عائمة فعلية. يمكنك استخدام هذه الوظيفة فقط عند تمرير معلمات مخصصة إلى تطبيق، على سبيل المثال، سير عمل تطبيق منطقي أو تدفق Power Automate. لتحويل سلاسل الفاصلة العائمة الممثلة بتنسيقات خاصة باللغة المحلية، يمكنك اختياريا تحديد رمز إعدادات RFC 4646 المحلية.

float('<value>', '<locale>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على رقم عشري صالح للتحويل. القيم الدنيا والقصوى هي نفس حدود نوع بيانات العدد العشري.
<الإعدادات المحلية>	لا	السلسلة‬	رمز إعدادات RFC 4646 المحلية المراد استخدامه. إذا لم يتم تحديدها، يتم استخدام الإعدادات المحلية الافتراضية. إذا لم تكن اللغة المحلية قيمة صالحة، يتم إنشاء خطأ بأن اللغة المتوفرة غير صالحة أو لا تحتوي على إعدادات محلية مقترنة.

قيمة الإرجاع	النوع	‏‏الوصف
<float-value>	Float	الرقم العشري للسلسلة المحددة. القيم الدنيا والقصوى هي نفس حدود نوع بيانات العدد العشري.

مثال 1

ينشئ هذا المثال إصدار سلسلة لرقم الفاصلة العائمة هذا:

float('10,000.333')

وإرجاع هذه النتيجة: 10000.333

مثال 2

ينشئ هذا المثال إصدار سلسلة لرقم الفاصلة العائمة على النمط الألماني هذا:

float('10.000,333', 'de-DE')

وإرجاع هذه النتيجة: 10000.333

formatDateTime

إرجاع طابع زمني بالتنسيق المحدد.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية.
<الإعدادات المحلية>	لا	السلسلة‬	إعدادات محلية للاستخدام. في حالة عدم تحديدها، فإن القيمة هي `en-us`. إذا لم تكن الإعدادات المحلية قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<reformatted-timestamp>	السلسلة‬	الطابع الزمني المحدث بالتنسيق المحدد والإعدادات المحلية، في حالة تحديده.

الأمثلة

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

أعد صفيفًا مع قيم تطابق اسم مفتاح في إخراج بيانات النموذج أو ترميز النموذج الخاص بالإجراء.

formDataMultiValues('<actionName>', '<key>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	الإجراء الذي يحتوي إخراجه على القيمة الأساسية التي تريدها
<مفتاح>	‏‏نعم‬	السلسلة‬	اسم المفتاح الذي ترغب في قيمته

قيمة الإرجاع	النوع	‏‏الوصف
[<array-with-key-values>]	صفيف	صفيف بكل القيم التي تطابق المفتاح المحدد

مثال

ينشئ هذا المثال صفيفًا من قيمة المفتاح «الموضوع» في إخراج بيانات النموذج أو ترميز النموذج الخاص بالإجراء المحدد:

formDataMultiValues('Send_an_email', 'Subject')

ويرجع نص الموضوع في صفيف، على سبيل المثال: ["Hello world"]

formDataValue

أعد قيمة واحدة تطابق اسم مفتاح في إخراج بيانات النموذج أو ترميز النموذج الخاص بالإجراء. إذا عثرت الدالة على أكثر من تطابق، فستتسبب هذه الدالة في حدوث خطأ.

formDataValue('<actionName>', '<key>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	الإجراء الذي يحتوي إخراجه على القيمة الأساسية التي تريدها
<مفتاح>	‏‏نعم‬	السلسلة‬	اسم المفتاح الذي ترغب في قيمته

قيمة الإرجاع	النوع	‏‏الوصف
<قيمة-المفتاح>	السلسلة‬	القيمة الموجودة في مفتاح محدد

مثال

ينشئ هذا المثال سلسلة من قيمة المفتاح «الموضوع» في إخراج بيانات النموذج أو ترميز النموذج الخاص بالإجراء المحدد:

formDataValue('Send_an_email', 'Subject')

ويرجع نص الموضوع كسلسلة، على سبيل المثال: "Hello world"

formatNumber

أعد رقمًا كسلسلة تستند إلى التنسيق المحدد.

formatNumber(<number>, <format>, <locale>?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<رقم>	‏‏نعم‬	عدد صحيح أو مزدوج	القيمة التي ترغب في تنسيقها.
<format>	‏‏نعم‬	السلسلة‬	سلسلة تنسيق مركّبة تحدد التنسيق الذي تريد استخدامه. للحصول على سلاسل التنسيق الرقمي المدعومة، يرجى مراجعة سلاسل التنسيق الرقمي القياسية، والتي يدعمها `number.ToString(<format>, <locale>)`.
<الإعدادات المحلية>	لا	السلسلة‬	الإعدادات المحلية لاستخدامها كما هو مدعوم من جانب `number.ToString(<format>, <locale>)`. في حالة عدم تحديدها، فإن القيمة هي `en-us`. إذا لم تكن الإعدادات المحلية قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<رقم منسق>	السلسلة‬	الرقم المحدد كسلسلة بالتنسيق الذي حددته. يمكنك تحويل هذه القيمة المرجعة إلى`int` أو `float`.

مثال 1

بافتراض أنك تريد تنسيق الرقم 1234567890. ينسق هذا المثال الرقم الموضح كسلسلة «1,234,567,890,00».

formatNumber(1234567890, '0,0.00', 'en-us')

*مثال 2»

بافتراض أنك تريد تنسيق الرقم 1234567890. ينسق هذا المثال الرقم إلى السلسلة «1,234,567,890,00».

formatNumber(1234567890, '0,0.00', 'is-is')

مثال 3

بافتراض أنك تريد تنسيق الرقم 17.35. ينسق هذا المثال الرقم إلى السلسلة «17.35دولارًا».

formatNumber(17.35, 'C2')

مثال 4

بافتراض أنك تريد تنسيق الرقم 17.35. ينسق هذا المثال الرقم إلى السلسلة «17,35 كرونة سويدية».

formatNumber(17.35, 'C2', 'is-is')

G

getFutureTime

إرجاع الطابع الزمني الحالي بالإضافة إلى وحدات الوقت المحددة.

getFutureTime(<interval>, <timeUnit>, <format>?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الفاصل الزمني>	‏‏نعم‬	Integer	عدد الوحدات الزمنية المطلوب إضافتها
<timeUnit>	‏‏نعم‬	السلسلة‬	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<format>	لا	السلسلة‬	إما محدد تنسيق فردي أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ يفيد بأن التنسيق المقدم غير صالح ويجب أن يكون سلسلة تنسيق رقمية.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني الحالي بالإضافة إلى عدد الوحدات الزمنية المحددة

مثال 1

افترض أن الطابع الزمني الحالي هو "2018-03-01T00:00:00.0000000Z". يضيف هذا المثال خمسة أيام إلى هذا الطابع الزمني:

getFutureTime(5, 'Day')

وإرجاع هذه النتيجة: "2018-03-06T00:00:00.0000000Z"

مثال 2

افترض أن الطابع الزمني الحالي هو "2018-03-01T00:00:00.0000000Z". يضيف هذا المثال خمسة أيام ويحول النتيجة إلى تنسيق "D":

getFutureTime(5, 'Day', 'D')

وإرجاع هذه النتيجة: "Tuesday, March 6, 2018"

getPastTime

إرجاع الطابع الزمني الحالي مطروحاً منه الوحدات الزمنية المحددة.

getPastTime(<interval>, <timeUnit>, <format>?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الفاصل الزمني>	‏‏نعم‬	Integer	عدد الوحدات الزمنية المحددة المطلوب طرحها
<timeUnit>	‏‏نعم‬	السلسلة‬	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<format>	لا	السلسلة‬	إما محدد تنسيق فردي أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ يفيد بأن التنسيق المقدم غير صالح ويجب أن يكون سلسلة تنسيق رقمية.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني الحالي مطروحاً منه العدد المحدد للوحدات الزمنية

مثال 1

افترض أن الطابع الزمني الحالي هو "2018-02-01T00:00:00.0000000Z". يطرح هذا المثال خمسة أيام من هذا الطابع الزمني:

getPastTime(5, 'Day')

وإرجاع هذه النتيجة: "2018-01-27T00:00:00.0000000Z"

مثال 2

افترض أن الطابع الزمني الحالي هو "2018-02-01T00:00:00.0000000Z". يطرح هذا المثال خمسة أيام ثم يحول النتيجة إلى تنسيق "D":

getPastTime(5, 'Day', 'D')

وإرجاع هذه النتيجة: "Saturday, January 27, 2018"

أكبر

التحقق مما إذا كانت القيمة الأولى أكبر من القيمة الثانية. إرجاع القيمة true عندما تكون القيمة الأولى أكثر أو إرجاع القيمة false عندما تكون أقل.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة	القيمة الأولى للتحقق مما إذا كانت أكبر من القيمة الثانية
<compareTo>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة على التوالي	قيمة المقارنة

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما تكون القيمة الأولى أكبر من القيمة الثانية. إرجاع القيمة false عندما تكون القيمة الأولى مساوية أو أقل من القيمة الثانية.

مثال

تحقق هذه الأمثلة ما إذا كانت القيمة الأولى أكبر من القيمة الثانية:

greater(10, 5)
greater('apple', 'banana')

وإرجاع هذه النتائج:

المثال الأول: true
المثال الثاني: false

greaterOrEquals

التحقق مما إذا كانت القيمة الأولى أكبر من أو مساوية للقيمة الثانية. إرجاع القيمة true عندما تكون القيمة الأولى أكبر أو تساوي أو إرجاع القيمة false عندما تكون القيمة الأولى أقل.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة	القيمة الأولى للتحقق مما إذا كانت أكبر من أو تساوي القيمة الثانية
<compareTo>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة على التوالي	قيمة المقارنة

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما تكون القيمة الأولى أكبر من القيمة الثانية أو مساوية لها. إرجاع القيمة false عندما تكون القيمة الأولى أقل من القيمة الثانية.

مثال

تحقق هذه الأمثلة ما إذا كانت القيمة الأولى أكبر من أو تساوي القيمة الثانية:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

وإرجاع هذه النتائج:

المثال الأول: true
المثال الثاني: false

guid

إنشاء معرف فريد عمومي (GUID) كسلسلة، على سبيل المثال، "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

يمكنك كذلك تحديد تنسيق مختلف للمعرف الفريد العمومي غير التنسيق الافتراضي " D "، وهو 32 رقماً مفصولاً بالواصلات.

guid('<format>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<format>	لا	السلسلة‬	محدد تنسيق واحد للمعرف الفريد العمومي الذي تم إرجاعه. التنسيق الافتراضي هو "D"، ولكن يمكنك استخدام "N" أو "D"أو "B" أو"P" أو "X".

قيمة الإرجاع	النوع	‏‏الوصف
<GUID-value>	السلسلة‬	المعرف الفريد العمومي الذي تم إنشاؤه عشوائياً

مثال

ينشئ هذا المثال نفس المعرف الفريد العمومي ولكن على هيئة 32 رقماً مفصولاً بواصلات ومحاطاً بأقواس:

guid('P')

وإرجاع هذه النتيجة: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

التحقق مما إذا كان التعبير صحيحاً أم خطأ. بناءً على النتيجة، قم بإرجاع قيمة محددة. يتم تقييم المعلمات من اليسار إلى اليمين.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<تعبير>	‏‏نعم‬	Boolean	التعبير الذي يجب التحقق منه
<valueIfTrue>	‏‏نعم‬	أي	القيمة التي يجب إرجاعها عندما يكون التعبير صحيحاً
<valueIfFalse>	‏‏نعم‬	أي	القيمة التي يجب إرجاعها عندما يكون التعبير غير صحيح

قيمة الإرجاع	النوع	‏‏الوصف
<specified-return-value>	أي	القيمة المحددة التي تُرجع بناءً على ما إذا كان التعبير صحيحاً أم خاطئاً

مثال

يرجع هذا المثال "yes" لأن التعبير المحدد يرجع بالقيمة إلى true. وإلا، يرجع المثال "no":

if(equals(1, 1), 'yes', 'no')

indexOf

إرجاع موضع البداية أو قيمة الفهرس لسلسلة فرعية. هذه الدالة ليست حساسة لحالة الأحرف، وتبدأ الفهارس بالرقم 0.

indexOf('<text>', '<searchText>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تحتوي على السلسلة الفرعية للبحث عنها
<searchText>	‏‏نعم‬	السلسلة‬	السلسلة الفرعية المطلوب البحث عنها

قيمة الإرجاع	النوع	‏‏الوصف
<index-value>	Integer	موضع البداية أو قيمة الفهرس للسلسلة الفرعية المحددة. في حالة عدم العثور على السلسلة، يرجع الرقم -1.

مثال

يبحث هذا المثال عن قيمة فهرس البداية للسلسلة الفرعية "world" في سلسلة "hello world":

indexOf('hello world', 'world')

وإرجاع هذه النتيجة: 6

العدد الصحيح

حول إصدار السلسلة من عدد صحيح إلى عدد صحيح حقيقي.

int('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	إصدار سلسلة للعدد الصحيح المراد تحويله. تعد القيم الدنيا والقصوى هي نفس الحدود لنوع بيانات العدد الصحيح.

قيمة الإرجاع	النوع	‏‏الوصف
<integer-result>	Integer	إصدار عدد صحيح للسلسلة المحددة. تعد القيم الدنيا والقصوى هي نفس الحدود لنوع بيانات العدد الصحيح.

مثال

ينشئ هذا المثال إصدار عدد صحيح للسلسلة "10":

int('10')

وإرجاع هذه النتيجة: 10

isFloat

إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة. بشكل افتراضي، تستخدم هذه الدالة الثقافة الثابتة لتنسيق الفاصلة العائمة. لتحديد أرقام الفاصلة العائمة الممثلة في تنسيقات أخرى خاصة باللغة المحلية، يمكنك اختياريا تحديد رمز إعدادات RFC 4646 المحلية.

isFloat('<string>', '<locale>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة التي يجب فحصها
<الإعدادات المحلية>	لا	السلسلة‬	رمز إعدادات RFC 4646 المحلية المراد استخدامه

قيمة الإرجاع	النوع	‏‏الوصف
<نتيجة منطقية>	Boolean	قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة

مثال 1

يتحقق هذا المثال مما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة في الثقافة غير المتباينة:

isFloat('10,000.00')

وإرجاع هذه النتيجة: true

مثال 2

يتحقق هذا المثال مما إذا كانت السلسلة عبارة عن رقم فاصلة عائمة في الإعدادات المحلية الألمانية:

isFloat('10.000,00', 'de-DE')

وإرجاع هذه النتيجة: true

isInt

إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عبارة عن عدد صحيح.

isInt('<string>')

المعلمة‬	المطلوب	نوع	الوصف
<string>	‏‏نعم‬	السلسلة‬	السلسلة التي يجب فحصها

قيمة الإرجاع	النوع	‏‏الوصف
<نتيجة منطقية>	Boolean	قيمة منطقية تشير إلى ما إذا كانت السلسلة عددا صحيحا

مثال

يتحقق هذا المثال مما إذا كانت السلسلة عبارة عن عدد صحيح:

isInt('10')

وإرجاع هذه النتيجة: true

عنصر

عند استخدامها داخل إجراء متكرر على صفيف أعد العنصر الحالي في الصفيف أثناء التكرار الحالي للإجراء. بإمكانك أيضًا الحصول على القيم من خصائص هذا العنصر.

item()

قيمة الإرجاع	النوع	‏‏الوصف
<عنصر صفيف حالي>	أي	العنصر الحالي في الصفيف لتكرار الإجراء الحالي

مثال

يحصل هذا المثال على العنصر body من الرسالة الحالية لإجراء «إرسال رسالة بريد إلكتروني» داخل التكرار الحالي لحلقة for-each:

item().body

items

أعد العنصر الحالي من كل دورة في تكرار for-each. استخدم هذه الدالة داخل تكرار for-each.

items('<loopName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<loopName>	‏‏نعم‬	السلسلة‬	الاسم لتكرار for-each

قيمة الإرجاع	النوع	الوصف
<عنصر>	أي	عنصر من الدورة الحالية في تكرار for-each المحدد

مثال

يحصل هذا المثال على العنصر الحالي من تكرار for-each المحدد:

items('myForEachLoopName')

iterationIndexes

أعد قيمة الفهرس للتكرار الحالي داخل تكرار Until. يمكنك استخدام هذه الدالة داخل تكرار Until المتداخل.

iterationIndexes('<loopName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<loopName>	‏‏نعم‬	السلسلة‬	اسم تكرار Until

قيمة الإرجاع	النوع	‏‏الوصف
<فهرس>	Integer	قيمة الفهرس للتكرار الحالي داخل تكرار Until المحدد

مثال

ينشئ هذا المثال متغير عداد ويزيد ذلك المتغير بمقدار واحد خلال كل تكرار في تكرار Until حتى تصل قيمة العداد إلى خمسة. ينشئ المثال أيضًا متغيرًا يتتبع الفهرس الحالي لكل تكرار. أثناء كل تكرار في تكرار Until، يزيد المثال قيمة العداد ثم يعين قيمة العداد إلى قيمة الفهرس الحالية ثم يزيد قيمة العداد. أثناء التكرار، يشير هذا المثال إلى فهرس التكرار الحالي باستخدام الدالة iterationIndexes:

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

أعد قيمة نوع JavaScript Object Notation (JSON) أو عنصر أو مصفوفة عناصر لسلسلة أو XML.

json('<value>')
json(xml('value'))

هام

بدون مخطط XML الذي يحدد بنية الإخراج، يمكن أن تعرض الدالة النتائج حيث تختلف البنية اختلافًا كبيرًا عن التنسيق المتوقع، اعتمادًا على الإدخال.

يجعل هذا السلوك هذه الدالة غير مناسبة للسيناريوهات التي يلزم أن يتوافق فيها الإخراج مع عقد محدد جيدًا، على سبيل المثال، في أنظمة أو حلول الأعمال المهمة.

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة أو XML	السلسلة أو XML للتحويل

قيمة الإرجاع	النوع	‏‏الوصف
<JSON-result>	نوع أو عنصر أو صفيف أصلي خاص بـ JSON	قيمة نوع JSON الأصلي أو عنصر أو صفيف عناصر من سلسلة الإدخال أو XML. - إذا قمت بتمرير XML الذي يحتوي على عنصر تابع واحد في العنصر الجذر، ترجع الدالة عنصر JSON واحدا لهذا العنصر التابع. - إذا قمت بتمرير XML يحتوي على العديد من العناصر التابعة في العنصر الجذر، فستعيد الدالة صفيفًا يحتوي على عناصر JSON لتلك العناصر التابعة. - إذا كانت السلسلة خالية، فإن الدالة ترجع عنصرًا فارغًا.

مثال 1

يحول هذا المثال هذه السلسلة إلى قيمة JSON:

json('[1, 2, 3]')

وإرجاع هذه النتيجة: [1, 2, 3]

مثال 2

يحول هذا المثال هذه السلسلة إلى JSON:

json('{"fullName": "Sophia Owen"}')

وإرجاع هذه النتيجة:

{
  "fullName": "Sophia Owen"
}

مثال 3

يستخدم هذا المثال الدالتين json() وxml() لتحويل XML الذي يحتوي على عنصر تابع واحد في العنصر الجذر إلى عنصر JSON يسمى person لهذا العنصر التابع:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

وإرجاع هذه النتيجة:

{
   "?xml": { 
      "@version": "1.0" 
   },
   "root": {
      "person": {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      }
   }
}

مثال 4

يستخدم هذا المثال الدالتين json() وxml() لتحويل XML الذي يحتوي على عناصر تابعة متعددة في العنصر الجذر إلى صفيف يسمى person يحتوي على عناصر JSON لتلك العناصر التابعة:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</name> <occupation>Engineer</occupation> </person> </root>'))

وإرجاع هذه النتيجة:

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

intersection

إرجاع مجموعة تحتوي فقط على العناصر المشتركة عبر المجموعات المحددة. لكي تظهر في النتيجة، يجب أن يظهر عنصر في جميع المجموعات التي تم تمريرها إلى هذه الدالة. إذا كان عنصر واحد أو أكثر يحمل نفس الاسم، يظهر العنصر الأخير بهذا الاسم في النتيجة.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة1>، <مجموعة2>، ...	‏‏نعم‬	صفيف أو كائن، ولكن ليس كليهما	المجموعات من حيث تريد العناصر الشائعة فقط

قيمة الإرجاع	النوع	‏‏الوصف
<common-items>	صفيف أو كائن، على التوالي	مجموعة تحتوي على العناصر الشائعة فقط عبر المجموعات المحددة

مثال

يبحث هذا المثال عن العناصر الشائعة عبر هذه الصفائف:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

وإرجاع صفيف مع هذه العناصر فقط:[1, 2]

join

إرجاع سلسلة تحتوي على جميع العناصر من صفيف ويفصل بين كل حرف منها محدِّد.

join([<collection>], '<delimiter>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	صفيف	الصفيف الذي يحتوي على العناصر للانضمام
<المحدِّد>	‏‏نعم‬	السلسلة‬	الفاصل الذي يظهر بين كل حرف في السلسلة الناتجة

قيمة الإرجاع	النوع	‏‏الوصف
<حرف1><محدِّد><حرف2><محدِّد>...	السلسلة‬	أنشئت السلسلة الناتجة من كافة العناصر في الصفيف المحدد. ملاحظة: يجب ألا يتجاوز طول النتيجة 104,857,600 حرف.

مثال

ينشئ هذا المثال سلسلة من جميع العناصر في هذا الصفيف من خلال الحرف المحدد كمحدد:

join(createArray('a', 'b', 'c'), '.')

وإرجاع هذه النتيجة: "a.b.c"

L

last

إرجاع العنصر الأخير من مجموعة.

last('<collection>')
last([<collection>])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف	المجموعة التي يمكن العثور فيها على العنصر الأخير

قيمة الإرجاع	النوع	‏‏الوصف
<last-collection-item>	سلسلة أو صفيف، على التوالي	العنصر الأخير في المجموعة

مثال

تبحث هذه الأمثلة عن العنصر الأخير في هذه المجموعات:

last('abcd')
last(createArray(0, 1, 2, 3))

وإرجاع هذه النتائج:

المثال الأول: "d"
المثال الثاني: 3

lastIndexOf

إرجاع موضع البداية أو قيمة الفهرس لآخر تكرار لسلسة فرعية. هذه الدالة ليست حساسة لحالة الأحرف، وتبدأ الفهارس بالرقم 0.

lastIndexOf('<text>', '<searchText>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تحتوي على السلسلة الفرعية للبحث عنها
<searchText>	‏‏نعم‬	السلسلة‬	السلسلة الفرعية المطلوب البحث عنها

قيمة الإرجاع	النوع	‏‏الوصف
<ending-index-value>	Integer	موضع البداية أو قيمة الفهرس لآخر تكرار للسلسلة الفرعية المحددة.

إذا كانت قيمة السلسلة أو السلسلة الفرعية فارغة، يحدث السلوك الموضح أدناه:

في حالة كانت قيمة السلسلة فقط فارغة، ترجع الدالة -1.
في حالة كانت قيم السلسلة والسلسلة الفرعية فارغة، ترجع الدالة 0.
في حالة كانت قيمة السلسلة الفرعية فقط فارغة، ترجع الدالة طول السلسلة مطروحًا منه 1.

الأمثلة

يبحث هذا المثال عن قيمة فهرس البداية للتكرار الأخير للسلسلة worldالفرعية في السلسلة hello world hello world. النتيجة التي أعيدت هي 18:

lastIndexOf('hello world hello world', 'world')

يفتقد هذا المثال معلمة السلسلة الفرعية، ويرجع قيمة 22 لأن قيمة سلسلة الإدخال (23) مطروحًا منها 1 أكبر من 0.

lastIndexOf('hello world hello world', '')

طول

إرجاع عدد العناصر الموجودة في مجموعة.

length('<collection>')
length([<collection>])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف	المجموعة التي تحتوي على عناصر يجب عدها

قيمة الإرجاع	النوع	‏‏الوصف
<length-or-count>	Integer	عدد العناصر الموجودة في المجموعة

مثال

تحسب هذه الأمثلة عدد العناصر في هذه المجموعات:

length('abcd')
length(createArray(0, 1, 2, 3))

وإرجاع هذه النتيجة: 4

أقل

التحقق مما إذا كانت القيمة الأولى أقل من القيمة الثانية. إرجاع القيمة true عندما تكون القيمة الأولى أقل أو إرجاع القيمة false عندما تكون القيمة الأولى أكبر.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة	القيمة الأولى للتحقق مما إذا كانت أقل من القيمة الثانية
<compareTo>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة على التوالي	عنصر المقارنة

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما تكون القيمة الأولى أقل من القيمة الثانية. إرجاع القيمة false عندما تكون القيمة الأولى مساوية أو أكبر من القيمة الثانية.

مثال

تتحقق هذه الأمثلة مما إذا كانت القيمة الأولى أقل من القيمة الثانية.

less(5, 10)
less('banana', 'apple')

وإرجاع هذه النتائج:

المثال الأول: true
المثال الثاني: false

lessOrEquals

التحقق مما إذا كانت القيمة الأولى أقل من أو مساوية للقيمة الثانية. إرجاع القيمة true عندما تكون القيمة الأولى أقل أو تساوي أو إرجاع القيمة false عندما تكون القيمة الأولى أكبر.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة	القيمة الأولى للتحقق مما إذا كانت أقل من أو تساوي القيمة الثانية
<compareTo>	‏‏نعم‬	عدد صحيح أو عائم أو سلسلة على التوالي	عنصر المقارنة

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عندما تكون القيمة الأولى أقل من القيمة الثانية أو مساوية لها. إرجاع القيمة false عندما تكون القيمة الأولى أكبر من القيمة الثانية.

مثال

تتحقق هذه الأمثلة مما إذا كانت القيمة الأولى أقل من أو تساوي القيمة الثانية.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

وإرجاع هذه النتائج:

المثال الأول: true
المثال الثاني: false

listCallbackUrl

أعد «عنوان URL لرد الاتصال» الذي يستدعي مشغلاً أو إجراءً. تعمل هذه الدالة فقط مع المشغلات والإجراءات الخاصة بنوعي موصل HttpWebhook وApiConnectionWebhook، ولكن ليس أنواع Manual وRecurrence وHTTP وAPIConnection.

listCallbackUrl()

قيمة الإرجاع	النوع	‏‏الوصف
<عنوان URL الخاص برد الاتصال>	السلسلة‬	عنوان URL الخاص برد الاتصال لمشغل أو إجراء

مثال

يوضح هذا المثال نموذج عنوان URL لرد الاتصال الذي يمكن أن تعيده هذه الدالة:

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

max

إرجاع القيمة الأعلى من قائمة أو صفيف ذات أرقام متضمنة في كلا الطرفين.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<رقم1>، <رقم2>، ...	‏‏نعم‬	عدد صحيح أو عائم أو كلاهما	مجموعة الأرقام التي تريد منها أعلى قيمة
[<رقم1>، <رقم2>، ...]	‏‏نعم‬	صفيف - عدد صحيح أو عائم أو كليهما	صفيف الأرقام التي تريد من خلالها أعلى قيمة

قيمة الإرجاع	النوع	‏‏الوصف
<max-value>	عدد صحيح أو عائم	أعلى قيمة في الصفيف المحدد أو مجموعة الأرقام

مثال

تحصل هذه الأمثلة على أعلى قيمة من مجموعة الأرقام والصفيف:

max(1, 2, 3)
max(createArray(1, 2, 3))

وإرجاع هذه النتيجة: 3

دقيقة

إرجاع القيمة الأقل من مجموعة من الأرقام أو صفيف.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<رقم1>، <رقم2>، ...	‏‏نعم‬	عدد صحيح أو عائم أو كلاهما	مجموعة الأرقام التي تريد منها أدنى قيمة
[<رقم1>، <رقم2>، ...]	‏‏نعم‬	صفيف - عدد صحيح أو عائم أو كليهما	مصفوفة الأرقام التي تريد منها أدنى قيمة

قيمة الإرجاع	النوع	‏‏الوصف
<min-value>	عدد صحيح أو عائم	أدنى قيمة في مجموعة الأرقام المحددة أو الصفيف المحدد

مثال

تحصل هذه الأمثلة على أقل قيمة في مجموعة الأرقام والصفيف:

min(1, 2, 3)
min(createArray(1, 2, 3))

وإرجاع هذه النتيجة: 1

mod

إرجاع الباقي من قسمة رقمين. للحصول على نتيجة العدد الصحيح، راجع div().

mod(<dividend>, <divisor>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<dividend>	‏‏نعم‬	عدد صحيح أو عائم	العدد الذي يجب قسمته على القاسم
<القاسم>	‏‏نعم‬	عدد صحيح أو عائم	الرقم الذي يقسم المقسوم، ولكن لا يمكن أن يكون صفرًا

قيمة الإرجاع	النوع	‏‏الوصف
<modulo-result>	عدد صحيح أو عائم	الباقي من قسمة الرقم الأول على الرقم الثاني

مثال 1

يقسم هذا المثال الرقم الأول على الرقم الثاني:

mod(3, 2)

وإرجاع هذه النتيجة: 1

مثال 2

يوضح هذا المثال أنه إذا كانت إحدى القيمتين أو كلتيهما سالبة، فإن النتيجة تطابق علامة المقسوم:

mod(-5, 2)
mod(4, -3)

يعرض المثال هذه النتائج:

المثال الأول: -1
المثال الثاني: 1

mul

إرجاع الناتج من ضرب رقمين.

mul(<multiplicand1>, <multiplicand2>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<multiplicand1>	‏‏نعم‬	عدد صحيح أو عائم	الرقم المطلوب ضربه في multiplicand2
<multiplicand2>	‏‏نعم‬	عدد صحيح أو عائم	الرقم الذي يتم ضربه في multiplicand1

قيمة الإرجاع	النوع	‏‏الوصف
<product-result>	عدد صحيح أو عائم	حاصل ضرب الرقم الأول في الرقم الثاني

مثال

هذه الأمثلة لضرب الرقم الأول في الرقم الثاني:

mul(1, 2)
mul(1.5, 2)

وإرجاع هذه النتائج:

المثال الأول: 2
المثال الثاني 3

multipartBody

أعد النص الأساسي لجزء معين في إخراج إجراء يتكون من أجزاء متعددة.

multipartBody('<actionName>', <index>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم الإجراء الذي يشتمل على إخراج بأجزاء متعددة
<فهرس>	‏‏نعم‬	Integer	قيمة الفهرس للجزء الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<النص الأساسي>	السلسلة‬	النص الأساسي الخاص بالجزء المحدد

N

لا

التحقق مما إذا كان التعبير غير صحيح. إرجاع true عندما يكون التعبير غير صحيح أو إرجاع false عندما يكون صحيحاً.

not(<expression>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<تعبير>	‏‏نعم‬	Boolean	التعبير الذي يجب التحقق منه

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع true عندما يكون التعبير غير صحيح. إرجاع false عندما يكون التعبير صحيحاً.

مثال 1

تتحقق هذه الأمثلة مما إذا كانت التعبيرات المحددة خاطئة:

not(false)
not(true)

وإرجاع هذه النتائج:

المثال الأول: التعبير غير صحيح، وبالتالي ترجع الدالة true.
المثال الثاني: التعبير صحيح، وبالتالي ترجع الدالة false.

مثال 2

تتحقق هذه الأمثلة مما إذا كانت التعبيرات المحددة خاطئة:

not(equals(1, 2))
not(equals(1, 1))

وإرجاع هذه النتائج:

المثال الأول: التعبير غير صحيح، وبالتالي ترجع الدالة true.
المثال الثاني: التعبير صحيح، وبالتالي ترجع الدالة false.

nthIndexOf

إرجاع موضع البداية أو قيمة الفهرس حيث يتضح التكرار nلسلسلة فرعية في سلسلة.

nthIndexOf('<text>', '<searchText>', <occurrence>)

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تشتمل على السلسلة الفرعية للبحث عنها
<searchText>	‏‏نعم‬	السلسلة‬	السلسلة الفرعية المطلوب البحث عنها
<تكرار>	‏‏نعم‬	Integer	رقم يحدد تكرار n من السلسلة الفرعية للبحث عنها. في حالة كان التكرار سالبًا، فابدأ البحث من النهاية.

قيمة الإرجاع	النوع	‏‏الوصف
<index-value>	Integer	موضع البداية أو قيمة الفهرس لتكرار n للسلسلة الفرعية المحددة. في حالة عدم العثور على السلسلة الفرعية أو توجد تكرارات أقل من n للسلسلة الفرعية، فسترجع `-1`.

الأمثلة

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

أو

التحقق مما إذا كان هناك تعبير واحد على الأقل صحيح. أعد صحيح عندما يكون تعبير واحد على الأقل صحيحًا، أو أعد خطأ عندما تكون جميعها خطأ.

or(<expression1>, <expression2>, ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<تعبير1>، <تعبير2>، ...	‏‏نعم‬	Boolean	التعبيرات التي يجب التحقق منها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع true عندما يكون تعبير واحد على الأقل صحيحاً. أعد خطأ عندما تكون جميع التعبيرات خطأ.

مثال 1

تتحقق هذه الأمثلة مما إذا كان تعبير واحد على الأقل صحيحاً:

or(true, false)
or(false, false)

وإرجاع هذه النتائج:

المثال الأول: تعبير واحد على الأقل صحيح، وبالتالي ترجع الدالة true.
المثال الثاني: كلا التعبيرين غير صحيح، وبالتالي ترجع الدالة false.

مثال 2

تتحقق هذه الأمثلة مما إذا كان تعبير واحد على الأقل صحيحاً:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

وإرجاع هذه النتائج:

المثال الأول: تعبير واحد على الأقل صحيح، وبالتالي ترجع الدالة true.
المثال الثاني: كلا التعبيرين غير صحيح، وبالتالي ترجع الدالة false.

نتائج

أعد الإخراجات الخاصة بالإجراء في وقت التشغيل. استخدم هذه الدالة، بدلاً من actionOutputs()، التي تحل إلى outputs() في المصمم. على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام outputs().

outputs('<actionName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<actionName>	‏‏نعم‬	السلسلة‬	اسم إخراج الإجراء الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<الإخراج>	السلسلة‬	الإخراج من الإجراء المحدد

مثال

يحصل هذا المثال على الإخراج من إجراء Twitter Get user:

outputs('Get_user')

وإرجاع هذه النتيجة:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

المعلمات

أعد قيمة المعلمة الموضحة في تعريف سير العمل الخاص بك.

parameters('<parameterName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<parameterName>	‏‏نعم‬	السلسلة‬	اسم المعلمة التي ترغب في قيمتها

قيمة الإرجاع	النوع	‏‏الوصف
<قيمة المعلمة>	أي	قيمة معلمة محددة

مثال

افترض أن لديك قيمة JSON هذه:

{
  "fullName": "Sophia Owen"
}

يتناول هذا المثال قيمة المعلمة المحددة:

parameters('fullName')

وإرجاع هذه النتيجة: "Sophia Owen"

parseDateTime

استعد الطابع الزمني من سلسلة تحتوي على طابع زمني.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<الإعدادات المحلية>	لا	السلسلة‬	إعدادات محلية للاستخدام. في حالة عدم التحديد، فإن الإعدادات المحلية الافتراضية هي `en-us`. إذا لم تكن الإعدادات المحلية قيمة صالحة، فسيتم إنشاء خطأ.
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة عدم تحديد التنسيق، فحاول تحليله بتنسيقات متعددة متوافقة مع الإعدادات المحلية المتوفرة. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<طابع زمني موزع>	السلسلة‬	الطابع الزمني الموزع بتنسيق «o» (yyyy-MM-ddTHH: mm: ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية.

الأمثلة

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

عشوائي

إرجاع عدد صحيح عشوائي من نطاق محدد، والذي يكون شاملاً فقط في نهاية البداية.

rand(<minValue>, <maxValue>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<minValue>	‏‏نعم‬	Integer	أقل عدد صحيح في النطاق
<maxValue>	‏‏نعم‬	Integer	العدد الصحيح الذي يلي أعلى عدد صحيح في النطاق الذي يمكن أن ترجعه الدالة

قيمة الإرجاع	النوع	‏‏الوصف
<random-result>	Integer	تم إرجاع العدد الصحيح العشوائي من النطاق المحدد

مثال

يحصل هذا المثال على عدد صحيح عشوائي من النطاق المحدد، باستثناء القيمة القصوى:

rand(1, 5)

وإرجاع أحد هذه الأرقام كنتيجة: 1 أو 2 أو 3 أو 4

النطاق

إرجاع صفيف عدد صحيح يبدأ من عدد صحيح محدد.

range(<startIndex>, <count>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<startIndex>	‏‏نعم‬	Integer	قيمة عدد صحيح تبدأ الصفيف كعنصر أول
<count>	‏‏نعم‬	Integer	عدد الأعداد الصحيحة في الصفيف. يجب أن تكون قيمة المعلمة `count` عددًا صحيحًا موجبًا لا يتجاوز 100,000. ملاحظة: يجب ألا يتجاوز مجموع قيم `startIndex` و`count` 2,147,483,647.

قيمة الإرجاع	النوع	‏‏الوصف
[<range-result>]	صفيف	الصفيف ذو الأعداد الصحيحة يبدأ من الفهرس المحدد

مثال

ينشئ هذا المثال صفيف عدد صحيح يبدأ من الفهرس المحدد ويحتوي على عدد محدد من الأعداد الصحيحة:

range(1, 4)

وإرجاع هذه النتيجة: [1, 2, 3, 4]

removeProperty

أزل خاصية من عنصر JSON وأرجع العنصر المحدث. في حالة عدم وجود الخاصية التي تحاول إزالتها، ترجع الدالة العنصر الأصلي.

removeProperty(<object>, '<property>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON الذي تريد إزالة خاصية منه
<خاصية>	‏‏نعم‬	السلسلة‬	اسم الخاصية التي تريد إزالتها

قيمة الإرجاع	النوع	‏‏الوصف
<updated-object>	‏‏الكائن	عنصر JSON المحدث بدون الخاصية المحددة

لإزالة خاصية تابعة من خاصية موجودة، استخدم بناء الجملة الموضح أدناه:

removeProperty(<object>['<parent-property>'], '<child-property>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON الذي تريد إزالة الخاصية منه
<الخاصية الأصل>	‏‏نعم‬	السلسلة‬	اسم الخاصية الأصل مع الخاصية التابعة التي تريد إزالتها
<خاصية تابعة>	‏‏نعم‬	السلسلة‬	اسم الخاصية التابعة المراد إزالتها

قيمة الإرجاع	النوع	‏‏الوصف
<updated-object>	‏‏الكائن	عنصر JSON المحدث الذي أزلت خاصيته التابعة

مثال 1

يزيل هذا المثال الخاصية middleName من عنصر JSON، الذي يتحول من سلسلة إلى JSON باستخدام الدالة JSON()، ويعيد العنصر المحدث:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

إليك عنصر JSON الحالي:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

إليك عنصر JSON المحدث:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

مثال 2

يزيل هذا المثال الخاصية التابعة middleName من العنصر الأصل customerName في JSON، الذي يتحول من سلسلة إلى JSON باستخدام الدالة JSON()، ويعيد العنصر المحدث:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

إليك عنصر JSON الحالي:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

إليك عنصر JSON المحدث:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

استبدل

استبدال سلسلة فرعية مع السلسلة المحددة، وإرجاع سلسلة النتائج. هذه الدالة حساسة لحالة الأحرف.

replace('<text>', '<oldText>', '<newText>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تحتوي على السلسلة الفرعية المراد استبدالها
<oldText>	‏‏نعم‬	السلسلة‬	السلسلة الفرعية المراد استبدالها
<newText>	‏‏نعم‬	السلسلة‬	سلسلة الاستبدال

قيمة الإرجاع	النوع	‏‏الوصف
<updated-text>	السلسلة‬	السلسلة المحدثة بعد استبدال السلسلة الفرعية في حالة عدم العثور على السلسلة الفرعية، فأعد السلسلة الأصلية.

مثال

يبحث هذا المثال عن السلسلة الفرعية "القديمة" في "السلسلة القديمة" ويستبدل "القديم" بـ "الجديد":

replace('the old string', 'old', 'new')

وإرجاع هذه النتيجة: "the new string"

النتيجة

أعد النتائج من إجراءات المستوى الأعلى في الإجراء ضمن النطاق المحدد، مثل الإجراء For_each، أو Until، أو Scope. تقبل الدالة result() معلمة واحدة، وهي اسم النطاق، وترجع صفيفًا يحتوي على معلومات من إجراءات المستوى الأول في هذا النطاق. تتضمن عناصر الإجراء هذه نفس سمات السمات التي ترجع بواسطة الدالة actions()، مثل وقت بدء الإجراء ووقت الانتهاء والحالة والإدخالات ومعرفات الارتباط والإخراجات.

إشعار

ترجع هذه الدالة المعلومات فقط من إجراءات المستوى الأول في الإجراء ضمن النطاق المحدد وليس من إجراءات متداخلة أعمق مثل إجراءات التبديل أو الشرط.

على سبيل المثال، يمكنك استخدام هذه الدالة للحصول على نتائج من الإجراءات الفاشلة بحيث يمكنك تشخيص الاستثناءات والتعامل معها. للمزيد من المعلومات، يرجى مراجعة الحصول على السياق والنتائج المتعلقة بالفشل.

result('<scopedActionName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<scopedActionName>	‏‏نعم‬	السلسلة‬	اسم الإجراء ضمن النطاق حيث تريد الإدخالات والإخراجات من إجراءات المستوى الأعلى داخل هذا النطاق

قيمة الإرجاع	النوع	‏‏الوصف
<array-object>	عنصر الصفيف	صفيف يشتمل على صفائف من الإدخالات والإخراجات من كل إجراء من المستوى الأعلى داخل النطاق المحدد

مثال

يرجع هذا المثال الإدخالات والإخراجات من كل تكرار لإجراء HTTP داخل تكرار For_each باستخدام الدالة result() في الإجراء Compose:

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

فيما يلي كيفية ظهور الصفيف الذي تم إرجاعه في المثال حيث يحتوي العنصر الخارجي outputs على الإدخالات والإخراجات من كل تكرار للإجراءات داخل الإجراء For_each.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

reverse

عكس ترتيب العناصر في مجموعة. عند استخدام هذه الدالة مع sort()، يمكنك فرز مجموعة بترتيب تنازلي.

reverse([<collection>])

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	صفيف	المجموعة التي يجب عكسها

قيمة الإرجاع	النوع	‏‏الوصف
[<مجموعة محدثة>]	صفيف	المجموعة المعكوسة

مثال

يعكس هذا المثال صفيفا من الأعداد الصحيحة:

reverse(createArray(0, 1, 2, 3))

وإرجاع هذا الصفيف: [3,2,1,0]

S

setProperty

عين قيمة لخاصية عنصر JSON وأرجع العنصر المحدث. في حالة عدم وجود الخاصية التي تحاول تعيينها، تضاف الخاصية إلى العنصر. لإضافة خاصية جديدة، استخدم الدالة addProperty().

setProperty(<object>, '<property>', <value>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON الذي تريد تعيين خاصيته
<خاصية>	‏‏نعم‬	السلسلة‬	اسم الخاصية الحالية أو الجديدة المطلوب تعيينها
<قيمة>	‏‏نعم‬	أي	القيمة المراد تعيينها للخاصية المحددة

لتعيين الخاصية التابعة في عنصر تابع، استخدم استدعاء متداخل setProperty() بدلاً من ذلك. خلاف ذلك، ترجع الدالة العنصر التابع فقط كإخراج.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

المعلمة‬	المطلوب	نوع	‏‏الوصف
<object>	‏‏نعم‬	‏‏الكائن	عنصر JSON الذي تريد تعيين خاصيته
<الخاصية الأصل>	‏‏نعم‬	السلسلة‬	اسم الخاصية الأصل مع الخاصية التابعة التي تريد تعيينها
<خاصية تابعة>	‏‏نعم‬	السلسلة‬	اسم الخاصية التابعة المطلوب تعيينها
<قيمة>	‏‏نعم‬	أي	القيمة المراد تعيينها للخاصية المحددة

قيمة الإرجاع	النوع	‏‏الوصف
<updated-object>	‏‏الكائن	عنصر JSON المحدث الذي تحدد خاصيته

مثال 1

يعين هذا المثال الخاصية surName إلى عنصر JSON، والذي يحول من سلسلة إلى JSON باستخدام الدالة JSON(). تعين الدالة القيمة المحددة للخاصية وترجع العنصر المحدث:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

إليك عنصر JSON الحالي:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

إليك عنصر JSON المحدث:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

مثال 2

يعيّن هذا المثال الخاصية التابعة surName للخاصية الأصل customerName في عنصر JSON، والتي يتم تحويلها من سلسلة إلى JSON باستخدام الدالة JSON(). تعين الدالة القيمة المحددة للخاصية وترجع العنصر المحدث:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

إليك عنصر JSON الحالي:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

إليك عنصر JSON المحدث:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

skip

إزالة العناصر من مقدمة المجموعة، وإعادة جميع العناصر الأخرى.

skip([<collection>], <count>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	صفيف	المجموعة التي تريد إزالة عناصرها
<count>	‏‏نعم‬	Integer	عدد صحيح موجب لعدد العناصر المطلوب إزالتها في المقدمة

قيمة الإرجاع	النوع	‏‏الوصف
[<مجموعة محدثة>]	صفيف	المجموعة المحدثة بعد إزالة العناصر المحددة

مثال

يزيل هذا المثال عنصراً واحداً، وهو الرقم 0، من مقدمة الصفيف المحدد:

skip(createArray(0, 1, 2, 3), 1)

وإرجاع هذه الصفيفة مع العناصر المتبقية: [1,2,3]

شريحة

أرجع سلسلة فرعية بتحديد موضع أو قيمة البداية والنهاية. راجع substring() أيضًا.

slice('<text>', <startIndex>, <endIndex>?)

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تشتمل على السلسلة الفرعية للبحث عنها
<startIndex>	‏‏نعم‬	Integer	موضع البداية أو القيمة المستندة إلى الصفر لمكان بدء البحث عن السلسلة الفرعية - إذا كان startIndex أكبر من طول السلسلة، فسترجع سلسلة فارغة. - إذا كان startIndex سالبًا، فابدأ البحث في قيمة الفهرس التي هي مجموع طول السلسلة وstartIndex.
<endIndex>	لا	Integer	موضع النهاية الصفري أو القيمة الخاصة بمكان إنهاء البحث عن السلسلة الفرعية. لا يضمن الحرف الموجود في قيمة فهرس النهاية في البحث. - في حالة عدم تحديد endIndex أو كان أكبر من طول السلسلة، فابحث حتى نهاية السلسلة. - إذا كانendIndex سالبًا، فقم بإنهاء البحث عند قيمة الفهرس التي هي مجموع طول السلسلة وendIndex.

قيمة الإرجاع	النوع	‏‏الوصف
<slice-result>	السلسلة‬	سلسلة جديدة تحتوي على السلسلة الفرعية التي عثر عليها

الأمثلة

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sort

فرز العناصر في مجموعة. يمكنك فرز عناصر المجموعة باستخدام أي مفتاح يحتوي على نوع بسيط.

sort([<collection>], <sortBy>?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	صفيف	المجموعة التي تحتوي على العناصر المراد فرزها
<فرز حسب>	لا	السلسلة‬	المفتاح الذي يجب استخدامه لفرز عناصر المجموعة

قيمة الإرجاع	النوع	‏‏الوصف
[<مجموعة محدثة>]	صفيف	المجموعة التي تم فرزها

مثال 1

يفرز هذا المثال صفيفا من الأعداد الصحيحة:

sort(createArray(2, 1, 0, 3))

وإرجاع هذا الصفيف: [0,1,2,3]

مثال 2

يفرز هذا المثال صفيفا من العناصر حسب المفتاح:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

وإرجاع هذا الصفيف: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

split

إرجاع صفيف يحتوي على سلاسل فرعية مفصولة بفواصل استناداً إلى حرف المحدد المعين في السلسلة الأصلية.

split('<text>', '<delimiter>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة المراد فصلها إلى سلاسل فرعية بناءً على المحدد المعين في السلسلة الأصلية
<المحدِّد>	‏‏نعم‬	السلسلة‬	الحرف الموجود في السلسلة الأصلية المراد استخدامه كمحدد

قيمة الإرجاع	النوع	‏‏الوصف
[<سلسة فرعية1>،<سلسة فرعية2>،...]	صفيف	مصفوفة تحتوي على سلاسل فرعية من السلسلة الأصلية المفصولة بفواصل

مثال 1

ينشئ هذا المثال صفيفاً يحتوي على سلاسل فرعية من السلسلة المحددة بناءً على الحرف المعين كمحدد:

split('a_b_c', '_')

وإرجاع هذا الصفيف كنتيجة: ["a","b","c"]

مثال 2

ينشئ هذا المثال صفيفًا بعنصر واحد في حالة عدم وجود محدد في السلسلة:

split('a_b_c', ' ')

وإرجاع هذا الصفيف كنتيجة: ["a_b_c"]

startOfDay

إرجاع بداية اليوم للحصول على طابع زمني.

startOfDay('<timestamp>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني المحدد ولكن يبدأ عند علامة ساعة الصفر لليوم

مثال

يبحث هذا المثال عن بداية اليوم لهذا الطابع الزمني:

startOfDay('2018-03-15T13:30:30Z')

وإرجاع هذه النتيجة: "2018-03-15T00:00:00.0000000Z"

startOfHour

إرجاع بداية الساعة للحصول على طابع زمني.

startOfHour('<timestamp>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني المحدد ولكن يبدأ عند علامة دقيقة الصفر للساعة

مثال

يبحث هذا المثال عن بداية الساعة لهذا الطابع الزمني:

startOfHour('2018-03-15T13:30:30Z')

وإرجاع هذه النتيجة: "2018-03-15T13:00:00.0000000Z"

startOfMonth

إرجاع بداية الشهر للحصول على طابع زمني.

startOfMonth('<timestamp>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني المحدد ولكن يبدأ في اليوم الأول من الشهر عند علامة ساعة الصفر

مثال 1

يعرض هذا المثال بداية الشهر لهذا الطابع الزمني:

startOfMonth('2018-03-15T13:30:30Z')

وإرجاع هذه النتيجة: "2018-03-01T00:00:00.0000000Z"

مثال 2

هذا المثال يرجع بداية الشهر بالتنسيق المحدد لهذا الطابع الزمني:

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

وإرجاع هذه النتيجة: "2018-03-01"

startsWith

تحقق مما إذا كانت سلسلة تبدأ بسلسلة فرعية معينة. يتم إرجاع القيمة true عند العثور على سلسلة فرعية أو إرجاع القيمة false عند عدم العثور عليها. هذه الدالة ليست حساسة لحالة الأحرف.

startsWith('<text>', '<searchText>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي يجب التحقق منها
<searchText>	‏‏نعم‬	السلسلة‬	سلسلة البداية التي سيتم البحث عنها

قيمة الإرجاع	النوع	‏‏الوصف
صواب أو خطأ	Boolean	إرجاع القيمة true عند العثور على بداية السلسلة الفرعية. إرجاع القيمة false عند عدم العثور عليه.

مثال 1

يتحقق هذا المثال ما إذا كانت السلسلة "hello world" تبدأ بالسلسلة الفرعية "hello":

startsWith('hello world', 'hello')

وإرجاع هذه النتيجة: true

مثال 2

يتحقق هذا المثال ما إذا كانت السلسلة "hello world" تبدأ بالسلسلة الفرعية "greetings":

startsWith('hello world', 'greetings')

وإرجاع هذه النتيجة: false

سلسلة

إرجاع إصدار السلسلة لقيمة.

string(<value>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	أي	القيمة المطلوب تحويلها. إذا كانت هذه القيمة خالية أو يتم تقييمها إلى قيمة خالية، تحول القيمة إلى قيمة سلسلة فارغة (`""`). على سبيل المثال، في حالة تعيين متغير سلسلة إلى خاصية غير موجودة، والتي يمكنك الوصول إليها مع عامل التشغيل `?`، تحول القيمة الفارغة إلى سلسلة فارغة. ومع ذلك، فإن المقارنة بين القيمة الفارغة ليست هي نفسها مقارنة سلسلة فارغة.

قيمة الإرجاع	النوع	‏‏الوصف
<string-value>	السلسلة‬	إصدار سلسلة للقيمة المحددة. إذا كانت معلمة القيمة خالية أو يتم تقييمها إلى قيمة خالية، ترجع هذه القيمة كقيمة سلسلة فارغة (`""`).

مثال 1

ينشئ هذا المثال إصدار السلسلة لهذا الرقم:

string(10)

وإرجاع هذه النتيجة: "10"

مثال 2

ينشئ هذا المثال سلسلة لعنصر JSON المحدد ويستخدم حرف الخط المائل العكسي (\) كحرف إلغاء لعلامة الاقتباس المزدوجة (").

string( { "name": "Sophie Owen" } )

وإرجاع هذه النتيجة: "{ \\"name\\": \\"Sophie Owen\\" }"

فرعي

إرجاع الناتج من طرح الرقم الثاني من الرقم الأول.

sub(<minuend>, <subtrahend>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<المطروح منه>	‏‏نعم‬	عدد صحيح أو عائم	الرقم المطلوب طرحه من العدد المطروح
<المطروح>	‏‏نعم‬	عدد صحيح أو عائم	الرقم المطلوب طرحه من العدد المطروح منه

قيمة الإرجاع	النوع	‏‏الوصف
<نتيجة>	عدد صحيح أو عائم	ناتج طرح الرقم الثاني من الرقم الأول

مثال

يطرح هذا المثال الرقم الثاني من الرقم الأول:

sub(10.3, .3)

وإرجاع هذه النتيجة: 10

السلسة الفرعية

إرجاع أحرف من سلسلة، بدءاً من الموضع المحدد أو الفهرس. تبدأ قيم الفهرس بالرقم 0. يرجى مراجعة slice() أيضًا.

substring('<text>', <startIndex>, <length>)

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تريد أحرفها
<startIndex>	‏‏نعم‬	Integer	رقم موجب يساوي أو أكبر من 0 الذي تريد استخدامه كموضع بداية أو قيمة فهرس
<الطول>	لا	Integer	عدد موجب من الأحرف التي تريدها في السلسلة الفرعية

إشعار

تأكد من أن المجموع من إضافة قيم المعلمة startIndex وlength أقل من طول السلسلة التي توفرها للمعلمة text. خلاف ذلك، تحصل على خطأ، على عكس الدالات المماثلة في اللغات الأخرى حيث تكون النتيجة السلسلة الفرعية من startIndexإلى نهاية السلسلة. تُعد معلمة length اختيارية وفي حالة عدم توفيرها، تأخذ دالة substring() جميع الأحرف بدءًا من startIndex إلى نهاية السلسلة.

قيمة الإرجاع	النوع	‏‏الوصف
<substring-result>	السلسلة‬	سلسلة فرعية ذات عدد محدد من الأحرف، تبدأ من موضع الفهرس المحدد في سلسلة المصدر

مثال

ينشئ هذا المثال سلسلة فرعية من خمسة أحرف من السلسلة المحددة، بدءاً من قيمة الفهرس 6:

substring('hello world', 6, 5)

وإرجاع هذه النتيجة: "world"

subtractFromTime

طرح عدد من وحدات الوقت من الطابع الزمني. انظر كذلك getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على الطابع الزمني
<الفاصل الزمني>	‏‏نعم‬	Integer	عدد الوحدات الزمنية المحددة المطلوب طرحها
<timeUnit>	‏‏نعم‬	السلسلة‬	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<الطابع الزمني المحدث>	السلسلة‬	الطابع الزمني مطروحاً منه العدد المحدد للوحدات الزمنية

مثال 1

يطرح هذا المثال يوماً واحداً من هذا الطابع الزمني:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

وإرجاع هذه النتيجة: "2018-01-01T00:00:00.0000000Z"

مثال 2

يطرح هذا المثال يوماً واحداً من هذا الطابع الزمني:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

وإرجاع هذه النتيجة باستخدام تنسيق "D" الاختياري: "Monday, January, 1, 2018"

T

الوقت المستغرق

إرجاع العناصر من مقدمة المجموعة.

take('<collection>', <count>)
take([<collection>], <count>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة>	‏‏نعم‬	سلسلة أو صفيف	المجموعة التي تريد عناصرها
<count>	‏‏نعم‬	Integer	عدد صحيح موجب لعدد العناصر التي تريدها من المقدمة

قيمة الإرجاع	النوع	‏‏الوصف
<مجموعة فرعية> أو [<مجموعة فرعية>]	سلسلة أو صفيف، على التوالي	سلسلة أو صفيف يحتوي على عدد محدد من العناصر المأخوذة من مقدمة المجموعة الأصلية

مثال

تحصل هذه الأمثلة على عدد محدد من العناصر من مقدمة هذه المجموعات:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

وإرجاع هذه النتائج:

المثال الأول: "abc"
المثال الثاني: [0, 1, 2]

علامات تجزئة

ترجع عدد علامات التجزئة، والتي تعد فواصل زمنية مقدارها 100 نانوثانية، منذ 1 يناير 0001 12:00:00 منتصف الليل (أو DateTime.Ticks في C#) حتى الطابع الزمني المحدد. للمزيد من المعلومات، راجع هذا الموضوع: خاصية DateTime.Ticks (النظام).

ticks('<timestamp>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<الطابع الزمني>	‏‏نعم‬	السلسلة‬	السلسلة لطابع زمني

قيمة الإرجاع	النوع	‏‏الوصف
<ticks-number>	Integer	عدد علامات التجزئة منذ الطابع الزمني المحدد

للأسفل

إرجاع سلسلة بتنسيق أحرف صغيرة. إذا كان أحد الأحرف في السلسلة لا يحتوي على نسخة ذي أحرف صغيرة، فإن هذا الحرف يبقى دون تغيير في السلسلة التي تم إرجاعها.

toLower('<text>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة المراد إرجاعها بتنسيق الأحرف الصغيرة

قيمة الإرجاع	النوع	‏‏الوصف
<lowercase-text>	السلسلة‬	السلسلة الأصلية بتنسيق الأحرف الصغيرة

مثال

يحول هذا المثال هذه السلسلة إلى أحرف صغيرة:

toLower('Hello World')

وإرجاع هذه النتيجة: "hello world"

toUpper

إرجاع سلسلة بتنسيق أحرف كبيرة. إذا كان أحد الأحرف في السلسلة لا يحتوي على نسخة ذي أحرف كبيرة، فإن هذا الحرف يبقى دون تغيير في السلسلة التي تم إرجاعها.

toUpper('<text>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة المراد إرجاعها بتنسيق الأحرف الكبيرة

قيمة الإرجاع	النوع	‏‏الوصف
<uppercase-text>	السلسلة‬	السلسلة الأصلية بتنسيق الأحرف الكبيرة

مثال

يحول هذا المثال هذه السلسلة إلى أحرف كبيرة:

toUpper('Hello World')

وإرجاع هذه النتيجة: "HELLO WORLD"

المشغل

أرجع إخراج المشغل في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى، والتي يمكنك تعيينها إلى تعبير.

داخل إدخالات المشغل، تعيد هذه الدالة الإخراج من التنفيذ السابق.
داخل حالة المشغل، ترجع هذه الدالة الإخراج من التنفيذ الحالي.

بشكل افتراضي، تشير الدالة إلى عنصر المشغل بأكمله، ولكن يمكنك تحديد الخاصية التي تريد قيمتها. تحتوي هذه الدالة أيضًا على إصدارات مختصرة متوفرة، راجع triggerOutputs() وtriggerBody().

trigger()

قيمة الإرجاع	النوع	‏‏الوصف
<إخراج المشغل>	السلسلة‬	الإخراج من المشغل في وقت التشغيل

triggerBody

أعد إخراج المشغل body في وقت التشغيل. اختصار لـ trigger().outputs.body. راجع trigger().

triggerBody()

قيمة الإرجاع	النوع	‏‏الوصف
<trigger-body-output>	السلسلة‬	الإخراج `body` من المشغل

triggerFormDataMultiValues

أرجع صفيفًا مع قيم تطابق اسم مفتاح في إخراج بيانات النموذج أو ترميز النموذج الخاص بالمشغل.

triggerFormDataMultiValues('<key>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مفتاح>	‏‏نعم‬	السلسلة‬	اسم المفتاح الذي ترغب في قيمته

قيمة الإرجاع	النوع	‏‏الوصف
[<array-with-key-values>]	صفيف	صفيف بكل القيم التي تطابق المفتاح المحدد

مثال

ينشئ هذا المثال صفيفًا من قيمة المفتاح «feedUrl» في إخراج بيانات النموذج أو ترميز النموذج لمشغل RSS:

triggerFormDataMultiValues('feedUrl')

ويرجع هذا الصفيف كمثال للنتيجة: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

أعد سلسلة مع قيمة واحدة تطابق اسم مفتاح في إخراج بيانات النموذج أو ترميز النموذج الخاص بالمشغل. إذا عثرت الدالة على أكثر من تطابق، فستتسبب هذه الدالة في حدوث خطأ.

triggerFormDataValue('<key>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مفتاح>	‏‏نعم‬	السلسلة‬	اسم المفتاح الذي ترغب في قيمته

قيمة الإرجاع	النوع	‏‏الوصف
<قيمة-المفتاح>	السلسلة‬	القيمة الموجودة في مفتاح محدد

مثال

ينشئ هذا المثال سلسلة من قيمة المفتاح «feedUrl» في إخراج بيانات النموذج أو ترميز النموذج لمشغل RSS:

triggerFormDataValue('feedUrl')

وترجع هذه السلسلة كمثال للنتيجة: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

أعد النص الأساسي لجزء معين في إخراج المشغل يتكون من أجزاء متعددة.

triggerMultipartBody(<index>)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<فهرس>	‏‏نعم‬	Integer	قيمة الفهرس للجزء الذي تريده

قيمة الإرجاع	النوع	‏‏الوصف
<النص الأساسي>	السلسلة‬	النص الأساسي الخاص بالجزء المحدد في إخراج المشغل متعدد الأجزاء

triggerOutputs

أعد إخراج المشغل في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى. اختصار لـ trigger().outputs. راجع trigger().

triggerOutputs()

قيمة الإرجاع	النوع	‏‏الوصف
<إخراج المشغل>	السلسلة‬	الإخراج من المشغل في وقت التشغيل

trim

إزالة المسافة البيضاء البادئة والزائدة من سلسلة، ثم إرجاع السلسلة المحدثة.

trim('<text>')

المعلمة‬	المطلوب	نوع	الوصف
<text>	نعم	السلسلة‬	السلسلة التي تحتوي على المسافات البيضاء البادئة واللاحقة للإزالة

قيمة الإرجاع	النوع	‏‏الوصف
<updatedText>	السلسلة‬	إصدار محدث للسلسلة الأصلية دون مسافات بيضاء بادئة أو لاحقة

مثال

يزيل هذا المثال المسافة البيضاء البادئة واللاحقة من السلسلة «مرحبًا بالعالم»:

trim(' Hello World  ')

وإرجاع هذه النتيجة: "Hello World"

U

union

إرجاع مجموعة تحتوي على جميع العناصر من المجموعات المحددة. للظهور في النتيجة، يمكن أن يظهر عنصر في أي مجموعة تم تمريرها إلى هذه الدالة. إذا كان عنصر واحد أو أكثر يحمل نفس الاسم، يظهر العنصر الأخير بهذا الاسم في النتيجة.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

المعلمة‬	المطلوب	نوع	‏‏الوصف
<مجموعة1>، <مجموعة2>، ...	‏‏نعم‬	صفيف أو كائن، ولكن ليس كليهما	المجموعات من حيث تريد جميع العناصر

قيمة الإرجاع	النوع	‏‏الوصف
<updatedCollection>	صفيف أو كائن، على التوالي	مجموعة تحتوي على جميع العناصر من المجموعات المحددة - دون تكرارات

مثال

يحصل هذا المثال على جميع العناصر من هذه المجموعات:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

وإرجاع هذه النتيجة: [1, 2, 3, 10, 101]

uriComponent

قم بإرجاع إصدار مرمز باستخدام معرّف الموارد المنتظم (URI) لسلسلة من خلال استبدال أحرف URL غير الآمنة بأحرف الإلغاء. استخدم هذه الدالة بدلاً من encodeUriComponent(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام uriComponent().

uriComponent('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المطلوب تحويلها إلى تنسيق مرمز بـ URI

قيمة الإرجاع	النوع	‏‏الوصف
<encoded-uri>	السلسلة‬	السلسلة المرمزة باستخدام URI مع أحرف الإلغاء

مثال

ينشئ هذا المثال إصدار مرمز باستخدام URI لهذه السلسلة:

uriComponent('https://contoso.com')

وإرجاع هذه النتيجة: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

إرجاع الإصدار الثنائي لمكون معرف موارد منتظم (URI).

uriComponentToBinary('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المرمزة باستخدام URI المراد تحويلها

قيمة الإرجاع	النوع	‏‏الوصف
<binary-for-encoded-uri>	السلسلة‬	الإصدار الثنائي للسلسلة المرمزة باستخدام URI. المحتوى الثنائي هو base64-encoded وrepresented بواسطة `$content`.

مثال

ينشئ هذا المثال إصدار ثنائي لهذه السلسلة المرمزة باستخدام URI:

uriComponentToBinary('https%3A%2F%2Fcontoso.com')

وإرجاع هذه النتيجة:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

إرجاع إصدار السلسلة لسلسلة مرمزة باستخدام معرف الموارد المنتظم (URI)، وفك ترميز السلسلة المرمزة باستخدام URI بشكلٍ فعال.

uriComponentToString('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة المرمزة باستخدام URI المراد فك ترميزها

قيمة الإرجاع	النوع	‏‏الوصف
<decoded-uri>	السلسلة‬	الإصدار الذي تم فك ترميزه لسلسلة فك ترميزها باستخدام URI

مثال

ينشئ هذا المثال إصدار سلسلة فك ترميزها للسلسلة التي تم فك ترميزها باستخدام URI:

uriComponentToString('https%3A%2F%2Fcontoso.com')

وإرجاع هذه النتيجة: "https://contoso.com"

uriHost

أعد قيمة host لمعرف الموارد المنتظم (URI).

uriHost('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيمة `host` له

قيمة الإرجاع	النوع	‏‏الوصف
<قيمة المضيف>	السلسلة‬	قيمة `host` لـ URI المحدد

مثال

يبحث هذا المثال عن قيمة host لـ URI هذا:

uriHost('https://www.localhost.com:8080')

وإرجاع هذه النتيجة: "www.localhost.com"

uriPath

أعد قيمة path لمعرف الموارد المنتظم (URI).

uriPath('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيمة `path` له

قيمة الإرجاع	النوع	‏‏الوصف
<path-value>	السلسلة‬	قيمة `path` لـ URI المحدد. إذا `path` لم يكن لديه قيمة، فأرجع الحرف «/».

مثال

يبحث هذا المثال عن قيمة path لـ URI هذا:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

وإرجاع هذه النتيجة: "/catalog/shownew.htm"

uriPathAndQuery

أعد قيم path وquery لمعرف الموارد المنتظم (URI).

uriPathAndQuery('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيم `path` و`query` له

قيمة الإرجاع	النوع	‏‏الوصف
<path-query-value>	السلسلة‬	قيم `path`و `query` لـ URI المحدد. إذا `path` لم يحدد قيمة، فأرجع الحرف «/».

مثال

يبحث هذا المثال عن قيم path وquery لـ URI هذا:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

وإرجاع هذه النتيجة: "/catalog/shownew.htm?date=today"

uriPort

أعد قيمة port لمعرف الموارد المنتظم (URI).

uriPort('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيمة `port` له

قيمة الإرجاع	النوع	‏‏الوصف
<port-value>	Integer	قيمة `port` لـ URI المحدد. إذا `port` لم يحدد قيمة، فأرجع المنفذ الافتراضي للبروتوكول.

مثال

يرجع هذا المثال قيمة port لـ URI هذا:

uriPort('https://www.localhost:8080')

وإرجاع هذه النتيجة: 8080

uriQuery

أعد قيمة query لمعرف الموارد المنتظم (URI).

uriQuery('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيمة `query` له

قيمة الإرجاع	النوع	‏‏الوصف
<query-value>	السلسلة‬	قيمة `query` لـ URI المحدد

مثال

يرجع هذا المثال قيمة query لـ URI هذا:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

وإرجاع هذه النتيجة: "?date=today"

uriScheme

أعد قيمة scheme لمعرف الموارد المنتظم (URI).

uriScheme('<uri>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<uri>	‏‏نعم‬	السلسلة‬	URI الذي تريد قيمة `scheme` له

قيمة الإرجاع	النوع	‏‏الوصف
<scheme-value>	السلسلة‬	قيمة `scheme` لـ URI المحدد

مثال

يرجع هذا المثال قيمة scheme لـ URI هذا:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

وإرجاع هذه النتيجة: "http"

utcNow

إرجاع الطابع الزمني الحالي.

utcNow('<format>')

اختياريًا، يمكنك تحديد تنسيق مختلف باستخدام المعلمة <format>.

المعلمة‬	المطلوب	نوع	‏‏الوصف
<format>	لا	السلسلة‬	سلسلة تنسيق رقمية إما محدد تنسيق واحد أو نمط تنسيق مخصص. يُعد التنسيق الافتراضي للطابع الزمني هو «o» (yyyy-MM-ddTHH:mm:ss.fffffffK)، والذي يتوافق مع ISO 8601 ويحافظ على معلومات المنطقة الزمنية. في حالة لم يكن التنسيق قيمة صالحة، فسيتم إنشاء خطأ.

قيمة الإرجاع	النوع	‏‏الوصف
<current-timestamp>	السلسلة‬	التاريخ والوقت الحاليان

مثال 1

لنفترض أن اليوم هو 15 أبريل 2018 الساعة 1:00 مساءً. يحصل هذا المثال الطابع الزمني الحالي:

utcNow()

وإرجاع هذه النتيجة: "2018-04-15T13:00:00.0000000Z"

مثال 2

لنفترض أن اليوم هو 15 أبريل 2018 الساعة 1:00 مساءً. يحصل هذا المثال الطابع الزمني الحالي باستخدام تنسيق "D" الاختياري:

utcNow('D')

وإرجاع هذه النتيجة: "Sunday, April 15, 2018"

V

من المتغيرات

أعد قيمة متغير محدد.

variables('<variableName>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<variableName>	‏‏نعم‬	السلسلة‬	اسم المتغير الذي تريد قيمته

قيمة الإرجاع	النوع	‏‏الوصف
<variable-value>	أي	قيمة المتغير المحدد

مثال

بافتراض أن القيمة الحالية لمتغير «numItems» هي 20. يتناول هذا المثال قيمة العدد الصحيح لهذا المتغير:

variables('numItems')

وإرجاع هذه النتيجة: 20

W

سير العمل

أعد جميع التفاصيل حول سير العمل نفسه أثناء وقت التشغيل.

workflow().<property>

المعلمة‬	المطلوب	نوع	‏‏الوصف
<خاصية>	لا	السلسلة‬	اسم خاصية سير العمل التي تريد قيمتها بشكل افتراضي، يحتوي عنصر سير العمل على هذه الخصائص: `name`، و`type`، و`id`، و`location`، و`run`،و`tags`. - قيمة الخاصية `run` هي عنصر JSON يتضمن هذه الخصائص: `name`، و`type`، و`id`. - الخاصية `tags` عبارة عن عنصر JSON يتضمن علامات مرتبطة بتطبيق المنطق الخاص بك في Azure Logic Apps أو التدفق في Power Automate وقيم هذه العلامات. للمزيد من المعلومات حول العلامات في موارد Azure، راجع موارد العلامات ومجموعات الموارد والاشتراكات للمؤسسة المنطقية في Azure. ملاحظة: بشكل افتراضي، لا يحتوي تطبيق المنطق على علامات، ولكن تدفق Power Automate يحتوي على علامات `flowDisplayName`، و`environmentName`.

مثال 1

يُرجع هذا المثال اسم التشغيل الحالي لسير العمل:

workflow().run.name

مثال 2

في حالة استخدامك Power Automate، يمكنك إنشاء تعبير @workflow() يستخدم خاصية الإخراج tags للحصول على القيم من الخاصية flowDisplayName أو environmentName للتدفق الخاص بك.

على سبيل المثال، بإمكانك إرسال إشعارات بريد إلكتروني مخصصة من التدفق نفسه ترتبط مرة أخرى بالتدفق الخاص بك. يمكن أن تتضمن هذه الإشعارات ارتباط HTML يحتوي على اسم عرض التدفق في عنوان البريد الإلكتروني ويتبع هذه الصيغة:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

س

xml

إرجاع إصدار XML لسلسلة تحتوي على كائن JSON.

xml('<value>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<قيمة>	‏‏نعم‬	السلسلة‬	السلسلة التي تحتوي على كائن JSON لتحويلها يجب أن يحتوي كائن JSON على خاصية جذر واحدة فقط، والتي لا يمكن أن تكون صفيف. استخدم حرف الخط المائل العكسي (\) كحرف إلغاء لعلامة الاقتباس المزدوجة (").

قيمة الإرجاع	النوع	‏‏الوصف
<xml-version>	‏‏الكائن	إصدار XML المرمز لسلسلة أو كائن JSON محدد

مثال 1

يُحول هذا المثال السلسلة إلى XML:

xml('<name>Sophia Owen</name>')

وإرجاع هذه النتيجة XML:

<name>Sophia Owen</name>

مثال 2

ينشئ هذا المثال إصدار XML لهذه السلسلة التي تحتوي على كائن JSON:

xml(json('{ "name": "Sophia Owen" }'))

وإرجاع هذه النتيجة XML:

<name>Sophia Owen</name>

مثال 3

لمفترض أن لديك كائن JSON هذا:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

ينشئ هذا المثال XML لسلسلة تحتوي على كائن JSON هذا:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

وإرجاع هذه النتيجة XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

التحقق من XML للعقد أو القيم التي تطابق تعبير XPath (لغة مسار XML)، ثم إرجاع العقد أو القيم المتطابقة. يساعدك تعبير XPath أو "XPath" فقط، على التنقل في بنية مستند XML بحيث يمكنك تحديد العقد أو حساب القيم في محتوى XML.

إشعار

في تطبيقات المنطق Consumption وStandard، تستخدم جميع تعبيرات الوظائف مكتبة .NET XPath. تتوافق تعبيرات XPath مع مكتبة .NET الأساسية وتدعم التعبير الذي تدعمه مكتبة .NET الأساسية فقط.

xpath('<xml>', '<xpath>')

المعلمة‬	المطلوب	نوع	‏‏الوصف
<xml>	‏‏نعم‬	أي	سلسلة XML للبحث عن العقد أو القيم التي تطابق قيمة تعبير XPath
<xpath>	‏‏نعم‬	أي	يستخدم تعبير XPath للبحث عن قيم أو عقد XML متطابقة

قيمة الإرجاع	النوع	‏‏الوصف
<xml-node>	XML	عقدة XML عندما تتطابق عقدة واحدة فقط مع تعبير XPath المحدد
<قيمة>	أي	القيمة من عقدة XML عندما تتطابق قيمة واحدة فقط مع تعبير XPath المحدد
[<xml-عقدة1>، <xml-عقدة2>، ...] -أو- [<قيمة1>، <قيمة2>، ...]	صفيف	صفيف يحتوي على عقد XML أو قيم تطابق تعبير XPath المحدد

مثال 1

بافتراض أن لديك سلسلة XML 'items' هذه:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

يمر هذا المثال في تعبير XPath، '/produce/item/name/text()'، للعثور على العقد التي تطابق العقدة <name></name>في سلسلة XML 'items' ويرجع صفيفًا بقيم العقدة هذه:

xpath(xml(parameters('items')), '/produce/item/name/text()')

يستخدم المثال أيضًا الدالة parameters() للحصول على سلسلة XML من 'items' وتحويل السلسلة إلى تنسيق XML باستخدام الدالة xml().

فيما يلي صفيف النتائج المملوء بقيم العقد التي تطابق <name></name>:

[ Gala, Honeycrisp ]

مثال 2

بعد المثال 1، يمر هذا المثال في تعبير XPath، '/produce/item/name[1]'، للعثور على العنصر الأول name التابع للعنصر item.

xpath(xml(parameters('items')), '/produce/item/name[1]')

إليك النتيجة:Gala

مثال 3

بعد المثال 1، يمر هذا المثال في تعبير XPath، '/produce/item/name[last()]'، للعثور على العنصر الأخير name التابع للعنصر item.

xpath(xml(parameters('items')), '/produce/item/name[last()]')

إليك النتيجة:Honeycrisp

مثال 4

في هذا المثال، افترض أن سلسلة XML items تحتوي أيضًا على السمات expired='true' وexpired='false':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

يمر هذا المثال في تعبير XPath، '//name[@expired]'، للعثور على كافة عناصر name التي تحتوي على السمة expired:

xpath(xml(parameters('items')), '//name[@expired]')

إليك النتيجة:[ Gala, Honeycrisp ]

مثال 5

في هذا المثال، افترض أن سلسلة XML items تتضمن هذه السمة فقط، expired = 'true':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

يمر هذا المثال في تعبير XPath، '//name[@expired = 'true']'، للعثور على كافة عناصر name التي تحتوي على السمة expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

إليك النتيجة:[ Gala ]

مثال 6

في هذا المثال، افترض أن سلسلة XML items تحتوي أيضًا على هذه السمات:

expired='true' price='12'
expired='false' price='40'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

يمر هذا المثال في تعبير XPath، '//name[@price>35]'، للعثور على كافة عناصر name التي تحتوي على price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

إليك النتيجة:Honeycrisp

مثال: 7

في هذا المثال، افترض أن سلسلة XML items هي نفسها كما في المثال 1:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

يعثر هذا المثال على العقد التي تطابق العقدة <count></count> ويضيف قيم العقد هذه مع الدالة sum():

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

إليك النتيجة:30

مثال: 8

في هذا المثال، افترض أن لديك سلسلة XML هذه، والتي تشمل مساحة اسم مستند XML، xmlns="https://contoso.com":

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

تستخدم هذه التعبيرات تعبير XPath /*[name()="file"]/*[name()="location"] أو /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]، للعثور على العقد التي تطابق العقدة <location></location>. تُظهر هذه الأمثلة بناء الجملة الذي تستخدمه في المصمم أو في محرر التعبير:

xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

إليك عقدة النتيجة التي تطابق العقدة <location></location>:

<location xmlns="https://contoso.com">Paris</location>

هام

إذا كنت تعمل في طريقة عرض التعليمات البرمجية، فتخلص من علامة الاقتباس المزدوجة (") باستخدام حرف الخط المائل العكسي (\). على سبيل المثال، تحتاج إلى استخدام أحرف الإلغاء عند إجراء تسلسل لتعبير ما كسلسلة JSON. ومع ذلك، إذا كنت تعمل في المصمم أو محرر التعبير، فلن تحتاج إلى إلغاء علامة الاقتباس المزدوجة لأن حرف الخط المائل العكسي يُضاف تلقائيًا إلى التعريف الأساسي، على سبيل المثال:

طريقة عرض التعليمات البرمجية: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
محرر التعبير: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

مثال: 9

بعد المثال 8، يستخدم هذا المثال تعبير XPath، 'string(/*[name()="file"]/*[name()="location"])'، للعثور على القيمة في العقدة <location></location>:

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

إليك النتيجة:Paris

الخطوات التالية

تعرف على المزيد بشأن لغة تعريف سير العمل