Impostazione delle proprietà del file di configurazione

Quando si crea e di assegna un nome ad un nuovo file di configurazione oppure quando si apre un file di configurazione di connettore esistente, Connector Configurator Express visualizza un pannello di configurazione con schede per le categorie di valori di configurazione richiesti.

Connector Configurator Express richiede i valori per le proprietà in queste categorie per i connettori:

Nota:
Per connettori che utilizzano messaggistica JMS, è possibile che venga visualizzata una categoria aggiuntiva, per configurazioni di gestore dati che convertono dati in oggetti di business.

Per connettori che vengono eseguiti su InterChange Server Express, sono anche richiesti i valori per queste proprietà.

Importante:
Connector Configurator Express accetta valori di proprietà in serie di caratteri in inglese o lingue diverse dall'inglese. Tuttavia, i nomi delle proprietà standard e specifiche dei connettori e i nomi di oggetti di business supportati, devono utilizzare solo serie di caratteri inglesi.

Le proprietà standard differiscono dalle proprietà specifiche dei connettori per i seguenti elementi:

I campi per Proprietà standard e Proprietà specifiche del connettore sono codificate con un colore per indicare quali sono configurabili:

Impostazione proprietà connettore standard

Per modificare il valore di una proprietà standard:

  1. Fare clic sul campo di cui si desidera visualizzare il valore.
  2. Immettere un valore oppure selezionarne uno dal menu a discesa, se viene visualizzato.
    Nota:
    Se la proprietà ha un Tipo di stringa, potrebbe avere un valore di sottotipo nella colonna Sottotipo. Questo sottotipo è utilizzato per una convalida estesa della proprietà.
  3. Una volta immessi i valori per le proprietà standard, è possibile effettuare una delle seguenti operazioni:

Per ottenere ulteriori informazioni su una proprietà standard particolare, fare clic con il pulsante sinistro del mouse sulla voce nella colonna Descrizione per quella proprietà nel foglio a tabella Proprietà standard. Se si è installato Extended Help, appare un pulsante a freccia sulla destra. Quando si fa clic sul pulsante, si apre una finestra Guida e vengono visualizzati dettagli della proprietà standard.

Nota:
Se il pulsante non appare, non è stata trova trovata nessuna Guida estesa per quella proprietà.

Se installati, i file Guida estesa si trovano nella directory <ProductDir>\bin\Data\Std\Help\<RegionalSetting>\.

Impostazione delle proprietà di configurazione specifiche del connettore

Per le proprietà di configurazione specifiche del connettore, è possibile aggiungere o modificare i nomi delle proprietà, i valori di configurazione, eliminare una proprietà o crittografare una proprietà. La lunghezza della proprietà predefinita è di 255 caratteri.

  1. Fare clic con il pulsante destro del mouse in parte superiore sinistra della grigia. Viene visualizzata una barra dei menu a discesa. Fare clic su Aggiungi per aggiungere una proprietà. Per aggiungere una proprietà secondaria, fare clic con il pulsante destro del mouse sul numero di righe principali e fare clic su Aggiungi secondario.
  2. Immettere un valore per la proprietà o la proprietà secondaria.
    Nota:
    Se la proprietà ha un Tipo di stringa, è possibile selezionare un sottotipo dall'elenco a discesa Sottotipo. Questo sottotipo è utilizzato per una convalida estesa della proprietà.
  3. Per crittografare una proprietà, selezionare la casella Crittografa.
  4. Per ottenere altre informazioni su una proprietà particolare, fare clic con il pulsante sinistro sulla voce nella colonna Descrizione per quella proprietà. Se si ha installata la guida estesa, appare un pulsante. Quando si fa clic sul pulsante, si apre una finestra Guida e vengono visualizzati dettagli della proprietà standard.
    Nota:
    Se il pulsante non appare, non è stata trova trovata nessuna Guida estesa per quella proprietà.
  5. Scegliere se salvare o eliminare le modifiche, come descritto per Impostazione proprietà connettore standard.

