ALM in Power Platform mit Test Engine (Vorschauversion)

Sie können einen lokalen Editor wie Visual Studio Code verwenden, um die YAML-Dateien zu bearbeiten und die Test Engine-Tests zu erstellen. Um die Test lokal auszuführen:

1. Stellen Sie sicher, dass Microsoft Power Platform CLI installiert ist
2. Wenn Sie die Integration der Quellcodeverwaltung verwenden, klonen Sie Ihr Projekt auf Ihren lokalen Computer
3. Verwenden Sie den pac-Testlauf, um den Test auszuführen
4. Überprüfen Sie die Ergebnisse des Bestehens/Nichtbestehens des Tests

Die Azure CLI ist unerlässlich, um Zugriffstoken für die Verbindung mit Dataverse zu erhalten. Lokal können Sie Folgendes verwenden:

az login --allow-no-subscriptions

Sie können Test Engine problemlos in die integrierten Pipelines von Power Platform integrieren, um eine native integrierte Erfahrung zu erreichen:

• Lösungspipelines: Fügen Sie Ihren Lösungspipelines automatisierte Tests hinzu, um die Qualität in jeder Phase sicherzustellen
• Umgebungsstrategie: Testen Sie in Entwicklungs- und Testumgebungen vor der Höherstufung auf die Produktion
• Pipelinevorlagen: Verwenden Sie Pipelinevorlagen, um Tests in Ihrer Organisation zu standardisieren

Sie können die Ausführung automatisierter Tests auslösen, wenn Sie einen benutzerdefinierten Pipelinehost verwenden:

1. Erstellen Sie einen Power Automate-Cloud-Flow, der anhand von Pipeline-Ereignissen ausgelöst wird
2. Stellen Sie eine Verbindung zu Ihrem CI/CD-System her, um die Tests auszuführen
3. Verarbeiten Sie Testergebnisse und aktualisieren Sie den Pipeline-Status

Das folgende Diagramm zeigt ein Beispiel für dieses Integrationsmuster:

Dieser Flow verwendet:

• Dataverse Trigger, um eine Pipeline zu starten, wenn die Bedingungen erfüllt sind
• Trigger-Bedingungen, um zu bestimmen, welche Bereitstellungsphase gilt
• Einen Azure DevOps-Connector, um einen Build mit Parametern zu starten
• Genehmigungsaktionen, um die Genehmigungsprozesse zu verwalten
• Dataverse-Aktionen, um die Pipeline basierend auf den Ergebnissen zu aktualisieren

Benutzerdefinierte CI/CD-Integration mit Power Automate

Wenn Unternehmen bereits über CI/CD-Tools verfügen, lässt sich Test Engine durch Power Automate mithilfe des Features Benutzerdefinierter Power Platform-Host in benutzerdefinierte Pipelines integrieren. Mit dem Ansatz des benutzerdefinierten Hosts können Sie:

• Einen benutzerdefinierten Pipelinehost festlegen, der Ihre automatisierten Tests ausführt
• Power Automate-Cloud-Flows erstellen, die automatisch aus Bereitstellungsereignissen ausgelöst werden
• pac test run-Befehle direkt aus Cloud-Flows ausführen, um Tests auszuführen, die in der Quellcodeverwaltung gespeichert sind
• Eine Verbindung zu Ihrem bevorzugten CI/CD-System herstellen (Azure DevOps, GitHub Actions usw.)
• Genehmigungsworkflows auf der Grundlage von Testergebnissen implementieren
• Den Bereitstellungsstatus basierend auf den Testergebnissen aktualisieren

Diese Integration ermöglicht es Ihnen, Ihre vorhandenen CI/CD-Investitionen beizubehalten und gleichzeitig die Funktionen von Test Engine zu Ihrem ALM-Prozess hinzuzufügen. Der benutzerdefinierte Host fungiert als Brücke zwischen den nativen ALM-Features von Power Platform und Ihrer externen Testinfrastruktur.

Sie können Ihre Power Platform.Pipeline mit einem benutzerdefinierten Host erweitern oder den Befehl pac test run direkt in die Ausführung Ihrer Build-Skripte integrieren.

