Creare e pubblicare modelli di flusso di lavoro per App per la logica di Azure

2025-07-23

Si applica a: Azure Logic Apps (Consumo + Standard)

App per la logica di Azure offre modelli predefiniti di automazione riutilizzabili e flussi di lavoro di integrazione che è possibile usare per velocizzare il processo di creazione di applicazioni di integrazione. Questi modelli seguono modelli di uso comune e consentono di semplificare lo sviluppo fornendo un punto di partenza o una linea di base con la logica di business e le configurazioni predefinite.

I modelli possono includere uno o più flussi di lavoro insieme alle relative connessioni, parametri e documentazione. Azure Logic Apps offre i seguenti tipi di modello:

Tipo di modello	Descrizione
Flusso di lavoro	Modelli riutilizzabili che creano singoli flussi di lavoro.
Acceleratori	Soluzioni in bundle che contengono più flussi di lavoro correlati.

È possibile trovare questi modelli nella raccolta di modelli, che si apre quando si sceglie di creare un flusso di lavoro iniziando con un modello. La raccolta contiene già modelli creati da Microsoft per modelli di progettazione e integrazione comuni.

Non solo è possibile avviare lo sviluppo usando i modelli di flusso di lavoro, ma è possibile creare e pubblicare modelli di flusso di lavoro solo per l'organizzazione all'interno di una sottoscrizione di Azure o condividerli con altri utenti. Il modello può includere elementi come schemi, mappe e assembly personalizzati.

I modelli organizzativi consentono di standardizzare i modelli di integrazione, condividere le procedure consigliate e riutilizzare le soluzioni all'interno dell'azienda senza renderle pubbliche. Questa funzionalità è particolarmente utile per le aziende che vogliono promuovere la coerenza mantenendo le opzioni aperte per la flessibilità. Indipendentemente dal fatto che gli scenari includano l'incorporamento di API interne, la gestione di logica specifica del dominio o l'applicazione di modelli architetturali, i modelli organizzativi consentono di ridimensionare e crescere mantenendo il controllo.

I modelli di App per la logica di Azure offrono anche le funzionalità seguenti:

Pubblicare modelli in modalità di test o produzione, che consentono di sperimentare e controllare in modo sicuro le versioni.
Usare direttamente LE API e i sistemi interni nei modelli senza doverli esternalizzare.
Scarica i pacchetti dei modelli e, facoltativamente, aggiungili al repository pubblico dei modelli di flusso di lavoro per Azure Logic Apps su GitHub.
Portare i modelli dal test alla produzione utilizzando la gestione integrata per il ciclo di vita in Azure DevOps, che offre organizzazione al team, mantenendo l'agilità.
Come risorse di prima classe in Azure, i template supportano il controllo degli accessi basato sui ruoli di Azure.
- È possibile gestire le autorizzazioni dei modelli come qualsiasi altra risorsa di Azure.
  
  Queste autorizzazioni rispettano gli ambiti di sottoscrizione e ruolo, il che significa che gli sviluppatori possono visualizzare e accedere solo ai modelli nelle sottoscrizioni a cui gli sviluppatori hanno accesso.
  
  Questa funzionalità offre un controllo di livello aziendale su chi può creare, visualizzare e distribuire modelli. Si ha il controllo completo sul modo in cui si vogliono organizzare i modelli in modo che sia possibile assicurarsi che i team giusti ottengano l'accesso ai modelli di automazione necessari.

Lo screenshot seguente mostra la raccolta di modelli di flusso di lavoro con ambito di un'organizzazione e una sottoscrizione di Azure con modelli di esempio che mostrano etichette di stato come Test e Produzione:

Questa guida illustra come creare e pubblicare un modello di flusso di lavoro nei modi seguenti:

Per usare solo l'organizzazione. Vedere Creare un modello di flusso di lavoro - Portale di Azure.

Questo percorso include la creazione del modello usando la procedura guidata nel portale di Azure per specificare i flussi di lavoro dell'app per la logica di origine, le informazioni sul modello e le opzioni da pubblicare per i test prima di rilasciare il modello nell'ambiente di produzione.
A disposizione di tutti i clienti Azure. Vedere Creare un modello di flusso di lavoro - Manuale.

Questo percorso richiede di creare un pacchetto modello e inviare il pacchetto come richiesta di pull al repository di modelli di flusso di lavoro pubblico per Azure Logic Apps in GitHub.

