Proprietà di configurazione dell'adapter Windows SharePoint Services
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione di un adapter Windows Sharepoint Services:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| SiteUrl | VT_BSTR | Specificare l'URL completo del sito Web Windows SharePoint Services. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
| WssLocation | VT_BSTR | Specificare l'URL della raccolta documenti di Windows SharePoint Services, relativi al sito SharePoint, da cui vengono recuperati i documenti, | Non è possibile ricevere messaggi da un elenco o una cartella SharePoint. | Talvolta la raccolta documenti SharePoint è diversa dal nome dell'elemento. Per scoprire l'URL corretto, controllare la barra degli indirizzi di Internet Explorer. |
| Nome visualizzazione | VT_BSTR | Specificare la visualizzazione di Windows SharePoint Services utilizzata per filtrare i documenti elaborati dall'adapter. | Nessuno | Tutti i messaggi di una visualizzazione non strutturata verranno elaborati. |
| ArchiveLocation | VT_BSTR | Specificare l'URL della cartella di Windows SharePoint Services, relativo al sito SharePoint, in cui vengono archiviati i file elaborati. | Nessuno | Talvolta l'URL della raccolta documenti o della cartella di SharePoint è diverso dal nome dell'elemento. Per scoprire l'URL corretto, controllare la barra degli indirizzi di Internet Explorer. |
| NamespaceAliases | VT_BSTR | Specificare un elenco separato da virgola o punti e virgola di definizioni degli alias degli spazi dei nomi. | Nessuno | Nessuno |
| ArchiveFileName | VT_BSTR | Specificare il nome file di Windows SharePoint Services del file archiviato. | Le macro "Il % SendingOrchestrationID" e "% SendingOrchestrationType" non sono supportate da questo campo. | Nessuno |
| Overwrite | VT_BSTR | Specificare se i file presenti nell'archivio devono essere sovrascritti o meno. | I valori validi sono: -Sì -No |
Il valore predefinito è no. |
| ErrorThreshold | VT_BSTR | Specificare il numero massimo di errori di polling consecutivi rilevati dall'adapter, raggiunto il quale l'indirizzo di ricezione viene disattivato. | I valori validi sono compresi tra 0 e 2147483647. | Impostare questa proprietà su 0 perché l'indirizzo di ricezione non venga mai disattivato. Il valore predefinito è 10. |
| PollingInterval | VT_BSTR | Specificare l'intervallo di tempo, in secondi, tra due query consecutive eseguite dall'adapter per verificare se sono disponibili nuovi messaggi da elaborare. | I valori validi sono compresi tra 1 e 2147483647. | Se si specifica un valore più basso migliorano la velocità effettiva e il tempo di risposta dell'adapter. Il valore predefinito è 60. |
| BatchSize | VT_BSTR | Specificare il numero massimo di documenti elaborati come batch dal servizio Web Adapter di messaggistica di Windows SharePoint Services. | I valori validi sono compresi tra 1 e 2147483647. | Un batch elaborato può contenere un numero di messaggi minore del numero specificato per le dimensioni del batch. Non può, invece, contenere un numero di messaggi maggiore. Il valore predefinito è 20. |
| OfficeIntegration | VT_BSTR | Specificare il livello di integrazione Office. | I valori validi sono: - facoltativo: tentare di rimuovere le istruzioni di elaborazione di InfoPath se possibile o di elaborare come non è possibile. - no : elaborare il documento "come è". - Sì : rimuovere le istruzioni di elaborazione di InfoPath o ignorare il messaggio in caso di errore. |
Il valore predefinito è facoltativo. |
| Timeout | VT_BSTR | Specificare il timeout, in millisecondi, per le chiamate del servizio Web di runtime dell'adapter al servizio Web Adapter Windows SharePoint Services. | I valori validi sono compresi tra 1000 e 2147483647. | Il valore predefinito è 100000. |
| AdapterWSPort | VT_BSTR | Specificare la porta HTTP del sito Web IIS in cui è installato il servizio Web Adapter Windows SharePoint Services. | Nessuno | Il valore predefinito è 80. |
| Uri | VT_BSTR | Specificare il percorso completo della raccolta documenti Windows SharePoint Services. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:
<CustomProps><AdapterConfig vt="8"><ReceiveLocation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><SiteUrl>http://BTS2006/sites/BASSite/</SiteUrl><WssLocation>Shared Docs</WssLocation><ViewName>Approved</ViewName><ArchiveLocation>Archive</ArchiveLocation><NamespaceAliases>po='http://POProcess/POrder'</NamespaceAliases><ArchiveFileName>PurchaseOrder0001.xml</ArchiveFileName><Overwrite>no</Overwrite><ErrorThreshold>10</ErrorThreshold><PollingInterval>60</PollingInterval><BatchSize>20</BatchSize><OfficeIntegration>optional</OfficeIntegration><Timeout>100000</Timeout><AdapterWSPort>80</AdapterWSPort><uri>wss://bts2006:80/sites/BASSite/Shared+Docs?ViewName=Approved</uri></ReceiveLocation></AdapterConfig></CustomProps>
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione di un adapter Windows Sharepoint Services:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| SiteUrl | VT_BSTR | Specificare l'URL completo del sito Web di Windows SharePoint Services | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
| WssLocation | VT_BSTR | Specificare l'URL della cartella di destinazione di Windows SharePoint Services, relativo al sito SharePoint. | Nessuno | In alcuni casi l'URL della raccolta documenti, dell'elenco o della cartella di SharePoint è diverso dal nome dell'elemento. Controllare la barra degli indirizzi in Internet Explorer per trovare l'URL corretto. |
| Overwrite | VT_BSTR | Specificare se sovrascrivere i file esistenti. | I valori validi sono: -No -Orchestrazione -Rinominare -Sì |
Il valore predefinito è no. |
| NamespaceAliases | VT_BSTR | Specificare un elenco separato da virgola o punti e virgola di definizioni degli alias degli spazi dei nomi. | Nessuno | Utilizzare questo campo per definire gli alias degli spazi dei nomi utilizzati dalle query XPATH inserite nei campi. Questa proprietà non esegue l'override della proprietà del contesto del messaggio WSS.ConfigNamespacesAliases definita dall'orchestrazione. I due valori, infatti, vengono uniti. |
| FileName | VT_BSTR | Specificare il nome file di Windows SharePoint Services. | Nessuno | Quando si inviano messaggi a un elenco, il valore specificato nella proprietà Nome file verrà ignorato e non verrà salvato in alcuna colonna di SharePoint. Gli elenchi di SharePoint non hanno una colonna Nome file. Aggiornare invece la colonna "Titolo" utilizzando una delle 16 colonne disponibili. |
| OfficeIntegration | VT_BSTR | Specificare di modificare il documento in modo che venga automaticamente aperto in un'applicazione Office come InfoPath o salvare il documento così com'è, se non viene rilevata alcuna soluzione InfoPath. | I valori validi sono: -No -Opzionale -Orchestrazione -Sì - Sìformlibrary |
Il valore predefinito è facoltativo. |
| TemplatesDocLib | VT_BSTR | Specificare il nome di una raccolta documenti di SharePoint in cui sono memorizzate le soluzioni InfoPath. | Questa proprietà deve contenere un valore se la proprietà TemplatesNamespaceCol contiene un valore. | La raccolta documenti deve avere almeno una colonna di SharePoint di tipo "Una riga di testo", compilata con lo spazio dei nomi e il nodo radice dei documenti XML che possono essere aperti con la soluzione InfoPath in questione o solo con il nodo radice. |
| TemplatesNamespaceCol | VT_BSTR | Specificare il nome della colonna di SharePoint Raccolta documenti fallback modelli in cui è memorizzato lo spazio dei nomi della soluzione InfoPath, | Questa proprietà deve contenere un valore se la proprietà TemplatesDocLib contiene un valore. Questo campo applica la distinzione tra maiuscole e minuscole. |
Nessuno |
| CustomTemplatesDocLib | VT_BSTR | Specificare il nome di una raccolta documenti di SharePoint in cui sono memorizzate le soluzioni InfoPath. | Questa proprietà deve contenere un valore se la proprietà CustomTemplatesNamespaceCol contiene un valore. Questo campo applica la distinzione tra maiuscole e minuscole. |
Nessuno |
| CustomTemplatesNamespaceCol | VT_BSTR | Specificare il nome della colonna di SharePoint Raccolta documenti modelli in cui è memorizzato lo spazio dei nomi della soluzione InfoPath, | Questa proprietà deve contenere un valore se la proprietà CustomTemplatesDocLib contiene un valore. Questo campo applica la distinzione tra maiuscole e minuscole. |
Nessuno |
| PropertyName(n) | VT_BSTR | Specificare il nome della colonna di Windows SharePoint Services esistente nella raccolta documenti di destinazione. | Questo campo applica la distinzione tra maiuscole e minuscole. | È possibile specificare fino a 16 colonne. |
| PropertySource(n) | VT_BSTR | Specificare il valore di colonna da impostare per il messaggio. | Nessuno | È possibile specificare fino a 16 valori di colonna. |
| Timeout | VT_BSTR | Specificare il timeout, in millisecondi, per le chiamate del servizio Web di runtime dell'adapter al servizio Web Adapter Windows SharePoint Services. | I valori validi sono compresi tra 1000 e 2147483647. | Il valore predefinito è 100000. |
| AdapterWSPort | VT_BSTR | Specificare la porta HTTP del sito Web IIS in cui è installato il servizio Web Adapter Windows SharePoint Services. | Nessuno | Il valore predefinito è 80. |
| Uri | VT_BSTR | Specificare il percorso completo della cartella di destinazione di Windows SharePoint Services, relativo al sito SharePoint. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:
Nota
Le definizioni relative a PropertyName2 e PropertySource2 tramite PropertyName16 e PropertySource16 sono state omesse dalla stringa.
<CustomProps><AdapterConfig vt="8"><SendPort xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><SiteUrl>http://BizTalkServer/sites/BASSite/</SiteUrl><WssLocation>Shared Documents/Purchase Orders</WssLocation><Overwrite>yes</Overwrite><NamespaceAliases>po='http://OrderProcess/POrder'</NamespaceAliases><FileName>PurchaseOrder0001.xml</FileName><OfficeIntegration>yesformlibrary</OfficeIntegration><TemplatesDocLib>Templates</TemplatesDocLib><TemplatesNamespaceCol>NamespaceFallback</TemplatesNamespaceCol><CustomTemplatesDocLib>Shared Documents</CustomTemplatesDocLib><CustomTemplatesNamespaceCol>Namespace</CustomTemplatesNamespaceCol><PropertyName1>Column1</PropertyName1><PropertySource1>Column1 Value</PropertySource1><Timeout>100000</Timeout><AdapterWSPort>80</AdapterWSPort><uri>wss://biztalkserver:80/sites/BASSite/Shared%20Documents/Purchase%20Orders</uri></SendPort></AdapterConfig></CustomProps>
Nota
Quando si specificano i dati di configurazione TransportTypeData per una scheda compilata tramite Adapter Framework, le coppie nome/valore utilizzate devono essere tutte archiviate nell'elemento <AdapterConfig> . Poiché l'elemento <AdapterConfig> specifica il tipo di dati VT_BSTR (vt="8"), i <> caratteri nei dati devono essere preceduti da un carattere di escape.