Verpacken einer Codekomponente

In diesem Artikel wird das Importieren von Codekomponenten in Microsoft Dataverse beschrieben. Nach der Implementierung der Codekomponenten mit der Microsoft Power Platform-CLI besteht werden im nächsten Schritt alle Codekomponentenelemente in einer Lösungsdatei gebündelt und die Lösungsdatei in Dataverse importiert, damit Sie die Codekomponenten zur Laufzeit sehen können.

So erstellen und importieren Sie eine Lösungsdatei:

  1. Erstellen Sie einen neuen Ordner im Beispielkomponentenordner und nennen Sie ihn Lösungen (oder einen anderen Namen Ihrer Wahl) mit dem Befehl mkdir Solutions. Navigieren Sie mit dem Befehl cd Solutions in das Verzeichnis.

  2. Erstellen Sie ein neues Lösungsprojekt mit dem pac solution init-Befehl. Das Lösungsprojekt wird für das Bündeln einer Codekomponente in einer ZIP-Datei der Lösung verwendet, die zum Importieren nach Dataverse verwendet wird.

    pac solution init --publisher-name developer --publisher-prefix dev
    

    Hinweis

    Die publisher-name- und publisher-prefix-Werte müssen in Ihrer Umgebung eindeutig sein.

  3. Sobald das neue Lösungsprojekt erstellt ist, verweisen Sie den Ordner Lösungen an den Speicherort, an dem sich die erstellte Beispielkomponente befindet. Sie können die Referenz hinzufügen, indem Sie den pac solution add-reference-Befehl verwenden. Dieser Verweis informiert das Lösungsprojekt darüber, welche Codekomponenten beim Build hinzugefügt werden sollen. Sie können Verweise auf mehrere Komponenten in einem einzelnen Lösungsprojekt hinzufügen.

     pac solution add-reference --path c:\downloads\mysamplecomponent
    
  4. Um eine ZIP-Datei aus Ihrem Lösungsprojekt zu erstellen, wechseln Sie zum Lösungsprojektverzeichnis und erstellen das Projekt mithilfe des folgenden Befehls. Dieser Befehl verwendet MSBuild, um das Lösungsprojekt zu erstellen, indem er die Abhängigkeiten NuGet als Teil der Wiederherstellung herunterfährt. Verwenden Sie das /restore nur beim ersten Mal, wenn das Lösungsprojekt erstellt wird. Für jeden weiteren Build können Sie danach den Befehl msbuild ausführen.

    msbuild /t:build /restore
    

    Tipp

    • Wenn msbuild 15.9.* nicht der Pfad ist, öffnen Sie die Entwicklereingabeaufforderung für VS 2017, um den Befehl msbuild auszuführen.
    • Das Erstellen der Lösung in der Debugging-Konfiguration generiert ein nicht verwaltetes Lösungspaket. Ein verwaltetes Lösungspaket wird erstellt, indem Sie die Lösung in der Versionskonfiguration erstellen. Diese Einstellungen können außer Kraft gesetzt werden, indem die SolutionPackageType-Eigenschaft in der cdsproj-Datei angegeben wird.
    • Sie können die msbuild-Konfiguration auf Release setzen, um einen Produktionsbuild auszugeben. Beispiel: msbuild /p:configuration=Release
    • Wenn die Fehlermeldung Mehrdeutiger Projektname beim Ausführen des Befehls msbuild für Ihre Lösung angezeigt wird, stellen Sie sicher, dass Ihr Lösungsname und Projektname nicht identisch sind.
  5. Die erzeugten Lösungsdateien befinden sich nach erfolgreicher Erstellung im Ordner \bin\debug\.

  6. Importieren Sie die Lösung in Dataverse manuell über das Webportal oder automatisch über die Microsoft Power Platform Build Tools.

Verbindung mit der Umgebung

