Configurare una porta di trasmissione SharePoint Services

In questo argomento viene confrontata una porta di trasmissione statica con una porta di trasmissione dinamica e vengono elencati anche i passaggi per creare una porta di trasmissione Windows SharePoint Services. In particolare:

Confronto tra una porta di trasmissione statica e una porta di trasmissione dinamica

Creare una porta di trasmissione statica

Creare una porta di trasmissione dinamica

Confronto tra una porta di trasmissione statica e una porta di trasmissione dinamica

Creare una porta di trasmissione statica

Quando si crea una porta di trasmissione statica, viene usato automaticamente il gestore di trasmissione predefinito associato al tipo di trasporto. Quando si usa l'adapter Windows SharePoint Services, il gestore di invio predefinito è BizTalkServerApplication. Per i passaggi per aggiungere un nuovo gestore di invio, passare a Come creare un gestore adattatore.

Creare la porta di trasmissione statica:

1. Nella console di amministrazione di BizTalk Server espandere Gruppo BizTalk [GroupName], espandere Applicazioni e quindi espandere l'applicazione per contenere la porta di invio.

2. Fare clic con il pulsante destro del mouse su Invia porte, scegliere Nuovo e quindi fare clic su Porta di invio statica unidirezionale.

   Importante

   Una porta di trasmissione statica Solicit-Response non è configurabile con l'adattatore Windows SharePoint Services.

3. In Proprietà fare clic su Windows SharePoint Services nell'elenco a discesa Tipo. Immettere le proprietà Name, Send Handler e Send Pipeline .

