Adaptador de aplicación lógicaLogic App Adapter

Información generalOverview

BizTalk Server utiliza el adaptador de Logic Apps para recibir mensajes desde una aplicación de lógica de Azure, o enviar mensajes a una aplicación de 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 creará 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 servidor 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 da por supuesto que tiene cierta familiaridad con Azure Logic Apps.This topic assumes you have some familiarity with Azure Logic Apps. Si está familiarizado con las aplicaciones lógicas, sugerimos aprender 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. Dicho de otro modo, la aplicación lógica envía mensajes a un servidor BizTalk Server.Put another way, the logic app sends messages to a BizTalk Server. El lado de recepción usa 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 instale una puerta de enlace de datos en el servidor BizTalk Server y crear 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 elegir exponer la máquina virtual como un extremo HTTP (obtendrá una dirección URL), o no se exponen como un extremo 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 exponerla, no es necesario utilizar 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), a continuación, deberá usar la puerta de enlace.If you don't expose the VM (no URL), then you need to use the gateway. Estos pasos se enumeran en este tema.These steps are listed in this topic.

También se muestra cómo enviar mensajes de BizTalk Server a una aplicación de lógica de Azure.We also show you how to send messages from BizTalk Server to an Azure logic app. Dicho de otro modo, 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.

Use 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 servidor de BizTalk en el entorno local (unido al dominio) o una máquina virtual de Azure que ejecuta 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 portal de Azure 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 emplea otro método para enviar un mensaje a una aplicación lógica, no debe usar estas herramientas.If you use another method to send a message to a logic app, you don't have to use these tools.

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

Hay unos pocos pasos implicados para BizTalk Server recibir mensajes desde 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 enumera estos pasos.This section lists these steps. Es posible que no puede ser exactamente como se muestra la interfaz de usuario en los cambios de Azure, por lo que algunos de los pasos.It's possible the user interface in Azure changes, so some of the steps may not be exactly as listed.

Requisitos previosPrerequisites

Paso 1: Instalar al adaptador de aplicación lógicaStep 1: Install the Logic App adapter

El adaptador de aplicación lógica es una descarga independiente y no se incluye con la instalación de BizTalk Server.The Logic App adapter is a separate download, and is not included with the BizTalk Server installation.

Importante

Para descargar el LogicAppAdapter.iso:To download the LogicAppAdapter.iso:

  1. Vaya a adaptador de Microsoft BizTalk Server para las aplicaciones lógicasy guardar.Go to Microsoft BizTalk Server Adapter for Logic Apps, and save.
  2. Abra el LogicAppAdapter.iso y ejecute el LogicApp Adapter.msi archivo para instalar.Open the LogicAppAdapter.iso, and run the LogicApp Adapter.msi file to install.
  1. En el servidor BizTalk Server, descargue e instale al adaptador de aplicación lógica.On your BizTalk Server, download and install the Logic App adapter.

  2. Haga doble clic LogicApp Adapter.msi para instalar.Double-select LogicApp Adapter.msi to install. Acepte el contrato de licencia y instalar.Accept the license agreement, and Install.

  3. Finalizar la instalación, un reinicio d la BizTalkServerApplication y BizTalkServerIsolatedHost las instancias de host.Finish the install, an d restart the BizTalkServerApplication and BizTalkServerIsolatedHost host instances.

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

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

  • El controlador de envío se crea y 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.

  • El C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter carpeta se crea e incluye dos servicios: Administración y ReceiveService.The C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter folder is created, and includes two services: Management and ReceiveService.

    El administración usa el conector de BizTalk 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 que BizTalk Server recibir mensajes de una aplicación de 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 usa en el lado de recepción de BizTalk.This service is only used on the receive-side of BizTalk. No se utiliza en el lado de envío.It is not used by the send-side.

    El ReceiveService utilizado por el conector de BizTalk en una aplicación lógica cuando escriba 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 de la aplicación lógica.The ReceiveService is responsible for sending the messages from the logic app. Este servicio solo se usa en el lado de recepción de BizTalk.This service is only used on the receive-side of BizTalk. No se utiliza en el lado de envío.It is not used by the send-side.

Usar conjuntamente la NullAdapter y el adaptador de aplicación lógicaUsing the NullAdapter and Logic App Adapter together

Si instala el adaptador de aplicación lógica y la NullAdapter, verá 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 los dos adaptadores, puede:If both adapters are needed, you can:

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

Paso 2: Crear las aplicaciones de IISStep 2: Create the IIS applications

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

Puede ejecutar las aplicaciones de IIS con 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 de AppPool requiere la pertenencia a los mismos grupos que la cuenta que ejecuta los servicios de BizTalk, como los grupos de 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, a continuación, mantenga la versión de .NET CLR de forma predeterminada y canalización administrada.If you create a new application pool, then keep the default .NET CLR version, and managed pipeline. Recuerde, elija una identidad (configuración avanzada) que tiene 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 IISCreate the Management IIS application

