Configurare l'adapter per file

Articolo
07/21/2023

Come configurare l'adattatore file, leggere le raccomandazioni sulla sicurezza e visualizzare le autorizzazioni necessarie.

È possibile creare una posizione di ricezione e inviare la porta usando BizTalk Server Amministrazione o a livello di codice. Questo argomento è incentrato sulla console di amministrazione di BizTalk Server. Per i passaggi a livello di codice, passare a Creare il percorso di ricezione o inviare la porta a livello di codice.

Importante

A partire da BizTalk Server 2016, è possibile connettersi a una condivisione file di Azure usando l'adattatore File. L'account di archiviazione di Azure deve essere montato nel BizTalk Server. Introduzione all'archiviazione file di Azure in Windows elenca i passaggi di montaggio.

Suggerimenti per la sicurezza

L'adapter per file trasferisce file all'interno e all'esterno di BizTalk Server da o in una directory. Per la sicurezza e la distribuzione dell'adapter per file nell'ambiente in uso è consigliabile attenersi alle seguenti linee guida:

Non aprire le porte per connettersi a una condivisione file nella rete perimetrale. È opportuno utilizzare l'adapter per file in ambienti con un elevato livello di attendibilità, ad esempio una rete Intranet.
Impostare elenchi di controllo di accesso discrezionali (DACL) nelle directory di rilascio della posizione di ricezione. È ad esempio necessario impostare autorizzazioni di lettura, scrittura ed eliminazione di file e autorizzazioni di eliminazione di sottocartelle e file per la directory da cui l'indirizzo di ricezione file preleva i messaggi, in modo da consentire solo agli utenti autorizzati di inserire messaggi in questo indirizzo.
Se si prelevano dati importanti tramite l'adapter per file, utilizzare il protocollo Internet Protocol Security (IPSec).

Autorizzazioni necessarie

I gestori adattatori vengono eseguiti nel contesto di sicurezza dell'istanza host selezionata per il gestore dell'adapter. L'istanza host usa la proprietà nel nome host - Proprietà dell'istanzaLogon host in Amministrazione BizTalk. Questo Logon account deve disporre di autorizzazioni specifiche per le cartelle o le condivisioni usate dall'adattatore File.

L'account utente dell'istanza host usato dal gestore richiede le autorizzazioni seguenti. Significa ✔ che è necessaria l'autorizzazione. Una voce vuota indica che l'autorizzazione non è necessaria.

Autorizzazioni	Gestore di ricezione	Gestore di trasmissione
Controllo completo	✔ a livello di condivisione (se si accede a una condivisione file)
Cartella di attraversamento/ file di esecuzione		✔ a livello di file
Cartella elenco/lettura dei dati	✔ a livello di file	✔ a livello di file
Lettura attributi		✔ a livello di file
Lettura attributi estesi		✔ a livello di file
Creare file/scrivere dati		✔ a livello di file
Creare cartelle/aggiungere dati		✔ a livello di file
Eliminare sottocartelle e file	✔ a livello di file	✔ a livello di file
Autorizzazioni di lettura		✔ a livello di file
Modifica		✔ a livello di condivisione (se si accede a una condivisione file)

Suggerimento

A livello di file aprire le autorizzazioni avanzate nel file o nella cartella per visualizzare queste autorizzazioni.

Nota

Ogni host può essere associato a un solo gestore di ricezione.

Configurare il percorso di ricezione

Nota

Prima di completare la procedura seguente, è necessario aver già aggiunto una porta di ricezione unidirezionale. Vedere Come creare una porta di ricezione.

Nella console di amministrazione BizTalk Server espandere amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione in cui si vuole creare un percorso di ricezione.
Nel riquadro sinistro fare clic sul nodo Porte di ricezione . Nel riquadro destro fare quindi clic con il pulsante destro del mouse sulla porta di ricezione associata a un indirizzo di ricezione esistente o che si desidera associare a un nuovo indirizzo di ricezione e scegliere Proprietà.
Nel riquadro sinistro della finestra di dialogo Proprietà porta di ricezione selezionare Posizioni di ricezione e nel riquadro destro fare doppio clic su un percorso di ricezione esistente oppure fare clic su Nuovo per creare una nuova posizione di ricezione.
Nella sezione Trasporto della finestra di dialogo Proprietà percorso ricezione selezionare TIPO FILE nell'elenco a discesa e quindi fare clic su Configura per configurare le proprietà di trasporto per la posizione di ricezione.

Nella scheda Generale eseguire le operazioni seguenti:

Usare	Per
Cartella di ricezione	Obbligatorio. Immettere il percorso di una cartella nel file system, nella condivisione di rete o nella condivisione file di Azure in cui il file riceve i file legge i file. È possibile immettere il percorso direttamente nella casella di testo Ricezione cartella oppure selezionarlo dal file system usando il pulsante Sfoglia . Quando si esplora la cartella, è anche possibile creare una nuova cartella usando Crea nuova cartella. Se si usa una condivisione di archiviazione file di Azure, immettere `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Digitare: Stringa Nota: Non impostare la proprietà Della cartella Di ricezione su una cartella che usa il file system distribuito NT con un collegamento simbolico. Se si usa un file system distribuito NT, è possibile usare solo cartelle con percorsi di rete dritti nelle posizioni di ricezione della scheda file. Per restrizioni su questa proprietà, vedere Restrizioni durante la configurazione dell'adapter File. Nota: L'URI per una porta di invio o una posizione di ricezione non può superare i 256 caratteri.
Maschera file	Obbligatorio. Specificare il filtro per i file. Il filtro può contenere il carattere jolly standard "". Valore predefinito:* .xml Digitare:* Stringa Per restrizioni su questa proprietà, vedere Restrizioni durante la configurazione dell'adapter File.
Indirizzo pubblico	Specificare l'indirizzo pubblico. BizTalk Server espone questo indirizzo ai partner esterni. Se questa proprietà non è specificata, verrà sostituita dal motore di runtime, come segue: < file:// Cartella>/<Maschera file> Il valore di questa proprietà richiede un prefisso per l'adapter. Digitare: Stringa Lunghezza minima: 0 Lunghezza massima: 256
Numero di tentativi	Specifica il numero di tentativi di accesso all'indirizzo di ricezione in una condivisione di rete, qualora sia temporaneamente non disponibile. Valore predefinito: 5 Digitare: Lungo Valore minimo: 0 Valore massimo: MAX_LONG
Intervallo tra i tentativi (minuti)	Specifica l'intervallo, in minuti, tra i tentativi di accesso all'indirizzo di ricezione in una condivisione di rete, qualora sia temporaneamente non disponibile. Valore predefinito: 5 minuti Digitare: Lungo Valore minimo: 0 Valore massimo: MAX_LONG

Nella scheda Autenticazione eseguire le operazioni seguenti:

Usare	Per
Utilizza queste credenziali se l'host non ha accesso alla cartella condivisa di rete	Obbligatorio solo quando si usa una condivisione di rete o una condivisione file di Azure. Valore predefinito: False Digitare: Boolean
Nome utente	Se si usa una condivisione di rete, immettere il nome utente che ha accesso alla condivisione. Se si usa una condivisione di archiviazione file di Azure, immettere il nome dell'account di archiviazione. Digitare: Stringa Nota: Se più posizioni di ricezione mappate alla stessa condivisione di rete sono configurate con credenziali alternative, è necessario usare le stesse credenziali per tutti i percorsi di ricezione. Windows non consente di creare più connessioni a un server di rete condiviso dallo stesso computer se si tenta di utilizzare più serie di credenziali.
Password	Se si usa una condivisione di rete, immettere la password per l'account che ha accesso alla condivisione di rete. Se si usa una condivisione di archiviazione file di Azure, immettere la chiave di accesso dell'account di archiviazione; elencato nel portale di Azure. Digitare: Stringa

Nella scheda Invio in batch eseguire le operazioni seguenti:

Usare	Per
Numero di messaggi in un batch	Specifica il numero massimo di messaggi da inviare in un batch. Valore predefinito: 5 Digitare: Int Valore minimo: 1 Valore massimo: 256
Dimensioni massime batch (in byte)	Specificare le dimensioni massime in byte di un batch. Valore predefinito: 102400 Digitare: Int Valore minimo: 1024 Valore massimo: MAX_LONG

L'adapter File limiterà il batch al primo valore raggiunto, sia esso il numero massimo di messaggi o il numero massimo di byte consentiti.

Selezionare OK.
Immettere i valori appropriati nella finestra di dialogo Proprietà posizione di ricezione per completare la configurazione del percorso di ricezione e fare clic su OK per salvare le impostazioni. Per informazioni sulla finestra di dialogo Proprietà indirizzo di ricezione , vedere Come creare un indirizzo di ricezione.

Configurare la porta di trasmissione

Nella Console di amministrazione BizTalk Server creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Vedere Come creare una porta di trasmissione. Configurare tutte le opzioni della porta di trasmissione e specificare FILE per l'opzione Tipo nella sezione Trasporto della scheda Generale .
Selezionare il pulsante Configura accanto a Tipo.

Nella scheda Generale eseguire le operazioni seguenti:

Usare	Per
Posizione di destinazione	Obbligatorio. Immettere il percorso del file system, della condivisione pubblica o della condivisione file di Azure per scrivere i messaggi di output. È possibile immettere il percorso direttamente nel percorso di destinazione oppure selezionarlo dal file system usando il pulsante Sfoglia . Quando si esplora la cartella nella finestra di dialogo Cerca cartella, è anche possibile creare una nuova cartella facendo clic su Crea nuova cartella. Se si usa una condivisione di archiviazione file di Azure, immettere `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Digitare: Stringa Nota: L'URI per una porta di trasmissione o una posizione di ricezione non può superare i 256 caratteri.
Nome file	Specificare il nome del file nel quale il gestore di trasmissione File scrive il messaggio. Per le restrizioni su questa proprietà, incluso l'uso di macro nel nome file, vedere Restrizioni durante la configurazione dell'adattatore File.
Modalità di copia	Definire la modalità di copia da utilizzare per la scrittura di un messaggio in un file. I valori validi sono: Append. - Il gestore di trasmissione File apre un file eventualmente esistente e aggiunge un messaggio alla fine. Se il file non esiste, il gestore di trasmissione File ne crea uno nuovo. Sovrascrivi. - Il gestore di trasmissione File apre un file eventualmente esistente e ne sovrascrive il contenuto. Se il file non esiste, il gestore di trasmissione File ne crea uno nuovo. Creare un nuovo gruppo di risorse. - Se il file non esiste, il gestore di trasmissione File ne crea uno nuovo in cui scrive il messaggio. Se il file esiste già, il gestore di trasmissione File segnala un errore, quindi segue la logica comune di ripetizione dei tentativi dell'adapter per le porte di trasmissione. Si tratta della modalità di copia predefinita per il gestore di trasmissione File.
Consenti cache in scrittura	Definire se utilizzare la memorizzazione nella cache del file system durante la scrittura di un messaggio in un file. Le opzioni valide sono: False Non usare la cache del file system. Vero Usare la cache del file system. Valore predefinito: False Importante: l'impostazione di questa proprietà su True può aumentare le prestazioni dell'adattatore file a rischio di potenziale perdita di dati quando si verifica una perdita di alimentazione e non tutti i dati vengono scritti su disco.
Utilizza file temporaneo durante la scrittura	Definire se scrivere il file di output in un file temporaneo da rinominare al termine dell'operazione di scrittura. Se questa opzione è abilitata, il file temporaneo verrà creato con l'estensione BTS-WIP. Opzioni valide: Vero L'adattatore file crea un file temporaneo durante la scrittura nella cartella di destinazione. False L'adattatore file non crea un file temporaneo durante la scrittura nella cartella di destinazione. Valore predefinito: False Nota: questa opzione è disponibile solo quando la proprietà CopyMode è impostata su un valore create new

