Instalación y uso del adaptador de aplicación lógica en BizTalk ServerInstall and use the Logic App Adapter on BizTalk Server

BizTalk Server usa el adaptador de Logic Apps para recibir mensajes de una aplicación lógica de Azure o enviar mensajes a una aplicación lógica de Azure.BizTalk Server uses the Logic Apps adapter to receive messages from an Azure logic app, or send messages to an Azure logic app.

En Azure, se crea una aplicación lógica.In Azure, we create a logic app. Esta aplicación lógica usa el conector de BizTalk para conectarse a una ubicación de recepción que se crea en el BizTalk Server.This logic app uses the BizTalk Connector to connect to a receive location that you create on your BizTalk Server. En este tema se supone que está familiarizado con Azure Logic Apps.This topic assumes you have some familiarity with Azure Logic Apps. Si no está familiarizado con Logic Apps, le recomendamos que Aprenda más sobre ellase incluso crear su propia aplicación lógica.If you're new to logic apps, we suggest learning more about them, and even creating your own logic app.

En este tema, se enumeran los pasos para recibir un mensaje en BizTalk Server desde una aplicación lógica.In this topic, we list the steps to receive a message in BizTalk Server from a logic app. Otra forma, la aplicación lógica envía mensajes a un BizTalk Server.Put another way, the logic app sends messages to a BizTalk Server. El lado de recepción usa las aplicaciones de IIS para controlar la comunicación con el servicio de Azure.The receive-side uses applications in IIS to handle the communication with the Azure service. Si BizTalk Server es local, también se instala una puerta de enlace de datos en el BizTalk Server y se crea una puerta de enlace en Azure.If BizTalk Server is on-premises, you also install a data gateway on the BizTalk Server, and create a gateway in Azure.

Si BizTalk Server está instalado en una máquina virtual (VM) de Azure, puede optar por exponer la máquina virtual como un punto de conexión HTTP (obtiene una dirección URL) o no exponerla como un punto de conexión HTTP.If BizTalk Server is installed on an Azure virtual machine (VM), then you can choose to expose the VM as an HTTP endpoint (you get a URL), or don't expose it as an HTTP endpoint. Si lo expone, no es necesario usar la puerta de enlace.If you expose it, then you don't need to use the gateway. Puede escribir la dirección URL en el conector de BizTalk en la aplicación lógica.You can enter your URL in the BizTalk Connector in your logic app. Si no expone la máquina virtual (ninguna dirección URL), debe usar la puerta de enlace.If you don't expose the VM (no URL), then you need to use the gateway. Estos pasos se muestran en este tema.These steps are listed in this topic.

También le mostramos cómo enviar mensajes desde BizTalk Server a una aplicación lógica de Azure.We also show you how to send messages from BizTalk Server to an Azure logic app. Otra forma, la aplicación lógica recibe los mensajes de BizTalk Server.Put another way, the logic app receives messages from BizTalk Server. El lado de envío es bastante sencillo, como verá en este tema.The send side is fairly straightforward, as you will see in this topic.

Utilice este tema para crear una ubicación de recepción y un puerto de envío mediante el adaptador de Logic Apps.Use this topic to create a receive location and a send port using the Logic Apps adapter. Puede usar el adaptador de LogicApp en un entorno local (unido a su dominio) BizTalk Server, o una máquina virtual de Azure que ejecute BizTalk Server.You can use the LogicApp adapter in a on-premises (joined to your domain) BizTalk Server, or an Azure virtual machine running BizTalk Server.

RequisitosRequirements

  • Una suscripción de Azure para iniciar sesión en el Azure Portal y crear una aplicación lógica.An Azure subscription to sign-in to the Azure portal, and create a logic app.
  • Opcional.Optional. Para enviar un mensaje de prueba a la aplicación lógica, instale una herramienta de prueba de HTTP, como Fiddler o Postman.To send a test message to your logic app, install an HTTP testing tool, such as Fiddler or Postman. Si usa otro método para enviar un mensaje a una aplicación lógica, no tiene que usar estas herramientas.If you use another method to send a message to a logic app, you don't have to use these tools.

Instalación del adaptador de aplicación lógicaInstall the Logic App adapter

BizTalk Server 2020 y versiones más recientesBizTalk Server 2020 and newer

A partir de BizTalk Server 2020, el adaptador de aplicación lógica se incluye con la instalación de BizTalk Server.Starting with BizTalk Server 2020, the Logic App adapter is included with the BizTalk Server installation.

BizTalk Server 2016BizTalk Server 2016

  1. En el BizTalk Server, descargue e instale el adaptador de aplicación lógica:On your BizTalk Server, download and install the Logic App adapter:
  2. Haga doble clic en LogicApp Adapter.msi para instalar.Double-select LogicApp Adapter.msi to install. Acepte el contrato de licencia e Instale.Accept the license agreement, and Install.
  3. Finalice la instalación y reinicie las instancias de host de BizTalkServerApplication y BizTalkServerIsolatedHost .Finish the install, and restart the BizTalkServerApplication and BizTalkServerIsolatedHost host instances.

