Procedura dettagliata: Modulo 1 - Invio e ricezione di messaggi con l'adapter Windows SharePoint Services

Questa procedura dettagliata illustra come configurare Windows SharePoint Services e BizTalk Server in modo da poter inviare e ricevere un messaggio usando l'adapter Windows SharePoint Services e il routing basato sul contenuto (CBR). Il routing basato sul contenuto elimina la necessità di utilizzare la sottoscrizione per messaggi associati in modo deterministico a porte specifiche. Offre inoltre una maggiore flessibilità agli utenti che desiderano instradare messaggi in base a proprietà della busta o semplicemente in base a proprietà di configurazione delle porte di ricezione. Per un'introduzione all'adattatore Windows SharePoint Services, vedere Informazioni sull'adapter Windows SharePoint Services.

Prerequisiti

Di seguito sono riportati i prerequisiti per l'esecuzione delle procedure illustrate in questo argomento:

• È necessario disporre di una distribuzione a server singolo con un'installazione completa di BizTalk Server in esecuzione in Windows Server 2008 SP2 o Windows Server 2008 R2.

  Per informazioni sull'uso dell'adattatore Windows SharePoint Services in una distribuzione multiserver, vedere Configurazione e distribuzione dell'adapter Windows SharePoint Services.

Configurare Windows SharePoint Services

In questa procedura verrà creato un sito Web principale di SharePoint contenente tre raccolte documenti. Queste raccolte vengono utilizzate dall'adapter Windows SharePoint Services per spostare un messaggio da una raccolta di origine a una di destinazione. Tale messaggio viene inoltre archiviato in una raccolta documenti. È necessario eseguire questa procedura per creare il sito di Windows SharePoint Services a cui accede l'adapter Windows SharePoint Services in questa procedura dettagliata e impostare i diritti utente per consentire l'accesso a tale sito.

Creare un sito di Windows SharePoint Services

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Strumenti di amministrazionee quindi fare clic su Amministrazione centrale SharePoint.

2. In Configurazione server virtuale fare clic su Crea un sito Web di primo livello.

3. In Elenco server virtuali selezionare il sito Web in cui è stato installato l'adapter Windows SharePoint Services. Ad esempio: Default Web Site.

4. Nella sezione Indirizzo sito Web digitare nel campo WSSAdapterWalkthroughNome URL .

5. Nella sezione Proprietario raccolta siti digitare un nome utente nel campo Nome utente. Questo utente sarà il proprietario del sito Web e non necessita di autorizzazioni speciali in BizTalk Server.

6. Nella sezione Proprietario raccolta siti digitare un indirizzo di posta elettronica nel campo Posta elettronica.

7. Fare clic su OK.

8. Nella pagina Sito di primo livello creato , fare clic sul nuovo sito Web di primo livello appena creato. Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

9. Selezionare il modello Sito del team dall'elenco dei modelli e quindi fare clic su OK. Verrà aperta la home page Sito Web del team.

Creare una raccolta documenti "Source"

1. Nella home page del sito Web team fare clic su Crea nella barra di spostamento superiore.

2. In Raccolte documenti fare clic su Raccolta documenti.

3. Nella sezione Nome e Descrizione digitare nel campoSourceNome .

4. Nella sezione Navigazione selezionare Sì per visualizzare questa raccolta moduli sulla barra di avvio rapido.

5. Nell'elenco a discesa Modello di documento della sezione Modello di documento selezionare None.

6. Fare clic su Crea. La raccolta documenti verrà creata e si verrà reindirizzati alla raccolta vuota.

Creare una raccolta documenti "Destination"

1. Nella home page del sito Web team fare clic su Crea nella barra di spostamento superiore.

2. In Raccolte documenti fare clic su Raccolta documenti.

3. Nella sezione Nome e Descrizione digitare nel campoDestination Nome .

4. Nella sezione Navigazione selezionare Sì per visualizzare questa raccolta moduli sulla barra di avvio rapido.

5. Nell'elenco a discesa Modello di documento della sezione Modello di documento selezionare None.

6. Fare clic su Crea. La raccolta documenti verrà creata e si verrà reindirizzati alla raccolta vuota.

Creare una raccolta documenti "Archive"

1. Nella home page del sito Web team fare clic su Crea nella barra di spostamento superiore.

2. In Raccolte documenti fare clic su Raccolta documenti.

3. Nella sezione Nome e Descrizione digitare nel campoArchive Nome .

4. Nella sezione Navigazione selezionare Sì per visualizzare questa raccolta moduli sulla barra di avvio rapido.

5. Nell'elenco a discesa Modello di documento della sezione Modello di documento selezionare None.

6. Fare clic su Crea. La raccolta documenti verrà creata e si verrà reindirizzati alla raccolta vuota.

7. Chiudere il WSSAdapterWalkthrough sito Web.

8. Chiudere il sito Web Amministrazione centrale SharePoint .

Configurare la funzionalità di sicurezza di Windows

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Strumenti di amministrazionee quindi fare clic su Gestione computer.

