Compartir a través de

Expresiones del adaptador de Windows SharePoint Services

  • Artículo

En este tema se describe el formato y el significado de las cadenas que se pueden especificar como valores para las propiedades Nombre de archivoProperty Source del adaptador de Windows SharePoint Services. También describe las propiedades de contexto relacionadas, WSS. Nombre de archivo y WSS. ConfigPropertiesXml. Estas expresiones permiten definir con facilidad el valor del nombre de archivo o el valor de columna de Windows SharePoint Services personalizado, basado en literales y valores extraídos del mensaje o del sistema de BizTalk.

Las expresiones pueden contener literales y macros. Los literales se mostrarán en el nombre de archivo exactamente como se escribieron. Las macros deben colocarse entre caracteres '%'. Un ejemplo de una macro es %MessageID% que en tiempo de ejecución se reemplazará por el GUID del mensaje.

Nota:

Cuando el carácter % se utiliza como un literal o en un elemento XPATH, se debe convertir en carácter de escape del modo siguiente: \%. Un solo carácter % se considerará un delimitador de macro, donde un \% se sustituirá, en tiempo de ejecución, con un solo carácter %. El carácter \ se debe convertir en carácter de escape del modo siguiente: \\.

Ejemplos de expresiones

Valor en tiempo de diseño Valor en tiempo de ejecución
XYZ XYZ
PurchaseOrder PurchaseOrder
%MessageID% 55B93F27-7455-4066-ABE1-B4EBE6839A1A
PurchaseOrder - %MessageID% PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A
Descuento \%10 Descuento %10
PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:ID% PurchaseOrder – 10001
PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:PartnerName%-%XPATH=//ns0:PurchaseOrder/ns0:ID% PurchaseOrder – Contoso-10001

Macros admitidas

Valor en tiempo de diseño Valor en tiempo de ejecución
%MessageID% Identificador del mensaje de BizTalk que constituye un GUID único.
%SendingOrchestrationID% Identificador de BizTalk de la instancia de orquestación en la que se originó el mensaje.
%SendingOrchestrationType% Nombre de tipo de la orquestación en la que se originó el mensaje.
%XPATH=<xpath>% Permite especificar un elemento XPATH para que se utilice para extraer el valor del mensaje. "<xpath>" debe reemplazarse por una expresión XPATH válida. Nota: El alias de espacio de nombres debe definirse fuera de la expresión en los "Alias de espacio de nombres" o WSS. Campo ConfigNamespaceAliases.
%Filename% Se reemplaza con el valor de nombre de archivo extraído de la propiedad de contexto del mensaje WSS.Filename. Los mensajes recibidos de SharePoint tienen el valor de la propiedad de contexto de mensaje WSS.Filename establecida en el nombre del archivo SharePoint. El valor devuelto se preprocesa utilizando Path.GetFilenameWithoutExtension. Nota: Esta macro no se puede usar en WSS.Config* propiedades de contexto (de orquestación).
%Extension% Se reemplaza con el valor de la extensión de archivo extraído de la propiedad de contexto del mensaje WSS.Filename. Los mensajes recibidos de SharePoint tienen el valor de la propiedad de contexto de mensaje WSS.Filename establecida en el nombre del archivo SharePoint. El valor devuelto se preprocesa utilizando Path.GetExtension. El valor devuelto no contendrá ".". Nota: Esta macro no se puede usar en WSS.Config* propiedades de contexto (de orquestación).

Toda expresión válida que admita la promoción de propiedades es un nombre de archivo de tiempo de diseño válido. El nombre de archivo de tiempo de diseño se ampliará en tiempo de ejecución a los nombres de archivo de Windows SharePoint Services. Este nombre de archivo de Windows SharePoint Services tiene algunas limitaciones adicionales que se describen del modo siguiente:

  • Los nombres de archivo válidos de Windows pueden contener cualquier carácter Unicode con la excepción de lo siguiente: / \ : * ? <> | " # { } % & caracteres ~ o tabulación y varios puntos.

  • El nombre de archivo no puede tener más de 256 caracteres y la longitud total de la dirección URL debe ser, a lo sumo, de 256 caracteres.

  • Si el nombre de archivo de Windows SharePoint Services expandido contiene caracteres no válidos, o si la dirección URL o el nombre de archivo expandido es demasiado largo, se registrará un error en el registro de eventos de la aplicación y el mensaje se suspenderá. El estado de mensaje y el error también estarán visibles en la página Concentrador de grupo mediante el seguimiento de instancias de servicios y eventos de mensajes.

Consulte también

Cómo configurar una ubicación de recepción de Windows SharePoint Services
Cómo configurar un controlador de envío de Windows SharePoint Services
Cómo configurar un puerto de envío de Windows SharePoint Services
Referencia de propiedades del adaptador de Windows SharePoint Services
Tipos de columna admitidos de Windows SharePoint Services