Configurazione dell'adapter BizTalk per le applicazioni host

La finestra di dialogo Configurazione applicazione Host Adapter BizTalk consente di definire e gestire le connessioni a sistemi IBM CICS, IMS o iSeries remoti. Viene avviato quando si fa clic sul campo valore della proprietà Stringhe di connessione . È possibile usare la finestra di dialogo Configurazione dell'applicazione host dell'adapter BizTalk per aggiungere un assembly TI .NET. È possibile usarlo come parte del mapping, per importare, esportare ed eliminare mapping, modificare le stringhe di connessione e visualizzare le proprietà di un assembly TI .NET.

I componenti della finestra di dialogo Configurazione applicazione host includono una barra degli strumenti, un menu, una griglia di dati e un riquadro dei risultati. Questo argomento contiene le sezioni seguenti che descrivono le varie attività che è possibile eseguire.

Comandi barra degli strumenti e menu

Finestra Mapping DataGrid

Creare e gestire le mappature

Impostazioni e mapping delle stringhe di connessione

Eseguire l'aggiornamento da versioni precedenti di Host Integration Server

Comandi barra degli strumenti e menu

È possibile accedere ai comandi che creano e gestiscono le stringhe di connessione tramite le barre degli strumenti e i menu sensibili al contesto. È possibile fare clic con il pulsante destro del mouse in un punto qualsiasi della griglia dati per visualizzare i menu sensibili al contesto. Ad esempio, quando si fa clic con il pulsante destro del mouse su una stringa di connessione, è possibile visualizzare, modificare, eliminare, importare ed esportare mapping. È possibile fare doppio clic sulla stringa di connessione per visualizzarla in modalità di modifica. La chiave DELETE elimina l'elemento attualmente selezionato e il tasto F1 apre la Guida online.

L'elenco seguente descrive le azioni che è possibile eseguire:

• Aggiungere un assembly TI .NET dalla Global Assembly Cache (GAC) o usando il percorso del file locale per aggiungere un assembly al mapping. Le colonne vengono popolate con i valori predefiniti riflessi dall'assembly. La stringa di connessione predefinita non sarà utilizzabile se non si immettono i valori necessari.

• Eliminare i mapping selezionati. Verrà visualizzata una finestra di dialogo per confermare l'eliminazione.

• Modifica la parte della stringa di connessione relativa al mapping quando viene selezionato un mapping. Avviare la finestra di dialogo Stringa di connessione per modificare la stringa di connessione.

• L'esportazione dei mapping in XML consente di eseguire il backup dei mapping. È possibile ripristinarli in un secondo momento usando la funzionalità di mapping di importazione. Le funzionalità di importazione/esportazione consentono di condividere i mapping tra gli endpoint.

• L'importazione di mapping o REs consente di importare XML esportato dalla finestra di dialogo della Configurazione dell'applicazione host dell'adattatore BizTalk. È anche possibile importare le definizioni RE esportate da TI Manager quando è selezionato un mapping.

• Le proprietà di visualizzazione dell'assembly TI .NET visualizzano le proprietà dell'assembly. Il tag XML visualizza il nome del documento di input/output supportato dall'assembly. Il nome del metodo fa parte del nome del tag, ma non viene usato durante la ricerca di un mapping. Tutte le proprietà sono di sola lettura.

Finestra di Mapping DataGrid

La finestra di dialogo Mapping DataGrid contiene gli elementi seguenti:

• Stato (completo o incompleto). Se la stringa di connessione non contiene informazioni di connessione, viene visualizzato un avviso indicato da un cerchio rosso con un punto esclamativo bianco. Dopo l'aggiunta delle informazioni mancanti, l'avviso scompare.

• ClassName e Nome dell'interfaccia dell'assembly TI usato come parte del mapping.

• Nome dell'assembly. Il nome forte dell'assembly se l'assembly viene caricato dalla GAC o il percorso completo dell'assembly se si tratta di un assembly locale. Questo campo viene compilato automaticamente quando viene aggiunto un assembly ed è di sola lettura.

• Remote Environment definisce la stringa di connessione. Rappresenta le caratteristiche di un sistema remoto che riceve le richieste dall'adapter dell'applicazione Host BizTalk. La stringa di connessione è costituita dal tipo di ambiente remoto, dal modello di programmazione, dall'identificazione host remota, dal trasporto di rete e da altre impostazioni utilizzate durante la comunicazione con l'host remoto.