4. Fare clic su Configure. In Proprietà configurare quanto segue:

   Proprietà	Descrizione
   Porta servizio Web adapter	Obbligatorio. Porta configurata nel sito Web IIS che ospita il servizio Web della scheda SharePoint Services. Il valore predefinito è la porta 80, ovvero la porta HTTP standard. Aggiornare questo valore se viene usata una porta diversa dalla porta 80.
   Timeout	Obbligatorio. Questo valore, espresso in millisecondi, definisce l'intervallo di tempo in cui l'adapter riceve una risposta dal servizio Web. Il valore predefinito è 10000 ms (100 secondi). Aumentare questo valore se le dimensioni del messaggio o del batch sono maggiori del previsto. Specificare il timeout, in millisecondi, per le chiamate del servizio Web di runtime dell'adapter al servizio Web Adapter Windows SharePoint Services. Può essere necessario aumentare questo valore se le dimensioni del messaggio o del batch sono maggiori del valore medio previsto dall'adapter.
   Utilizza modello a oggetti client	Obbligatorio. Determina se viene usato il modello a oggetti CSOM (Client Side Object Model) o SSOM (Service Side Object Model) di SharePoint. Il valore predefinito è Sì. Impostare su Sì per usare sharePoint CSOM nella BizTalk Server. Non sono previsti requisiti per il computer SharePoint Services. Impostare su No per usare SharePoint SSOM che include il servizio Web installato nel computer SharePoint Services. Appendice B: installare l'adapter Microsoft SharePoint fornisce informazioni specifiche sui componenti SSOM e CSOM usati dall'adattatore SharePoint Services.
   URL cartella di destinazione	Obbligatorio. URL della cartella SharePoint Services per archiviare i documenti. Immettere il percorso relativo del sito di SharePoint, Ad esempio, Documenti condivisi o Documenti condivisi/Ordini di acquisto/. È inoltre possibile usare un elenco come destinazione, Ad esempio , elenchi/attività. Se si specifica un elenco, il corpo del messaggio non viene salvato insieme all'elemento di elenco. I valori estratti dal messaggio vengono alzati di livello nelle colonne di SharePoint. Nota: L'URL della raccolta documenti o della cartella di SharePoint può essere diverso dal nome. Per l'URL corretto, controllare l'indirizzo nel Web browser.
   Nome file	Facoltativo. Immettere il nome di SharePoint Services nome file. Immettere un nome di file, ad esempio PurchaseOrder0001.xml o un'espressione. Le espressioni includono qualsiasi combinazione di valori letterali, macro e query XPATH, Ad esempio, immettere PurchOrd-%XPATH=/po:PurchaseOrderId%-%MessageID%.xml. Se non si specifica un nome di file, viene usato il nome del file originale, il valore fornito dall'orchestrazione oppure 'Msg-%MessageID%.xml'. Per altre informazioni, vedere espressioni di adapter Windows SharePoint Services. Nota: Quando si inviano messaggi a un elenco, questo valore nome file viene ignorato e non salvato in una colonna di SharePoint. Aggiornare invece la colonna "Titolo" usando una delle 16 colonne disponibili. Gli elenchi di SharePoint non hanno una colonna Nome file.
   Alias spazi dei nomi	Facoltativo. Elenco separato da virgole o punti e virgola con le definizioni degli alias degli spazi dei nomi. Usare questo campo per definire gli alias degli spazi dei nomi usati dalle query XPATH inserite in campi quali 'Nome file' o 'Valore colonna'. Ad esempio, immettere po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' xmlns="; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'. Nota: Questa proprietà non esegue l'override del WSS. Proprietà del contesto del messaggio ConfigNamespacesAliases definita dall'orchestrazione. I due valori vengono uniti.
   Overwrite	Obbligatorio. Determina se viene sovrascritto un eventuale file esistente. Il valore predefinito è No. Le opzioni includono: - No: genera un errore e sospende il messaggio se esiste un file con lo stesso nome. - Orchestrazione: usa il valore definito nell'orchestrazione se esiste un file con lo stesso nome. - Rinomina: rinomina il nuovo file se esiste un file con lo stesso nome. - Sì: sovrascrive un file esistente se ha lo stesso nome. Se impostato su Sì, l'invio di un numero elevato di messaggi con lo stesso nome può causare errori di SharePoint Visualizzatore eventi. Questi errori non influiscono sull'adapter e qualsiasi messaggio con esito negativo verrà ritrasmesso.
   URL sito SharePoint	Obbligatorio. URL completo del sito Web SharePoint Services. Ad esempio, http:// SharePointServer/sites/TestSite. Nota: Un URI della porta di trasmissione o della posizione di ricezione non può superare i 256 caratteri.
   Integrazione Microsoft Office	Obbligatorio. Per i messaggi binari, è necessario usare No o Facoltativo. Il valore predefinito è Facoltativo. Le opzioni includono: No: salva il documento così come è. Questa opzione può essere usata per i messaggi binari. Facoltativo: modifica il documento in modo che venga aperto automaticamente in un'applicazione office, ad esempio InfoPath. Se le istruzioni di elaborazione non vengono trovate, il documento viene elaborato così come è. Questa opzione può essere usata per i messaggi binari. Orchestrazione: usa il valore definito nell'orchestrazione. Sì: modifica il documento in modo che venga aperto automaticamente in un'applicazione office, ad esempio InfoPath. Se non vengono trovate le istruzioni di elaborazione, il messaggio viene sospeso. Se impostato su Sì, è necessario almeno uno dei seguenti coppie di proprietà: Colonnedello spazio dei nomi Modelli e raccolta documenti Modelli di libreria documenti di fallback e colonnedello spazio dei nomi fallback Sì (Raccolta moduli infoPath): se una soluzione InfoPath si trova nella raccolta moduli, il documento viene modificato in modo che venga aperto automaticamente in un'applicazione office, ad esempio InfoPath. Se la raccolta moduli non contiene una soluzione, il messaggio viene sospeso.
   Raccolta documenti modelli	Obbligatorio solo quando viene popolata la colonna dello spazio dei nomi modelli. Raccolta documenti di SharePoint in cui vengono archiviate le soluzioni InfoPath, Ad esempio, Soluzioni personali. L'adapter cerca nella raccolta documenti modelli per una soluzione InfoPath corrispondente. Se non viene trovata una soluzione, l'adapter cerca nella raccolta documenti di fallback dei modelli. Nota: La raccolta documenti modelli richiede almeno una colonna "Singola riga di testo" popolata con quanto segue: Lo spazio dei nomi e il nodo radice dei documenti XML aperti con la soluzione InfoPath OPPURE il nodo radice del documento XML Per altre informazioni, vedere Procedura dettagliata: Modulo 2 - Integrazione di Office con l'adattatore Windows SharePoint Services.
   Raccolta documenti fallback modelli	Obbligatorio solo quando viene popolata la colonna dello spazio dei nomi fallback dei modelli. Raccolta documenti di SharePoint in cui vengono archiviate le soluzioni InfoPath, Ad esempio, Modelli. Se una soluzione non viene trovata nella raccolta documenti modelli, l'adapter cerca nella raccolta documenti di fallback modelli per una soluzione InfoPath corrispondente. I campi Raccoltadocumenti di fallback e raccolta documenti modelli possono essere usati con due set di soluzioni InfoPath. Esistono soluzioni InfoPath generiche che funzionano per tutte le operazioni generali e soluzioni InfoPath specializzate usate solo per partner specifici. Il campo Raccolta documenti fallback modelli deve puntare alle soluzioni generice e la raccolta documenti modelli deve puntare alle soluzioni specializzate per quel particolare partner. Nota:Templates Fallback Document Library richiede almeno una colonna 'Singola riga di testo' di SharePoint popolata con quanto segue: Lo spazio dei nomi e il nodo radice dei documenti XML aperti con la soluzione InfoPath OPPURE il nodo radice del documento XML Per altre informazioni, vedere Procedura dettagliata: Modulo 2 - Integrazione di Office con l'adattatore Windows SharePoint Services.
   Colonna spazio dei nomi fallback modelli	Obbligatorio solo quando viene popolata la raccolta documenti di fallback dei modelli. Raccolta documenti di SharePoint in cui viene archiviato lo spazio dei nomi delle soluzioni InfoPath, Ad esempio, myNamespace. Nota: Questo campo è distinzione tra maiuscole e minuscole.
   Colonna spazio dei nomi modelli	Obbligatorio solo quando viene popolata la raccolta documenti modelli. Colonna Raccolta documenti modelli sharePoint che archivia lo spazio dei nomi della soluzione InfoPath. Ad esempio, myNamespace. Nota: Questo campo è distinzione tra maiuscole e minuscole.
   Password SharePoint Online	Facoltativo. Password dell'account di SharePoint Online.
   Nome utente SharePoint Online	Facoltativo. Nome utente dell'account di SharePoint Online.
   Colonna n	Facoltativo. Colonna sharePoint presente nella raccolta documenti di destinazione. Aggiornare questa colonna con il valore estratto dal messaggio o specificato nel campo Valore colonna . Nota: È possibile specificare fino a 16 colonne. Questo campo applica la distinzione tra maiuscole e minuscole.
   Valore colonna n	Facoltativo. Immettere il valore di colonna da impostare per il messaggio. È possibile digitare un valore letterale, ad esempio 'Ordine di acquisto', o un'espressione. Le espressioni possono includere qualsiasi combinazione di valori letterali, macro e query XPATH, Ad esempio, immettere "%XPATH=/po:POAmount%", "%SendingOrchestrationID%". Nota: È possibile specificare fino a 16 colonne.

