Configurazione dell'adattatore BizTalk per applicazioni host

La finestra di dialogo Configurazione applicazione host dell'adapter BizTalk consente di definire e gestire 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 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 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 di DataGrid

Creare e gestire mapping

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 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 su stringa di connessione per visualizzarla in modalità di modifica. La chiave DELETE elimina l'elemento attualmente selezionato e la chiave F1 apre la Guida online.

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

• Aggiungere un assembly .NET TI 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. Il stringa di connessione predefinito non sarà utilizzabile se non si immettono i valori richiesti.

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

• Modificare la parte stringa di connessione del mapping quando viene selezionato un mapping. Avviare la finestra di dialogo Stringa di connessione per modificare il 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 Configurazione applicazione host dell'adapter BizTalk . È anche possibile importare le definizioni RE esportate da TI Manager quando viene 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 quando si trova un mapping. Tutte le proprietà sono di sola lettura.

Finestra Mapping di 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 interfaccia dell'assembly TI usato come parte del mapping.

• Nome assembly . Nome sicuro 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.

• Ambiente remoto definisce il stringa di connessione. Rappresenta le caratteristiche di un sistema remoto che riceve le richieste dall'adapter dell'applicazione Host BizTalk. Il stringa di connessione è costituito dal tipo di ambiente remoto, dal modello di programmazione, dall'identificazione dell'host remoto, dal trasporto di rete e da altre impostazioni usate 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 stringa di connessione del mapping attualmente selezionato.

Creare e gestire mapping

Questa sezione descrive le attività che è possibile eseguire.

Aggiungere assembly per creare stringa di connessione

Sulla barra degli strumenti fare clic sull'icona della cartella e quindi selezionare Aggiungi assembly da GAC o Aggiungi assembly locale. L'aggiunta di 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 in locale.

Gli assembly possono essere aggiunti anche tramite l'aggiunta di gac o l'aggiunta di opzioni di assembly locali dal menu.

Eliminare una stringa di connessione

Selezionare il mapping o i mapping 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 popolata 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 il 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 della 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 della stringa di connessione di questo argomento. La convalida RE è limitata nell'ambito e i valori non appropriati 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 visualizzato il stringa di connessione creato 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 usando le sostituzioni in fase di esecuzione.

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

  Il flag Off è esclusivo per Client, Package e User. Disattivato verrà cancellato quando vengono controllati gli altri tre. Quando disattivato viene selezionato, tutte le altre tre opzioni verranno cancellate.

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

Impostazioni e mapping 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 dei socket di sistema

*Campo obbligatorio.

Mapping di importazione

Per importare mapping esportati dall'adapter BizTalk per la configurazione dell'applicazione host, fare clic sull'icona Importa mapping o RES . Selezionare Importa mapping o selezionare Importa mapping dal menu File . È quindi possibile cercare il codice XML esportato dalla finestra di dialogo Configurazione applicazione host BizTalk Adapter for Host . 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 viene selezionato un mapping, fare clic sull'icona Importa mapping o RES . Selezionare Importa REs o selezionare Importa 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.

Mapping di esportazione

Per esportare mapping a un file XML, fare clic sul mapping Esporta nell'icona 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 mapping .

Proprietà dell'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.

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 il re predefinito è stato usato 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 GESTIONE TI. Importare la configurazione usando la finestra di dialogo Stringhe di connessione .

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

• L'override re tramite BizTalk Server Amministrazione non è supportata. 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 gestione TI 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 stia eseguendo 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, le informazioni host necessarie per il runtime TI possono essere specificate subito prima che il metodo venga richiamato, purché le informazioni di connessione host siano note. 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 un stringa di connessione analizzato e impostato su OGGETTO RE creato in fase di esecuzione. È possibile specificare informazioni su re quando la porta che ospita l'adattatore dell'applicazione host è configurata. Viene archiviato come parte delle informazioni di configurazione della porta gestite dalla struttura di amministrazione BizTalk. Con questo approccio, l'uso di BAHA per integrare l'applicazione .NET con le applicazioni host, è sufficiente usare Designer TI per creare gli assembly client TI .NET. Tutte le altre attività possono essere eseguite in BizTalk Server.

La tabella seguente descrive i menu e le azioni della barra degli strumenti.

Vedere anche

Adattatore BizTalk per applicazioni host