Struttura del metaoggetto JText

Un metaoggetto JText ha una struttura gerarchica. Il metaoggetto di livello superiore predefinito è denominato MO_JTextConnector_Default. Due attributi del metaoggetto di livello superiore, EventDataHandler e OutputDataHandler, rappresentano i metaoggetti secondari che forniscono informazioni di configurazione per il gestoredati che il connettore utilizza. Il connettore utilizza il gestore dati per convertire i dati tra gli oggetti aziendale e le stringhe o le matrici di byte.

Per impostazione predefinita, questi attributi specificano lo stesso metaoggetti del gestore dati (MO_DataHandler_DefaultNameValueConfig). Questo metaoggetto del gestore dati chiama il gestore dati NameValue per convertire effettivamente i dati. In altre parole, la configurazione predefinita fornita specifica che la conversione evento e file di output utilizza lo stesso gestore dati. Per informazioni sull'istanziazione di un gestore dati, consultare Data Handler Guide.

Nota:
Poiché l'utilizzo del programma di formattazione è stato rifiutato in favore dell'utilizzo del gestore dati, gli attributi EventFormat e OutputFormat che precedentemente rappresentavano un programma di formattazione sono stati rimossi dal metaoggetto MO_JTextConnector_Default. Per utilizzare un programma di formattazione, è necessario:

Per informazioni sull'utilizzo di un programma di formattazione, consultare la documentazione per il rilascio 3.0.0 o 2.3.0 del connettore JText.

Figura 5 mostra la struttura gerarchica per i metaoggetti JText predefiniti e ogni nome e tipo di attributo.

Figura 5. Struttura gerarchica del metaoggetto JText
Struttura gerarchica del metaoggetto JText

Creazione metaoggetti personalizzati

MO_JTextConnector_Default, come il metaoggetti JText di livello superiore, contiene informazioni di configurazione e metaoggetti secondari per il connettore. È possibile creare metaoggetti di livello superiore separati per ogni tipo di oggetto business che il connettore gestisce. Questi metaoggetti personalizzati possono contenere gli stessi o diversi metaoggetti secondari per configurare il tipo di gestore di dati. Ad esempio, per configurare l'elaborazione in modo diverso per gli oggetti business Customer e Item, creare i metaoggetti MO_JTextConnector_Customer e MO_JTextConnector_Item e progettare questi metaoggetti di livello superiore per contenere diversi metaoggetti del gestore dati.

All'inizializzazione, il connettore richiama un elenco di metaoggetti supportati e oggetti business dal broker di integrazione. Dai nomi di questi oggetti, il connettore determina quali oggetti business hanno i propri metaoggetti di livello superiore associati. Al runtime, il connettore corrisponde al nome di un oggetto business di richiesta con uno dei metaoggetti supportati per posizionare le informazioni di configurazione appropriate.

Ad esempio, presupporre che il connettore supporta i seguenti metaoggetti:

e i seguenti oggetti business:

Quando il broker di integrazione invia un oggetto business Customer di richiesta, il connettore utilizza le informazioni di configurazione specificate nel metaoggetto MO_JTextConnector_Customer. quando il broker di integrazione invia un oggetto business Order di richiesta, il connettore utilizza le informazioni di configurazione specificate nel metaoggetto MO_JTextConnector_Default.

Attributi MO_JTextConnector_Default

Questa sezione descrive gli attributi nei metaoggetti MO_JTextConnector_Default .

Nota:
Tutti i valori in una proprietà DefaultValue di attributi sono sensibili al maiuscolo/minuscolo. Le informazioni di directory devono specificare il percorso assoluto di una directory.

Tabella 8 e le sezioni seguenti descrivono la funzionalità di ogni attributo nel metaoggetto MO_JTextConnector_Default. Tra le altre informazioni, questa tabella include il valore fornito per ogni proprietà DefaultValue di ogni attributo semplice. È possibile sostituire il valore fornito con il prodotto con il proprio valore.

