Che cos'è l'adapter di Windows SharePoint Services?

L'adapter BizTalk Server per Windows SharePoint Services offre un'integrazione più stretta con Windows SharePoint Services e Microsoft Office InfoPath. Nell'argomento seguente vengono descritte le funzionalità e una panoramica del funzionamento dell'adapter di Windows SharePoint Services.

Funzionalità dell'adapter Windows SharePoint Services

L'elenco seguente descrive le funzionalità importanti dell'adapter Windows SharePoint Services:

• Possibilità di inviare messaggi XML e binari di BizTalk Server alle raccolte documenti di SharePoint.

• Integrazione con InfoPath: è possibile trasformare i messaggi XML bizTalk Server in uscita in modo che vengano aperti automaticamente in InfoPath quando vengono aperti dal sito di Windows SharePoint Services.

• Promozione delle proprietà per i messaggi che passano a Windows SharePoint Services. È possibile aggiornare fino a 16 colonne di SharePoint con i metadati di BizTalk Server relativi all'ID dell'istanza di orchestrazione, all'ID messaggio o ai valori estratti dal messaggio.

• Definizione del nome file in base al contenuto del messaggio e alle proprietà di BizTalk Server.

• 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 comunque in modo che venga creata una nuova voce di elenco e che i valori della colonna vengano recuperati dal messaggio.

• Possibilità di ricevere messaggi da qualsiasi vista di qualsiasi raccolta documenti e archiviarli in una raccolta documenti specificata usando il nome file specificato.

• Promozione delle proprietà dell'adapter Windows SharePoint Services in BizTalk Server: le informazioni sui file di Windows SharePoint Services sono rese disponibili in BizTalk Server come proprietà del contesto del messaggio. È possibile accedere alle proprietà del contesto del messaggio da pipeline, orchestrazioni, ecc. È possibile accedere alle colonne personalizzate di SharePoint tramite il documento WSS.InPropertiesXml.

• Supporto completo per le porte dinamiche: gli adattatori di trasmissione possono supportare l'associazione URI statica (definita dall'utente quando viene creata la porta di trasmissione) o l'associazione URI dinamica (definita dall'orchestrazione durante l'invio del messaggio). Tutte le informazioni di configurazione possono essere definite tramite proprietà del contesto del messaggio, ad esempio WSS. Nome file e WSS. ConfigTimeout, per porte di trasmissione dinamiche e porte di invio fisiche.

• Contatori delle prestazioni

Funzionamento dell'adapter Windows SharePoint Services

L'adapter BizTalk Server per Windows SharePoint Services è costituito da tre componenti principali:

• Servizio Web dell'adattatore di Windows SharePoint Services

• Adapter di ricezione di Windows SharePoint Services

• Adapter di trasmissione di Windows SharePoint Services

  Nel server Windows SharePoint Services il servizio Web (BTSharePointAdapterWS.asmx) viene installato per fornire 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 raccolta di SharePoint. L'adattatore di ricezione recupera i file dal servizio Web e l'adattatore di invio pubblica i file su di esso.

  La figura seguente illustra i componenti principali dell'adapter BizTalk Server per Windows SharePoint Services che forniscono queste funzionalità.

  

Ricezione di documenti da Windows SharePoint Services

L'adattatore di ricezione esegue l'interrogazione periodica delle visualizzazioni della raccolta documenti di Windows SharePoint Services. Chiama un metodo Web nel server Windows SharePoint Services che usa il modello a oggetti di Windows SharePoint Services per esplorare la raccolta, controllare i file e restituire i dati del file all'adattatore. L'adapter invia quindi i file a BizTalk Server MessageBox e chiama un altro metodo Web per eliminare o archiviare i file da Windows SharePoint Services. Per filtrare i file in una biblioteca di Windows SharePoint Services, l'adapter esegue il polling della biblioteca di Windows SharePoint Services tramite una visualizzazione di Windows SharePoint Services.

L'approccio centralizzato (polling) offre un modello di gestione semplice in cui la configurazione viene eseguita nel server BizTalk. Offre inoltre prestazioni migliori a causa del fatto che consente l'invio in batch dei messaggi.

Poiché il supporto per le transazioni a livello di piattaforma non è disponibile tra Windows SharePoint Services, i servizi Web e BizTalk Server, il meccanismo di check-out viene utilizzato per minimizzare gli errori associati alle condizioni di errore. In determinate condizioni (ovvero, i file vengono inviati correttamente nel database MessageBox di BizTalk Server ma non possono essere eliminati da Windows SharePoint Services), i file rimarranno estratti nel server Windows SharePoint Services anche se sono stati inviati a BizTalk Server. Gli errori verranno registrati nel registro eventi nel server BizTalk.

