Werkstroomsjablonen maken en publiceren voor Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Azure Logic Apps biedt vooraf gebouwde, herbruikbare automatiserings- en integratiewerkstroomsjablonen die u kunt gebruiken om het proces van het bouwen van integratietoepassingen te versnellen. Deze sjablonen volgen veelgebruikte patronen en helpen u bij het stroomlijnen van de ontwikkeling door een beginpunt of basislijn te bieden met vooraf gedefinieerde bedrijfslogica en -configuraties.

Sjablonen kunnen een of meer werkstromen bevatten, samen met hun verbindingen, parameters en documentatie. Azure Logic Apps biedt de volgende sjabloontypen:

Sjabloontype	Beschrijving
Werkproces	Herbruikbare sjablonen waarmee afzonderlijke werkstromen worden gemaakt.
Versnellers	Gebundelde oplossingen die meerdere gerelateerde werkstromen bevatten.

U vindt deze sjablonen in de galerie met sjablonen, die wordt geopend wanneer u ervoor kiest om een werkstroom te maken door te beginnen met een sjabloon. De galerie bevat al door Microsoft geschreven sjablonen voor algemene ontwerp- en integratiepatronen.

U kunt niet alleen beginnen met het ontwikkelen van werkstroomsjablonen, maar u kunt werkstroomsjablonen maken en publiceren voor het gebruik van uw organisatie alleen binnen een Azure-abonnement of deze delen met anderen. Uw sjabloon kan artefacten bevatten, zoals schema's, kaarten en aangepaste assembly's.

Met organisatiesjablonen kunt u integratiepatronen standaardiseren, aanbevolen procedures delen en oplossingen binnen uw onderneming intern hergebruiken zonder ze openbaar te maken. Deze mogelijkheid is vooral handig voor bedrijven die consistentie willen bevorderen, terwijl opties open blijven voor flexibiliteit. Ongeacht of uw scenario's het insluiten van interne API's, het afhandelen van domeinspecifieke logica of het afdwingen van architectuurpatronen, organisatiesjablonen u helpen bij het schalen en groeien terwijl u de controle houdt.

Azure Logic Apps-sjablonen bieden u ook de volgende mogelijkheden:

Publiceer sjablonen in de test- of productiemodus, waarmee u veilig kunt experimenteren en releases kunt behouden.
Gebruik API's en interne systemen rechtstreeks in sjablonen zonder dat u ze hoeft te externaliseren.
Download sjabloonpakketten en voeg ze desgewenst toe aan de opslagplaats voor openbare werkstroomsjablonen voor Azure Logic Apps in GitHub.
Verdeel uw sjablonen van test naar productie met behulp van het ingebouwde levenscyclusbeheer in Azure DevOps, wat uw teamstructuur geeft, maar de flexibiliteit behoudt.
Als eersteklas resources in Azure ondersteunen sjablonen op rollen gebaseerd toegangsbeheer (RBAC) van Azure.
- U kunt sjabloonmachtigingen beheren zoals elke andere Azure-resource.
  
  Deze machtigingen respecteren abonnements- en rolbereiken, wat betekent dat ontwikkelaars alleen die sjablonen kunnen zien en openen in abonnementen waartoe ontwikkelaars toegang hebben.
  
  Deze mogelijkheid biedt controle op ondernemingsniveau over wie sjablonen kan ontwerpen, weergeven en implementeren. U hebt volledige controle over de manier waarop u sjablonen wilt ordenen, zodat u ervoor kunt zorgen dat de juiste teams toegang krijgen tot de automatiseringspatronen die ze nodig hebben.

In de volgende schermopname ziet u de galerie met werkstroomsjablonen die zijn afgestemd op een organisatie en Een Azure-abonnement met voorbeeldsjablonen met statuslabels zoals Testen en Productie:

In deze handleiding ziet u hoe u op de volgende manieren een werkstroomsjabloon maakt en publiceert:

Alleen voor gebruik door uw organisatie. Zie Werkstroomsjabloon maken - Azure Portal.

Met dit pad maakt u uw sjabloon met behulp van de wizard in Azure Portal om de werkstromen voor de logische bron-app op te geven, informatie over uw sjabloon en de opties om te publiceren voor testen voordat u de sjabloon in productie brengt.
Voor alle Azure-klanten om te gebruiken. Zie Werkstroomsjabloon maken - Handmatig.

Voor dit pad moet u een sjabloonpakket maken en het pakket verzenden als een pull-aanvraag naar de opslagplaats voor openbare werkstroomsjablonen voor Azure Logic Apps in GitHub.

Vereiste voorwaarden

Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.
De geïmplementeerde verbruiks- of standaardbron voor logische apps en werkstroom die moet worden gebruikt als de bronworkflowdefinitie voor de sjabloon.