Una vez instalado, tiene lo siguiente:Once installed, you have the following:

  • El adaptador LogicApp se agrega a la administración de BizTalk.The LogicApp adapter is added to BizTalk Administration.

  • Se crea el controlador de envío y se usa el host BizTalkServerApplication.The send handler is created, and uses the BizTalkServerApplication host.

  • El controlador de recepción se crea como un servicio WCF y usa el host BizTalkServerIsolatedHost.The receive handler is created as a WCF service, and uses the BizTalkServerIsolatedHost host.

  • La LogicApp Adapter carpeta se crea dentro del directorio de instalación de BizTalk e incluye dos servicios: Management y ReceiveService.The LogicApp Adapter folder is created inside the BizTalk installation directory, and includes two services: Management and ReceiveService.

    El conector de BizTalk usa la Administración en una aplicación lógica para conectarse a BizTalk Server mediante la puerta de enlace de datos.The Management is used by the BizTalk Connector in a logic app to connect to BizTalk Server using the data gateway. Este servicio de administración permite a BizTalk Server recibir mensajes de una aplicación lógica de Azure mediante la puerta de enlace de datos.This management service allows BizTalk Server to receive messages from an Azure logic app using the data gateway. Este servicio solo se utiliza en el lado de recepción de BizTalk.This service is only used on the receive-side of BizTalk. No lo utiliza el lado de envío.It is not used by the send-side.

    El conector de BizTalk usa ReceiveService en una aplicación lógica al especificar la ubicación de recepción.The ReceiveService is used by the BizTalk Connector in a logic app when you enter the receive location. El ReceiveService es responsable de enviar los mensajes desde la aplicación lógica.The ReceiveService is responsible for sending the messages from the logic app. Este servicio solo se utiliza en el lado de recepción de BizTalk.This service is only used on the receive-side of BizTalk. No lo utiliza el lado de envío.It is not used by the send-side.

Recepción de mensajes desde una aplicación lógicaReceive messages from a logic app

Hay algunos pasos implicados en BizTalk Server para recibir mensajes de una aplicación lógica.There are a few steps involved for BizTalk Server to receive messages from a logic app. En esta sección se indican estos pasos.This section lists these steps. Es posible que la interfaz de usuario de Azure cambie, por lo que es posible que algunos de los pasos no sean exactamente los indicados.It's possible the user interface in Azure changes, so some of the steps may not be exactly as listed.

Requisitos previosPrerequisites

Usar el adaptador de NullAdapter y la aplicación lógica juntos: solo BizTalk Server 2016Using the NullAdapter and Logic App Adapter together - BizTalk Server 2016 only

Si instala el adaptador de aplicación lógica y el NullAdapter, es posible que vea el siguiente error:If you install the Logic App Adapter and the NullAdapter, you may see the following error:

Another adapter with the same OutboundEngineCLSID value already exists

El GUID de la clase de adaptador es el mismo para el adaptador de aplicación lógica y NullAdapter.The GUID of the Adapter class is the same for Logic App Adapter and NullAdapter. Si se necesitan ambos adaptadores, puede:If both adapters are needed, you can:

  1. Descargue el código fuente de NullAdapter en github.Download the NullAdapter source code on GitHub.
  2. Actualice el GUID en la clase NullSendAdapter.CS .Update the GUID in the NullSendAdapter.cs class.
  3. Actualice el valor OutboundEngineCLSID en el archivo NullAdapter. reg .Update the OutboundEngineCLSID value in the NullAdapter.reg file.
  4. Compile e implemente el NullAdapter.Build and deploy the NullAdapter.

Paso 1: creación de las aplicaciones de IISStep 1: Create the IIS applications

Las aplicaciones de IIS usan los servicios de administración y ReceiveService.The IIS applications use the Management and ReceiveService services.

Puede ejecutar las aplicaciones de IIS mediante un nuevo grupo de aplicaciones o un grupo de aplicaciones existente.You can run the IIS applications using a new application pool, or an existing application pool. La identidad del AppPool requiere la pertenencia a los mismos grupos que la cuenta que ejecuta los servicios de BizTalk, como los grupos usuarios de la aplicación de BizTalk y usuarios de hosts aislados de BizTalk.The identity of the AppPool requires membership to the same groups as the account that runs the BizTalk services, such as the BizTalk Application Users and BizTalk Isolated Host Users groups.

Sugerencia

Si crea un nuevo grupo de aplicaciones, mantenga la versión predeterminada de .NET CLR y la canalización administrada.If you create a new application pool, then keep the default .NET CLR version, and managed pipeline. Recuerde que debe elegir una identidad (configuración avanzada) que tenga la pertenencia a los mismos grupos de BizTalk que la cuenta de servicio de BizTalk.Remember, choose an identity (Advanced Settings) that has membership to the same BizTalk groups as your BizTalk service account.

Crear la aplicación de administración de IISCreate the Management IIS application