• Endpoint remoto Nome DNS o indirizzo IP dell'host IBM remoto.

• Nel riquadro dei risultati vengono visualizzati i valori per la stringa di connessione del mapping attualmente selezionato.

Creare e gestire mappature

Questa sezione descrive le attività che è possibile eseguire.

Aggiungi assembly per creare una stringa di connessione

Sulla barra degli strumenti fare clic sull'icona della cartella e quindi selezionare Aggiungi assembly da GAC o Aggiungi assembly locale. Aggiungi assembly dalla GAC avvierà una finestra di dialogo che elenca tutti gli assembly nella GAC che è possibile selezionare. Se si seleziona Aggiungi assembly locale, è possibile esplorare gli assembly installati localmente.

Gli assembly possono essere aggiunti anche tramite le opzioni Aggiungi al GAC o Aggiungi assembly locale dal menu.

Eliminare una stringa di connessione

Selezionare la mappatura o le mappature da eliminare. Fare clic sull'icona [X] sulla barra degli strumenti per eliminare i mapping selezionati. Viene visualizzata una finestra di dialogo in modo da poter confermare l'eliminazione.

È anche possibile eliminare i mapping usando l'opzione Elimina mapping dal menu.

Modifica stringa di connessione

• La stringa di connessione viene usata per idratare l'istanza RE. Viene popolato con valori predefiniti quando viene specificato un assembly. Fare doppio clic sul mapping selezionato, selezionare Modifica oppure selezionare il menu Modifica stringa di connessione per avviare la finestra di dialogo Stringa di connessione. In questo modo è possibile modificare la stringa di connessione per il RE specificato. Se i valori obbligatori non vengono immessi, verrà visualizzato un flag di errore.

• L'oggetto RE convalida i valori minimi obbligatori delle proprietà. La cella Stringa di connessione verrà contrassegnata se i valori delle proprietà obbligatori non sono impostati. Le proprietà obbligatorie sono elencate nella sezione Impostazioni e mapping delle stringhe di connessione di questo argomento. La convalida RE è di portata limitata e valori inappropriati potrebbero causare errori di runtime TI.

• Nella finestra di dialogo vengono visualizzate proprietà modificabili e non modificabili in una griglia. Nella casella di testo di sola lettura nella parte inferiore viene visualizzata la stringa di connessione creata in base ai valori immessi nella griglia delle proprietà. Le proprietà vengono raccolte in base ai metodi pubblici definiti dall'oggetto RE, con valori definiti dall'oggetto stesso. Alcuni convertitori di tipi e editor di proprietà vengono forniti per facilitare la modifica dei valori delle proprietà.

• L'ambiente remoto visualizza le proprietà necessarie per connettersi all'host. Tali valori sono indicati da un asterisco (*) nella griglia delle proprietà. Se mancano una o più proprietà, viene visualizzato un cerchio rosso con un punto esclamativo bianco nella griglia Dati. Questo avviso notifica che le proprietà mancanti possono essere fornite tramite override in fase di esecuzione.

• Le impostazioni di sicurezza sono controllate da enumerazioni di sicurezza predefinite che possono essere combinate usando l'operatore OR per formare nuove impostazioni di sicurezza.

  Il flag Off è esclusivo per Client, Package e User. Disattivato sarà disattivato quando uno qualsiasi degli altri tre verrà selezionato. Quando disattivato viene selezionato, tutte le altre tre opzioni verranno cancellate.

  L'editor SSOApplication è stato portato da una versione precedente con lievi modifiche. È possibile specificare un'applicazione affiliata direttamente nella griglia delle proprietà oppure usare l'editor per selezionarne uno già creato.

Impostazioni e associazioni delle stringhe di connessione

Nelle tabelle seguenti vengono visualizzate le proprietà supportate che definiscono l'ambiente host e il modello di programmazione. Gli asterischi indicano le proprietà obbligatorie.

I valori predefiniti vengono impostati dagli oggetti RE stessi e viene eseguita una convalida limitata.

Dati utente SNA

*Campo obbligatorio.

Collegamento SNA

*Campo obbligatorio.

Dati utente HTTP

*Campo obbligatorio.

Collegamento HTTP

*Campo obbligatorio.

IMS LU6.2

*Campo obbligatorio.

IMS Connect

*Campo obbligatorio.

TRM User Data/Link

*Campo obbligatorio.

Dati utente/collegamento ELM

*Campo obbligatorio.

Chiamata al programma distribuito

*Campo obbligatorio.

System Z Sockets User Data/Link