Hier ist ein Beispiel für eine Azure DevOps-Pipeline-YAML-Datei, die veranschaulicht, wie Sie Power Apps Test Engine-Tests einrichten und ausführen:

trigger:
- main

pool:
  vmImage: 'windows-latest'

variables:
  - group: PowerPlatformTestVariables # Create a variable group with these variables
  # Required variables in the variable group:
  # ClientId - Service Principal App ID
  # ClientSecret - Service Principal Secret (mark as secret)
  # TenantId - Microsoft Entra Tenant ID
  # EnvironmentUrl - Power Platform Environment URL
  # EnvironmentId - Power Platform Environment ID

steps:
# Download the test plan file from secure files
- task: DownloadSecureFile@1
  name: testPlan
  displayName: 'Download Test Plan File'
  inputs:
    secureFile: 'testplan.te.yaml' # Upload your test plan to Secure Files in Azure DevOps

# Install Power Platform CLI
- task: PowerShell@2
  displayName: 'Install Power Platform CLI'
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "Installing Power Platform CLI..."
      $pacUrl = "https://aka.ms/PowerAppsCLI"
      $pacZip = "$env:TEMP\pac.zip"
      $pacDestination = "$env:TEMP\pac"
      
      # Create the destination folder if it doesn't exist
      if (-not (Test-Path $pacDestination)) {
          New-Item -ItemType Directory -Path $pacDestination -Force | Out-Null
      }
      
      # Download PAC CLI
      Invoke-WebRequest -Uri $pacUrl -OutFile $pacZip
      
      # Extract PAC CLI
      Expand-Archive -Path $pacZip -DestinationPath $pacDestination -Force
      
      # Add PAC CLI to PATH
      $env:PATH = "$pacDestination;$env:PATH"
      
      # Verify installation
      pac help

# Install Azure CLI and authenticate with service principal
- task: PowerShell@2
  displayName: 'Install Azure CLI and Authenticate'
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "Installing Azure CLI..."
      $azureCliUrl = "https://aka.ms/installazurecliwindows"
      $azureCliInstaller = "$env:TEMP\AzureCLI.msi"
      
      # Download Azure CLI installer
      Invoke-WebRequest -Uri $azureCliUrl -OutFile $azureCliInstaller
      
      # Install Azure CLI silently
      Start-Process -FilePath msiexec.exe -Args "/i $azureCliInstaller /quiet /norestart" -Wait
      
      # Reload PATH to include Azure CLI
      $env:PATH = [System.Environment]::GetEnvironmentVariable("PATH", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("PATH", "User")
      
      # Authenticate with service principal
      Write-Host "Authenticating with Azure CLI..."
      az login --service-principal -u "$(ClientId)" -p "$(ClientSecret)" --tenant "$(TenantId)" --allow-no-subscriptions

# Authenticate PAC CLI with service principal
- task: PowerShell@2
  displayName: 'Authenticate PAC CLI'
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "Authenticating PAC CLI..."
      
      # Create authentication profile
      pac auth create --name TestEngineAuth --url "$(EnvironmentUrl)" --applicationId "$(ClientId)" --clientSecret "$(ClientSecret)" --tenant "$(TenantId)"
      
      # Select the authentication profile
      pac auth select --name TestEngineAuth

# Run the tests
- task: PowerShell@2
  displayName: 'Execute Test Engine Tests'
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "Running Test Engine tests..."
      
      # Create output directory
      $outputDir = "$(Build.ArtifactStagingDirectory)\TestResults"
      New-Item -ItemType Directory -Path $outputDir -Force | Out-Null
      
      # Run the tests
      pac test run `
        --test-plan-file "$(testPlan.secureFilePath)" `
        --environment-id "$(EnvironmentId)" `
        --tenant "$(TenantId)" `
        --logConsole info `
        --trx `
        --outputDirectory $outputDir
      
      if ($LASTEXITCODE -ne 0) {
          Write-Error "Test execution failed with exit code $LASTEXITCODE"
          exit $LASTEXITCODE
      }

# Publish test results
- task: PublishTestResults@2
  displayName: 'Publish Test Results'
  inputs:
    testResultsFormat: 'VSTest'
    testResultsFiles: '$(Build.ArtifactStagingDirectory)\TestResults\*.trx'
    mergeTestResults: true
    testRunTitle: 'Power Apps Test Engine Results'
  condition: always() # Ensure results are published even if tests fail

# Publish test artifacts
- task: PublishBuildArtifacts@1
  displayName: 'Publish Test Artifacts'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)\TestResults'
    ArtifactName: 'TestArtifacts'
    publishLocation: 'Container'
  condition: always()