Se i file Guida estesa sono installati e la proprietà AdapterHelpName è vuota, Connector Configurator Express punta ai file Guida estesa specifici dell'adattatore in <ProductDir>\bin\Data\App\Help\<RegionalSetting>\. Altrimenti, Connector Configurator Express punta i file specifici dell'adattatore Guida estesa posizionati in <ProductDir>\bin\Data\App\Help\<AdapterHelpName>\<RegionalSetting>\. Consultare la proprietà AdapterHelpName descritta nell'appendice Proprietà standard.

Il valore Metodo aggiornato visualizzato per ciascuna proprietà indica se è necessario riavviare un componente o un agente per attivare i valori modificati.

Importante:
Modificando il nome di una proprietà di connettore di applicazioni specifiche potrebbe causare la non riuscita del connettore. Alcuni nomi di proprietà potrebbero essere necessari al connettore per connettersi ad un'applicazione o per essere eseguito correttamente.

Proprietà specifiche del connettore

Le proprietà di configurazione specifiche dei connettori forniscono informazioni necessarie dal connettore al runtime. Questi forniscono inoltre un modo di modificare le informazioni statiche o logiche nel connettore senza dover ricodificare e ricreare il connettore.

La tabella 6 elenca le proprietà di configurazione specifiche del connettore per il connettore. Vedere le sezioni che seguono per spiegazioni delle proprietà.

Tabella 6. Proprietà di configurazione specifiche del connettore
Nome Valori possibili Valore predefinito Obbligatorio?
ArchivingEnabled true oppure false
Vero
EventLog Nome e posizione del file
event.log
No
EventRecovery arresta o riprova
riprova
FTPPollFrequency numero di cicli di poll
No
GenerateTemplate BOName
No
OutputLog File che registra il numero di sequenza successiva per ogni oggetto business in entrata durante l'elaborazione della richiesta
Output.Log
No
PollQuantity Numero di eventi elaborati
a ogni poll
25
No
SortFilesOnTimestamp true oppure false Falso No
NoPoll true oppure false Falso No
ArchivingEnabled

Attiva l'archiviazione. Se questa proprietà è impostato su true, il file di evento viene archiviato nella directory di archivio con l'estensione specificata. Se la proprietà viene impostata su false, il file di evento non è archiviata. In questo caso, il connettore elimina il file dopo aver inviato tutti gli eventi al broker di integrazione. Per ulteriori informazioni, consultare Specifica dell'archivio di evento.

Il valore predefinito è true.

EventLog

Fornisce ubicazione di memorizzazione file per gli eventi generati dal connettore. Questo file si trova nella sottodirectory JText nella directory connectors dove è installato il prodotto.

Il valore predefinito è event.log.

EventRecovery

Specifica il funzionamento di recupero. Se questa proprietà è impostata su riprova, il connettore utilizza il file event.log per recuperare gli eventi con errori. Se questa proprietà è impostata su arresta, il connettore termina quando si rileva un evento non riuscito. Per ulteriori informazioni, consultare File log di evento.

Il valore predefinito è riprova.

FTPPollFrequency

Determina quanto frequentemente il connettore esegue il poll di un server FTP misurato nel numero di cicli di poll standard. Ad esempio, se la proprietà di configurazione standard PollFrequency è impostata su 10000, e FTPPollFrequency è impostato su 6, il connettore esegue il poll della directory eventi locale ogni 10 secondi e della directory remota ogni 60 secondi. Il connettore esegue il poll del FTP solo se si specifica un valore per questa proprietà. Se FTPPollFrequency valuta 0 o vuoto, il connettore non esegue il poll di FTP. Per impostazione predefinita non lo fa.

Non c'è un valore predefinito per questa proprietà.

GenerateTemplate

Abilita il connettore a generare una maschera per ogni oggetto business supportato dopo l'avvio del connettore. La sintassi per questa proprietà è BOName;BOName dove il nome di un oggetto business specifico viene sostituito per BOName. Ad esempio, per generare due maschere, una per un oggetto business Customer e uno per un oggetto business Item, specificare Customer;Item. Per ulteriori informazioni, consultare Generazione degli oggetti business di esempio per la verifica.

Non c'è un valore predefinito per questa proprietà.

OutputLog

Specifica il nome del file che memorizza il numero della sequenza che il connettore utilizza per creare file di output singoli per ogni tipo di oggetto business durante l'elaborazione della richiesta. Il formato del file è:

BusinessObjectName = NextSequenceNumber

dove BusinessObjectName è il nome dell'oggetto business di richiesta e NextSequenceNumber rappresenta il numero di sequenza dell'oggetto business ricevuto più di recente, incrementato di uno. Ad esempio, se il connettore sta elaborando oggetti business Customer e Item, il file di log di output potrebbe contenere quanto segue:

Customer = 12
 Item = 2

Questo file indica che il connettore ha già elaborato 11 Customer e 1 Item. Il prossimo oggetto business Customer e Item sarà scritto nei file Customer_12.out e Item_2.out, rispettivamente. Quando riceve un oggetto business Order di richiesta, il connettore aggiunge una nuova riga al file di log di emissione e scrive l'oggetto business al file Order_1.out.

Se il metaoggetto FileSeqEnabled è impostato su true, il connettore utilizza questo numero di sequenza per nominare unicamente i file di emissione che crea per ogni oggetto business. Il connettore denomina ogni file di emissione facendo seguire un trattino basso (_) ed il numero di sequenza al nome dell'oggetto business o ad un file il cui nome è specificato nell'attributo del metaoggetto OutputFileName. Poiché il log di emissione viene archiviato nel formato lettura utente, è possibile utilizzare un editor di testo standard per leggere il file o per impostare il suo valore.

Per ulteriori informazioni sull'attributo OutputFileName, consultare Specifica del nome del file di output. Per ulteriori informazioni sul log si emissione, consultare Specifica l'elaborazione della richiesta. Per ulteriori informazioni sulla restituzione del nome del file generato, consultare Restituzione del nome file.

Il valore predefinito è Output.Log.

PollQuantity

Specifica il numero di eventi da elaborare per ogni poll. Il metodo del poll del connettore richiama il numero specificato si record di eventi e li elabora in un singolo poll. L'elaborazione di più eventi per poll può migliorare la prestazione quando l'applicazione genera grandi numeri di eventi. Tuttavia, poiché le richieste del broker di integrazione sono bloccate mentre il metodo del polli sta elaborando gli eventi, non impostare gli eventi su un numero troppo alto. Se ogni chiamata di poll impiega molto tempo, questa ritarda le operazioni di richiesta del broker di integrazione. Per ulteriori informazioni, consultare Regolazione delle prestazioni del connettore JText.

Il valore predefinito è 25.

SortFilesOnTimestamp

Consente all'adattatore di prendere i file di evento in base alla data/ora. Questa proprietà è idealmente impostata su true quando ci sono solo pochi grossi file di evento presi dall'adattatore durante il poll. Quando ci sono molti piccoli file di evento, questo valore dovrebbe essere impostato su false per evitare il tempo eccessivo impiegato per ordinare i file ad ogni poll.

Il valore predefinito è False.

Nota:
L'ordinamento in base alla data/ora è supportato solo sulle piattaforme Windows, i5/OS, e Linux. L'ordinamento in base alla data/ora non è supportato sulle piattaforme MVS. Inoltre, l'adattatore JText può eseguire il poll dei file remoti sulla data/ora dal sito FTP solo se il server FTP supporta il comando mdtm (modifica data e ora).
NoPoll

Se questa proprietà è impostata su true, allora l'adattatore non esegue l'elaborazione dell'evento e l'adattatore può essere solo utilizzato per l'elaborazione della richiesta.

Il valore predefinito è False.

Crittografia delle proprietà del connettore

Le proprietà specifiche dell'applicazione possono essere crittografate selezionando la casella di controllo Crittografa nella finestra Proprietà specifiche del connettore. Per decrittografare un valore, fare clic per eliminare i valori dalla casella di controllo Crittografa ed immettere il valore corretto nella casella di dialogo Verifica e fare clic su OK. Se il valore immesso è corretto, il valore viene decriptato e viene visualizzato.

Nella guida per l'utente dell'adattatore per ciascun connettore è presente un elenco e la descrizione di ciascuna proprietà del relativo valore predefinito.