Uw Logic App-resource en -werkstroom moeten worden geïmplementeerd voordat u uw sjabloon maakt. Zorg ervoor dat u alle waarden die de eindgebruiker van de werkstroom moet opgeven correct parameteriseert in plaats van deze waarden vast te leggen.

Als u deze resource en werkstroom niet hebt, raadpleegt u de volgende artikelen:
- Een voorbeeld workflow maken voor een consumptie-logische app
- Een voorbeeld van een werkstroom voor een logische app van Standard maken
Schermopnamen die een alleen-lezen voorbeeld van afbeeldingen tonen voor de werkstroom die de sjabloon creëert. Gebruik de bestandsextensie .png voor deze schermopnamen. Deze voorbeeldafbeeldingen voor sjablonen worden weergegeven in het overzichtsvenster van de sjabloon in de galerie met sjablonen.

Als u deze afbeeldingen wilt opslaan zodat uw sjabloon ze kan gebruiken, hebt u een Azure-opslagaccount en een blobcontainer nodig.

Volg deze stappen om deze afbeeldingen te maken:
1. Open in de Azure Portal de bron-logica-app-resource en werkstroom in de ontwerper.
2. Stel de werkstroom in om twee schermopnamen te maken: één versie die werkt met het lichte thema van een webbrowser en een andere versie die werkt met het donkere thema van een webbrowser.
3. Maak de schermopnamen met behulp van het hulpprogramma voor schermopnamen van uw voorkeur. Neem niet te veel witruimte rond de werkstroom op.
4. Sla elke afbeelding op met behulp van de bestandsextensie .png en een naam die de namen en stijlconventies volgt, bijvoorbeeld <>-light.png en <image-name>-dark.png.
5. Voeg uw afbeeldingen toe aan de blobcontainer in uw Azure Storage-account. Kopieer en sla de blob-URL voor elke afbeelding op, zodat u later kunt verwijzen naar de afbeeldingen uit uw sjabloon.
  
  Belangrijk
  
  De URL bevat een SAS-sleutel (Shared Access Signature) of -token die bijvoorbeeld machtigingen verleent aan opslagservices. Zorg ervoor dat u uw SAS-sleutel beveiligt, net zoals u een accountsleutel beveiligt tegen onbevoegd gebruik.

Beste praktijken

Deze lijst bevat aanbevolen procedures die u kunt volgen wanneer u uw werkstroomsjabloon maakt:

Gebruik geen in code vastgelegde eigenschappen en de bijbehorende waarden in trigger- en actiedefinities.
Geef meer context over trigger- en actiedefinities door beschrijvende en nuttige opmerkingen toe te voegen.
Resource en werkstromen van standaard logica-apps
- Gebruik de ingebouwde bewerkingen zoveel mogelijk. De Azure Blob Storage-connector heeft bijvoorbeeld de volgende versies beschikbaar voor Standard-werkstromen:
  - Ingebouwde serviceproviderbewerkingen worden weergegeven in de connectorengalerij onder het ingebouwde filter. Deze versies worden gehost en uitgevoerd met de Azure Logic Apps-runtime met één tenant, met betere prestaties, doorvoer en andere voordelen.
  - Door Azure gehoste beheerde API-connectorbewerkingen worden weergegeven in de connectorengalerij onder het Gedeelde filter. Deze versies worden gehost en uitgevoerd in multitenant Azure met behulp van gedeelde globale resources.

Een werkstroomsjabloon maken

Volg de bijbehorende stappen op basis van of u uw werkstroomsjabloon alleen beschikbaar wilt maken voor uw organisatie of voor iedereen in Azure:

Enkel voor organisatie
Alle Azure-producten

In deze stappen wordt beschreven hoe u een werkstroomsjabloon maakt en publiceert die alleen beschikbaar is voor leden in een specifiek Azure-abonnement.

Zoek en selecteer in het zoekvak van Azure Portalsjablonen voor logische apps.
Selecteer Maken op de paginawerkbalk Van Logic Apps-sjablonen.

Geef op de pagina Een Azure Logic Apps-sjabloon maken op het tabblad Basisinformatie de volgende informatie op:

Kenmerk	Vereist	Weergegeven als	Beschrijving
Abonnement	Ja	< Azure-abonnementnaam>	Het Azure-abonnement dat moet worden gebruikt met de werkstroomsjabloon.
Resourcegroep	Ja	< resource-group-name>	De naam voor de Azure-resourcegroep die moet worden gebruikt met de sjabloon.
Naam	Ja	< sjabloonnaam>	De naam van de workflow-sjabloonresource.
Regio	Ja	< Azure-regio>	De Azure-regio voor het creëren van de werkstroomsjabloonresource.

