Progettare, compilare e distribuire app per la logica di Azure in Visual StudioDesign, build, and deploy Azure Logic Apps in Visual Studio

Anche se il portale di Azure è uno strumento eccellente per la creazione e la gestione delle app per la logica di Azure, è possibile usare Visual Studio per progettarle, compilarle e distribuirle.Although the Azure portal offers a great way for you to create and manage Azure Logic Apps, you can use Visual Studio for designing, building, and deploying your logic apps. Visual Studio offre strumenti avanzati, come la finestra di progettazione di app per la logica, per creare app per la logica, configurare i modelli di distribuzione e automazione e distribuirli in qualsiasi ambiente.Visual Studio provides rich tools like the Logic App Designer for you to create logic apps, configure deployment and automation templates, and deploy to any environment.

Per un'introduzione alle app per la logica di Azure, imparare a creare la prima app per la logica nel Portale di Azure.To get started with Azure Logic Apps, learn how to create your first logic app in the Azure portal.

Procedura di installazioneInstallation steps

Per installare e configurare gli strumenti di Visual Studio per le app per la logica di Azure, seguire questi passaggi.To install and configure Visual Studio tools for Azure Logic Apps, follow these steps.

PrerequisitiPrerequisites

Installare gli strumenti di Visual Studio per le app per la logica di AzureInstall Visual Studio tools for Azure Logic Apps

Dopo aver installato i prerequisiti:After you install the prerequisites:

  1. Aprire Visual Studio.Open Visual Studio. Scegliere Estensioni e aggiornamenti dal menu Strumenti.On the Tools menu, select Extensions and Updates.
  2. Espandere la categoria In rete per poter eseguire le ricerche in rete.Expand the Online category so you can search online.
  3. Sfogliare o cercare App per la logica per visualizzare Azure Logic Apps Tools for Visual Studio (Strumenti per app per la logica di Azure per Visual Studio).Browse or search for Logic Apps until you find Azure Logic Apps Tools for Visual Studio.
  4. Fare clic sul pulsante Scarica per scaricare e installare l'estensione.To download and install the extension, click Download.
  5. Al termine dell'installazione riavviare Visual Studio.Restart Visual Studio after installation.

Nota

È anche possibile scaricare gli strumenti per Visual Studio 2017 di app per la logica di Azure e gli strumenti per Visual Studio 2015 di app per la logica di Azure direttamente da Visual Studio Marketplace.You can also download Azure Logic Apps Tools for Visual Studio 2017 and the Azure Logic Apps Tools for Visual Studio 2015 directly from the Visual Studio Marketplace.

Al completamento dell'installazione è possibile usare il progetto Gruppo di risorse di Azure con la Progettazione delle app per la logica.After you finish installation, you can use the Azure Resource Group project with Logic App Designer.

Creare il progettoCreate your project

  1. Nel menu File, andare in Nuovoe selezionare Progetto.On the File menu, go to New, and select Project. Oppure per aggiungere il progetto a una soluzione esistente, andare in Aggiungie selezionare Nuovo progetto.Or to add your project to an existing solution, go to Add, and select New Project.

    File menu

  2. Nella finestra Nuovo progetto cercare Cloud e selezionare Gruppo di risorse di Azure.In the New Project window, find Cloud, and select Azure Resource Group. Assegnare un nome al progetto e fare clic su OK.Name your project, and click OK.

    Add new project

  3. Selezionare il modello App per la logica che crea un modello di distribuzione delle app per la logica vuoto che è possibile usare.Select the Logic App template, which creates a blank logic app deployment template for you to use. Dopo aver selezionato il modello, fare clic su OK.After you select your template, click OK.

    Selezionare il modello App per la logica

    Il progetto di app per la logica viene aggiunto alla soluzione.You've now added your logic app project to your solution. Il file di distribuzione verrà visualizzato in Esplora soluzioni.In the Solution Explorer, your deployment file should appear.

    File di distribuzione

Creare l'app per la logica con la finestra di progettazioneCreate your logic app with Logic App Designer

Dopo aver creato un progetto Gruppo di risorse di Azure contenente un'app per la logica, è possibile aprire Progettazione app per la logica in Visual Studio per creare il flusso di lavoro.When you have an Azure Resource Group project that contains a logic app, you can open the Logic App Designer in Visual Studio to create your workflow.

Nota

