الجديد للمطورين في تحديث يوليو 2017

نحن نهتم بالإعلان عن أن تحديث يوليو 2017 Dynamics 365 (عبر الإنترنت)متوفر لـ للتجربة و الشراء! واكب كل جديد للاطلاع على معلومات حول الوقت الذي يمكنك فيه تحديث مؤسساتك الموجودة.

راجع أيضًا الارتباطات التالية:

في Dynamics 365، تم تضمين وظائف Dynamics CRM السابقة كجزء من مجموعة تطبيقات الأعمال الذكية. يُشار إلى التطبيقات التي تشكل جزء إدارة علاقات العملاء (CRM) في المجموعة باسم "Customer Engagement" وتشمل تطبيقات Sales وCustomer Service وField Service وProject Service Automation والخدمات ذات الصلة.

تكامل البيانات الخارجية مع الكيانات الظاهرية

لديك طريقة جديدة لدمج البيانات من أنظمة خارجية. بدون الكيانات المرئية، فإن الاستراتيجيات الشائعة لتكامل البيانات الخارجية تشمل تعليمات برمجية على جانب العميل لاسترداد البيانات الخارجية وعرضها أو النسخ المتماثل للبيانات الخارجية على جانب الخادم ومزامنتها في Dynamics 365 Customer Engagement. توفر الكيانات المرئية منهجًا أفضل للعديد من متطلبات تكامل بيانات النظام الخارجي.

تحسينات وجهة API للويب

يتم تضمين التحسينات التالية في هذا الإصدار من واجهة API للويب، نقطة نهاية OData v4 الخاصة بنا:

  • توافر إجراءات مخصصة والتي تقوم بإرجاع أنواع EntityReference أو Entity أو EntityCollection.

  • توافر التغييرات على سلوكيات واجهة API باستخدام الإصدار الأخير v9.0 للخدمة، وبقاء السلوكيات القديمة متوفرة في الإصدار v8.x. لا يلزمك تغيير التعليمة البرمجية الخاصة بك عندما تقوم بالترقية.

  • رسائل جديدة: توافر رسائل GrantAccess وModifyAccess وRetrieveSharedPrincipalsAndAccess باستخدام واجهة API للويب.

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

تحسينات واجهة API للعميل

من خلال تقديم الواجهة الموحدة في إصدار تحديث 2017 لـ Dynamics 365 (على الإنترنت)، ثمة بعض تغييرات هامة تم إجراؤها على واجهات API للعميل لضمان أنها تعمل باتساق عبر الواجهة الموحدة وعميل الويب.

سياق التنفيذ والسياق العمومي

في النموذج، يمكن وجود عدة سياسات تنفيذ نشطة في نفس الوقت. على سبيل المثال، يحتوي النموذج المؤلف من نموذج سريع وشبكة قابلة للتحرير على سياق للكيان المعروض في النموذج، وسياق آخر للنموذج السريع، وسياق شبكة للشبكة القابلة لتحرير، وسياق كيان لكل صف في الشبكة القابلة للتحرير. Xrm.Page هو سياق النموذج الرئيسي. في حالة تشغيل برنامج نصي في سياق ثانوي (صف شبكة، نموذج سريع، كيان ذي صلة) عندئذ لكن يكون Xrm.Page هو سياق النموذج الصحيح.

يتم تمرير سياق التنفيذ في النموذج تلقائيًا إلى أحداث النماذج ومعالجات الأحداث. من ثم، بدلا من استخدام كائن Xrm.Page الثابت للحصول على سياق النموذج، يجب عليك الآن استخدام الأسلوب executionContext.getFormContext للحصول على مثيل سياق النموذج، ثم استخدامه لتنفيذ أساليب API للعميل بحيث يمكنك استخدام نفس البرامج النصية في سياقات مختلفة.

أيضًا، تم إهمال Xrm.Page.context المستخدم للإشارة إلى السياق على جانب العميل في هذا الإصدار؛ ويجب عليك الآن استخدام أسلوب Xrm.Utility.getGlobalContext جديد للحصول على السياق العمومي بدلا من الانتقال إلى سياق النموذج. يحتوي الأسلوب الجديد على مكافئ لكافة الأساليب المتوفرة لكائن Xrm.Page.context لاسترداد المعلومات الخاصة بمؤسسة أو مستخدم.

وجهات API للعميل الجديدة

قدمنا عددًا من واجهات API للعميل الجديدة في هذا الإصدار.

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

