Condividi tramite

Restrizioni durante la configurazione dell'adapter FILE

  • Articolo

Restrizioni e regole quando si usa l'adapter di file.

Maschera file e nome file gotchas

Il filtro file è una stringa che specifica il tipo di file che verrà prelevato dall'indirizzo di ricezione dal gestore di ricezione File. Il nome file è una stringa che specifica il nome del file in cui il gestore di trasmissione File scriverà il messaggio.

Di seguito vengono riportate le restrizioni applicate alle proprietà del nome file e del filtro file:

  • È possibile specificare un solo filtro file o nome file per ogni indirizzo di ricezione o porta di trasmissione.

  • Non è consentito specificare il percorso completo o parte del percorso con il filtro file o il nome file. Il filtro file e il nome file rappresentano sempre un nome senza il percorso.

  • Per il filtro file e il nome file non viene applicata la distinzione tra maiuscole e minuscole.

  • Il nome del file non può contenere uno dei caratteri seguenti: <> : / | " ? * ;

  • La maschera file non può contenere uno dei caratteri seguenti: <> : / | " ;

  • I nomi di dispositivo riservati seguenti non possono essere usati come nome di un file: CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 e LPT9. Non è consentita inoltre alcuna combinazione di questi nomi con estensioni.

  • I volumi dei dischi Windows usano la convenzione di denominazione 8.3 (8dot3) per impostazione predefinita, che usa nomi di file brevi e lunghi. I volumi dei dischi non di sistema disabilitano la convenzione di denominazione 8dot3 e quindi usano solo nomi di file lunghi.

    Quando 8dot3 è abilitato, i file e le relative estensioni di file vengono convertiti in un nome breve. Ad esempio, testabcdefgh.docx ottiene la conversione in testab~1.doc. Si noti che il nome del file è abbreviato e l'estensione del file viene abbreviata da .docx a doc.

    Questo comportamento influisce sul modo in cui l'adapter file riceve il file. Se una maschera file è impostata su *.xml, i file corrispondenti a *.xml entrambe le *.xmln estensioni vengono raccolti.

    Per verificare se la convenzione di denominazione 8dot3 è abilitata nei dischi, aprire un prompt dei comandi come amministratore e digitare fsutil 8dot3name query c:fsutil 8dot3name query d:o e così via. L'output di esempio è simile al seguente:

    C:\WINDOWS\system32>fsutil 8dot3name query c:
The volume state is: 0 (8dot3 name creation is enabled).
The registry state is: 2 (Per volume setting - the default).

Based on the above two settings, 8dot3 name creation is enabled on c:

    L'adapter File usa la funzione FindFirstFile. Questa funzione include i risultati della ricerca con i nomi di file brevi e lunghi. Per visualizzare i nomi di file brevi e lunghi in una cartella, aprire un prompt dei comandi, passare alla cartella e digitare dir /x. In un prompt dei comandi è anche possibile digitare dir c:\foldername /x.

    Se si modifica l'impostazione 8dot3name in un volume, i nuovi file usano la nuova impostazione. Tutti i file esistenti mantengono i nomi fino a quando non vengono spostati.

    Per raccogliere solo i file previsti e ottenere prestazioni migliori (meno sovraccarico) durante il carico più elevato, è consigliabile configurare l'adattatore file per usare un volume in cui è disabilitato 8dot3name.

  • La lunghezza totale di percorso file, filtro file e nome file (senza sostituzione macro) non deve superare 256 caratteri (questa è una restrizione del database MessageBox).

  • Il percorso del file non può iniziare con "\\?".

  • Nel percorso file non è possibile utilizzare lettere di unità di rete mappate, poiché variano in base alla sessione dell'utente.

    Il motore di messaggistica BizTalk convalida sempre le proprietà di nomi file e filtri file in fase di progettazione utilizzando gli elementi elencati precedentemente. L'adapter File inoltre convalida le proprietà di nomi file e filtri file in fase di esecuzione se il messaggio viene inviato su una porta dinamica.

Nota

L'adapter File non preleva file di sistema o file di sola lettura. Vengono prelevati solo file su disco e non file di dispositivo.

Uso di macro nei nomi di file

È possibile utilizzare un set di macro predefinito per creare in modo dinamico i file in cui il gestore di trasmissione File scrive i messaggi. Prima di creare un file nel file system, il gestore di trasmissione File sostituisce tutte le macro nel nome file con i rispettivi valori. È possibile utilizzare diverse macro in un nome file.

È possibile utilizzare le macro del nome file durante la configurazione del gestore di trasmissione File utilizzando il modello a oggetti di BizTalk Explorer.

Il gestore di trasmissione File non sostituisce le macro con un valore se si verifica una delle seguenti condizioni:

  • La proprietà di sistema corrispondente non è impostata.

  • Il nome della macro non è stato digitato correttamente.

  • Il valore della macro contiene simboli non validi per il nome file.

    Se si verifica una di queste condizioni, il gestore di trasmissione File lascia inalterate le macro nel nome file, ad esempio Myfile_%MessageID%.xml.

    Nella tabella seguente sono elencate le macro supportate e viene indicato come vengono sostituite dal gestore di trasmissione File.

