Compartilhar via


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

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

  2. Na caixa de pesquisa, insira conector de aplicativos lógicos e selecione Inserir.

    Captura de tela da pesquisa de "conector de aplicativos lógicos".

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

    Captura de tela da pesquisa de Criar conector de Aplicativos Lógicos.

  4. Insira detalhes para registrar seu conector conforme descrito na tabela. Quando terminar, marque a caixa de seleção Fixar no painel e selecione Criar.

    Captura de tela dos detalhes do conector personalizado dos Aplicativo Lógicos.

    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

  1. No menu do seu conector, se ainda não estiver selecionado, selecione Conector de Aplicativos Lógicos.

  2. Na barra de ferramentas, selecione Editar.

    Captura de tela de Editar conector personalizado

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

    1. Para Conectores personalizados, selecione SOAP para o seu Ponto de Extremidade de API para fornecer o arquivo WSDL que descreve sua API.

      Captura de tela do fornecimento do arquivo WSDL para 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.
    2. 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.

      Captura de tela de Detalhes do conector

      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

  1. 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.

    Captura de tela do tipo de 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.

    Captura de tela da autenticação básica.

  2. 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

  1. 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.

    Captura de tela de definição do conector.

  2. (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.

Captura de tela de como encontrar seu conector no Designer de Aplicativos Lógicos.

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

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.