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

مقالة
05/07/2022
قراءة خلال 87 دقائق

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

ملاحظة

تنطبق هذه الصفحة المرجعية على كل من 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>).<اسم الخاصية>"

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

"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	إنشاء معرف فريد عمومي (GUID) كسلسلة.
indexOf	إرجاع موضع البداية لسلسلة فرعية.
isInt	إرجاع قيمة منطقية تشير إلى ما إذا كانت السلسلة عددا صحيحا.
lastIndexOf	إرجاع موضع البداية لآخر تكرار لسلسة فرعية.
الطول	إرجاع عدد العناصر في سلسلة أو مصفوفة.
nthIndexOf	إرجاع موضع البداية أو قيمة الفهرس حيث يظهر التكرار nth لسلسلة فرعية في سلسلة.
replace	استبدال سلسلة فرعية بالسلسلة المحددة، ثم إرجاع السلسلة المحدثة.
slice	إرجاع سلسلة فرعية عن طريق تحديد موضع البداية والنهاية أو القيمة. راجع أيضا السلسلة الفرعية.
split	إرجاع مصفوفة تحتوي على سلاسل فرعية مفصولة بفاصلات من سلسلة أكبر استناداً إلى حرف محدد معين في السلسلة الأصلية.
startsWith	تحقق مما إذا كانت سلسلة تبدأ بسلسلة فرعية معينة.
substring	إرجاع أحرف من سلسلة، بدءاً من الموضع المحدد. انظر أيضا شريحة.
toLower	إرجاع سلسلة بتنسيق أخرف صغيرة.
toUpper	إرجاع سلسلة بتنسيق أحرف كبيرة.
trim	إزالة المسافة البيضاء البادئة والزائدة من سلسلة، ثم إرجاع السلسلة المحدثة.

دوال التحصيل

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

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

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

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

ملاحظة

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

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

دوال التحويل

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

ملاحظة

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

دالة التحويل	المهمة
array	إرجاع صفيف من إدخال واحد محدد. للحصول على مدخلات متعددة، انظر createArray.
base64	إرجاع الإصدار المرمّز باستخدام base64 لإحدى السلاسل.
base64ToBinary	إرجاع الإصدار الثنائي لسلسلة مرمّزة باستخدام base64.
base64ToString	إرجاع إصدار السلسلة لسلسلة مرمّزة باستخدام base64.
binary	إرجاع الإصدار الثنائي لقيمة إدخال.
Bool	إرجاع الإصدار المنطقي لقيمة إدخال.
createArray	إرجاع صفيف من مدخلات متعددة.
dataUri	إرجاع URI للبيانات لقيمة إدخال.
dataUriToBinary	إرجاع الإصدار الثنائي لـ URI للبيانات.
dataUriToString	إرجاع إصدار السلسلة لـ URI للبيانات.
عشري	إرجاع الرقم العشري لسلسلة عشرية.
decodeBase64	إرجاع إصدار السلسلة لسلسلة مرمّزة باستخدام base64.
decodeDataUri	إرجاع الإصدار الثنائي لـ URI للبيانات.
decodeUriComponent	إرجاع سلسلة استبدال أحرف الإلغاء بإصدارات غير مرمزة.
encodeUriComponent	إرجاع سلسلة يستبدل أحرف URL غير الآمنة بأحرف الإلغاء.
عائم	إرجاع رقم فاصلة عائمة لقيمة إدخال.
Int	إرجاع إصدار صحيح لسلسلة.
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	إرجاع عدد صحيح عشوائي من نطاق محدد.
range	إرجاع صفيف عدد صحيح يبدأ من عدد صحيح محدد.
sub	إرجاع الناتج من طرح الرقم الثاني من الرقم الأول.

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

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

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

وظائف سير العمل

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

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

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

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

دالات تحليل URI