Invio di documenti a Windows SharePoint Services

L'adattatore invia documenti a Windows SharePoint Services chiamando un metodo Web nel server Windows SharePoint Services. L'adattatore specifica l'URL del sito di Windows SharePoint Services, l'URL della raccolta documenti o dell'elenco relativi al sito, il nome del file o dell'elemento di elenco e le proprietà promosse da associare al file.

È possibile impostare il nome del 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'adattatore può anche impostare i valori delle proprietà promosse nel file come valori di colonna. Come per i nomi dei file, i valori delle proprietà promosse possono essere fissi o derivati dai dati XML nel documento.

Importante

Le proprietà promosse nell'adattatore di Windows SharePoint Services sono entità diverse rispetto alle proprietà promosse in BizTalk Server o in Windows SharePoint Services.

Le proprietà promosse di Windows SharePoint Services vengono utilizzate per rendere visibili gli elementi XML durante la navigazione 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 per promuovere gli elementi chiave, rendendolo automatico. Questa funzionalità è disponibile in Windows SharePoint Services solo quando si usano raccolte moduli di InfoPath (raccolte documenti che archiviano moduli di InfoPath con lo stesso schema XSD e la stessa soluzione InfoPath).

La promozione delle proprietà dell'adattatore di Windows SharePoint Services consente all'utente di alzare di livello le proprietà in Windows SharePoint Services quando i documenti con schemi diversi vengono archiviati nella stessa raccolta documenti.

La promozione delle proprietà di BizTalk Server è un concetto simile, solo che le proprietà vengono rese visibili all'orchestrazione come proprietà del messaggio e non all'utente finale nell'interfaccia utente. Inoltre, BizTalk Server supporta un concetto di demozione delle proprietà quando i valori delle proprietà vengono nuovamente salvati nel documento.

Quando si usa l'adattatore Windows SharePoint Services con moduli di InfoPath e raccolte moduli (anziché raccolte documenti e XML arbitrari), non è necessario impostare le proprietà promosse tramite l'adapter di invio. Al contrario, il documento può essere modificato all'interno dell'orchestrazione (modificando direttamente il messaggio o indirettamente tramite proprietà che verranno abbassate di livello). I valori verranno promossi automaticamente 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 eseguito nel sito Web di Windows SharePoint Services e dal runtime dell'adapter eseguito nel server BizTalk all'interno del processo dell'istanza host di BizTalk Server. Il runtime dell'adapter richiama il servizio Web BTSharePointAdapterWS che deve disporre delle autorizzazioni per eseguire determinate attività all'interno di 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 creata come 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 di Windows dell'istanza host deve essere membro del gruppo Host abilitati per SharePoint . È responsabilità dell'amministratore aggiungere e rimuovere account da questo gruppo, oltre a rendere gli account dell'istanza host membri del ruolo Collaboratore di SharePoint.

Componente	Identità del processo	Autorizzazione
Servizio Web BTSharePointAdapterWS	Identità chiamante	Richiamare l'autorizzazione concessa al gruppo Host abilitati per SharePoint
Runtime dell'adapter	Identità dell'host BizTalk	Non disponibile
Modello a oggetti di Windows SharePoint Services	Non disponibile	Il gruppo Host abilitati per SharePoint deve essere membro del ruolo Collaboratore in SharePoint Services.

Il programma di installazione di BizTalk Server 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'adapter 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 SharePoint al ruolo Collaboratore Di Windows SharePoint Services.

Le autorizzazioni per i file, gli elenchi e le raccolte documenti di Windows SharePoint Services sono limitate usando la sicurezza di Windows SharePoint Services. I messaggi vengono inviati da Windows SharePoint Services direttamente in BizTalk Server. La comunicazione tra il runtime dell'adapter e il servizio Web viene eseguita tramite HTTP o HTTPS.

L'adattatore presuppone che il servizio Web BTSharePointAdapterWS usi lo stesso schema HTTP (HTTP o HTTPS) del sito di Windows SharePoint Services. Ciò significa che l'adattatore userà HTTPS per comunicare con il servizio Web BTSSharePointAdapterWS quando il sito di Windows SharePoint Services viene creato in un sito Web IIS sicuro oppure userà HTTP per comunicare con il servizio Web BTSharePointAdapterWS quando il sito di Windows SharePoint Services viene creato in un sito Web IIS senza un certificato server.

Vedere anche

Configurazione e distribuzione dell'adapter Windows SharePoint Services
Configurazione dell'adapter Windows SharePoint Services
Procedure dettagliate sull'adapter Windows SharePoint Services