Freigeben über


Komponentenbibliothek Application Lifecycle Management (ALM)

Eine Komponentenbibliothek ist eine spezielle Art von Canvas-App, die eine oder mehrere Canvas-Komponenten enthalten kann. Diese Bibliothekskomponenten können dann von allen anderen Canvas-Apps in der Umgebung verwendet werden. Mit dieser Funktion können Sie wiederverwendbare gemeinsam genutzte Komponenten für alle Apps in einer Umgebung erstellen, im Gegensatz zu Komponenten auf App-Ebene die auf eine App beschränkt sind.

Um eine Komponente aus einer Komponentenbibliothek zu verwenden, müssen Sie die Komponente zuerst in die Canvas-App importieren. Nach dem Import können Sie die Komponente zu jedem App-Bildschirm hinzufügen. Alle Aktualisierungen in der Komponentendefinition aus der Komponentenbibliothek werden Sie auffordern, die Änderung auf Nachfrage zu überprüfen und zu integrieren oder wann die App wird zur Bearbeitung geöffnet wird. Komponentenbibliotheken und abhängige Apps können auch mit Standard Microsoft Dataverse Lösungen in eine andere Umgebung verschoben werden.

Hinweis

In diesem Artikel bezieht sich der Begriff „Importieren“ auf das Importieren einer Komponente aus einer Komponentenbibliothek in eine App und sollte nicht mit dem Importieren einer Lösung in Dataverse verwechselt werden.

Wenn eine Komponente aus einer Komponentenbibliothek in eine Canvas-App importiert wird, wird die Definition dieser Komponente in die Definition der Canvas-App kopiert. Sobald eine Komponentendefinition importiert wurde, ist die App in Bezug auf diese Komponentendefinition „in sich abgeschlossen“. Der App-Hersteller kann die Komponente bearbeiten, und lokale Instanzen der Komponente innerhalb der App erstellen. An dieser Stelle gibt es keinen direkten Link zur Komponentenbibliothek, aus der die Komponente stammt. Diese Eigenständigkeit gilt auch, wenn die Canvas-App anschließend in eine andere Umgebung migriert wird, in der die Komponentenbibliothek nicht vorhanden ist. Sie können weiterhin Instanzen der importierten Komponentendefinition innerhalb der Apps in der Zielumgebung erstellen, und die Apps können weiterhin veröffentlicht und wiedergegeben werden. In diesem Fall werden keine neuen Updates in der verbrauchenden App angefordert oder empfangen.

Um die Beziehung zwischen der App und der Komponentenbibliothek aufrechtzuerhalten, stellen Sie sicher, dass Sie die Komponentenbibliothek verwenden, um Änderungen an der Komponente vorzunehmen, anstatt die Komponente in der konsumierenden App zu bearbeiten.

Unterstützung von Canvas-Apps und Komponentenbibliotheken

Wenn eine Canvas-App eine Canvas-Komponente aus einer Komponentenbibliothek importiert, besteht in Übereinstimmung mit den anderen Abhängigkeiten von Lösungsobjekten eine Abhängigkeit von dieser Komponentenbibliothek. Um eine App in die neue Umgebung zu verschieben, müssen Sie die Komponentenbibliothek entweder in derselben Lösung packen oder als Voraussetzung installieren. Die Abhängigkeit von der App zur Komponentenbibliothek wird in der Zielumgebung beibehalten. Wenn zu einem späteren Zeitpunkt eine Komponentenbibliothek mit der aktualisierten Komponente mithilfe einer Lösung in die Zielumgebung importiert wird, erhalten vorhandene Apps die neuen Komponentendefinitionen mithilfe des regulären Komponentenaktualisierungsflows.

Komponentenbibliothek in einer Lösung erstellen und exportieren

Sie können eine Komponentenbibliothek entweder direkt aus der Lösung heraus erstellen oder sie einer vorhandenen Lösung hinzufügen.

Hinzufügen einer vorhandenen Komponentenbibliothek zu einer Lösung oder einer neuen.