5. Fare clic su OK salvare le impostazioni.

6. Altre opzioni di configurazione delle porte di trasmissione includono:

   1. Come configurare le opzioni avanzate di trasporto per una porta di trasmissione

   2. Come configurare le opzioni di trasporto di backup per una porta di trasmissione

   3. Come configurare le mappe in uscita per una porta di trasmissione

   4. Come configurare i filtri per una porta di trasmissione

   5. Come assegnare un certificato a una porta di trasmissione

   6. Come configurare il rilevamento per una porta di trasmissione

Creare una porta di trasmissione dinamica

Quando si crea una porta di trasmissione dinamica, è possibile configurare il gestore di trasmissione per ciascun adapter. Una singola porta di trasmissione dinamica può essere usata da più adapter. Vedere Dynamic Send Port Handler is Configurable (Gestore porta di trasmissione dinamica) per i passaggi per configurare il gestore della porta di trasmissione dinamica.

1. Nella console di amministrazione di BizTalk Server espandere Gruppo BizTalk [GroupName], espandere Applicazioni e quindi espandere l'applicazione per contenere la porta di trasmissione.

2. Fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuova e quindi scegliere Porta di trasmissione unidirezionale dinamica o Porta di trasmissione dinamica Solicit-Response

3. In Proprietà immettere le proprietà Name e Pipeline

   Fare clic su Configure.