2. Nelll'albero della console espandere Utenti e gruppi locali e quindi fare clic su Gruppi.

3. Fare clic con il pulsante destro del mouse sul gruppo Host abilitati per SharePoint , scegliere Aggiungi al gruppo e quindi fare clic su Aggiungi.

4. Nella finestra di dialogo Seleziona utenti, computer o gruppi, in Immettere i nomi degli oggetti da selezionare digitare il nome dell'account configurato BizTalk Server Istanza host in cui eseguire e quindi fare clic su OK.

5. Nell'albero della console espandere Servizi e applicazioni, quindi fare clic su Servizi.

6. Fare clic con il pulsante destro del mouse su BizTalk Service BizTalk Group: <BizTalk_Host_Name>, quindi scegliere Riavvia.

   Nota

   <> BizTalk_Host_Name è il nome dell'host. Per impostazione predefinita, si tratta di BizTalkServerApplication.

   Nota

   L'appartenenza non verrà applicata finché non si riavvia il servizio.

7. Chiudere Gestione computer.

Configurare la sicurezza di SharePoint

1. Aprire un Web browser e passare all'URL del sito creato, Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

2. Nella home page del sito Web team fare clic su Impostazioni sito nella barra di spostamento superiore.

3. In Amministrazione fare clic su Gestisci utenti.

4. Fare clic su Aggiungi utenti.

5. Nel passaggio 1: scegliere Utenti digitare il nome dell'account in cui è in esecuzione l'istanza host BizTalk Server.

6. Nel passaggio 2: scegliere Gruppi di siti selezionare le caselle di controllo Lettore e Collaboratore .

7. Fare clic su Avanti.

8. Deselezionare la casella di controllo Invia il messaggio di posta elettronica seguente per consentire a questi utenti di essere stati aggiunti e quindi fare clic su Fine.

9. Chiudere il WSSAdapterWalkthrough sito Web.

Creare e configurare le porte BizTalk Server

In questa procedura verranno create e configurate le porte di ricezione BizTalk Server, le posizioni di ricezione e le porte di trasmissione per l'adattatore Windows SharePoint Services. Queste porte sono punti di ingresso e di uscita da BizTalk Server per i documenti ricevuti e inviati dall'adattatore Windows Sharepoint Services.

Creare la porta di ricezione

1. Fare clic su Start, Tutti i programmi, Microsoft BizTalk Server 20xx e quindi fare clic su amministrazione BizTalk Server.

2. Espandere BizTalk Server Amministrazione, espandere Gruppo BizTalk, applicazioni, espandere Applicazione BizTalk 1, fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovoe quindi fare clic su Porta di ricezione unidirezionale...

3. Nella finestra di dialogo Proprietà porta di ricezione digitare nel campo Nome in GeneraleFromSource.

4. Fare clic su OK.

Creare l'indirizzo di ricezione

1. Nella Console di amministrazione BizTalk fare clic con il pulsante destro del mouse sul nodo Percorsi di ricezione , scegliere Nuovo e quindi fare clic su Posizione di ricezione unidirezionale.

2. Nella finestra di dialogo Seleziona porta di ricezione selezionare FromSourcee quindi fare clic su OK.

3. Nella finestra di dialogo Proprietà posizione di ricezione digitare nel campo Nome in GeneraleSourceLocation.

4. Nell'elenco a discesa Tipo della sezione Trasporto selezionare Windows``SharePoint``Services.

5. Fare clic su Configura per configurare le proprietà dell'adattatore Windows SharePoint Services.

6. Nella proprietà Porta servizio Web Adapter digitare il numero di porta del server virtuale in cui è stato installato il servizio Web adapter Windows SharePoint Services. Per impostazione predefinita, è configurata la porta 80.

7. Digitare la proprietà Archive Location .Type Archive in The Archive Location property.

8. Digitare 10 la proprietà Intervallo di polling .

9. Digitare l'URL del sito di SharePoint nella proprietà Url sito oint di ShareP. Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

10. Digitare Source per la proprietà Raccolta documenti di origine .

11. Fare clic su OK.

12. Nella finestra di dialogo Proprietà percorso di ricezione selezionare BizTalkServerApplication come gestore di ricezione.

13. Nell'elenco a discesa Ricezione pipeline selezionare PassThruReceive.

14. Fare clic su OK.

Creare la porta di trasmissione

1. Nella console di amministrazione BizTalk fare clic con il pulsante destro del mouse sul nodo Invia porte , scegliere Nuovo e quindi fare clic su Porta di invio statica in modalità unidirezionale.

2. Nella finestra di dialogo Invia proprietà porta digitare SendToDestination nel campo Nome.

3. Nella sezione Trasporto selezionare Windows SharePoint Services per il tipo.

4. Fare clic su Configura per configurare le proprietà dell'adattatore Windows SharePoint Services.

5. Nella proprietà Porta servizio Web adapter digitare il numero di porta del server virtuale in cui è stato installato il servizio Web della scheda Windows SharePoint Services. Per impostazione predefinita, è configurata la porta 80.

