Criar um conector personalizado do Azure Logic Apps (SOAP) (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

• Esta é uma funcionalidade de pré-visualização.
• As funcionalidades de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado 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, pode começar com uma conta gratuita do Azure. Como alternativa, você pode se inscrever para uma assinatura pré-paga.

• 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, você pode usar nosso exemplo, Pedidos de serviços SOAP (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).

• (Opcional) Uma imagem para utilizar como um ícone para o conector personalizado.

1. Criar o seu conector

1. No portal do Azure no menu principal do Azure, selecione Novo.

2. Na caixa de pesquisa, introduza logic apps connector e, em seguida, selecione Enter.

   

3. Na lista Resultados , selecione Criar Conector>de Aplicativos Lógicos.

   

4. Introduza os detalhes para registar o conector, conforme descrito na tabela. Quando terminar, marque a caixa de seleção Fixar no painel e 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

1. No menu do conector, selecione Conector de aplicativos lógicos se ainda não estiver selecionado.

2. Na barra de ferramentas, selecione Editar.

   

3. Selecione Geral para fornecer os detalhes nestas tabelas para criar, proteger e definir as ações e gatilhos para seu conector SOAP.

   1. Em Conectores personalizados, selecione SOAP para seu ponto de extremidade da API para fornecer o arquivo WSDL que descreve sua API.

      

      Opção	Format	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://path-to-wsdl-file	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.

   2. Para obter informações gerais, carregue um ícone para o conector.

      Normalmente, os campos Descrição, Host e URL base são preenchidos automaticamente a partir do arquivo WSDL. Se não estiverem, adicione essas informações conforme descrito na tabela e selecione Continuar.

      

      Opção ou definição	Format	Description
      Carregar ícone	png-or-jpg-file-under-1-MB	Um ícone que representa o conector Cor: de preferência um logótipo branco contra um fundo com cor. Dimensões: Um logotipo de aproximadamente 160 × 160 pixels dentro de um quadrado de 230 × 230 pixels
      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

1. Selecione Segurança e, em seguida, reveja ou descreva 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 padrão, o tipo de autenticação do 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 de parâmetro.

   

2. Para guardar o conector depois de introduzir 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

1. Selecione Definição e, em seguida, revise, edite ou defina novas ações e gatilhos que os usuários podem adicionar aos seus fluxos de trabalho.

   As ações e gatilhos são baseados nas operações definidas no 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á aparecerem aqui, pode ir para o passo seguinte no processo de registo sem fazer alterações nesta página.

   

2. (Opcional) Se você quiser editar ações e gatilhos existentes ou adicionar novos, vá para um exemplo de edição de uma definição de API.

3. Concluir a criação do conector

Quando estiver pronto, selecione Atualizar conector para implantar o 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. Eles estão disponíveis apenas para o autor do conector e usuários que têm a mesma Microsoft Entra ID, locatário e assinatura do Azure para Aplicativos Lógicos na região onde esses aplicativos são implantados. 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 saber mais, vá para Certificar seu 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 disponível em geral.

P: Existem restrições ou problemas conhecidos para um conector SOAP?
R: Sim. Para saber mais, vá para Restrições do conector SOAP e problemas conhecidos.

P: Existem limites para conectores personalizados?
R: Sim. Para saber mais, vá para limites de conector personalizados.

Obtenha suporte

• Para obter suporte com desenvolvimento e integração, ou para solicitar recursos que não estão disponíveis no assistente de registro, entre em contato 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 usuários de Aplicativos Lógicos estão a fazer, vá para o 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 dos usuários dosAplicativos Lógicos.

Informações relacionadas

Certificar o seu conector
Perguntas frequentes sobre o conector personalizado para Aplicativos Lógicos do Azure, Power Automate, Power Apps, e Copilot Studio

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para fornecer comentários, vá para Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.