Wanneer u klaar bent, selecteert u Beoordelen en maken. Controleer de opgegeven informatie en selecteer Maken.

Azure maakt een sjabloonresource.

Kies vervolgens de bronwerkstroomdefinitie die u voor uw sjabloon wilt gebruiken.

De definitie van de bronwerkstroom kiezen

Selecteer Sjabloon in het resourcemenu van de sjabloon onder Sjabloon.
Selecteer Toevoegen op de pagina Sjabloon op het tabblad Werkstromen.

Geef in het deelvenster Werkstromen beheren in dit sjabloonvenster op het tabblad Werkstromen kiezen de volgende informatie op:

Kenmerk	Vereist	Weergegeven als	Beschrijving
Abonnement	Ja	< Azure-abonnementnaam>	De naam voor het Azure-abonnement met de bronlogica-app.
Resourcegroep	Ja	< resource-group-name>	De naam voor de Azure-resourcegroep met de logische bron-app.
Exemplaar van logische app	Ja	< source-logica-app>	De naam voor de bronlogica-app met de werkstroom die u wilt gebruiken.
Werkstromen	Ja	< bronwerkstromen>	Voor een Verbruik logische app selecteert u de enige bestaande workflow die u in uw sjabloon wilt gebruiken. Voor een standaard logische app selecteert u ten minste één werkstroom die u in uw sjabloon wilt gebruiken.

Wanneer u klaar bent, selecteert u Volgende.

Geef op het tabblad Werkstromen instellen de volgende informatie op voor elke geselecteerde bronwerkstroom:

Kenmerk	Vereist	Weergegeven als	Beschrijving
Werkstroomnaam	Ja	< JSON-werkstroomnaam>	De JSON-naam voor de werkstroom die alleen kleine letters, cijfers en afbreekstreepjes kan gebruiken en waarvan u de naam slechts één keer kunt wijzigen.
Staat	Ja	Stateful of Stateless	Of u de uitvoeringsgeschiedenis van de werkstroom, de bewerkingsinvoer en bewerkingsuitvoer standaard wilt opslaan en bewaren.
Samenvatting	Ja	< korte beschrijving>	Een korte samenvatting op hoog niveau over het doel van de sjabloon.
Beschrijving	Nee	< gedetailleerde beschrijving>	Een beschrijving met gedetailleerdere informatie over de sjabloon.
Voorwaarden	Nee	< Voorwaarden>	Vereisten die u nodig hebt voordat u de sjabloon kunt gebruiken.

Geef in de sectie Werkstroomafbeeldingen de voorbeeldafbeeldingen van de werkstroom op die moeten worden gebruikt voor het overzichtsvenster van sjablonen in de sjablonengalerie. Dit deelvenster bevat andere sjabloongegevens.

Werkstroomafbeelding	Beschrijving
SAS-URL voor light-mode	De SAS-URL voor de voorbeeldafbeelding van de werkstroom met licht thema die is opgeslagen in een blobcontainer vanuit uw Azure-opslagaccount.
SAS-URL voor donkere modus	De SAS-URL voor de voorbeeldafbeelding van een werkstroom met donkerthema die is opgeslagen in een blobcontainer in uw Azure-opslagaccount.

Wanneer u klaar bent, selecteert u Opslaan.

U kunt uw sjabloon op elk gewenst moment opslaan tijdens het maken. Telkens wanneer u de voortgang opslaat, wordt de validatie automatisch uitgevoerd om te bepalen of er fouten bestaan, bijvoorbeeld niet-ondersteunde acties of niet-geparameteriseerde waarden. U hoeft fouten niet onmiddellijk op te lossen wanneer u ze hebt gevonden, maar u moet ze herstellen voordat u ze publiceert.
Controleer en bevestig op het tabblad Verbindingen de verbindingen die Azure automatisch ophaalt uit de bronwerkstromen.

U hoeft geen andere acties uit te voeren.
Wanneer u klaar bent, selecteert u Volgende.

Parameters aanpassen

Voeg op het tabblad Parameters aanpassingen toe voor de gewenste parameters voor de werkstroom.

Selecteer op het tabblad Parameters het bewerkingspictogram voor de parameter.

Geef de volgende informatie op voor de parameter:

Vastgoed	Vereist	Beschrijving
weergavenaam	Ja	De parameternaam die wordt weergegeven in Azure Portal.
Standaardwaarde	Nee	De standaardwaarde voor de parameter.
Beschrijving	Nee	De beschrijving voor het doel van de parameter.
Vereist veld	Nee	Of de werkstroom de parameter vereist.

Wanneer u klaar bent, selecteert u Opslaan.

Sjabloongegevens opgeven

