Come configurare porte di trasmissione utilizzando le proprietà di contesto di Windows SharePoint Services

In questo argomento viene descritto come configurare le porte di trasmissione di Windows SharePoint Services in fase di esecuzione utilizzando le proprietà di contesto di Windows Sharepoint Services da un'orchestrazione BizTalk. Lo stesso meccanismo può essere utilizzato per configurare porte di trasmissione dinamiche e con binding tardivo di Windows SharePoint Services. Le proprietà di configurazione per una porta di trasmissione dinamica vengono importate in un'orchestrazione in fase di esecuzione. Le proprietà dell'adattatore esposte nella finestra di dialogo Proprietà trasporto Windows SharePoint Services possono essere applicate anche a una porta di trasmissione dinamica o ad associazione tardiva. Per impostare le proprietà di configurazione di una porta di trasmissione dinamica o con binding tardivo utilizzando le proprietà di contesto dell'adapter Windows SharePoint Services, eseguire le operazioni seguenti:

Per impostare le proprietà di configurazione per una porta di trasmissione utilizzando le proprietà di contesto dell'adapter Windows SharePoint Services

1. Per le porte di trasmissione dinamiche, per creare una porta di trasmissione unidirezionale dinamica, seguire la procedura descritta nell'argomento Come creare una porta di trasmissione.

2. Utilizzare una forma Assegnazione messaggi all'interno di una forma Construct Message in un'orchestrazione per impostare le proprietà di configurazione per il messaggio in uscita. Per un esempio di come impostare le proprietà di configurazione per un messaggio in uscita, vedere Procedura dettagliata: Modulo 3 - Accesso alle proprietà di SharePoint da un'orchestrazione. La sezione Costruire un nuovo messaggio di questo argomento illustra come impostare le proprietà di configurazione di un messaggio in uscita. Le proprietà del contesto dell'adattatore correlate alle proprietà che è possibile impostare nella finestra di dialogo Proprietà trasporto Windows SharePoint Services sono elencate nella tabella seguente:

   Proprietà del trasporto	Proprietà di contesto dell'adapter	Tipo di dati	Commenti
   Porta servizio Web adapter	WSS.ConfigAdapterWSPort	Int	I valori validi sono compresi tra 1 e 65535 Il valore predefinito è 80.
   Timeout	WSS.ConfigTimeout	Int	I valori validi sono compresi tra 1000 e 2147483647. Il valore predefinito è 100000 Specificare un valore pari a 0 per indicare un timeout infinito.
   URL cartella di destinazione	ND	ND	Per le porte dinamiche, questa impostazione viene impostata indirettamente impostando la proprietà Microsoft.XLANGs.BaseTypes.Address della porta dinamica con una forma di espressione in un'orchestrazione. Per le porte con binding tardivo questa proprietà non può essere impostata in fase di esecuzione, poiché il valore della porta di trasmissione fisica ne esegue sempre l'override.
   Nome file	WSS.Filename	string	Supporta l'uso di tutte le macro nome file che possono essere utilizzate nelle proprietà di trasporto, ad eccezione delle macro %Filename% e %Extension%.
   Alias spazi dei nomi	WSS.ConfigNamespaceAliases	string	Se un alias dello spazio dei nomi impostato per un messaggio in fase di esecuzione corrisponde esattamente a quello impostato per la porta di trasmissione a cui viene instradato il messaggio, gli spazi dei nomi vengono uniti e si verifica un errore di routing. Per evitare questo problema, assicurarsi che gli alias degli spazi dei nomi specificati non siano identici. Se l'espressione seguente viene utilizzata, ad esempio, in un'orchestrazione per impostare l'alias dello spazio dei nomi per un messaggio: Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'"; e se questo messaggio viene indirizzato a una porta di trasmissione che specifica il valore seguente per la proprietà Alias dello spazio dei nomi : orchns='http://OrderProcess.PurchaseOrder' si verifica un errore quando in BizTalk Server viene eseguito il tentativo di instradare il messaggio a questa porta di trasmissione. Per risolvere questo problema, è possibile specificare il valore seguente per la proprietà Alias dello spazio dei nomi della porta di trasmissione: orchns2='http://OrderProcess.PurchaseOrder'
   Overwrite	WSS.ConfigOverwrite	string	I valori validi sono: - "Sì" - "no" - "rename"
   URL sito SharePoint	WSS.InListUrl	string	Per le porte dinamiche, questa impostazione viene impostata indirettamente impostando la proprietà Microsoft.XLANGs.BaseTypes.Address della porta dinamica con una forma di espressione in un'orchestrazione. Per le porte con binding tardivo questa proprietà non può essere impostata in fase di esecuzione, poiché il valore della porta di trasmissione fisica ne esegue sempre l'override.
   Integrazione Microsoft Office	WSS.ConfigOfficeIntegration	string	I valori validi sono: - "Sì" - "no" - "yesformlibrary" - "facoltativo"
   Raccolta documenti modelli	WSS.ConfigTemplatesDocLib	string	Nessuno
   Raccolta documenti fallback modelli	WSS.ConfigCustomTemplatesDocLib	string	Nessuno
   Colonna spazio dei nomi fallback modelli	WSS.ConfigCustomTemplatesNamespaceCol	string	Nessuno
   Colonna spazio dei nomi modelli	WSS.ConfigTemplatesNamespaceCol	string	Nessuno
   Colonna n	WSS.ConfigPropertiesXml Il nome della colonna è impostato nel <campo PropertyNamex>columnname</PropertyNamex> .	string	Nessuno
   Valore colonna n	WSS.ConfigPropertiesXml Il valore della colonna viene impostato nel <campo PropertySourcex>columnvalue</PropertySourcex> .	string	Supporta l'uso di tutte le macro nome file che possono essere utilizzate nelle proprietà di trasporto, ad eccezione delle macro %Filename% e %Extension%.

   Nota

   Per i valori forniti per queste proprietà di contesto è rilevante la distinzione tra maiuscole e minuscole. Quando si impostano i valori di configurazione per la porta dinamica con proprietà di contesto, è necessario verificare che venga applicata la distinzione tra maiuscole e minuscole. In caso contrario, si verificherà un errore quando BizTalk tenta di instradare il documento verso la porta di trasmissione designata.