La dirección URL de esta aplicación IIS la usa el conector de BizTalk (en la aplicación lógica) para usar la puerta de enlace de datos en el BizTalk Server.The URL of this IIS application is used by the BizTalk Connector (in your logic app) to use the data gateway on your BizTalk Server.

BizTalk Server 2020 y versiones más recientesBizTalk Server 2020 and newer
  1. Configure las API de REST mediante el Asistente para configuración de BizTalk.Configure the REST APIs using the BizTalk Configuration Wizard. Para obtener ayuda con la configuración, consulte la Guía de configuración.For help with configuration, please refer to the Configuration Guide. Para obtener más información sobre las API de REST, consulte la referencia de la API de REST de BizTalk.For more details about the REST APIs, please refer to the BizTalk REST API Reference
  2. Abra un explorador web y vaya a http://localhost/BizTalkManagementService/Schemas.Open a web browser, and go to http://localhost/BizTalkManagementService/Schemas. Se muestra una lista de esquemas o se le pide que abra o guarde schemas.json .Either a list of schemas display, or you are prompted to open/save schemas.json. El resultado real depende del explorador Web.The actual result depends on your web browser. Si no sucede nada, Compruebe la configuración de la API de REST.If neither of these happens, then please check your REST API configuration.
BizTalk Server 2016BizTalk Server 2016
  1. Abra el Administrador de Internet Information Services (IIS).Open the Internet Information Services (IIS) Manager.

  2. Haga clic con el botón secundario en sitio web predeterminado y agregue aplicación.Right-click Default Web Site, and Add Application. En esta nueva aplicación:In this new application:

    1. Escriba el alias (nombre) de la aplicación, como IISLogicApp.Enter the Alias (name) for your application, such as IISLogicApp.
    2. Seleccione el grupo de aplicaciones.Select the application pool.
    3. Establezca la ruta de acceso física en C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management .Set the Physical path to C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management.
    4. La configuración de pruebas para confirmar la identidad del grupo de aplicaciones supera las pruebas de autenticación y autorización.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.
  3. Haga clic en Aceptar para guardar los cambios.Select OK to save your changes.

  4. Abra un explorador Web y vaya a http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26 , como http://localhost/IISLogicApp/Schemas?api-version=2016-10-26 .Open a web browser, and go to http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26, such as http://localhost/IISLogicApp/Schemas?api-version=2016-10-26. Se muestra una lista de esquemas o se le pide que abra o guarde schemas.json .Either a list of schemas display, or you are prompted to open/save schemas.json. El resultado real depende del explorador Web.The actual result depends on your web browser. Si ninguno de estos sucede, es posible que la identidad de AppPool no presente la pertenencia a los grupos de BizTalk.If neither of these happens, then your AppPool identity may be missing membership to the BizTalk groups.

Crear la aplicación IIS ReceiveService de BizTalkCreate the BizTalk ReceiveService IIS application

La dirección URL de esta aplicación IIS la usa el conector de BizTalk (en la aplicación lógica) cuando se elige la ubicación de recepción.The URL of this IIS application is used by the BizTalk Connector (in your logic app) when you choose the receive location.

  1. Abra el Administrador de Internet Information Services (IIS).Open the Internet Information Services (IIS) Manager.

  2. Haga clic con el botón secundario en sitio web predeterminado y agregue aplicación.Right-click Default Web Site, and Add Application. En esta nueva aplicación:In this new application:

    1. Escriba el alias (nombre) de la aplicación, como ReceiveWCFService.Enter the Alias (name) for your application, such as ReceiveWCFService.

    2. Seleccione el mismo grupo de aplicaciones que la aplicación IIS anterior.Select the same application pool as the previous IIS application.

    3. Establezca la ruta de acceso física en:Set the Physical path to:

      • BizTalk Server 2020: C:\Program Files (x86)\Microsoft BizTalk Server\LogicApp Adapter\ReceiveService .BizTalk Server 2020: C:\Program Files (x86)\Microsoft BizTalk Server\LogicApp Adapter\ReceiveService.
      • BizTalk Server 2016: C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService .BizTalk Server 2016: C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService.
    4. La configuración de pruebas para confirmar la identidad del grupo de aplicaciones supera las pruebas de autenticación y autorización.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.

  3. Haga clic en Aceptar para guardar los cambios.Select OK to save your changes.