Het tabblad Profiel bevat informatie over uw sjabloon die wordt weergegeven in de sjablonengalerie, bijvoorbeeld de weergavenaam van de sjabloon, de naam van de uitgever, connectors en andere metagegevens.

Geef op het tabblad Profiel de volgende informatie op over uw sjabloon:

Vastgoed	Vereist	Beschrijving
weergavenaam	Ja	De weergavenaam van de werkstroomsjabloon die wordt weergegeven in de sjablonengalerie.
Bij	Ja	De naam van de uitgever van de werkstroomsjabloon.
Samenvatting	Ja	De beschrijving voor de werkstroom die door de sjabloon wordt gemaakt.
Aanbevolen connectors	Ja	Selecteer de primaire connectortypen in de werkstroomsjabloon.
Categorie	Nee	De categorie waartoe de sjabloon behoort.
tags	Nee	Tags die u wilt gebruiken voor het labelen van de werkstroom.

Wanneer u klaar bent, selecteert u Volgende.
Controleer en bevestig alle opgegeven informatie op het tabblad Samenvatting .

Publiceren voor testen

Wanneer u klaar bent om uw sjabloon te testen, kunt u uw sjabloon publiceren voor testen.

Selecteer op het tabblad Samenvatting of een voorgaande tab, onder aan het tabblad, in de lijst Opslaande optie Opslaan en publiceren om te testen.

Azure publiceert de sjabloon, die het label Testen weergeeft, naar de galerie met sjablonen.
Als u de nieuwe sjabloon wilt testen, volgt u de stappen in Werkstromen maken op basis van vooraf gedefinieerde sjablonen , maar met deze stappen:
1. Selecteer Gepubliceerd voor testen in de lijst Status. Selecteer Mijn sjablonen onder de rij Filters.
  
  Uw sjabloon wordt weergegeven met het label Testen , bijvoorbeeld:
2. Voltooi het maken van uw werkstroom, het testen van uw sjabloon en het aanbrengen van eventuele aanpassingen.

Publiceren voor productie

Als u het sjabloonlabel wilt wijzigen van Testen naar Productie in de sjablonengalerie, voert u de volgende stappen uit:

Zoek en open uw sjabloonresource in Azure Portal.
Selecteer Sjabloon in de zijbalk van de sjabloon onder Sjabloon.
Selecteer volgende op de pagina Sjabloon en herhaal deze totdat u het tabblad Profiel opent.
Selecteer Opslaan en publiceren voor productie in de lijst Opslaan.

Sjabloon verwijderen uit galerie

Als u uw aangepaste werkstroomsjabloon tijdelijk of permanent uit de sjablonengalerie wilt verwijderen, kunt u de publicatie van de sjabloon ongedaan maken.

Zoek en open uw sjabloonresource in Azure Portal.
Selecteer Sjabloon in de zijbalk van de sjabloon onder Sjabloon.
Selecteer volgende op de pagina Sjabloon en herhaal deze totdat u het tabblad Profiel opent.
Selecteer Opslaan en publicatiesjabloon ongedaan maken in de lijst Opslaan.

In deze stappen wordt beschreven hoe u een werkstroomsjabloon maakt en publiceert die iedereen in Azure kan gebruiken. Voor deze aanpak moet u een sjabloonpakket maken.

Wat is er in een sjabloonpakket?

In de volgende tabel worden de vereiste en optionele bestanden in een sjabloonpakket beschreven:

Bestandsnaam	Vereist	Beschrijving
workflow.json	Ja	Een JSON-bestand met uw werkstroomdefinitie.
manifest.json	Ja	Een JSON-bestand met informatie over uw werkstroom en gerelateerde onderdelen.
*< image-name>-dark.png*	Ja	Een afbeeldingsbestand met de werkstroom als een alleen-lezen schermafbeelding in .png indeling en werkt met het donkere thema van een browser.
*< image-name>-light.png*	Ja	Een afbeeldingsbestand met de werkstroom als een alleen-lezen schermafbeelding in .png indeling en werkt met het lichte thema van een browser.
*< map-name>.json, .xml* of .xslt	Nee	Artefacten zoals kaarten en schema's die ondersteuning bieden voor uw werkstroomsjabloon.
*< custom-assembly>.dll*	Nee	Aangepaste assembly's die ondersteuning bieden voor uw werkstroomsjabloon.
readme.md	Nee	Een Markdown-bestand met instructies, procedures of andere informatie voor uw werkstroomsjabloon.

U kunt ook andere bestanden opnemen om uw sjabloon te onderhouden en te ondersteunen, bijvoorbeeld bestanden met test- of voorbeeldgegevens.

Een sjabloonpakketmap maken

