Adaptador SB-MessagingSB-Messaging Adapter

Service Bus (SB-Messaging) se utiliza el adaptador para recibir y enviar de entidades de Service Bus como colas, temas y retransmisiones.The Service Bus (SB-Messaging) adapter is used to receive and send from Service Bus entities like Queues, Topics, and Relays. Puede usar el SB-Messaging adaptador para conectarse a sus instalaciones BizTalk ServerBizTalk Server en Azure.You can use the SB-Messaging adapter to connect your on-premises BizTalk ServerBizTalk Server to Azure.

A partir de BizTalk Server 2016BizTalk Server 2016 Feature Pack 2, se admite Premium de Service Bus.Starting with BizTalk Server 2016BizTalk Server 2016 Feature Pack 2, Service Bus Premium is supported. Al configurar un puerto de envío con este adaptador, puede enviar mensajes a los temas y colas con particiones.When configuring a send port using this adapter, you can send messages to partitioned queues and topics.

Autenticar con Service BusAuthenticating with Service Bus

Service Bus ofrece dos métodos de autenticación:Service Bus provides two methods to authenticate:

  • Access Control Service (ACS)Access Control Service (ACS)
  • Firma de acceso compartido (SAS)Shared Access Signature (SAS)

Se recomienda usar la firma de acceso compartido (SAS) para autenticar con Service Bus.We recommend using Shared Access Signature (SAS) to authenticate with Service Bus. El valor de clave de acceso compartido aparece en la portal Azure.The Shared Access Key value is listed in the Azure portal.

Cuando se crea un espacio de nombres de Service Bus, no se crea automáticamente el espacio de nombres de Access Control (ACS).When you create a Service Bus namespace, the Access Control (ACS) namespace is not automatically created. Para usar el Control de acceso, necesitará los valores de nombre del emisor y clave del emisor de este espacio de nombres.To use Access Control, you need the Issuer Name and Issuer Key values of this namespace. Estos valores están disponibles cuando se crea un nuevo espacio de nombres de ACS mediante Windows PowerShell.These values are available when you create a new ACS namespace using Windows PowerShell. Estos valores no se muestran en el portal de Azure.These values are not listed in the Azure portal.

Para usar ACS para la autenticación y obtener los valores de nombre del emisor y clave del emisor, los pasos generales son:To use ACS for authentication, and get the Issuer Name and Issuer Key values, the overall steps include:

  1. Instalar el cmdlets de Powershell de Azure.Install the Azure Powershell cmdlets.

  2. Agregue su cuenta de Azure: Add-AzureAccountAdd your Azure account: Add-AzureAccount

  3. Devolver el nombre de la suscripción: get-azuresubscriptionReturn your subscription name: get-azuresubscription

  4. Seleccione su suscripción: select-azuresubscription <name of your subscription>Select your subscription: select-azuresubscription <name of your subscription>

  5. Crear un nuevo espacio de nombres: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType MessagingCreate a new namespace: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Ejemplo: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType MessagingExample: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Cuando se crea el nuevo espacio de nombres de ACS (que puede tardar varios minutos), se muestran los valores IssuerName y IssuerKey en la cadena de conexión:When the new ACS namespace is created (which can take several minutes), the IssuerName and IssuerKey values are listed in the connection string:

    Name                  : biztalksbnamespace
    Region                : South Central US
    DefaultKey            : abcdefghijklmnopqrstuvwxyz
    Status                : Active
    CreatedAt             : 10/18/2016 9:36:30 PM
    AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
    ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
    ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
    NamespaceType         : Messaging
    

Consulte New-AzureSBNamespace para obtener instrucciones.See New-AzureSBNamespace for guidance.