Nella scheda Autenticazione eseguire le operazioni seguenti:

Usare	Per
Utilizza queste credenziali se l'host non ha accesso alla cartella condivisa di rete	Obbligatorio solo quando si usa una condivisione di rete o una condivisione file di Azure. Valore predefinito: False Digitare: Boolean
Nome utente	Se si usa una condivisione di rete, immettere il nome utente che ha accesso alla condivisione. Se si usa una condivisione di archiviazione file di Azure, immettere il nome dell'account di archiviazione. Digitare: Stringa
Password	Se si usa una condivisione di rete, immettere la password per l'account che ha accesso alla condivisione di rete. Se si usa una condivisione di archiviazione file di Azure, immettere la chiave di accesso dell'account di archiviazione; elencato nel portale di Azure. Digitare: Stringa

Selezionare OK per salvare le impostazioni.

Impostare le proprietà per una porta di trasmissione dinamica

Una porta di trasmissione dinamica non fornisce opzioni di configurazione per il trasporto nella Console di amministrazione BizTalk Server perché si presume che tali proprietà vengano fornite insieme alle proprietà di contesto associate al messaggio. Queste proprietà possono essere impostate in una pipeline personalizzata o un'orchestrazione. Per impostare le proprietà di configurazione dei messaggi in un'orchestrazione, è possibile eseguire le operazioni seguenti:

Aggiungere una forma Costrutto messaggio all'orchestrazione.
Configurare la forma Costrutto messaggio per costruire un nuovo messaggio. ad esempio Message_2.
Aggiungere una forma Assegnazione messaggio alla forma Costrutto messaggio .
Aggiungere codice alla forma Assegnazione messaggi per inizializzare il messaggio costruito e impostare le proprietà di configurazione appropriate per il messaggio. Il codice seguente inizializza un messaggio denominato Message_2 costruito con una forma Construct Message e quindi imposta due proprietà di configurazione per il messaggio. In questo scenario Message_1 è stato ricevuto originariamente dall'orchestrazione:
```
Message_2=Message_1;  
Message_2(FILE.CopyMode)= 0; //0=Append  
Message_2(FILE.AllowCacheOnWrite)= true;  
Message_2(FILE.UseTempFileOnWrite)= true;  
```

Configurare il gestore di ricezione o invio

Nella console di amministrazione di BizTalk Server espandere BizTalk Server Amministrazione, espandere Gruppo BizTalk, espandere Impostazioni piattaforma e quindi fare clic su Adapter.
Nell'elenco espanso degli adattatori fare clic su FILE, nel riquadro destro fare clic con il pulsante destro del mouse sul gestore di ricezione o invio che si desidera configurare. Selezionare Proprietà.
Nell'elenco Nome host selezionare l'host per eseguire il gestore.
Fare clic su OK.