Voordat u de sjabloonpakketmap maakt, moet u vertrouwd raken met namen en stijlconventies.
Gebruik de volgende syntaxis voor de mapnaam en het minste aantal woorden om te voorkomen dat de tekenlimiet voor bestandspaden wordt overschreden om de sjabloonopslagplaats gemakkelijker te laten bladeren, organiseren en onderhouden:

<

Zie de opslagplaats voor werkstroomsjablonen voor Azure Logic Apps in GitHub voor voorbeelden.
Als u de map sjabloonpakket correct wilt registreren, moet u de mapnaam toevoegen aan het hoofdniveau van de opslagplaats manifest.json bestand.

Een workflow.json-bestand maken

Het workflow.json-bestand bevat de onderliggende definitie voor een werkstroom in JSON-indeling. Als u het workflow.json-bestand wilt maken, moet u uw werkstroomdefinitie kopiëren en opslaan als een bestand met de naam workflow.json.

Voor de eenvoudigste en beste manier om de werkstroomdefinitie op te halen, maakt u uw werkstroom met behulp van de ontwerpfunctie. Zorg ervoor dat u de aanbevolen procedures voor werkstromen bekijkt, samen met namen en stijlconventies. Als uitgangspunt kunt u ook de vooraf gemaakte werkstroomsjablonen gebruiken vanuit de sjablonengalerie in Azure Portal.

Tijdens het bouwen van uw werkstroom bevat de ontwerpfunctie automatisch verwijzingen naar toegevoegde ingebouwde, serviceproviderverbindingen, beheerde API-verbindingen of bibliotheken in de onderliggende werkstroomdefinitie.

Nadat u klaar bent, kopieert u de onderliggende werkstroomdefinitie naar een leeg workflow.json bestand.

De onderliggende werkstroomdefinitie kopiëren

Selecteer Code in azure Portal in het werkstroommenu onder Ontwikkelaars.
Kopieer in het venster codeweergave de volledige werkstroomdefinitie, bijvoorbeeld:
Sla de werkstroomdefinitie op in een leeg bestand met de naam workflow.json.

Parameterverwijzingen in workflow.json

Wanneer u naar parameters in het workflow.json-bestand verwijst, moet u de parameternamen weergeven die het achtervoegsel _#workflowname# op de volgende manier gebruiken:

"name": "@parameters('<parameter-name>_#workflowname#')"

Voorbeeld:

"name": "@parameters('sharepoint-folder-path_#workflowname#')"

Verbindingsverwijzingen in workflow.json

Wanneer u verwijst naar verbindingen in het workflow.json bestand, moet u de verbindingsnamen weergeven die het achtervoegsel _#werkstroomnaam# op de volgende manier gebruiken:

"referenceName": "<connector-ID>_#workflowname#",
"connectionName": "<connector-ID>_#workflowname#"

Voorbeeld:

"referenceName": "azureaisearch_#workflowname#",
"connectionName": "azureaisearch_#workflowname#"

Zie De connector-id zoeken voor meer informatie over de connector-id.

Een manifest.json-bestand maken

Het bestand manifest.json beschrijft de relatie tussen een werkstroom en gerelateerde onderdelen. Op dit moment moet u dit bestand handmatig maken of kunt u het manifest.json-bestand opnieuw gebruiken op basis van een bestaande vooraf gedefinieerde sjabloon in de opslagplaats voor werkstroomsjablonen van Azure Logic Apps in GitHub. Wanneer u het manifest.json-bestand maakt, moet u de namen en stijlconventies controleren.

In de volgende tabel worden de kenmerken in het manifest.json-bestand beschreven:

Naam van kenmerk	Vereist	Weergegeven als	Beschrijving
`title`	Ja	< sjabloontitel>	De titel die wordt weergegeven in de galerie met sjablonen, die wordt geopend wanneer u een werkstroom toevoegt vanuit een sjabloon in Azure Portal.
`description`	Ja	< sjabloonbeschrijving>	De beschrijving van de sjabloon, die wordt weergegeven in het overzichtsvenster van de sjabloon in de galerie met sjablonen.
`prerequisites`	Nee	< sjabloonvereisten>	Alle vereisten waaraan moet worden voldaan voor het gebruik van de sjabloon. Wordt weergegeven in het overzichtsvenster van de sjabloon. U kunt vanuit deze sectie een koppeling maken naar andere documenten.
`tags`	Nee	< template-tags-array>	De sjabloontags die moeten worden gebruikt voor het zoeken of filteren van sjablonen.
`skus`	Ja	`standard`, `consumption`	Het werkstroomtype van de logische app dat wordt ondersteund door de sjabloon. Als u het niet zeker weet, gebruikt `standard`u .
`kinds`	Nee	`stateful`, `stateless`	De werkstroommodus, waarmee wordt bepaald of uitvoeringsgeschiedenis en bewerkingsstatussen worden opgeslagen. Standaard zijn alle werkstromen beschikbaar in zowel stateful als stateless modus. Als uw werkstroom alleen wordt uitgevoerd in de stateful modus, gebruikt u dit kenmerk om deze vereiste expliciet te maken.
`detailsDescription`	Nee	Zie beschrijving.	Alle andere gedetailleerde beschrijvingsinformatie voor de sjabloon.
`details`	Nee	Zie beschrijving.	Sjabloongegevens die moeten worden gebruikt voor het filteren van de sjablonengalerie. - `By`: De sjabloonuitgever, bijvoorbeeld `Microsoft`. - `Type`: `Workflow` - `Trigger`: het triggertype, bijvoorbeeld `Recurrence`, of `Event``Request`.
`artifacts`	Ja	< artefactenmatrix>	Alle relevante bestanden in het sjabloonpakket en bevatten de volgende kenmerken: - `type`: Het bestandstype, dat de juiste locatie bepaalt voor waar het bestand moet worden gekopieerd, bijvoorbeeld `workflow`. - `file`: de bestandsnaam en extensie, bijvoorbeeld workflow.json.
`images`	Ja	Zie beschrijving.	De namen van afbeeldingsbestanden voor zowel browserlichte als donkere thema's: - `light`: Afbeeldingsnaam voor licht thema, bijvoorbeeld werkstroomlicht - `dark`: Afbeeldingsnaam voor donker thema, bijvoorbeeld werkstroom donker.
`parameters`	Ja, maar kan leeg zijn als er geen bestaat	< werkstroomparameters-matrix>	De parameters voor de acties in de werkstroomsjabloon. Voor elke parameter moet u de volgende eigenschappen opgeven: - `name`: De parameternaam moet het achtervoegsel hebben, `_#workflowname#`. Gebruik alleen alfanumerieke tekens, afbreekstreepjes of onderstrepingstekens en volg deze notatie: `<parameter-name>_#workflowname#` - `displayName`: de beschrijvende weergavenaam van de parameter. Zie namen en stijlconventies. - `type`: het gegevenstype van de parameter, bijvoorbeeld `String` of `Int`. - `default`: de standaardwaarde van de parameter, indien van toepassing. Als er geen is, laat u deze waarde staan als een lege tekenreeks. - `description` De details van de parameter en andere belangrijke of nuttige informatie. - `required`: of `true``false`
`connections`	Ja, maar kan leeg zijn als er geen bestaat.	< verbindingen-matrix>	De verbindingen die moeten worden gemaakt met behulp van de werkstroomsjabloon. Elke verbinding heeft de volgende eigenschappen: - `connectorId`: De connector-id moet het achtervoegsel hebben, `_#workflowname#`. Gebruik alleen alfanumerieke tekens, afbreekstreepjes of onderstrepingstekens en volg deze notatie: `<connector-ID>_#workflowname#` Zie De connector-id zoeken om de connector-id te vinden. - `kind`: het runtimehosttype van de connector, dat is `inapp` voor ingebouwde bewerkingen en serviceproviderconnectors of `shared` voor beheerde, door Azure gehoste connectors. In de galerie connectors worden ingebouwde bewerkingen en serviceproviderconnectors gelabeld als In App, terwijl beheerde connectors worden gelabeld als Gedeeld.
`featuredConnections`	Nee	< uitgelichte-verbindingen-array>	In de galerie met sjablonen worden standaard pictogrammen weergegeven voor de vooraf gemaakte bewerkingen en connectors in Azure Logic Apps die door elke sjabloon worden gebruikt. Als u pictogrammen voor andere bewerkingen wilt opnemen, kunt u het `featuredConnections` kenmerk gebruiken. Elke bewerking moet de volgende kenmerken hebben: - `kind`: Het bewerkingstype - `type`: Het bewerkingstype Zie Het type en het type van de bewerking zoeken voor de sectie featuredConnections om deze waarden te vinden.

Voeg in het manifest.json-bestand voor uw werkstroomsjabloonpakket dezelfde afbeeldingsnamen toe aan de images sectie zonder de bestandsextensie .png , bijvoorbeeld:

"images": {
    "dark": "workflow-dark",
    "light": "workflow-light"
}

De connector-id zoeken

Voer de volgende stappen uit om de connector-id te vinden die moet worden gebruikt voor een verbinding in het manifest.json bestand of een verbindingsreferentie in het workflow.json-bestand :