للعمل مع معرفات الموارد الموحدة (URIs) والحصول على قيم خصائص مختلفة لمعرفات 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	إرجاع القيمة غير الفارغة الأولى من معلمة واحدة أو أكثر.
إزالةProperty	قم بإزالة خاصية من كائن JSON وإرجاع الكائن المحدث.
setProperty	تعيين قيمة خاصية كائن JSON وإرجاع الكائن المحدث.
xpath	التحقق من XML للعقد أو القيم التي تطابق تعبير XPath (لغة مسار XML)، ثم إرجاع العقد أو القيم المتطابقة.

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

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

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

A

إجراء

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

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

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

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

المعلمة	مطلوب	النوع	الوصف
<الخاصيه>	لا	سلسلة	اسم خاصية كائن الإجراء التي تريد قيمتها: name و startTime و endTime و inputs و outputsو status و code و trackingId و clientTrackingId. في مدخل Microsoft Azure، يمكنك العثور على هذه الخصائص من خلال مراجعة تفاصيل محفوظات تشغيل معينة. لمزيد من المعلومات، راجع REST API - إجراءات تشغيل سير العمل.

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

actionBody

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

actionBody('<actionName>')

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

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

مثال

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

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() في المصمم، لذا ضع في اعتبارك استخدام المخرجات ()، بدلا من actionOutputs(). على الرغم من أن كلتا الدالتين تعملان بنفس الطريقة، يفضل استخدام outputs().

actionOutputs('<actionName>')

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

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

مثال

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

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"
  }
}

actions

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

تلميح

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

ملاحظة

في السابق، يمكنك استخدام الدالة actions() أو conditions العنصر عند تحديد تشغيل إجراء استنادا إلى الإخراج من إجراء آخر. ومع ذلك، للإعلان صراحة عن التبعيات بين الإجراءات، يجب عليك الآن استخدام خاصية الإجراء runAfter التابع. لمعرفة المزيد حول الخاصية runAfter ، راجع Catch and handle failures with the runAfter property.

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

المعلمة	مطلوب	النوع	الوصف
<اسم الإجراء>	نعم	سلسلة	اسم كائن الإجراء الذي تريد إخراجه
<الخاصيه>	لا	سلسلة	اسم خاصية كائن الإجراء التي تريد قيمتها: name و startTime و endTime و inputs و outputsو status و code و trackingId و clientTrackingId. في مدخل Microsoft Azure، يمكنك العثور على هذه الخصائص من خلال مراجعة تفاصيل محفوظات تشغيل معينة. لمزيد من المعلومات، راجع REST API - إجراءات تشغيل سير العمل.

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

مثال

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

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

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

إضافة

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

add(<summand_1>, <summand_2>)

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

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

مثال

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

add(1, 1.5)

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

addDays

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

addDays('<timestamp>', <days>, '<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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الساعات>	نعم	عدد صحيح	العدد الموجب أو السالب للساعات التي يجب إضافتها
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الدقائق>	نعم	عدد صحيح	العدد الموجب أو السالب للدقائق التي يجب إضافتها
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>)

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

القيمة المُرجعة	النوع	الوصف
<كائن محدث>	العنصر	كائن JSON المحدث بالخاصية المحددة

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

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

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

القيمة المُرجعة	النوع	الوصف
<كائن محدث>	العنصر	كائن 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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الثواني>	نعم	عدد صحيح	العدد الموجب أو السالب للثواني التي يجب إضافتها
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الفاصل الزمني>	نعم	عدد صحيح	عدد الوحدات الزمنية المحددة المطلوب إضافتها
<timeUnit>	نعم	سلسلة	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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"

و

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

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

المعلمة	مطلوب	النوع	الوصف
<expression1>, <expression2>, ...	نعم	منطقي	التعبيرات التي يجب التحقق منها

القيمة المُرجعة	النوع	الوصف
صواب أو خطأ	منطقي	إرجاع true عندما تكون كافة التعبيرات صحيحة. إرجاع 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"]

B

base64

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

ملاحظة

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

base64('<value>')

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

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

مثال

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

base64('hello')

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

base64ToBinary

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

ملاحظة

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

base64ToBinary('<value>')

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

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

مثال

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

base64ToBinary('aGVsbG8=')

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

base64ToString

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

ملاحظة

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

base64ToString('<value>')

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

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

مثال

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

base64ToString('aGVsbG8=')

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