La dirección URL de esta aplicación de IIS se usa el conector de BizTalk (en la aplicación lógica) para usar la puerta de enlace de datos en el servidor 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.

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

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

    1. Escriba el Alias (nombre) para 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. Establecer el ruta de acceso física a 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. Configuración de pruebas para confirmar el grupo de aplicaciones identidad pasa la autenticación y autorización se comprueba.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.
  3. Seleccione 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, tales 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. Una lista de presentación de los esquemas o deba abrir o guardar schemas.json.Either a list of schemas display, or you are prompted to open/save schemas.json. El resultado real depende de su explorador web.The actual result depends on your web browser. Si se produce ninguno de estos, su identidad AppPool posible que falte 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 de BizTalk ReceiveService IISCreate the BizTalk ReceiveService IIS application

La dirección URL de esta aplicación de IIS se usa el conector de BizTalk (en la aplicación lógica) al elegir 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 en sitio Web predeterminado, y Agregar aplicación.Right-click Default Web Site, and Add Application. En esta nueva aplicación:In this new application:

    1. Escriba el Alias (nombre) para la aplicación, como ReceiveWCFService.Enter the Alias (name) for your application, such as ReceiveWCFService.
    2. Seleccione el mismo grupo de aplicaciones como la aplicación de IIS anterior.Select the same application pool as the previous IIS application.
    3. Establecer el ruta de acceso física a C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService.Set the Physical path to C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService.
    4. Configuración de pruebas para confirmar el grupo de aplicaciones identidad pasa la autenticación y autorización se comprueba.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.
  3. Seleccione Aceptar para guardar los cambios.Select OK to save your changes.

Paso 3: Crear una aplicación lógicaStep 3: Create a logic app

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

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

  3. Agregar el BizTalk Server - preparar mensaje desde JSON acción.Add the BizTalk Server - Prepare message from JSON action.

  4. Opcional: Seleccione conectarse mediante una puerta de enlace de datos localesy escriba lo siguiente:Optional: Select Connect via on-premise data gateway, and enter the following:

    PropertyProperty DescripciónDescription
    Dirección URL del servidor de BizTalkBizTalk Server URL Escriba el nombre de dominio completo (FQDN) de la administración de BizTalk en la dirección URL de la aplicación de 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 IIS.Enter the identity of the IIS application pool.
    ContraseñaPassword Escriba la contraseña del grupo de aplicaciones 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 obligatorio si:Remember, the data gateway is only required if:

    • Usa un servidor de BizTalk en el entorno localYou're using an on-premises BizTalk Server
    • Está usando una máquina virtual de Azure de BizTalk Server y la máquina virtual no se expone como un extremo 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. Configurar la acción.Configure the action. Para cuerpo, seleccione la salida del cuerpo HTTP.For Body, select the HTTP body output. Para esquema, seleccione el esquema que desea usar.For Schema, select the schema you want to use.

    Nota

    Este paso se supone que está familiarizado con los esquemas de BizTalk y sabe qué esquema deseado.This step assumes you are familiar with schemas in BizTalk, and know which schema you want. Si no está seguro, a continuación, implementar el ejemplo HelloWorld SDK, actualice sus artefactos para usar el adaptador de aplicación lógica y use su esquema y ejemplo de mensaje.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 el BizTalk Server: Enviar mensaje acción.Add a new step, and select the BizTalk Server - Send message action. Para ubicación de recepción, seleccione la dirección URL de la lista desplegable o escriba el nombre de dominio completo (FQDN) de la dirección URL de aplicación de ReceiveService IIS.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 deberá especificarse también en las propiedades de transporte de la ubicación de recepción como el 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).

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

  8. Guardar los cambios.Save your changes.

Cuando se guarda, el desencadenador de solicitud de HTTP crea automáticamente una dirección URL.When you save, the HTTP Request trigger automatically creates a URL. Copie esta dirección URL; necesitarla en paso 5: Enviar un mensaje.Copy this URL; you need it in Step 5: Send a message.

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

