Compartilhar um conector personalizado
Agora que você criou um conector personalizado para a API do Printer Framer, deseja disponibilizar o conector para todos os usuários em sua organização. Dessa forma, eles podem chamar essa API de seus próprios fluxos de trabalho dos Aplicativos Lógicos do Azure. Você também sabe que muitos de seus clientes usam os Aplicativos Lógicos do Azure. Se você puder publicar seu novo conector para eles, eles poderão fazer chamadas para sua API facilmente.
Partilhar um conector com a sua organização
Se você criou e usou um conector personalizado em um fluxo de trabalho de aplicativo lógico, por padrão, esse conector estará disponível para outros usuários dos Aplicativos Lógicos do Azure em sua organização. Eles podem adicionar o conector a fluxos de trabalho em regiões de aplicativos lógicos se atenderem aos seguintes critérios:
- Eles compartilham o mesmo locatário do Microsoft Entra com você.
- Eles compartilham a mesma assinatura do Azure com você.
Os Aplicativos Lógicos do Azure compartilham automaticamente conectores personalizados, que outros usuários podem ver quando selecionam conectores para seus fluxos de trabalho. No entanto, você pode querer informá-los sobre o novo conector, sua finalidade, como usá-lo e assim por diante.
Compartilhar um conector com a comunidade
Se os usuários externos puderem chamar sua API, considere publicar seu conector personalizado na comunidade do Azure. A publicação torna a criação de fluxos de trabalho com os Aplicativos Lógicos do Azure e o acesso aos seus dados por meio da API muito mais fáceis. Tornar seu conector personalizado mais amplamente disponível também ajuda a promover sua API e impulsionar a adoção da comunidade.
A API do Print Framer é um bom exemplo. Qualquer pessoa que tenha uma assinatura e possa escrever código que faça chamadas à API REST pode acessar sua API. No entanto, se você publicar seu conector personalizado, as pessoas que usam os Aplicativos Lógicos do Azure poderão chamar sua API de seus fluxos de trabalho sem escrever nenhum código. Algumas pessoas podem não saber sobre sua API, portanto, se encontrarem seu conector por meio da galeria de conectores dos Aplicativos Lógicos do Azure, poderão decidir experimentar a API e até mesmo comprar uma assinatura.
Para publicar seu conector na galeria de conectores dos Aplicativos Lógicos do Azure, você precisa enviá-lo à Microsoft para certificação. Se o conector atender aos critérios de certificação, a Microsoft publicará o conector para todos os usuários do Azure Logic Apps localizarem e usarem.
Critérios da certificação
A Microsoft certifica apenas conectores que atendem aos seguintes critérios:
| Funcionalidade | Obrigatório ou recomendado | Descrição |
|---|---|---|
| Propriedade do software como serviço | Obrigatório | Sua organização deve possuir a API para a qual o conector fornece acesso. |
| Autenticação | Obrigatório | Sua API deve suportar OAuth2, chave de API ou autenticação básica. |
| Suporte | Obrigatório | Você precisa fornecer um contrato de suporte aos usuários para que os clientes possam solicitar ajuda para problemas técnicos. |
| Disponibilidade | Recomendado | Garanta pelo menos 99,9% de tempo de atividade em seu Acordo de Nível de Serviço (SLA). |
Lista de verificação antes de enviar um conector
Teste totalmente seu conector antes de enviá-lo para certificação. Certifique-se de que não existem bugs ou outros problemas. A lista seguinte abrange problemas comuns a verificar e resolver:
- Erros na definição OpenAPI: Elimine qualquer código JSON inválido no arquivo de definição da API. Verifique se a definição da API está em conformidade com o esquema OpenAPI.
- Informações completas na definição: Certifique-se de que cada operação, parâmetro de entrada e atributo de resposta na especificação OpenAPI enviada tenha um resumo, descrição e informações de visibilidade.
Enviar um conector para certificação
O processo de certificação leva cerca de duas semanas, mas esse cronograma depende de quão bem seu conector atende aos critérios anteriores. O processo é executado de forma semelhante às seguintes etapas:
Nomeação: Visite o formulário de nomeação para enviar o seu conector. A Microsoft enviará um Contrato de Parceiro.
Revisão: Depois que os contratos são assinados, um funcionário da Microsoft analisa o conector. Talvez seja necessário fornecer o ID do conector, a definição da OpenAPI, um arquivo de ícone, uma conta de teste, um endereço de e-mail para suporte e outras informações.
Publicar: a Microsoft prepara e publica o conector com a tag "Preview".
Suporte e atualizações: Depois que a Microsoft publicar o conector e as pessoas começarem a usá-lo, monitore os fóruns de produtos relacionados para saber se os clientes estão tendo problemas. Se precisar de submeter uma nova versão, utilize o mesmo formulário de nomeação. Depois que o conector estiver disponível por algum tempo, você pode pedir ao contato de nomeação para remover a tag "Visualizar".
Para obter mais informações, consulte Enviar seu conector para certificação Microsoft.