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:
Per connettori che vengono eseguiti su InterChange Server Express, sono anche richiesti i valori per queste proprietà.
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:
Per modificare il valore di una proprietà standard:
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.
Se installati, i file Guida estesa si trovano nella directory <ProductDir>\bin\Data\Std\Help\<RegionalSetting>\.
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.
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.
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à.
Nome | Valori possibili | Valore predefinito | Obbligatorio? |
---|---|---|---|
ArchivingEnabled | true oppure false |
Vero |
Sì |
EventLog | Nome e posizione del file |
event.log |
No |
EventRecovery | arresta o riprova |
riprova |
Sì |
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 |
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.
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.
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.
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à.
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à.
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.
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.
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.
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.
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.
Fare riferimento alle descrizioni dei metodi di aggiornamento individuati nell'appendice Proprietà standard.
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.
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.
Per designare che una definizione di un oggetto di business sia supportata dal connettore, con System Manager in esecuzione, effettuare le seguenti operazioni:
Per eliminare un oggetto di business dall'elenco supportato:
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.
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.
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.
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:
Questi sono gli oggetti di business supportati da questo connettore, come designato nella scheda Oggetti di business supportato. Se si designano oggetti di business aggiuntivi nella scheda Oggetti di business supportati, ciò sia riflette in questo elenco dopo aver salvato le modifiche selezionando Salva in progetto dal menu File della finestra Connector Configurator Express.
La finestra visualizza tutte le mappe installate nel sistema da utilizzare con gli oggetti di business supportati del connettore. L'oggetto di business origine per ciascuna mappa viene visualizzato a sinistra del nome mappa, nella finestra Nome oggetto di business.
In alcuni casi, occorre eseguire il bind in modo esplicito con una mappa associata.
Il bind esplicito è necessario solo quando esistono più mappe per un oggetto di business supportato particolare. Quando InterChange Server Express viene avviato, cerca di eseguire il bind automaticamente con una mappa per ciascun oggetto di business supportato per ciascun connettore. Se più mappe prendono come input lo stesso oggetto di business, il server cerca di individuare ed eseguire il bind con la mappa che è il soprainsieme delle altre.
Se non esiste una mappa che è il soprainsieme delle altre, il server non dovrà eseguire il bind con l'oggetto di business ad una singola mappa e occorrerà impostare il bind in modo esplicito.
Per eseguire il bind in modo esplicito, effettuare le seguenti operazioni:
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.
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.
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.
È 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.
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:
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à.