ثنائي

إرجاع الإصدار الثنائي المرمز 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>')

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

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

مثال

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

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

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

bool(<value>)

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

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

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

المخرجات

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

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

C

الدمج

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

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>', ...)

المعلمة	مطلوب	النوع	الوصف
<text1>, <text2>, ...	نعم	سلسلة	على الأقل سلسلتان للجمع

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

ملاحظة

يقوم 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>')

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

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

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

القيمة المُرجعة	النوع	الوصف
صواب أو خطأ	منطقي	إرجاع القيمة 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 المناطق الزمنية الافتراضية.
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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 المناطق الزمنية الافتراضية، ولكن قد يتعين عليك إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<destinationTimeZone>	نعم	سلسلة	اسم المنطقة الزمنية الهدف. للحصول على أسماء المناطق الزمنية، راجع Microsoft Windows المناطق الزمنية الافتراضية، ولكن قد يتعين عليك إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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 المناطق الزمنية الافتراضية، ولكن قد تحتاج إلى إزالة أي علامات ترقيم من اسم المنطقة الزمنية.
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>', ...)

المعلمة	مطلوب	النوع	الوصف
<object1>, <object2>, ...	نعم	أي، ولكن ليست مختلطة	عنصران على الأقل لإنشاء الصفيف

القيمة المُرجعة	النوع	الوصف
[<object1>, <object2>, ...]	صفيف	الصفيف الذي تم إنشاؤه من جميع عناصر الإدخال

مثال

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

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"

dayOfMonth

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

dayOfMonth('<timestamp>')

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

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

مثال

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

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

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

dayOfWeek

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

dayOfWeek('<timestamp>')

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

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

مثال

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

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

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

dayOfYear

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

dayOfYear('<timestamp>')

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

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

مثال

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

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".

decodeBase64 (مهمل)

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

مثال 1

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

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

مثال 2

يرجع كلا المثالين هذه القيمة بنوع Float: 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>])

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

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

مثال

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

empty('')
empty('abc')

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

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

endsWith

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

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

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

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

مثال 1

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

endsWith('hello world', 'world')

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

مثال 2

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

endsWith('hello world', 'universe')

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

يساوي

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

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

المعلمة	مطلوب	النوع	الوصف
<object1>, <object2>	نعم	مختلف	القيم أو التعبيرات أو الكائنات التي يجب مقارنتها

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

مثال

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

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

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

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

F#‎

first

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

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

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

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

مثال

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

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

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

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

حُر

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

float('<value>')

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

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

مثال

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

float('10.333')

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

formatDateTime

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

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

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>')

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

القيمة المُرجعة	النوع	الوصف
[<قيم الصفيف مع المفتاح>]	صفيف	صفيف مع كافة القيم التي تطابق المفتاح المحدد

مثال

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

formDataMultiValues('Send_an_email', 'Subject')

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

formDataValue

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

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

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

القيمة المُرجعة	النوع	الوصف
<قيمة المفتاح>	سلسلة	القيمة الموجودة في المفتاح المحدد

مثال

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

formDataValue('Send_an_email', 'Subject')

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

رقم التنسيق

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

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