6. Digitare in Destination per la proprietà Destination Folder .

7. Digitare in PurchaseOrder1-%MessageID%.xml per la proprietà Filename .

8. Impostare la proprietà Overwrite su Yes.

9. Digitare l'URL nel sito di SharePoint nella proprietà Url sito di SharePoint . Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

10. Impostare la proprietà Microsoft Office Integration su No.

11. Fare clic su OK.

12. Nell'elenco a discesa Send Port Properties (Proprietà portadi invio) selezionare BizTalkServerApplication.

13. Nell'elenco a discesa Invia pipeline selezionare PassThruTransmit.

14. Fare clic sulla scheda Filtri.

15. Selezionare WSS.InListName nel campo Proprietà .

16. Selezionare == nel campo Operatore .

17. Digitare Source nel campo Valore .

18. Fare clic su OK.

Abilitare e avviare l'indirizzo e la porta di ricezione

In queste procedure è possibile abilitare l'indirizzo di ricezione e avviare la porta di ricezione. È necessario completare questa procedura per consentire all'adapter Windows SharePoint Services di inviare e ricevere messaggi tramite la porta di trasmissione e l'indirizzo di ricezione specificati.

Abilitare l'indirizzo di ricezione

1. Nella console di amministrazione BizTalk fare clic sul nodo Percorsi di ricezione .

2. Fare clic con il pulsante destro del mouse SourceLocationsu e quindi scegliere Abilita.

Avviare la porta di trasmissione

1. Nella console di amministrazione BizTalk fare clic sul nodo Invia porte .

2. Fare clic con il pulsante destro del mouse su SendToDestination, quindi scegliere Start.

3. Chiudere la console di amministrazione BizTalk.

Invio di un messaggio tramite il sistema

In questa procedura verrà creato un documento XML che sarà quindi caricato nel sito Web di Windows SharePoint Services. L'adapter Windows SharePoint Services riceverà il messaggio, lo archivierà nella Raccolta documenti di archiviazione e lo invierà alla Raccolta documenti di destinazione. Questa procedura illustra come un documento viene eseguito da un sito Web di Sharepoint, tramite BizTalk Server e a un sito Web di Sharepoint Services usando l'adapter di Windows Sharepoint Services.

Creare una directory di lavoro

• Creare una directory nel computer denominato WSSAdapterWalk through. Ad esempio: C:\WSSAdapterWalkthrough.

Creare un file XML

1. Fare clic su Start, scegliere Tutti i programmi, scegliere Accessori e quindi fare clic su Blocco note.

2. Digitare quanto segue:

   <?xml version="1.0"?>  
   <PurchaseOrder>  
       <ID>1001</ID>  
       <FirstName>John</FirstName>  
       <LastName>Doe</LastName>  
       <Amount>750</Amount>  
   </PurchaseOrder>  
   

3. Salvare il file nella directory di lavoro come PurchaseOrder1.xml. Ad esempio: C:\WSSAdapterWalkthrough\PurchaseOrder1.xml.

Caricare il file XML

1. Aprire un Web browser e passare all'URL del sito creato nell'attività precedente, Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

2. Sul lato sinistro, in Documenti fare clic su Origine.

3. Fare clic su Carica documento.

4. Nella casella Nome digitare o passare al file XML creato in precedenza. Ad esempio, C:\WSSAdapterWalkthrough\PurchaseOrder1.xmle quindi fare clic su Salva e Chiudi. Il file verrà visualizzato nell'elenco.

5. Aggiornare la finestra del browser. Il PurchaseOrder1.xml file non sarà più elencato in questa raccolta.

   Nota

   Potrebbe essere necessario aggiornare il browser più volte, in quanto l'intervallo di polling è impostato su 10 secondi.

6. Nella barra di spostamento superiore fare clic su Documenti e elenchi.

7. In Raccolte documenti fare clic su Destinazione.

8. Il messaggio verrà ora visualizzato nella raccolta documenti di destinazione. Una copia del messaggio sarà inoltre disponibile nella raccolta documenti di archiviazione.

   Nota

   Se il messaggio non viene visualizzato nella raccolta documenti di destinazione, fare riferimento a "Risoluzione dei problemi dell'adattatore Windows SharePoint Services" in BizTalk Server Guida.

Riepilogo

In questa procedura dettagliata è stato illustrato come configurare Windows SharePoint Services e BizTalk Server in modo da poter inviare e ricevere un messaggio usando l'adattatore Windows SharePoint Services e il routing basato su contenuto (CBR).

Passaggi successivi

Dopo aver completato questa procedura dettagliata, eseguire la procedura dettagliata: Modulo 2 - Integrazione di Office con la procedura dettagliata dell'adapter Windows SharePoint Services, che si espande sul lavoro eseguito con questa procedura dettagliata e illustra come integrare Office con l'adattatore Windows SharePoint Services.

Vedere anche

Informazioni sull'adapter Windows SharePoint Services
Procedure dettagliate relative all'adapter Windows SharePoint Services