Prerequisiti

Account e sottoscrizione di Azure. Se non si ha una sottoscrizione, è possibile iscriversi per creare un account Azure gratuito.
La risorsa e il flusso di lavoro dell'app per la logica Standard distribuiti da usare come definizione del flusso di lavoro di origine per il modello.

Prima di creare il modello, è necessario distribuire la risorsa e il flusso di lavoro dell'app per la logica. Assicurarsi di parametrizzare correttamente tutti i valori che l'utente finale del flusso di lavoro deve fornire, anziché impostare come hardcode tali valori.

Se questa risorsa e il flusso di lavoro non sono disponibili, vedere gli articoli seguenti:
- Creare un esempio di flusso di lavoro di app per la logica A consumo
- Creare un esempio di flusso di lavoro dell'app Standard per la logica
Screenshot che mostrano immagini di anteprima di sola lettura per il flusso di lavoro creato dal modello. Usare l'estensione del nome file .png per questi screenshot. Queste immagini di anteprima per il modello vengono visualizzate nel riquadro di panoramica del modello nella raccolta modelli.

Per archiviare queste immagini in modo che il modello possa usarle, è necessario un account di archiviazione di Azure e un contenitore BLOB.

Per creare queste immagini, seguire questa procedura:
1. Nel portale di Azure, aprire la risorsa e il flusso di lavoro dell'app per la logica di origine nella finestra di progettazione.
2. Configurare il flusso di lavoro per creare due screenshot: una versione che funziona con il tema chiaro di un Web browser e un'altra versione che funziona con il tema scuro di un Web browser.
3. Creare gli screenshot usando lo strumento di acquisizione dello schermo preferito. Non includere troppi spazi vuoti intorno al flusso di lavoro.
4. Salvare ogni immagine usando l'estensione .png nome file e un nome che segue le convenzioni di stile e nomi di stile, ad esempio nome-immagine><-light.png e <nome-immagine>-dark.png.
5. Aggiungere le immagini al contenitore BLOB nell'account di archiviazione di Azure. Copiare e salvare l'URL del BLOB per ogni immagine in modo da poter fare riferimento in un secondo momento alle immagini dal modello.
  
  Importante
  
  L'URL include una chiave o un token di firma di accesso condiviso che concede autorizzazioni, ad esempio, ai servizi di archiviazione. Assicurarsi di proteggere la chiave di firma di accesso condiviso proprio come si protegge una chiave dell'account dall'uso non autorizzato.

Procedure consigliate

Questo elenco fornisce le procedure consigliate da seguire quando si crea il modello di flusso di lavoro:

Non usare proprietà hardcoded e i relativi valori nelle definizioni di trigger e azione.
Fornire più contesto sulle definizioni di trigger e azione aggiungendo commenti descrittivi e utili.
Risorse e flussi di lavoro standard dell'app per la logica
- Usare le operazioni predefinite il più possibile. Ad esempio, il connettore archiviazione BLOB di Azure include le versioni seguenti disponibili per i flussi di lavoro Standard:
  - Le operazioni predefinite del provider di servizi vengono visualizzate nella raccolta connettori sotto il filtro predefinito. Queste versioni sono ospitate ed eseguite con il runtime single-tenant di Azure Logic Apps, offrendo prestazioni di throughput superiori e altri vantaggi migliorati.
  - Le operazioni del connettore API gestito ospitate in Azure vengono visualizzate nella raccolta dei connettori sotto il filtro Condiviso. Queste versioni sono ospitate ed eseguite in Azure multi-tenant usando risorse globali condivise.

Creare un modello di flusso di lavoro

In base al fatto che si voglia rendere disponibile il modello di flusso di lavoro solo per l'organizzazione o per tutti gli utenti in Azure, seguire la procedura corrispondente:

Solo organizzazione
Tutto Azure

Questi passaggi descrivono come creare e pubblicare un modello di flusso di lavoro disponibile solo per i membri di una sottoscrizione di Azure specifica.

Nella casella di ricerca del portale di Azure trovare e selezionare modelli di app per la logica.
Nella barra degli strumenti della pagina Modelli di Logic Apps, selezionare Crea.

Nella scheda Informazioni di base della pagina Crea un modello di App per la logica di Azure specificare le informazioni seguenti:

