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.
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.
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.
Questa sezione descrive gli attributi nei metaoggetti MO_JTextConnector_Default .
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.
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:
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://]FullPathnameI 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:
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.
|
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.
|
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:
|
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:
[file://]FullPathname I valori predefiniti forniti sono:
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. |
Ci sono tre modi per specificare il nome del file di output:
Utilizzare questo attributo quando si desidera che il connettore scriva ogni oggetto business dello stesso tipo in file separati con numeri di sequenza unici, o colleghi oggetti business in un file singolo con un nome specifico.
Utilizzare un metaoggetto secondario dinamico quando si desidera generare dinamicamente un nome file di output per ogni tipo di oggetto business o restituire il nome del file di output generato dal connettore. Consultare Utilizzo di un metaoggetto secondario dinamico per i dettagli.
Ci sono diversi modi di utilizzare l'attributo OutputFileName per specificare il nome del file di output:
Native è una parola riservata.
Per ulteriori informazioni, consultare Specifica l'elaborazione della richiesta.