FileTransform@2 - مهمة تحويل الملف v2

استخدم هذه المهمة لاستبدال الرموز المميزة بقيم متغيرة في ملفات تكوين XML أو JSON.

# File transform v2
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@2
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #enableXmlTransform: true # boolean. XML transformation. Default: true.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. Optional. Use when enableXmlTransform == true. XML Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
  # Variable Substitution
    #jsonTargetFiles: # string. JSON target files. 
    #xmlTargetFiles: # string. XML target files.

# File transform v2
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@2
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. XML Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
  # Variable Substitution
    #jsonTargetFiles: # string. JSON target files. 
    #xmlTargetFiles: # string. XML target files.

الحزمة أو المجلد
string. مطلوب. القيمة الافتراضية: $(System.DefaultWorkingDirectory)/**/*.zip.

مسار الملف إلى الحزمة أو المجلد.

المتغيرات هي إنشاء وإصدار . يتم دعم أحرف البدل.

على سبيل المثال، $(System.DefaultWorkingDirectory)/**/*.zip. بالنسبة للمجلدات المضغوطة، يتم استخراج المحتويات إلى موقع TEMP والتحويلات المنفذة والنتائج المضغوطة في موقع البيانات الاصطناعية الأصلي.

تحويل XML
boolean. القيمة الافتراضية: true.

سيتم تشغيل تحويلات التكوين قبل استبدال المتغير.

يتم دعم تحويلات XML للنظام الأساسي ل Windows فقط.

قواعد تحويل XML
string. اختياري. استخدم عند enableXmlTransform == true. القيمة الافتراضية: -transform **\*.Release.config -xml **\*.config.

يوفر قائمة مفصولة بخطوط جديدة لقواعد ملف التحويل باستخدام بناء الجملة: -transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>. مسار ملف النتيجة اختياري، وإذا لم يتم تحديده، استبدال ملف التكوين المصدر بملف النتيجة المحول.

قواعد تحويل XML
string. القيمة الافتراضية: -transform **\*.Release.config -xml **\*.config.

يوفر قائمة مفصولة بخطوط جديدة لقواعد ملف التحويل باستخدام بناء الجملة: -transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>. مسار ملف النتيجة اختياري، وإذا لم يتم تحديده، استبدال ملف التكوين المصدر بملف النتيجة المحول.

ملفات هدف JSON
string.

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

على سبيل المثال، لاستبدال قيمة ConnectionString في العينة أدناه، تحتاج إلى تعريف متغير على أنه Data.DefaultConnection.ConnectionString في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء أو الإصدار (أو بيئة البنية الأساسية لبرنامج ربط العمليات التجارية للإصدار).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

يتم تشغيل استبدال المتغير بعد تحويلات التكوين.

ملاحظة: يتم استخدام المتغيرات المخصصة المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء/الإصدار فقط في الاستبدال. يتم استبعاد متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية المحددة افتراضيا/النظام. إذا تم تعريف نفس المتغيرات في مسار الإصدار وفي المرحلة، فستحل متغيرات المرحلة محل متغيرات مسار الإصدار.

xmlTargetFiles - ملفات XML الهدف
string.

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

بالنسبة إلى XML، ستتم مطابقة المتغيرات المعرفة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء أو الإصدار مقابل إدخالات key أو name في أقسام appSettingsapplicationSettingsconnectionStrings لأي ملف تكوين parameters.xml.

يتم تشغيل استبدال المتغير بعد تحويلات التكوين.

ملاحظة: يتم استخدام المتغيرات المخصصة المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء/الإصدار فقط في الاستبدال. يتم استبعاد متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية المحددة افتراضيا/النظام. إذا تم تعريف نفس المتغيرات في مسار الإصدار وفي المرحلة، فستحل متغيرات المرحلة محل متغيرات مسار الإصدار.

اي.