Freigeben über

Erstellen und Veröffentlichen von Workflowvorlagen für Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Azure Logic Apps bietet vorgefertigte, wiederverwendbare Automatisierungs- und Integrationsworkflowvorlagen, mit denen Sie den Prozess der Erstellung von Integrationsanwendungen beschleunigen können. Diese Vorlagen folgen häufig verwendeten Mustern und helfen Ihnen bei der Optimierung der Entwicklung, indem sie einen Ausgangspunkt oder eine Baseline mit vordefinierter Geschäftslogik und Konfigurationen bereitstellen.

Vorlagen können einen oder mehrere Workflows zusammen mit ihren Verbindungen, Parametern und Dokumentationen enthalten. Azure Logic Apps bietet die folgenden Vorlagentypen:

Vorlagentyp BESCHREIBUNG
Arbeitsablauf Wiederverwendbare Vorlagen, die einzelne Workflows erstellen.
Beschleuniger Gebündelte Lösungen, die mehrere verwandte Workflows enthalten.

Sie finden diese Vorlagen im Vorlagenkatalog, der geöffnet wird, wenn Sie einen Workflow erstellen möchten, indem Sie mit einer Vorlage beginnen. Der Katalog enthält bereits von Microsoft erstellte Vorlagen für allgemeine Entwurfs- und Integrationsmuster.

Sie können die Entwicklung nicht nur mithilfe von Workflowvorlagen starten, sondern auch Workflowvorlagen für die Verwendung Ihrer Organisation allein innerhalb eines Azure-Abonnements erstellen und veröffentlichen oder mit anderen teilen. Ihre Vorlage kann Artefakte wie Schemas, Karten und benutzerdefinierte Assemblys enthalten.

Mithilfe von Organisationsvorlagen können Sie Integrationsmuster standardisieren, bewährte Methoden freigeben und Lösungen intern wiederverwenden, ohne sie öffentlich zu machen. Diese Funktion ist besonders nützlich für Unternehmen, die Konsistenz fördern möchten, während Optionen für Flexibilität offen bleiben. Ganz gleich, ob Ihre Szenarien das Einbetten interner APIs, das Behandeln von domänenspezifischer Logik oder das Erzwingen von Architekturmustern umfassen, organisatorische Vorlagen helfen Ihnen beim Skalieren und Wachsen, während Sie die Kontrolle behalten.

Azure Logic Apps-Vorlagen bieten Ihnen auch die folgenden Funktionen:

  • Veröffentlichen Sie Vorlagen im Test- oder Produktionsmodus, mit denen Sie sicher experimentieren und Versionen kontrollieren können.

  • Verwenden Sie APIs und interne Systeme direkt in Vorlagen, ohne sie externisieren zu müssen.

  • Laden Sie Vorlagenpakete herunter, und fügen Sie sie optional dem öffentlichen Workflowvorlagen-Repository für Azure Logic Apps in GitHub hinzu.

  • Graduieren Sie Ihre Vorlagen von Test zu Produktion, indem Sie die integrierte Lebenszyklusverwaltung in Azure DevOps verwenden, wodurch Ihre Teamstruktur erhalten bleibt, aber Flexibilität erhalten bleibt.

  • Als erstklassige Ressourcen in Azure unterstützen Vorlagen die rollenbasierte Zugriffssteuerung (Azure Role-Based Access Control, RBAC).

    • Sie können Vorlagenberechtigungen wie jede andere Azure-Ressource verwalten.

      Diese Berechtigungen respektieren Abonnement- und Rollenbereiche, was bedeutet, dass Entwickler nur die Vorlagen in Abonnements anzeigen und darauf zugreifen können, auf die Entwickler Zugriff haben.

      Diese Funktion bietet eine Kontrolle in Unternehmensqualität darüber, wer Vorlagen erstellen, anzeigen und bereitstellen kann. Sie haben die volle Kontrolle über die Art und Weise, wie Sie Vorlagen organisieren möchten, damit Sie sicherstellen können, dass die richtigen Teams Zugriff auf die benötigten Automatisierungsmuster erhalten.