المعلمة	مطلوب	النوع	الوصف
<عدد>	نعم	عدد صحيح أو مزدوج	القيمة التي تريد تنسيقها.
<التنسيق>	نعم	سلسلة	سلسلة تنسيق مركب تحدد التنسيق الذي تريد استخدامه. للحصول على سلاسل التنسيق الرقمي المدعومة، راجع سلاسل التنسيق الرقمي القياسية، التي يدعمها `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>?)

المعلمة	مطلوب	النوع	الوصف
<الفاصل الزمني>	نعم	عدد صحيح	عدد الوحدات الزمنية المراد إضافتها
<timeUnit>	نعم	سلسلة	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<التنسيق>	لا	سلسلة	إما محدد تنسيق فردي أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>?)

المعلمة	مطلوب	النوع	الوصف
<الفاصل الزمني>	نعم	عدد صحيح	عدد الوحدات الزمنية المحددة المطلوب طرحها
<timeUnit>	نعم	سلسلة	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<التنسيق>	لا	سلسلة	إما محدد تنسيق فردي أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>	نعم	عدد صحيح أو عائم أو سلسلة على التوالي	قيمة المقارنة

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

مثال

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

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

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

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

greaterOrEquals

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

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

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

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

مثال

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

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

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

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

المعرف الفريد العمومي

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

guid()

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

guid('<format>')

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

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

مثال

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

guid('P')

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

I

if

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

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

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

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

مثال

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

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

indexOf

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

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

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

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

مثال

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

indexOf('hello world', 'world')

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

int

تحويل إصدار السلسلة لعدد صحيح إلى عدد صحيح فعلي.

int('<value>')

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

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

مثال

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

int('10')

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

isInt

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

isInt('<string>')

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

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

مثال

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

isInt('10')

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

عنصر

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

item()

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

مثال

يحصل هذا المثال على body العنصر من الرسالة الحالية لإجراء "Send_an_email" داخل التكرار الحالي لكل حلقة:

item().body

العناصر

إرجاع العنصر الحالي من كل دورة في حلقة لكل حلقة. استخدم هذه الدالة داخل التكرار الحلقي لكل حلقة.

items('<loopName>')

المعلمة	مطلوب	النوع	الوصف
<اسم التكرار الحلقي>	نعم	سلسلة	اسم التكرار الحلقي لكل حلقة

القيمة المُرجعة	النوع	الوصف
<البند>	أي	العنصر من الدورة الحالية في التكرار الحلقي المحدد لكل حلقة

مثال

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

items('myForEachLoopName')

تكرارات

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

iterationIndexes('<loopName>')

المعلمة	مطلوب	النوع	الوصف
<اسم التكرار الحلقي>	نعم	سلسلة	اسم حلقة Until

القيمة المُرجعة	النوع	الوصف
<مؤشر>	عدد صحيح	قيمة الفهرس للتكرار الحالي داخل حلقة 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([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

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

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

مثال

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

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

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

انضمام

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

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

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

القيمة المُرجعة	النوع	الوصف
<حرف 1><محدد><حرف 2><محدد> ...	سلسلة	السلسلة الناتجة التي تم إنشاؤها من كافة العناصر في الصفيف المحدد. ملاحظة: يجب ألا يتجاوز طول النتيجة 104857600 حرف.

مثال

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

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>	عدد صحيح	موضع البداية أو قيمة الفهرس لآخر تكرار للسلسلة الفرعية المحددة.

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

إذا كانت قيمة السلسلة فارغة فقط، ترجع -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>	عدد صحيح	عدد العناصر الموجودة في المجموعة

مثال

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

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

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

أقل

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

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

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

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

مثال

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

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

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

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

lessOrEquals

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

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

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

القيمة المُرجعة	النوع	الوصف
صواب أو خطأ	منطقي	إرجاع القيمة 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(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

المعلمة	مطلوب	النوع	الوصف
<number1>, <number2>, ...	نعم	عدد صحيح أو عائم أو كلاهما	مجموعة الأرقام التي تريد منها أعلى قيمة
[<number1>, <number2>, ...]	نعم	صفيف - عدد صحيح أو عائم أو كليهما	صفيف الأرقام التي تريد من خلالها أعلى قيمة

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

مثال

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

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

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

دقيقة

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

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

المعلمة	مطلوب	النوع	الوصف
<number1>, <number2>, ...	نعم	عدد صحيح أو عائم أو كلاهما	مجموعة الأرقام التي تريد منها أدنى قيمة
[<number1>, <number2>, ...]	نعم	صفيف - عدد صحيح أو عائم أو كلاهما	مصفوفة الأرقام التي تريد منها أدنى قيمة

القيمة المُرجعة	النوع	الوصف
<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('<actionName>', <index>)

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

القيمة المُرجعة	النوع	الوصف
<الجسم>	سلسلة	النص الأساسي للجزء المحدد

-N

not

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

not(<expression>)

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

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

مثال 1

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

not(false)
not(true)

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

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

مثال 2

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

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

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

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

nthIndexOf

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

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

المعلمة	مطلوب	النوع	الوصف
<text>	نعم	سلسلة	السلسلة التي تحتوي على السلسلة الفرعية للبحث عنها
<searchText>	نعم	سلسلة	السلسلة الفرعية المطلوب البحث عنها
<حدوث>	نعم	عدد صحيح	رقم يحدد التكرار nth للسلسلة الفرعية للبحث عنها. إذا كان التكرار سالبا، فابدأ البحث من النهاية.

القيمة المُرجعة	النوع	الوصف
<index-value>	عدد صحيح	موضع البداية أو قيمة الفهرس لحدوث nth للسلسلة الفرعية المحددة. إذا لم يتم العثور على السلسلة الفرعية أو أقل من 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

أو

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

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

المعلمة	مطلوب	النوع	الوصف
<expression1>, <expression2>, ...	نعم	منطقي	التعبيرات التي يجب التحقق منها

القيمة المُرجعة	النوع	الوصف
صواب أو خطأ	منطقي	إرجاع 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>')

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

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

مثال

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

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>')

المعلمة	مطلوب	النوع	الوصف
<اسم المعلمة>	نعم	سلسلة	اسم المعلمة التي تريد قيمتها

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

مثال

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

{
  "fullName": "Sophia Owen"
}

يحصل هذا المثال على قيمة المعلمة المحددة:

parameters('fullName')

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

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

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

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

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الاعدادات المحليه>	لا	سلسلة	لغة الاستخدام. إذا لم يتم تحديد الإعدادات المحلية الافتراضية هي `en-us`. إذا لم تكن القيمة المحلية قيمة صالحة، يتم إنشاء خطأ.
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>	نعم	عدد صحيح	أقل عدد صحيح في النطاق
<maxValue>	نعم	عدد صحيح	العدد الصحيح الذي يلي أعلى عدد صحيح في النطاق الذي يمكن أن ترجعه الدالة

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

مثال

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

rand(1, 5)

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

range

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

range(<startIndex>, <count>)

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

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

مثال

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

range(1, 4)

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

الاستبدال

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

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

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

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

مثال

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

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

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

removeProperty

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

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

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

القيمة المُرجعة	النوع	الوصف
<كائن محدث>	العنصر	كائن JSON المحدث بدون الخاصية المحددة

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

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

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

القيمة المُرجعة	النوع	الوصف
<كائن محدث>	العنصر	كائن 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"
   }
}

النتيجة

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

ملاحظة

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

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

result('<scopedActionName>')

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

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

مثال

يقوم هذا المثال بإرجاع المدخلات والمخرجات من كل تكرار لإجراء 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"
            }
         }
      ]
   }
]

S

setProperty

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

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

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

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

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

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

القيمة المُرجعة	النوع	الوصف
<كائن محدث>	العنصر	كائن 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([<collection>], <count>)

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

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

مثال

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

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

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

slice

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

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

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

القيمة المُرجعة	النوع	الوصف
<نتيجة الشريحة>	سلسلة	سلسلة جديدة تحتوي على السلسلة الفرعية التي تم العثور عليها

أمثلة

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 ''.

‏‏مقسّم

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

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

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

القيمة المُرجعة	النوع	الوصف
[<substring1,substring2>><,...]	صفيف	مصفوفة تحتوي على سلاسل فرعية من السلسلة الأصلية المفصولة بفواصل

مثال 1

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

split('a_b_c', '_')

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

مثال 2

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

split('a_b_c', ' ')

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

startOfDay

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

startOfDay('<timestamp>', '<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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>'?)

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>	نعم	سلسلة	سلسلة البداية التي سيتم البحث عنها

القيمة المُرجعة	النوع	الوصف
صواب أو خطأ	منطقي	إرجاع القيمة 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>	نعم	عدد صحيح	رقم موجب يساوي أو أكبر من 0 الذي تريد استخدامه كموضع بداية أو قيمة فهرس
<الطول>	لا	عدد صحيح	عدد موجب من الأحرف التي تريدها في السلسلة الفرعية

ملاحظة

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

القيمة المُرجعة	النوع	الوصف
<substring-result>	سلسلة	سلسلة فرعية ذات عدد محدد من الأحرف، تبدأ من موضع الفهرس المحدد في سلسلة المصدر

مثال

ينشئ هذا المثال سلسلة فرعية من خمسة أحرف من السلسلة المحددة، بدءاً من قيمة الفهرس 6:

substring('hello world', 6, 5)

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

subtractFromTime

طرح عدد من وحدات الوقت من الطابع الزمني. انظر كذلك getPastTime.

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

المعلمة	مطلوب	النوع	الوصف
<الطابع الزمني>	نعم	سلسلة	السلسلة التي تحتوي على الطابع الزمني
<الفاصل الزمني>	نعم	عدد صحيح	عدد الوحدات الزمنية المحددة المطلوب طرحها
<timeUnit>	نعم	سلسلة	وحدة الوقت المراد استخدامها مع الفاصل الزمني: "الثانية"، و"الدقيقة"، و"الساعة"، و"اليوم"، و"الأسبوع"، و"الشهر"، و"السنة"
<التنسيق>	لا	سلسلة	سلسلة تنسيق رقمي إما محدد تنسيق واحد أو نمط تنسيق مخصص. التنسيق الافتراضي للطوابع الزمنية هو "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>	نعم	عدد صحيح	عدد صحيح موجب لعدد العناصر التي تريدها من المقدمة

القيمة المُرجعة	النوع	الوصف
<فرعيه> أو [<مجموعة فرعية>]	سلسلة أو صفيف، على التوالي	سلسلة أو صفيف يحتوي على عدد محدد من العناصر المأخوذة من مقدمة المجموعة الأصلية

مثال

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

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>	عدد صحيح	عدد علامات التجزئة منذ الطابع الزمني المحدد

toLower

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

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()

القيمة المُرجعة	النوع	الوصف
<مشغل-نص-إخراج>	سلسلة	الإخراج `body` من المشغل

triggerFormDataMultiValues

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

triggerFormDataMultiValues('<key>')

المعلمة	مطلوب	النوع	الوصف
<مفتاح>	نعم	سلسلة	اسم المفتاح الذي تريد قيمته

القيمة المُرجعة	النوع	الوصف
[<قيم الصفيف مع المفتاح>]	صفيف	صفيف مع كافة القيم التي تطابق المفتاح المحدد

مثال

ينشئ هذا المثال صفيفا من قيمة المفتاح "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>)

المعلمة	مطلوب	النوع	الوصف
<مؤشر>	نعم	عدد صحيح	قيمة الفهرس للجزء الذي تريده

القيمة المُرجعة	النوع	الوصف
<الجسم>	سلسلة	النص الأساسي للجزء المحدد في إخراج المشغل متعدد الأجزاء

مشغلOutputs

إرجاع إخراج المشغل في وقت التشغيل، أو القيم من أزواج اسم وقيمة JSON الأخرى. اختصار ل trigger().outputs. راجع trigger().

triggerOutputs()

القيمة المُرجعة	النوع	الوصف
<إخراج المشغل>	سلسلة	الإخراج من مشغل في وقت التشغيل

اقتطاع

إزالة المسافة البيضاء البادئة والزائدة من سلسلة، ثم إرجاع السلسلة المحدثة.

trim('<text>')

المعلمة	مطلوب	النوع	الوصف
<text>	نعم	سلسلة	السلسلة التي تحتوي على المسافات البيضاء البادئة واللاحقة للإزالة

القيمة المُرجعة	النوع	الوصف
<updatedText>	سلسلة	إصدار محدث للسلسلة الأصلية دون مسافات بيضاء بادئة أو لاحقة

مثال

يزيل هذا المثال المسافة البيضاء البادئة واللاحقة من السلسلة " مرحبًا بالعالم ":

trim(' Hello World  ')

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

U

موحد

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

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

المعلمة	مطلوب	النوع	الوصف
<collection1>, <collection2>, ...	نعم	صفيف أو كائن، ولكن ليس كلاهما	المجموعات من حيث تريد جميع العناصر

القيمة المُرجعة	النوع	الوصف
<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` قيمة 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 الذي تريد قيمه وقيمه `pathquery`

