Integrare 3270 app basate sullo schermo in mainframe IBM con Azure usando App per la logica di Azure e il connettore IBM 3270

Si applica a: App per la logica di Azure (consumo + standard)

Per accedere ed eseguire app mainframe IBM, in genere eseguite spostandosi tra le schermate dell'emulatore 3270, dai flussi di lavoro a consumo e standard in App per la logica di Azure, è possibile usare il connettore IBM 3270. In questo modo, è possibile integrare le app IBM mainframe con Azure, Microsoft e altre app, servizi e sistemi creando flussi di lavoro automatizzati con App per la logica di Azure. Il connettore comunica con i mainframe IBM usando il protocollo TN3270. Il connettore IBM 3270 è disponibile in tutte le aree App per la logica di Azure ad eccezione di Azure per enti pubblici e Microsoft Azure gestito da 21Vianet.

Questa guida pratica descrive gli aspetti seguenti relativi al connettore IBM 3270 :

• Perché usare il connettore IBM 3270 in App per la logica di Azure

• In che modo il connettore IBM 3270 esegue app basate sullo schermo 3270

• Prerequisiti e configurazione per l'uso del connettore IBM 3270

• Passaggi per l'aggiunta di azioni del connettore IBM 3270 al flusso di lavoro

Perché usare questo connettore?

Per accedere alle app nei mainframe IBM, in genere si usa un emulatore di terminale 3270, spesso denominato "schermo verde". Questo metodo è un modo testato nel tempo, ma presenta limitazioni. Anche se Host Integration Server (HIS) consente di lavorare direttamente con queste app, talvolta la separazione dello schermo e della logica di business potrebbe non essere possibile. In alternativa, forse non si hanno più informazioni sul funzionamento delle applicazioni host.

Per estendere questi scenari, il connettore IBM 3270 in App per la logica di Azure funziona con lo strumento di progettazione 3270, usato per registrare o "acquisire", le schermate host usate per un'attività specifica, definire il flusso di spostamento per tale attività tramite l'app mainframe e definire i metodi con parametri di input e output per tale attività. Lo strumento di progettazione converte tali informazioni in metadati usati dal connettore 3270 durante l'esecuzione di un'azione nel flusso di lavoro.

Dopo aver generato il file di metadati dallo strumento di progettazione 3270, tale file viene aggiunto come artefatto mappa alla risorsa dell'app per la logica Standard o all'account di integrazione collegato per un'app per la logica a consumo in App per la logica di Azure. In questo modo, il flusso di lavoro può accedere ai metadati dell'app quando si aggiunge un'azione del connettore IBM 3270 . Il connettore legge il file di metadati dalla risorsa dell'app per la logica (Standard) o dall'account di integrazione (consumo), gestisce lo spostamento tra le schermate 3270 e presenta dinamicamente i parametri da usare con il connettore 3270 nel flusso di lavoro. È quindi possibile fornire dati all'applicazione host e il connettore restituisce i risultati al flusso di lavoro. Di conseguenza, è possibile integrare le app legacy con Azure, Microsoft e altre app, servizi e sistemi supportati App per la logica di Azure.

Riferimento tecnico Connessione or

Il connettore IBM 3270 ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.

App per la logica	Ambiente	versione di Connessione ion
Consumo	App per la logica di Azure multi-tenant	Connettore gestito, visualizzato nella finestra di progettazione sotto l'etichetta Enterprise . Questo connettore fornisce solo un'azione singola e nessun trigger. Per altre informazioni, vedere Informazioni di riferimento sul connettore gestito IBM 3270.
Standard	App per la logica di Azure a tenant singolo e ambiente del servizio app v3 (A edizione Standard v3 solo con piani di Windows)	Connettore gestito, visualizzato nella raccolta connettori in Runtime>Condiviso e connettore predefinito basato su provider di servizi, visualizzato nella raccolta connettori in Runtime>in-App. La versione predefinita è diversa nei modi seguenti: - - Il connettore predefinito richiede di caricare il file HIDX nella risorsa dell'app per la logica Standard, non in un account di integrazione. - Il connettore predefinito può connettersi direttamente a un server 3270 e accedere alle reti virtuali di Azure usando un stringa di connessione. - La versione predefinita supporta l'autenticazione server con crittografia TLS (SSL) per i dati in transito, la codifica dei messaggi per il funzionamento e l'integrazione della rete virtuale di Azure. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito IBM 3270 - Informazioni di riferimento sul connettore predefinito IBM 3270

