Criar um conector personalizado Aplicativos Lógicos do Azure (SOAP) (versão preliminar)
[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]
Para integrar os serviços SOAP em seus fluxos de trabalho de Aplicativos Lógicos do Azure, você pode criar e registrar um conector SOAP (Simple Object Access Protocol) personalizado usando a linguagem WSDL (Web Services Description Language) que descreve seu serviço SOAP. Os conectores SOAP funcionam como conectores predefinidos, para que você possa usá-los da mesma maneira que outros conectores em seus aplicativos lógicos. Atualmente, os conectores personalizados SOAP não são compatíveis com operações unidirecionais.
Importante
- Este é um recurso em versão preliminar.
- Os recursos de visualização não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer comentários.
Pré-requisitos
Para registrar seu conector SOAP, você precisa:
Uma assinatura do Azure. Se você não tiver uma assinatura, poderá iniciar uma conta gratuita do Azure. Como alternativa, você pode se inscrever para uma assinatura paga conforme o uso.
Um dos seguintes:
- Uma URL para um arquivo WSDL que define seu serviço SOAP e as APIs.
- Um arquivo WSDL que define seu serviço SOAP e as APIs.
Para este procedimento, você pode usar nosso exemplo, Serviços SOAP de ordens (
http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl
).(Opcional) Uma imagem a ser usada como um ícone do conector personalizado.
1. Criar seu conector
No portal do Azure do menu principal do Azure, selecione Novo.
Na caixa de pesquisa, insira conector de aplicativos lógicos e selecione Inserir.
Na lista Resultados, selecione Conector de Aplicativos Lógicos > Criar.
Insira detalhes para registrar seu conector conforme descrito na tabela. Quando terminar, marque a caixa de seleção Fixar no painel e selecione Criar.
Propriedade Valor sugerido Descrição Name soap-connector-name Insira um nome para o conector. Assinatura Azure-subscription-name Selecione sua assinatura do Azure. Grupo de recursos Azure-resource-group-name Crie ou selecione um grupo do Azure para organizar seus recursos do Azure. Localização deployment-region Selecione a mesma região do Azure que seu aplicativo lógico.
Depois que o Azure implantar seu conector, o menu do conector de Aplicativos Lógicos deve ser aberto. Caso contrário, selecione seu conector SOAP no painel do Azure.
2. Definir seu conector
Especifique o arquivo WSDL ou a URL para criar seu conector, a autenticação que o conector usa e as ações e gatilhos que seu conector SOAP fornece.
2a. Especificar o arquivo WSDL ou URL do conector
No menu do seu conector, se ainda não estiver selecionado, selecione Conector de Aplicativos Lógicos.
Na barra de ferramentas, selecione Editar.
Selecionar Geral para fornecer os detalhes nestas tabelas a fim de criar, proteger e definir as ações e gatilhos para seu conector SOAP.
Para Conectores personalizados, selecione SOAP para o seu Ponto de Extremidade de API para fornecer o arquivo WSDL que descreve sua API.
Opção Formato Descrição Carregar WSDL do arquivo WSDL-file Navegue até o local do seu arquivo WSDL e selecione esse arquivo. Carregar WSDL da URL http://path-to-wsdl-file Insira a URL para o arquivo WSDL do seu serviço. SOAP para REST Não aplicável Transforme APIs no serviço SOAP em APIs REST. Para Informações gerais, carregue um ícone para o seu conector.
Em geral, os campos Descrição, Host e URL base são preenchidos automaticamente pelo seu arquivo WSDL. Se não forem, adicione essas informações conforme descrito na tabela e selecione Continuar.
Opção ou configuração Formato Descrição Carregar ícone png-or-jpg-file-under-1-MB Um ícone que representa seu conector Cor: preferencialmente um logotipo branco sobre um fundo colorido.
Dimensões: Um logotipo de aproximadamente 160 × 160 pixels dentro de um quadrado de 230 × 230 pixels
Cor de fundo do ícone icon-brand-color-hexadecimal-code A cor atrás do seu ícone que corresponde à cor do plano de fundo no arquivo do seu ícone. Formato: hexadecimal. Por exemplo, #007ee5 representa a cor azul.
Descrição connector-description Insira uma descrição curta para o seu conector. Host connector-host Insira o domínio do host para o seu serviço SOAP. URL Base connector-base-URL Insira a URL base para o seu serviço SOAP.
2b. Descreva a autenticação que seu conector usa
Selecione Segurança e, em seguida, revise ou descreva a autenticação que seu conector usa. A autenticação garante que as identidades dos usuários fluam adequadamente entre o serviço e qualquer cliente.
Por padrão, o Tipo de autenticação do seu conector é definido como Sem autenticação.
Para alterar o tipo de autenticação, selecione Editar. Você pode selecionar Autenticação Básica. Para usar rótulos de parâmetros diferentes dos valores padrão, atualize-os em Rótulo do parâmetro.
Para salvar seu conector após inserir as informações de segurança, na parte superior da página, selecione Atualizar conector e, em seguida, selecione Continuar.
2c. Revisar, atualizar ou definir ações e gatilhos para seu conector
Selecione Definição para revisar, editar ou definir novas ações e gatilhos que os usuários possam adicionar a seus fluxos de trabalho.
Ações e gatilhos são baseados nas operações definidas no seu arquivo WSDL, que preenchem automaticamente a página Definição e incluem os valores de solicitação e resposta. Se as operações necessárias já forem exibidas aqui, você pode passar para a próxima etapa do processo de registro sem fazer alterações nesta página.
(Opcional) Se você quiser editar ações e gatilhos existentes ou adicionar novos, veja um exemplo de edição de uma definição de API.
3. Terminar de criar seu conector
Quando estiver pronto, selecione Atualizar conector para implantar seu conector.
Parabéns! Agora, ao criar um aplicativo lógico, você poderá encontrar seu conector no Designer de Aplicativos Lógicos e adicionar esse conector ao seu aplicativo lógico.
Compartilhar seu conector com outros usuários dos Aplicativos Lógicos
Os conectores personalizados registrados, mas não certificados, funcionam como conectores predefinidos, com uma exceção. Eles estão disponíveis somente para o autor do conector e para os usuários que têm o mesmo locatário do Microsoft Entra ID e a mesma assinatura do Azure para Aplicativos Lógicos na região em que esses aplicativos estão implantados. Embora o compartilhamento seja opcional, você pode ter cenários em que deseja compartilhar seus conectores com outros usuários.
Importante
Se você compartilhar um conector, outras pessoas poderão começar a depender desse conector. A exclusão do seu conector exclui todas as conexões com esse conector.
Para compartilhar seu conector com usuários externos fora desses limites, por exemplo, com todos os usuários dos Aplicativos Lógicos, certifique seu conector. Para saber mais, acesse Certificar seu conector.
Perguntas frequentes
P: O conector SOAP está disponível para o público geral (GA)?
R: O conector SOAP está em versão preliminar e ainda não é um serviço em GA.
P: Existem restrições e problemas conhecidos para o conector SOAP?
R: Sim. Para saber mais, acesse Restrições do conector SOAP e problemas conhecidos.
P: Existem limites para conectores personalizados?
R: Sim. Para saber mais, acesse Personalizar limites do conector.
Obtenha suporte
Para obter suporte de desenvolvimento e integração ou para solicitar recursos que não estão disponíveis no assistente de registro, entre em contato com condevhelp@microsoft.com. A Microsoft monitora esta conta para verificar perguntas e problemas do desenvolvedor e direcioná-las para a equipe apropriada.
Para fazer ou responder a perguntas ou ver o que outros usuários dos Aplicativos Lógicos estão fazendo, acesse Fórum de Aplicativos Lógicos do Azure.
Para ajudar a melhorar os Aplicativos Lógicos, vote ou envie ideias no Site de comentários do usuário dos Aplicativos Lógicos.
Informações relacionadas
Certificar seu conector
Perguntas frequentes sobre o conector personalizado para Aplicativos Lógicos do Azure, Power Automate e Power Apps
Enviar comentários
Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.