Paso 2: creación de una aplicación lógicaStep 2: Create a logic app

  1. En el Azure portal, cree una nueva aplicación lógica.In the Azure portal, create a new logic app.

  2. Agregue el desencadenador cuando se recibe una solicitud HTTP .Add the When an HTTP request is received trigger.

  3. Agregue el mensaje BizTalk Server-prepare desde la acción JSON.Add the BizTalk Server - Prepare message from JSON action.

  4. Opcional: seleccione conectar a través de puerta de enlace de datos local y escriba lo siguiente:Optional: Select Connect via on-premise data gateway, and enter the following:

    PropiedadProperty DescripciónDescription
    BizTalk Server dirección URLBizTalk Server URL Escriba el nombre de dominio completo (FQDN) de la dirección URL de la aplicación de administración de BizTalk en IIS.Enter the fully qualified domain name (FQDN) of the BizTalk Management in IIS application URL. Por ejemplo, escriba http://BizTalkServerName.corp.contoso.com/IISLogicApp/.For example, enter http://BizTalkServerName.corp.contoso.com/IISLogicApp/.
    Tipo de autenticaciónAuthentication Type Seleccione Windows.Select Windows.
    Nombre de usuarioUsername Escriba la identidad del grupo de aplicaciones de IIS.Enter the identity of the IIS application pool.
    ContraseñaPassword Escriba la contraseña del grupo de aplicaciones de IIS.Enter the password of the IIS application pool.
    Puerta de enlaceGateway Seleccione la puerta de enlace que creó.Select the gateway you created.

    Sugerencia

    Recuerde que la puerta de enlace de datos solo es necesaria si:Remember, the data gateway is only required if:

    • Está usando una BizTalk Server localYou're using an on-premises BizTalk Server
    • Está usando una máquina virtual de BizTalk Server de Azure y la máquina virtual no se expone como un punto de conexión http (ninguna dirección URL)You're using a BizTalk Server Azure virtual machine and the VM is NOT exposed as an HTTP endpoint (no URL)
  5. Seleccione Crear.Select Create.

  6. Configure la acción.Configure the action. En cuerpo, seleccione la salida de cuerpo http.For Body, select the HTTP body output. En esquema, seleccione el esquema que desea usar.For Schema, select the schema you want to use.

    Nota

    En este paso se da por supuesto que está familiarizado con los esquemas de BizTalk y sabe qué esquema desea.This step assumes you are familiar with schemas in BizTalk, and know which schema you want. Si no está seguro, implemente el ejemplo de SDK HelloWorld, actualice sus artefactos para usar el adaptador de aplicación lógica y use su esquema y el mensaje de ejemplo.If you're not sure, then deploy the HelloWorld SDK sample, update its artifacts to use the Logic App adapter, and use its schema and sample message.

  7. Agregue un nuevo paso y seleccione la acción BizTalk Server-Send Message .Add a new step, and select the BizTalk Server - Send message action. En Ubicación de recepción, seleccione la dirección URL en la lista desplegable o escriba el nombre de dominio completo (FQDN) de la dirección URL de la aplicación de IIS ReceiveService.For Receive Location, select the URL from the drop-down list, or enter the fully qualified domain name (FQDN) of the ReceiveService IIS application URL. Por ejemplo, escriba http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svc.For example, enter http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svc.

    Sugerencia

    Al crear la ubicación de recepción, esta dirección URL exacta también se especificará en las propiedades de transporte de la ubicación de recepción como dirección pública (pestaña general).When you create the receive location, this exact URL will also be entered in the receive location transport properties as the Public Address (General tab).

    En cuerpo, seleccione el resultado del cuerpo de la acción de BizTalk Server anterior.For Body, select the body output from the previous BizTalk Server action.

  8. Guarde los cambios mediante Guardar.Save your changes.

Al guardar, el desencadenador de solicitud HTTP crea automáticamente una dirección URL.When you save, the HTTP Request trigger automatically creates a URL. Copie esta dirección URL.Copy this URL. Lo necesitará en el paso 4: envío de un mensaje (en este artículo).You need it in Step 4: Send a message (in this article).

Paso 3: crear un puerto de recepción y una ubicación de recepciónStep 3: Create a receive port and a receive location

Nota

En lugar de crear sus propios puertos de recepción y la misma ubicación de recepción, puede implementar el ejemplo de SDK HelloWorld.Instead of creating your own receive ports and receive location, you can deploy the HelloWorld SDK sample. Actualice los artefactos para usar el adaptador de Logic Apps.Update the artifacts to use the Logic Apps adapter.