4. Nella finestra Configura gestore di trasmissione scegliere il gestore di invio per i singoli adattatori. Il gestore di trasmissione predefinito è BizTalkServerApplication. Per i passaggi per aggiungere un nuovo gestore di invio, passare a Come creare un gestore dell'adapter.

   È consigliabile usare host separati per diversi motivi, tra cui:

   • Requisiti a 32 bit: alcune schede richiedono un host a 32 bit, ad esempio le schede FTP e POP3. È possibile raggruppare tutti gli adapter a 32 bit o alcuni di essi in un host separato.

     Supporto a 64 bit per BizTalk Server

   • Host per scopo: creare un host per l'invio, un host per la ricezione, un host per l'elaborazione di orchestrazioni e un host per il rilevamento.

   • Impostazioni host diverse: molte impostazioni vengono implementate a livello di host. In questo modo è possibile configurare impostazioni di limitazione delle richieste diverse per ciascun host. È ad esempio possibile disabilitare la limitazione delle richieste nell'HostA, rilevare ciascun evento nell'HostB, modificare le impostazioni del CLR di .NET per l'HostC, aumentare l'utilizzo della memoria nell'HostD.

   • Sicurezza: la sicurezza viene implementata a livello di host. Ciascun host viene eseguito con un proprio account di Windows. Se ad esempio l'HostA usa l'adapter FILE per accedere a una condivisione file, è possibile assegnare all'account utente dell'HostA le autorizzazioni per l'accesso alla condivisione file. Se l'HostB usa un servizio Web ospitato in un server IIS, è possibile assegnare all'account utente dell'HostB l'autorizzazione per l'accesso al servizio Web. In questo modo è inoltre possibile impedire agli account di altri host di accedere a entità non necessarie.

   • Adattatori separati: ad esempio, sono disponibili diversi artefatti (percorso di ricezione e porte di trasmissione) usando l'adattatore HTTP. è consigliabile raggruppare tutti gli elementi associati all'adapter HTTP in un host separato.

   • Orchestrazioni separate: le singole orchestrazioni possono trovarsi nel proprio host. Se ad esempio un'orchestrazione usa una quantità elevata di memoria o CPU, è possibile inserirla in un host separato.

     BizTalk Server Guida all'ottimizzazione delle prestazioni e Come gestire e risolvere i problemi dei database BizTalk Server forniscono suggerimenti sulle prestazioni.

5. Fare clic su OK per salvare le impostazioni.

6. Altre opzioni di configurazione delle porte di trasmissione includono:

   1. Come configurare le opzioni avanzate di trasporto per una porta di trasmissione

   2. Come configurare le mappe in uscita per una porta di trasmissione

   3. Come configurare i filtri per una porta di trasmissione

   4. Come assegnare un certificato a una porta di trasmissione

   5. Come configurare il rilevamento per una porta di trasmissione

7. Fare clic su OK per salvare le impostazioni.

   Argomenti aggiuntivi relativi alle porte di trasmissione:

   Creazione e configurazione delle porte di trasmissione

   Creazione e configurazione di gruppi di porte di trasmissione

Vedere anche

Risoluzione dei problemi relativi SharePoint Services alla configurazione dell'adapter SharePoint Servicesreceive locationCSOM: SharePoint Services Adapter