Freigeben über

Schnellstart: Erstellen eines Power Platform Tools-Projekts

  • Artikel

Wie bei jeder Visual Studio-Lösung erstellen Sie zunächst ein neues Projekt. Geben Sie im neuen Projektdialog „Power Platform“ in das Suchfeld ein. Eine Liste der verfügbaren Power Platform Tools-Projekt-C#-Vorlagen wird im Abschnitt Verfügbare Projektvorlagen beschrieben.

Anforderungen

  • Visual Studio 2019 oder 2022
  • Power Platform Tools für Visual Studio
  • C#-Sprache
  • .NET Framework 4.6.2 oder später (Plug-In- und benutzerdefinierte Workflowaktivitätsentwicklung erfordert v4.6.2)
  • Power Apps-Abonnement oder eine Testumgebung
  • Windows Workflow Foundation (nur für benutzerdefinierte Workflowaktivitätsentwicklung)

Wenn Sie Power Platform Tools für Visual Studio nicht installiert haben, installieren Sie es, indem Sie den Anweisungen hier folgen: Power Platform Tools

Sie können Windows Workflow Foundation über die Visual Studio Installationsanwendung installieren, indem Sie Ändern und dann die einzelnen Komponenten wie in der nächsten Abbildung gezeigt auswählen. Ein alternativer Ansatz besteht darin, einen Workload zu installieren, der diese Komponente enthält.

Die Windows Workflow Foundation-Komponente hinzufügen

Verfügbare Projektvorlagen

Die folgende Tabelle stellt die verfügbaren Power Platform Tools-Projektvorlagen vor.

C#-Projektvorlage Beschreibung
Power Platform-Lösungsvorlage Lösungsvorlage zum Erstellen einer Power Platform-Lösung. Diese Vorlage ist für eine Visual Studio-Lösung und nicht eine Microsoft Dataverse-Lösung.
Power Platform-Plug-In-Bibliothek Projektvorlage zum Erstellen einer Power Platform-Plug-In-Klassenbibliothek und -Assembly (DLL).
Power Platform-Paket Projektvorlage zum Erstellen eines Power Platform-Pakets (CrmPackage). Das Paket wird verwendet, um die Lösung und benutzerdefinierte Codebibliotheken in einer Dataverse-Umgebung bereitzustellen.
Power Platform-Workflowaktivitätsbibliothek Projektvorlage zum Erstellen einer benutzerdefinierten Power Platform-Workflowaktivitäts-Klassenbibliothek und -Assembly (DLL).
Anpassungsprojekt Projektvorlage für alle Anpassungen einer Power Platform-Lösung (Dataverse).

Verwenden Sie die Power Platform-Lösungsvorlage

Die Power Platform-Lösungsvorlage ist ein guter Ausgangspunkt für jede neue Lösung. Sie können Projekte zu der Lösung hinzufügen und daraus entfernen. Sie sollten das CrmPackage-Projekt jedoch nicht entfernen. Dies führt dazu, dass die Bereitstellung der Power Platform-Lösung für die Zielumgebung scheitert.

Wichtig

Eine Power Platform-Lösung darf nur ein einziges CrmPackage-Projekt enthalten. Sonst schlägt die Bereitstellung der Dataverse-Lösung fehl.

Die Projektvorlagen der Plug-In-Bibliothek und der Workflow-Bibliothek werden normalerweise für fortgeschrittenere Szenarios verwendet. Beispielsweise, wenn Sie einer Power Platform-Lösung mehrere benutzerdefinierte Code-Assemblys hinzufügen möchten oder nur an der Entwicklung dieser bestimmten benutzerdefinierten Codekomponente interessiert sind. Bevor Sie eine Lösung bereitstellen können, die nur ein Projekt dieser Typen enthält, müssen Sie ein CrmPackage-Projekt zur Visual Studio-Lösung hinzufügen.

Der einfache Weg, eine Power Platform-Lösung zu erstellen, die ein CrmPackage-Projekt und optional ein Plug-In und/oder Workflowaktivitätsprojekt enthält, ist die Verwendung der Power Platform-Lösungsvorlage. Gehen Sie wie folgt vor, um diese Lösung zu erstellen.

  1. Suchen Sie in dem neuen Visual Studio-Projektdialog Power Platform-Lösungsvorlage und wählen Sie sie aus. Wählen Sie dann Weiter.

  2. Geben Sie die angeforderten Projektinformationen ein, wählen Sie eine .NET Framework-Version und dann Erstellen aus.

    Bei diesem zeigen sollte entweder ein Dataverse Anmeldedialogfeld oder ein Dialogfeld zur Wiederverwendung Ihrer letzten Dataverse Verbindung angezeigt werden. Tun Sie alles, was angemessen ist, um eine Verbindung zu Ihrer Dataverse-Entwicklungsumgebung zu erstellen. Entwickeln Sie niemals Code in einer Produktionsumgebung.

  3. Wählen Sie beim Dialog Microsoft Power Platform-Lösung konfigurieren entweder eine vorhandene Dataverse-Lösung aus oder erstellen Sie eine neue Lösung.

    Je nachdem, was Sie ausgewählt haben, werden Sie aufgefordert, Informationen zur neuen Lösung oder Auswählen zur vorhandenen Lösung aus einer Dropdown-Liste einzugeben. Schritt 3 Auswählen Lösung wird angezeigt, ist aber erst aktiv, wenn Sie angemeldet sind und in Schritt 2 Weiter wählen.

  4. Sobald die Power Platform-Ziellösung identifiziert oder erstellt wurde, geben Sie vorhandene Elemente an oder erstellen Sie neue Projekte (Schritt 1) mit einer der oben genannten Power Platform-Projektvorlagen.

    Nachdem Sie ein neues Element ausgewählt haben, wird das Dialogfeld erweitert und zeigt Schritt 2 an. Hier können Sie (nur) eines der verfügbaren Projekte auswählen, um es zu Ihrer Lösung hinzuzufügen. Wählen (markieren) Sie ein oder mehrere Projekte aus der Liste und wählen Sie Weiter. Schritt 3 wird angezeigt, ist aber nicht aktiv, bis Sie mit Schritt 2 fertig sind und Weiter wählen.

  5. Geben Sie in Schritt 3 des Dialogs Namen für Ihre ausgewählten Projekte ein und wählen Sie Fertig.

    Wählen Sie Namen aus, die Sie als Projektnamen im Visual Studio Lösungs-Explorer sehen möchten.

  6. Sie werden aufgefordert, die Lösungsdatei zu speichern. Wählen Sie Speichern aus, um die Visual Studio-Lösung zu speichern.