En esta sección se enumeran los pasos para crear sus propios artefactos.This section lists the steps to create your own artifacts.

  1. En BizTalk Server administración, expanda BizTalk Server administración, grupo de BizTalk, aplicaciones y, a continuación, expanda la aplicación en la que desea ejecutar la ubicación de recepción.In BizTalk Server Administration, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to run the receive location. Por ejemplo, expanda BizTalk Application 1.For example, expand BizTalk Application 1.

  2. Haga clic con el botón secundario en puertos de recepción, seleccione nuevo y seleccione Puerto de recepción unidireccional.Right-select Receive Ports, select New, and select One-way Receive Port.

  3. En las propiedades del puerto de recepción, escriba lo siguiente:In the Receive Port properties, enter the following:

    UseUse this Para hacer estoTo do this
    NombreName Escriba un nombre para el puerto de recepción.Enter a name for the receive port. Por ejemplo, escriba LAReceivePort.For example, enter LAReceivePort.
    AutenticaciónAuthentication Opciones:Options:
    • Sin autenticación: valor predeterminado.No Authentication: Default. Deshabilita la autenticación de.Disables authentication.
    • Eliminar mensajes si hay errores en la autenticación: habilita la autenticación, pero para quitar los mensajes no autenticados.Drop messages if authentication fails: Enables authentication but to drop unauthenticated messages.
    • Conservar mensajes si hay errores en la autenticación: haga clic en esta opción para habilitar la autenticación y mantener los mensajes no autenticados.Keep messages if authentication fails: Click this option to enable authentication and keep unauthenticated messages.
    Habilitar enrutamiento para mensajes con erroresEnable routing for failed messages Enruta cualquier mensaje con errores de procesamiento a una aplicación de suscripción (por ejemplo, otro puerto de recepción o programación de orquestación).Routes any message that fails processing to a subscribing application (such as another receive port or orchestration schedule). Desactive esta opción para suspender los mensajes con errores y generar una confirmación negativa (NACK).Uncheck this option to suspend failed messages and generate a negative acknowledgment (NACK). Esta opción está desactivada de forma predeterminada.The default value is cleared. Para obtener más información, consulte Habilitar el enrutamiento para mensajes con errores para un puerto de recepción.For more information, see How to Enable Routing for Failed Messages for a Receive Port.
  4. Seleccione ubicaciones de recepción y seleccione nuevo.Select Receive Locations, and select New.

  5. Escriba un nombre para la ubicación de recepción.Enter a Name for the receive location. Por ejemplo, escriba LAReceiveLoc.For example, enter LAReceiveLoc.

  6. En tipo, seleccione LogicApp en la lista y seleccione el botón Configurar.For the Type, select LogicApp from the list, and select the Configure button.

  7. En la pestaña General , configure la dirección del punto de conexión para la aplicación lógica:In the General tab, configure the endpoint address for your logic app:

    UseUse this Para hacer estoTo do this
    Dirección (URI)Address (URI) Obligatorio.Required. Escriba la dirección URL de la aplicación IIS ReceiveService de BizTalk ( /YourIISApp2Name/Service1.svc ).Enter the BizTalk ReceiveService IIS application URL (/YourIISApp2Name/Service1.svc). Por ejemplo, escriba /ReceiveWCFService/Service1.svc.For example, enter /ReceiveWCFService/Service1.svc.
    Dirección públicaPublic Address Obligatorio.Required. Escriba http://<your fully qualified machine name>/YourIISApp2Name/Service1.svc.Enter http://<your fully qualified machine name>/YourIISApp2Name/Service1.svc. Por ejemplo, escriba http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svc.For example, enter http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svc.

    Esta dirección URL exacta también se muestra en la aplicación lógica en la ubicación de recepción.This exact URL is also listed in your logic app in the receive location.
  8. Opcional.Optional. En la pestaña enlace , configure las propiedades relacionadas con el tiempo de espera y la codificación del enlace de WCF-WebHttp subyacente.In the Binding tab, configure any timeout and encoding-related properties of the underlying WCF-WebHttp binding. Estas propiedades son útiles cuando se trabaja con mensajes de gran tamaño.These properties are helpful when dealing with large messages.

    UseUse this Para hacer estoTo do this
    Tiempo de espera de aperturaOpen timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de apertura del canal.Enter the time interval it should take for the channel open operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tiempo de espera de envíoSend timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de envío.Enter the time interval it should take for the send operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero. Si utiliza un puerto de recepción de solicitud-respuesta, este valor especifica un intervalo de tiempo para que se complete toda la interacción, aunque el cliente devuelva un mensaje de gran tamaño.If you use a request-response receive port, this value specifies a time span for the entire interaction to complete, even if the client returns a large message.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tiempo de espera de cierreClose timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de cierre del canal.Enter the time interval it should take for the channel close operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tamaño máximo de mensaje recibido (bytes)Maximum received message size (bytes) Escriba el tamaño máximo, en bytes, para un mensaje, incluidos los encabezados, que se va a recibir en la conexión.Enter the maximum size, in bytes, for a message including headers, to be received on the wire. El tamaño de los mensajes está limitado por la cantidad de memoria asignada para cada mensaje.The size of the messages is bound by the amount of memory allocated for each message. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS).You can use this property to limit exposure to denial of service (DoS) attacks.

    Valor predeterminado: 65536Default value: 65536
    Valor máximo: 2147483647Maximum value: 2147483647
    Número máximo de llamadas concurrentesMaximum concurrent calls Especifique el número de llamadas simultáneas a una instancia de servicio única.Enter the number of concurrent calls to a single service instance. Las llamadas que superan el límite se ponen en cola.Calls in excess of the limit are queued. Establecer este valor en 0 es equivalente a establecerlo en Int32.MaxValue.Setting this value to 0 is equivalent to setting it to Int32.MaxValue.

    El valor predeterminado es 200.The default is 200.
  9. Opcional.Optional. En la pestaña seguridad , configure las propiedades de seguridad.In the Security tab, configure any security properties. Para fines de desarrollo, puede elegir ninguno:For development purposes, you can choose None:

    UseUse this Para hacer estoTo do this
    Modo de seguridadSecurity mode Opciones:Options:

    • Ninguno: los mensajes no están protegidos durante la transferencia.None: Messages are not secured during transfer.
    • Transporte: se proporciona seguridad basada en transporte HTTPS.Transport: Security is provided using the HTTPS transport. Los mensajes SOAP están protegidos mediante HTTPS.The SOAP messages are secured using HTTPS. Para usar este modo, debe configurar Capa de sockets seguros (SSL) en Internet Information Services (IIS).To use this mode, you must set up Secure Sockets Layer (SSL) in Internet Information Services (IIS).
    • TransportCredentialOnly: valor predeterminado.TransportCredentialOnly: Default.
    Tipos de credenciales de cliente de transporteTransport client credential types Elija el tipo de credencial al usar la autenticación de cliente.Choose the credential type when using client authentication. Opciones:Options:

    • Ninguno: no se produce autenticación en el nivel de transporte.None: No authentication occurs at the transport level.
    • Básica: utiliza la autenticación básica para enviar nombres de usuario y contraseñas en texto sin formato a través de la red.Basic: Uses Basic authentication to send user names and passwords in plain text over the network. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales.You must create the domain or local user accounts corresponding to the credentials.
    • Digest: utiliza la autenticación implícita para enviar contraseñas como valor hash a través de la red.Digest: Uses Digest authentication to send passwords as a hash value over the network. Solo está disponible en los dominios con controladores de dominio que ejecutan la autenticación de sistemas operativos Windows Server.Only available on domains with domain controllers running Windows Server operating systems authentication. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.You must create the domain or local user accounts corresponding to client credentials.
    • NTLM: valor predeterminado.Ntlm: Default. Los clientes envían las credenciales sin enviar una contraseña a esta ubicación de recepción.Clients sends the credentials without sending a password to this receive location. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.You must create the domain or local user accounts corresponding to client credentials.
    • Windows: la autenticación integrada de Windows negocia Kerberos o NTLM, prefiriendo Kerberos si hay un dominio presente.Windows: Windows integrated authentication negotiates Kerberos or NTLM, preferring Kerberos if a domain is present. Para usar Kerberos, es importante que el cliente identifique el servicio con un nombre de entidad de seguridad de servicio (SPN).To use Kerberos, it is important to have the client identify the service with a service principal name (SPN). Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.You must create the domain or local user accounts corresponding to client credentials.
    • Certificado: utiliza un certificado de cliente.Certificate: Uses a client certificate. La cadena de certificados de CA para los certificados X. 509 de cliente debe estar instalada en el almacén de certificados entidades de certificación raíz de confianza del equipo para que los clientes puedan autenticarse en esta ubicación de recepción.The CA certificate chain for the client X.509 certificates must be installed in the Trusted Root Certification Authorities certificate store of this computer so that the clients can authenticate to this receive location.
    • InheritedFromHostInheritedFromHost
    Uso del inicio de sesión únicoUse Single Sign-On
  10. Opcional.Optional. En la pestaña mensajes , use la propiedad encabezados HTTP salientes para agregar cualquier encabezado personalizado y use las propiedades adicionales para ayudar a los errores:In the Messages tab, use the Outbound HTTP Headers property to add any custom headers, and use the additional properties to help with faults:

    UseUse this Para hacer estoTo do this
    Encabezados HTTP salientesOutbound HTTP Headers Escriba los encabezados HTTP que desee marcar en el mensaje de respuesta.Enter any HTTP headers that you want stamped on the response message.
    Deshabilitar ubicación en caso de errorDisable location on failure Deshabilita la ubicación de recepción si se produce un error en el procesamiento de entrada debido a un error de canalización de recepción o a un error de enrutamiento.Disables the receive location if inbound processing fails due to a receive pipeline failure or a routing failure. El valor predeterminado es desactivado.Default is unchecked.
    Suspender mensaje de solicitud en caso de errorSuspend request message on failure Suspende el mensaje de solicitud si se produce un error en el procesamiento de entrada debido a un error de canalización de recepción o a un error de enrutamiento.Suspends the request message if inbound processing fails due to a receive pipeline failure or a routing failure. El valor predeterminado es desactivado.Default is unchecked.
    Incluir detalle de excepción en erroresInclude exception detail in faults Cuando se produce un error, devuelve cualquier error de SOAP para ayudar a la depuración.When an error occurs, returns any SOAP faults to help debugging. El valor predeterminado es desactivado.Default is unchecked.

