Criar e publicar modelos de fluxo de trabalho para Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

Os Aplicativos Lógicos do Azure fornecem modelos de fluxo de trabalho de integração e automação predefinidos e reutilizáveis que você pode usar para acelerar o processo de criação de aplicativos de integração. Esses modelos seguem padrões comumente usados e ajudam você a simplificar o desenvolvimento ao oferecerem um ponto de partida ou linha de base com configurações e lógicas de negócios predefinidas.

Os modelos podem incluir um ou mais fluxos de trabalho junto com suas conexões, parâmetros e documentação. Os Aplicativos Lógicos do Azure oferecem os seguintes tipos de modelo:

Tipo de modelo	Descrição
Workflow	Modelos reutilizáveis que criam fluxos de trabalho únicos.
Aceleradores	Soluções agrupadas que contêm vários fluxos de trabalho relacionados.

Você pode encontrar esses modelos na galeria de modelos, que é aberta quando você opta por criar um fluxo de trabalho começando com um modelo. A galeria já contém modelos criados pela Microsoft para padrões comuns de design e integração.

Você não só pode iniciar o desenvolvimento usando modelos de fluxo de trabalho, mas também pode criar e publicar modelos de fluxo de trabalho apenas para uso da sua organização em uma assinatura do Azure ou compartilhá-los com outras pessoas. Seu modelo pode incluir artefatos como esquemas, mapas e assemblies personalizados.

Os modelos organizacionais permitem padronizar padrões de integração, compartilhar práticas recomendadas e reutilizar soluções em sua empresa internamente sem torná-los públicos. Essa funcionalidade é especialmente útil para empresas que desejam promover a consistência, mantendo as opções abertas para flexibilidade. Se seus cenários incluem a inserção de APIs internas, o tratamento da lógica específica do domínio ou a imposição de padrões de arquitetura, os modelos organizacionais ajudam você a escalar e crescer enquanto você permanece no controle.

Os modelos de Aplicativos Lógicos do Azure também oferecem os seguintes recursos:

Publicar modelos no modo de teste ou de produção, que permitem testar e manter as versões com segurança.
Use diretamente APIs e sistemas internos em modelos sem precisar externalizá-las.
Baixe pacotes de modelo e, opcionalmente, adicione-os ao repositório de modelo de fluxo de trabalho público para Aplicativos Lógicos do Azure no GitHub.
Gradue seus modelos de teste para produção usando o gerenciamento de ciclo de vida interno no Azure DevOps, que fornece estrutura para sua equipe, mas preserva a agilidade.
Como recursos de primeira classe no Azure, os modelos dão suporte ao RBAC (controle de acesso baseado em função) do Azure.
- Você pode gerenciar permissões de modelo como qualquer outro recurso do Azure.
  
  Essas permissões respeitam escopos de assinatura e função, o que significa que os desenvolvedores podem ver e acessar somente esses modelos em assinaturas em que os desenvolvedores têm acesso.
  
  Essa funcionalidade fornece controle de nível empresarial sobre quem pode criar, exibir e implantar modelos. Você tem controle total sobre a maneira como deseja organizar modelos para garantir que as equipes certas tenham acesso aos padrões de automação de que precisam.

A captura de tela a seguir mostra a galeria de modelos de fluxo de trabalho com escopo para uma organização e uma assinatura do Azure com modelos de exemplo que mostram rótulos de status, como Teste e Produção:

Este guia mostra como criar e publicar um modelo de fluxo de trabalho das seguintes maneiras:

Somente para uso da sua organização. Consulte Criar modelo de fluxo de trabalho – portal do Azure.

Esse caminho faz com que você crie seu modelo usando o assistente no portal do Azure para especificar os fluxos de trabalho do aplicativo lógico de origem, as informações sobre seu modelo e as opções de publicação para teste antes de liberar o modelo para produção.
Para todos os clientes do Azure usarem. Consulte Criar modelo de fluxo de trabalho – Manual.

Esse caminho exige que você crie um pacote de modelo e envie o pacote como uma solicitação de pull para o repositório de modelo de fluxo de trabalho público para Aplicativos Lógicos do Azure no GitHub.