Wenn eine Komponentenbibliothek in einer Umgebung gespeichert wird, in der Dataverse verfügbar ist, wird die Komponentenbibliothek automatisch zur Standardlösung hinzugefügt. Mit dem wird ein eindeutiger logischer Name für die Komponentenbibliothek mit dem Standard-CDS-Publisher Präfix generiert. Dieses Verhalten soll sicherstellen, dass das Lösungssystem sich seiner Anwesenheit bewusst ist und die Abhängigkeiten von den Apps verknüpfen kann, die den logischen Namen der Komponentenbibliothek verwenden.

Hinweis

Komponentenbibliotheken, die vor der Einführung der ALM-Funktion der Komponentenbibliothek erstellt wurden, müssen bearbeitet und veröffentlicht werden, und der Editor muss explizit geschlossen werden, bevor sie für die ALM-Funktionen aktiviert werden. Sie können die ALM-Bereitschaft der Komponentenbibliothek anhand ihres Vorhandenseins in der Standardlösung überprüfen.

Überprüfen Sie die Standardlösung auf das Vorhandensein Ihrer Komponentenbibliothek.

Komponentenbibliotheken innerhalb einer Lösung unterstützen ebenfalls Anpassungen zulassen verwaltete Eigenschaften, die das Verhalten der Komponentenbibliothek in der Zielumgebung steuern.

Verwaltete Eigenschaft „Anpassungen zulassen“ für Komponentenbibliothek.

Wenn Sie diese Einstellung deaktivieren und die Lösung in eine Zielumgebung exportieren, können Sie die Komponentenbibliothek nicht bearbeiten.

Sie können die Komponentenbibliothek, die keine Anpassungen zulässt, nicht bearbeiten.

Komponentenabhängigkeiten

Apps, die Komponenten aus der Komponentenbibliothek verwenden, werden in der Lösungsinfrastruktur als abhängig gekennzeichnet. Dieses Verhalten gilt für alle Apps, die zu jeder Dataverse Lösung in einer bestimmten Umgebung hinzugefügt werden. Sie können weiterhin Apps außerhalb von Lösungen erstellen, aber diese Apps haben keine Lösungsabhängigkeiten. Sie können diese Apps später zu Lösungen hinzufügen, um sie Teil der Lösung ALM zu machen.

Animation, die eine Canvas-App in einer Lösung zeigt, die die Komponente aus der Komponentenbibliothek in derselben Lösung und die Abhängigkeiten für beide verwendet.

Wenn Sie eine Lösung importieren, die nur eine App enthält, die eine Komponente aus einer Komponentenbibliothek verwendet, aber die Komponentenbibliothek ausschließt, wird die folgende Meldung angezeigt:

„Fehler beim Importieren aufgrund fehlender Abhängigkeiten für <app name>“.

In diesem Fall können Sie zuerst die Komponentenbibliothekslösung installieren oder die Komponentenbibliothek mit der Lösung bündeln, die die Canvas-App enthält. Jeder der Schritte würde sicherstellen, dass die App die Abhängigkeit in der Zielumgebung erstellt hat.

Wenn die Bibliothek aktualisiert und eine neuere Komponentenversion über die Lösungen importiert wird, erhält die App eine Benachrichtigung und erhält die Aktualisierungen, wenn die App zur Bearbeitung geöffnet wird.

Hinweis

Wenn die verwaltete Eigenschaft der Komponentenbibliothek Anpassungen zulassen deaktiviert ist, kann die Komponentenbibliothek in der Zielumgebung nicht bearbeitet werden.

Abhängigkeiten werden basierend auf dem zuletzt veröffentlichten Status einer App berechnet. Wenn Sie eine ältere Version der App wiederherstellen, die keine Bibliothekskomponente verwendet, wird die Abhängigkeit von der App und der Lösung entfernt. Das Importieren einer Komponente aus einer Komponentenbibliothek in eine App, ohne sie tatsächlich zu verwenden, schafft auch eine Abhängigkeit, da die nicht verwendete Bibliothekskomponente in der App für eine zukünftige Verwendung verfügbar bleibt.