مساحة الاسم الجديدة الوصف
Xrm.Device يحتوي على أساليب لاستخدام إمكانات الأجهزة المحمولة.
Xrm.Encode يحتوي على أساليب تتعلق بتطبيق السمة وترميز XML على السلاسل.
Xrm.Navigation يحتوي على أساليب جديدة لمربعات حوار متعددة الصفحات وسير المهمة وبعض الأساليب الموجودة من مساحة الاسم Xrm.Utility.
Xrm.UI يحتوي على أساليب لعرض إعلامات عمومية على مستوى التطبيق وإخفائها.
Xrm.WebApi يحتوي على أساليب لتنفيذ عمليات CRUD على السجلات؛ ويقوم بالتبديل تلقائيًا بين وضع الاتصال وعدم الاتصال.
Xrm.WebApi.offline يحتوي على أساليب لتنفيذ عمليات CRUD أثناء العمل في وضع دون اتصال.
Xrm.WebApi.online يحتوي على أساليب لتنفيذ عمليات CRUD وExecute وExecuteMultiple أثناء العمل في وضع الاتصال.

تم تقديم واجهات API الجديدة التالية في مساحات الاسم الموجودة:

مساحة الاسم واجهات API جديدة
نموذج executionContext getUrl
Xrm.Page.data حدث OnLoad ومعالجات الأحداث (addOnLoad وremoveOnLoad)
isValid
تحديث saveOptions في أسلوب the Xrm.Page.data.save(saveOptions) ليتضمن قيمة جديدة تسمى SaveMode للسماح لمعالجات حدث onSave بمعرفة لماذا يحدث الحفظ
مجموعة السمات
Xrm.Page.data.entity مجموعة relatedEntities
getEntityReference
isValid
تحديث أسلوب save للسماح بإرسال saveOptions كمعلمة
Xrm.Page.data.entity attribute isValid
setPrecision
Xrm.Page.ui ثلاث واجهات API جديدة تنطبق فقط لمربعات الحوار متعددة الصفحات والتدفقات المستندة إلى المهام: getDefaultNextPageName وmovePrevious وmoveTo.
setFormEntityName
حدث OnLoad ومعالجات الأحداث (addOnLoad وremoveOnLoad)
Xrm.Utility getAllowedStatusTransitions
getEntityMetadata
getGlobalContext
getLearningPathAttributeName
getResourceString
invokeProcessAction
lookupObjects
showHierarchyPage
showProgressIndicator
closeProgressIndicator
refreshParentGrid

فضلا عن واجهات API للعميل الجديدة هذه، توجد بعض واجهات API إضافية للعميل والتي تم تقديمها لعناصر تحكم معينة مثل الشبكات والبحث ومجموعة الخيارات والمؤقت. لمزيد من المعلومات حول واجهات API الجديدة هذه، راجع الصفحات الخاصة بعنصر التحكم.

واجهات API للعميل المهملة

تم إهمال بعض واجهات API للعميل، ويجب أن تستخدم واجهات API للعميل الجديدة/المحسنة بدلا منها كما هو موضح في هذه القائمة: تم إهمال بعض واجهات API للعميل

ملاحظة: الإهمال يعني أن أننا نعتزم إزالة واجهة API للعميل من إصدار "رئيسي" مستقبلي لـ Dynamics 365. سوف يستمر العمل بواجهة API للعميل ودعمها بالكامل حتى إزالتها رسميًا. بعد الإزالة، لن تعمل الميزة أو الإمكانية. نحن نخطط الآن بحيث يتاح لك الوقت الكافي لتخطيط وتحديث التعليمات البرمجية الخاصة بك قبل إزالة هذه الميزة أو الإمكانية.

دعم واجهة API للعميل لعنصر تحكم المخطط الزمني الجديد في الواجهة الموحدة

يقدم عنصر تحكم المخطط الزمني الجديد عمليات النشر والأنشطة والملاحظات في العرض الموحد. يدعم عنصر التحكم في المخطط الزمني واجهات API للعميل التالية:

  • getControlType: تقوم بإرجاع “timelinewall”

  • getName

  • getParent

  • getLabel و setLabel

  • getVisible و setVisible

  • setFocus: يعين التركيز على زر إضافة في عنصر التحكم.

  • refresh: تحديث حائط المخطط الزمني.

لمزيد من المعلومات حول واجهات API للعميل، راجع عنصر تحكم Xrm.Page.ui (مرجع على جانب العميل)

إنشاء تطبيقات الأعمال المستند إلى الدوار والمبنية لغرض معين وإدارتها

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

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

استخدم:

  • كيان AppModule لإنشاء التطبيقات وإدارتها والتحقق منها

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

  • كيان AppModuleRoles لإقران أدوار الأمان وإلغاء إقرانها والتي تحدد وصول المستخدمين لتطبيق ما.