Pré-requisitos

Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.
O recurso de aplicativo lógico e o fluxo de trabalho Consumo ou Standard a serem usados como a definição de fluxo de trabalho de origem para o modelo.

O recurso de aplicativo lógico e o fluxo de trabalho devem ser implantados antes de criar seu modelo. Certifique-se de parametrizar corretamente os valores que o usuário final do fluxo de trabalho deve fornecer, em vez de codificar esses valores corretamente.

Se você não tiver esse recurso e fluxo de trabalho, consulte os seguintes artigos:
- Crie um exemplo de fluxo de trabalho de aplicativo lógico de Consumo
- Criar um exemplo de fluxo de trabalho do aplicativo lógico Standard
Capturas de tela que mostram imagens de visualização somente leitura para o fluxo de trabalho que o modelo cria. Use a extensão .png nome do arquivo para essas capturas de tela. Essas imagens de visualização do modelo aparecem no painel de visão geral do modelo na galeria de modelos.

Para armazenar essas imagens para que seu modelo possa usá-las, você precisa de uma conta de armazenamento do Azure e um contêiner de blob.

Para criar essas imagens, siga estas etapas:
1. No portal do Azure, abra o recurso de lógica do aplicativo de origem e o fluxo de trabalho no designer.
2. Configure o fluxo de trabalho para criar duas capturas de tela: uma versão que funciona com o tema claro de um navegador da Web e outra versão que funciona com o tema escuro de um navegador da Web.
3. Crie as capturas de tela usando sua ferramenta de captura de tela preferida. Não inclua muito espaço em branco ao redor do fluxo de trabalho.
4. Salve cada imagem usando o sufixo de nome de arquivo .png e um nome que siga as convenções de nomes e estilos, por exemplo, <nome-imagem>-light.png e <nome-imagem>-dark.png.
5. Adicione suas imagens ao contêiner de blob em sua conta de armazenamento do Azure. Copie e salve a URL do blob para cada imagem para que você possa referenciar posteriormente as imagens do modelo.
  
  Importante
  
  A URL inclui uma chave ou token SAS (Assinatura de Acesso Compartilhado) que concede permissões, por exemplo, aos serviços de armazenamento. Certifique-se de proteger sua chave SAS assim como você protege uma chave de conta contra uso não autorizado.

Práticas recomendadas

Esta lista fornece as práticas recomendadas a seguir ao criar seu modelo de fluxo de trabalho:

Não use propriedades codificadas e seus valores em definições de gatilho e ação.
Forneça mais contexto sobre definições de gatilho e ação adicionando comentários descritivos e úteis.
Fluxos de trabalho e recursos de aplicativo lógico padrão
- Use as operações internas o máximo possível. Por exemplo, o conector do Armazenamento de Blobs do Azure tem as seguintes versões disponíveis para fluxos de trabalho Standard:
  - As operações internas do provedor de serviços aparecem na galeria de conectores no filtro Interno. Essas versões são hospedadas e executadas com o ambiente de execução monolocatário dos Aplicativos Lógicos do Azure, oferecendo melhor desempenho, taxa de transferência e outros benefícios.
  - As operações dos conectores de API gerenciados, hospedados no Azure, aparecem na galeria de conectores sob o filtro Compartilhado. Essas versões são hospedadas e executadas no Azure multilocatário usando recursos globais compartilhados.

Criar um modelo de fluxo de trabalho

Com base em se você deseja disponibilizar seu modelo de fluxo de trabalho apenas para sua organização ou para todos no Azure, siga as etapas correspondentes:

Exclusivo para organização
Todo o Azure

Estas etapas descrevem como criar e publicar um modelo de fluxo de trabalho disponível somente para membros em uma assinatura específica do Azure.

Na caixa de pesquisa do portal do Azure , localize e selecione modelos de aplicativos lógicos.
Na barra de ferramentas da página Modelos de Aplicativos Lógicos , selecione Criar.

Na página Criar um modelo de Aplicativos Lógicos do Azure , na guia Noções Básicas , forneça as seguintes informações:

Parâmetro	Obrigatório	Valor	Descrição
Subscrição	Sim	< Nome da assinatura do Azure>	A assinatura do Azure a ser usada com o modelo de fluxo de trabalho.
Grupo de recursos	Sim	< resource-group-name>	O nome do grupo de recursos do Azure a ser usado com o modelo.
Nome	Sim	< nome do modelo>	O nome do recurso de modelo de fluxo de trabalho.
Região	Sim	< Região do Azure>	A região do Azure para onde criar o recurso de modelo de fluxo de trabalho.

Quando terminar, selecione Review + create. Examine as informações fornecidas e selecione Criar.

O Azure cria o recurso de modelo.

Em seguida, escolha a definição de fluxo de trabalho de origem a ser usada para o modelo.

Escolha a definição do fluxo de trabalho de origem

No menu de recursos do modelo, em Modelo, selecione Modelo.
Na página Modelo , na guia Fluxos de Trabalho , selecione Adicionar.

No painel Gerenciar fluxos de trabalho neste painel de modelo , na guia Escolher fluxos de trabalho , forneça as seguintes informações:

Parâmetro	Obrigatório	Valor	Descrição
Subscrição	Sim	< Nome da assinatura do Azure>	O nome da assinatura do Azure com o aplicativo lógico de origem.
Grupo de recursos	Sim	< resource-group-name>	O nome do grupo de recursos do Azure com o aplicativo lógico de origem.
Instância do aplicativo lógico	Sim	< source-logic-app>	O nome do aplicativo lógico de origem com o fluxo de trabalho que você deseja usar.
Fluxos de trabalho	Sim	< fluxos de trabalho de origem>	Para um aplicativo lógico de consumo, selecione o único fluxo de trabalho existente a ser usado em seu modelo. Para um aplicativo lógico Standard, selecione pelo menos um fluxo de trabalho a ser usado em seu modelo.

Quando terminar, clique em Avançar.

Na guia Configurar fluxos de trabalho , forneça as seguintes informações para cada fluxo de trabalho de origem selecionado:

Parâmetro	Obrigatório	Valor	Descrição
Nome do fluxo de trabalho	Sim	< JSON-workflow-name>	O nome JSON para o fluxo de trabalho que pode usar apenas letras minúsculas, números e hifens e que você pode renomear apenas uma vez.
Estado	Sim	Com estado ou Sem monitoração de estado	Se deseja salvar e armazenar o histórico de execução do fluxo de trabalho, as entradas de operação e as saídas de operação, por padrão.
Resumo	Sim	< descrição abreviada>	Um breve resumo de alto nível sobre a finalidade do modelo.
Descrição	Não	< descrição detalhada>	Uma descrição com informações mais detalhadas sobre o modelo.
Pré-requisitos	Não	< Pré-requisitos>	Todos os requisitos necessários antes de poder usar o modelo.

Na seção Imagens de fluxo de trabalho, forneça as imagens de visualização de fluxo de trabalho a serem usadas para o painel de visão geral do modelo na galeria de modelos. Esse painel inclui outras informações de modelo.

Imagem de fluxo de trabalho	Descrição
URL SAS do modo claro	A URL da SAS para a imagem de visualização do fluxo de trabalho com tema claro armazenada em um contêiner de blob da sua conta de armazenamento do Azure.
URL da SAS de modo escuro	A URL da SAS para a imagem de visualização de fluxo de trabalho com tema escuro armazenada em um contêiner de blob da sua conta de armazenamento do Azure.

Quando terminar, selecione Salvar.

Você pode salvar seu modelo a qualquer momento durante o processo de criação. Sempre que você salva o progresso, a validação é executada automaticamente para determinar se existem erros, por exemplo, ações sem suporte ou valores não parametrizados. Você não precisa corrigir erros imediatamente ao encontrá-los, mas deve corrigi-los antes da publicação.
Na guia Conexões , examine e confirme as conexões que o Azure extrai automaticamente dos fluxos de trabalho de origem.

Você não precisa tomar nenhuma outra ação.
Quando estiver pronto, selecione Próximo.

Personalizar parâmetros

Na guia Parâmetros , adicione a personalização para todos os parâmetros desejados para o fluxo de trabalho.

Na guia Parâmetros , selecione o ícone de edição do parâmetro.

Forneça as seguintes informações para o parâmetro:

Propriedade	Obrigatório	Descrição
Nome de exibição	Sim	O nome do parâmetro que aparece no portal do Azure.
Valor padrão	Não	O valor padrão para o parâmetro.
Descrição	Não	Descrição da finalidade do parâmetro.
Campo Obrigatório	Não	Se o fluxo de trabalho requer o parâmetro.

Quando terminar, selecione Salvar.

Fornecer informações de modelo

A guia Perfil especifica informações sobre o modelo que aparece na galeria de modelos, por exemplo, o nome de exibição do modelo, o nome do editor, os conectores e outros metadados.

Na guia Perfil , forneça as seguintes informações sobre seu modelo:

Propriedade	Obrigatório	Descrição
Nome de exibição	Sim	O nome de exibição do modelo de fluxo de trabalho que aparece na galeria de modelos.
Por	Sim	O nome do editor do modelo de fluxo de trabalho.
Resumo	Sim	A descrição do fluxo de trabalho que o modelo cria.
Conectores em destaque	Sim	Selecione os principais tipos de conector no modelo de fluxo de trabalho.
Categoria	Não	A categoria na qual o modelo pertence.
Tags	Não	Todas as marcas que você deseja usar para rotular o fluxo de trabalho.

Quando estiver pronto, selecione Próximo.
Na guia Resumo , examine e confirme todas as informações fornecidas.

Publicar para teste

Quando estiver pronto para testar seu modelo, você poderá publicar seu modelo para teste.

Na guia Resumo ou uma guia anterior, na parte inferior da guia, na lista Salvar , selecione Salvar + publicar para teste.

O Azure publica o modelo, que exibe o rótulo Teste , na galeria de modelos.
Para testar seu novo modelo, siga as etapas em Criar fluxos de trabalho de modelos predefinidos, mas com estas etapas :
1. Na lista Status , selecione Publicado para Teste. Na linha de filtros, selecione Meus Modelos.
  
  Seu modelo aparece com o rótulo Testando , por exemplo:
2. Conclua a criação do fluxo de trabalho, teste o modelo e faça os ajustes necessários.

Publicar para produção

Para alterar o rótulo de modelo de Teste para Produção na galeria de modelos, siga estas etapas:

No portal do Azure, localize e abra o recurso de modelo.
Na barra lateral do modelo, em Modelo, selecione Modelo.
Na página Modelo , selecione Avançar e repita até abrir a guia Perfil .
Na lista Salvar , selecione Salvar + publicar para produção.

Remover modelo da galeria

Se você quiser remover temporariamente ou permanentemente o modelo de fluxo de trabalho personalizado da galeria de modelos, você poderá cancelar a publicação do modelo.

No portal do Azure, localize e abra o recurso de modelo.
Na barra lateral do modelo, em Modelo, selecione Modelo.
Na página Modelo , selecione Avançar e repita até abrir a guia Perfil .
Na lista Salvar , selecione Salvar + cancelar a publicação do modelo.

Estas etapas descrevem como criar e publicar um modelo de fluxo de trabalho disponível para todos usarem no Azure. Para essa abordagem, você precisa criar um pacote de modelo.

O que há em um pacote de modelo?

A tabela a seguir descreve os arquivos opcionais em um pacote de modelo:

Nome do arquivo	Obrigatório	Descrição
workflow.json	Sim	Um arquivo JSON com sua definição de fluxo de trabalho.
manifest.json	Sim	Um arquivo JSON com informações sobre seu fluxo de trabalho e componentes relacionados.
*< image-name>-dark.png*	Sim	Um arquivo de imagem com o fluxo de trabalho como uma captura de tela somente leitura no formato .png e funciona com o tema escuro de um navegador.
*< image-name>-light.png*	Sim	Um arquivo de imagem com o fluxo de trabalho como uma captura de tela somente leitura no formato .png e funciona com o tema claro de um navegador.
*< map-name>.json, .xmlou .xslt*	Não	Quaisquer artefatos, como mapas e esquemas que dão suporte ao modelo de fluxo de trabalho.
*< custom-assembly>.dll*	Não	Todos os assemblies personalizados que dão suporte ao modelo de fluxo de trabalho.
readme.md	Não	Um arquivo Markdown com instruções, procedimentos ou outras informações para o modelo de fluxo de trabalho.

