Archivos de politicas para Pipeline Templates

Article
07/25/2006

Al crear templates para pipelines en BizTalk Server 2006 se utilizan archivos de politicas (policy files) para definir la forma de ejecucion de los componentes que se definiran es dichos pipelines. Los archivos de politicas definen la secuencia de los stages en el pipeline, tambien definen tanto el minimo y el maximo numero de componentes a ejecutar en un stage y el modo en que estos componentes deberan ser ejecutados; tanto en los pipelines de envio como en los de recepcion.

Cuando se prentende crear un archivo de politica es necesario cumplir el siguiente formato:

 <?xml version="1.0" encoding="utf-8"?>
<Document xmlns:xsd=https://www.w3.org/2001/XMLSchema 
xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance 
CategoryId = "F66B9F5E-43FF-4f5f-BA46-885348AE1B4E" FriendlyName = "Receive">
  <Stages>
    <Stage _locAttrData="Name" _locID="1" Name = "Decode" minOccurs = "0" 
maxOccurs = "-1" stageId = "9d0e4103-4cce-4536-83fa-4a5040674ad6" execMethod = "All"/>
    <Stage _locAttrData="Name" _locID="2" Name = "Disassemble" minOccurs = "0" 
maxOccurs="-1" stageId="9d0e4105-4cce-4536-83fa-4a5040674ad6" execMethod="FirstMatch"/>
    <Stage _locAttrData="Name" _locID="3" Name = "Validate" minOccurs = "0" 
maxOccurs="-1" stageId="9d0e410d-4cce-4536-83fa-4a5040674ad6" execMethod="All"/>
    <Stage _locAttrData="Name" _locID="4" Name = "ResolveParty" minOccurs = "0" 
maxOccurs="-1" stageId="9d0e410e-4cce-4536-83fa-4a5040674ad6" execMethod="All"/>
  </Stages>
</Document>

Los elementos y atributos mas relevantes de este formato se explican a continuacion:

Nodo / Atributo	Descripcion

/Document/\@CategoryId	Este atributo especifica que tipo de pipeline aplica la politica, si un Receive o un Send Pipeline. Dependiendo del tipo de Pipeline el valor es diferente: Send Pipeline: 8C6B051C-0FF5-4fc2-9AE5-5016CB726282 Receive Pipeline: F66B9F5E-43FF-4f5f-BA46-885348AE1B4E
/Document/\@FriendlyName	Este atributo estable un nombre amigable para el Pipeline en el momento de compilacion.
/Document/Stages	Tag que agrupa la especificacion para cada Stage que se puede implementar en el Pipeline.
/Document/Stages/Stage	Tag que especifica los atributos de configuracion de un Stage.
/Document/Stages/Stage/\@_locAttrData	Este atributo especifica el tag de localizacion.
/Document/Stages/Stage/\@_locID	Este atributo especifica el id de localizacion.
/Document/Stages/Stage/\@Name	Este atributo establece el nombre del Stage en el Pipeline Designer de Visual Studio.
/Document/Stages/Stage/\@minOccurs	Este atributo especifica el numero minimo de componentes que permite el editor en el Stage.
/Document/Stages/Stage/\@maxOccurs	Este atributo especifica el numero maximo de componentes que permite el editor en el Stage. Por defecto el valor es -1 que equivale a 255.
/Document/Stages/Stage/\@stageId	Este atributo especifica el tipo de Stage, por ejemplo: Pre-Assemble, Disassemble, etc. Dependiento del tipo de Stage el valor es diferente:Send Pipelines Pre-Assemble: 9d0e4101-4cce-4536-83fa-4a5040674ad6 Assemble: 9d0e4107-4cce-4536-83fa-4a5040674ad6 Encode: 9d0e4108-4cce-4536-83fa-4a5040674ad6Receive Pipelines Decode: 9d0e4103-4cce-4536-83fa-4a5040674ad6 Disassemble: 9d0e4105-4cce-4536-83fa-4a5040674ad6 Validate: 9d0e410d-4cce-4536-83fa-4a5040674ad6 ResolveParty: 9d0e410e-4cce-4536-83fa-4a5040674ad6
/Documet/Stages/Stage/\@execMethod	Este atributo especifica el modo de ejecucion de los componentes del Stage en el Pipeline. Solo existen 3 posible valores a especificar:None: no ejecuta ningun componente especificdo en el Stage. Si esta especificado y se adiciona un componente al Stage, en tiempo de compilacion presenta error.FirstMatch: ejecuta el primer componenteAll: ejecuta todos los componentes establecidos.

Para definir que politica utilizara un template, es necesario editar el atributo /Document/@PolicyFilePath definido en el archivo *.btp que representa el template y decir el archivo que tendra la politica del pipeline; luego el archivo de politica debe de ser almacenado en <BizTalk Server installation directory>\Developer Tools\Pipeline Policy Files.

Por defecto, en la carpeta de politicas de BizTalk Server existen dos archivos: BTSReceivePolicy.xml y BTSTransmitPolicy.xml, los cuales definen las politicas para los Receive Pipelines y Send Pipelines respectivamente. Se debe tener cuidado si se desea cambiar la configuracion de estos archivos, ya que representan los pipelines por defectos de BizTalk Server.

Para mas informacion acerca de pipelines, visitar Pipeline Templates

Autor: Carlos Medina

Este mensaje se proporciona "como está" sin garantías de ninguna clase, y no otorga ningún derecho

Archivos de politicas para Pipeline Templates

Additional resources