Sie können die Codekomponenten direkt über die Microsoft Power Platform-CLI bereitstellen, indem Sie eine Verbindung mit der Dataverse-Umgebung herstellen und die aktualisierten Komponenten verschieben.

Mit den folgenden Schritten können Sie das Authentifizierungsprofil erstellen, eine Verbindung zu Dataverse herstellen und die aktualisierten Komponenten übertragen.

  1. Erstellen Sie Ihr Authentifizierungsprofil mit dem Befehl pac auth create.

    pac auth create --url https://xyz.crm.dynamics.com 
    
  2. Wenn Sie zuvor ein Authentifizierungsprofil erstellt haben, können Sie mit dem pac auth list-Befehl alle vorhandenen Profile anzeigen:

     pac auth list 
    
  3. Um zwischen den zuvor erstellten Authentifizierungsprofilen zu wechseln, verwenden Sie den pac auth select-Befehl:

     pac auth select --index <index of the active profile>
    
  4. Verwenden Sie den pac org who-Befehl, um die grundlegenden Informationen zur Umgebung abzurufen. Die Verbindung wird mit Hilfe des Standardauthentifizierungsprofils hergestellt.

    pac org who 
    
  5. Um ein bestimmtes Authentifizierungsprofil zu löschen, verwenden Sie den pac auth delete-Befehl pac auth delete --index <index of the profile>.

  6. Wenn Sie alle Authentifizierungsprofile von Ihrem lokalen Computer löschen möchten, verwenden Sie den pac auth clear-Befehl. Diese Aktion ist irreversibel, da sie die Datei authprofile.json und die Token-Cachedatei auf Ihrem lokalen Computer endgültig löscht.

Bereitstellung von Codekomponenten

Nachdem Sie erfolgreich ein Authentifizierungsprofil erstellt haben, können Sie die Codekomponenten mit den neuesten Änderungen an die Dataverse-Instanz übertragen.

Die push-Funktion beschleunigt die Inner-Entwicklerzyklusentwicklung, da sie die Codekomponenten-Versionsverwaltungsanforderungen umgeht und nicht erfordert, dass Sie die Lösung (cdsproj) erstellen, um die Codekomponente zu importieren.

Um die push-Funktion zu verwenden, führen Sie Folgendes durch:

  1. Stellen Sie sicher, dass Sie ein gültiges Authentifizierungsprofil erstellt haben.

  2. Gehen Sie zu dem Verzeichnis, in dem sich die Beispielkomponentendatei befindet.

  3. Führen Sie den pac pcf push-Befehl aus.

    pac pcf push --publisher-prefix <your publisher prefix>
    

    Hinweis

    Das Publisher-Präfix, das Sie mit dem Befehl push verwenden, sollte mit dem Publisher-Präfix Ihrer Lösung übereinstimmen, in dem die Komponenten enthalten sein werden.

Entfernen von Komponenten aus einer Lösung

Wenn Sie eine Codekomponente aus einer Lösungsdatei entfernen möchten:

  1. Bearbeiten Sie die Datei cdsproj im Projektverzeichnis der Lösung und entfernen Sie die Referenzen auf die Komponente. Hier finden Sie ein Beispiel für einen Komponentenverweis:

    <ItemGroup>
        <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
          <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
          <Name>pcf_component</Name>
          <Targets>Build</Targets>
          <referenceOutputAssembly>false</referenceOutputAssembly>
          <OutputItemType>Content</OutputItemType>
          <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        </Projectreference>
    </ItemGroup>
    
  2. Führen Sie eine Neuerstellung (oder Bereinigung) durch, indem Sie den folgenden Befehl verwenden:

    msbuild /t:rebuild
    

Siehe auch

Hinzufügen von Code-Komponenten zu einer Spalte oder Tabelle in modellbasierten Apps
Hinzufügen von Komponenten zu einer Canvas-App
Power Apps component framework-API-Referenz
Übersicht über das Power Apps component framework
Microsoft Power Platform CLI-Befehlsgruppen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).