Recibir mensajes de Service BusReceive messages from Service Bus

  1. En la consola de administración de BizTalk Server, expanda grupo de BizTalk, expanda aplicacionesy, a continuación, expanda la aplicación.In the BizTalk Server Administration console, expand BizTalk Group, expand Applications, and then expand your application.

  2. Haga clic en puertos de recepción, seleccione Newy seleccione unidireccional puerto de recepción.Right-click Receive Ports, select New, and select One-Way receive port.

  3. Asígnele un nombre y seleccione ubicaciones de recepción.Give it a name, and select Receive Locations.

  4. Seleccione New, asígnele una nombre.Select New, give it a Name. En el transporte sección, seleccione SB-Messaging desde el tipo lista desplegable y, a continuación, seleccione configurar.In the Transport section, select SB-Messaging from the Type drop-down list, and then select Configure.

  5. Configurar la General propiedades:Configure the General properties:

    UseUse this ParaTo do this
    Dirección URL de cola o suscripciónQueue or Subscription URL Especifique la dirección URL donde se implementa la cola de Service Bus.Specify the URL where the Service Bus queue is deployed. Normalmente, la dirección URL tiene el formato siguiente:Typically the URL is in the following format:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Tiempo de espera de abrirOpen Timeout Especifica un valor que indica el tiempo para la operación para completar de apertura de un canal de duración.Specifies a time span value that indicates the time for a channel open operation to complete.

    Valor predeterminado: 1 minuto.Default value: 1 minute
    Tiempo de espera de cierreClose Timeout Especifica un valor que indica el tiempo para completar operación de cierre de un canal de duración.Specifies a time span value that indicates the time for a channel close operation to complete.

    Valor predeterminado: 1 minuto.Default value: 1 minute
    Tiempo de espera de recepciónReceive timeout Especifica un valor que indica el tiempo para completar una operación de recepción de duración.Specifies a time span value that indicates the time for a receive operation to complete.

    Valor predeterminado: 10 minutosDefault value: 10 minutes
    Número de capturas previasPrefetch count Especifica el número de mensajes que recibe simultáneamente desde la cola de Service Bus o un tema.Specifies the number of messages that are received simultaneously from the Service Bus Queue or a topic. Captura previa permite que el cliente de cola o suscripción cargue más mensajes desde el servicio cuando realiza una operación de recepción.Prefetching enables the queue or subscription client to load additional messages from the service when it performs a receive operation. El cliente almacena estos mensajes en una caché local.The client stores these messages in a local cache. El tamaño de la memoria caché viene determinada por el valor de la propiedad de número de capturas previas que especifique aquí.The size of the cache is determined by the value for the Prefetch Count property you specify here.

    Para obtener más información, consulte la sección "Captura previa" en https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/For more information, refer to the section “Prefetching” at https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Valor predeterminado: -1Default value: -1
    Usar sesiónUse Session Active esta casilla para utilizar una sesión de Service Bus para recibir mensajes de una cola o una suscripción.Select this check box to use a Service Bus session to receive messages from a queue or a subscription.
  6. Configurar la autenticación propiedades:Configure the Authentication properties:

    UseUse this ParaTo do this
    Servicio de Control de accesoAccess Control Service Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes:Select this to use ACS for authentication and provide the following values:

    -Escriba el URI de STS de Access Control Service de Service Bus.- Enter the Service Bus Access Control Service STS URI. Normalmente, el URI tiene el formato siguiente:Typically the URI is in the following format:

    https://<namespace>-sb.accesscontrol.windows.net/

    -Escriba el nombre del emisor del espacio de nombres de Service Bus.- Enter the issuer name for the Service Bus namespace.

    -Escriba la clave del emisor del espacio de nombres de Service Bus.- Enter the issuer key for the Service Bus namespace.
    Firma de acceso compartido (nuevo a partir de BizTalk Server 2013 R2BizTalk Server 2013 R2)Shared Access Signature (new starting with BizTalk Server 2013 R2BizTalk Server 2013 R2) Seleccione esta opción para usar la firma de acceso compartido (SAS) para la autenticación y proporcione el nombre de clave de SAS y el valor de clave.Select this to use Shared Access Signature (SAS) for authentication, and provide the SAS key name and key value.
  7. En el propiedades ficha la Namespace para propiedades de mensajes desacoplados, escriba el espacio de nombres que utiliza el adaptador para escribir las propiedades de mensaje negociado como propiedades de contexto de mensaje en el mensaje recibido por BizTalk ServerBizTalk Server.In the Properties tab, in the Namespace for Brokered Message Properties, enter the namespace that the adapter uses to write the brokered message properties as message context properties on the message received by BizTalk ServerBizTalk Server. Si desea promocionar las propiedades de mensaje negociado, seleccione el promocionar propiedades de mensajes desacoplados casilla de verificación.If you want to promote the brokered message properties, select the Promote Brokered Message Properties check box.

  8. Seleccione Aceptar.Select OK.

  9. Seleccione su controlador de recepcióny el canalización de recepción.Select your Receive handler, and the Receive pipeline. Seleccione Aceptar para guardar los cambios.Select OK to save your changes. Crear una ubicación de recepción proporciona alguna orientación.Create a Receive Location provides some guidance.

