Proprietà di configurazione dell'adapter FILE
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione di un adapter FILE.
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| RemoveReceivedFileRetryCount | VT_UI4 | Specifica il numero di tentativi di eliminazione di un file che è stato letto dall'adapter FILE e inviato a BizTalk Server. | I valori validi sono compresi tra 0 e 100. | Il valore predefinito è 5. |
| RemoveReceivedFileMaxInterval | VT_UI4 | Specifica l'intervallo iniziale, in millisecondi, di attesa da parte dell'adapter FILE prima di tentare l'eliminazione di un file letto e inviato a BizTalk Server. | I valori validi sono compresi tra 1 e 1000. | Il valore predefinito è 10. |
| FileMask | VT_BSTR | Specificare il filtro per i file. | Nessuno | Il valore predefinito è *.xml. |
| BatchSizeInBytes | VT_UI4 | Specifica il numero massimo di byte complessivi per un batch di file da inviare a BizTalk MessageBox. | I valori validi sono compresi tra 1024 e 104857600. | Il valore predefinito è 102400. |
| PollingInterval | VT_UI4 | Specificare la frequenza, in millisecondi, con cui l'adapter FILE eseguirà il polling della posizione specificata per i nuovi file. | I valori validi sono compresi tra 1000 e 3600000. | Impostare su 1 per disattivare il polling. |
| BatchSize | VT_UI4 | Specifica il numero massimo di messaggi da inviare in un batch. | I valori validi sono compresi tra 1 e 256. | Il valore predefinito è 20. |
| FileNetFailRetryInt | VT_UI4 | Specifica l'intervallo, in minuti, tra i tentativi di accesso all'indirizzo di ricezione in una condivisione di rete, qualora sia temporaneamente non disponibile. | I valori validi sono compresi tra 0 e 4294967295. | Il valore predefinito è 5. |
| RemoveReceivedFileDelay | VT_UI4 | Specifica l'intervallo iniziale, in millisecondi, di attesa da parte dell'adapter FILE prima di tentare l'eliminazione di un file letto e inviato a BizTalk Server. | L'intervallo raddoppia dopo ogni intervallo tra i tentativi finché non viene raggiunto il valore massimo specificato. I valori validi sono compresi tra 1 e 1000. |
Il valore predefinito è 10. |
| RenameReceivedFiles | VT_BOOL | Specifica se rinominare o meno i file prima che vengano selezionati per l'elaborazione. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0. |
| FileNetFailRetryCount | VT_UI4 | Specifica il numero di tentativi di accesso all'indirizzo di ricezione in una condivisione di rete, qualora sia temporaneamente non disponibile. | I valori validi sono compresi tra 0 e 4294967295. | Il valore predefinito è 5. |
Nel codice seguente viene illustrato il formato della stringa XML utilizzata per impostare le proprietà:
<CustomProps>
<RemoveReceivedFileRetryCount vt="19">5</RemoveReceivedFileRetryCount>
<RemoveReceivedFileMaxInterval vt="19">300000</RemoveReceivedFileMaxInterval>
<FileMask vt="8">*.xml</FileMask>
<BatchSizeInBytes vt="19">102400</BatchSizeInBytes>
<PollingInterval vt="19">60000</PollingInterval>
<BatchSize vt="19">20</BatchSize>
<FileNetFailRetryInt vt="19">5</FileNetFailRetryInt>
<RemoveReceivedFileDelay vt="19">10</RemoveReceivedFileDelay>
<RenameReceivedFiles vt="11">0</RenameReceivedFiles>
<FileNetFailRetryCount vt="19">5</FileNetFailRetryCount>
</CustomProps>
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione di un adapter FILE:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| Username | VT_BSTR | Specifica credenziali alternative se l'istanza host dell'adapter FILE non dispone dei diritti necessari per una cartella condivisa di rete. | Nessuno | Specificare il nome utente nel formato <dominio>\nome utente. |
| UseTempFileOnWrite | VT_BOOL | Specifica un file temporaneo durante la scrittura nella cartella di destinazione. Al termine della scrittura, il file viene rinominato con il valore specificato per la proprietà FileName. | Questa proprietà può essere impostata su -1 (true) se la proprietà CopyMode è impostata sul valore 2 (Crea nuovo). I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0 (false). |
| CopyMode | VT_UI4 | Definisce e la modalità di copia da utilizzare per la scrittura di un messaggio in un file. | I valori validi sono: - 0 (Accodamento) - 1 (Sovrascrivi) - 2 (Crea nuovo) |
Il valore predefinito per il registro è 2 (Crea nuovo). |
| FileName | VT_BSTR | Specifica il nome del file nel quale il gestore di trasmissione dei file scriverà il messaggio. | Per informazioni sulle restrizioni di questa proprietà, vedere Restrizioni durante la configurazione dell'adapter File. | Il valore predefinito è %MessageID%.xml. |
| AllowCacheOnWrite | VT_BOOL | Specifica se utilizzare la memorizzazione nella cache del file system durante la scrittura di un messaggio in un file. | I valori validi sono: - 0 (non usare la memorizzazione nella cache) - -1 (usare la memorizzazione nella cache) |
Il valore predefinito è 0 (non utilizzare la memorizzazione nella cache) |
| Password | VT_NULL | Specifica la password da utilizzare insieme alla proprietà Username se l'istanza host dell'adapter FILE non dispone dei diritti necessari per una cartella condivisa di rete. | Questo valore è sempre impostato su null quando si esporta un file di associazione. Questo campo deve essere compilato manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. | Nessuno |
Nel codice seguente viene illustrato il formato della stringa XML utilizzata per impostare le proprietà:
<CustomProps>
<Username vt="8">Domainname\User</Username>
<UseTempFileOnWrite vt="11">-1</UseTempFileOnWrite>
<CopyMode vt="19">1</CopyMode>
<FileName vt="8">%MessageID%.xml</FileName>
<AllowCacheOnWrite vt="11">-1</AllowCacheOnWrite>
<Password vt="1" />
</CustomProps>