Informazioni di riferimento sul connettore predefinito

La sezione seguente descrive le operazioni per il connettore IBM 3270, che attualmente include solo l'azione seguente:

Eseguire un piano di spostamento

Parametro	Richiesto	Digita	Descrizione
Nome HIDX	Sì	Stringa	Selezionare il file HIDX 3270 da usare.
Nome metodo	Sì	Stringa	Selezionare il metodo nel file HIDX da usare.
Parametri avanzati	No	Variabile	Questo elenco viene visualizzato dopo aver selezionato un metodo in modo che sia possibile aggiungere altri parametri da usare con il metodo selezionato. I parametri disponibili variano in base al file HIDX e al metodo selezionato.

Questa operazione include anche parametri avanzati, visualizzati dopo aver selezionato un metodo, per poter selezionare e usare con il metodo selezionato. Questi parametri variano in base al file HIDX e al metodo selezionato.

Prerequisiti

• Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.

• Accesso al server TN3270 che ospita l'app guidata dallo schermo 3270

• File XML di Host Integration Designer (HIDX) che fornisce i metadati necessari per il connettore IBM 3270 per eseguire l'app guidata dallo schermo 3270.

  Per creare questo file HIDX, scaricare e installare lo strumento di progettazione 3270. L'unico prerequisito è Microsoft .NET Framework 4.8.

  Questo strumento consente di registrare schermate, percorsi di spostamento, metodi e parametri per le attività nell'app aggiunte ed eseguite come azioni del connettore 3270. Lo strumento genera un file XML di Host Integration Designer (HIDX) che fornisce i metadati necessari per il connettore per eseguire l'app guidata dallo schermo 3270.

  Dopo aver scaricato e installato questo strumento, seguire questa procedura per connettersi al server host TN3270, progettare l'artefatto di metadati richiesto e generare il file HIDX.

• La risorsa e il flusso di lavoro dell'app per la logica standard o a consumo in cui si vuole eseguire l'app basata sullo schermo 3270

  Il connettore IBM 3270 non dispone di trigger, quindi usare qualsiasi trigger per avviare il flusso di lavoro, ad esempio il trigger Ricorrenza o il trigger Richiesta. È quindi possibile aggiungere le azioni del connettore 3270.

• Un account di integrazione, necessario in base alla versione del connettore 3270 usata ed è una risorsa di Azure in cui è possibile archiviare centralmente elementi B2B, ad esempio partner commerciali, contratti, mappe, schemi e certificati da usare con azioni specifiche del flusso di lavoro.

  Workflow	Descrizione
  Standard	- 3270 connettore predefinito: caricare il file HIDX nella risorsa dell'app per la logica Standard. - Connettore gestito 3270: caricare il file HIDX nella risorsa dell'app per la logica Standard o nell'account di integrazione collegato.
  Consumo	Connettore gestito 3270: caricare il file HIDX nell'account di integrazione collegato.

  Per altre informazioni, vedere Caricare il file HIDX.

Caricare il file HIDX

Per consentire al flusso di lavoro di usare il file HIDX, seguire questa procedura:

Standard

1. Passare alla cartella in cui è stato salvato il file HIDX e copiare il file.

2. Nella portale di Azure scegliere i passaggi seguenti, in base alla versione del connettore:

   • Connettore 3270 predefinito: caricare il file HIDX nella risorsa dell'app per la logica Standard.

   • Connettore gestito 3279:

     • Caricare il file HIDX in un account di integrazione collegato. Assicurarsi di selezionare HIDX come tipo di mappa.

     • Caricare il file HIDX nella risorsa dell'app per la logica Standard.

3. Aggiungere ora un'azione IBM 3270 al flusso di lavoro.

Consumo

1. Passare alla cartella in cui è stato salvato il file HIDX e copiare il file.

2. Nella portale di Azure caricare il file HIDX come artefatto mappa nell'account di integrazione collegato. Assicurarsi di selezionare HIDX come tipo di mappa.

3. Aggiungere ora un'azione IBM 3270 al flusso di lavoro.

Più avanti in questa guida, quando si aggiunge un'azione del connettore IBM 3270 al flusso di lavoro per la prima volta, viene richiesto di creare una connessione tra il flusso di lavoro e il sistema mainframe. Dopo aver creato la connessione, è possibile selezionare il file HIDX aggiunto in precedenza, il metodo da eseguire e i parametri da usare.

