Compartir a través de


API de BAM desde una expresión de orquestación (ejemplo de BizTalk Server)

En este ejemplo se muestra cómo:

  • Use la API de BAM desde una expresión de orquestación BizTalk Server.

  • Realizar el seguimiento de elementos repetitivos en un mensaje como instancias de actividad individuales.

  • Crear una relación entre los datos de BAM supervisados mediante un perfil de seguimiento y los datos de BAM supervisados mediante una API de BAM.

Ubicación del ejemplo

Puede encontrar este ejemplo en <Samples Path>\BAM\BamFromExpression.

En la siguiente tabla se enumeran los archivos de este ejemplo y se describe el propósito de cada uno de ellos.

Archivo Descripción
BamDefinition.xls Hoja de estilo de definición de BAM.
BamDefinition.xml Definición de BAM.
BamFromExpression.btproj Proyecto de archivo de seguimiento de Visual Studio.
BamFromExpression.sln Solución de Visual Studio.
Cleanup.bat Archivo por lotes que se usa para anular la implementación del ejemplo.
InputMessage.xml Mensaje de entrada.
Orchestration1.odx Orquestación.
PoSchema.xsd Esquema del pedido de compra.
PropertySchema.xsd Esquema de propiedad.
Setup.bat Archivo por lotes para compilar e implementar el ejemplo.
QueryBam.sql Script de SQL.

Creación del perfil de seguimiento

  1. Abra un símbolo del sistema como administrador y ejecute <la ruta de> acceso de ejemplos\BAM\BAMFromExpression\Setup.bat. Setup.bat inicializa la infraestructura de BAM para este ejemplo e implementa la actividad de BAM.

  2. En los programas>de Microsoft BizTalk Server, haga clic con el botón derecho en Editor de perfiles de seguimiento y ejecute como administrador.

  3. En el panel izquierdo de la ventana Editor de perfiles de seguimiento , haga clic aquí para importar una definición de actividad de BAM.

  4. En la sección Nombre de definición de actividad de BAM del cuadro de diálogo Importar definición de actividad de BAM , seleccione FromExpressionPo y, a continuación, haga clic en Aceptar.

  5. En el panel derecho de la ventana Editor de perfiles de seguimiento , haga clic aquí para seleccionar un origen de eventos.

  6. En la sección Nombre del ensamblado del cuadro de diálogo Seleccionar ensamblado primario del origen de eventos, seleccione Microsoft.Samples.BizTalk.BamFromExpression y, a continuación, haga clic en Siguiente.

  7. En la sección Nombre de orquestación del cuadro de diálogo Seleccionar orquestación , seleccione BamFromExpression.Orchestration1 y, a continuación, haga clic en Aceptar.

  8. Haga clic con el botón derecho en la forma Receive_1 y, a continuación, haga clic en Esquema de carga de mensaje.

  9. Expanda <Esquema>, PurchaseOrder, Expanda Desdey, a continuación, arrastre PoID en el panel derecho a ActivityID en el panel izquierdo.

  10. Arrastre los elementos siguientes del panel derecho y suéltelos en los nodos con nombre del panel izquierdo:

    De En
    Nombre De
    State State
    City City
    Teléfono Teléfono
    Total PoTotal
  11. Haga clic en el icono de carpeta con la flecha (botón con carpeta y flecha arriba) para mostrar la orquestación.

  12. Arrastre la forma Receive_1 en el panel derecho a Recibido en el panel izquierdo.

  13. Arrastre la forma Send_1 en el panel derecho para Enviar en el panel izquierdo.

  14. Guarde el perfil de seguimiento en <Samples Path>\BAM\BamFromExpression\ BamFromExpression.btt.

  15. En el menú Herramientas , haga clic en Aplicar perfil de seguimiento.

Compilación e inicialización de este ejemplo

Implemente el perfil de seguimiento BamFromExpression.btt. Consulte Cómo implementar perfiles de seguimiento con la Utilidad de administración de perfiles de seguimiento.

Ejecutar esta muestra

Copie la ruta de> acceso de ejemplos del archivo<\BamFromExpression\InputMessage.xml a <Samples Path>\BamFromExpression\Input.

En unos 10 segundos, el mensaje de salida aparecerá en <Samples Path>\BamFromExpression\Output.

Visualización de los datos de BAM

  1. Abra SQL Server Management Studio.

  2. En SQL Server Management Studio, expanda el servidor, bases de datos, BAMPrimaryImport y, a continuación, tablas.

  3. Haga clic con el botón derecho en dbo.bam_FromExpressionPo_Completed y, a continuación, haga clic en Abrir tabla. Si usa SQL Server, haga clic en Seleccionar las 1000 primeras filas.

    El contenido de la tabla bam_FromExpressionPo_Completed se muestra en el panel derecho. La fila con el identificador de actividad 123 representa el pedido de 345 USD incluido en el mensaje de entrada.

  4. Haga clic con el botón derecho en dbo.bam_FromExpressionPoItem_Completed y, a continuación, haga clic en Abrir tabla. Si usa SQL Server, haga clic en Seleccionar las 1000 primeras filas.

    El contenido de la tabla bam_FromExpressionPoItem_Completed se muestra en el panel derecho. Las dos filas, que tienen identificadores de actividad 123_0 y 123_1, representan los artículos en el pedido de compra: Flash MC y Decoder infrarrojo.

  5. Haga clic con el botón derecho en dbo.bam_FromExpressionPoItem_CompletedRelationships y, a continuación, haga clic en Abrir tabla. Si usa SQL Server, haga clic en Seleccionar las 1000 primeras filas.

    El contenido de la tabla bam_FromExpressionPoItem_CompletedRelationships se muestra en el panel derecho. Cada fila de la tabla representa una relación entre una actividad FromExpressionPoItem y una actividad FromExpressionPo. El valor de la columna ActivityID hace referencia al identificador de actividad de la actividad FromExpressionPoItem. El valor de la columna ReferenceData hace referencia al identificador de actividad de la actividad FromExpressionPo. En este caso, ambos registros indican que los artículos MC Flash y descodificador de infrarrojos están asociados con el pedido de 345 USD.

Volver a ejecutar el ejemplo

  1. Abra un símbolo del sistema como administrador y ejecute <la ruta> de acceso de ejemplos\BAM\BamFromExpression\Cleanup.bat para quitar el perfil de seguimiento y otra infraestructura de BAM.

  2. Ejecute <la ruta> de acceso de ejemplos\BAM\BamFromExpression\Setup.bat para compilar el ejemplo e implementarlo.

Consulte también

Supervisión de la actividad económica (carpeta de ejemplos de BizTalk Server)
Relaciones de actividades