Parametro	Obbligatorio	Valore	Descrizione
Abbonamento	Sì	<Azure-subscription-name>	Sottoscrizione di Azure da usare con il modello di flusso di lavoro.
Gruppo di risorse	Sì	<resource-group-name>	Nome del gruppo di risorse di Azure da usare con il modello.
Nome	Sì	<template-name>	Nome della risorsa template del flusso di lavoro.
Regione	Sì	<Regione di Azure>	Area di Azure in cui creare la risorsa modello di flusso di lavoro.

Al termine, selezionare Rivedi e crea. Esaminare le informazioni fornite e selezionare Crea.

Azure crea la risorsa modello.

Scegliere quindi la definizione del flusso di lavoro di origine da usare per il modello.

Scegliere la definizione del flusso di lavoro di origine

Nel menu della risorsa modello, in Modello, selezionare Modello.
Nella scheda Flussi di lavoro della pagina Modello selezionare Aggiungi.

Nel riquadro Gestisci flussi di lavoro in questo modello, nella scheda Scegli flussi di lavoro specificare le informazioni seguenti:

Parametro	Obbligatorio	Valore	Descrizione
Abbonamento	Sì	<Azure-subscription-name>	Nome della sottoscrizione di Azure con l'app per la logica di origine.
Gruppo di risorse	Sì	<resource-group-name>	Nome del gruppo di risorse di Azure contenente l'app logica originale.
Istanza di Logic App	Sì	<source-logic-app>	Nome dell'app per la logica di origine con il flusso di lavoro che si vuole usare.
Flussi di lavoro	Sì	<flussi di lavoro di origine>	Per un'app per la logica a consumo, selezionare l'unico flusso di lavoro esistente da usare nel modello. Per un'app per la logica Standard, selezionare almeno un flusso di lavoro da usare nel modello.

Al termine, selezionare Avanti.

Nella scheda Configura flussi di lavoro specificare le informazioni seguenti per ogni flusso di lavoro di origine selezionato:

Parametro	Obbligatorio	Valore	Descrizione
Nome flusso di lavoro	Sì	<JSON-workflow-name>	Nome JSON per il flusso di lavoro che può usare solo lettere minuscole, numeri e trattini e che è possibile rinominare una sola volta.
State	Sì	Con stato o senza stato	Se salvare e archiviare la cronologia di esecuzione del flusso di lavoro, gli input delle operazioni e gli output delle operazioni, per impostazione predefinita.
Sommario	Sì	<breve descrizione>	Breve riepilogo generale sullo scopo del modello.
Descrizione	NO	<descrizione dettagliata>	Descrizione con informazioni più dettagliate sul modello.
Prerequisiti	NO	<Prerequisiti>	Tutti i requisiti necessari prima di poter usare il modello.

Nella sezione Immagini flusso di lavoro specificare le immagini di anteprima del flusso di lavoro da usare per il riquadro di panoramica del modello nella raccolta modelli. Questo riquadro include altre informazioni sul modello.

Immagine del flusso di lavoro	Descrizione
URL SAS in modalità chiara	URL della firma di accesso condiviso per l'immagine di anteprima del flusso di lavoro con tema chiaro archiviata in un contenitore BLOB dall'account di archiviazione di Azure.
URL di firma di accesso condiviso in modalità scura	URL della firma di accesso condiviso per l'immagine di anteprima del flusso di lavoro con tema scuro archiviata in un contenitore BLOB dall'account di archiviazione di Azure.

Al termine, seleziona Salva.

È possibile salvare il modello in qualsiasi momento durante il processo di creazione. Ogni volta che si salva lo stato di avanzamento, la convalida viene eseguita automaticamente per determinare se esistono errori, ad esempio azioni non supportate o valori senza parametri. Non è necessario correggere immediatamente gli errori quando li si trovano, ma è necessario correggerli prima della pubblicazione.
Nella scheda Connessioni esaminare e confermare le connessioni estratte automaticamente da Azure dai flussi di lavoro di origine.

Non è necessario eseguire altre azioni.
Quando si è pronti, selezionare Avanti.

Personalizzare i parametri

Nella scheda Parametri aggiungere la personalizzazione per tutti i parametri desiderati per il flusso di lavoro.

Nella scheda Parametri selezionare l'icona di modifica per il parametro .

Specificare le informazioni seguenti per il parametro :