Administrar ubicaciones de recepción describe las propiedades adicionales.Managing Receive Locations describes the additional properties.

Paso 4: envío de un mensajeStep 4: Send a message

  1. Abra Fiddler o Postman (o el que prefiera).Open Fiddler or Postman (or whatever you prefer).

  2. Pegue la dirección URL del desencadenador de solicitud de la aplicación lógica.Paste the URL of the Request trigger from your logic app. Copió esta dirección URL en el paso 3.You copied this URL in Step 3.

  3. Seleccione post como el verbo http y establezca el encabezado Content-Type en application/json .Select POST as the HTTP verb, and set the Content-type header to application/json. En el cuerpo, pegue el siguiente código JSON:In the body, paste the following JSON:

    {"hello":"world"}
    
  4. Dado que se trata de una llamada unidireccional a BizTalk, el resultado debe ser HTTP 202.Because this is a one-way call to BizTalk, the result should be an HTTP 202. Si utiliza el ejemplo de SDK HelloWorld, vaya a su servidor BizTalk Server.If you're using the HelloWorld SDK sample, go to your BizTalk server. Puede haber un archivo en la carpeta de envío.There may be a file in your send folder.

Envío de mensajes a una aplicación lógicaSend messages to a logic app

Paso 1: Creación de una aplicación lógicaStep 1: Create a logic app

  1. En el Azure portal, cree una nueva aplicación lógica.In the Azure portal, create a new logic app.

  2. Agregar el desencadenador cuando se recibe una solicitud HTTPAdd the When an HTTP request is received trigger

  3. Agregue la acción Office 365 Outlook-enviar un correo electrónico .Add the Office 365 Outlook - Send an email action. En dirección de, escriba la dirección de Office 365.For the To address, enter your Office 365 address. En asunto, escriba Sending from BizTalk .For the Subject, enter Sending from BizTalk. En cuerpo, elija el resultado del cuerpo del desencadenador cuando se reciba una solicitud HTTP .For Body, choose the Body output from the When an HTTP request is received trigger.

  4. La aplicación lógica tiene un aspecto similar al ejemplo siguiente:Your logic app looks similar to the following example:

    Ejemplo de adaptador de LogicApp que usa Office 365 y Outlook

  5. Copie la dirección URL HTTP POST que se crea automáticamente al guardar la aplicación lógica. necesitará esta dirección URL en el paso siguiente.Copy the HTTP POST URL that is automatically created when you save the logic app; you need this URL in the next step. Es posible que tenga que cerrar y volver a abrir la aplicación lógica para ver la dirección URL.You may have to close and reopen the logic app to see the URL.

