Informazioni sull'adapter Windows SharePoint Services
L'adattatore BizTalk Server per Windows SharePoint Services offre un'integrazione più stretta con Windows SharePoint Services e Microsoft Office InfoPath. Nell'argomento seguente vengono illustrati il funzionamento e le funzionalità dell'adapter Windows SharePoint Services.
Funzionalità dell'adapter Windows SharePoint Services
Nell'elenco seguente vengono descritte importanti funzionalità dell'adapter Windows SharePoint Services:
Possibilità di inviare messaggi binari e XML di BizTalk Server a raccolte documenti di SharePoint.
Integrazione con InfoPath: è possibile trasformare i messaggi XML in uscita BizTalk Server per aprirli automaticamente in InfoPath quando si apre dal sito di Windows SharePoint Services.
Promozione proprietà per i messaggi trasmessi a Windows SharePoint Services. È possibile aggiornare fino a 16 colonne di SharePoint con i metadati di BizTalk Server sull'ID istanza di orchestrazione di tipo messaggio, sull'ID messaggio o sui valori estratti dal messaggio.
Definizione di nome file basata sul contenuto del messaggio e sulle proprietà di BizTalk Server.
La possibilità di inviare documenti a un elenco arbitrario (anziché a una raccolta documenti): in questo caso il documento stesso non viene archiviato in Windows SharePoint Services ma la promozione delle proprietà avviene ancora in modo che venga creata una nuova voce di elenco e i valori di colonna vengano recuperati dal messaggio.
Possibilità di ricevere messaggi da qualsiasi visualizzazione di qualsiasi raccolta documenti e di archiviarli in una raccolta documenti specificata con il nome file specificato.
Promozione delle proprietà dell'adattatore Windows SharePoint Services in BizTalk Server: le informazioni sui file Windows SharePoint Services sono rese disponibili in BizTalk Server come proprietà del contesto del messaggio. Le proprietà di contesto dei messaggi sono accessibili da pipeline, orchestrazioni e così via. Le colonne di SharePoint personalizzate sono accessibili tramite il documento WSS.InPropertiesXml.
Supporto completo per le porte dinamiche: gli adattatori di invio possono supportare l'associazione URI statica (definita dall'utente quando viene creata la porta di invio) o l'associazione URI dinamica (definita dall'orchestrazione durante l'invio del messaggio). Tutte le informazioni sulla configurazione possono essere definite tramite le proprietà di contesto dei messaggi, quali WSS.Filename e WSS.ConfigTimeout, per le porte di trasmissione dinamiche oltre che per le porte di trasmissione fisiche.
Contatori delle prestazioni
Funzionamento dell'adapter Windows SharePoint Services
L'adattatore BizTalk Server per Windows SharePoint Services è costituito da tre componenti principali:
Servizio Web Adapter Windows SharePoint Services
Adapter di ricezione Windows SharePoint Services
Adapter di trasmissione Windows SharePoint Services
Nel server Windows SharePoint Services, il servizio Web (BTSharePointAdapterWS.asmx) viene installato per consentire l'accesso alle raccolte e agli elenchi di Windows SharePoint Services. Il servizio Web espone i metodi per ottenere, inserire, eliminare e archiviare documenti da una libreria di SharePoint. L'adapter di ricezione recupera i file dal servizio Web e l'adapter di trasmissione li inserisce.
Nella figura seguente vengono illustrati i componenti principali dell'adattatore BizTalk Server per Windows SharePoint Services che forniscono queste funzionalità.
Ricezione di documenti da Windows SharePoint Services
L'adapter di ricezione esegue il polling delle visualizzazioni di raccolte documenti di Windows SharePoint Services. Chiama un metodo Web sul server Windows SharePoint Services che utilizza il modello a oggetti di Windows SharePoint Services per esplorare la raccolta, estrarre i file e restituire i dati dei file all'adapter. L'adapter invia quindi i file al MessageBox di BizTalk Server e chiama un altro metodo Web per eliminare o archiviare i file da Windows SharePoint Services. Per filtrare i file in una raccolta di Windows SharePoint Services, l'adapter esegue il polling della raccolta di Windows SharePoint Services tramite una visualizzazione di Windows SharePoint Services.
L'approccio centralizzato (polling) offre un semplice modello di gestione in cui la configurazione viene eseguita sul server BizTalk Server. Consente inoltre di ottenere prestazioni migliori grazie alla funzionalità di invio in batch dei messaggi.
Poiché il supporto per le transazioni a livello di piattaforma non è disponibile in Windows SharePoint Services, nei servizi Web e in BizTalk Server, per ridurre al minimo gli errori associati alle condizioni con esito negativo viene utilizzato il meccanismo di estrazione. In determinate condizioni, ovvero quando i file vengono inviati al database MessageBox di BizTalk Server, ma non possono essere eliminati da Windows SharePoint Services, i file rimangono estratti sul server Windows SharePoint Services anche se sono stati inviati a BizTalk Server. Gli errori verranno registrati nel registro eventi del server BizTalk Server.
Invio di documenti a Windows SharePoint Services
L'adapter invia documenti a Windows SharePoint Services chiamando un metodo Web sul server Windows SharePoint Services. L'adapter specifica l'URL del sito di Windows SharePoint Services, la raccolta documenti o l'URL dell'elenco relativo al nome del sito, del file o della voce dell'elenco e le proprietà alzate di livello da associare al file.
È possibile impostare il nome file su una stringa fissa o su un nome derivato dai dati XML nel documento. La derivazione del nome può essere molto utile per applicare le convenzioni di denominazione standard. L'adapter può inoltre impostare i valori delle proprietà alzate di livello nel file come valori di colonna. Come i nomi file, le proprietà alzate di livello possono essere fisse o derivate dai dati XML nel documento.
Importante
Le proprietà alzate di livello nell'adapter Windows SharePoint Services sono entità diverse dalle proprietà alzate di livello in BizTalk Server o in Windows SharePoint Services.
Le proprietà alzate di livello di Windows SharePoint Services vengono utilizzate per rendere visibili gli elementi XML durante l'esplorazione di una raccolta moduli di Windows SharePoint Services. Quando un modulo di InfoPath viene pubblicato in una raccolta moduli di Windows SharePoint Services, InfoPath configura la raccolta moduli in modo che gli elementi chiave vengano automaticamente alzati di livello. Questa funzionalità è disponibile in Windows SharePoint Services solo quando si utilizzano le raccolte moduli di InfoPath, ovvero le raccolte documenti in cui vengono archiviati i moduli di InfoPath con lo stesso schema XSD e la stessa soluzione InfoPath.
La promozione proprietà dell'adapter Windows SharePoint Services consente all'utente di alzare di livello le proprietà in Windows SharePoint Services quando documenti con schemi diversi vengono archiviati nella stessa raccolta documenti.
La promozione proprietà di BizTalk Server è un concetto analogo, con la sola differenza che le proprietà sono rese visibili all'orchestrazione come proprietà nel messaggio e non all'utente finale nell'interfaccia utente. BizTalk Server supporta inoltre un concetto di abbassamento di livello delle proprietà quando i valori delle proprietà vengono nuovamente salvati nel documento.
Quando si utilizza l'adapter Windows SharePoint Services con i moduli e le raccolte moduli di InfoPath, anziché con raccolte documenti e XML arbitrarie, non è necessario impostare le proprietà alzate di livello tramite l'adapter di trasmissione. Il documento può invece essere modificato all'interno dell'orchestrazione, direttamente modificando il messaggio o indirettamente tramite le proprietà che verranno abbassate di livello. I valori verranno automaticamente alzati di livello da Windows SharePoint Services.
Considerazioni sulla sicurezza per l'adapter Windows SharePoint Services
L'adapter Windows SharePoint Services è costituito da sottosistemi, dal servizio Web BTSharePointAdapterWS che viene eseguito sul sito Web di Windows SharePoint Services e dal runtime dell'adapter che viene eseguito sul server BizTalk Server durante il processo relativo all'istanza dell'host BizTalk Server. Il runtime dell'adapter richiama il servizio Web BTSharePointAdapterWS che deve disporre delle autorizzazioni per eseguire determinate attività in Windows SharePoint Services. Poiché questo componente viene eseguito come chiamante, è necessario concedere le autorizzazioni al chiamante. Ciò significa che l'istanza host BizTalk deve essere effettuata da Collaboratore nel sito di SharePoint per poter inviare e ricevere messaggi da tale sito. Il servizio Web BTSharePointAdapterWS può essere richiamato solo dai membri del gruppo Host abilitati per SharePoint . Per consentire a un'istanza host BizTalk di eseguire il runtime dell'adapter, di interagire con il servizio Web, l'account Windows dell'istanza host deve essere membro del gruppo Host abilitati per SharePoint . È responsabilità dell'amministratore aggiungere e rimuovere account da questo gruppo, nonché per rendere i membri degli account dell'istanza host del ruolo Collaboratore sharePoint.
| Componente | Identità del processo | Autorizzazione |
|---|---|---|
| Servizio Web BTSharePointAdapterWS | Identità del chiamante | Richiamare l'autorizzazione concessa al gruppo Host abilitati per SharePoint |
| Runtime dell'adapter | Identità dell'host BizTalk | N/D |
| Modello a oggetti di Windows SharePoint Services | N/D | Il gruppo Host abilitati per SharePoint deve essere membro del ruolo Collaboratore in SharePoint Services. |
BizTalk Server Setup configura le autorizzazioni per il servizio Web BTSharePointAdapterWS in modo che solo gli account membri del gruppo Host abilitati per SharePoint possano accedere a questo servizio Web. Se si desidera che gli host eseguano l'adattatore Windows SharePoint Services, l'amministratore dovrà aggiungere il gruppo NT associato a tale host al gruppo Host abilitati per SharePoint e aggiungere anche il gruppo Host abilitati per SharePointal ruolo collaboratore Windows SharePoint Services.
Le autorizzazioni per i file, gli elenchi e le raccolte documenti di Windows SharePoint Services sono limitate dalla sicurezza di Windows SharePoint Services. I messaggi vengono inviati direttamente a BizTalk Server da Windows SharePoint Services. La comunicazione tra il runtime dell'adapter e il servizio Web viene stabilita tramite HTTP o HTTPS.
L'adapter presume che il servizio Web BTSharePointAdapterWS utilizzi lo stesso schema HTTP (HTTP o HTTPS) del sito Windows SharePoint Services. L'adapter utilizzerà pertanto HTTPS per comunicare con il servizio Web BTSSharePointAdapterWS quando il sito di Windows SharePoint Services viene creato su un sito Web IIS sicuro. Utilizzerà invece HTTP per comunicare con il servizio Web BTSharePointAdapterWS quando il sito di Windows SharePoint Services viene creato su un sito Web IIS senza certificati server.
Vedere anche
Impostazione e distribuzione dell'adapter Windows SharePoint Services
Configurazione dell'adapter Windows SharePoint Services
Procedure dettagliate relative all'adapter Windows SharePoint Services