Proprietà	Obbligatoria	Descrizione
Nome visualizzato	Sì	Nome del parametro visualizzato nel portale di Azure.
Valore predefinito	NO	Il valore predefinito per il parametro.
Descrizione	NO	Descrizione dello scopo del parametro.
Campo obbligatorio	NO	Indica se il flusso di lavoro richiede il parametro .

Al termine, seleziona Salva.

Fornire informazioni sul modello

La scheda Profilo specifica informazioni sul modello visualizzato nella raccolta di modelli, ad esempio il nome visualizzato del modello, il nome dell'editore, i connettori e altri metadati.

Nella scheda Profilo specificare le informazioni seguenti sul modello:

Proprietà	Obbligatoria	Descrizione
Nome visualizzato	Sì	Nome visualizzato del modello del flusso di lavoro visualizzato nella raccolta modelli.
By	Sì	Nome dell'autore del modello di flusso di lavoro.
Sommario	Sì	Descrizione del flusso di lavoro creato dal modello.
Connettori in primo piano	Sì	Selezionare i tipi di connettore primario nel modello di flusso di lavoro.
Categoria	NO	Categoria a cui appartiene il modello.
Etichette	NO	Eventuali tag da usare per l'etichettatura del flusso di lavoro.

Quando si è pronti, selezionare Avanti.
Nella scheda Riepilogo esaminare e confermare tutte le informazioni fornite.

Pubblicare per i test

Quando si è pronti per testare il modello, è possibile pubblicare il modello per i test.

Nella scheda Riepilogo o in una scheda precedente, nella parte inferiore della scheda, nell'elenco Salva selezionare Salva e pubblica per i test.

Azure pubblica il modello, che visualizza l'etichetta Testing , nella raccolta di modelli.
Per testare il nuovo modello, seguire la procedura descritta in Creare flussi di lavoro da modelli predefiniti , ma seguendo questa procedura:
1. Nell'elenco Stato selezionare Pubblicato per il test. Nella riga filtri selezionare Modelli personali.
  
  Il modello viene visualizzato con l'etichetta Test , ad esempio:
2. Completare la creazione del flusso di lavoro, il test del modello e apportare eventuali modifiche necessarie.

Pubblicare per la produzione

Per modificare l'etichetta del modello da Testing a Production nella raccolta modelli, seguire questa procedura:

Nel portale di Azure trovare e aprire la risorsa modello.
Nella barra laterale del modello, in Modello, selezionare Modello.
Nella pagina Modello selezionare Avanti e ripetere finché non si apre la scheda Profilo .
Nell'elenco Salva selezionare Salva e pubblica per la produzione.

Rimuovere un modello dalla galleria

Se si desidera rimuovere temporaneamente o definitivamente il modello di flusso di lavoro personalizzato dalla raccolta modelli, è possibile annullare la pubblicazione del modello.

Nel portale di Azure trovare e aprire la risorsa modello.
Nella barra laterale del modello, in Modello, selezionare Modello.
Nella pagina Modello selezionare Avanti e ripetere finché non si apre la scheda Profilo .
Nell'elenco Salva selezionare Salva e annulla la pubblicazione del modello.

Questi passaggi descrivono come creare e pubblicare un modello di flusso di lavoro disponibile per tutti gli utenti da usare in Azure. Per questo approccio, è necessario creare un pacchetto modello.

Che cos'è in un pacchetto modello?

La tabella seguente descrive i file obbligatori e facoltativi in un pacchetto modello:

Nome del file	Obbligatoria	Descrizione
workflow.json	Sì	Un file JSON con la definizione del flusso di lavoro.
manifest.json	Sì	Un file JSON con informazioni sul flusso di lavoro e sui componenti correlati.
*<image-name>-dark.png*	Sì	Un file di immagine con il flusso di lavoro come screenshot di sola lettura in formato .png e funziona con il tema scuro di un browser.
*<image-name>-light.png*	Sì	Un file di immagine con il flusso di lavoro come screenshot di sola lettura in formato .png e funziona con il tema chiaro di un browser.
*<map-name>.json, .xml, or .xslt*	NO	Tutti gli artefatti, ad esempio mappe e schemi che supportano il modello del flusso di lavoro.
*<custom-assembly>.dll*	NO	Tutti gli assembly personalizzati che supportano il modello di flusso di lavoro.
readme.md	NO	Un file Markdown con istruzioni, procedure o altre informazioni per il modello di flusso di lavoro.

