Codekomponenten für Canvas-Apps

Professionelle Entwickler können das Power Apps-Komponentenframework verwenden, um Codekomponenten zu erstellen, die sie in ihren Canvas-Apps verwenden können. Weitere Informationen finden Sie in der Übersicht über das Power Apps-Komponentenframework.

App erstellende Personen können das Power Apps component framework für das Erstellen, Importieren und Hinzufügen von Codekomponenten zu Canvas-Apps mithilfe der Microsoft Power Platform CLI nutzen. Bestimmte APIs sind in Canvas-Apps möglicherweise nicht verfügbar. Überprüfen Sie jede API, um zu ermitteln, wo sie verfügbar ist.

Sicherheitsaspekte

Warnung

Codekomponenten enthalten Code, den Microsoft nicht generiert hat und beim Rendern in Power Apps Studio potenziell auf Sicherheitstoken und Daten zugreifen kann. Stellen Sie beim Hinzufügen von Codekomponenten zu einer Canvas-App sicher, dass Sie die Codekomponentenlösungen aus einer vertrauenswürdigen Quelle abrufen. Diese Sicherheitsanfälligkeit besteht beim Ausführen der Canvas-App nicht.

Wenn Sie in Power Apps Studio eine Canvas-App öffnen, die Codekomponenten enthält, wird eine Warnmeldung zu potenziell unsicherem Code angezeigt. Codekomponenten in der Power Apps Studio-Umgebung haben Zugriff auf Sicherheitstoken, sodass nur Komponenten aus vertrauenswürdigen Quellen geöffnet werden. Administratoren und Systemanpasser sollten alle Codekomponenten überprüfen und validieren, bevor sie diese Komponenten in eine Umgebung importieren und sie Herstellern zur Verwendung in ihren Apps zur Verfügung stellen. Der Default Herausgeber wird angezeigt, wenn Sie Codekomponenten mithilfe einer nicht verwalteten Lösung importieren oder wenn Sie pac pcf push verwenden, um Ihre Codekomponente zu installieren.

Voraussetzungen

• Eine Power Apps-Lizenz ist erforderlich. Weitere Informationen finden Sie unter Power Apps-Komponentenframeworklizenzierung.
• Es sind Systemadministratorrechte erforderlich, um die Power Apps Component Framework-Funktion in der Umgebung zu aktivieren.

Aktivieren Sie die Power Apps Component Framework-Funktion

Um Codekomponenten zu einer App hinzuzufügen, müssen Sie die Funktion des Power Apps component framework in jeder Umgebung aktivieren, in der Sie sie verwenden möchten. Standardmäßig ist die Power Apps Component-Funktion für modellgesteuerte Apps aktiviert. So aktivieren Sie eine Umgebung für die Verwendung von Codekomponenten in ihren Apps:

1. Melden Sie sich bei Power Apps an.

2. Wählen Sie Einstellungen und dann Admin Center aus.

   

3. Wählen Sie im linken Bereich Umgebungen aus, wählen Sie die Umgebung aus, in der Sie diese Funktion aktivieren möchten, und wählen Sie dann Einstellungen aus.

4. Erweitern Sie Produkt, und wählen Sie Merkmale.

5. Aktivieren Sie in der Liste der verfügbaren Funktionen die Option Power Apps Component Framework für Canvas-Apps, und wählen Sie dann Speichern aus.

   

Implementieren von Codekomponenten

Nachdem Sie das Feature des Power Apps component framework in Ihrer Umgebung aktiviert haben, können Sie mit der Implementierung der Logik für Codekomponenten beginnen. Ein schrittweises Lernprogramm finden Sie unter Erstellen Ihrer ersten Codekomponente.

Überprüfen Sie die Einschränkungen von Codekomponenten in Canvas-Apps, bevor Sie mit der Implementierung beginnen.

Hinzufügen von Komponenten zu einer Canvas-App

1. Zu Power Apps Studio wechseln.

2. Erstellen Sie eine neue Canvas-App oder bearbeiten Sie eine vorhandene App, der Sie die Codekomponente hinzufügen möchten.

   Wichtig

   Stellen Sie sicher, dass Sie die Lösung .zip Datei mit den Codekomponenten in Microsoft Dataverse importiert haben.

3. Wählen Sie im linken Bereich das Symbol Hinzufügen (+) aus und wählen Sie dann Weitere Komponenten abrufen aus.

   

4. Wählen Sie auf der Registerkarte Code eine Komponente aus der Liste aus und wählen Sie dann Importieren aus.

   

5. Wählen Sie das Symbol + im linken Bereich aus, erweitern Sie Codekomponenten, und wählen Sie die Komponente aus, um sie der App hinzuzufügen.

   

   Notiz

   Sie können auch Einfügen>Benutzerdefiniert>Komponente importieren auswählen, um Komponenten hinzuzufügen. Diese Option ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie daher den zuvor beschriebenen Fluss.

Auf der Registerkarte "Eigenschaften " werden die Eigenschaften der Codekomponente angezeigt.

Notiz

Um vorhandene Codekomponenten erneut zu importieren und die Eigenschaften auf der Standardregisterkarte Eigenschaften verfügbar zu machen, aktualisieren Sie die Manifestversion der Codekomponente. Die Eigenschaften bleiben auf der Registerkarte "Erweiterte Eigenschaften" verfügbar.

Codekomponente aus einer Canvas-App löschen

1. Öffnen Sie die App, in der Sie die Codekomponente hinzugefügt haben.

2. Wählen Sie im linken Bereich die Strukturansicht aus, und wählen Sie dann den Bildschirm aus, auf dem Sie die Codekomponente hinzugefügt haben.

3. Wählen Sie neben der Komponente die Option Mehr (...), und wählen Sie dann Löschen aus.

   

4. Speichern Sie die App, um die Änderungen darzustellen.

Aktualisieren vorhandener Codekomponenten

Um Laufzeitänderungen nach dem Aktualisieren von Codekomponenten anzuzeigen, ändern Sie die version Eigenschaft in der Manifestdatei. Ändern Sie die Version der Komponente, wenn Sie Änderungen vornehmen.

Notiz

Power Apps Studio aktualisiert vorhandene Codekomponenten nur, wenn Sie die App schließen oder erneut öffnen. Wenn Sie die App erneut öffnen, werden sie aufgefordert, die Codekomponenten zu aktualisieren. Durch das einfache Löschen oder Hinzufügen von Codekomponenten in die App werden die Komponenten nicht aktualisiert. Veröffentlichen Sie zuerst alle Anpassungen in der aktualisierten Lösung, andernfalls werden an der Codekomponente vorgenommene Aktualisierungen nicht angezeigt.

Siehe auch

Power Apps component framework – Übersicht
Erste Codekomponente erstellen
Weitere Informationen zum Power Apps component framework