Partilhar via

Integre aplicativos orientados por tela 3270 em mainframes IBM com o Azure usando o Azure Logic Apps e o conector IBM 3270

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Para acessar e executar aplicativos de mainframe IBM, que normalmente são executados navegando pelas telas do emulador 3270, a partir dos fluxos de trabalho Consumo e Padrão nos Aplicativos Lógicos do Azure, é possível usar o conector IBM 3270 . Desta forma, pode integrar as suas aplicações de mainframe da IBM com o Azure, a Microsoft e outros serviços, sistemas e aplicações ao criar fluxos de trabalho automatizados com o Azure Logic Apps. O conector se comunica com mainframes IBM usando o protocolo TN3270. O conector IBM 3270 está disponível em todas as regiões dos Aplicativos Lógicos do Azure, exceto no Azure Government e no Microsoft Azure operados pela 21Vianet.

Este guia de instruções descreve os seguintes aspetos sobre o conector IBM 3270 :

  • Por que usar o conector IBM 3270 no Azure Logic Apps

  • Como o conector IBM 3270 executa aplicativos controlados por tela 3270

  • Pré-requisitos e configuração para usar o conector IBM 3270

  • Etapas para adicionar ações do conector IBM 3270 ao seu fluxo de trabalho

Porquê usar este conector?

Para acessar aplicativos em mainframes IBM, você normalmente usa um emulador de terminal 3270, geralmente chamado de "tela verde". Este método é uma forma testada pelo tempo, mas tem limitações. Embora o Host Integration Server (HIS) ajude você a trabalhar diretamente com esses aplicativos, às vezes, separar a tela e a lógica de negócios pode não ser possível. Ou, talvez você não tenha mais informações sobre como os aplicativos host funcionam.

Para estender esses cenários, o conector IBM 3270 nos Aplicativos Lógicos do Azure funciona com a Ferramenta de Design 3270, que você usa para gravar, ou "capturar", as telas de host usadas para uma tarefa específica, definir o fluxo de navegação para essa tarefa por meio de seu aplicativo de mainframe e definir os métodos com parâmetros de entrada e saída para essa tarefa. A ferramenta de design converte essas informações em metadados que o conector 3270 usa ao executar uma ação em seu fluxo de trabalho.

Depois de gerar o arquivo de metadados da Ferramenta de Design 3270, você adiciona esse arquivo como um artefato de mapa ao recurso do aplicativo lógico padrão ou à sua conta de integração vinculada para um aplicativo lógico de consumo nos Aplicativos Lógicos do Azure. Dessa forma, seu fluxo de trabalho pode acessar os metadados do seu aplicativo quando você adiciona uma ação do conector IBM 3270 . O conector lê o arquivo de metadados do recurso do aplicativo lógico (Padrão) ou da sua conta de integração (Consumo), lida com a navegação pelas telas 3270 e apresenta dinamicamente os parâmetros a serem usados com o conector 3270 em seu fluxo de trabalho. Em seguida, você pode fornecer dados para o aplicativo host e o conector retorna os resultados para seu fluxo de trabalho. Como resultado, você pode integrar seus aplicativos herdados com o Azure, a Microsoft e outros aplicativos, serviços e sistemas suportados pelos Aplicativos Lógicos do Azure.

Referência técnica do conector

O conector IBM 3270 tem versões diferentes, com base no tipo de aplicativo lógico e no ambiente de host.

Aplicação lógica Environment Versão da conexão
Consumo Aplicativos Lógicos do Azure Multilocatário Conector gerenciado, que aparece no designer sob o rótulo Empresa . Este conector fornece apenas uma ação única e sem gatilhos. Para obter mais informações, consulte IBM 3270 managed connector reference.
Standard Aplicativos Lógicos do Azure de locatário único e Ambiente do Serviço de Aplicativo v3 (somente planos ASE v3 com Windows) Conector gerenciado, que aparece na galeria de conectores em Runtime Shared, e o conector interno baseado em provedor de serviços, que aparece na galeria de conectores em Runtime>>In-App. A versão integrada difere das seguintes formas: -

- O conector integrado requer que você carregue seu arquivo HIDX para o recurso do aplicativo lógico padrão, não uma conta de integração.