È anche possibile includere qualsiasi altro file per gestire e supportare il modello, ad esempio file con dati di test o di esempio.

Creare una cartella del pacchetto modello

Prima di creare la cartella del pacchetto modello, acquisire familiarità con nomi e convenzioni di stile.
Per semplificare l'esplorazione, l'organizzazione e la manutenzione del repository dei modelli, usare la sintassi seguente per il nome della cartella e il minor numero di parole per evitare di superare il limite di caratteri per i percorsi di file:

<workflow-task>-<product>-<pattern-or-protocol, if any>

Per esempi, vedere il repository dei modelli di flusso di lavoro per App per la logica di Azure in GitHub.
Per registrare correttamente la cartella del pacchetto modello, è necessario aggiungere il nome della cartella al file di manifest.json a livello radice del repository.

Creare un file workflow.json

Il file workflow.json contiene la definizione sottostante per un flusso di lavoro in formato JSON. Per creare il file workflow.json, è necessario copiare e salvare la definizione del flusso di lavoro come file denominato workflow.json.

Per ottenere la definizione del flusso di lavoro più semplice e migliore, creare il flusso di lavoro usando la finestra di progettazione. Assicurarsi di esaminare le procedure consigliate per il flusso di lavoro insieme ai nomi e alle convenzioni di stile. In alternativa, come punto di partenza, è possibile usare i modelli di flusso di lavoro predefiniti dalla raccolta di modelli nel portale di Azure.

Durante la compilazione del flusso di lavoro, la finestra di progettazione include automaticamente riferimenti a eventuali connessioni predefinite, provider di servizi, connessioni API gestite o librerie nella definizione del flusso di lavoro sottostante.

Al termine, copiare la definizione del flusso di lavoro sottostante in un file di workflow.json vuoto.

Copiare la definizione del flusso di lavoro sottostante

Nel menu del flusso di lavoro del portale di Azure selezionare Codice in Sviluppo.
Dalla finestra di visualizzazione codice copiare l'intera definizione del flusso di lavoro, ad esempio:
In un file vuoto denominato workflow.json, salvare la definizione del flusso di lavoro.

Riferimenti ai parametri in workflow.json

Quando si fa riferimento ai parametri nel file workflow.json, è necessario riflettere i nomi dei parametri che usano il suffisso _#workflowname# nel modo seguente:

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

Ad esempio:

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

Riferimenti alla connessione in workflow.json

Quando si fa riferimento alle connessioni nel file workflow.json, è necessario riflettere i nomi di connessione che usano il suffisso _#workflowname# nel modo seguente:

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

Ad esempio:

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

Per altre informazioni sull'ID connettore, vedere Trovare l'ID connettore.

Creare un file manifest.json

Il file manifest.json descrive la relazione tra un flusso di lavoro e i componenti correlati. Attualmente, è necessario creare manualmente questo file oppure riutilizzare il file manifest.json da un modello esistente predefinito nel repository dei modelli di flusso di lavoro di App per la logica di Azure in GitHub. Quando si crea il file di manifest.json, assicurarsi di esaminare i nomi e le convenzioni di stile.

Nella tabella seguente vengono descritti gli attributi nel file manifest.json:

Nome dell'attributo	Obbligatoria	Valore	Descrizione
`title`	Sì	<template-title>	Titolo visualizzato nella raccolta di modelli, che viene aperto quando si aggiunge un flusso di lavoro da un modello nel portale di Azure.
`description`	Sì	<template-description>	Descrizione del modello, visualizzata nel riquadro di panoramica del modello nella raccolta modelli.
`prerequisites`	NO	<prerequisiti di modello>	Eventuali prerequisiti da soddisfare per l'uso del modello. Viene visualizzato nel riquadro di panoramica del modello. È possibile collegarsi ad altri documenti di questa sezione.
`tags`	NO	<template-tags-array>	Tag del modello da usare per la ricerca o il filtro dei modelli.
`skus`	Sì	`standard`, `consumption`	Tipo di flusso di lavoro dell'app per la logica supportato dal modello. Se non si è certi, usare `standard`.
`kinds`	NO	`stateful`, `stateless`	Modalità flusso di lavoro, che determina se gli stati della cronologia di esecuzione e dell'operazione vengono archiviati. Per impostazione predefinita, tutti i flussi di lavoro sono disponibili sia in modalità con stato che senza stato. Se il flusso di lavoro viene eseguito solo in modalità con stato, usare questo attributo per rendere esplicito questo requisito.
`detailsDescription`	NO	Vedere la descrizione.	Qualsiasi altra descrizione dettagliata per il modello.
`details`	NO	Vedere la descrizione.	Informazioni sul modello da usare per filtrare la raccolta di modelli. - `By`: autore del modello, ad esempio `Microsoft`. - `Type`: `Workflow` - `Trigger`: Ttipo di trigger, ad esempio, `Recurrence`, `Event`, o `Request`.
`artifacts`	Sì	<artifacts-array>	Tutti i file pertinenti nel pacchetto modello e include gli attributi seguenti: - `type`: tipo di file, che determina il percorso appropriato per dove copiare il file, ad esempio `workflow`. - `file`: il nome e l'estensione del file, ad esempio, workflow.json.
`images`	Sì	Vedere la descrizione.	Nomi di file di immagine del flusso di lavoro per temi chiari e scuri del browser: - `light`: nome dell'immagine per il tema chiaro, ad esempio luce del flusso di lavoro - `dark`: nome dell'immagine per il tema scuro, ad esempio, scuro del flusso di lavoro..
`parameters`	Sì, ma può essere vuoto se non esiste	<workflow-parameters-array>	Parametri per le azioni nel modello del flusso di lavoro. Per ogni parametro, è necessario specificare le proprietà seguenti: - `name`: il nome del parametro deve avere il suffisso `_#workflowname#`. Usare solo caratteri alfanumerici, trattini o caratteri di sottolineatura, e seguire questo formato: `<parameter-name>_#workflowname#` - `displayName`: nome visualizzato descrittivo del parametro. Vedere Nomi e convenzioni di stile. - `type`: tipo di dati del parametro, ad esempio `String` o `Int`. - `default`: valore predefinito del parametro, se presente. In caso contrario, lasciare questo valore come stringa vuota. - `description` Dettagli del parametro e altre informazioni importanti o utili. - `required`: `true` o `false`
`connections`	Sì, ma può essere vuoto se non esiste alcuno.	<connections-array>	Connessioni da creare usando il modello di flusso di lavoro. Ogni connessione ha le proprietà seguenti: - `connectorId`: l'ID connettore deve avere il suffisso, `_#workflowname#`. Usare solo caratteri alfanumerici, trattini o caratteri di sottolineatura, e seguire questo formato: `<connector-ID>_#workflowname#` Per trovare l'ID connettore, vedere Trovare l'ID connettore. - `kind`: il tipo di host di runtime del connettore, che è `inapp` per le operazioni predefinite e i connettori del provider di servizi o `shared` per i connettori gestiti ospitati in Azure. Nella raccolta connettori, le operazioni predefinite e i connettori del provider di servizi vengono etichettati come In App, mentre i connettori gestiti vengono etichettati come Condivisi.
`featuredConnections`	NO	<featured-connections-array>	Per impostazione predefinita, la raccolta di modelli mostra le icone per le operazioni predefinite e i connettori in App per la logica di Azure usati da ogni modello. Per includere icone per qualsiasi altra operazione, è possibile usare l'attributo `featuredConnections`. Ogni operazione deve avere gli attributi seguenti: - `kind`: tipo di operazione - `type`: Tipo di operazione Per trovare questi valori, vedere la sezione Trovare il tipo di operazione e il tipo per la sezione Connessioni in primo piano.

Nel file manifest.json per il pacchetto modello di flusso di lavoro, aggiungere gli stessi nomi di immagine alla sezione images senza l'estensione del nome file .png, ad esempio:

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

Trovare l'ID connettore

Per trovare l'ID connettore da usare per una connessione nel file manifest.json o un riferimento alla connessione nel file workflow.json, seguire questa procedura:

Nel portale di Azure aprire la risorsa app per la logica.
Nel menu dell'app per la logica, in Flussi di lavoro selezionare Connessioni.
Selezionare la scheda Visualizzazione JSON.
In base al tipo di connessione, seguire questa procedura:
- Per una connessione API gestita "condivisa" ospitata ed eseguita in Azure:
  1. Trovare la sezione managedApiConnections.
  2. Nell'attributo connection, copiare e salvare il valore id, ma sostituire tutti i dati personali o sensibili, ad esempio l'ID sottoscrizione, il nome del gruppo di risorse e così via, con #<item>#:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>
    
    Ad esempio, il testo seguente mostra l'ID connettore per il connettore SharePoint:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline
- Per una connessione del provider di servizi ospitata nel runtime di App per la logica di Azure a tenant singolo:
  1. Trovare la sezione serviceProviderConnections.
  2. Per ogni connessione, trovare l'attributo id nell'attributo serviceProvider.
  3. Copiare e salvare il valore seguente:
    
    /serviceProviders/<connection-name>
    
    Ad esempio, il testo seguente mostra l'ID connettore per il connettore Ricerca intelligenza artificiale di Azure:
    
    /serviceProviders/azureaisearch.

Trovare le proprietà 'kind' e 'type' dell'operazione per le connessioni in primo piano

Nel filemanifest.json la featuredConnections sezione può includere icone per qualsiasi altra operazione da includere nella raccolta di modelli nel portale di Azure. Per questa sezione, ovvero una matrice, è necessario specificare gli attributi kind e type per ogni operazione.

Per ottenere questi valori di attributo, seguire questa procedura nel portale di Azure con il flusso di lavoro aperto:

Nel menu del flusso di lavoro, in Sviluppatore, selezionare Codice.
Nella sezione actions della finestra della visualizzazione codice. individuare l'operazione desiderata e quindi trovare i valori kind e type.

Aggiungere un pacchetto modello al repository GitHub

Per pubblicare il pacchetto modello nella raccolta di modelli di flusso di lavoro nel portale di Azure, è necessario configurare l'account GitHub, visitare il repository dei modelli di flusso di lavoro in GitHub per Azure Logic Apps e creare una pull request per il pacchetto modello in modo che il team di Azure Logic Apps possa esaminare e convalidare la tua PR.

Creare un account GitHub, se non ne è disponibile uno.

Per altre informazioni, vedere Introduzione all'account GitHub.
Passare al repository dei modelli di flusso di lavoro denominato LogicAppsTemplates per App per la logica di Azure in GitHub.
Creare un fork personalizzato, ovvero una copia remota del repository LogicAppsTemplates in GitHub.

Per altre informazioni, vedere Creazione di fork di un repository.
Per lavorare in locale, clonare il fork nel computer.
1. Seguire questa procedura per scaricare, installare e configurare Git.
2. Passare al fork, con l'URL seguente:
  
  https://github.com/<your-username>/LogicAppsTemplates
3. Nel computer locale, creare una cartella denominata GitHub, se non è già disponibile. Non clonare in una cartella sincronizzata di OneDrive.
4. Seguire questa procedura per clonare il proprio fork, non il repository di produzione.
5. Nel repository locale, seguire questa procedura per creare un ramo di lavoro.
6. Dopo aver estratto il ramo di lavoro, passare al livello radice nel repository locale e creare la cartella del pacchetto modello.
7. Aggiungere i file modello alla cartella del pacchetto modello e aggiornare il file di manifest.json a livello radice con il nome della cartella.
8. Quando si è pronti per eseguire il commit delle modifiche nel repository locale, ad esempio il salvataggio di uno snapshot, eseguire i comandi seguenti usando lo strumento da riga di comando Git o altri strumenti:
  
  git add .
  
  git commit -m "<commit-short-description>"
9. Per caricare lo snapshot nel fork remoto, eseguire il comando seguente:
  
  git push origin <your-working-branch>
In GitHub creare una richiesta pull per confrontare <your-working-branch> con il ramo main nel repository LogicAppsTemplates.
1. Passare alla pagina Richieste pull del repository e selezionare Nuova richiesta pull.
2. In Confronta modifiche, selezionare Confronta tra fork.
3. Assicurarsi che la richiesta pull abbia le impostazioni seguenti e quindi selezionare Crea richiesta pull.
  
  Repository di base Base Repository head Confronto
  
  Azure/LogicAppsTemplates principale <nome utente>/LogicAppsTemplates <your-working-branch>
4. Immettere un titolo e una descrizione per la richiesta pull. Per completare, selezionare Crea richiesta pull.
5. Attendere che il team di App per la logica di Azure esamini la richiesta pull.
Per altre informazioni, vedere Creazione di una richiesta pull da un fork.