أيضًا، تتوفر الآن واجهات API للعميل الجديدة في السياق العمومي (Xrm.Utility.getGlobalContext) الذي يتيح لك استرداد المعلومات حول التطبيق الحالي:

  • getCurrentAppUrl: الحصول على URL للتطبيق الحالي.

  • getCurrentAppName: الحصول على الاسم للتطبيق الحالي.

  • getCurrentAppProperties: الحصول على الخصائص للتطبيق الحالي مثل appId وdisplayName وuniqueName وurl وwebResourceId وwelcomePageId.

نوع السمة الجديدة: مجموعة خيارات التحديد المتعدد

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

دعم البرمجة النصية للنماذج لمجموعات خيارات التحديد المتعدد

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

تدعم مجموعات خيارات التحديد المتعدد كافة واجهات API للعميل المدعومة لمجموعة الخياراتالسمات وعناصر التحكم؛ والفرق الوحيد هو أن القيمة العائدة من أساليب معينة ستكون مصفوفة بدلاً من قيمة فردية.

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

إنشاء عناصر تحكم مخصصة

تم إصدار إمكانية إنشاء عناصر تحكم كميزة معاينة. يوفر إطار عمل عناصر التحكم المخصصة (CCF) إطار عمل قابل للتوسعة لإنشاء مكونات واجهة مستخدم لعرض البيانات والتفاعل معها في التطبيق. باستخدام إطار عمل عناصر التحكم المخصصة (CCF) ستتمكن من تحديد مكونات واجهة المستخدم التي تمثل مكونات الحل المعتمدة على بيانات التعريف والقابلة للتكوين ولإعادة الاستخدام. ستتمكن من تحديد عناصر تحكم للحقول الفردية والشبكات والشبكات الفرعية.

تكامل WebHooks

ستتمكن من دمج البيانات من Dynamics 365 Customer Engagement إلى التعليمات البرمجية المخصصة لك والجاري استضافتها على خدمات خارجية باستخدام WebHooks. يمكنك استخدام أداة تسجيل المكون الإضافي لتكوين متى يتم ترحيل بيانات Customer Engagement إلى خدمة خارجية. يعتبر WebHooks من أنماط HTTP الصغيرة لتوصيل واجهات API للويب والخدمات مع نموذج النشر/الاشتراك. يُعلم مرسلو WebHooks المستلمين بشأن الأحداث من خلال تقديم طلبات إلى نقاط النهاية للمستلم مع بعض المعلومات حول الأحداث. باستخدام نموذج WebHooks، يمكنك تأمين نقطة النهاية الخاصة بك باستخدام عنوان مصادقة أو مفاتيح معلمة استعلام. وهذا يوفر بديلا لنموذج مصادقة SAS الذي يمكنك حاليًا استخدامه لتكامل ناقل خدمة Azure.

موارد ويب صورة خط المتجه

استخدم صور خط المتجهة لأي رمز يتم عرضه في التطبيق. تُعرف صور خط المتجه بأنها تنسيق صور خط متجه يستند إلى XML لرسومات متجهات قابلة للتوسعة (SVG). وتتميز صور خط المتجه عن موارد ويب الصور الأخرى بأنها قابلة لتغيير الحجم. يمكنك تحديد صورة خط المتجه وإعادة استخدامها بدلاً من توفير أحجام صور متعددة. يمكنك استخدام مورد الويب هذا لتحديد رمز فردي لكيان بدلا من الصور بأحجام مختلفة.

دعم الحلول القابلة للترجمة

يمكنك استخدام موارد ويب RESX لتخزين السلاسل المترجمة للحلول الخاصة بك. يُستخدم تنسيق RESX XML عمومًا لتعريف الموارد المترجمة بحيث توجد أداة مشتركة متوفرة للتعامل مع هذا النوع من الملفات ويكون موردي الترجمة على دراية بالتعامل معها. يمكنك إقران موارد ويب RESX مع أي مورد ويب JavaScript تستخدمها، بحيث يمكنك استخدام واجهة API جديدة على جانب العميل للوصول إلى السلاسل المترجمة في وقت التشغيل.

تبعيات مورد ويب JavaScript

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

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

تحسينات مركز الخدمة التفاعلية