3. Utilizzare una forma di espressione in un'orchestrazione per impostare la proprietà Microsoft.XLANGs.BaseTypes.Address per la porta di trasmissione dinamica. Questa proprietà viene utilizzata per specificare l'URI a cui la porta di trasmissione dinamica instrada il messaggio. Per un esempio di come impostare la proprietà Microsoft.XLANGs.BaseTypes.Address per una porta di trasmissione dinamica, vedere la sezione Creare un'espressione dell'argomento Procedura dettagliata: Modulo 3 - Accesso alle proprietà di SharePoint da un'orchestrazione. Per altre informazioni sulle proprietà del contesto dell'adattatore di Windows Sharepoint Services, vedere informazioni di riferimento sulle proprietà dell'adapter di Windows SharePoint Services.

   È inoltre possibile impostare in modo dinamico alcune proprietà di una porta di trasmissione con binding tardivo di Windows Sharepoint Services in un'orchestrazione. In tal caso, la porta di Windows SharePoint Services verrà configurata due volte, una volta tramite le proprietà di contesto di Windows SharePoint Services e un'altra volta tramite la finestra di dialogo Proprietà del trasporto Windows SharePoint Services. Per impostazione predefinita, la configurazione specificata nella finestra di dialogo Proprietà del trasporto Windows SharePoint Services ha la precedenza sulle proprietà di configurazione specificate nelle proprietà di contesto. Per utilizzare la configurazione specificata nelle proprietà di contesto, eseguire la procedura seguente:

   1. Per creare una porta di invio statica, seguire la procedura descritta nell'argomento Come creare una porta di invio.

   2. Quando si impostano le proprietà per la porta di invio, definire l'URI per la porta di invio immettendo i valori appropriati per le proprietà URL sito sharepoint e URL cartella di destinazione .

   3. Impostare il valore della proprietà Overwrite su Orchestration se si vuole usare il valore definito dalla proprietà di contesto WSS. ConfigOverwrite in un'orchestrazione.

   4. Impostare la proprietà Microsoft Office Integration su Orchestration se si vuole usare il valore definito dalla proprietà di contesto WSS. ConfigOfficeIntegration in un'orchestrazione.

   5. Immettere un valore di -1 per le proprietà della porta di invio che usano il tipo di dati integer se si desidera impostare tali valori con una proprietà di contesto in un'orchestrazione.

   6. Lasciare vuota qualsiasi proprietà della porta di trasmissione che utilizza dati di tipo stringa se si desidera impostare tali valori con una proprietà di contesto in un'orchestrazione. Questa operazione non si applica alle proprietà URL sito di Sharepoint e URL cartella di destinazione . Queste proprietà devono essere specificate nella finestra di dialogo Proprietà trasporto di Windows Sharepoint Services .

   7. Usare una forma Assegnazione messaggi all'interno di una forma Costrutto messaggio in un'orchestrazione per impostare le proprietà di configurazione per il messaggio in uscita. Per un esempio di come impostare le proprietà di configurazione per un messaggio in uscita, vedere Procedura dettagliata: Modulo 3 - Accesso alle proprietà di SharePoint da un'orchestrazione. La sezione Costrutti un nuovo messaggio di questo argomento illustra come impostare le proprietà di configurazione di un messaggio in uscita.

   8. Qualsiasi proprietà della porta di trasmissione configurata con un valore pari a -1 (per le proprietà che utilizzano dati di tipo Integer), "Orchestrazione" (per le proprietà di enumerazione nell'elenco a discesa) o lasciata vuota (per le proprietà che utilizzano dati di tipo stringa) verrà impostata in fase di esecuzione con la proprietà di contesto specificata nell'orchestrazione.

   Se si utilizza l'adapter Windows SharePoint Services per ricevere moduli di InfoPath con allegati incorporati e quindi si inviano i moduli di InfoPath a una raccolta di documenti SharePoint, eseguire la procedura seguente per mantenere le istruzioni di elaborazione di InfoPath eventualmente presenti nel modulo:

Per mantenere le istruzioni di elaborazione di InfoPath per i moduli di InfoPath con allegati incorporati elaborati da BizTalk Server

1. Se si usa una mappa nell'orchestrazione per eseguire il mapping dei dati da un modulo di InfoPath a un altro modulo di InfoPath, assicurarsi di aver impostato la proprietà Copy Processing Instructions (PIs) nella mappa su Sì. Questo parametro è impostato nella sezione Intestazione personalizzata della pagina Proprietà griglia per la mappa.

2. Se non si utilizza una mappa nell'orchestrazione, aggiornare il messaggio di output utilizzando l'espressione seguente in una forma Assegnazione messaggio:

   NewMessage(XMLNORM.ProcessingInstructionOption) = 1;  
   NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"  
   

   Nell'espressione precedente , NewMessage è il messaggio di output a cui si aggiungono le istruzioni di elaborazione.

Vedere anche

Come creare una porta di trasmissione