Anhang: Hinzufügen von Lizenzierungsinformationen zu Ihrer Lösung

Dieser Artikel bezieht sich auf die Lizenzverwaltungsfunktion, die Microsoft ISVs die Verwaltung und Durchsetzung von Lizenzen für ihre Produkte ermöglicht. Weitere Informationen: ISV-App-Lizenzverwaltung

Dieser Artikel beschreibt, wie Sie einer Microsoft Dataverse-Lösung Lizenzierungsinformationen hinzufügen, sie verpacken und die Zip-Datei der Lösung auf Microsoft AppSource hochladen. Weitere Informationen: Schritt 3: Erstellen Sie ein AppSource-Paket für Ihre App.

Die folgenden Schritte sind erforderlich, um Lizenzinformationen zu Ihrer Lösung hinzuzufügen:

• Vorhandene Lösung klonen.
• Verwenden Sie die Microsoft Power Platform-CLI, um der Lösung Lizenzinformationen hinzuzufügen.
• Bauen Sie die Lösung, verpacken Sie sie und laden Sie die Zip-Datei auf AppSource hoch.

Herunterladen der aktuellen Version der Microsoft Power Platform-CLI

In diesem Artikel erfahren Sie, wie Sie die Power Platform-CLI herunterladen: Was ist die Microsoft Power Platform CLI?.

Das Microsoft Power Platform CLI-Tool enthält den Befehl pac solution add-license zum Hinzufügen von Lizenzierungsinformationen zur Lösung.

Eine Lösung klonen

Verwenden Sie Microsoft Power Platform CLI-Befehle, um die Lösung zu klonen. So klonen Sie eine Lösung:

1. Erstellen Sie ein Authentifizierungsprofil für die Umgebung, in der Sie Ihre Lösung hinzufügen möchten, indem Sie den Befehl pac auth create verwenden:

    pac auth create --name <name of your choice> --kind Dataverse -–url <your dataverse url> --username <your username> --password <your password>`
   

2. Klonen Sie die vorhandene Lösung mit dem Befehl pac solution clone:

   pac solution clone --name <your solution name> --outputDirectory <your chosen output directory>
   

Sie sollten jetzt ein Lösungsprojekt im angegebenen Ausgabeordner haben.

Lizenzierungsdateien erstellen

Um Ihrer Lösung Lizenzierungsinformationen hinzuzufügen, müssen Sie zwei .CSV-Dateien mit einem Texteditor Ihrer Wahl erstellen. Im Folgenden sind die beiden Dateien aufgeführt, die Sie erstellen müssen:

• Plandefinitionsdatei: Definieren Sie die Details der Pläne, die Sie in Partner Center erstellt haben.
• Plan-Datei Zuordnung: Ordnet diese Pläne den Komponenten Ihrer Lösung zu.

In diesem Artikel werden wir diese beiden CSV-Dateien für eine Beispiellösung namens F365 erstellen. Diese Lösung enthält mehrere modellgesteuerte Apps, für die wir den Zugriff über die Lizenzverwaltung einschränken wollen. Wir werden ein Russische Puppe Lizenzierungsmodell für diese Lösung verwenden, wie in der folgenden Tabelle gezeigt:

Plan	Ermöglicht den Zugriff auf
Gold-Plan	Gold-Plan, Silber-Plan, Bronze-Plan
Silber-Plan	Silber-App, Bronze-App
Bronze-Plan	Bronze-App

Um Lizenzierungsinformationen zu Ihrer Lösung hinzuzufügen, müssen Sie Pläne im Partner Center erstellen. Mehr Informationen: Pläne im Partner Center erstellen.

Wenn Sie mit dem Erstellen der Pläne fertig sind, erzeugt jeder Plan einen Service ID-Wert, der beim Erstellen der Plan-Definitionsdatei benötigt wird.

Anmerkung

Derzeit sind modellgesteuerte Anwendungen die einzigen Typen von Lösungskomponenten, die Lizenzen zugeordnet werden können. In zukünftigen Versionen planen wir, Unterstützung für andere Komponententypen wie Canvas-Apps und Tabellen hinzuzufügen.

Plan-Definitionsdatei

Die Plan-Definitionsdatei muss die folgenden Spalten enthalten, die in dem im folgenden Beispiel gezeigten Format angeordnet sind:

Service-ID: Diese wird automatisch erstellt, wenn Sie im Rahmen der Angebotserstellung einen Plan im Partner Center anlegen. Kopieren Sie sie aus der Partnerzentrale in die Plan-Definitionsdatei. Mehr Informationen: Pläne im Partner Center erstellen.

Anzeigename: Dies ist ein beschreibender Name für Ihren Plan, den Sie wählen können. Es wird den Benutzenden auf den Fehlerbildschirmen der Lizenzprüfung angezeigt, sodass es für Ihre Kundschaft leicht erkennbar sein sollte.

URL für weitere Informationen: Dies ist eine URL, an die Sie Benutzer weiterleiten möchten, um weitere Informationen zu Ihrer Lösung zu erhalten, für den Fall, dass bei der Lizenzprüfung ein Fehler auftritt.

Plan-Zuordnungsdatei

Die Plan-Zuordnungsdatei muss die folgenden Spalten enthalten, die in dem im folgenden Beispiel gezeigten Format angeordnet sind:

Service-ID: Diese wird automatisch erstellt, wenn Sie im Rahmen der Angebotserstellung einen Plan im Partner Center anlegen. Kopieren Sie sie aus der Partnerzentrale in die Plan-Definitionsdatei. Mehr Informationen: Pläne im Partner Center erstellen.

Komponentenname: Die Lösungskomponente, auf die Sie den Zugriff mithilfe der Lizenzverwaltung beschränken möchten. Dieser Name muss mit dem Namen der Komponente in der Spalte Name im Power Apps-Lösungsbetrachter (Bild oben) übereinstimmen.

Sobald Sie Ihre eigenen Lizenzierungs-CSV-Dateien erstellt haben, besteht der nächste Schritt darin, die Informationen aus diesen Dateien in Ihre Lösung einzufügen.

Lizenzierungsinformationen hinzufügen

Um die Lizenzinformationen aus den (oben erstellten) CSV-Dateien zur Lösung hinzuzufügen:

1. Navigieren Sie mithilfe eines Befehlsfensters an den Speicherort, an dem Sie die Lösung geklont haben. Verwenden Sie den Befehl pac solution add-license:

   pac solution add-license -pd <path to plan definition file> -pm <path to plan mapping file>
   

2. Um zu überprüfen, ob die Lizenzierungsinformationen hinzugefügt wurden, navigieren Sie zu dem Ort, an dem Sie die Zip-Datei Ihrer Lösung geklont haben. Sie sollten sehen, dass ein neuer Ordner ServicePlans mit zwei XML-Dateien erstellt wurde.

3. Optional: Um festzustellen, wie die Lizenzinformationen aus den CSV-Dateien erfasst wurden, öffnen Sie die XML-Dateien in Ihrem bevorzugten Editor.

   • Die Datei ServicePlans.xml enthält die Plan-Definitionsinformationen aus der Plan-Definitionsdatei.
   • Die Datei ServicePlansAppModules.xml enthält die Plan-Zuordnungsinformationen aus der Plan-Zuordnungsdatei.

Erstellen Sie die Lösung und erstellen Sie ein AppSource-Paket

1. Führen Sie den unten gezeigten MSBuild-Befehl aus dem Projektordner aus, um die Lösungs-ZIP-Datei zu erstellen. MSBuild ist in Visual Studio-Installationen enthalten.

   msbuild /t:build /restore -p:Configuration=Release
   

   Die entstandene Lösungs-ZIP-Datei befindet sich im bin/Release-Ordner des Projekts.

2. Um zu überprüfen, ob die Lizenzierungsinformationen enthalten sind, suchen Sie nach der Erstellung der Projektmappe nach den Lizenzierungsinformationen in Ihrer Projektmappen-customizations.xml-Datei.

3. Importieren Sie die nicht verwaltete Lösung, die Sie gerade erstellt haben, in eine Umgebung und exportieren Sie sie dann als verwaltete Lösung.

   Sie können die importierte Lösung anschließend aus der Umgebung löschen, da sie nicht mehr benötigt wird. Weitere Informationen: Lösungen importieren, Lösungen exportieren

4. Informationen zum Erstellen des AppSource-Pakets finden Sie unter Schritt 3: Erstellen eines AppSource-Pakets für Ihre App.

Siehe auch

Schritt 2: Erstellen Sie ein verwaltete Lösung für Ihre App
Anhang: Checkliste zur App-Zertifizierung