Criar e gerenciar contas de integração para fluxos de trabalho B2B nos Aplicativos Lógicos do Azure com o Enterprise Integration Pack

1. Na caixa de pesquisa do portal do Azure, digite contas de integração e selecione Contas de integração.

2. Em Conta de Integração, selecione Criar.

3. No painel Criar uma conta de integração, forneça as seguintes informações sobre sua conta de integração:

   Propriedade	Obrigatório	Valor	Descrição
   Assinatura	Sim	<Azure-subscription-name>	O nome e a ID da assinatura do Azure
   Grupo de recursos	Sim	<Azure-resource-group-name>	O nome do grupo de recursos do Azure para organizar recursos relacionados. Neste exemplo, crie um grupo de recursos com o nome FabrikamIntegration-RG.
   Nome da conta de integração	Sim	<integration-account-name>	O nome da conta de integração, que pode conter somente letras, números, hifens (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo usa Fabrikam-Integration.
   Tipo de preço	Sim	<pricing-level>	O tipo de preço da conta de integração, que você pode alterar posteriormente. Neste exemplo, selecione Gratuito. Para saber mais, consulte a seguinte documentação: - Modelo de preços de Aplicativos Lógicos - Limites e configuração de Aplicativos Lógicos - Preços de Aplicativos Lógicos
   Conta de armazenamento	Disponível somente para a conta de integração Premium (versão prévia)	Nenhum	O nome de uma conta de armazenamento do Azure existente. Para o exemplo neste guia, essa opção não se aplica.
   Região	Sim	<Azure-region>	A região do Azure onde armazenar os metadados da conta de integração. Selecione o mesmo local do recurso do aplicativo lógico ou crie seus aplicativos lógicos no mesmo local da conta de integração. Para este exemplo, use Oeste dos EUA. Para usar sua conta de integração com um ISE (ambiente de serviço de integração), selecione Associar ao ambiente de serviço de integração e, em seguida, selecione seu ISE como o local. Para criar uma conta de integração de dentro de um ISE, consulte Criar contas de integração de dentro de um ISE. Observação: o recurso de ISE será desativado em 31 de agosto de 2024, devido à sua dependência dos Serviços de Nuvem do Azure (clássico), que será desativado ao mesmo tempo. Atualmente em versão prévia, a funcionalidade está disponível para exportar uma conta de integração Standard para um ISE para uma conta de integração Premium.
   Habilitar a análise de logs	No	Não selecionado	Para este exemplo, não selecione essa opção.

4. Quando terminar, selecione Review + create.

   Após o fim da implantação, o Azure abrirá sua conta de integração.

5. Caso criou uma conta de integração Premium, configure o acesso à conta de armazenamento do Azure associada.

Preparar o ambiente para a CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

1. Para adicionar a extensão az logic integration-account, use o comando az extension add:

   az extension add –-name logic
   

2. Execute o comando az group create para criar um grupo de recursos ou use um grupo de recursos existente:

   az group create --name myresourcegroup --location westus
   

   Para listar as contas de integração de um grupo de recursos, use o comando az logic integration-account list:

   az logic integration-account list --resource-group myresourcegroup
   

3. Para criar uma conta de integração, execute o comando az logic integration-account create:

   az logic integration-account create --resource-group myresourcegroup \
       --name integration_account_01 --location westus --sku name=Standard
   

   O nome da conta de integração só pode conter letras, números, hifens (-), sublinhados (_), parênteses (()) e pontos (.).

   Para ver uma conta de integração específica, use o comando az logic integration-account show:

   az logic integration-account show --name integration_account_01 --resource-group myresourcegroup
   

   É possível alterar o SKU, ou tipo de preço, usando o comando az logic integration-account update:

   az logic integration-account update --sku name=Basic --name integration_account_01 \
       --resource-group myresourcegroup
   

   Para saber mais sobre preços, confira estes recursos:

   • Modelo de preços de Aplicativos Lógicos do Azure
   • Limites e configuração de Aplicativos Lógicos do Azure
   • Preço de Aplicativos Lógicos do Azure

Para importar uma conta de integração usando um arquivo JSON, use o comando az logic integration-account import:

az logic integration-account import --name integration_account_01 \
    --resource-group myresourcegroup --input-path integration.json

Esta seção descreve como concluir essa tarefa usando o portal do Azure. Se você usa o Visual Studio e seu aplicativo lógico está em um projeto de grupo de recursos do Azure, vincule seu aplicativo lógico a uma conta de integração usando o Visual Studio.

1. Abra o recurso de aplicativo lógico no portal do Azure.

2. No menu de navegação do aplicativo lógico, em Configurações, selecione Configurações de fluxo de trabalho. Na conta de integração, abra a lista Selecionar uma conta de integração e selecione a conta de integração desejada.

   

3. Para concluir a vinculação, clique em Salvar.

   

   Quando a conta de integração estiver vinculada, o Azure mostrará uma mensagem de confirmação.

   

Agora, o fluxo de trabalho do aplicativo lógico pode usar os artefatos em sua conta de integração, além dos conectores B2B, como validação XML e codificação ou decodificação de arquivo simples.

Localizar a URL de retorno de chamada da sua conta de integração

Antes de vincular sua conta de integração a um recurso de aplicativo lógico Standard, você precisa ter a URL de retorno de chamada da conta de integração.

1. Na caixa de pesquisa do portal do Azure, digite contas de integração e selecione Contas de integração.

2. Da lista de Contas de integração, selecione sua conta de integração.

3. No menu de navegação da sua conta de integração selecionada, em Configurações, selecione URL de Retorno de Chamada.

4. Localize o valor da propriedade URL de Retorno de Chamada Gerado, copie o valor e salve a URL a ser usada posteriormente para vinculação.

Vincular conta de integração a um aplicativo lógico Standard

Portal do Azure

1. No portal do Azure, abra seu recurso de aplicativo lógico Padrão.

2. No menu de navegação do aplicativo lógico, em Configurações, selecione Variáveis de ambiente.

3. Na página Variáveis de ambiente, verifique se a configuração do aplicativo denominada WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL existe.

4. Caso a configuração do aplicativo não exista, no final da lista de configurações, adicione uma nova configuração de aplicativo inserindo o seguinte:

   Propriedade	Valor
   Nome	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valor	<URL de retorno de chamada da conta de integração>

5. Quando terminar, selecione Aplicar.

Visual Studio Code

1. No projeto do aplicativo lógico Standard no Visual Studio Code, abra o arquivo local.settings.json.

2. No objeto Values, adicione uma configuração de aplicativo que tenha as seguintes propriedades e valores, incluindo a URL de retorno de chamada salva anteriormente:

   Propriedade	Valor
   Nome	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valor	<URL de retorno de chamada da conta de integração>

   Este exemplo mostra como uma configuração de aplicativo de exemplo pode ser exibida:

   {
       "IsEncrypted": false,
       "Values": {
           "AzureWebJobStorage": "UseDevelopmentStorage=true",
           "FUNCTIONS_WORKER_RUNTIME": "node",
           "WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL": "https://prod-03.westus.logic.azure.com:443/integrationAccounts/...."
       }
   }
   

3. Quando terminar, salve as alterações.

1. Na caixa de pesquisa do portal do Azure, digite contas de integração e selecione Contas de integração.

   O Azure mostra todas as contas de integração em suas assinaturas do Azure.

2. Em Contas de integração, selecione a conta de integração que deseja mover. No menu de recursos da sua conta de integração, selecione Visão geral.

   

3. Na página de Visão geral, selecione Nível de preços de upgrade, que lista todos os níveis superiores disponíveis. Quando você seleciona uma camada, a alteração entra em vigor imediatamente.

   

1. Instale os pré-requisitos da CLI do Azure, se ainda não tiver feito isso.

2. No portal do Azure, abra o ambiente do Azure Cloud Shell.

   

3. No prompt de comando, insira o comando az resource e defina skuName como a camada mais alta.

   az resource update --resource-group {ResourceGroupName} --resource-type Microsoft.Logic/integrationAccounts --name {IntegrationAccountName} --subscription {AzureSubscriptionID} --set sku.name={SkuName}
   

   Por exemplo, se você tiver a camada Básico, poderá definir skuName como Standard:

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Standard
   

Para vincular seu aplicativo lógico a outra conta de integração ou não usar mais uma conta de integração com o aplicativo lógico, exclua o vínculo por meio do Azure Resource Explorer.

1. Abra seu navegador e acesse o Azure Resource Explorer https://resources.azure.com) (). Entre com as mesmas credenciais da conta do Azure.

   

2. Na caixa de pesquisa, insira o nome do aplicativo lógico para localizá-lo e selecioná-lo.

   

3. Na barra de título do gerenciador, selecione Leitura/Gravação.

   

4. Na guia Dados, selecione Editar.

   

5. No editor, localize o objeto integrationAccount, que tem o seguinte formato, e exclua o objeto:

   {
      // <other-attributes>
      "integrationAccount": {
         "name": "<integration-account-name>",
         "id": "<integration-account-resource-ID>",
         "type": "Microsoft.Logic/integrationAccounts"  
      },
   }
   

   Por exemplo:

   

6. Na guia Dados, selecione Colocar para salvar as alterações.

   

7. No portal do Azure, abra o aplicativo lógico. No menu do aplicativo lógico, em Configurações de fluxo de trabalho, confirme se a propriedade Conta de integração agora aparece vazia.

   

Portal do Azure

1. No portal do Azure, abra seu recurso de aplicativo lógico Padrão.

2. No menu do aplicativo lógico, em Configurações, selecione Variáveis de ambiente.

3. Na página Variáveis de ambiente, localize a configuração do aplicativo denominado WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL.

4. Desmarque o nome da configuração do aplicativo e seu valor.

5. Quando terminar, selecione Aplicar.

Visual Studio Code

1. No projeto do aplicativo lógico Standard no Visual Studio Code, abra o arquivo local.settings.json.

2. No objeto Values, localize e exclua a configuração do aplicativo que tem as seguintes propriedades e valores:

   Propriedade	Valor
   Nome	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valor	<URL de retorno de chamada da conta de integração>

3. Quando terminar, salve as alterações.

1. Na caixa de pesquisa do portal do Azure, digite contas de integração e selecione Contas de integração.

   O Azure mostra todas as contas de integração em suas assinaturas do Azure.

2. Em Contas de integração, selecione a conta de integração que deseja excluir. No menu da conta de integração, selecione Visão Geral.

   

3. Na página Visão Geral, selecione Excluir.

   

4. Para confirmar que deseja excluir sua conta de integração, clique em Sim.

   

É possível excluir uma conta de integração usando o comando az logic integration-account delete:

az logic integration-account delete --name integration_account_01 --resource-group myresourcegroup