- O conector interno pode se conectar diretamente a um servidor 3270 e acessar redes virtuais do Azure usando uma cadeia de conexão.

- A versão incorporada suporta autenticação de servidor com encriptação TLS (SSL) para dados em trânsito, codificação de mensagens para o seu funcionamento e integração de rede virtual do Azure.

Para obter mais informações, consulte a seguinte documentação:

- Referência do conector gerenciado IBM 3270
- Referência do conector integrado IBM 3270

Referência de conector integrada

A seção a seguir descreve as operações para o conector IBM 3270, que atualmente inclui apenas a seguinte ação:

Executar um plano de navegação

Parâmetro Necessário Tipo Description
Nome HIDX Sim String Selecione o arquivo HIDX 3270 que você deseja usar.
Nome do método Sim String Selecione o método no arquivo HIDX que você deseja usar.
Parâmetros avançados Não Varia Essa lista aparece depois que você seleciona um método para que você possa adicionar outros parâmetros para usar com o método selecionado. Os parâmetros disponíveis variam com base no seu arquivo HIDX e no método selecionado.

Esta operação também inclui parâmetros avançados, que aparecem depois de selecionar um método, para você selecionar e usar com o método selecionado. Esses parâmetros variam com base no arquivo HIDX e no método selecionado.

Pré-requisitos

  • Uma conta e subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.

  • Acesso ao servidor TN3270 que hospeda seu aplicativo controlado por tela 3270

  • O arquivo Host Integration Designer XML (HIDX) que fornece os metadados necessários para que o conector IBM 3270 execute seu aplicativo controlado por tela 3270 .

    Para criar este ficheiro HIDX, transfira e instale a 3270 Design Tool. O único pré-requisito é o Microsoft .NET Framework 4.8.

    Essa ferramenta ajuda você a gravar as telas, caminhos de navegação, métodos e parâmetros para as tarefas em seu aplicativo que você adiciona e executa como ações de conector 3270. A ferramenta gera um arquivo HIDX (Host Integration Designer XML) que fornece os metadados necessários para que o conector execute seu aplicativo controlado por tela 3270.

    Depois de baixar e instalar essa ferramenta, siga estas etapas para se conectar ao seu servidor host TN3270, projetar o artefato de metadados necessário e gerar o arquivo HIDX.

  • O recurso e o fluxo de trabalho do aplicativo lógico Padrão ou de Consumo no qual você deseja executar seu aplicativo controlado por tela 3270

    O conector IBM 3270 não tem gatilhos, portanto, use qualquer gatilho para iniciar seu fluxo de trabalho, como o gatilho de Recorrência ou o gatilho de Solicitação. Em seguida, você pode adicionar as ações do conector 3270.

  • Uma conta de integração, que é necessária com base na versão do conector 3270 que você usa e é um recurso do Azure onde você pode armazenar centralmente artefatos B2B, como parceiros comerciais, contratos, mapas, esquemas e certificados para usar com ações específicas do fluxo de trabalho.

    Fluxo de Trabalho Description
    Standard - Conector integrado 3270: Carregue o arquivo HIDX para o recurso do aplicativo lógico padrão.

    - Conector gerenciado 3270: Carregue o arquivo HIDX para seu recurso de aplicativo lógico padrão ou sua conta de integração vinculada.
    Consumo Conector gerenciado 3270: carregue o arquivo HIDX para sua conta de integração vinculada.

    Para obter mais informações, consulte Carregar o arquivo HIDX.

Carregue o arquivo HIDX

Para que seu fluxo de trabalho use o arquivo HIDX, siga estas etapas:

  1. Vá para a pasta onde você salvou o arquivo HIDX e copie o arquivo.

  2. No portal do Azure, escolha as seguintes etapas, com base na versão do conector:

  3. Agora, adicione uma ação do IBM 3270 ao seu fluxo de trabalho.

Mais adiante neste guia, quando você adiciona uma ação do conector IBM 3270 ao seu fluxo de trabalho pela primeira vez, você é solicitado a criar uma conexão entre seu fluxo de trabalho e o sistema de mainframe. Depois de criar a conexão, você pode selecionar o arquivo HIDX adicionado anteriormente, o método a ser executado e os parâmetros a serem usados.

Adicionar uma ação do IBM 3270

