Cómo configurar puertos de envío mediante las propiedades de contexto de Windows SharePoint Services
En este tema se describe cómo configurar puertos de envío de Windows SharePoint Services en tiempo de ejecución mediante las propiedades de contexto de Windows Sharepoint Service en una orquestación de BizTalk. Se puede usar el mismo mecanismo para configurar los puertos de envío enlazados en tiempo de ejecución. Las propiedades de configuración para un puerto de envío dinámico se establecen en una orquestación en tiempo de ejecución. Las propiedades del adaptador que se exponen en el cuadro de diálogo Propiedades de transporte de Windows SharePoint Services también se pueden aplicar a un puerto de envío dinámico o enlazado en tiempo de ejecución. Para establecer las propiedades de configuración para un puerto de envío enlazado en tiempo de ejecución mediante las propiedades de contexto del adaptador de Windows Sharepoint Services, siga estos pasos:
Para establecer las propiedades de configuración para un puerto de envío mediante las propiedades de contexto del adaptador de Windows Sharepoint Services
Para los puertos de envío dinámicos, para crear un puerto de envío unidireccional dinámico, siga los pasos del tema Creación de un puerto de envío.
Use una forma de asignación de mensajes dentro de una forma Construir mensaje en una orquestación para establecer las propiedades de configuración del mensaje saliente. Para obtener un ejemplo de cómo establecer las propiedades de configuración de un mensaje saliente, vea Tutorial: Módulo 3: Obtener acceso a las propiedades de SharePoint desde una orquestación. En la sección Construir un nuevo mensaje de este tema se muestra cómo establecer las propiedades de configuración de un mensaje saliente. Las propiedades de contexto del adaptador que se correlacionan con las propiedades que se pueden establecer en el cuadro de diálogo Propiedades de transporte de Windows SharePoint Services se muestran en la tabla siguiente:
Transport (propiedad) Propiedad de contexto del adaptador Tipo de datos Comentarios Puerto del servicio Web del adaptador WSS.ConfigAdapterWSPort Int Los valores válidos son de 1 a 65535.
El valor predeterminado es 80.Tiempo de espera WSS.ConfigTimeout Int Los valores válidos son de 1000 a 2147483647.
El valor predeterminado es 100000
Especifique un valor de 0 para indicar un tiempo de espera infinito.Dirección URL de carpeta de destino N/D N/D Para los puertos dinámicos, esto se establece indirectamente estableciendo la propiedad Microsoft.XLANGs.BaseTypes.Address del puerto dinámico con una forma de expresión en una orquestación. En puertos enlazados en tiempo de ejecución, esta propiedad no se puede establecer en tiempo de ejecución puesto que siempre se reemplaza por el valor del puerto de envío físico. Filename WSS.Filename String Admite el uso de todas las macros de nombre de archivo que se pueden usar en las propiedades de transporte, excepto las macros %Filename% y %Extension% . Alias de espacios de nombres WSS.ConfigNamespaceAliases String Si un conjunto de alias de espacios de nombres para un mensaje en tiempo de ejecución coincide con el conjunto de alias de espacios de nombres para el puerto de envío al que se enruta el mensaje, los espacios de nombres se combinan y se produce un error de enrutamiento. Pare evitar este problema, asegúrese de que los alias de espacios de nombres no sean idénticos. Por ejemplo, si se usa la siguiente expresión en una orquestación para establecer el alias de espacios de nombres para un mensaje:
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";
y si este mensaje se enruta a un puerto de envío que especifica el siguiente valor para la propiedad Aliases de espacio de nombres:
orchns='http://OrderProcess.PurchaseOrder'
se producirá un error cuando BizTalk Server intente enrutar el mensaje en este puerto de envío. Para resolver este problema, puede especificar el siguiente valor para la propiedad Alias de espacio de nombres del puerto de envío:
orchns2='http://OrderProcess.PurchaseOrder'
Sobrescribir WSS.ConfigOverwrite String Los valores válidos son:
- "Sí"
- "no"
- "cambiar nombre"Dirección URL del sitio de SharePoint WSS.InListUrl String Para los puertos dinámicos, esto se establece indirectamente estableciendo la propiedad Microsoft.XLANGs.BaseTypes.Address del puerto dinámico con una forma de expresión en una orquestación. En puertos enlazados en tiempo de ejecución, esta propiedad no se puede establecer en tiempo de ejecución puesto que siempre se reemplaza por el valor del puerto de envío físico. Integración con Microsoft Office WSS.ConfigOfficeIntegration String Los valores válidos son:
- "Sí"
- "no"
- "yesformlibrary"
- "opcional"Biblioteca de documentos de plantillas WSS.ConfigTemplatesDocLib String None Biblioteca de documentos de reserva de plantillas WSS.ConfigCustomTemplatesDocLib String None Columna de espacio de nombres de reserva de plantillas WSS.ConfigCustomTemplatesNamespaceCol String None Columna de espacio de nombres de plantillas WSS.ConfigTemplatesNamespaceCol String None Columna n
WSS.ConfigPropertiesXml
El nombre de columna se establece en el <campo PropertyNamex>columnname</PropertyNamex> .String None Valor de columna n
WSS.ConfigPropertiesXml
El valor de columna se establece en <el campo PropertySourcex>columnvalue</PropertySourcex> .String Admite el uso de todas las macros de nombre de archivo que se pueden usar en las propiedades de transporte, excepto las macros %Filename% y %Extension% . Nota
Los valores para estas propiedades de contexto distinguen entre mayúsculas y minúsculas. Al establecer los valores de configuración para un puerto dinámico con propiedades de contexto, debe asegurarse de que se utilizan las mayúsculas y minúsculas del modo apropiado o, de lo contrario, se producirá un error cuando BizTalk intente enrutar el documento al puerto de envío designado.
Use una forma de expresión en una orquestación para establecer la propiedad Microsoft.XLANGs.BaseTypes.Address para el puerto de envío dinámico. Esta propiedad se usa para especificar el URI en el que el puerto de envío dinámico enruta el mensaje. Para obtener un ejemplo de cómo establecer la propiedad Microsoft.XLANGs.BaseTypes.Address para un puerto de envío dinámico, vea la sección Crear una expresión del tema Tutorial: Módulo 3: Obtener acceso a las propiedades de SharePoint desde una orquestación. Para obtener más información sobre las propiedades de contexto del adaptador de Windows Sharepoint Services, vea Windows SharePoint Services Referencia de propiedades del adaptador.
También es posible establecer de forma dinámica algunas propiedades de un puerto de envío enlazados en tiempo de ejecución de Windows Sharepoint Services en una orquestación. Si lo ha hecho, el puerto de Windows SharePoint Services se configurará dos veces, una a través de las propiedades de contexto de Windows SharePoint Services y otra mediante el cuadro de diálogo Propiedades de transporte Windows SharePoint Services. De forma predeterminada, el cuadro de diálogo Propiedades de transporte Windows SharePoint Services adquiere propiedad sobre las propiedades de configuración especificadas en las propiedades de contexto. Para usar la configuración especificada en las propiedades de contexto, siga estos pasos:
Para crear un puerto de envío unidireccional estático, siga los pasos del tema Creación de un puerto de envío.
Al establecer las propiedades del puerto de envío, defina el URI del puerto de envío escribiendo los valores adecuados para las propiedades URL del sitio de SharePoint y Dirección URL de carpeta de destino .
Establezca el valor de la propiedad Overwrite en Orchestration si desea usar el valor definido por la propiedad de contexto WSS. ConfigOverwrite en una orquestación.
Establezca la propiedad Integración de Microsoft Office en Orchestration si desea usar el valor definido por la propiedad de contexto WSS. ConfigOfficeIntegration en una orquestación.
Escriba un valor de -1 para las propiedades de puerto de envío que usen el tipo de datos entero si desea establecer esos valores con una propiedad de contexto en una orquestación.
Deje en blanco cualquier propiedad de puerto de envío que use el tipo de datos de cadena si desea establecer estos valores con una propiedad de contexto en una orquestación. Esto no se aplica a las propiedades URL del sitio de SharePoint y dirección URL de carpeta de destino . Estas propiedades deben especificarse en el cuadro de diálogo Propiedades de transporte de Windows Sharepoint Services .
Use una forma de asignación de mensajes dentro de una forma Construir mensaje en una orquestación para establecer las propiedades de configuración del mensaje saliente. Para obtener un ejemplo de cómo establecer las propiedades de configuración de un mensaje saliente, vea Tutorial: Módulo 3: Obtener acceso a las propiedades de SharePoint desde una orquestación. En la sección Construir un nuevo mensaje de este tema se muestra cómo establecer las propiedades de configuración de un mensaje saliente.
Las propiedades de puerto de envío que se configuran con un valor de -1 (para propiedades que usan el tipo de datos entero) "Orquestación" (para las propiedades de enumeración desplegables) o se han dejado en blanco (para propiedades que usan el tipo de datos de cadena) se establecerán en tiempo de ejecución con la propiedad de contexto que se especificó en la orquestación.
Si usa el adaptador de Windows SharePoint Services para recibir los formularios de InfoPath con datos adjuntos integrados y los envía a una biblioteca de documentos de SharePoint, complete los siguientes pasos para conservar las instrucciones de procesamiento de InfoPath que estén en el formulario:
Para conservar las instrucciones de procesamiento de InfoPath para los formularios de InfoPath con datos adjuntos integrados que procesa BizTalk Server
Si usa un mapa en la orquestación para asignar datos de un formulario de InfoPath a otro formulario de InfoPath, asegúrese de que ha establecido la propiedad Copy Processing Instructions (PIs) en el mapa en Sí. Este parámetro se establece en la sección Encabezado personalizado de la página Propiedades de cuadrícula del mapa.
Si no está usando una asignación en la orquestación, actualice el mensaje de salida mediante la siguiente expresión en una forma de asignación de mensaje:
NewMessage(XMLNORM.ProcessingInstructionOption) = 1; NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"
En la expresión anterior, NewMessage es el mensaje de salida al que va a agregar las instrucciones de procesamiento.