Der folgende Screenshot zeigt den Workflowvorlagenkatalog für eine Organisation und ein Azure-Abonnement mit Beispielvorlagen, die Statusbezeichnungen wie Test und Produktion anzeigen:

Screenshot zeigt das Azure-Portal und die Galerie der Workflow-Vorlagen mit benutzerdefinierten Vorlagen, die auf Azure-Abonnements ausgerichtet sind, in der Test- und Produktionsphase.

In diesem Handbuch wird gezeigt, wie Sie eine Workflowvorlage auf folgende Weise erstellen und veröffentlichen:

Voraussetzungen

  • Ein Azure Konto und ein Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

  • Die bereitgestellte Verbrauchs- oder Standard-Logik-App-Ressource und der Workflow, die als Definition des Quellworkflows für die Vorlage dienen sollen.

    Ihre Logik-App-Ressource und Ihr Workflow müssen bereitgestellt werden, bevor Sie Ihre Vorlage erstellen. Stellen Sie sicher, dass Sie alle Werte, die der Endbenutzer des Workflows bereitstellen muss, korrekt parametrisieren, anstatt diese Werte zu hartcodieren.

    Wenn Sie nicht über diese Ressource und diesen Workflow verfügen, lesen Sie die folgenden Artikel:

  • Screenshots mit schreibgeschützten Vorschaubildern für den Workflow, den die Vorlage erstellt. Verwenden Sie die Dateinamenerweiterung.png für diese Screenshots. Diese Vorschaubilder für Vorlagen werden im Vorlagenübersichtsbereich im Vorlagenkatalog angezeigt.

    Um diese Images so zu speichern, dass Ihre Vorlage sie verwenden kann, benötigen Sie ein Azure-Speicherkonto und einen BLOB-Container.

    Führen Sie die folgenden Schritte aus, um diese Bilder zu erstellen:

    1. Öffnen Sie im Azure-Portal die Quelllogik-App-Ressource und den Workflow im Designer.

    2. Richten Sie den Workflow ein, um zwei Screenshots zu erstellen: eine Version, die mit dem hellen Design eines Webbrowsers und einer anderen Version funktioniert, die mit dem dunklen Design eines Webbrowsers funktioniert.

    3. Erstellen Sie die Screenshots mithilfe Ihres bevorzugten Tools für die Bildschirmaufnahme. Schließen Sie nicht zu viel Leerraum um den Workflow ein.

    4. Speichern Sie jedes Bild mithilfe der dateinamenerweiterung.png und einen Namen, der den Namens- und Formatvorlagenkonventionen folgt, < z. B. bildname>-light.png und <Bildname>-dark.png.

    5. Fügen Sie Ihre Bilder dem BLOB-Container in Ihrem Azure-Speicherkonto hinzu. Kopieren Sie die BLOB-URL für jedes Bild, und speichern Sie sie, damit Sie später auf die Bilder aus Ihrer Vorlage verweisen können.

      Von Bedeutung

      Die URL enthält einen SAS-Schlüssel (Shared Access Signature) oder ein Token, der Berechtigungen erteilt, z. B. für Speicherdienste. Stellen Sie sicher, dass Sie Ihren SAS-Schlüssel genauso schützen, wie Sie einen Kontoschlüssel vor nicht autorisierter Verwendung schützen.

Bewährte Methoden

Diese Liste enthält bewährte Methoden, die Sie beim Erstellen ihrer Workflowvorlage befolgen können:

  • Verwenden Sie keine hartcodierten Eigenschaften und deren Werte in Trigger- und Aktionsdefinitionen.

  • Stellen Sie mehr Kontext zu Trigger- und Aktionsdefinitionen bereit, indem Sie beschreibende und aussagekräftige Kommentare hinzufügen.

  • Standard-Logic-App-Ressource und -Workflows

    • Verwenden Sie so weit wie möglich die integrierten Vorgänge. Der Azure Blob Storage-Connector verfügt beispielsweise über die folgenden Versionen für Standardworkflows:

      • Integrierte Dienstanbietervorgänge erscheinen in der Connector-Galerie unter dem Filter Integriert. Diese Versionen werden mit der Single-Tenant-Laufzeit von Azure Logic Apps gehostet und ausgeführt, was eine bessere Leistung, einen besseren Durchsatz und andere Vorteile bietet.

      • In Azure gehostete verwaltete API-Connectorvorgänge werden im Connectorskatalog unter dem freigegebenen Filter angezeigt. Diese Versionen werden in mehrinstanzenfähigem Azure mit freigegebenen globalen Ressourcen gehostet und ausgeführt.