القيمة المُرجعة	النوع	الوصف
<قيمة استعلام المسار>	سلسلة	`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` قيمة URI المحدد. إذا `port` لم تحدد قيمة، فسترجع المنفذ الافتراضي للبروتوكول.

مثال

يرجع port هذا المثال قيمة URI هذا:

uriPort('https://www.localhost:8080')

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

uriQuery

query إرجاع قيمة معرف مورد موحد (URI).

uriQuery('<uri>')

المعلمة	مطلوب	النوع	الوصف
<Uri>	نعم	سلسلة	URI الذي `query` تريد قيمته

القيمة المُرجعة	النوع	الوصف
<قيمة الاستعلام>	سلسلة	`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` قيمة URI المحدد

مثال

يرجع scheme هذا المثال قيمة URI هذا:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

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

utcNow

إرجاع الطابع الزمني الحالي.

utcNow('<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>')

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

القيمة المُرجعة	النوع	الوصف
<قيمة متغيرة>	أي	قيمة المتغير المحدد

مثال

افترض أن القيمة الحالية لمتغير "numItems" هي 20. يحصل هذا المثال على قيمة العدد الصحيح لهذا المتغير:

variables('numItems')

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

W

سير العمل

إرجاع جميع التفاصيل حول سير العمل نفسه أثناء وقت التشغيل.