Tabella 8. Attributi nella definizione del metaoggetto MO_JTextConnector_Default
Nome attributo Descrizione
ArchiveDir
Specifica il percorso assoluto della directory Archive. La directory deve già esistere. I valori predefiniti forniti sono:

Linux: /tmp/JTextConn/Default/archive

Windows:C:\temp\JTextConn\Default\Archive


i5/OS: /QIBM/UserData/WBIServer44/<instance>/connectors/JText/archive

BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore JText.
DataEncoding
DataEncoding è la codifica da utilizzare per scrivere e leggere le stringhe di oggetti business. Se questa proprietà non viene specificata nel metaoggetto statico, il connettore prova a leggere o scrivere la stringa dell'oggetto aziendale senza utilizzando la codifica specifica. È possibile specificare la codifica supportata di Java impostato per questo attributo.
DataProcessingMode
Questo attributo fornisce nuova flessibilità per la lettura e la scrittura dei file binari. Quando viene impostato su Binaria, questa proprietà MO abilita JText a leggere e scrivere i file binari dal sistema di file mentre richiama l'interfaccia del gestore dati appropriata perle trasformazioni di BO nella matrice di byte e viceversa. L'impostazione tradizionale per questo è Text. Nel modo Text, viene utilizzata l'interfaccia del gestore dati di BO a String e viceversa. Quando la proprietà non è impostata viene predefinita su Text. Il modo Binary dovrebbe essere solo utilizzato con un gestore dati che appropriatamente implementa i metodi getBO(byte[]) e getByteArrayFromBO().
DummyKey
Questo attributo esiste per soddisfare il requisito che un attributo in ogni definizione oggetto business ha la proprietà Key abilitata.
EndBODelimiter
Specifica un delimitatore che separa gli oggetti business nel file di input. Per ulteriori informazioni sull'attributo EndBODelimiter, consultare Poll per gli oggetti business specifici.

Se non si fornisce un valore predefinito durante la configurazione e DataProcessingMode è impostato su Text, la proprietà viene impostata in modo predefinito sul seguente valore: <EndBO:BOName>. Quando DataProcessingMode è binario, la proprietà è impostata in modo predefinito sul seguente valore: FF01 .
Nota:
Poiché il gestore dati del NameValue viene impostato come gestore dati predefinito, il valore EndBODelimiter viene impostato su <EndBO:BOName>. Se si desidera utilizzare un altro gestore dati, come il gestore dati Delimitato, sarà necessario specificare il valore corrispondente. Per il gestore dati Delimitato, la stringa EOL è un valore EndBODelimiter valido.
EndOfFileDelimiter
Quando DataProcessingMode è binario e FTPDataStructure è Record, vengono utilizzati EndBODelimiter e EndOfFileDelimiter. Questa proprietà viene impostata sul byte esadecimale che è utilizzata per la fine del marker del file nel file di record. Se non è impostata, viene utilizzato il valore predefinito FF02.
EventDataHandler
Rappresenta un metaoggetto secondario i cui attributi forniscono valori di configurazione per il gestore dati da utilizzare per l'elaborazione eventi (stringa oggetto business convertito all'oggetto business). Il valore predefinito fornito è MO_DataHandler_DefaultNameValueConfig
EventDir
Specifica il percorso assoluto della directory Event. La directory deve già esistere. Se si creano metaoggetti separati per diversi oggetti business diversi e si specifica lo stesso percorso EventDir per entrambi, è necessario specificare valori univoci per l'attributo EventExt in ogni metaoggetto. Per ulteriori informazioni, consultare Specifica directory evento ed estensioni. Per configurare il connettore affinché utilizzi un sistema di file FTP remoto per l'elaborazione eventi, specificare l'URL FTP in questo attributo. Facoltativamente, è possibile utilizzare questo attributo per specificare le seguenti ulteriori informazioni nell'URL:
  • L'id e la password di un utente con i privilegi per connettersi al server FTP ed eseguire le operazioni FTP; se non specificato in EventDir, è necessario specificarlo in FTPUserId eFTPPassword.
  • La porta FTP; se non specificata in EventDir, il connettore utilizza la porta FTP predefinita.
  • la directory evento remota; se non specificata in EventDir, il connettore esegue il poll dei file di evento dalla directory nella quale è stabilita la connessione al server FTP.