Erstellen einer Workflowvorlage

Je nachdem, ob Sie Ihre Workflowvorlage nur für Ihre Organisation oder für alle Benutzer in Azure verfügbar machen möchten, führen Sie die entsprechenden Schritte aus:

In diesen Schritten wird beschrieben, wie Sie eine Workflowvorlage erstellen und veröffentlichen, die nur für Mitglieder in einem bestimmten Azure-Abonnement verfügbar ist.

  1. Suchen sie im Suchfeld des Azure-Portalsnach Vorlagen für Logik-Apps, und wählen Sie sie aus.

  2. Wählen Sie auf der Symbolleiste " Vorlagen für Logik-Apps " die Option "Erstellen" aus.

  3. Geben Sie auf der Seite "Erstellen einer Vorlage für Azure Logic Apps " auf der Registerkarte " Grundlagen " die folgenden Informationen an:

    Parameter Erforderlich Wert BESCHREIBUNG
    Abonnement Ja < Name des Azure-Abonnements> Das Azure-Abonnement, das mit der Workflowvorlage verwendet werden soll.
    Ressourcengruppe Ja < Ressourcengruppenname> Der Name der Azure-Ressourcengruppe, die mit der Vorlage verwendet werden soll.
    Name Ja < Name der Vorlage> Der Name für die Workflowvorlagenressource.
    Region Ja < Azure-Region> Die Azure-Region, in der die Workflowvorlagenressource erstellt werden soll.

  4. Wenn Sie fertig sind, wählen Sie "Überprüfen" und "Erstellen" aus. Überprüfen Sie die bereitgestellten Informationen, und wählen Sie "Erstellen" aus.

    Azure erstellt die Vorlagenressource.

Wählen Sie als Nächstes die Quellworkflowdefinition aus, die für Ihre Vorlage verwendet werden soll.