Enviar mensajes a Service BusSend messages to Service Bus

  1. En la consola de administración de BizTalk Server, haga clic en puertos de envío, seleccione Newy seleccione puerto de envío unidireccional estático.In the BizTalk Server Administration console, right-click Send Ports, select New, and select Static One-way send port.

    Crear un puerto de envío proporciona alguna orientación.Create a Send Port provides some guidance.

  2. Escriba un nombre.Enter a Name. En transporte, establezca el tipo a SB-Messagingy seleccione configurar.In Transport, set the Type to SB-Messaging, and select Configure.

  3. Configurar la General propiedades:Configure the General properties:

    UseUse this ParaTo do this
    Dirección URL de destinoDestination URL Escriba la dirección URL donde se implementa la cola de Service Bus.Enter the URL where the Service Bus queue is deployed. Normalmente, la dirección URL tiene el formato siguiente:Typically the URL is in the following format:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Intervalo de vaciado de loteBatch Flush Interval Especifica un intervalo de tiempo el valor que indica el intervalo cuando los lotes de mensajes que se envían a una cola o un tema se vacían.Specifies a time span value that indicates the interval when the message batches being sent to a Queue or a Topic are flushed. El valor predeterminado es 20 milisegundos.The default value is 20 milliseconds.

    Para obtener más información sobre el procesamiento por lotes con respecto a los temas y colas de Service Bus, consulte el procesamiento por lotes del lado cliente sección en https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements .For more information about batching with respect to Service Bus Queues and Topics, see the Client-side batching section at https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
    Tiempo de espera de abrirOpen Timeout Especifica un valor que indica el tiempo para la operación para completar de apertura de un canal de duración.Specifies a time span value that indicates the time for a channel open operation to complete.

    Valor predeterminado: 1 minuto.Default value: 1 minute
    Tiempo de espera de envíoSend Timeout Especifica un valor que indica el tiempo para completar una operación de envío de duración.Specifies a time span value that indicates the time for a send operation to complete.

    Valor predeterminado: 1 minuto.Default value: 1 minute
    Tiempo de espera de cierreClose Timeout Especifica un valor que indica el tiempo para completar operación de cierre de un canal de duración.Specifies a time span value that indicates the time for a channel close operation to complete.

    Valor predeterminado: 1 minuto.Default value: 1 minute
  4. Configurar la autenticación propiedades:Configure the Authentication properties:

    UseUse this ParaTo do this
    Servicio de Control de accesoAccess Control Service Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes:Select this to use ACS for authentication and provide the following values:

    -Escriba el URI de STS de Access Control Service de Service Bus.- Enter the Service Bus Access Control Service STS URI. Normalmente, el URI tiene el formato siguiente:Typically the URI is in the following format:

    https://<namespace>-sb.accesscontrol.windows.net/

    -Escriba el nombre del emisor del espacio de nombres de Service Bus.- Enter the issuer name for the Service Bus namespace.

    -Escriba la clave del emisor del espacio de nombres de Service Bus.- Enter the issuer key for the Service Bus namespace.
    Firma de acceso compartido (nuevo a partir de BizTalk Server 2013 R2BizTalk Server 2013 R2)Shared Access Signature (new starting with BizTalk Server 2013 R2BizTalk Server 2013 R2) Seleccione esta opción para usar la firma de acceso compartido (SAS) para la autenticación y proporcione el nombre de clave de SAS y el valor de clave.Select this to use Shared Access Signature (SAS) for authentication, and provide the SAS key name and key value.
  5. En el propiedades , escriba el Namespace para el usuario define propiedades de mensajes desacoplados que contiene las propiedades de contexto de mensaje de BizTalk que se desean escribir en el mensaje saliente a Bus de servicio.In the Properties tab, enter the Namespace for the user defined Brokered Message Properties that contains the BizTalk message context properties that you want to write on the outgoing message to Service Bus. Todas las propiedades de espacio de nombres se escriben en el mensaje como propiedades de mensajes desacoplados definidas por el usuario.All the namespace properties are written to the message as user-defined Brokered Message properties. El adaptador ignora el espacio de nombres al escribir las propiedades como propiedades de mensajes desacoplados.The adapter ignores the namespace while writing the properties as Brokered Message properties. El espacio de nombres utiliza sólo para determinar qué propiedades escribir.It uses the namespace only to ascertain what properties to write.

    También puede especificar los valores de las propiedades BrokeredMessage.You can also enter the values for the BrokeredMessage properties. Estas propiedades se describen en propiedades BrokeredMessage, incluido el clave de partición.These properties are described at BrokeredMessage Properties, including the Partition Key.

  6. Seleccione Aceptar para guardar los cambios.Select OK to save your changes.

Vea tambiénSee also

Uso de adaptadoresUsing adapters