Referenzkomponenten

Die folgenden Referenzkomponenten können beim Erstellen Ihrer Automatisierungstestpipeline hilfreich sein.

Hier ist ein Beispiel für einen GitHub Actions-Workflow, der denselben Testausführungsprozess ausführt:

name: Test Engine Execution

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
  workflow_dispatch:  # Allow manual triggering

jobs:
  test:
    runs-on: windows-latest
    
    env:
      TENANT_ID: ${{ secrets.TENANT_ID }}
      CLIENT_ID: ${{ secrets.CLIENT_ID }}
      CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}
      ENVIRONMENT_URL: ${{ secrets.ENVIRONMENT_URL }}
      ENVIRONMENT_ID: ${{ secrets.ENVIRONMENT_ID }}
    
    steps:
    - name: Checkout repository
      uses: actions/checkout@v3
      
    - name: Install Power Platform CLI
      run: |
        Write-Host "Installing Power Platform CLI..."
        $pacUrl = "https://aka.ms/PowerAppsCLI"
        $pacZip = "$env:TEMP\pac.zip"
        $pacDestination = "$env:TEMP\pac"
        
        # Create the destination folder if it doesn't exist
        if (-not (Test-Path $pacDestination)) {
            New-Item -ItemType Directory -Path $pacDestination -Force | Out-Null
        }
        
        # Download PAC CLI
        Invoke-WebRequest -Uri $pacUrl -OutFile $pacZip
        
        # Extract PAC CLI
        Expand-Archive -Path $pacZip -DestinationPath $pacDestination -Force
        
        # Add PAC CLI to PATH
        $env:PATH = "$pacDestination;$env:PATH"
        echo "$pacDestination" >> $env:GITHUB_PATH
        
        # Verify installation
        pac help

    - name: Install Azure CLI
      run: |
        Write-Host "Installing Azure CLI..."
        $ProgressPreference = 'SilentlyContinue'
        Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi
        Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'
        rm .\AzureCLI.msi
        
    - name: Azure CLI Authentication
      run: |
        Write-Host "Authenticating with Azure CLI..."
        az login --service-principal -u "$env:CLIENT_ID" -p "$env:CLIENT_SECRET" --tenant "$env:TENANT_ID" --allow-no-subscriptions
        
    - name: PAC CLI Authentication
      run: |
        Write-Host "Authenticating PAC CLI..."
        # Create authentication profile
        pac auth create --name TestEngineAuth --url "$env:ENVIRONMENT_URL" --applicationId "$env:CLIENT_ID" --clientSecret "$env:CLIENT_SECRET" --tenant "$env:TENANT_ID"
        
        # Select the authentication profile
        pac auth select --name TestEngineAuth
      
    - name: Run Test Engine tests
      run: |
        Write-Host "Running Test Engine tests..."
        
        # Create output directory
        $outputDir = "./TestResults"
        New-Item -ItemType Directory -Path $outputDir -Force | Out-Null
        
        # Run the tests
        pac test run `
          --test-plan-file "./TestPlan/testplan.te.yaml" `
          --environment-id "$env:ENVIRONMENT_ID" `
          --tenant "$env:TENANT_ID" `
          --logConsole info `
          --trx `
          --outputDirectory $outputDir
        
        if ($LASTEXITCODE -ne 0) {
            Write-Error "Test execution failed with exit code $LASTEXITCODE"
            exit $LASTEXITCODE
        }
    
    - name: Upload test results
      uses: actions/upload-artifact@v3
      if: always()
      with:
        name: test-results
        path: ./TestResults
        
    - name: Publish Test Results
      uses: EnricoMi/publish-unit-test-result-action@v2
      if: always()
      with:
        files: ./TestResults/**/*.trx