Auswählen der Quellworkflowdefinition

  1. Wählen Sie im Menü "Vorlagenressource" unter "Vorlage" die Option "Vorlage" aus.

  2. Wählen Sie auf der Seite "Vorlage " auf der Registerkarte "Workflows " die Option "Hinzufügen" aus.

  3. Geben Sie im Bereich "Workflows in diesem Vorlagenbereich verwalten" auf der Registerkarte " Workflows auswählen " die folgenden Informationen an:

    Parameter Erforderlich Wert BESCHREIBUNG
    Abonnement Ja < Name des Azure-Abonnements> Der Name für das Azure-Abonnement mit der Quelllogik-App.
    Ressourcengruppe Ja < Ressourcengruppenname> Der Name für die Azure-Ressourcengruppe mit der Quelllogik-App.
    Logik-App-Instanz Ja < Quelllogik-App> Der Name der Quelllogik-App mit dem Workflow, den Sie verwenden möchten.
    Workflows Ja < Quellworkflows> Wählen Sie für eine Verbrauchslogik-App den einzigen vorhandenen Workflow aus, der in Ihrer Vorlage verwendet werden soll.

    Wählen Sie für eine Standardlogik-App mindestens einen Workflow aus, der in Ihrer Vorlage verwendet werden soll.

  4. Wenn Sie fertig sind, wählen Sie Weiter.

  5. Geben Sie auf der Registerkarte " Workflows einrichten " die folgenden Informationen für jeden ausgewählten Quellworkflow an:

    Parameter Erforderlich Wert BESCHREIBUNG
    Workflowname Ja < JSON-Workflowname> Der JSON-Name für den Workflow, der nur Kleinbuchstaben, Zahlen und Bindestriche verwenden kann und die Sie nur einmal umbenennen können.
    Zustand Ja Zustandsbehaftet oder zustandslos Gibt an, ob der Verlauf der Workflow-Ausführungen, die Eingaben und Ausgaben von Vorgängen standardmäßig gespeichert werden sollen.
    Zusammenfassung Ja < Kurzbeschreibung> Eine kurze hochwertige Zusammenfassung über den Zweck der Vorlage.
    Beschreibung Nein < detaillierte Beschreibung> Eine Beschreibung mit ausführlicheren Informationen zur Vorlage.
    Voraussetzungen Nein < Voraussetzungen> Alle Anforderungen, die Sie benötigen, bevor Sie die Vorlage verwenden können.

  6. Geben Sie im Abschnitt "Workflowbilder " die Workflowvorschaubilder an, die im Vorlagenkatalog für den Vorlagenübersichtsbereich verwendet werden sollen. Dieser Bereich enthält weitere Vorlageninformationen.

    Workflowbild BESCHREIBUNG
    SAS-URL im Light-Modus Die SAS-URL für das helle Workflow-Vorschaubild, das in einem Blob-Container in Ihrem Azure-Speicherkonto gespeichert ist.
    SAS-URL für dunklen Modus Die SAS-URL für das Vorschaubild des dunklen Workflows, das in einem BLOB-Container in Ihrem Azure-Speicherkonto gespeichert ist.

  7. Wenn Sie fertig sind, wählen Sie Speichern aus.

    Sie können Ihre Vorlage während des Erstellungsprozesses jederzeit speichern. Jedes Mal, wenn Sie den Fortschritt speichern, wird die Überprüfung automatisch ausgeführt, um festzustellen, ob Fehler vorhanden sind, z. B. nicht unterstützte Aktionen oder nicht parametrisierte Werte. Sie müssen fehler nicht sofort beheben, wenn Sie sie finden, aber Sie müssen sie vor der Veröffentlichung beheben.

  8. Überprüfen und bestätigen Sie auf der Registerkarte "Verbindungen " die Verbindungen, die Azure automatisch aus den Quellworkflows abruft.

    Sie müssen keine anderen Aktionen ausführen.

  9. Klicken Sie abschließend auf Weiter.

Anpassen von Parametern

Fügen Sie auf der Registerkarte "Parameter " Anpassungen für alle gewünschten Parameter für den Workflow hinzu.

  1. Wählen Sie auf der Registerkarte "Parameter " das Bearbeitungssymbol für den Parameter aus.

  2. Geben Sie die folgenden Informationen für den Parameter an:

    Eigentum Erforderlich BESCHREIBUNG
    Anzeigename Ja Der Parametername, der im Azure-Portal angezeigt wird.
    Standardwert Nein Der Standardwert für den Parameter.
    Beschreibung Nein Die Zweckbeschreibung des Parameters.
    Pflichtfeld Nein Gibt an, ob der Workflow den Parameter erfordert.

  3. Wenn Sie fertig sind, wählen Sie Speichern aus.

Vorlageninformationen bereitstellen

Auf der Registerkarte "Profil" werden Informationen zu Ihrer Vorlage angegeben, die in der Vorlagengalerie angezeigt werden, z. B. Anzeigename, Herausgebername, Connectoren und andere Metadaten.

  1. Geben Sie auf der Registerkarte "Profil " die folgenden Informationen zu Ihrer Vorlage an:

    Eigentum Erforderlich BESCHREIBUNG
    Anzeigename Ja Der Anzeigename der Workflowvorlage, der im Vorlagenkatalog angezeigt wird.
    Von Ja Der Name des Herausgebers der Workflowvorlage.
    Zusammenfassung Ja Die Beschreibung für den Workflow, den die Vorlage erstellt.
    Empfohlene Connectors Ja Wählen Sie die primären Connectortypen in der Workflowvorlage aus.
    Kategorie Nein Die Kategorie, zu der die Vorlage gehört.
    Stichwörter Nein Alle Tags, die Sie zum Bezeichnen des Workflows verwenden möchten.

  2. Klicken Sie abschließend auf Weiter.

  3. Überprüfen und bestätigen Sie auf der Registerkarte " Zusammenfassung " alle bereitgestellten Informationen.