فيما يلي التغييرات على مركز الخدمة التفاعلية:

  • مركز الخدمة التفاعلية يُسمى الآن مركز خدمة العملاء، هو متوفر كتطبيق واجهة موحدة.

  • يستخدم تطبيق مركز خدمة العملاء نوع نموذج رئيسي بدلا من نوع نموذج رئيسي - تجربة تفاعلية. إذا كنت تقوم بالترقية من إصدار سابق لـ Dynamics 365 Customer Engagement، فإن كافة أنواع نماذج رئيسي - تجربة تفاعلية الخاصة بك سيتم تحويلها إلى نوع نموذج رئيسي. سيتم تعيين أي نوع نماذج رئيسي - تجربة تفاعلية خاص بك قابل للتخصيص إلى غير نشط أثناء الترقية، ويجب عليك تمكين النماذج المحولة بعد الترقية لاستخدامها. ستكون أيضًا كافة أنواع نماذج رئيسي - خدمة تفاعلية المحولة إلى نوع نموذج رئيسي بتصنيف أقل من أنواع النماذج رئيسي لمنع أي تعارضات في ترتيب النماذج. وهذا يضمن عرض النموذج الصحيح للمستخدمين في ترقية النشر لعميل الويب.

  • تم الآن تمكين كافة الكيانات للتجربة التفاعلية في تطبيق مركز خدمة العملاء. هذا يعني أن خاصية EntityMetadata.IsInteractionCentricEnabled، التي تشير إلى ما إذا كان يمكن تمكين الكيان للتجربة التفاعلية أم لا، لم تعد متعلقة. تمت إزالة الإعداد المتعلق لهذه الخاصية في أداة التخصيص، تمكين للتجربة التفاعلية، في الإصدار الحالي، وسوف تتم إزالة خاصية EntityMetadata.IsInteractionCentricEnabled من الإصدار المستقبلي لـ Dynamics 365 SDK for Customer Engagement.

تجاوز سلوك الفتح الافتراضي لصفوف البيانات في شبكة مرتبطة بالكيان

في الوقت الحالي، يؤدي تنفيذ أي من الإجراءات التالية في صف البيانات في شبكة مرتبطة بالكيان إلى فتح سجل الكيان افتراضيًا:

  • النقر المزدوج فوق صف البيانات أو النقر فوق ارتباط السمة الرئيسية في الصف.

  • تحديد صف بيانات، والضغط على "إدخال".

  • تحديد صف بيانات، في جهاز تم تمكين اللمس به.

قد يكون هناك حالات لا تريد فيها فتح سجل الكيان، على سبيل المثال، بالنسبة لسجلات إدارة المستندات، قد تحتاج إلى فتح موقع SharePoint بدلاً من عرض السجل. يمكنك الآن تجاوز السلوك الافتراضي لتحديد السلوك المخصص الخاص بك.

يمكنك الآن إنشاء تعريف أمر للكيان باستخدام Mscrm.OpenRecordItem كقيمة لسمة Id (<CommandDefinition> (RibbonDiffXml)، وتحديد إجراء مخصص للأمر <Actions> (RibbonDiffXml). سوف يبحث Customer Engagement عن معرف الأمر هذا للكيان عندما تحاول فتح سجل من شبكة مرتبطة بالكيان، وفي حالة وجوده، سوف ينفذ الإجراء المخصص بدلا من فتح سجل الكيان (السلوك الافتراضي).

تحسينات عمليات سير إجراءات العمل

تم تحسين سير إجراءات العمل لتوفر التغييرات التالية:

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

  • يمكنك الآن تشغيل إجراءات العمل باستخدام واجهة API جديدة للعميل تسمى Xrm.Utility.invokeProcessAction. تم إصدار إمكانية تشغيل إجراءات العملية من الناحية البرمجية باستخدام واجهة API جديدة للعميل كميزة معاينة في هذا الإصدار.

    • في عميل الويب، يمكن أن تقوم بتشغيل أي إجراء عملية باستخدام واجهة API الجديدة للعميل. مع ذلك، في الواجهة الموحدة، فإن إجراءات العملية تلك المتوفرة للتشغيل كخطوة عملية أعمال هي التي يمكن فقط تشغيلها باستخدام واجهة API الجديدة للعميل.

    • التعرف على تقدم خطوة إجراء العملية وتعيينها باستخدام API جديدة للعميل: getProgress و setProgress. يمكنك الحصول على إحدى حالات تقدم الخطوة التالية وتعيينها باستخدام هذه الأساليب : لا يوجد: 0 أو معالجة: 1 أو مكتمل: 2 أو إخفاق: 3 أو غير صالح: 4. تم إصدار واجهات API الجديدة للعميل هذه كميزة معاينة في هذا الإصدار أيضًا.

    • لا يتم دعم واجهات API للعميل getProgress و setProgress لخطوة بيانات العملية.

  • يمكنك الآن استخدام واجهة API الجديدة على جانب العميل Xrm.Navigation.openTaskFlow لتشغيل سير مهمة.

راجع أيضًا

الجديد في Unified Service Desk للمطورين والمخصصين

دليل المطورين لـ Dynamics 365 Customer Engagement