Im Projektmappenexplorer sollten Sie nun eine Lösung sehen, die ein einzelnes CrmPackage-Projekt und ein oder mehrere Projekte basierend auf den von Ihnen ausgewählten Projektvorlagen enthält. Jedes Projekt einer Plugin- oder benutzerdefinierten Workflow-Aktivitätsklassenbibliothek erstellt eine Assembly. Sie können jeder Klassenbibliothek weitere Klassen hinzufügen, indem Sie nach Wunsch ein neues oder vorhandenes Element mit den Power Platform-Projektvorlagen hinzufügen.

Projekte verwalten

Die folgenden Verfahren beschreiben einige gängige Vorgänge für Ihre Visual Studio-Lösung.

Ein neues Projekt einer Power Platform-Lösung hinzufügen

Nur Projekte, die mit einer Power Platform Tools-Vorlage erstellt wurden, sollten zu einer Lösung hinzugefügt werden, die mit der Power Platform Tools-Lösungsvorlage erstellt wurden. Um einer Lösung ein neues Projekt hinzuzufügen, gehen Sie folgendermaßen vor.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Lösung, wählen Sie Hinzufügen und dann Neues Projekt.

  2. Wählen Sie eine der installierten Power Platform Tools-Vorlagen und wählen Sie Weiter.

  3. Geben Sie alle erforderlichen Informationen ein, und wählen Sie Erstellen aus. Wählen Sie für ein Plug-In oder eine Workflowaktivitätsbibliothek unbedingt .NET Framework 4.6.2 aus.

Ein vorhandenes Projekt zu einer Power Platform-Lösung hinzufügen

Nur Projekte, die mit Power Platform Tools-Vorlagen erstellt wurden, sollten zu einer Lösung hinzugefügt werden, die mit der Power Platform Tools-Lösungsvorlage erstellt wurden.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Lösung, wählen Sie Hinzufügen und dann Vorhandenes Projekt.

  2. Navigieren Sie zur .csprog-Datei des Zielprojekts, wählen Sie sie aus und wählen Sie Öffnen.

  3. Klicken Sie im Projektmappen-Explorer unter dem CrmPackage-Projekt mit der rechten Maustaste auf Referenzen und dann Referenz hinzufügen.

  4. Wählen Sie in der Registerkarte Projekte des Dialogs Referenz hinzufügen das (hinzuzufügende) Projekte aus der Liste aus und wählen Sie dann Hinzufügen um sie zur Liste der ausgewählten Projekte und Komponenten hinzuzufügen.

  5. Wählen Sie OK, um die Projekte zur Projektmappe hinzuzufügen und das Dialogfeld Referenz hinzufügen zu schließen.

Ein Projekt aus einer Power Platform-Lösung entfernen

  1. Klicken Sie im Projektmappenexplorer mit der rechten Maustaste auf das Projekt und wählen Sie Entfernen aus. Das Projekt wird automatisch aus den CrmPackage-Referenzen entfernt.

  2. Bearbeiten Sie die XML-Datei RegisterFile.crmregister im CrmPackage-Projekt und entfernen Sie alle XML-Registrierungscodes, die sich auf das gerade entfernte Projekt beziehen.

  3. Entfernen Sie alle bereitgestellten Assemblys und Schritte Ihres Projekts aus der Dataverse-Umgebung und -Lösung.

    Wenn Sie ein Plug-In oder ein Workflowaktivität-Bibliotheksprojekt aus der Visual Studio Lösung entfernt haben, möchten Sie möglicherweise auch alle zugehörigen Assemblys und Schritte aus Dataverse Umgebung und der Lösung entfernen. Sie können diese Komponenten im Power Platform Explorer entfernen, indem Sie den Plug-In-Assemblys-Knoten Ihrer Umgebungsstruktur erweitern, mit der rechten Maustaste auf die Ziel-Assembly klicken und Assembly löschen auswählen. Dadurch werden die Assembly und alle registrierten Schritte gelöscht.

    Wichtig

    Ihr Dataverse-Anmeldekonto muss Besitzer der bereitgestellten Assembly sein oder Löschzugriff darauf haben, damit Sie sie aus der Umgebung löschen können.

Siehe auch

Schnellstart: Erstellen eines Plug-Ins mit Power Platform Tools