FileTransform@1 - مهمة تحويل الملف v1

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

بناء الجملة

# File transform v1
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@1
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #enableXmlTransform: false # boolean. XML transformation. Default: false.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. Optional. Use when enableXmlTransform == true. Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
  # Variable Substitution
    #fileType: # 'xml' | 'json'. File format. 
    #targetFiles: # string. Optional. Use when fileType = xml || fileType = json. Target files.

الإدخالات

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

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

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

على سبيل المثال، ⁧$(System.DefaultWorkingDirectory)/**/*.zip⁩.

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

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

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

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

يوفر قائمة مفصولة سطرا جديدا بقواعد ملف التحويل باستخدام بناء الجملة:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - تنسيق الملف
string. القيم المسموح بها: xml، . json

يوفر تنسيق الملف الذي تم تكوين الاستبدال عليه.

بالنسبة إلى XML، ستتم مطابقة المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار مع key الإدخالات أو name في appSettingsأقسام و applicationSettingsو لأي connectionStrings ملف تكوين و parameters.xml. Variable Substitution يتم تشغيله بعد تحويلات التكوين.

لاستبدال متغيرات JSON المتداخلة أو الهرمية، حددها باستخدام تعبيرات JSONPath.

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

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

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

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

targetFiles - الملفات الهدف
string. ‏‏اختياري. استخدم عندما fileType = xml || fileType = json.

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

خيارات التحكم بالمهمة

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

متغيرات الإخراج

لا شيء

الملاحظات

يتوفر إصدار أحدث من هذه المهمة في FileTransform@2.

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	جميع إصدارات العامل المدعومة.
فئة المهمة	الأداة المساعدة