Um fluxo de trabalho de aplicativo lógico padrão pode usar o conector gerenciado do IBM 3270 e o conector integrado do IBM 3270. No entanto, um fluxo de trabalho do aplicativo lógico de consumo pode usar apenas o conector gerenciado do IBM 3270. Cada versão tem ações diferentes. Com base no fato de você ter um fluxo de trabalho de aplicativo lógico Consumo ou Padrão, siga as etapas correspondentes:

  1. No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico padrão onde você já adicionou um gatilho.

  2. Se você ainda não adicionou um gatilho, siga estas etapas gerais para adicionar o gatilho desejado ao seu fluxo de trabalho.

    Este exemplo continua com o gatilho Request chamado When a HTTP request is received.

  3. Siga estas etapas gerais para adicionar a ação do conector integrado do IBM 3270 chamada Executar um plano de navegação.

  4. Quando a caixa de informações de conexão for exibida, forneça os seguintes valores de parâmetro necessários:

    Propriedade Necessário Valor Description
    Nome da Ligação Sim <nome da conexão> Um nome para a sua ligação
    Página de código Não <página de código> O número da página de código para o host usar para converter texto. Se deixado em branco, o conector usa 37 como o valor padrão.
    Device Type Não <IBM-terminal-modelo> O nome ou número do modelo para o terminal IBM emular. Se deixado em branco, o conector usa valores padrão.
    Telas de exceção de log Não Verdadeiro ou falso Registre a tela do host se ocorrer um erro durante a navegação na tela.
    Nome da unidade lógica Não <logical-unit-name> O nome da unidade lógica específica a ser solicitada ao host
    Número da porta Não <Porta do servidor TN3270> A porta usada pelo seu servidor TN3270. Se deixado em branco, o conector usa 23 como o valor padrão.
    Servidor Sim <TN3270-nome-do-servidor> O nome do servidor para o serviço TN3270
    Tempo limite Não <tempo-limite de segundos> A duração do tempo limite em segundos enquanto espera por ecrãs
    Usar TLS Não Ligado ou desligado Ative ou desative a criptografia TLS.
    Validar certificado do servidor TN3270 Não Ligado ou desligado Ative ou desative a validação do certificado do servidor.

    Por exemplo:

    Screenshot shows Azure portal, Standard workflow designer, and IBM 3270 connection properties.

  5. Quando terminar, selecione Criar novo.

  6. Quando a caixa de informações da ação for exibida, forneça os valores de parâmetro necessários:

    Propriedade Necessário Valor Description
    Nome HIDX Sim <Nome do ficheiro HIDX> Selecione o arquivo HIDX 3270 que você deseja usar.
    Nome do método Sim <nome-método> Selecione o método no arquivo HIDX que você deseja usar. Depois de selecionar um método, a lista Adicionar novos parâmetros é exibida para que você possa selecionar parâmetros a serem usados com esse método.
    Parâmetros avançados Não Varia Essa lista aparece depois que você seleciona um método para que você possa adicionar outros parâmetros para usar com o método selecionado. Os parâmetros disponíveis variam com base no seu arquivo HIDX e no método selecionado.

    Por exemplo:

    Selecione o arquivo HIDX

    Screenshot shows Standard workflow designer, 3270 action, and selected HIDX file.

    Selecione o método

    Screenshot shows Standard workflow designer, 3270 action, and selected method.

    Selecione os parâmetros

    Screenshot shows Standard workflow designer, 3270 action, and more parameters.

  7. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Salvar.

Testar o fluxo de trabalho

  1. Para executar seu fluxo de trabalho, no designer, selecione o menu do fluxo de trabalho, selecione Visão geral. Na barra de ferramentas Visão geral, selecione Executar>execução.

    Depois que o fluxo de trabalho terminar de ser executado, o histórico de execução do fluxo de trabalho será exibido. As etapas bem-sucedidas mostram marcas de seleção, enquanto as etapas malsucedidas mostram um ponto de exclamação (!).

  2. Para revisar as entradas e saídas de cada etapa, expanda essa etapa.

  3. Para rever as saídas, selecione Ver saídas brutas.

  4. Para revisar as entradas e saídas de cada etapa, expanda essa etapa.

  5. Para rever as saídas, selecione Ver saídas brutas.

Próximos passos