Crear y registrar conectores personalizados SOAP en Azure Logic Apps (versión preliminar)

  • Artículo

[Este tema es documentación preliminar y está sujeto a modificaciones.]

Para integrar los servicios SOAP en sus flujos de trabajo de Azure Logic Apps, puede crear y registrar un conector de Protocolo simple de acceso a objetos (SOAP) personalizado mediante el lenguaje de descripción de servicios web (WSDL) que describe su servicio SOAP. Los conectores SOAP funcionan como conectores precompilados, por lo que puede usarlos de la misma manera que otros conectores en sus aplicaciones lógicas. Actualmente, los conectores personalizados SOAP no admiten operaciones unidireccionales.

Importante

  • Esta es una característica en versión preliminar.

  • Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Requisitos previos

Para registrar su conector SOAP, necesita:

  • Una suscripción a Azure. Si no dispone de una suscripción, puede empezar con una cuenta de Azure gratuita. Como alternativa, puede suscribirse a una suscripción de pago por uso.

  • Una de los siguientes elementos:

    • Una URL a un archivo WSDL que define su servicio SOAP y las API.
    • Un archivo WSDL que define su servicio SOAP y las API.

    Para este procedimiento, puede usar nuestro ejemplo, Pedidos de servicio SOAP (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).

  • (Opcional) Una imagen para usar como icono del conector personalizado.

1. Crear el conector

  1. En Azure Portal, en el menú principal de Azure, seleccione Nuevo.

  2. En el cuadro de búsqueda, escriba conector de aplicaciones lógicas y, a continuación, seleccione Entrar.

    Captura de pantalla de la búsqueda de "conector de aplicaciones lógicas".

  3. En la lista Resultados, elija Conector de Logic Apps > Crear.

    Captura de pantalla del conector Create Logic Apps.

  4. Introduzca los detalles para registrar su conector como se describe en la tabla. Cuando termine, seleccione la casilla de verificación Anclar en el panel y, a continuación, seleccione Crear.

    Captura de pantalla de los detalles del conector personalizado de Logic Apps.

    Property Valor sugerido Descripción
    Name soap-connector-name Escribir un nombre para el conector.
    Suscripción Azure-subscription-name Seleccione su suscripción a Azure.
    Grupo de recursos Azure-resource-group-name Cree o seleccione un grupo de Azure para organizar sus recursos de Azure.
    Ubicación región de implementación Seleccione la misma región de Azure que su aplicación lógica.

Después de que Azure implemente su conector, debería abrirse el menú del conector Logic Apps. Si no es así, seleccione su conector SOAP en el panel de Azure.

2. Definir el conector

Especifique el archivo WDSL o la dirección URL para crear el conector, la autenticación que utiliza el conector y las acciones y los desencadenadores que proporciona el conector SOAP.

2a. Especificar el archivo WSDL o la URL del conector

  1. En el menú de su conector, seleccione Conector Logic Apps si aún no está seleccionado.

  2. En la barra de herramientas, seleccione Editar.

    Captura de pantalla de Editar conector personalizado

  3. Seleccione General para proporcionar los detalles en estas tablas para crear, proteger y definir las acciones y los desencadenadores para su conector SOAP.

    1. Para Conectores personalizados, seleccione SOAP para su Punto de conexión de API para proporcionar el archivo WSDL que describe su API.

      Captura de pantalla de proporcionar el archivo WSDL para su API

      Opción Formato Descripción
      Cargar WSDL desde el archivo WSDL-file Vaya a la ubicación del archivo WSDL y selecciónelo.
      Cargar WSDL desde una URL http://path-to-wsdl-file Introduzca la URL para el archivo WSDL del servicio.
      SOAP a REST No aplicable Transforme las API del servicio SOAP en API REST.

    2. Para Información general, cargue un icono para su conector.

      Normalmente, los campos Descripción, Anfitrión y URL base se rellenan automáticamente desde el archivo WSDL. Si no lo son, agregue esta información como se describe en la tabla y, a continuación, seleccione Continuar.

      Captura de detalles del conector

      Opción o configuración Formato Descripción
      Cargar icono png-or-jpg-file-under-1-MB Un icono que representa su conector

      Color: preferiblemente un logotipo blanco sobre un fondo de color.

      Dimensiones: un logotipo de aproximadamente 160 × 160 píxeles dentro de un cuadrado de 230 × 230 píxeles
      Color de fondo del icono icon-brand-color-hexadecimal-code Color detrás del icono que coincide con el color de fondo en el archivo del icono.

      Formato: hexadecimal. Por ejemplo, #007ee5 representa el color azul.
      Descripción connector-description Introduzca una breve descripción para el conector.
      Anfitrión connector-host Introduzca el dominio de host para su servicio SOAP.
      URL base connector-base-URL Introduzca la URL base para el servicio SOAP.