Tipp

Wenn Sie eine Komponente aus einer Komponentenbibliothek in der verbrauchenden App bearbeiten, wird eine lokale Kopie erstellt. Zu diesem Zeitpunkt ist die Bibliothekskomponente weiterhin für die Verwendung über das Feld Einfügen verfügbar. Um die Abhängigkeit vollständig zu entfernen, löschen Sie die Komponente aus Einfügen > Bibliothekskomponenten > ... (Auslassung) > Aus App entfernen.

Bewährte Verfahren und Problembehebung

  • Begrenzen Sie die Anzahl der Komponenten in einer Bibliothek auf 20, um eine optimale Leistung zu erzielen. Planen und erstellen Sie mehrere Komponentenbibliotheken im Voraus, da die Anzahl der darin enthaltenen Komponenten im Laufe der Zeit wahrscheinlich zunehmen wird. Dieser Ansatz reduziert auch die Nutzlast der Lösung, wenn Apps in der Umgebung verschoben werden.

  • Von der Veröffentlichung der Komponentenbibliothek bis zur Verfügbarkeit für die Anwendung gibt es eine Verzögerung, die bis zu 5 Minuten dauern kann.

  • Wenn die App das Update nicht von der Bibliothekskomponente in der Zielumgebung empfangen kann, in der die Lösung installiert ist, überprüfen Sie dies mit den folgenden Aktionen:

    • Änderungen, die an einer Komponentenbibliothek in einer Zielumgebung vorgenommen werden, befinden sich auf der obersten Ebene einer Komponente. Anschließend definieren diese Anpassungen das Laufzeitverhalten der Komponente. Informationen zum Entfernen dieser nicht verwalteten Anpassungen finden Sie unter Entfernen Sie eine nicht verwaltete Ebene.
    • Ermitteln Sie den logischen Namen der Komponentenbibliothek aus der Lösungsansicht. Verwenden Sie die Standardlösung, wenn die Bibliothek nicht explizit zur Lösung hinzugefügt wird.
    • Laden Sie die App mithilfe der Bibliothekskomponente auf den lokalen Computer mithilfe von Datei > Speichern als > Dieser Computer herunter. Benennen Sie die heruntergeladene Datei in die Erweiterung .zip um und entpacken Sie das Paket. Öffnen Sie die Datei Properties.json, und suchen Sie dann nach dem Schlüsselwort „LibraryDependencies“. Sie sollten einen übereinstimmenden logischen Bibliotheksnamen sehen.
    • Wenn Sie die Lösung verwenden, überprüfen Sie, ob die Canvas-App die Komponentenbibliotheken ordnungsgemäß als Lösungsabhängigkeiten identifiziert hat. Wenn die Lösung die Komponentenbibliotheken nicht ordnungsgemäß als Lösungsabhängigkeiten identifiziert, bedeutet dies, dass die App-Abhängigkeit zum Link der Komponentenbibliothek nicht ordnungsgemäß erstellt wurde. Wenden Sie sich in diesem Fall an den Lösungsanbieter, um das Problem zu beheben.
    • Wenn Sie Lösungsherausgeber sind, überprüfen Sie, ob die Komponentenbibliotheken mit dem logischen Namen der Bibliothek in der Lösung gespeichert werden und dass dieser mit dem identisch ist, auf den im .msapp-Paket der Komponentenbibliothek verwiesen wird.
  • Beim Lösungsexport wird immer die neueste Version der Komponentenbibliothek exportiert. Aktualisieren Sie daher die Apps immer mit der neuesten Komponentenversion, bevor Sie sie über Lösungen exportieren. Diese Aktion stellt sicher, dass die Apps dieselbe Komponentenversion haben, die in der neuesten Version der Komponentenbibliothek verfügbar ist. Apps und Bibliothek gelten als miteinander synchronisiert, wenn sie zum ersten Mal in eine Zielumgebung verschoben werden; Daher werden Sie beim Bearbeiten der App nicht aufgefordert, ein verfügbares Update anzugeben.

Siehe auch

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).