Open uw logische app-resource in Azure Portal.
Selecteer Verbindingen in het menu van de logische app onder Werkstromen.
Selecteer het tabblad JSON-weergave .
Voer de volgende stappen uit op basis van het verbindingstype:
- Voor een beheerde 'gedeelde' API-verbinding die wordt gehost en uitgevoerd in Azure:
  1. Zoek de managedApiConnections sectie.
  2. Kopieer en sla de connection waarde in het id kenmerk op, maar vervang eventuele persoonlijke of gevoelige gegevens, zoals de abonnements-id, de naam van de resourcegroep, enzovoort, door#<item>#:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>
    
    In de volgende tekst ziet u bijvoorbeeld de connector-id voor de SharePoint-connector:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline
- Voor een serviceproviderverbinding die wordt gehost op de Azure Logic Apps-runtime met één tenant:
  1. Zoek de serviceProviderConnections sectie.
  2. Zoek voor elke verbinding het id kenmerk in het serviceProvider kenmerk.
  3. Kopieer en sla de volgende waarde op:
    
    /serviceProviders/<connection-name>
    
    In de volgende tekst ziet u bijvoorbeeld de connector-id voor de Azure AI Search-connector:
    
    /serviceProviders/azureaisearch.

De eigenschappen 'kind' en 'type' voor featuredConnections zoeken

In het manifest.json-bestand kan de featuredConnections sectie pictogrammen bevatten voor andere bewerkingen die u wilt opnemen in de sjablonengalerie in Azure Portal. Voor deze sectie, een matrix, moet u de kind en type kenmerken voor elke bewerking opgeven.

Volg deze stappen in Azure Portal met uw geopende werkstroom om deze kenmerkwaarden op te halen:

Selecteer Code in het werkstroommenu onder Ontwikkelaars.
Zoek in het codeweergavevenster in de actions sectie de gewenste bewerking en zoek vervolgens de kind en type waarden.

Sjabloonpakket toevoegen aan GitHub-opslagplaats

Als u uw sjabloonpakket wilt publiceren naar de galerie met werkstroomsjablonen in Azure Portal, moet u uw GitHub-account instellen, naar de opslagplaats voor werkstroomsjablonen in GitHub voor Azure Logic Apps gaan en een pull-aanvraag voor uw sjabloonpakket maken, zodat het Azure Logic Apps-team uw pull-aanvraag kan controleren en valideren

Maak een GitHub-account als u er nog geen hebt.

Zie Aan de slag met uw GitHub-account voor meer informatie.
Ga naar de opslagplaats voor werkstroomsjablonen met de naam LogicAppsTemplates voor Azure Logic Apps in GitHub.
Maak uw eigen fork, een externe kopie van de LogicAppsTemplates-opslagplaats in GitHub.

Zie Forking a repository voor meer informatie.
Als u lokaal wilt werken, kloont u uw fork naar uw computer.
1. Volg deze stappen om Git te downloaden, te installeren en in te stellen.
2. Ga naar uw fork, met de volgende URL:
  
  https://github.com/<your-username>/LogicAppsTemplates
3. Maak op uw lokale computer een map met de naam GitHub als u er nog geen hebt. Kloon niet naar een OneDrive-synchronisatie ed map.
4. Volg deze stappen om uw fork te klonen, niet de productieopslagplaats.
5. Volg deze stappen in uw lokale opslagplaats om een werkbranch te maken.
6. Nadat u de werkbranch hebt uitgecheckt, gaat u naar het hoofdniveau in uw lokale opslagplaats en maakt u de map met het sjabloonpakket.
7. Voeg uw sjabloonbestanden toe aan de map met sjabloonpakketten en werk het manifest.json-bestand op hoofdniveau bij met de mapnaam.
8. Wanneer u klaar bent om uw wijzigingen door te voeren in uw lokale opslagplaats, zoals het opslaan van een momentopname, voert u de volgende opdrachten uit met behulp van het Git-opdrachtregelprogramma of andere hulpprogramma's:
  
  git add .
  
  git commit -m "<commit-short-description>"
9. Voer de volgende opdracht uit om uw momentopname te uploaden naar uw externe fork:
  
  git push origin <your-working-branch>

Maak in GitHub een pull-aanvraag om uw werkvertakking< met de hoofdvertakking in de >

Ga naar de pagina Pull-aanvragen van de opslagplaats en selecteer Nieuwe pull-aanvraag.
Selecteer Onder Wijzigingen vergelijken de optie Vergelijken tussen vorken.

Zorg ervoor dat uw pull-aanvraag de volgende instellingen heeft en selecteer vervolgens Pull-aanvraag maken.

Basisopslagplaats	Basis	Hoofdopslagplaats	Vergelijken
Azure/LogicAppsTemplates	voornaamste	< >gebruikersnaam/LogicAppsTemplates	*< uw werkvertakking>*

Voer een titel en beschrijving in voor uw pull-aanvraag. Selecteer Pull-aanvraag maken om te voltooien.
Wacht tot het Azure Logic Apps-team uw pull-aanvraag controleert.