2b. Describir la autenticación que usa el conector

  1. Seleccione Seguridad y, a continuación, revise o describa la autenticación que utiliza su conector. La autenticación asegura que las identidades de sus usuarios fluyan adecuadamente entre su servicio y cualquier cliente.

    Por defecto, el Tipo de autenticación de su conector se establece en Sin autenticación.

    Captura de pantalla del tipo de autenticación.

    Para cambiar el tipo de autenticación, seleccione Editar. Puede elegir Autenticación básica. Para usar etiquetas de parámetros diferentes a los valores predeterminados, actualícelos en Etiqueta de parámetro.

    Captura de pantalla de autenticación básica.

  2. Para guardar su conector después de introducir la información de seguridad, en la parte superior de la página, seleccione Actualizar conector y luego seleccione Continuar.

2c. Revisar, actualizar o definir acciones y desencadenadores para el conector

  1. Seleccione Definición y, a continuación, revise, edite o defina nuevas acciones y desencadenadores que los usuarios pueden agregar a sus flujos de trabajo.

    Las acciones y los desencadenadores se basan en las operaciones definidas en su archivo WSDL, que rellenan automáticamente la página Definición e incluyen los valores de solicitud y respuesta. Si las operaciones requeridas ya aparecen aquí, puede pasar al siguiente paso del proceso de registro sin realizar cambios en esta página.

    Captura de pantalla de definición de conector.

  2. (Opcional) Si desea editar acciones y desencadenadores existentes, o agregar nuevos, vaya a un ejemplo de editar una definición de API.

3. Terminar de crear el conector

Cuando esté listo para enviar la encuesta, seleccione Actualizar conector para implementar el conector.

Enhorabuena. Ahora, cuando crea una aplicación lógica, puede encontrar su conector en Logic Apps Designer y agregar ese conector a su aplicación lógica.

Captura de pantalla de cómo encontrar su conector en Logic Apps Designer.

Comparta su conector con otros usuarios de Logic Apps

Los conectores personalizados registrados pero no certificados funcionan como los conectores prediseñados, con una excepción. Solo están disponibles para el autor del conector y los usuarios que tienen el mismo inquilino de Microsoft Entra ID y suscripción de Azure para Logic Apps en la región donde se implementan esas aplicaciones. Aunque compartir es opcional, es posible que tenga escenarios en los que desee compartir sus conectores con otros usuarios.

Importante

Si comparte un conector, otros podrían comenzar a depender de ese conector. Al eliminar su conector, se eliminan todas las conexiones a ese conector.

Para compartir su conector con usuarios externos fuera de estos límites, por ejemplo, con todos los usuarios de Logic Apps, certifique su conector. Para obtener más información, vaya a Certificar su conector.

Preguntas frecuentes

P: ¿El conector SOAP está disponible con carácter general?
R: el conector SOAP está en versión preliminar y aún no es un servicio disponible con carácter general.

P: ¿Existen restricciones o problemas conocidos para el conector SOAP?
R: Sí. Para obtener más información, vaya a Restricciones del conector SOAP y problemas conocidos.

P: ¿Hay algún límite para los conectores personalizados?
R: Sí. Para obtener más información, vaya a Límites de conectores personalizados.

Obtener soporte técnico

  • Para obtener ayuda con el desarrollo y la incorporación, o para solicitar funciones que no están disponibles en el asistente de registro, comuníquese con condevhelp@microsoft.com. Microsoft monitorea esta cuenta en busca de preguntas y problemas de desarrollo, y los dirige al equipo apropiado.

  • Para hacer o responder preguntas, o ver qué están haciendo otros usuarios de Logic Apps, vaya al Foro de Azure Logic Apps.

  • Para ayudar a mejorar Logic Apps, vote o envíe ideas en el Sitio de comentarios de usuarios de Logic Apps.

Consulte también

Certificación del conector
Preguntas frecuentes sobre el conector personalizado para Azure Logic Apps, Power Automate y Power Apps

Proporcionar comentarios

Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de características. Para enviar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione el tipo de comentario.