Aggiungere un'azione IBM 3270

Un flusso di lavoro di app per la logica Standard può usare il connettore gestito IBM 3270 e il connettore predefinito IBM 3270. Tuttavia, un flusso di lavoro dell'app per la logica a consumo può usare solo il connettore gestito IBM 3270. Ogni versione ha azioni diverse. In base al fatto che si disponga di un flusso di lavoro di app per la logica a consumo o standard, seguire la procedura corrispondente:

Standard

1. Nella portale di Azure aprire la risorsa dell'app per la logica Standard e il flusso di lavoro in cui è già stato aggiunto un trigger.

2. Se non è già stato aggiunto un trigger, seguire questa procedura generale per aggiungere il trigger desiderato al flusso di lavoro.

   Questo esempio continua con il trigger Request denominato Quando viene ricevuta una richiesta HTTP.

3. Seguire questi passaggi generali per aggiungere l'azione connettore predefinita IBM 3270 denominata Esegui un piano di spostamento.

4. Quando viene visualizzata la casella delle informazioni di connessione, specificare i valori dei parametri necessari seguenti:

   Proprietà	Richiesto	Valore	Descrizione
   Nome connessione	Sì	<nome connessione>	Nome della connessione
   Tabella codici	No	<tabella codici>	Numero della tabella codici per l'host da utilizzare per la conversione del testo. Se lasciato vuoto, il connettore usa 37 come valore predefinito.
   Tipo di dispositivo	No	<IBM-terminal-model>	Nome o numero del modello per il terminale IBM da emulare. Se lasciato vuoto, il connettore usa i valori predefiniti.
   Schermate delle eccezioni del log	No	Vero o falso	Registrare la schermata host se si verifica un errore durante lo spostamento dello schermo.
   Nome unità logica	No	<logical-unit-name>	Nome dell'unità logica specifica da richiedere dall'host
   Numero di porta	No	<TN3270-server-port>	Porta usata dal server TN3270. Se lasciato vuoto, il connettore usa 23 come valore predefinito.
   Server	Sì	<TN3270-server-name>	Nome del server per il servizio TN3270
   Timeout	No	<timeout-seconds>	Durata del timeout in secondi durante l'attesa delle schermate
   Usare TLS	No	Attivato o disattivato	Attivare o disattivare la crittografia TLS.
   Convalidare il certificato del server TN3270	No	Attivato o disattivato	Attivare o disattivare la convalida per il certificato del server.

   Ad esempio:

   

5. Al termine, selezionare Crea nuovo.

6. Quando viene visualizzata la casella delle informazioni sull'azione, specificare i valori dei parametri necessari:

   Proprietà	Richiesto	Valore	Descrizione
   Nome HIDX	Sì	<HIDX-file-name>	Selezionare il file HIDX 3270 da usare.
   Nome metodo	Sì	<method-name>	Selezionare il metodo nel file HIDX da usare. Dopo aver selezionato un metodo, viene visualizzato l'elenco Aggiungi nuovo parametro in modo da poter selezionare i parametri da usare con tale metodo.
   Parametri avanzati	No	Variabile	Questo elenco viene visualizzato dopo aver selezionato un metodo in modo che sia possibile aggiungere altri parametri da usare con il metodo selezionato. I parametri disponibili variano in base al file HIDX e al metodo selezionato.

   Ad esempio:

   Selezionare il file HIDX

   

   Selezionare il metodo

   

   Selezionare i parametri

   

7. Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Consumo

1. Nella portale di Azure aprire la risorsa dell'app per la logica a consumo e il flusso di lavoro in cui è già stato aggiunto un trigger.

2. Se non è già stato aggiunto un trigger, seguire questa procedura generale per aggiungere il trigger desiderato al flusso di lavoro.

   Questo esempio continua con il trigger Request denominato Quando viene ricevuta una richiesta HTTP.

3. Seguire questi passaggi generali per aggiungere l'azione del connettore gestito IBM 3270 denominata Esegui un programma mainframe su una connessione TN3270. È possibile trovare il connettore nella categoria Enterprise .