Nota

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

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

  1. En administración de BizTalk Server, expanda administración de BizTalk Server, expanda grupo de BizTalk, expanda aplicacionesy, a continuación, expanda la aplicación que desea Ejecute 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. Botón derecho, seleccione puertos de recepción, seleccione Newy seleccione puerto de recepción unidireccional.Right-select Receive Ports, select New, and select One-way Receive Port.

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

    UseUse this ParaTo do this
    NameName 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: Predeterminado:No Authentication: Default. Deshabilita la autenticación.Disables authentication.
    • Eliminar mensajes si hay errores de autenticación: Habilita la autenticación, pero a colocación de los mensajes no autenticados.Drop messages if authentication fails: Enables authentication but to drop unauthenticated messages.
    • Conservar mensajes si hay errores de 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 los mensajes que se produce un error de procesamiento de una aplicación de suscripción (por ejemplo, otro programación de orquestación o puerto de recepció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 cómo habilitar enrutamiento para mensajes de error 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óny seleccione New.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. Para el 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 el General pestaña, configure la dirección de punto de conexión para la aplicación lógica:In the General tab, configure the endpoint address for your logic app:

    UseUse this ParaTo do this
    Dirección (URI)Address (URI) Requerido.Required. Escriba la dirección URL de aplicación de BizTalk ReceiveService IIS (/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 Requerido.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 aparece 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 el enlace pestaña, configure las propiedades relacionadas con la codificación del enlace de WCF-WebHttp subyacente y cualquier tiempo de espera.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 ParaTo do this
    Tiempo de espera de abrirOpen timeout Escriba el intervalo de tiempo que tardará la operación de apertura del canal en completarse.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 Escriba el intervalo de tiempo que 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 usa una respuesta de solicitud de puerto de recepción, este valor especifica un intervalo de tiempo para la interacción en completarse, incluso si el cliente devuelve un mensaje grande.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 Escriba el intervalo de tiempo que tardará la operación de cierre de canal para completarse.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, de un mensaje incluyendo los encabezados, que se reciban 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á enlazado 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 Escriba el número de llamadas simultáneas a una instancia de servicio único.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 el seguridad pestaña, 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 ParaTo 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 mediante el 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 establecer la seguridad de Secure Sockets Layer (SSL) en Internet Information Services (IIS).To use this mode, you must set up Secure Sockets Layer (SSL) in Internet Information Services (IIS).
    • TransportCredentialOnly: Predeterminado:TransportCredentialOnly: Default.
    Tipos de credencial de transporte del clienteTransport client credential types Elija el tipo de credencial al utilizar 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ásico: Utiliza la autenticación básica para enviar los 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.
    • Resumen: Utiliza la autenticación implícita para enviar contraseñas como un 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 con la autenticación de los 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: Predeterminado:Ntlm: Default. Los clientes envía 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; prefiere Kerberos si hay un dominio.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 principal 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: Usa un certificado de cliente.Certificate: Uses a client certificate. La cadena de certificados de CA para los certificados X.509 de cliente deben instalarse en el almacén de certificados entidades emisoras raíz de confianza de este equipo para que los clientes puedan autenticarse a 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
    Usar inicio de sesión únicoUse Single Sign-On
  10. Opcional.Optional. En el mensajes , utilice el encabezados HTTP salientes propiedad para agregar los encabezados personalizados y usar las propiedades adicionales para ayudar con 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 ParaTo do this
    Encabezados HTTP salientesOutbound HTTP Headers Escriba los encabezados HTTP que se desean que aparezca 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 un error de enrutamiento.Disables the receive location if inbound processing fails due to a receive pipeline failure or a routing failure. 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 un error de enrutamiento.Suspends the request message if inbound processing fails due to a receive pipeline failure or a routing failure. Valor predeterminado es desactivado.Default is unchecked.
    Incluir detalle de excepción en erroresInclude exception detail in faults Cuando se produce un error, devuelve un error de SOAP para facilitar la depuración.When an error occurs, returns any SOAP faults to help debugging. Valor predeterminado es desactivado.Default is unchecked.

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

Paso 5: Enviar un mensajeStep 5: Send a message

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

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

  3. Seleccione POST como el verbo HTTP y ha establecido la Content-type encabezado para application/json.Select POST as the HTTP verb, and set the Content-type header to application/json. En el cuerpo, pegue el siguiente JSON:In the body, paste the following JSON:

    {“hello”:”world”}
    
  4. Se trata de una llamada unidireccional a BizTalk, el resultado debe ser un HTTP 202.Because this is a one-way call to BizTalk, the result should be an HTTP 202. Si usa el ejemplo HelloWorld SDK, vaya al 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.

Enviar mensajes a una aplicación lógicaSend messages to a logic app

Paso 1: Instalar al adaptador de Logic AppsStep 1: Install the Logic Apps adapter

El adaptador de Logic Apps es una descarga independiente y no se incluye con la instalación de BizTalk Server.The Logic Apps adapter is a separate download, and is not included with the BizTalk Server installation.

  1. Vaya a adaptador de Microsoft BizTalk Server para las aplicaciones lógicasy guardar.Go to Microsoft BizTalk Server Adapter for Logic Apps, and save.
  2. Abra el LogicAppAdapter.iso y ejecute el LogicApp Adapter.msi archivo para instalar.Open the LogicAppAdapter.iso, and run the LogicApp Adapter.msi file to install.
  3. Finalizar la instalación y reinicie el BizTalkServerApplication y BizTalkServerIsolatedHost las instancias de host.Finish the install, and restart the BizTalkServerApplication and BizTalkServerIsolatedHost host instances.

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

  • El adaptador de LogicApp se agrega a la administración de BizTalkThe LogicApp adapter is added to BizTalk Administration
  • El controlador de envío se crea y 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.
  • El C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter carpeta se crea e incluye dos servicios: Administración y ReceiveService.The C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter folder is created, and includes two services: Management and ReceiveService. Estos servicios no se usan para enviar mensajes a una aplicación lógica.These services are not used to send messages to a logic app.

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

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

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

  3. Agregar el Office 365 Outlook - enviar un correo electrónico acción.Add the Office 365 Outlook - Send an email action. Para el a de direcciones, escriba su dirección de Office 365.For the To address, enter your Office 365 address. Para el asunto, escriba Sending from BizTalk.For the Subject, enter Sending from BizTalk. Para cuerpo, elija el cuerpo de salida desde el se recibe cuando una solicitud HTTP desencadenador.For Body, choose the Body output from the When an HTTP request is received trigger.

  4. Es similar a la aplicación lógica:Your logic app looks similar to:

    LogicAppExample

  5. Copie la dirección URL de POST de HTTP que se crea automáticamente cuando se guarda la aplicación lógica; necesita 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 deba 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 3: Crear un puerto de envíoStep 3: Create a Send Port

Para que BizTalk Server enviar mensajes a una aplicación lógica, la aplicación lógica debe tener un Manual desencadenar, tales como Manual: cuando una solicitud HTTP se recibe.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 administración de BizTalk Server, expanda administración de BizTalk Server, expanda grupo de BizTalk, expanda aplicacionesy, a continuación, expanda la aplicación que desea Ejecute 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. Botón derecho, seleccione puertos de envío, seleccione Newy 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 del puerto de envío.Enter a Name for the send port. Por ejemplo, escriba LASendPort.For example, enter LASendPort.

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

  5. En el General pestaña, configure el URI de devolución de llamada de su desencadenador de aplicación lógica.In the General tab, configure the Callback URI of your logic app trigger. Hay dos formas de hacerlo:There are two ways to do this:

    Opción 1 : Pegue la URL de HTTP POST que copió en el paso anterior en el desencadenador (URI de devolución de llamada) propiedad.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 siguientes pasos:You can also copy the URI using the following steps:

    1. En el portal Azure, 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 el se recibe cuando una solicitud HTTP tarjeta y copie el 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 el desencadenador (URI de devolución de llamada) propiedad.In your send port, paste this URL in the Trigger (Callback URI) property.

      Sugerencia

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

      Opción 2 : Si no conoce el identificador URI de devolución de llamada para el desencadenador, seleccione configurare 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, utilice las listas desplegables para elegir su suscripción, grupo de recursos, aplicación lógica, y desencadenador.Then, use the drop-down lists to choose your Subscription, Resource Group, Logic App, and Trigger.

  6. Opcional.Optional. En el enlace pestaña, configure las propiedades relacionadas con la codificación del enlace de WCF-WebHttp subyacente y cualquier tiempo de espera.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 ParaTo do this
    Tiempo de espera de abrirOpen timeout Escriba el intervalo de tiempo que tardará la operación de apertura del canal en completarse.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 Escriba el intervalo de tiempo que 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 usa una respuesta de solicitud de puerto de recepción, este valor especifica un intervalo de tiempo para la interacción en completarse, incluso si el cliente devuelve un mensaje grande.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 Escriba el intervalo de tiempo que tardará la operación de cierre de canal para completarse.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, de un mensaje incluyendo los encabezados, que se reciban 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á enlazado 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 de lógica 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 el mensajes , utilice el encabezados HTTP salientes propiedad para agregar los 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 Aceptar para guardar la configuración.Select OK to save your configuration.

Administración de puertos de envío y grupos de puertos de envío se describen las propiedades de puerto de envío adicionales.Managing Send Ports and Send Port Groups describes the additional send port properties.

Paso 4: Enviar algunos mensajesStep 4: Send some messages

Puede crear un puerto de recepción y 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. Crear una ubicación de recepción y establecer las propiedades similares para:Create a receive location, and set the properties similar to:

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

    PropertyProperty OperadorOperator ValorValue
    BTS.ReceivePortNameBTS.ReceivePortName == FileSendPortFileSendPort
  4. Cree un archivo de texto (archivo.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 (archivo.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 en una aplicación lógica con la URI especificada.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 usa el conector de Office 365 Outlook, su a 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.

SiguienteNext

¿Cuáles son las aplicaciones lógicasWhat are Logic Apps

Crear una aplicación lógicaCreate a logic app

Uso de adaptadores de BizTalk ServerUsing adapters in BizTalk Server