مشاركة عبر


Concatودالات Concatenate

الوظيفة تنطبق على
Concat تعمل تطبيقات Canvas Copilot Studio Desktop على تدفقات التطبيقات المستندة إلى نموذج Power Platform CLI Dataverse لوظائف Power Pages
Concatenate تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse Power Pages

تسلسل سلاسل النص والسلاسل الفردية في الجداول.

‏‏الوصف

Concatenate تقوم الدالة بسلسلة مزيج من السلاسل الفردية وجدول من عمود واحد من السلاسل. عند استخدام هذه الدالة مع سلاسل فردية، فهي مكافئه لاستخدام عامل التشغيل&.

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

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

استخدم وظيفة Split أو MatchAll لتقسيم سلسلة في جدول من السلاسل الفرعية.

بناء الجملة

Concat( جدول، صيغة، فاصل)

  • الجدول - مطلوب. الجدول المُراد العمل عليه.
  • الصيغة - مطلوبة. الصيغة المُراد تطبيقها عبر سجلات الجدول.
  • فاصل - اختياري. قيمة نصية يتم إدخالها بين الصفوف المتسلسلة من الجدول.

Concatenate( String1 [, String2, ...] )

  • السلاسل - مطلوب. خليط من السلاسل الفردية أو جدول من عمود واحد للسلاسل.

الأمثلة

تستخدم الأمثلة الواردة في هذا القسم هذه المتغيرات العمومية:

  • الاسم الأول = "جين"
  • اسم العائلة = "الفلاني"
  • منتجات = جدول من عمودين وأربعة صفوف.

لإنشاء هذه المتغيرات العامة في تطبيق، قم بادراج عنصر تحكم Button، وقم بتعيين خاصية OnSelect الخاصة به إلى هذه الصيغة:

Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
    Table(
        { Name: "Violin", Type: "String" },
        { Name: "Cello", Type: "String" },
        { Name: "Trumpet", Type: "Wind" }
    )
)

حدد الزر (بالنقر فوقه أثناء الضغط باستمرار على المفتاح Alt).

Concatenate الدالة وعامل التشغيل

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

صيغة ‏‏الوصف نتيجة
Concatenate( LastName, ", ", FirstName ) يقوم بتسلسل القيمة في LastName، السلسلة "،" (فاصلة متبوعة بمسافة)، والقيمة في FirstName. "Doe, Jane"
اسم العائلة & "،" & الاسم الأول تمامًا كالمثال السابق باستثناء استخدام عامل التشغيل & بدلاً من الدالة. "Doe, Jane"
Concatenate( FirstName, " ", LastName ) يقوم بتسلسل القيمة في FirstName، السلسلة " " (مسافة واحدة)، والقيمة في FirstName. "جين دو"
الاسم الأول & " " & اسم العائلة تمامًا كالمثال السابق، باستخدام عامل التشغيل & بدلاً من الدالة. "جين دو"

Concatenate مع جدول من عمود واحد

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

صيغة ‏‏الوصف نتيجة
Concatenate( "الاسم: ", Products.Name, ", Type: ", Products.Type ) بالنسبة إلى كل سجل في جدول المنتجات، تتم سلسلة السلسلة "الاسم: "، اسم المنتج، والسلسلة "، النوع: "، ونوع المنتج. جدول بعمود واحد بعمود Valueيحتوي على القيم التالية: "Name: Violin, Type: String"‏، و"Name:‏ "Cello، وType: String"، و"Name: Trumpet، وType: Wind"

Concat دالة

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

صيغة ‏‏الوصف نتيجة
Concat( المنتجات، الاسم، "، " ) تقييم التعبير الاسم بالنسبة لكل سجل منتجات وتسلسل النتائج معًا في سلسلة نص واحدة مفصولة بـ ", ". "الكمان، سيلو، البوق"
Concat( المنتجات، "'" والاسم ""، و"، و" ) تقييم التعبير "'" & Name & "'" لكل سجل منتجات‏‎ وسلسلة النتائج معًا في سلسلة نص واحدة مفصولة بواسطة ", ". "'Violin', 'Cello', 'البوق'"
Concat( Filter( Products, Type = "String"), Name, ", " ) تقييم الصيغة الاسم لكل سجل منتجات يفي بعامل التصفية النوع = "السلسلة"، وتسلسل النتائج في سلسلة نص واحدة مفصولة بـ ", ". "الكمان، تيلو"

التقسيم وMatchAll

إذا كنت تستخدم Concat مع فاصل، يمكنك عكس العملية باستخدام الدالة Split .

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

صيغة ‏‏الوصف نتيجة
Split( Concat( Products, Name, ", " ), ", " ) تقسيم السلسلة النصية باستخدام الفاصل "، ". جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Violin"، و"Cello"، و"Trumpet"