Criar e registar conectores personalizados SOAP nas Azure Logic Apps (pré-visualização)
[Este tópico é documentação de pré-lançamento e está sujeito a alterações.]
Para integrar serviços SOAP nos seus fluxos de trabalho das Azure Logic Apps, pode criar e registar um conector SOAP (Simple Object Access Protocol) personalizado utilizando Linguagem WSDL (Web Services Description Language) que descreve o seu serviço SOAP. Os conectores SOAP funcionam como conectores pré-criados, pelo que podem ser utilizados da mesma forma que outros conectores nas suas aplicações lógicas. Atualmente, os conectores personalizados SOAP não suportam operações unidirecionais.
Importante
Isto é uma funcionalidade de pré-visualização.
As funcionalidades de pré-visualização não se destinam à produção e poderão ter funcionalidades restritas. Estas funcionalidades estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.
Pré-requisitos
Para registar o conector SOAP, precisa de:
Uma subscrição do Azure. Se não tiver uma subscrição, poderá iniciar uma conta Azure gratuita. Como alternativa, pode inscrever-se para uma subscrição pay as you go.
Um dos seguintes:
- Um URL para um ficheiro WSDL que define o serviço SOAP e as APIs.
- Um ficheiro WSDL que define o serviço SOAP e as APIs.
Para este procedimento, pode utilizar o nosso exemplo, Serviços SOAP de Encomendas (
http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).(Opcional) Uma imagem para utilizar como um ícone para o conector personalizado.
1. Criar o seu conector
No portal do Azure, no menu principal do Azure, selecione Novo.
Na caixa de pesquisa, introduza conector logic apps e, em seguida, selecione Enter.
Na lista Resultados, selecione Conector do Logic Apps > Criar.
Introduza os detalhes para registar o conector, conforme descrito na tabela. Quando terminar, selecione a caixa de verificação Afixar ao dashboard e, em seguida, selecione Criar.
Property Valor sugerido Descrição Name soap-conector-nome Introduza um nome para o seu conector. Subscrição Azure-subscrição-nome Selecione a subscrição do Azure. Grupo de recursos Azure-recurso-grupo-nome Crie ou selecione um grupo do Azure para organizar os seus recursos do Azure. Localização região-implementação Selecione a mesma região do Azure que a aplicação lógica.
Depois de o Azure implementar o conector, o menu do conector Logic Apps deverá abrir-se. Se não se abrir, selecione o conector SOAP no dashboard do Azure.
2. Definir o seu conector
Especifique o ficheiro WSDL ou o URL para criar o conector, a autenticação que este utiliza e as ações e os acionadores que o conector SOAP fornece.
2a. Especificar o ficheiro WSDL ou o URL do conector
No menu do seu conector, se ainda não estiver selecionado, selecione Conector Logic Apps.
Na barra de ferramentas, selecione Editar.
Selecione Geral para fornecer os detalhes nestas tabelas para criar, proteger e definir as ações e acionadores para o conector SOAP.
Para Conectores personalizados, selecione SOAP para Ponto Final de API para fornecer o ficheiro WSDL que descreve a API.
Opção Formato Descrição Carregar o WSDL a partir do ficheiro WSDL-file Navegue para a localização do ficheiro WSDL e selecione esse ficheiro. Carregar WSDL a partir do URL http://caminho-para-ficheiro-wsdl Introduza o URL para o ficheiro WSDL do 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 conector.
Normalmente, os campos Descrição, Anfitrião e URL Base são preenchidos automaticamente a partir do ficheiro WSDL. Se não estiverem, adicione essas informações, conforme descrito na tabela e selecione Continuar.
Opção ou definição Formato Descrição Carregar ícone png-or-jpg-file-under-1-MB Um ícone que representa o seu conector Cor: de preferência um logótipo branco contra um fundo com cor.
Dimensões: um logótipo com, aproximadamente, 160 × 160 píxeis dentro de um quadrado de 230 × 230 píxeis
Cor de fundo do ícone ícone-marca-cor-código-hexadecimal A cor por trás do ícone que corresponde à cor de fundo no ficheiro de ícones. Formato: hexadecimal. Por exemplo, #007ee5 representa a cor azul.
Descrição conector-descrição Introduza uma breve descrição para o conector. Host conector-anfitrião Introduza o domínio do anfitrião para o seu serviço SOAP. URL Base conector-base-URL Introduza o URL base para o serviço SOAP.
2b. Descrever a autenticação que o conector utiliza
Selecione Segurança para rever ou descrever a autenticação que o conector utiliza. A autenticação certifica-se de que as identidades dos utilizadores fluem de acordo com o serviço e eventuais clientes.
Por definição, o tipo de autenticação do conector está definido como sem autenticação.
Para alterar o tipo de autenticação, selecione Editar. Pode selecionar a autenticação básica. Para utilizar etiquetas de parâmetros diferentes dos valores predefinidos, atualize-os em etiquetas de parâmetros.
Para guardar o conector depois de ter introduzido as informações de segurança, na parte superior da página, selecione Atualizar conector e, em seguida, selecione Continuar.
2c. Rever, atualizar ou definir ações e acionadores para o conector
Selecione Definição e, em seguida, reveja, edite ou defina novas ações e acionadores que os utilizadores podem adicionar aos respetivos fluxos de trabalho.
As ações e os acionadores baseiam-se nas operações definidas no ficheiro WSDL, que preenchem automaticamente a página Definição e incluem os valores de pedido e resposta. Se as operações necessárias já aparecerem aqui, pode ir para o passo seguinte no processo de registo sem fazer alterações nesta página.
(Opcional) Se pretende editar ações e acionadores existentes, ou adicionar novos acionadores, aceda a um exemplo de edição de uma definição de API.
3. Concluir a criação do conector
Quando estiver preparado, selecione Atualizar Conector para implementar o seu conector.
Parabéns! Agora, quando cria uma aplicação lógica, pode localizar o conector no Logic Apps Designer e adicionar esse conector à aplicação lógica.
Partilhar o seu conector com outros utilizadores de Logic Apps
Os conectores personalizados registados, mas não certificados, funcionam como conectores pré-criados, com uma exceção. Estão disponíveis só para o autor do conector e utilizadores que tenham o mesmo inquilino do Microsoft Entra ID e subscrição do Azure para Logic Apps na região em que essas aplicações são implementadas. Apesar da partilha ser opcional, é possível que tenha cenários nos quais pretende partilhar os conectores com outros utilizadores.
Importante
Se partilhar um conector, os outros utilizadores poderão começar a depender dele. Eliminar o seu conector elimina todas as ligações a esse conector.
Para partilhar o conector com utilizadores externos fora destas fronteiras — por exemplo, com todos os utilizadores de Logic Apps — certifique o seu conector. Para obter mais informações, aceda a Certificar o conector.
FAQ
P: O conector SOAP está geralmente disponível? R: O conector SOAP está em pré-visualização e ainda não é um serviço de disponibilidade geral.
P: Existem restrições e problemas conhecidos num conector SOAP? R: Sim. Para obter mais informações, aceda a Restrições e problemas conhecidos do conector SOAP.
P: Existem limites para os conectores personalizados? R: Sim. Para obter mais informações, aceda a limites do conector personalizado.
Obtenha suporte
Para obter suporte com o desenvolvimento e a inclusão, ou para pedir caraterísticas que não estão disponíveis no assistente de registo, contacte condevhelp@microsoft.com. A Microsoft monitoriza esta conta para perguntas e problemas de programador e encaminha-as para a equipa apropriada.
Para fazer ou responder a perguntas, ou ver o que outros utilizadores de Logic Apps estão a fazer, aceda ao Fórum das Azure Logic Apps.
Para ajudar a melhorar as Logic Apps, vote ou submeta ideias no site de comentários de utilizador de Logic Apps.
Consulte também
Certificar o conector
FAQ do conector personalizado para Azure Logic Apps, Power Automate e Power Apps
Enviar comentários
Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.