Você também pode incluir outros arquivos para manter e dar suporte ao modelo, por exemplo, arquivos com dados de teste ou de exemplo.

Criar uma pasta de pacote de modelo

Antes de criar a pasta do pacote de modelo, familiarize-se com Convenções de nomes e estilos.
Para manter o repositório de modelos mais fácil de procurar, organizar e manter, use a seguinte sintaxe para o nome da pasta e o menor número de palavras para evitar exceder o limite de caracteres para caminhos de arquivo:

< workflow-task>-<product>-<pattern-or-protocol, se houver>

Para obter exemplos, consulte o repositório de modelos de fluxo de trabalho para Aplicativos Lógicos do Azure no GitHub.
Para registrar corretamente a pasta do pacote de modelo, você deve adicionar o nome da pasta ao arquivo manifest.json de nível raiz do repositório.

Criar um arquivo workflow.json

O arquivo workflow.json contém a definição subjacente para um fluxo de trabalho no formato JSON. Para criar o arquivo workflow.json, você precisa copiar e salvar sua definição de fluxo de trabalho como um arquivo chamado workflow.json.

Para obter a definição de fluxo de trabalho mais fácil e melhor, crie seu fluxo de trabalho usando o designer. Examine as Práticas recomendadas do fluxo de trabalho juntamente com Nomes e convenções de estilo. Ou, como ponto de partida, você pode usar os modelos de fluxo de trabalho predefinidos da galeria de modelos no portal do Azure.

À medida que você cria seu fluxo de trabalho, o designer inclui automaticamente referências a quaisquer conexões internas, de provedor de serviços, conexões de API gerenciadas ou bibliotecas na definição de fluxo de trabalho subjacente.

Depois de terminar, copie a definição de fluxo de trabalho subjacente para um arquivo de workflow.json vazio.

Copiar a definição de fluxo de trabalho subjacente

No portal do Azure, no menu fluxo de trabalho, em Desenvolvedor, selecione Código.
Na janela de exibição de código, copie toda a definição de fluxo de trabalho, por exemplo:
Em um arquivo vazio chamado workflow.json, salve a definição do fluxo de trabalho.

Referências de parâmetro no workflow.json

Ao referenciar parâmetros no arquivo workflow.json, você deve refletir os nomes de parâmetro que usam o sufixo _#workflowname# da seguinte maneira:

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

Por exemplo:

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

Referências de conexão no workflow.json

Ao referenciar conexões no arquivo workflow.json, você deve refletir os nomes de conexão que usam o sufixo _#workflowname# da seguinte maneira:

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

Por exemplo:

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

Para obter mais informações sobre a ID do conector SAP, confira Localizar a ID do conector.

Criar um arquivo manifest.json

O arquivo manifest.json descreve a relação entre um fluxo de trabalho e componentes relacionados. No momento, você precisa criar manualmente esse arquivo ou recompilar o arquivo manifest.json de um modelo predefinido existente no repositório de modelos de fluxo de trabalho de Aplicativos Lógicos do Azure no GitHub. Ao criar o arquivo manifest.json, examine os nomes e as convenções de estilo.

A tabela a seguir descreve os atributos no arquivo manifest.json:

Nome do atributo	Obrigatório	Valor	Descrição
`title`	Sim	< template-title>	O título que aparece na galeria de modelos, que é aberta quando você adiciona um fluxo de trabalho de um modelo no portal do Azure.
`description`	Sim	< template-description>	A descrição do modelo, que aparece no painel de visão geral do modelo na galeria de modelos.
`prerequisites`	Não	< template-prerequisites>	Todos os pré-requisitos a serem atendidos para usar o modelo. Aparece no painel de visão geral do modelo. Você pode vincular a outros documentos desta seção.
`tags`	Não	< template-tags-array>	As marcas de modelo a serem usadas para pesquisar ou filtrar modelos.
`skus`	Sim	`standard`, `consumption`	O tipo de fluxo de trabalho do aplicativo lógico compatível com o modelo. Se você não tiver certeza, use `standard`.
`kinds`	Não	`stateful`, `stateless`	O modo de fluxo de trabalho, que determina se o histórico de execução e os estados de operação são armazenados. Por padrão, todos os fluxos de trabalho estão disponíveis no modo com estado e sem estado. Se o fluxo de trabalho for executado apenas no modo com estado, use esse atributo para tornar esse requisito explícito.
`detailsDescription`	Não	Confira a descrição.	Qualquer outra informação de descrição detalhada para o modelo.
`details`	Não	Confira a descrição.	Informações de modelo a serem usadas para filtrar a galeria de modelos. - `By`: o publicador de modelos, por exemplo, `Microsoft`. - `Type`: `Workflow` - `Trigger`: o tipo de gatilho, por exemplo, `Recurrence`,`Event` ou `Request`.
`artifacts`	Sim	< array de artefatos>	Todos os arquivos relevantes no pacote de modelo e inclui os seguintes atributos: - `type`: o tipo de arquivo, que determina o local apropriado para onde copiar o arquivo, por exemplo, `workflow`. - `file`: o nome do arquivo e a extensão, por exemplo, workflow.json.
`images`	Sim	Confira a descrição.	Os nomes de arquivo de imagem de fluxo de trabalho para temas claros e escuros do navegador: - `light`: nome da imagem para tema claro, por exemplo, workflow-light - `dark`: nome da imagem para tema escuro, por exemplo, workflow-dark.
`parameters`	Sim, mas pode estar vazio se nenhum existir	< workflow-parameters-array>	Os parâmetros para as ações no modelo de fluxo de trabalho. Para cada parâmetro, você precisa especificar as seguintes propriedades: - `name`: o nome do parâmetro deve ter o sufixo, `_#workflowname#`. Use apenas caracteres alfanuméricos, hifens ou sublinhados e siga este format: `<parameter-name>_#workflowname#` - `displayName`: o nome de exibição amigável do parâmetro. Consulte Convenções de nomes e estilos. - `type`: os tipos de dados do parâmetro, por exemplo, `String` ou `Int`. - `default`: o valor do parâmetro padrão, se houver. Se não houver, deixe esse valor como uma cadeia de caracteres vazia. - `description` Os detalhes do parâmetro e outras informações importantes ou úteis. - `required`: `true` ou `false`
`connections`	Sim, mas pode estar vazio se nenhum existir.	< connections-array>	As conexões a serem criadas usando o modelo de fluxo de trabalho. Cada conexão tem as seguintes propriedades: - `connectorId`: a ID do conector deve ter o sufixo, `_#workflowname#`. Use apenas caracteres alfanuméricos, hifens ou sublinhados e siga este format: `<connector-ID>_#workflowname#` Para localizar a ID do conector SAP, confira Localizar a ID do conector. - `kind`: o tipo de host de runtime do conector, que é `inapp` para operações internas e conectores do provedor de serviços ou `shared` para conectores gerenciados hospedados no Azure. Na galeria de conectores, as operações internas e os conectores do provedor de serviços são rotulados como No App, enquanto os conectores gerenciados são rotulados como Compartilhados.
`featuredConnections`	Não	< featured-connections-array>	Por padrão, a galeria de modelos mostra ícones para as operações predefinidas e conectores nos Aplicativos Lógicos do Azure usados por cada modelo. Para incluir ícones para qualquer outra operação, você pode usar o atributo `featuredConnections`. Cada operação deve ter os seguintes atributos: - `kind`: a categoria de operação - `type`: o tipo de operação Para localizar esses valores, consulte Localizar o tipo de operação e o tipo da seção featuredConnections.

No arquivo manifest.json para o pacote de modelo de fluxo de trabalho, adicione os mesmos nomes de imagem à seção images sem a extensão de nome do arquivo .png, por exemplo:

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

Localizar a ID do conector

Para localizar a ID do conector a ser usada para uma conexão no arquivo manifest.json ou uma referência de conexão no arquivo workflow.json, siga estas etapas:

Abra o recurso de aplicativo lógico no portal do Azure.
No menu do aplicativo lógico, em Fluxos de trabalho, selecione Conexões.
Escolha a guia Exibição do JSON.
Para testar a conexão, siga estas etapas:
- Para uma conexão de API gerenciada e "compartilhada" hospedada e executada no Azure:
  1. Localize a seção managedApiConnections.
  2. No atributo connection, copie e salve o valor id, mas substitua quaisquer dados pessoais ou confidenciais, como a ID da assinatura, o nome do grupo de recursos e assim por diante, por #<item>#:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>
    
    Por exemplo, o texto a seguir mostra a ID do conector para o conector do SharePoint:
    
    /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline
- Para uma conexão de provedor de serviços hospedada no runtime de Aplicativos Lógicos do Azure de locatário único:
  1. Localize a seção serviceProviderConnections.
  2. Para cada conexão, localize o atributo id no atributo serviceProvider.
  3. Copie e salve os seguintes valores a seguir:
    
    /serviceProviders/<connection-name>
    
    Por exemplo, o texto a seguir mostra a ID do conector para o conector de Pesquisa de IA do Azure:
    
    /serviceProviders/azureaisearch.

Localizar as propriedades 'kind' e 'type' da operação para featuredConnections

No arquivo manifest.json , a featuredConnections seção pode incluir ícones para quaisquer outras operações que você deseja incluir com a galeria de modelos no portal do Azure. Para esta seção, que é uma matriz, você precisa fornecer os atributos kind e type para cada operação.

Para obter esses valores de atributo, siga estas etapas no portal do Azure com o fluxo de trabalho aberto:

No menu fluxo de trabalho, em Desenvolvedor, selecione Monitor.
Na janela exibição de código, na seção actions, localize a operação desejada e localize os valores kind e type.

Adicionar pacote de modelo ao repositório GitHub

Para publicar seu pacote de modelos na galeria de modelos de fluxo de trabalho no portal do Azure, você precisa configurar sua conta do GitHub, visitar o repositório de modelos de fluxo de trabalho no GitHub para Aplicativos Lógicos do Azure e criar uma solicitação pull para seu pacote de modelos para que a equipe de Aplicativos Lógicos do Azure possa examinar e validar sua PR

Criar uma conta gratuita no GitHub, caso ainda não tenha uma.

Para obter mais informações, confira Introdução à conta GitHub.
Vá para o repositório de modelos de fluxo de trabalho chamado LogicAppsTemplates para Aplicativos Lógicos do Azure no GitHub.
Crie sua própria bifurcação, que é uma cópia remota do repositório LogicAppsTemplates no GitHub.

Para obter mais informações, consulte o Bifurcação de um repositório.
Para trabalhar localmente, clone sua bifurcação em seu computador.
1. Siga estas etapas para baixar, instalar e configurar o Git.
2. Vá para a bifurcação, que tem a seguinte URL:
  
  https://github.com/<your-username>/LogicAppsTemplates
3. No computador local, crie uma pasta chamada GitHub, caso ainda não tenha uma. Não clone em uma pasta sincronizada do OneDrive.
4. Siga estas etapas para clonar sua bifurcação, não o repositório de produção.
5. No repositório local, siga estas etapas para criar uma ramificação de trabalho.
6. Depois de fazer check-out da ramificação de trabalho, vá para o nível raiz no repositório local e crie a pasta do pacote de modelo.
7. Adicione seus arquivos de modelo à pasta do pacote de modelo e atualize o arquivo de manifest.json no nível raiz com o nome da pasta.
8. Quando estiver tudo pronto para confirmar as alterações no repositório local, que é como salvar um instantâneo, execute os seguintes comandos usando a ferramenta de linha de comando do Git ou outras ferramentas:
  
  git add .
  
  git commit -m "<commit-short-description>"
9. Para carregar o instantâneo na bifurcação remota, execute o seguinte comando:
  
  git push origin <your-working-branch>

No GitHub, crie uma pull request para comparar <your-working-branch> com a ramificação maindo repositório LogicAppsTemplates.

Vá para a página Pull request do repositório e selecione Nova pull request.
Em Comparar alterações, selecione Comparar entre bifurcações.

Verifique se a pull request tem as seguintes configurações e selecione Criar pull request.

Repositório de base	Base	Repositório de cabeçalho	Comparar
Azure/LogicAppsTemplates	principal	*< nome> de usuário/LogicAppsTemplates*	*< seu branch de trabalho>*

Insira um título e uma descrição para sua solicitação de pull. Na próxima página, selecione Criar pull request.
Aguarde até que a equipe de Aplicativos Lógicos do Azure examine sua solicitação de pull.