Nome macro Valore sostitutivo
%datetime% Data e ora UTC (Coordinated Universal Time) nel formato AAAA-MM-GGThhmmss, ad esempio 1997-07-12T103508.
%datetime_bts2000% Data e ora UTC in formato AAAAMMGGhhmmsss, dove sss indica secondi e millisecondi, ad esempio 199707121035234 significa 1997/07/12, 10.35.23 e 400 millisecondi.
%datetime.tz% Data e ora locali più differenza di fuso orario rispetto a GMT nel formato AAAA-MM-GGThhmmssDFO, ad esempio 1997-07-12T103508+800.
%DestinationParty% Nome dell'entità di destinazione. Il valore deriva dalla proprietà BTS.DestinationPartydel contesto del messaggio.
%DestinationPartyQualifier% Qualificatore dell'entità di destinazione. Il valore deriva dalla proprietà BTS.DestinationPartyQualifierdel contesto del messaggio.
%MessageID% Identificatore univoco globale (GUID) del messaggio in BizTalk Server. Il valore proviene direttamente dalla proprietà del contesto del messaggio BTS. MessageID.
%SourceFileName% Nome del file da cui l'adapter FILE legge il messaggio. Il nome del file include l'estensione ed esclude il percorso del file, ad esempio Sample.xml. Quando si sostituisce questa proprietà, l'adapter File estrae il nome del file dal percorso del file assoluto archiviato nel FILE. Proprietà di contesto ReceivedFileName . Se la proprietà di contesto non contiene un valore, ad esempio se il messaggio è stato ricevuto su un adapter diverso dall'adapter FILE, la macro non verrà sostituita e rimarrà inalterata nel nome file, ad esempio C:\Drop\%SourceFileName%. Nota: L'implementazione corretta di questa macro richiede che il messaggio di output sia lo stesso messaggio del messaggio ricevuto.
%SourceParty% Nome dell'entità di origine da cui l'adapter FILE ha ricevuto il messaggio. Nota: L'implementazione corretta di questa macro richiede che il messaggio di output sia lo stesso messaggio del messaggio ricevuto.
%SourcePartyQualifier% Qualificatore dell'entità di origine da cui l'adapter FILE ha ricevuto il messaggio. Nota: L'implementazione corretta di questa macro richiede che il messaggio di output sia lo stesso messaggio del messaggio ricevuto.
%time% Ora UTC nel formato hhmmss.
%time.tz% Ora locale più differenza di fuso orario rispetto a GMT nel formato hhmmssTZD, ad esempio 124525+530.

Proprietà della cartella di ricezione e della posizione di destinazione

L'indirizzo di ricezione dei file è una stringa contenente il percorso di una cartella di un file system o di una condivisione di rete da cui il gestore di ricezione dei file legge i file. L'indirizzo di destinazione dei file è una stringa contenente il percorso di una cartella di un file system o di una condivisione di rete in cui il gestore di ricezione dei file scrive i file.

Alle proprietà della cartella di ricezione e dell'indirizzo di destinazione vengono applicate le restrizioni seguenti:

  • Non è necessario che il percorso file sia presente nel file system o nella condivisione di rete quando si specifica la proprietà.

  • Il percorso del file deve sempre essere assoluto.

  • È possibile specificare il percorso del file usando il formato UNC (Universal Naming Convention) (ad esempio \\<server>\<share>).

  • Se il percorso del file è in formato UNC, il nome del server non deve contenere i caratteri seguenti: ' ~ ! @ # $ ^ & * ( ) = + [ ] { } \ | ; : ' " , / <> ? ;

  • Non è possibile utilizzare i simboli di cartella padre (\..\) e corrente (\.\) in qualsiasi parte del percorso del file.

  • Nel percorso del file non viene applicata la distinzione tra maiuscole e minuscole.

  • Il percorso del file non può contenere uno dei caratteri seguenti: <> : / | " ? * ;

  • Nel percorso file non è possibile utilizzare i nomi dei dispositivi riservati seguenti: CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 e LPT9.

  • La lunghezza totale del percorso del file, del filtro file e del nome file (senza sostituzione macro) non deve superare i 256 caratteri (il database MessageBox impone tale restrizione).

  • L'adapter FILE non supporta la specifica Unicode del percorso del file, ad esempio "\\?\".

    Restrizioni solo per la proprietà della cartella di ricezione:

  • Non impostare la proprietà della cartella di ricezione su una cartella che utilizza il file system distribuito di Microsoft Windows NT con un collegamento simbolico. Se si utilizza un file system distribuito di Windows NT, per gli indirizzi di ricezione dell'adapter FILE è possibile utilizzare solo cartelle con percorsi di rete diretti.

  • Quando si inviano documenti a un percorso UNC e si dispone di più server per la ricezione dei documenti nell'indirizzo di ricezione per l'adapter FILE, un solo server preleverà ed elaborerà la maggior parte dei documenti inviati a tale percorso UNC. Per altre informazioni sulla ridenominazione dei file, vedere la sezione Scheda di ricezione file di Scheda file.

    Restrizioni solo per la proprietà della cartella di trasmissione:

  • È possibile che l'adapter file non disponga di risorse di sistema operativo sufficienti per elaborare simultaneamente tutti i messaggi in un batch quando è in esecuzione in un sistema operativo non server come Microsoft Windows Vista.

    L'adapter FILE convalida il percorso del file in fase di progettazione tramite le regole sopra descritte. L'adapter FILE convalida inoltre il messaggio in fase di esecuzione se l'adapter invia il messaggio attraverso una porta dinamica con un adapter FILE.