Paso 2: crear un puerto de envíoStep 2: Create a Send Port

Por BizTalk Server para enviar mensajes a una aplicación lógica, la aplicación lógica debe tener un desencadenador manual , como manual, cuando se recibe una solicitud HTTP.For BizTalk Server to send messages to a logic app, the logic app must have a Manual trigger, such as Manual - When an HTTP request is received.

  1. En BizTalk Server administración, expanda BizTalk Server administración, grupo de BizTalk, aplicaciones y, a continuación, expanda la aplicación en la que desea ejecutar el puerto de envío.In BizTalk Server Administration, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to run the send port. Por ejemplo, expanda BizTalk Application 1.For example, expand BizTalk Application 1.

  2. Haga clic con el botón secundario en puertos de envío, seleccione nuevo y seleccione Puerto de envío unidireccional estático.Right-select Send Ports, select New, and select Static One-way Send Port.

  3. Escriba un nombre para el puerto de envío.Enter a Name for the send port. Por ejemplo, escriba LASendPort.For example, enter LASendPort.

  4. En tipo, seleccione LogicApp en la lista y seleccione el botón configurar .For the Type, select LogicApp from the list, and select the Configure button.

  5. En la pestaña General , configure el URI de devolución de llamada del desencadenador de aplicación lógica.In the General tab, configure the Callback URI of your logic app trigger. Existen dos modos para hacer esto:There are two ways to do this:

    Opción 1 : pegue la dirección URL http post que copió en el paso anterior en la propiedad DESENCADENAdor (URI de devolución de llamada) .Option 1 : Paste the HTTP POST URL you copied in the previous step in the Trigger (Callback URI) property. También puede copiar el URI mediante los pasos siguientes:You can also copy the URI using the following steps:

    1. En el Azure portal, abra la aplicación lógica en el diseñador de Logic apps (modo de edición).In the Azure portal, open your logic app in the Logic Apps designer (edit mode).

    2. Seleccione la tarjeta cuando se reciba una solicitud HTTP y copie la dirección URL.Select the When an HTTP request is received card, and copy the URL.

    3. En el puerto de envío, pegue esta dirección URL en la propiedad desencadenador (URI de devolución de llamada) .In your send port, paste this URL in the Trigger (Callback URI) property.

      Sugerencia

      También puede usar las API de administración para obtener este URI.You can also use your management APIs to get this URI.

      Opción 2 : Si no conoce el URI de devolución de llamada para el desencadenador, seleccione configurar e inicie sesión en Azure.Option 2 : If you don't know the Callback URI for your trigger, select Configure, and sign-in to Azure. A continuación, use las listas desplegables para elegir la suscripción, el grupo de recursos, la aplicación lógica y el desencadenador.Then, use the drop-down lists to choose your Subscription, Resource Group, Logic App, and Trigger.

  6. Opcional.Optional. En la pestaña enlace , configure las propiedades relacionadas con el tiempo de espera y la codificación del enlace de WCF-WebHttp subyacente.In the Binding tab, configure any timeout and encoding-related properties of the underlying WCF-WebHttp binding. Estas propiedades son útiles cuando se trabaja con mensajes de gran tamaño.These properties are helpful when dealing with large messages.

    UseUse this Para hacer estoTo do this
    Tiempo de espera de aperturaOpen timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de apertura del canal.Enter the time interval it should take for the channel open operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tiempo de espera de envíoSend timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de envío.Enter the time interval it should take for the send operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero. Si utiliza un puerto de recepción de solicitud-respuesta, este valor especifica un intervalo de tiempo para que se complete toda la interacción, aunque el cliente devuelva un mensaje de gran tamaño.If you use a request-response receive port, this value specifies a time span for the entire interaction to complete, even if the client returns a large message.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tiempo de espera de cierreClose timeout Especifique el intervalo de tiempo que debe tardar en completarse la operación de cierre del canal.Enter the time interval it should take for the channel close operation to complete. Este valor debe ser mayor o igual que System.TimeSpan.Zero.This value should be greater than or equal to System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00Default value: 00:01:00
    Valor máximo: 23:59:59Maximum value: 23:59:59
    Tamaño máximo de mensaje recibido (bytes)Maximum received message size (bytes) Escriba el tamaño máximo, en bytes, para un mensaje, incluidos los encabezados, que se va a recibir en la conexión.Enter the maximum size, in bytes, for a message including headers, to be received on the wire. El tamaño de los mensajes está limitado por la cantidad de memoria asignada para cada mensaje.The size of the messages is bound by the amount of memory allocated for each message. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS).You can use this property to limit exposure to denial of service (DoS) attacks.

    El adaptador Logic Appa aprovecha la clase WebHttpBinding en el modo de transferencia almacenado en búfer para comunicarse con un punto de conexión.The logic appa adapter leverages the WebHttpBinding class in the buffered transfer mode to communicate with an endpoint. Para el modo de transferencia almacenado en búfer, la propiedad WebHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad.For the buffered transport mode, the WebHttpBinding.MaxBufferSize property is always equal to the value of this property.

    Valor predeterminado: 65536Default value: 65536
    Valor máximo: 2147483647Maximum value: 2147483647
  7. Opcional.Optional. En la pestaña mensajes , utilice la propiedad encabezados HTTP salientes para agregar encabezados personalizados en el mensaje saliente.In the Messages tab, use the Outbound HTTP Headers property to add any custom headers on the outgoing message.

  8. Seleccione OK (Aceptar) para guardar la configuración.Select OK to save your configuration.