*Campo obbligatorio.

Dati utente di System I socket

*Campo obbligatorio.

Importa mappature

Per importare i mapping esportati dall'adapter BizTalk per la configurazione dell'applicazione host, fare clic sull'icona Importa mapping o REs . Selezionare Importa mapping, oppure selezionare Importa mapping dal menu File. È quindi possibile cercare il codice XML esportato dalla finestra di dialogo Configurazione applicazione host dell'adapter BizTalk. Selezionare il file da importare. Il processo di importazione non sovrascriverà i mapping esistenti.

Importare la definizione RE

Usare questa opzione per importare le definizioni RE esportate da TI Manager. Quando si seleziona un mapping, fare clic sull'icona Importa mapping o RES . Selezionare Import REs o Import REs dal menu File. È quindi possibile cercare il codice XML esportato da TI Manager. Verrà visualizzata una finestra di dialogo che elenca le definizioni RE che è possibile selezionare. Verranno visualizzate solo le definizioni RE con lo stesso modello di programma del mapping selezionato.

Esportazione dei mapping

Per esportare i mapping in un file XML, fare clic sull'icona Esporta mapping in XML oppure selezionare Esporta mapping dal menu File . È quindi possibile passare al percorso in cui è possibile salvare il file. È possibile importare questo file usando la funzionalità Importa mappatura.

Proprietà Assembly

È possibile visualizzare le proprietà pertinenti dell'assembly, nonché il nome del tag XML del documento di input/output supportato dall'assembly. Il nome del metodo fa parte del nome del tag, ma non viene usato durante la ricerca di un mapping. Tutte le proprietà sono di sola lettura. Selezionare il mapping e quindi fare clic sull'icona delle proprietà dell'assembly oppure selezionare Mostra proprietà dell'assembly dal menu.

Eseguire l'aggiornamento da versioni precedenti di Host Integration Server

Questa sezione descrive come eseguire la migrazione di applicazioni BAHA esistenti per usare la stringa di connessione:

• Se è stato usato RE predefinito in BAHA, esportare la configurazione usando TI Manager e quindi importare la configurazione usando la finestra di dialogo Stringhe di connessione .

• Se è stato usato re non predefinito, associare l'oggetto di distribuzione al nuovo RE in TI Manager ed esportare la configurazione in TI Manager. Importare la configurazione usando la finestra di dialogo Stringhe di connessione .

• Non è possibile cambiare REs in Amministrazione BizTalk Server senza usare la stringa di connessione perché la finestra di dialogo Tipo host è stata rimossa.

• L'override RE tramite l'amministrazione di BizTalk Server non è supportato. Anche se è possibile usare il contesto del messaggio per ottenere l'override RE, non è consigliabile. È consigliabile usare le stringhe di connessione.

• Se viene specificata un'applicazione SSO non predefinita, è possibile usare ti manager per associare re all'applicazione SSO non predefinita e continuare a usare re statico. In alternativa, è possibile specificarlo nella stringa di connessione.

  Importare xml esportato da TI Manager

  Ti Manager non è obbligatorio, a meno che non si esegua una migrazione. È possibile esportare la definizione di oggetti REs e WIP in un file XML, che può essere importato dalla finestra di dialogo Stringhe di connessione .

L'adapter BizTalk per la configurazione dell'applicazione host usa la funzionalità RE dinamica introdotta in Host Integration Server 2009. Con RE dinamico, è possibile specificare le informazioni sull'host necessarie per il runtime TI appena prima che venga invocato il metodo, purché siano note le informazioni sulla connessione host. L'assembly client .NET non deve essere distribuito e associato a un re predefinito in TI Manager prima che i relativi metodi possano essere richiamati.

Per BAHA, le informazioni di connessione possono essere incorporate in una stringa di connessione analizzata e impostata su RE oggetto creato in fase di esecuzione. È possibile specificare le informazioni su un RE durante la configurazione della porta che ospita l'adattatore dell'applicazione host. Viene archiviato come parte delle informazioni di configurazione delle porte gestite dalla funzionalità di amministrazione bizTalk. Con questo approccio, l'uso di BAHA per integrare l'applicazione .NET con le applicazioni host, è sufficiente usare TI Designer per creare gli assembly client TI .NET. Tutte le altre attività possono essere eseguite in BizTalk Server.

Nella tabella seguente vengono descritti i menu e le azioni della barra degli strumenti.

Vedere anche

Adapter BizTalk per applicazioni host