Zie Een pull-aanvraag maken vanuit een fork voor meer informatie.

Namen en stijlconventies

Gebied	Conventie
Gevoelige gegevens	Voeg geen persoonlijke en gevoelige gegevens toe aan sjabloonbestanden, schermopnamen, beschrijvingen of testgegevens. Deze gegevens bevatten bijvoorbeeld abonnements-id's, gebruikersnamen, wachtwoorden enzovoort.
Mapnamen	Gebruik indien mogelijk kleine letters en afbreekstreepjes om de leesbaarheid te vereenvoudigen. Zie Hoofdlettergebruik – Microsoft Style Guide.
Namen van afbeeldingsbestanden	Gebruik de .png als bestandsnaamextensie, kleine letters en afbreekstreepjes, bijvoorbeeld workflow-light.png.
Product-, service-, technologie- en merknamen	Volg de officiële spelling en hoofdlettergebruik. Bijvoorbeeld: - Wanneer u naar de servicenaam of het platform verwijst, gebruikt u 'Azure Logic Apps', niet 'Logic Apps'. - Wanneer u naar de resource of het exemplaar verwijst, gebruikt u 'logische apps' of 'logische app', niet 'Logische app' of 'Logic Apps'. - Wanneer u verwijst naar de volgorde van triggers en acties, gebruikt u 'werkstroom voor logische apps' of 'werkstroom'.
Afkortingen en acroniemen	Gebruik de uitgebreide naam voor product, service, technologie, merknamen en ongebruikelijke technische termen, niet afkortingen of acroniemen. Algemene acroniemen, zoals HTTP en URL, zijn acceptabel. Gebruik bijvoorbeeld 'Visual Studio Code', niet 'VS Code'. Zie Acroniemen – Microsoft Style Guide.
Overige tekst	- Gebruik zinsvoorbeeld voor titels, koppen en hoofdtekstinhoud, wat betekent dat u alleen de eerste letter hoofdletters maakt, tenzij u product, service, technologie of merknaam hebt. - Gebruik geen hoofdletters voor gewone zelfstandige naamwoorden en artikelen, zoals "a", "an", "and", "or", "the", enzovoort.
Spraak	- Gebruik de stem van de tweede persoon (u en uw), in plaats van een derde persoon (gebruikers, ontwikkelaars, klanten) tenzij u naar specifieke rollen moet verwijzen. Zie Persoon – Microsoft Style Guide. - Gebruik indien mogelijk een actieve, directe, maar vriendelijke toon. Actieve stem richt zich op het onderwerp en werkwoord in tekst, terwijl passieve stem zich richt op het object in tekst.
Woordenschat	- Gebruik eenvoudige, algemene, alledaagse woorden, zoals 'gebruik', in plaats van 'gebruiken' of 'gebruiken'. - Gebruik geen woorden, woordgroepen, jargon, colloquialismen, idiomen of taal die niet goed in verschillende talen worden vertaald. - Gebruik 'alstublieft' alleen voor specifieke scenario's. Zie alsjeblieft – Microsoft Style Guide. - Gebruik bijvoorbeeld 'bijvoorbeeld' of 'zoals', niet 'bijvoorbeeld' of 'dat wil zeggen'. - Gebruik geen directionele termen zoals 'hier', 'boven', 'onder', 'rechts' en 'links', die niet toegankelijk zijn.
Interpunctie	- Neem voor een reeks items de laatste komma op vóór de combinatie, zoals 'en'. Bijvoorbeeld appels, sinaasappels en bananen. Zie komma's – Microsoft Style Guide. - Volledige zinnen beëindigen met de juiste interpunctie. Gebruik geen uitroeptekens. Zie interpunctie – Microsoft Style Guide.
Opmaak	- Voor code volgt u de stijlconventie voor de taal van die code. - Gebruik geen in code vastgelegde koppelingen, waardoor de URL's worden verbroken. Vraag in uw pull-aanvraag om een omleidingskoppeling om in plaats daarvan te gebruiken. - Gebruik voor koppelingen de volgende indeling: `For more information, see [descriptive-link-text](URL)]`. - Gebruik beschrijvende koppelingstekst, niet algemene of vage koppelingstekst, zoals '.`See [here](URL)`' - Gebruik alleen getallen voor stappen in een procedure, niet voor lijsten die geen specifieke volgorde hebben. Zie Lijsten – Microsoft Style Guide. - Gebruik slechts één spatie na interpunctie, tenzij u code inspringt.

Zie de Microsoft Style Guide en global writing tips voor meer richtlijnen.

Werkstromen voor logische apps maken van vooraf gedefinieerde sjablonen

Feedback

Is deze pagina nuttig?

Last updated on 2025-07-10