ملء مراجع الاتصال ومتغيرات البيئة مسبقًا لعمليات النشر التي يتم تنفيذها تلقائيًا

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

مزيد من المعلومات:

• نظرة عامة على مراجع الاتصال
• نظرة عامة حول متغيرات البيئة

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

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

ملف إعدادات النشر

لإجراء تعبئة مسبقة لمعلومات مراجع الاتصال ومتغيرات البيئة لعملية النشر، استخدام ملف إعدادات النشر (JSON) لتخزين المعلومات، ثم قم تمريره كمعلمة عند استيراد الحل باستخدام Power Platform Build Tools. يمكنك تخزين ملف JSON في نظام التحكم المصدر لتحديثه وإدارته كما هو مطلوب لمؤسستك.

وفيما يلي مثال عن ملف إعدادات النشر:

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": ""
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": ""
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

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

الخطوة 1: إنشاء ملف إعدادات النشر

يمكن إنشاء ملف إعدادات النشر باستخدام Power Platform CLI. يمكنك إنشاء الملف أثناء تصدير الحل أو استنساخه.

الخيار 1: إنشاء ملف إعدادات النشر باستخدام خاصية create-settings

استخدم الخاصية create-settings مع Power Platform CLI:

C:\> pac solution create-settings --solution-zip <solution_zip_file_path> --settings-file <settings_file_name>

سيتولى هذا الأمر إنشاء ملف JSON كما هو موضح أدناه.

في ملف JSON، هناك قيم قليلة فارغة في المقطع ConnectionReferences. و يجب تجميع هذه القيم بعد إنشائها في البيئة الهدف.

الخيار 2: إنشاء ملف إعدادات النشر عن طريق استنساخ الحل

يلزم استنساخ حل مشروع لهذه الخطوة لأنه يعرض الحل الأصلي بتنسيق قابل للبناء. بعد استنساخ حل باستخدام Power Platform CLI، ستحصل على بنية الدليل التالية التي تم إنشاؤها على الكمبيوتر.

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

الخطوة 2: الحصول على معلومات مرجع الاتصال ومتغيرات البيئة

لتعبئة ملف إعدادات النشر، ستحتاج إلى الحصول على معلومات حول مراجع الاتصال ومتغيرات البيئة للحل الهدف.

الحصول على معلومات مراجع الاتصال

للحصول على معرف لاتصال للبيئة الهدف، استخدم إحدى الطرق التالية:

• سجل دخولك إلى Power Apps وحدد بيئتك الهدف. في جزء التنقل الأيسر، حدد بيانات>اتصالات، وحدد الاتصال الذي ترغب في الحصول على معرف لاتصال به ثم انظر إلى عنوان URL للحصول على معرف الاتصال.

  

• أنشئ تطبيق لوحة على الكيان المرجعي للاتصال. الخطوات هي على الشكل التالي:

  1. سجل دخولك إلى Power Apps وحدد بيئتك الهدف.

  2. في جزء التنقل الأيسر، حدد التطبيقات، ثم حدد تطبيق جديد>لوحة.

  3. حدد Dataverse كمصدر بياناتك.

     

  4. حدد جدول مراجع الاتصال وحدد اتصال.

     

  5. سيؤدي ذلك إلى إنشاء تطبيق معرض سيسرد كافة الاتصالات ومعرفات الاتصال الخاصة بها ضمن البيئة.

     

الحصول على معلومات حول متغيرات البيئة

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

وإلا، يمكنك توفير القيمة المناسبة للبيئة الهدف بالاستناد إلى معرفتك بالبيئة الهدف.

الخطوة 3: تحديث القيم في ملف إعدادات النشر

قم بتحرير ملف إعدادات النشر (JSON) يدويًا لإضافة معلومات الاتصال ومتغيرات البيئة بشكل ملائم. وفيما يلي مثال عن ملف إعدادات مع إضافة القيم المفقودة (سابقًا).

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": "Test"
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": "UAT"
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "4445162937b84457a3465d2f0c2cab7e",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "ef3d1cbb2c3b4e7987e02486584689d3",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "74e578ccc24846729f32fcee83b630de",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "d8beb0fb533442c6aee5c18ae164f13d",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

الخطوة 4: استخدام ملف إعدادات النشر لمهام Build Tools

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

عند استخدام استيراد مهمة الحل في Power Platform Build Tools، حدد استخدام ملف إعدادات النشر ووفر المسار إلى ملف إعدادات النشر. بعد ذلك، ابدأ تشغيل المسار.

التحقق من الصحة

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

(راجع أيضًا)

ما هو Microsoft Power Platform CLI؟
مهام Microsoft Power Platform Build Tools