4. Quando viene visualizzata la casella delle informazioni di connessione, specificare i valori dei parametri necessari seguenti:

   Proprietà	Richiesto	Valore	Descrizione
   Nome connessione	Sì	<nome connessione>	Nome della connessione
   ID account di integrazione	Sì	<integration-account-name>	Nome dell'account di integrazione
   URL di firma di accesso condiviso dell'account di integrazione	Sì	<integration-account-SAS-URL>	URL della firma di accesso condiviso dell'account di integrazione, che è possibile generare dalle impostazioni dell'account di integrazione nel portale di Azure. 1. Nel menu dell'account di integrazione, in Impostazioni, selezionare URL di callback. 2. Nel riquadro di destra copiare il valore dell'URL di callback generato.
   Server	Sì	<TN3270-server-name>	Nome del server per il servizio TN3270
   Porta	No	<TN3270-server-port>	Porta usata dal server TN3270. Se lasciato vuoto, il connettore usa 23 come valore predefinito.
   Tipo di dispositivo	No	<IBM-terminal-model>	Nome o numero del modello per il terminale IBM da emulare. Se lasciato vuoto, il connettore usa i valori predefiniti.
   Tabella codici	No	<code-page-number>	Numero della tabella codici per l'host. Se lasciato vuoto, il connettore usa 37 come valore predefinito.
   Nome unità logica	No	<logical-unit-name>	Nome dell'unità logica specifica da richiedere dall'host
   Abilitare SSL?	No	Attivato o disattivato	Attivare o disattivare la crittografia TLS.
   Convalidare il certificato SSL dell'host?	No	Attivato o disattivato	Attivare o disattivare la convalida per il certificato del server.

   Ad esempio:

   

5. Al termine, seleziona Crea.

6. Quando viene visualizzata la casella delle informazioni sull'azione, specificare i valori dei parametri necessari:

   Proprietà	Richiesto	Valore	Descrizione
   Nome HIDX	Sì	<HIDX-file-name>	Selezionare il file HIDX 3270 da usare.
   Nome metodo	Sì	<method-name>	Selezionare il metodo nel file HIDX da usare. Dopo aver selezionato un metodo, viene visualizzato l'elenco Aggiungi nuovo parametro in modo da poter selezionare i parametri da usare con tale metodo.
   Aggiungere un nuovo parametro	No	Variabile	Questo elenco viene visualizzato dopo aver selezionato un metodo in modo che sia possibile aggiungere altri parametri da usare con il metodo selezionato. I parametri disponibili variano in base al file HIDX e al metodo selezionato.

   Ad esempio:

   Selezionare il file HIDX

   

   Selezionare il metodo

   

   Selezionare i parametri

   

7. Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Testare il flusso di lavoro

Standard

1. Per eseguire il flusso di lavoro, nella finestra di progettazione selezionare il menu flusso di lavoro, selezionare Panoramica. Sulla barra degli strumenti Panoramica selezionare Esegui>esegui.

   Al termine dell'esecuzione del flusso di lavoro, viene visualizzata la cronologia di esecuzione del flusso di lavoro. I passaggi riusciti mostrano i segni di spunta, mentre i passaggi non riusciti mostrano un punto esclamativo (!).

2. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

3. Per esaminare gli output, selezionare Visualizza output non elaborati.

4. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

5. Per esaminare gli output, selezionare Visualizza output non elaborati.

Consumo

1. Per eseguire il flusso di lavoro, sulla barra degli strumenti della finestra di progettazione selezionare Esegui esecuzione trigger>.

   Al termine dell'esecuzione del flusso di lavoro, viene visualizzata la cronologia di esecuzione del flusso di lavoro. I passaggi riusciti mostrano i segni di spunta, mentre i passaggi non riusciti mostrano un punto esclamativo (!).

2. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

3. Per esaminare gli output, selezionare Visualizza output non elaborati.

4. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

5. Per esaminare gli output, selezionare Visualizza output non elaborati.

Passaggi successivi

• Monitorare lo stato dell'esecuzione del flusso di lavoro, esaminare la cronologia di esecuzione del trigger e del flusso di lavoro e configurare gli avvisi in App per la logica di Azure
• Visualizzare le metriche per l'integrità e le prestazioni del flusso di lavoro in App per la logica di Azure
• Monitorare e raccogliere dati di diagnostica per i flussi di lavoro in App per la logica di Azure
• Abilitare e visualizzare dati di telemetria avanzati in Application Insights per flussi di lavoro Standard in App per la logica di Azure