Veröffentlichen zum Testen

Wenn Sie bereit sind, Ihre Vorlage zu testen, können Sie Ihre Vorlage zum Testen veröffentlichen.

  1. Wählen Sie auf der Registerkarte "Zusammenfassung" oder auf einer vorherigen Registerkarte am unteren Rand der Liste "Speichern" die Option "Speichern + Veröffentlichen zum Testen" aus.

    Screenshot zeigt das Azure-Portal, die Registerkarte

    Azure veröffentlicht die Vorlage, die die Testbezeichnung anzeigt, im Vorlagenkatalog.

  2. Führen Sie zum Testen Der neuen Vorlage die Schritte unter Erstellen von Workflows aus vordefinierten Vorlagen aus, aber mit den folgenden Schritten:

    1. Wählen Sie in der Statusliste die Option "Veröffentlicht für Tests" aus. Wählen Sie unter der Zeile "Filter " die Option "Meine Vorlagen" aus.

      Ihre Vorlage wird mit der Bezeichnung "Test " angezeigt, z. B.:

      Screenshot: Azure-Portal, Vorlagenkatalog und ausgewählte Registerkarte für

    2. Beenden Sie die Erstellung Ihres Workflows, testen Sie Ihre Vorlage, und nehmen Sie alle erforderlichen Anpassungen vor.

Veröffentlichen für die Produktion

Führen Sie die folgenden Schritte aus, um die Vorlagenbezeichnung von "Testen " in " Produktion " im Vorlagenkatalog zu ändern:

  1. Suchen und öffnen Sie ihre Vorlagenressource im Azure-Portal.

  2. Wählen Sie auf der Seitenleiste der Vorlage unter "Vorlage" die Option "Vorlage" aus.

  3. Wählen Sie auf der Seite "Vorlage" "Weiter" aus, und wiederholen Sie den Vorgang, bis Sie die Registerkarte "Profil" öffnen.

  4. Wählen Sie in der Liste "Speichern " die Option "Speichern+ Veröffentlichen für die Produktion" aus.

    Screenshot zeigt das Azure-Portal, die Registerkarte

Wenn Sie Die benutzerdefinierte Workflowvorlage vorübergehend oder dauerhaft aus dem Vorlagenkatalog entfernen möchten, können Sie die Veröffentlichung der Vorlage aufheben.

  1. Suchen und öffnen Sie ihre Vorlagenressource im Azure-Portal.

  2. Wählen Sie auf der Seitenleiste der Vorlage unter "Vorlage" die Option "Vorlage" aus.

  3. Wählen Sie auf der Seite "Vorlage" "Weiter" aus, und wiederholen Sie den Vorgang, bis Sie die Registerkarte "Profil" öffnen.

  4. Wählen Sie in der Speichern Liste Speichern + Vorlage aufheben aus.

    Screenshot zeigt das Azure-Portal, die Registerkarte

Namens- und Stilkonventionen

Bereich Konvention
Sensible Daten Schließen Sie keine persönlichen und vertraulichen Daten in Vorlagendateien, Screenshots, Beschreibungen oder Testdaten ein, und laden Sie sie nicht hoch. Diese Daten umfassen beispielsweise Abonnement-IDs, Benutzernamen, Kennwörter usw.
Ordnernamen Um die Lesbarkeit zu vereinfachen, verwenden Sie nach Möglichkeit Kleinbuchstaben und Bindestriche. Siehe Hinweise zur Großschreibung im Microsoft-Styleguide.
Bilddateinamen Verwenden Sie .png als Dateinamenerweiterung, Kleinbuchstaben und Bindestriche, z. B. workflow-hell.png.
Produkt-, Dienst-, Technologie- und Markennamen Folgen Sie der offiziellen Schreibung und Großschreibung. Beispiel:

– Wenn Sie auf den Dienstnamen oder die Plattform verweisen, verwenden Sie „Azure Logic Apps“, nicht „Logic Apps“.

– Wenn Sie auf die Ressource oder Instanz verweisen, verwenden Sie „Logik-Apps“ oder „Logik-App“, nicht „Logic App“ oder „Logic Apps“.

– Wenn Sie auf die Abfolge von Triggern und Aktionen verweisen, verwenden Sie „Logik-App-Workflow“ oder „Workflow“.
Abkürzungen und Akronyme Verwenden Sie den ausgeschriebenen Namen für Produkt-, Dienst-, Technologie- und Markennamen sowie ungewöhnliche technische Begriffe, keine Abkürzungen oder Akronyme. Allgemeine Akronyme, z. B. „HTTP“ und „URL“, sind akzeptabel. Verwenden Sie beispielsweise „Visual Studio Code“, nicht „VS Code“. Siehe Hinweise zur Akronymen im Microsoft-Styleguide.
Sonstiger Text – Verwenden Sie die normale Groß- und Kleinschreibung für Titel, Überschriften und Textkörper.

– Beachten Sie die Rechtschreibregeln.
Sprache – Verwenden Sie die direkte Anrede (Sie und Ihre), statt die dritte Person (Benutzer, Entwickler, Kunden) zu verwenden, es sei denn, Sie müssen auf bestimmte Rollen verweisen. Siehe Hinweise zu Personen im Microsoft-Styleguide.

– Verwenden Sie nach Möglichkeit einen aktiven, direkten, aber freundlichen Ton. Aktive Formulierungen konzentrieren sich auf das Subjekt und das Verb im Text, während passive Formulierungen sich auf das Objekt konzentrieren.
Vokabular – Verwenden Sie einfache, häufige, alltägliche Wörter, wie z. B. „verwenden“ statt „gebrauchen“.

– Verwenden Sie keine Wörter, Ausdrücke, Jargon, Umgangssprache, Redensarten oder Slang, die nicht gut in andere Sprachen übersetzt werden können.

– Verwenden Sie „bitte“ nur für bestimmte Szenarien. Siehe Hinweise zu „Bitte“ im Microsoft-Styleguide.

– Verwenden Sie keine ungebräuchlichen Abkürzungen.

– Verwenden Sie keine direktionalen Begriffe wie „hier“, „über“, „unter“, „rechts“ und „links“, da diese die Barrierefreiheit einschränken.
Interpunktion – Beachten Sie bei Aufzählungen die richtige Zeichensetzung. Z. B. „Äpfel, Orangen und Bananen“. Siehe Hinweise zu Kommas im Microsoft-Styleguide.

– Beenden Sie vollständige Sätze mit dem entsprechenden Satzzeichen. Verwenden Sie keine Ausrufezeichen. Siehe Hinweise zu Satzzeichen im Microsoft-Styleguide.
Formatierung – Folgen Sie für Code der Stilkonvention für die jeweilige Programmiersprache.

– Verwenden Sie keine hartcodierten Links, die nicht mehr funktionieren, wenn sich die URLs ändern. Bitten Sie in Ihrer PR-Anforderung stattdessen um einen Umleitungslink.

– Verwenden Sie für Links das folgende Format:

For more information, see [descriptive-link-text](URL)].

– Verwenden Sie beschreibenden Linktext, keinen generischen oder vagen Linktext, z. B. „See [here](URL)“.

– Verwenden Sie Zahlen nur für Schritte in einer Prozedur, nicht für Listen, die keine bestimmte Reihenfolge aufweisen. Siehe Hinweise zu Listen im Microsoft-Styleguide.

– Verwenden Sie nur ein Leerzeichen nach Satzzeichen, mit Ausnahme von Einzügen bei Code.

Weitere Anleitungen finden Sie im Microsoft-Styleguide und den globalen Schreibtipps.

Verwandte Inhalte

Erstellen von Logik-App-Workflows aus vordefinierten Vorlagen

  • Last updated on