Se per una proprietà esistono più valori, verrà visualizzata la casella di controllo Crittografa per il primo valore della proprietà. Quando si seleziona Crittografa, tutti i valori verranno crittografati. Per decrittografare più valori di una proprietà, fare clic per fare clic per eliminare i valori dalla casella di controllo Codifica e quindi immettere un nuovo valore nella casella di controllo Verifica. Se il valore immesso corrisponde, tutti i valori multipli verranno decriptati.

Metodo aggiornato

Fare riferimento alle descrizioni dei metodi di aggiornamento individuati nell'appendice Proprietà standard.

Specifica di definizioni di oggetti di business supportati

Utilizzare la scheda Oggetti di business supportati in Connector Configurator Express per specificare gli oggetti di business che il connettore utilizzare. Occorre specificare gli oggetti di business generici e quelli specifici delle applicazioni ed occorre specificare le associazioni per le mappe tra oggetti di business.

Nota:
Per alcuni connettori è necessario che determinati oggetti di business siano specificati come supportati, per eseguire notifiche di eventi o configurazioni aggiuntive (utilizzando meta oggetti) con le relative applicazioni.

InterChange Server Express come broker

Per specificare che una definizione di oggetto di business sia supportata dal connettore oppure modificare le impostazioni di supporto per una definizione di oggetto di business esistente, fare clic sulla scheda Oggetti di business supportati ed utilizzare i seguenti campi.

Nome oggetto di business

Per designare che una definizione di un oggetto di business sia supportata dal connettore, con System Manager in esecuzione, effettuare le seguenti operazioni:

  1. Fare clic in un campo vuoto nell'elenco Nome oggetto di business. Viene visualizzato un elenco a discesa contenente tutte le definizione di oggetti di business che esistono nel progetto di System Manager.
  2. Fare clic su un oggetto di business per aggiungerlo.
  3. Impostare Supporto agente (descritto qui di seguito) per l'oggetto di business.
  4. Nel menu File della finestra Connector Configurator Express, fare clic su Salva in progetto. La definizione del connettore modificata, compreso il supporto designato per la definizione dell'oggetto di business aggiunto, viene salvata in un progetto ICL (Integration Component Library) in System Manager.

Per eliminare un oggetto di business dall'elenco supportato:

  1. Per selezionare un campo di oggetto di business, fare clic sul numero a sinistra dell'oggetto di business.
  2. Dal menu Modifica la finestra Connector Configurator Express, fare clic su Elimina riga. L'oggetto di business viene eliminato dalla visualizzazione dell'elenco.
  3. Dal menu File, fare clic su Salva in progetto.

Eliminando l'oggetto di business dall'elenco supportato viene modificata la definizione di connettore e rende l'oggetto di business eliminato non disponibile all'utilizzo in questa implementazione del connettore. Il codice di connessione né viene influenzato né elimina la definizione dell'oggetto di business da System Manager.

Sopporto agente

Se un oggetto di business ha un Supporto agente, il sistema cercherà utilizzare l'oggetto di business per la distribuzione di dati per un'applicazione tramite un agente connettore.

Tipicamente, vengono supportati oggetti di business per un connettore dall'agente del connettore, ma non gli oggetti di business generico.

Per indicare che l'oggetto di business viene supportato dall'agente del connettore, verificare la casella Supporto agente. La finestra Connector Configurator Express non convalida le selezioni Supporto agente.

Livello di transazione massimo

Il livello della transazione massima per un connettore è il livello di transazione più elevata che supporta connettori.

Per ulteriori connettori, Massimo sforzo è l'unica scelta possibile.

Occorre il server per le modifiche nel livello delle transazioni perché abbiano effetto.

Mappe associate per InterChange Server Express

Ciascun connettore supporta un elenco di definizioni di oggetti business e le relative mappe associate che sono al momento attive in InterChange Server Express. Questo elenco viene visualizzato quando si seleziona la scheda Mappe associate.

L'elenco degli oggetti di business contiene l'oggetto di business specifico dell'applicazione supportato dall'agente e l'oggetto generico corrispondente che il controllore invia alla collaborazione di sottoscrizione. L'associazione di una mappa determina quale mappa verrà utilizzata per trasformare l'oggetto di business specifico dell'applicazione per l'oggetto di business specifico per l'oggetto di business specifico dell'applicazione.