workflow().<property>

المعلمة	مطلوب	النوع	الوصف
<الخاصيه>	لا	سلسلة	اسم خاصية سير العمل التي تريد قيمتها بشكل افتراضي، يحتوي كائن سير العمل على هذه الخصائص: `name`و `typeid`و`runlocation`.`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>

X

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.

xpath('<xml>', '<xpath>')

المعلمة	مطلوب	النوع	الوصف
<xml>	نعم	أي	سلسلة XML للبحث عن العقد أو القيم التي تطابق قيمة تعبير XPath
<xpath>	نعم	أي	يستخدم تعبير XPath للبحث عن قيم أو عقد XML متطابقة

القيمة المُرجعة	النوع	الوصف
<xml-node>	XML	عقدة XML عندما تتطابق عقدة واحدة فقط مع تعبير XPath المحدد
<القيمة>	أي	القيمة من عقدة XML عندما تتطابق قيمة واحدة فقط مع تعبير XPath المحدد
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	صفيف	صفيف يحتوي على عقد 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'، للعثور على العقد التي تطابق العقدة <name></name>'items' في سلسلة XML، وإرجاع صفيف بقيم العقدة هذه:

xpath(xml(parameters('items')), '/produce/item/name')

يستخدم المثال أيضا الدالة parameters() للحصول على سلسلة XML من 'items' وتحويل السلسلة إلى تنسيق XML باستخدام الدالة xml().

فيما يلي صفيف النتائج مع العقد التي تطابق <name></name:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

مثال 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]'، للعثور على كافة العناصر التي تحتوي price > 35على name :

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

الخطوات التالية

تعرف على لغة تعريف سير العمل

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

هل هذه الصفحة مفيدة؟

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

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

دوال السلسلة

دوال التحصيل

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

دوال التحويل

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

ترميز Base64 وفك ترميزه

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

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

وظائف سير العمل

دالات تحليل URI

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

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

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

A

إجراء

actionBody

actionOutputs

actions

إضافة

addDays

addHours

addMinutes

addProperty

addSeconds

addToTime

و

صفيف

B

base64

base64ToBinary

base64ToString

ثنائي

هيئة

Bool

C

الدمج

Concat

يحتوي على

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

عشري

decodeBase64 (مهمل)

decodeDataUri

decodeUriComponent

div

E

encodeUriComponent

فارغ

endsWith

يساوي

F#‎

first

حُر

formatDateTime

قيم formDataMultiValues

formDataValue

رقم التنسيق

G

getFutureTime

getPastTime

أكبر

greaterOrEquals

المعرف الفريد العمومي

I

if

indexOf

int