Para obter mais informações, consulte Criação de pull requests em uma bifurcação.

Convenções de nomes e estilos

Área	Convenção
Dados Confidenciais	Não inclua ou carregue dados pessoais e confidenciais em arquivos de modelo, capturas de tela, descrições ou dados de teste. Por exemplo, esses dados incluem IDs de assinatura, nomes de usuário, senhas e assim por diante.
Nomes de pastas	Para facilitar a legibilidade, use maiúsculas minúsculas e hifens quando possível. Consulte Capitalização – Guia de Estilo da Microsoft.
Nomes de arquivos de imagem	Use o .png como a extensão de nome de arquivo, letras minúsculas e hifens, por exemplo, workflow-light.png.
Nomes de produto, serviço, tecnologia e marcas	Siga a ortografia e a capitalização oficiais. Por exemplo: – Quando você se referir ao nome do serviço ou plataforma, use "Aplicativos Lógicos do Azure", não "Aplicativos Lógicos". – Quando você se referir ao recurso ou à instância, use "aplicativos lógicos" ou "aplicativo lógico", não "Aplicativo Lógico" ou "Aplicativos Lógicos". – Quando você se referir à sequência de gatilhos e ações, use "fluxo de trabalho do aplicativo lógico" ou "fluxo de trabalho".
Abreviações e acrônimos	Use o nome expandido para produto, serviço, tecnologia, nomes de marca e termos técnicos incomuns, não abreviações ou acrônimos. Acrônimos comuns, como "HTTP" e "URL", são aceitáveis. Por exemplo, use "Visual Studio Code", não "VS Code". Consulte Acrônimos – Guia de Estilo da Microsoft.
Outro texto	– Use maiúsculas e minúsculas para títulos, cabeçalhos e conteúdo do corpo, o que significa que você capitaliza apenas a primeira letra, a menos que tenha produto, serviço, tecnologia ou marca. – Não capitalize substantivos e artigos comuns, como "um", "e", "ou", "a", e assim por diante.
Serviço de Voz	– Use a voz de segunda pessoa (você e sua), em vez de terceira pessoa (usuários, desenvolvedores, clientes), a menos que você precise se referir a funções específicas. Consulte Pessoa – Guia de Estilo da Microsoft. – Use um tom ativo, direto, mas amigável quando possível. A voz ativa se concentra no assunto e no verbo no texto, enquanto a voz passiva se concentra no objeto no texto.
Vocabulário	– Use palavras simples, comuns e cotidianas, como "usar", em vez de "utilizar" ou "aproveitar". – Não use palavras, frases, jargões, coloquialismos, idiomas ou gírias que não se traduzam bem entre idiomas. – Use "por favor" apenas em situações específicas. Consulte por favor – Guia de Estilo da Microsoft. - Use "por exemplo" ou "tal como", não "por exemplo" ou "ou seja". – Não use termos direcionais como "aqui", "acima", "abaixo", "direita" e "esquerda", que não são acessíveis amigáveis.
Pontuação	– Para uma série de itens, inclua a última vírgula antes da conjunção, como "e". Por exemplo, "maçãs, laranjas e bananas". Consulte Vírgulas – Guia de Estilo da Microsoft. – Encerre frases completas com pontuação apropriada. Não use pontos de exclamação. Consulte Pontuação – Guia de Estilo da Microsoft.
Formatação	– Para o código, siga a convenção de estilo para o idioma desse código. - Não use links codificados, que são interrompidos se as URLs forem alteradas. Em sua solicitação de PR, solicite um link de redirecionamento para usar em vez disso. - Para links, use o seguinte formato: `For more information, see [descriptive-link-text](URL)]`. - Use texto de link descritivo, não texto de link genérico ou vago, como "`See [here](URL)`". – Use números apenas para etapas em um procedimento, não para listas que não têm nenhuma ordem específica. Consulte Listas – Guia de Estilo da Microsoft. – Use apenas um espaço após a pontuação, a menos que você esteja recuando o código.

Para obter mais diretrizes, consulte Guia de Estilo da Microsoft e Dicas de redação globais.

Criar fluxos de trabalho de aplicativo lógico a partir de modelos predefinidos

Comentários

Esta página foi útil?

Last updated on 2025-07-23