Condividi tramite

Espressioni dell'adapter Windows SharePoint Services

  • Articolo

In questo argomento vengono descritti il formato e il significato delle stringhe che è possibile specificare come valori per le proprietà Origine Nome fileproprietà dell'adattatore Windows SharePoint Services. Descrive anche le proprietà del contesto correlate, WSS. Nome file e WSS. ConfigPropertiesXml. Queste espressioni consentono di definire in modo semplice il valore del nome file oppure del valore personalizzato di una colonna di Windows SharePoint Services in base a valori letterali o valori estratti dal messaggio o dal sistema BizTalk.

Le espressioni possono contenere valori letterali e macro. I valori letterali vengono visualizzati nel nome del file così come sono stati digitati. Le macro devono essere racchiuse tra caratteri "%". Un esempio di macro è %MessageID% che in fase di esecuzione verrà sostituito con il GUID del messaggio.

Nota

Quando il carattere "%" viene utilizzato come valore letterale o all'interno di un XPATH, è necessario utilizzare la sequenza di escape "\%". Un singolo carattere "%" verrà considerato come delimitatore di una macro, mentre una sequenza "\%" verrà sostituita in fase di esecuzione con un singolo carattere "%". Per il carattere "\" è necessario utilizzare la sequenza di escape "\\".

Esempi di espressioni

Valore della fase di progettazione Valore in fase di esecuzione
XYZ XYZ
PurchaseOrder PurchaseOrder
%MessageID% 55B93F27-7455-4066-ABE1-B4EBE6839A1A
PurchaseOrder - %MessageID% PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A
Sconto 10\% Sconto 10%
PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:ID% PurchaseOrder – 10001
PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:PartnerName%-%XPATH=//ns0:PurchaseOrder/ns0:ID% PurchaseOrder – Contoso-10001

Macro supportate

Valore della fase di progettazione Valore in fase di esecuzione
%MessageID% ID del messaggio BizTalk che corrisponde a un GUID univoco.
%SendingOrchestrationID% ID BizTalk dell'istanza di orchestrazione in cui ha avuto origine il messaggio.
%SendingOrchestrationType% Nome del tipo dell'orchestrazione in cui ha avuto origine il messaggio.
%XPATH=<xpath>% Consente di specificare un XPATH da utilizzare per estrarre il valore dal messaggio. "<xpath>" deve essere sostituito con un'espressione XPATH valida. Nota: L'alias dello spazio dei nomi deve essere definito all'esterno dell'espressione in 'Alias dello spazio dei nomi' o WSS. Campo ConfigNamespaceAliases.
%Filename% Sostituito con il valore del nome file estratto dalla proprietà di contesto WSS.Filename del messaggio. Nei messaggi ricevuti da SharePoint, il valore della proprietà di contesto WSS.Filename è impostato sul nome del file di SharePoint. Il valore restituito viene pre-elaborato utilizzando Path.GetFilenameWithoutExtension. Nota: Questa macro non può essere utilizzata nelle proprietà del contesto WSS.Config* (dall'orchestrazione).
%Extension% Sostituito con il valore dell'estensione file estratto dalla proprietà di contesto WSS.Filename del messaggio. Nei messaggi ricevuti da SharePoint, il valore della proprietà di contesto WSS.Filename è impostato sul nome del file di SharePoint. Il valore restituito viene pre-elaborato utilizzando Path.GetExtension. Il valore restituito non conterrà ".". Nota: Questa macro non può essere utilizzata nelle proprietà del contesto WSS.Config* (dall'orchestrazione).

Una qualsiasi espressione valida supportata dalla promozione delle proprietà è, in fase di progettazione, un nome di file valido. Il nome del file utilizzato in fase di progettazione sarà espanso in fase di esecuzione in nomi di file di Windows SharePoint Services. Per il nome del file di Windows SharePoint Services sono previste alcune limitazioni aggiuntive descritte di seguito:

  • I nomi di file di Windows validi possono contenere caratteri Unicode ad eccezione dei seguenti: / \ : * ? <> | " # { } % & ~ o caratteri di tabulazioni e più punti.

  • Il nome file non può contenere più di 256 caratteri e l'URL intero non può contenere più di 256 caratteri.

  • Se il nome del file di Windows SharePoint Services espanso contiene caratteri non validi, o se il nome espanso del file o l'URL sono troppo lunghi, nel Registro eventi applicazioni verrà registrato un errore e il messaggio verrà sospeso. L'errore e lo stato del messaggio saranno inoltre visualizzati nella pagina Hub gruppo mediante la registrazione degli eventi dei messaggi e delle istanze dei servizi.

Vedere anche

Come configurare un indirizzo di ricezione Windows SharePoint Services
Come configurare un gestore di trasmissione di Windows SharePoint Services
Come configurare una porta di trasmissione Windows SharePoint Services
Informazioni di riferimento sulle proprietà dell'adapter Windows SharePoint Services
Tipi di colonna di Windows SharePoint Services supportati