Se si stanno utilizzando mappe definite in modo univoco per oggetti di business di origine e destinazione specifici, le mappe verranno già associate ai relativi oggetti di business appropriati quando si apre la finestra e non occorrerà modificarli.

Se più di una mappa è disponibile per essere utilizzata da un oggetto di business supportato, occorrerà associare l'oggetto di business con la mappa da utilizzare.

La scheda Mappe associate visualizza i seguenti campi:

Risorse per InterChange Server Express

La scheda Risorse consente di impostare un valore che determina se e in che misura l'agente del connettore gestirà più processi contemporaneamente, utilizzando il parallelismo di agenti del connettore.

Non tutti connettori supportano questa funzione. Se si sta eseguendo un agente connettore che è stato creato in Java per essere multithreading, si viene informati di non utilizzare questa funzione, poiché di solito è più efficiente utilizzare più thread che processi multipli.

Messaggistica per InterChange Server Express

La scheda Messaggistica consente di configurare le proprietà di messaggistica. Le proprietà di messaggistica sono disponibili solo se JMS è stato impostato come valore della proprietà standard DeliveryTransport e InterChange Server Express come tipo broker. Tali proprietà influenzano su come il connettore utilizzerà le code.

Convalida delle code di messaggistica

Prima di poter convalidare una coda di messaggistica, è necessario:

Per convalidare la coda, utilizzare il pulsante Convalida a destra dei campi tipo di messaggistica e Nome host sulla scheda Messaggistica.

Sicurezza per InterChange Server Express

È possibile utilizzare la scheda Sicurezza in Connector Configurator Express per ottenere diversi livelli di protezione per un messaggio. È possibile utilizzare questa funzione solo quando la proprietà DeliveryTransport è impostata su JMS.

Per impostazione predefinita, la Riservatezza viene attivata. Selezionare la casella Riservatezza per abilitarla.

Il Nome percorso assoluto del sistema di destinazione keystore è:

Questo percorso e questo file dovrebbero essere sul sistema dove si pensa di avviare il connettore, cioè, il sistema di destinazione.

È possibile utilizzare il pulsante Sfoglia alla destra solo se il sistema di destinazione è quello al momento in esecuzione. Diventa grigio a meno che Riservatezza non viene abilitata e il Sistema di destinazione nella barra del menu viene impostato su Windows.

Il Livello di protezione del messaggio potrebbe essere impostato nel modo seguente per le tre categorie di messaggi (Tutti i messaggi, Tutti i messaggi amministrativi e Tutti i messaggi di oggetto business):

La funzione Manutenzione chiave consente di generare, importare ed esportare le chiavi pubbliche per il server e l'adattatore.

Prima di poter importare un certificato nel keystore dell'adattatore, è necessario esportarlo dal keystore del server. quando si seleziona Esporta chiave pubblica adattatore, appare la casella di dialogo Esporta chiave pubblica adattatore.

Quando si seleziona Importa chiave pubblica del server, appare la casella di dialogo Importa chiave pubblica del server.

La funzione Controllo accesso adattatore viene abilitata solo quando il valore di DeliveryTransport è IDL. Per impostazione predefinita, l'adattatore accede con l'identità ospite. Se la casella Utilizza identità ospite non viene selezionata, i campi Identità adattatore e Password adattatore sono abilitati.

Impostazione dei valori dei file di traccia/log

Quando si apre un file di configurazione del connettore o un file di definizione del connettore, Connector Configurator Express utilizza i valori di registrazione e di traccia di quel file come valori predefiniti. È possibile modificare tali valori in Connector Configurator Express.

Per modificare i valori di traccia e di log:

  1. Fare clic sulla scheda File di traccia/log.
  2. Per la traccia o il log, è possibile scegliere di scrivere messaggi in:

Gestori dati

La sezione relativa ai gestori dati è disponibile per la configurazione solo se si è designato un valore JMS per DeliveryTransport e un valore JMS per ContainerManagedEvents. Non tutti gli adattatori utilizzano i gestori dati.

Consultare le descrizioni in ContainerManagedEvents nell'Appendice A, Proprietà standard, per valori da utilizzare per tali proprietà.

Copyright IBM Corp. 2004, 2005