La sintassi per specificare le informazioni FTP nell'attributo EventDir è:
ftp://[UserId:password@]FTPserver[:port][RemoteEventDirectory]
Per ulteriori informazioni, consultare Elaborazione eventi remota. Per specificare le informazioni di file locale nell'attributo EventDir, utilizzare il percorso completo del file. In alternativa, è possibile utilizzare un FILE URL, che utilizza il seguente formato:
[file://]FullPathname
I valori predefiniti forniti sono:
Linux: /tmp/JTextConn/Default/event

Windows:C:\temp\JTextConn\Default\Event


i5/OS:
/QIBM/UserData/WBIServer44/<instance>/connectors/JText/event

BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
Nota:
Una nuova proprietà booleana specifica del connettore, "NoPoll", è stata introdotta per disattivare facoltativamente il poll. Il valore predefinito è false. Quando è impostato su true, l'adattatore elabora solo le richieste e non esegue il poll.
EventExt
Specifica l'estensione del file utilizzato per la notifica dell'evento. Se non è specificato alcun valore, il connettore JText esegue poll per i file con nessuna estensione file. Per ulteriori informazioni, consultare Specificare più file di evento o più directory di evento.
Nota:
L'utilizzo di un asterisco (*) per questo attributo per specificare che il poll del connettore per tutti i file in una directory di evento singola indipendentemente dalla estensione, non è più supportato.
Il valore predefinito fornito è in.
FailArchiveExt
Specifica l'estensione del file utilizzata per archiviare gli oggetti business che non sono stati elaborati correttamente. Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Il valore predefinito fornito è fail.
FileSeqEnabled
Specifica la sequenza nome file, che emette ogni oggetto business in un file separato. Il nome del file include un numero di sequenza univoco. Per ulteriori informazioni, consultare Specifica l'elaborazione della richiesta. Il valore predefinito fornito è true.
FixedBOSize

Quando è presente con un valore valido, questa proprietà del metaoggetto sovrascriverla proprietà EndBODelimiter e fornisce agli utenti un'alternativa al delimitatore tradizionale basta sull'analisi BO.

FTPArchiveDir
Specifica il percorso relativo della directory di archivio sul server FTP. La directory deve già esistere. Ci sono diverse opzioni per utilizzare questo attributo in modo da specificare l'archivio:
  • Specificare un valore per questo attributo, ma nessun valore per l'attributo FTPRenameExt in modo che il connettore colleghi una data/ora al nome file dell'evento e lo sposti alla directory di archivio del server FTP in questo attributo.
  • Specificare un valore per questo attributo e l'attributo FTPRenameExt in modo che il connettore ridenomini il nome file dell'evento elaborato con una data/ora ed un valore specificato in FTPRenameExt e lo sposti nella directory di archivio del server FTP specificata in questo attributo.
  • Non specificare alcun valore per questo attributo o per l'attributo FTPRenameExt in modo che il connettore elimini il file di evento elaborato senza archiviarlo.
  • Non specificare alcun valore per questo attributo, ma specificare un valore per l'attributo FTPRenameExt in modo che il connettore ridenomini il file di evento elaborato, aggiungendo una data/ora ed il valore specificato in FTPRenameExt, e spostandolo nella directory specificata nell'attributo EventExt.
  • Specificare / (barra) per questo attributo ma nessun valore per l'attributo FTPRenameExt in modo che il connettore sposti il file di evento elaborato nella directory root sul server FTP.
  • Specificare / (barra) per questo attributo ed un valore per l'attributo FTPRenameExt in modo che il connettore ridenomini il nome del file di evento elaborato con l'estensione specificato in FTPRenameExt, e lo sposti nella directory root sul server FTP.
Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Non c'è nessun valore fornito per questo attributo.
BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
FTPDataStructure
Questo attributo è del tipo Stringa. L'utente può specificare la struttura dei dati FTP (File o Record) per ottenere o inserire i file da o al sito remoto. Se non viene specificato niente, Jtext utilizza 'File come valore predefinito
FTPEventFileMask
Utilizza caratteri jolly integrati per specificare la maschera o il prefisso o i file FTP remoti per l'elaborazione evento. Specificare un valore per questo attributo solo per identificare la maschera del file su una struttura principale che non aderisce agli standard di denominazione che si applicano ai sistemi Windows, Linux, o i5/OS. Utilizzando i caratteri jolly nel nome file è possibile specificare più files per l'elaborazione evento. Ad esempio, è possibile utilizzare il seguente formato per specificare più file di evento: ACT.Z1UC.INPT*Per ulteriori informazioni, consultare Identificazione file su una struttura principale: Configurazione facoltativa. Non esiste alcun valore predefinito fornito.

Se si esegue il poll, è necessario fornire una maschera molto specifica. Ad esempio, se si desidera eseguire il poll di tutti i file di evento seguenti: USER.JTEXT.TEST001.EVENT, USER.JTEXT.TEST002.EVENT, USER.JTEXT.TEST003.EVENT, USER.JTEXT.TEST004.EVENT, e FTPArchiveDir è impostato come / o lasciato vuoto, e FTPRenameExt è impostato come RENAME, quindi questi file vengono archiviati come il seguente: USER.JTEXT.TEST001.RENAME, USER.JTEXT.TEST002.RENAME, USER.JTEXT.TEST003.RENAME. Quindi, se si fornisce un FTPEventFileMask=USR.JTEXT.TEST*.*, tutti gli eventi verranno presi al primo poll. Tutti i file archiviati verranno presi al poll successivo, poiché sono anche conformi alla stessa maschera del file. Per evitare ciò, è necessario fornire una maschera molto specifica. Ad esempio, come USR.JTEXT.TEST*.EVENT, in modo che USR.JTEXT.TEST*.RENAME non sia preso durante il polling.
Nota:
Non specificare una maschera che è applicabile per i file di evento e archiviati.

BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
FTPFileListingFormat
Specifica il formato nel quale il connettore JText prevede che le informazioni del file appaiano durante la lettura nei file. Questo abilita il connettore a leggere nei file in diverse locali dove potrebbero essere memorizzate le informazioni di data e ora in ordini diversi nelle informazioni del formato di file. Per configurare il connettore per utilizzare il formato per la locale, specificare una serie di caratteri delimitati da un punto e una virgola che rappresentano l'ordine nel quale si verificano gli attributi del file; di seguito viene riportato un elenco che associa i caratteri possibili con gli attributi del file che rappresentano.
P Permission L Links U User G Group S Size D Date M Month T Time N Name
Un valore adatto per questo attributo, quindi, potrebbe essere P:L:U:G:S:D:M:T:N.
FTPGetQuantity
Determina il numero di file richiamati dall'URL FTP remoto con ogni poll remoto.
FTPKeepConnectionOpen
Impostare la proprietà Valore predefinito di questo attributo sul valore true per fare in modo che il connettore JText conservi la connessione con un sito FTP. Se questo attributo è impostato sul valore true allora il connettore chiude solo la connessione quando il connettore viene arrestato o se il server FTP chiude la connessione stessa (a causa del timeout configurato, ad esempio). Il connettore verifica che la connessione è ancora attiva ogni volta che esegue un'operazione remota per gestire la situazione quando il server FTP potrebbe aver chiuso la connessione a causa del timeout. Se la connessione è stato chiuso allora il connettore lo ristabilisce. Impostare la proprietà Valore predefinito di questo attributo sul valore false per fare in modo che il connettore JText apra una connessione con il server FTP ogni volta che esegue un'operazione e chiude quando è terminata la connessione. La configurazione del connettore per mantenere la connessione attiva può migliorare la prestazione del connettore quando si esegue l'elaborazione della richiesta sul sito FTP.
FTPLocalEventDir
Specifica la directory del sistema locale nella quale il connettore scarica i file di evento dal sito FTP. È necessario specificare un valore per questo attributo per abilitare il connettore ad elaborare gli eventi utilizzando FTP. Per ulteriori informazioni, consultare Specifica della directory locale. Non esiste alcun valore predefinito fornito.
BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
FTPOSPlatform
Utilizzare questo attributo solo se si configura il connettore per utilizzare un sistema di file FTP remoto quando il server FTP remoto è una piattaforma MVS. In questo caso, specificare il valore di questo attributo come MVS. Il maiuscolo/minuscolo non è significativo. Per ulteriori informazioni, consultare Specifica di un file system FTP remoto. Non esiste alcun valore predefinito fornito.
FTPPassword
Specifica la password dell'utente che ha autorizzazioni per connettersi al server FTP ed eseguire le operazioni FTP. Non è necessario specificare un valore per questo attributo se la password è inclusa nell'URL specificato nell'attributo EventDir o OutputDir. Per ulteriori informazioni, consultare Specifica dell'URL FTP ed informazioni di login. Non c'è nessun valore fornito per questo attributo.
FTPPollTerminateIfServerDown

Specifica il funzionamento del connettore quando è configurato per eseguire il poll del sito FTP per gli eventi ed il sito FTP non è disponibile. Se la proprietà Valore predefinito dell'attributo FTPPollTerminateIfServerDown è impostato sul valore true ed il sito FTP non è disponibile quando il connettore tenta di eseguire il poll di una chiamata, allora il connettore termina. Se la proprietà Valore predefinito dell'attributo FTPPollTerminateIfServerDown è impostato sul valore false ed il sito FTP non è disponibile quando il connettore tenta di eseguire il poll di una chiamata, allora il connettore non termina.
Non esiste alcun valore predefinito fornito.

FTPRenameExt

Specifica l'estensione file o il suffisso che il connettore utilizza per ridenominare il file FTP remoto dopo che il connettore ne ha eseguito il poll. La ridenominazione del file evita che il connettore esegua il poll dello stesso file nel ciclo di poll successivo. In alternativa, è possibile configurare il connettore per ridenominare il file di evento elaborato e spostarlo in una directory di archivio. Per ulteriori informazioni, consultare l'attributo FailArchiveExt. Per ulteriori informazioni, consultare Identificazione file su una struttura principale: Configurazione facoltativa. Non esiste alcun valore predefinito fornito.

FTPRequestTerminateIfServerDown

Specifica il funzionamento del connettore quando è configurato per eseguire l'elaborazione della richiesta e comunicare con un sito FTP, ed il sito FTP non è disponibile. Se la proprietà Valore predefinito dell'attributo FTPRequestTerminateIfServerDown è impostato sul valore true ed il sito FTP non è disponibile quando il connettore tenta di eseguire l'elaborazione della richiesta, quindi il connettore termina. Se la proprietà Valore predefinito dell'attributo FTPRequestTerminateIfServerDown viene impostato sul valore false ed il sito FTP non è disponibile quando il connettore tenta di eseguire l'elaborazione della richiesta, allora il connettore non termina.
Non esiste alcun valore predefinito fornito

.
FTPTransferType

Questa proprietà del metaoggetto JText viene utilizzata durante l'elaborazione dell'evento e della richiesta. I valori possibili per questa proprietà sono Binary e ASCII. La proprietà detta il tipo di trasferimento che JTex utilizza quando si posizionano in modo remoto o si richiamano i file da un server FTP. Quando la proprietà non esiste, il funzionamento dell'adattatore viene impostato in modo predefinito su Binary.

FTPUserId
Specifica il nome dell'utente che ha privilegi per connettersi al server FTP ed eseguire le operazioni FTP. Non è necessario specificare un valore per questo attributo se l' id utente è incluso nell'URL specificato nell'attributo EventDir o OutputDir. Il connettore ignora questo attributo se non trova un URL di FTP nell'attributo EventDir (durante l'elaborazione dell'evento) o l'attributo OutputDir (durante l'elaborazione della richiesta). Per ulteriori informazioni, consultare Specifica dell'URL FTP ed informazioni di login. Non c'è nessun valore fornito per questo attributo.
IncludeEndBODelimiter
Specifica se il valore specificato per l'attributo del metaoggettoEndBODelimiter è incluso o meno nella stringa scritta in un file dal connettore JText. Se la proprietà Valore predefinito di questo attributo è impostata su true allora il connettore include il valore specificato per l'attributo EndBODelimiter quando scrive i file. Se la proprietà Valore predefinito di questo attributo è impostata su false allora il connettore non include il valore specificato nell'attributo EndBODelimiter quando scrive i file.
LargeObject
Un flag utilizzato per attivare le funzioni di ottimizzazione degli oggetti ampi dell'adattatore JText (quando è impostato su true). L'impostazione di questo flag su true risulta nella seguente modifiche nel funzionamento del programma di archiviazione:
  1. Se un file di evento ha più oggetti business, l'archiviazione verrà eseguita solo dopo che tutti gli oggetti business per quel file di evento vengono elaborati.
  2. Il file originale non verrà archiviato nel caso in cui l'elaborazione degli oggetti business in quel file di evento risulti in un errore o in uno stato non sottoscritto.
Verrà inoltre creato un file di log in più internamente per mantenere traccia dello stato di archiviazione.
MVSSiteCommand
Utilizzato per emettere i comandi del sito FTP MVS. Il comando del sito dovrebbe essere specificato senza le parole chiave SITE o QUOTE. Un esempio del valore del comando del sito è:LRECL=<value> BLKSIZE=<value>, dove <value> rappresenta gli argomenti del comando del sito passati.
ObjectEventID
Placeholder non utilizzato dal connettore in un metaoggetto ma richiesto dal broker di integrazione. Questo attributo deve essere l'ultimo attributo nel metaoggetto. Non esiste alcun valore predefinito fornito.
OriginalArchiveExt
Specifica l'estensione del file utilizzata per archiviare il file di evento originale, che conserva l'intero file di evento per riferimento in caso gli oggetti business sbagliano l'elaborazione o non sono sottoscritti. Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Il valore predefinito fornito è orig.
OutputDataHandler
Rappresenta un metaoggetto secondario i cui attributi forniscono valori di configurazione per il gestore dati da utilizzare per le richieste di chiamata del servizio (oggetto business convertito alla stringa dell'oggetto business). Il valore predefinito fornito è MO_DataHandler_DefaultNameValueConfig
OutputDir
Specifica il percorso assoluto della directory Output. La directory deve già esistere. Per configurare il connettore affinché utilizzi un sistema di file FTP remoto per l'elaborazione richiesta, specificare l'URL FTP in questo attributo. Facoltativamente, è possibile utilizzare questo attributo per specificare le seguenti ulteriori informazioni nell'URL:
  • L'id e la password di un utente con i privilegi per connettersi al server FTP ed eseguire le operazioni FTP; se non specificato in EventDir, è necessario specificarlo in FTPUserId eFTPPassword.
  • La porta FTP; se non specificata in OutputDir, il connettore utilizza la porta FTP predefinita.
  • la directory di output remota; se non specificata OutputDir, il connettore carica i file di richiesta nella directory di connessione predefinita (la directory sul server FTP sulla quale viene stabilita la connessione).
La sintassi per specificare le informazioni FTP nell'attributo è OutputDir:ftp://[UserId:password@]FTPserver[:port]Per ulteriori informazioni, consultare Elaborazione richiesta remota. Per specificare le informazioni di file locale nell'attributo OutputDir, utilizzare il percorso completo del file. In alternativa, è possibile utilizzare un FILE URL, che utilizza il seguente formato:
[file://]FullPathname

I valori predefiniti forniti sono:

Linux
: /tmp/JTextConn/Default/out

Windows:c:\temp\JTextConn\Default\Out


i5/OS:
/QIBM/UserData/WBIServer44/<instance>/connectors/JText/out

BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
OutputExt
Specifica l'estensione del file utilizzato per l'elaborazione dell'evento. Il valore predefinito è out.
Nota:
Se OutputFileName non contiene nessuna estensione, ma l'attributo OutputExt contiene un'estensione, il file di output viene generato con il nome e l'estensione del file. Se non contiene un'estensione, il file di output viene generato senza uno.
OutputFileName
Specifica il nome e il percorso del file di output nel quale il connettore scrive l'oggetto business in entrata durante l'elaborazione della richiesta. Se l'attributo OutputDir contiene una directory di output valida, il file di output viene generato nella directory specificata. Per ulteriori informazioni, consultare Specifica del nome del file di output.
Nota:
Se gli attributi OutputFileName eOutputExt non contengono un'estensione, il file di output viene generato senza un'estensione.
Il valore predefinito fornito è Native.
BiDi supportato. Se il formato BiDi utilizzato nelle piattaforme di destinazione è diverso dal formato Windows 2003, i valori per questi attributi di metadati verranno trasformati.
PartialArchiveExt
Specifica l'estensione del file utilizzata per archiviare gli oggetti business elaborati con successo (quando il file di evento contiene più oggetti business, non tutti elaborati con successo). Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Il valore predefinito fornito è partial.
StagingDir
Specifica una directory nella quale il connettore dovrebbe scrivere i file prima di spostarli nella directory specificata dall'attributo OutputDir. Questo è progettato per gestire gli ambienti dove altri processi software potrebbero star elaborando e manipolando la directory nella quale il connettore JText emette i file (come un processo FTP che rileva i file creati dal connettore e li sposta in un'altra posizione). In situazioni come queste, c'è un rischio che il processo esterno sposti il file prima di essere stato scritto completamente. E' possibile specificare una directory di blocco nell'attributo StagingDir, in questo modo il connettore scrive il file completamente nella directory di blocco e quindi lo sposta nella directory di emissione quando è terminata, eliminando il rischio che il processo esterno prenda un file incompleto.
Si consiglia la directory di blocco e di emissione sia sullo stesso file system o unità per adattare diversi approcci dei sistemi operativi alle operazioni di spostamento del file. Notare che StagingDirpuò essere una directory remota.

Non esiste alcun valore predefinito fornito.

BiDi supportato per Windows. Tutte le proprietà abilitate BiDi verranno trasformate dal formato Windows BiDi nel formato BiDi.Metadata, che è una proprietà standard del connettore e-Mail.
SuccessArchiveExt
Specifica l'estensione del file utilizzata per archiviare gli oggetti business che non sono stati elaborati correttamente. Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Il valore predefinito fornito è success.
UnsubscribedArchiveExt
Specifica l'estensione del file utilizzata per archiviare gli oggetti business non sottoscritti. Per ulteriori informazioni, consultare Specifica dell'archivio di evento. Il valore predefinito fornito è unsub.

Nota:
Gli attributi FTPTransferType, FTPDataStructure, DataProcessingMode, EndOfFileDelimiter, e FixedBOSizenon sono parte del metaoggetto JText come fornito. Per utilizzare questi attributi, è necessario aggiungerli esplicitamente al metaoggetto ed è necessario impostare i valori predefiniti.

Specifica del nome del file di output

Ci sono tre modi per specificare il nome del file di output:

Ci sono diversi modi di utilizzare l'attributo OutputFileName per specificare il nome del file di output:

Nota:
Se il connettore sta elaborando più di un tipo di oggetto business e OutputFileName è impostato su una stringa diversa da Native, ogni oggetto business deve avere il suo metaoggetto di livello superiore che specifica un nome di file di output univoco. Ad esempio, il metaoggetto utilizzato dall'oggetto business Custom potrebbe essere MO_JTextConnector_Customer, e il metaoggetto utilizzato da Item potrebbe essereMO_JTextConnector_Item. Impostare il valore dell'attributo OutputFileName in ogni metaoggetto su un valore univoco.

Native è una parola riservata.

Per ulteriori informazioni, consultare Specifica l'elaborazione della richiesta.

Copyright IBM Corp. 2004, 2005