Administrar puertos de envío y grupos de puertos de envío describe las propiedades adicionales del puerto de envío.Managing Send Ports and Send Port Groups describes the additional send port properties.

Paso 3: enviar algunos mensajesStep 3: Send some messages

Puede crear un puerto de recepción y una ubicación de recepción mediante el adaptador de archivo.You can create a receive port and receive location using the File adapter. Asegúrese de que la aplicación lógica está habilitada.Be sure your logic app is enabled.

  1. Crear un puerto de recepción, como FileSendPort,Create a receive port, such as FileSendPort,

  2. Cree una ubicación de recepción y establezca las propiedades similares a:Create a receive location, and set the properties similar to:

    PropiedadProperty Entrada de ejemploSample input
    Carpeta RecepciónReceive folder C:\temp\InC:\temp\In\
    Máscara de archivoFile mask *.txt*.txt
    CanalizaciónPipeline PassThruReceivePassThruReceive
  3. En el puerto de envío que ha creado, establezca el filtro en:In the send port you created, set the Filter to:

    PropiedadProperty OperatorOperator ValorValue
    BTS.ReceivePortNameBTS.ReceivePortName == FileSendPortFileSendPort
  4. Cree un archivo de texto (FileName.txt) con el siguiente texto.Create a text file (FileName.txt) with the following text. Use este archivo de texto como el mensaje de ejemplo:Use this text file as your sample message:

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  5. Copie el mensaje de ejemplo (FileName.txt) en la carpeta de recepción.Copy your sample message (FileName.txt) into the receive folder. El puerto de envío envía el archivo. txt a la aplicación lógica con el URI especificado.The send port sends the .txt file to the logic app using the URI you entered. La aplicación lógica recibe los archivos.Your logic app receive the files. Si ha usado el conector de Office 365 Outlook, su dirección de correo electrónico debe recibir el correo electrónico con el mensaje de ejemplo.If you used the Office 365 Outlook connector, your To email address should receive the email, with the sample message.

SiguientesNext

Qué son Logic AppsWhat are Logic Apps

Creación de una aplicación lógicaCreate a logic app

Usar adaptadores en BizTalk ServerUsing adapters in BizTalk Server