FSCPS for Azure DevOps

Overview 🚀

This extension provides Azure DevOps tasks for Dynamics 365 Finance and Operations using FSCPS.

Xpp Build Task

Features and Benefits

• Automated Package Management: You don't need to manage the D365FSC NuGet packages anymore. This extension will do it for you.
• Comprehensive Package Generation: It can generate:
  • LCS Deployable Package
  • Power Platform Unified Package
  • AXmodel file
  • Build logs
• FSCPS Integration: Utilizes fscps.tools for compilation and package generation, offering all its advantages.

How to Use

Here are detailed steps to use this extension in your Azure DevOps pipelines:

0. Prerequisites:

   • Repository hierarchy should be like the following:

     <workspace>/
       ├── Metadata/
       │   ├── Model1/
       │   ├── Model2/
       │   └── Model3/
       └── VSProjects/
           └── Task1_Test/
     

     or

     <workspace>/
       ├── PackagesLocalDirectory/
       │   ├── Model1/
       │   ├── Model2/
       │   └── Model3/
       └── VSProjects/
           └── Task1_Test/
     

1. Install the Extension: After installing the extension in your organization, you can add the "FSCPS - Xpp Build" task to your new or existing build pipelines.

2. Configuration: Make the following configuration changes:

   • Select D365FSC Version: Choose the version of D365FSC you want to use to build your source code.
   • Specify Path: Select the path to your Metadata/PackagesLocalDirectory/SourceCode.

3. Build Artifacts Path:

   • By default, the path to the build artifacts is $(Build.ArtifactStagingDirectory).
   • You can provide a different artifacts path at the Package -> Artifacts Directory setting.

     !!! Important: Ensure that you have correctly set the artifacts path to avoid any build issues.

4. Add Publish Task:

   • Add the "Publish build artifacts" task.
   • Fill the Path to publish field with $(Build.ArtifactStagingDirectory) value.

5. Save and Queue: - Save the pipeline and queue the smoke test to ensure everything is set up correctly.
   And that's it! You've successfully configured the extension in your build pipeline. Feel free to reach out if you have any questions or run into any issues.

Update ISV Task

The "FSCPS - Update ISV" task allows you to update existing D365 models or add a new one into the code repository.

Configuration:

• Metadata Directory: Specify the path to the local Metadata folder.
• Zip URL: Specify the URL/URI to the zip file containing code/package/axmodel.
• Zip File Name: Specify the name of the file to be downloaded from the URL.

Example:

- task: updateisv@0
  inputs:
    metadataPath: '$(Build.SourcesDirectory)'
    url: '$(UrlVar)'
    fileName: '$(NameVar)'

Send Email Task

The "FSCPS - Send Email" task allows you to send an email using SMTP.

Configuration:

• To: Specify the recipient's email addresses, separated by commas.
• Cc: Specify the CC email addresses, separated by commas.
• Subject: Specify the email subject.
• Body: Specify the email body.
• Attachments: Specify the paths to attachments, separated by semicolons.
• SmtpServer: Specify the SMTP server address.
• SmtpPort: Specify the SMTP server port.
• SmtpUsername: Specify the username for SMTP authentication.
• SmtpPassword: Specify the password for SMTP authentication.
• Secure: Specify whether to use a secure connection (true/false).
• From: Specify the sender's email address.

Example:

- task: sendemail@0
  inputs:
    To: 'user@example.com'
    Cc: 'ccuser@example.com'
    Subject: 'Build Notification'
    Body: 'The build has completed successfully.'
    Attachments: 'path1;path2;path3'
    SmtpServer: 'smtp.example.com'
    SmtpPort: '587'
    SmtpUsername: 'your-username'
    SmtpPassword: 'your-password'
    Secure: true
    From: 'noreply@example.com'