La finestra di progettazione richiede una connessione internet ai connettori di query per i dati e le proprietà disponibili.The designer requires an internet connection to query connectors for available properties and data. Ad esempio, se si utilizza il connettore di Dynamics CRM Online, la finestra di progettazione richiede l'istanza CRM per visualizzare le proprietà predefinite e personalizzate disponibili.For example, if you use the Dynamics CRM Online connector, the designer queries your CRM instance to show available custom and default properties.

  1. Fare clic con il pulsante destro del mouse sul file <template>.json e scegliere Open with Logic App Designer (Apri con Progettazione app per la logica).Right-click your <template>.json file, and select Open with Logic App Designer. (Ctrl+L)(Ctrl+L)

  2. Scegliere la sottoscrizione di Azure, il gruppo di risorse e la posizione per il modello di distribuzione.Choose your Azure subscription, resource group, and location for your deployment template.

    Nota

    Progettando un'app per la logica verranno create risorse di connessione API per l'esecuzione di query per ottenere le proprietà durante la progettazione.Designing a logic app creates API Connection resources that query for properties during design. Il gruppo di risorse selezionato viene usato da Visual Studio per creare tali connessioni durante la fase di progettazione.Visual Studio uses your selected resource group to create those connections during design time. Per visualizzare o modificare qualsiasi connessione API, andare nel Portale di Azure e cercare Connessioni API.To view or change any API Connections, go to the Azure portal, and browse for API Connections.

    Selezione della sottoscrizione

    La finestra di progettazione usa la definizione nel file <template>.json per il rendering.The designer uses the definition in the <template>.json file for rendering.

  3. Creare e progettare l'app per la logica.Create and design your logic app. Il modello di distribuzione viene aggiornato con le modifiche.Your deployment template is updated with your changes.

    Progettazione app per la logica in Visual Studio

Visual Studio aggiunge le risorse Microsoft.Web/connections al file di risorse per tutte le connessioni necessarie all'app per la logica per funzionare.Visual Studio adds Microsoft.Web/connections resources to your resource file for any connections your logic app needs to function. Queste proprietà di connessione possono essere impostate al momento della distribuzione ed essere gestite successivamente in Connessioni API nel portale di Azure.These connection properties can be set when you deploy, and managed after you deploy in API Connections in the Azure portal.

Passare alla visualizzazione del codice JSONSwitch to JSON code view

È possibile selezionare la scheda Visualizzazione Codice nella parte inferiore della finestra di progettazione per visualizzare la rappresentazione JSON dell'app per la logica.To show the JSON representation for your logic app, select the Code View tab at the bottom of the designer.

Per tornare al file di risorse JSON completo, fare clic con il pulsante destro del mouse su <template>.json e scegliere Apri.To switch back to the full resource JSON, right-click the <template>.json file, and select Open.

Aggiungere riferimenti per le risorse dipendenti ai modelli di distribuzione di Visual StudioAdd references for dependent resources to Visual Studio deployment templates

Quando si vuole che l'app per la logica faccia riferimento alle risorse dipendenti, è possibile usare le funzioni del modello di Azure Resource Manager nel modello di distribuzione di app per la logica.When you want your logic app to reference dependent resources, you can use Azure Resource Manager template functions in your logic app deployment template. Ad esempio, l'utente può fare in modo che l'app per la logica faccia riferimento a una funzione di Azure o a un account di integrazione che si desidera distribuire insieme all'app per la logica.For example, you might want your logic app to reference an Azure Function or integration account that you want to deploy alongside your logic app. Seguire queste linee guida sull'uso dei parametri nel modello di distribuzione in modo che la Progettazione app per la logica esegua il rendering correttamente.Follow these guidelines about how to use parameters in your deployment template so that the Logic App Designer renders correctly.

È possibile usare i parametri dell'app per la logica in questi tipi di trigger e azioni:You can use logic app parameters in these kinds of triggers and actions:

  • Flusso di lavoro figlioChild workflow
  • App per le funzioniFunction app
  • Chiamata APIMAPIM call
  • URL di runtime della connessione APIAPI connection runtime URL
  • Percorso di connessione APIAPI connection path

Ed è possibile usare le funzioni di modello, ad esempio parametri, variabili, resourceId, CONCAT e così via. Ad esempio, ecco come è possibile sostituire l'ID di risorsa della funzione di Azure:And you can use template functions such as parameters, variables, resourceId, concat, etc. For example, here's how you can replace the Azure Function resource ID:

"parameters":{
    "functionName": {
        "type":"string",
        "minLength":1,
        "defaultValue":"<FunctionName>"
    }
},

E dove si useranno i parametri:And where you would use parameters:

"MyFunction": {
    "type": "Function",
    "inputs": {
        "body":{},
        "function":{
            "id":"[resourceid('Microsoft.Web/sites/functions','functionApp',parameters('functionName'))]"
        }
    },
    "runAfter":{}
}

È anche possibile, ad esempio, impostare il parametro per l'operazione di invio messaggio del bus di servizio:As another example you can parameterize the Service Bus send message operation:

"Send_message": {
    "type": "ApiConnection",
        "inputs": {
            "host": {
                "connection": {
                    "name": "@parameters('$connections')['servicebus']['connectionId']"
                }
            },
            "method": "post",
            "path": "[concat('/@{encodeURIComponent(''', parameters('queueuname'), ''')}/messages')]",
            "body": {
                "ContentData": "@{base64(triggerBody())}"
            },
            "queries": {
                "systemProperties": "None"
            }
        },
        "runAfter": {}
    }

Nota

host.runtimeUrl è facoltativo e può essere rimosso dal modello, se presente.host.runtimeUrl is optional and can be removed from your template if present.

Nota

Affinché la Progettazione dell'app per la logica funzioni quando si usano i parametri, è necessario fornire valori predefiniti, ad esempio:For the Logic App Designer to work when you use parameters, you must provide default values, for example:

"parameters": {
    "IntegrationAccount": {
    "type":"string",
    "minLength":1,
    "defaultValue":"/subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Logic/integrationAccounts/<integrationAccountName>"
    }
},

Salvare l'app per la logicaSave your logic app

Per salvare l'app per la logica in qualsiasi momento, andare in File > Salva.To save your logic app at anytime, go to File > Save. (Ctrl+S)(Ctrl+S)

Se quando si salva l'applicazione l'app per la logica presenta errori, questi vengono visualizzati in Visual Studio nella finestra Output.If your logic app has any errors when you save your app, they appear in the Visual Studio Outputs window.

Distribuire l'app per la logica da Visual StudioDeploy your logic app from Visual Studio

Dopo aver configurato l'app, è possibile distribuirla direttamente da Visual Studio in pochi passaggi.After configuring your app, you can deploy directly from Visual Studio in just a couple steps.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Distribuisci > Nuova distribuzione...In Solution Explorer, right-click your project, and go to Deploy > New Deployment...

    New deployment

  2. Quando verrà richiesto, accedere alla sottoscrizione di Azure.When you're prompted, sign in to your Azure subscription.

  3. A questo punto è necessario selezionare i dettagli del gruppo di risorse in cui si desidera distribuire l'app per la logica.Now you must select the details for the resource group where you want to deploy your logic app. Al termine, fare clic su Distribuisci.When you're done, select Deploy.

    Nota

    Assicurarsi di selezionare il modello e i parametri corretti per il gruppo di risorse.Make sure that you select the correct template and parameters file for the resource group. Ad esempio, se si desidera distribuire in un ambiente di produzione, scegliere il file dei parametri di produzione.For example, if you want to deploy to a production environment, choose the production parameters file.

    Deploy to resource group

    Lo stato di distribuzione viene visualizzato nella finestra Output.The deployment status appears in the Output window. Potrebbe essere necessario selezionare Provisioning Azure nell'elenco Mostra output di.You might have to select Azure Provisioning in the Show output from list.

    Output dello stato di distribuzione

In futuro sarà possibile modificare l'app per la logica nel controllo del codice sorgente e usare Visual Studio per distribuire nuove versioni.In the future, you can edit your logic app in source control, and use Visual Studio to deploy new versions.

Nota

Se si modifica la definizione direttamente nel Portale di Azure, tali modifiche saranno sovrascritte alla successiva distribuzione da Visual Studio.If you change the definition in the Azure portal directly, those changes are overwritten when you deploy from Visual Studio next time.

Aggiungere un'app per la logica a un progetto Gruppo di risorse esistenteAdd your logic app to an existing Resource Group project

Se si dispone di un progetto Gruppo di risorse esistente, è possibile aggiungere l'app per la logica al progetto nella finestra Struttura JSON.If you have an existing Resource Group project, you can add your logic app to that project in the JSON Outline window. È inoltre possibile aggiungere un'altra app per la logica con l'applicazione creata in precedenza.You can also add another logic app alongside the app you previously created.

  1. Aprire il file <template>.json .Open the <template>.json file.

  2. Per aprire la finestra Struttura JSON andare in Visualizza > Altre finestre > Struttura JSON.To open the JSON Outline window, go to View > Other Windows > JSON Outline.

  3. Per aggiungere una risorsa al file del modello, fare clic su Aggiungi risorsa nella parte superiore della finestra Struttura JSON.To add a resource to the template file, click Add Resource at the top of the JSON Outline window. Oppure nella finestra Struttura JSON fare clic con il tasto destro del mouse su risorsee selezionare Aggiungi nuova risorsa.Or in the JSON Outline window, right-click resources, and select Add New Resource.

    Finestra Struttura JSON

  4. Nella finestra di dialogo Aggiungi risorsa, individuare e selezionare App per la logica.In the Add Resource dialog box, find and select Logic App. Dare un nome all'app per la logica e scegliere Aggiungi.Name your logic app, and choose Add.

    Aggiungere una risorsa

Passaggi successiviNext Steps