Repository di base	Base	Repository head	Confronto
Azure/LogicAppsTemplates	principale	*<nome utente>/LogicAppsTemplates*	*<your-working-branch>*

Nomi e convenzioni di stile

Zona	Convenzione
Dati sensibili	Non includere o caricare dati personali e sensibili nei file modello, screenshot, descrizioni o dati di test. Ad esempio, questi dati includono ID sottoscrizione, nomi utente, password e così via.
Nomi cartella	Per semplificare la leggibilità, usare caratteri minuscoli e trattini quando possibile. Vedere la Guida per le maiuscole e minuscole - Guida di stile Microsoft.
Nomi dei file di immagine	Usare il .png come estensione del nome file, caratteri minuscoli e trattini, ad esempio workflow-light.png.
Nomi di prodotto, servizio, tecnologia e marchio	Seguire l'ortografia ufficiale e la maiuscola. Ad esempio: - Quando si fa riferimento al nome o alla piattaforma del servizio, usare "App per la logica di Azure", non "App per la logica". - Quando si fa riferimento alla risorsa o all'istanza, usare "app per la logica" o "app per la logica", non "App per la logica" o "App per la logica". - Quando si fa riferimento alla sequenza di trigger e azioni, usare "flusso di lavoro dell'app per la logica" o "flusso di lavoro".
Abbreviazioni e acronimi	Usare il nome espanso per prodotto, servizio, tecnologia, nomi di marchi e termini tecnici non comuni, non abbreviazioni o acronimi. Gli acronimi comuni, ad esempio "HTTP" e "URL", sono accettabili. Ad esempio, usare "Visual Studio Code", non "VS Code". Vedere Acronimi - Guida di stile Microsoft.
Altro testo	- Usare la distinzione tra maiuscole e minuscole per titoli, intestazioni e contenuto del corpo, ovvero si scrivere in maiuscolo solo la prima lettera, a meno che non si disponga di prodotto, servizio, tecnologia o nome del marchio. - Non scrivere in maiuscolo nomi e articoli ordinari, ad esempio "un", "una", "e", "o", "il" e così via.
Chiamata vocale	- Usare la voce di seconda persona (tu e tuo) anziché la terza persona (utenti, sviluppatori, clienti) a meno che non sia necessario fare riferimento a ruoli specifici. Vedere Persona - Guida di stile Microsoft. - Usa un tono attivo, diretto, ma amichevole quando possibile. La voce attiva è incentrata sull'oggetto e sul verbo nel testo, mentre la voce passiva è incentrata sull'oggetto nel testo.
Vocabolario	- Usare parole semplici, comuni, quotidiane, ad esempio "usare", anziché "utilizzare" o "sfruttare". - Non usare parole, frasi, gergo, colloquialismi, idiomi o gergo che non si traducono bene tra le lingue. - Usare "si prega di" solo per scenari specifici. Vedere Si prega di: Guida di stile Microsoft. - Usare "ad esempio" o "come ad esempio", non "ad es." o "es.". - Non usare termini direzionali come "qui", "sopra", "sotto", "destra" e "sinistra", che non sono accessibili.
Punteggiatura	- Per una serie di elementi, includere l'ultima virgola prima della congiunzione, ad esempio "e". Ad esempio, "mele, arance e banane". Vedere Virgole - Guida di stile Microsoft. - Terminare le frasi complete con punteggiatura appropriata. Non usare punti esclamativi. Vedere Punteggiatura: Guida di stile Microsoft.
Formattazione	- Per il codice, seguire la convenzione di stile per il linguaggio del codice. - Non usare collegamenti hardcoded, che non funzionano se gli URL cambiano. Nella richiesta pull, chiedere invece un collegamento di reindirizzamento da usare. - Per i collegamenti, usare il formato seguente: `For more information, see [descriptive-link-text](URL)]`. - Usare testo descrittivo del collegamento, non testo generico o vago, ad esempio "`See [here](URL)`". - Usare i numeri solo per i passaggi di una procedura, non per gli elenchi che non dispongono di un ordine specifico. Vedere Elenchi - Guida di stile Microsoft. - Usare solo uno spazio dopo la punteggiatura, a meno che non venga applicato un rientro al codice.

Per altre indicazioni, vedere la Guida di stile Microsoft e i suggerimenti per la scrittura globale.

Creare flussi di lavoro di app per la logica da modelli predefiniti