Partilhar via


IA-Connect mainframe (visualização)

IA-Connect é uma plataforma de Robotic Process Automation (RPA) que adiciona funcionalidade de RPA da nuvem a máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop (RDS). Este é o módulo para automatizar sessões de mainframe 5250 e 3270 usando aplicativos de emulação de terminal que suportam a API HLLAPI.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Laboratórios Ultima
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Metadados do conector
Editora Laboratórios Ultima
Sítio Web https://www.ultima.com/ultima-labs
Política de privacidade https://www.ultima.com/privacy-policy
Categorias Operações de TI; Produtividade

IA-Connect é uma plataforma de Robotic Process Automation (RPA) que adiciona funcionalidade de RPA do Power Automate Cloud Flows a máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop (RDS). Os IA-Connect Connectors fornecem mais de 650 ações, permitindo automatizar todos os tipos de aplicativos locais diretamente de um Power Automate Cloud Flow. Todas as IA-Connect ações estão disponíveis diretamente do seu Power Automate Cloud Flow, proporcionando fácil integração entre aplicativos baseados na nuvem e locais, a capacidade de aproveitar as condições, loops, conteúdo dinâmico, expressões e tratamento de exceções existentes do Power Automate em seus processos de RPA. A utilização dos conectores IA-Connect também fornece histórico de execução completo e auditabilidade do histórico de execução do Flow, ao mesmo tempo em que elimina a necessidade de ter um aplicativo/console/estúdio separado para desenvolver seus processos de RPA.

Pré-requisitos

Para usar qualquer um dos IA-Connect Connectors, você deve instalar o software IA-Connect. Este teste é gratuito durante 30 dias, após os quais necessitará de uma licença IA-Connect.

O software IA-Connect consiste em dois componentes principais:

  • O IA-Connect Orchestrator, que é um WebApp do Azure que você hospedaria em seu próprio locatário do Azure. Isso lida com o roteamento e a segurança de fluxos de RPA para uma ou mais máquinas virtuais locais ou baseadas em nuvem.

  • O IA-Connect Agent and Diretor, que é instalado nas máquinas virtuais onde o software que você deseja automatizar está acessível. Além disso, o IA-Connect Agent pode ser executado dentro de uma sessão Citrix ou Microsoft Remote Desktop Services (RDS), onde os comandos RPA são passados por um canal virtual para a sessão remota para execução. O IA-Connect Agent pode ser executado a partir de um compartilhamento de rede e não requer instalação.

Conectores IA-Connect disponíveis

Os conectores IA-Connect disponíveis são:

  • IA-Connect Código Dinâmico
  • IA-Connect Java
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect SAP GUI
  • Sessão IA-Connect
  • IA-Connect UI
  • IA-Connect Web Browser

Como obter credenciais

Para receber sua licença e começar sua avaliação gratuita de 30 dias, envie uma solicitação em nosso site (https://www.ultima.com/IA-Connect/Power-Automate).

Assim que receber um pedido de avaliação, entraremos em contacto consigo através do endereço de e-mail fornecido para ajudar a configurar o software IA-Connect e para lhe fornecer a licença de avaliação. Esta é uma versão de avaliação completa e permitirá que você teste qualquer uma das 650 ações em todos os 8 conectores IA-Connect em seu próprio ambiente durante o período de avaliação.

Introdução ao conector

Depois de submeter um pedido de avaliação para o IA-Connect, poderá descarregar um ficheiro ZIP contendo o software IA-Connect e documentação que abrange a instalação e configuração. Também entraremos em contato para oferecer suporte e orientação durante o processo de instalação, conforme necessário.

Support

Durante o período de teste, você pode entrar em contato com o Ultima Labs (IAConnect@ultima.com) para obter suporte e assistência.

Ao comprar IA-Connect licenças, você receberá tokens de suporte que podem ser trocados por treinamento personalizado ou suporte do Centro de Serviço Técnico (TSC) da Ultima, com sede no Reino Unido.

Problemas conhecidos, erros comuns e perguntas frequentes

Nossa Base de Conhecimento contém uma série de artigos que abrangem quaisquer problemas conhecidos, erros comuns que podem ocorrer ao usar os IA-Connect Connectors e perguntas frequentes. Isso pode ser acessado e https://support.ultima.com/ultimalabs uma conta para acessar esses recursos é fornecida durante a avaliação do IA-Connect e após a compra de uma licença IA-Connect.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API securestring A chave de API para esta api Verdade
IA-Connect Endereço do Orchestrator cadeia (de caracteres) Especifique o endereço do IA-Connect Orchestrator sem o componente HTTP(S) Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Aguarde a cadeia de caracteres na sessão de emulação do terminal

Aguarda que uma cadeia de caracteres especificada seja exibida na sessão do emulador de terminal. Essa ação pode ser usada ao se mover entre telas para validar que você está na tela correta.

Aguarde até que o sistema de emulação de terminal esteja pronto

Aguarda que o emulador de terminal informe que o sistema está pronto. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Aguarde o teclado de emulação do terminal desbloqueado

Aguarda que o emulador de terminal informe que o teclado está desbloqueado. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Conectar-se à sessão de emulação de terminal

Conecta qualquer subsistema HLLAPI IA-Connect em execução (IA-HLLAPI) ao ID de sessão de mainframe conectado especificado. O ID da sessão é um Id atribuído pelo emulador de terminal que você está usando para conexões de mainframe. A sessão de mainframe deve estar em execução antes de você se conectar a ela usando esta ação.

Definir a posição do cursor de emulação de terminal

Define a posição atual do cursor em uma sessão de mainframe para a posição especificada.

Definir emulação de terminal HLLAPI DLL

Inicia o subsistema HLLAPI IA-Connect (IA-HLLAPI) e o conecta à DLL HLLAPI do emulador de terminal especificada (um componente do software de emulação de terminal que está sendo usado para se conectar a sessões de mainframe).

Definir parâmetro de sessão na sessão de emulação de terminal

Esta ação define um parâmetro de sessão HLLAPI avançado. Esta ação só deve ser usada se você estiver familiarizado com os parâmetros de sessão HLLAPI.

Descarte a emulação de terminal HLLAPI DLL

Desliga qualquer subsistema HLLAPI em execução IA-Connect (IA-HLLAPI).

Desconectar da sessão de emulação de terminal

Desconecta o subsistema HLLAPI de IA-Connect em execução (IA-HLLAPI) de um ID de sessão de mainframe conectado especificado. O ID da sessão é um Id atribuído pelo emulador de terminal que você está usando para conexões de mainframe.

Enviar chave de redefinição para a sessão de emulação do terminal

Envia uma chave de redefinição para a sessão do emulador de terminal. Isso redefinirá todas as entradas e limpará um estado de entrada inválido.

Enviar senha para a sessão de emulação do terminal

Envia uma senha para uma sessão de mainframe na posição atual do cursor. Se desejar enviar uma palavra-passe para uma posição específica do cursor, pode utilizar a ação "Enviar palavra-passe para a sessão de emulação do terminal na posição".

Enviar senha para a sessão de emulação do terminal na posição

Envia uma senha para uma sessão de mainframe na posição especificada do cursor.

Enviar string para sessão de emulação de terminal

Envia uma cadeia de caracteres para uma sessão de mainframe na posição atual do cursor. Se desejar enviar uma string para uma posição específica do cursor, você pode usar a ação 'Enviar string para a sessão de emulação do terminal na posição'.

Enviar string para sessão de emulação de terminal na posição

Envia uma cadeia de caracteres para uma sessão de mainframe na posição especificada do cursor.

Get é emulação de terminal de teclado desbloqueado

Retorna se o emulador de terminal está relatando que o teclado está desbloqueado. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Ler linhas de tela de emulação de terminal

Lê as linhas da tela de uma sessão de mainframe especificada. Esta ação é comumente usada para ler grandes quantidades de dados que podem ser filtrados, se necessário.

Ler tela de emulação de terminal na posição do cursor

Lê o número especificado de caracteres da sessão de mainframe, começando na posição do cursor especificada.

Obter a posição do cursor de emulação de terminal

Obtém a posição atual do cursor em uma sessão de mainframe.

Obter emulação de terminal Área de Informação do Operador (OIA)

Retorna a Área de Informações do Operador exibida pelo emulador de terminal. Esta é a linha na parte inferior da tela do emulador de terminal e geralmente indica informações de status, como se o sistema está aguardando ou está em um estado de entrada inválido.

Obter o status da conexão de emulação de terminal

Retorna o estado atual da conexão de emulação de terminal dentro da sessão especificada.

Procurar string na sessão de emulação de terminal

Procura uma cadeia de caracteres especificada na exibição atual do emulador de terminal. Se a cadeia de caracteres for encontrada, sua posição e índice serão retornados.

Redefinir sessão de emulação de terminal

Redefine a sessão de mainframe atual. A ação desconecta IA-Connect Agente da sessão e desfaz todos os parâmetros de sessão que foram definidos. Depois de chamar essa ação, você precisará se conectar novamente à sessão usando a ação 'Conectar à sessão' para continuar interagindo com ela.

Status da sessão de emulação do terminal de consulta

Retorna informações sobre a sessão de mainframe conectada. Alguns emuladores de terminal podem não retornar valores para todas as saídas.

Aguarde a cadeia de caracteres na sessão de emulação do terminal

Aguarda que uma cadeia de caracteres especificada seja exibida na sessão do emulador de terminal. Essa ação pode ser usada ao se mover entre telas para validar que você está na tela correta.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

string de pesquisa
SearchString True string

A cadeia de caracteres para esperar.

Pesquisar em toda a tela
SearchEntireScreen boolean

A tela inteira deve ser pesquisada? Se definido como falso, as entradas 'Índice da linha inicial da pesquisa' e 'Índice da coluna inicial da pesquisa' podem ser usadas para restringir a área de pesquisa.

Índice da linha inicial da pesquisa
SearchStartRowIndex integer

O índice de linha no qual começar a procurar a cadeia de caracteres especificada, a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' estiver definido como false.

Índice da coluna inicial da pesquisa
SearchStartColIndex integer

O índice de coluna no qual começar a procurar a cadeia de caracteres especificada, a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' estiver definido como false.

Segundos de espera
SecondsToWait True double

O número máximo de segundos para aguardar que a cadeia de caracteres especificada seja exibida.

Delta segundos de espera
DeltaSecondsToWait double

O número de segundos entre cada pesquisa para a cadeia de caracteres especificada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
String encontrada
StringFound boolean

Retorna true se a cadeia de caracteres especificada foi encontrada antes do período máximo de espera.

Posição da cadeia de caracteres encontrada
StringFoundPosition integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém a posição absoluta do primeiro caractere na cadeia de pesquisa. Por exemplo, supondo uma sessão de 24 linhas por 80 colunas, a posição seria retornada como 321 se a cadeia de caracteres fosse encontrada na primeira coluna da quinta linha, pois a quinta linha conteria as posições 321 a 400.

Índice de linha encontrado da cadeia de caracteres
StringFoundRowIndex integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém o índice de linha do primeiro caractere na cadeia de pesquisa.

Índice de coluna de cadeia de caracteres encontrado
StringFoundColIndex integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém o índice de coluna do primeiro caractere na cadeia de pesquisa.

Aguarde até que o sistema de emulação de terminal esteja pronto

Aguarda que o emulador de terminal informe que o sistema está pronto. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Parâmetros

Name Chave Necessário Tipo Description
Segundos de espera
SecondsToWait True double

O número máximo de segundos para aguardar que o emulador de terminal informe que o sistema está pronto.

Delta segundos de espera
DeltaSecondsToWait double

O número de segundos entre cada consulta ao emulador de terminal para verificar o status do sistema.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O sistema está pronto
SystemReady boolean

Retorna true se o emulador de terminal estiver relatando que o sistema está pronto.

Aguarde o teclado de emulação do terminal desbloqueado

Aguarda que o emulador de terminal informe que o teclado está desbloqueado. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Parâmetros

Name Chave Necessário Tipo Description
Segundos de espera
SecondsToWait True double

O número máximo de segundos para aguardar que o emulador de terminal informe que o teclado está desbloqueado.

Delta segundos de espera
DeltaSecondsToWait double

O número de segundos entre cada consulta ao emulador de terminal para verificar o status de desbloqueio do teclado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O teclado está desbloqueado
KeyBoardIsUnlocked boolean

Retorna true se o emulador de terminal estiver relatando que o teclado está desbloqueado.

Conectar-se à sessão de emulação de terminal

Conecta qualquer subsistema HLLAPI IA-Connect em execução (IA-HLLAPI) ao ID de sessão de mainframe conectado especificado. O ID da sessão é um Id atribuído pelo emulador de terminal que você está usando para conexões de mainframe. A sessão de mainframe deve estar em execução antes de você se conectar a ela usando esta ação.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir a posição do cursor de emulação de terminal

Define a posição atual do cursor em uma sessão de mainframe para a posição especificada.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Índice da linha do cursor
CursorRowIndex True integer

O índice da linha do cursor no qual definir o cursor.

Índice da coluna do cursor
CursorColIndex True integer

O índice da coluna do cursor no qual definir o cursor.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir emulação de terminal HLLAPI DLL

Inicia o subsistema HLLAPI IA-Connect (IA-HLLAPI) e o conecta à DLL HLLAPI do emulador de terminal especificada (um componente do software de emulação de terminal que está sendo usado para se conectar a sessões de mainframe).

Parâmetros

Name Chave Necessário Tipo Description
Nome do arquivo HLLAPI DLL
DLLFilename True string

O caminho completo do arquivo para a DLL HLLAPI fornecida pelo emulador.

IA-HLLAPI nome do ficheiro
IAHLLAPIPath string

O local opcional da DLL COM de 32 bits de IA-HLLAPI usada como uma interface COM para a DLL HLLAPI especificada (somente se a DLL HLLAPI for de 32 bits). Isso normalmente não é necessário, pois IA-Connect tem uma DLL HLLAPI interna chamada 'IA-HLLAPI. DLL' que é usado para configurar a interface COM para a DLL HLLAPI do emulador. Por padrão, IA-Connect extrai isso para o diretório '%TEMP%\IA-Connect' no perfil do usuário.

Nome do ponto de entrada
EntryPointName string

O nome do ponto de entrada DLL. Isso varia dependendo do software emulador que está sendo usado e, se deixado em branco, IA-Connect tentará os seguintes pontos de entrada comuns: hllapi, HLLAPI, HLLAPI32, EHLLAPI, EHLLAPI32.

É interface melhorada
IsEnhancedInterface boolean

Este parâmetro deve ser definido como true se a DLL usa a interface aprimorada HLLAPI.

É 64bit HLLAPI DLL
Is64BitHLLAPIDLL boolean

Este parâmetro deve ser definido como true se a DLL HLLAPI que você está tentando carregar for de 64 bits.

Use COM para DLL HLLAPI de 64 bits
UseCOMFor64BitHLLAPIDLL boolean

Defina como true se a DLL HLLAPI que você está tentando carregar for de 64 bits e você quiser executá-la por meio de uma DLLSurrogate COM fora de processo em vez de chamar diretamente (na memória) do IA-Connect.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir parâmetro de sessão na sessão de emulação de terminal

Esta ação define um parâmetro de sessão HLLAPI avançado. Esta ação só deve ser usada se você estiver familiarizado com os parâmetros de sessão HLLAPI.

Parâmetros

Name Chave Necessário Tipo Description
Parâmetro
Parameter True string

O(s) parâmetro(s) HLLAPI a definir. Vários parâmetros podem ser separados por vírgulas ou espaços.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Descarte a emulação de terminal HLLAPI DLL

Desliga qualquer subsistema HLLAPI em execução IA-Connect (IA-HLLAPI).

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desconectar da sessão de emulação de terminal

Desconecta o subsistema HLLAPI de IA-Connect em execução (IA-HLLAPI) de um ID de sessão de mainframe conectado especificado. O ID da sessão é um Id atribuído pelo emulador de terminal que você está usando para conexões de mainframe.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar chave de redefinição para a sessão de emulação do terminal

Envia uma chave de redefinição para a sessão do emulador de terminal. Isso redefinirá todas as entradas e limpará um estado de entrada inválido.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar senha para a sessão de emulação do terminal

Envia uma senha para uma sessão de mainframe na posição atual do cursor. Se desejar enviar uma palavra-passe para uma posição específica do cursor, pode utilizar a ação "Enviar palavra-passe para a sessão de emulação do terminal na posição".

Parâmetros

Name Chave Necessário Tipo Description
Introduzir palavra-passe
InputPassword True password

A senha a ser inserida. Isso suporta um conjunto completo de símbolos de teclado, por exemplo, '@E' para enter.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar senha para a sessão de emulação do terminal na posição

Envia uma senha para uma sessão de mainframe na posição especificada do cursor.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Índice da linha do cursor
CursorRowIndex True integer

O índice de linha do cursor atual.

Índice da coluna do cursor
CursorColIndex True integer

O índice atual da coluna do cursor.

Introduzir palavra-passe
InputPassword True password

A senha a ser inserida. Isso suporta um conjunto completo de símbolos de teclado, por exemplo, '@E' para enter.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar string para sessão de emulação de terminal

Envia uma cadeia de caracteres para uma sessão de mainframe na posição atual do cursor. Se desejar enviar uma string para uma posição específica do cursor, você pode usar a ação 'Enviar string para a sessão de emulação do terminal na posição'.

Parâmetros

Name Chave Necessário Tipo Description
String de entrada
InputString True string

A cadeia de caracteres a ser inserida. Isso suporta um conjunto completo de símbolos de teclado, por exemplo, '@E' para enter.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar string para sessão de emulação de terminal na posição

Envia uma cadeia de caracteres para uma sessão de mainframe na posição especificada do cursor.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Índice da linha do cursor
CursorRowIndex True integer

O índice de linha do cursor atual.

Índice da coluna do cursor
CursorColIndex True integer

O índice atual da coluna do cursor.

String de entrada
InputString True string

A cadeia de caracteres a ser inserida. Isso suporta um conjunto completo de símbolos de teclado, por exemplo, '@E' para enter.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Get é emulação de terminal de teclado desbloqueado

Retorna se o emulador de terminal está relatando que o teclado está desbloqueado. A saída desta ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O teclado está desbloqueado
KeyBoardIsUnlocked boolean

Retorna true se o emulador de terminal estiver relatando que o teclado está desbloqueado.

Ler linhas de tela de emulação de terminal

Lê as linhas da tela de uma sessão de mainframe especificada. Esta ação é comumente usada para ler grandes quantidades de dados que podem ser filtrados, se necessário.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Índice da linha inicial
StartRowIndex True integer

O índice da linha inicial a partir do qual começar a ler.

Índice da linha final
EndRowIndex True integer

O índice da linha final para parar de ler.

Número de linhas na sessão
NumberOfRowsInSession integer

O número de linhas que estão sendo exibidas pela sessão. Se definido como 0, IA-Connect consultará a sessão para recuperar o número de linhas.

Número de colunas na sessão
NumberOfColumnsInSession integer

O número de colunas que estão sendo exibidas pela sessão. Se definido como 0, IA-Connect consultará a sessão para recuperar o número de colunas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
JSON de linhas de tela
ScreenRowsJSON string

As linhas são lidas a partir da sessão de mainframe, no formato JSON.

Ler tela de emulação de terminal na posição do cursor

Lê o número especificado de caracteres da sessão de mainframe, começando na posição do cursor especificada.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Índice da linha do cursor
CursorRowIndex True integer

O índice de linha do cursor atual.

Índice da coluna do cursor
CursorColIndex True integer

O índice atual da coluna do cursor.

Número de caracteres a ler
ReadScreenLength True integer

O número de caracteres a serem lidos na sessão de mainframe.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Conteúdo do ecrã
ScreenContents string

O conteúdo da tela que foi lido da sessão de mainframe.

Obter a posição do cursor de emulação de terminal

Obtém a posição atual do cursor em uma sessão de mainframe.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Índice da linha do cursor
CursorRowIndex integer

O índice de linha do cursor atual.

Índice da coluna do cursor
CursorColIndex integer

O índice atual da coluna do cursor.

Posição do cursor
CursorPos integer

A posição absoluta do cursor. Por exemplo, supondo uma sessão de 24 linhas por 80 colunas, a primeira coluna da primeira linha seria a posição 1 e a primeira coluna da segunda linha seria a posição 81.

Obter emulação de terminal Área de Informação do Operador (OIA)

Retorna a Área de Informações do Operador exibida pelo emulador de terminal. Esta é a linha na parte inferior da tela do emulador de terminal e geralmente indica informações de status, como se o sistema está aguardando ou está em um estado de entrada inválido.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Formato OIA
OIAFormat string

O formato da Área de Informação do Operador (OIA), por exemplo PC400.

Espera do sistema
SystemWait boolean

Retorna true se o emulador de terminal estiver relatando que o sistema está atualmente aguardando a conclusão de uma ação, ou false se não.

CAPS
CAPS boolean

Retorna true se o emulador de terminal estiver relatando que a tecla CAPS está pressionada no momento, ou false se não.

Tecla Shift
ShiftKey boolean

Retorna true se o emulador de terminal estiver relatando que a tecla SHIFT está pressionada no momento, ou false se não.

Pronto para o subsistema
SubsystemReady boolean

Retorna true se o emulador de terminal estiver relatando que o subsistema está pronto, ou false se não.

Modo de inserção
InsertMode boolean

Retorna true se o emulador de terminal estiver relatando que o modo de inserção está habilitado no momento, ou false se não.

Entrada inválida
InvalidInput boolean

Retorna true se o emulador de terminal estiver relatando que a sessão de mainframe está atualmente em um estado de entrada inválido, ou false se não.

Tipo de entrada
InputType string

O tipo de entrada de sessão de mainframe. Pode ser APL, Katakana, Alfanumérico, Hiragana ou Byte Duplo.

Obter o status da conexão de emulação de terminal

Retorna o estado atual da conexão de emulação de terminal dentro da sessão especificada.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Conectado à sessão
ConnectedToSession boolean

Retorna true se você estiver conectado à ID de sessão especificada ou false se não.

Sistema ocupado
SystemBusy boolean

Retorna true se o sistema de mainframe estiver relatando que está ocupado no momento, ou false se não.

Teclado bloqueado
KeyboardLocked boolean

Retorna true se a sessão de mainframe estiver relatando que o teclado está bloqueado no momento, ou false se não.

Sessão em uso por outro aplicativo HLLAPI
SessionInUseByAnotherHLLAPIApplication boolean

Retorna true se a sessão de mainframe estiver atualmente em uso por outro aplicativo HLLAPI ou false se não.

HLLAPI thread ID
HLLAPIThreadID integer

Relata o ID do thread HLLAPI no IA-Connect. Esta saída é apenas para fins de diagnóstico.

COM thread ID
COMThreadID integer

Relata o ID do thread COM no IA-Connect. Esta saída é apenas para fins de diagnóstico.

Contagem de chamadas
CallCount integer

Informa o número de ações HLLAPI realizadas por IA-Connect nesta sessão. Esta saída é apenas para fins de diagnóstico.

Procurar string na sessão de emulação de terminal

Procura uma cadeia de caracteres especificada na exibição atual do emulador de terminal. Se a cadeia de caracteres for encontrada, sua posição e índice serão retornados.

Parâmetros

Name Chave Necessário Tipo Description
ID da Sessão
SessionID True string

O ID de sessão de mainframe de caractere único, por exemplo A.

string de pesquisa
SearchString True string

A cadeia de caracteres a ser pesquisada.

Pesquisar em toda a tela
SearchEntireScreen boolean

A tela inteira deve ser pesquisada? Se definido como falso, as entradas 'Índice da linha inicial da pesquisa' e 'Índice da coluna inicial da pesquisa' podem ser usadas para restringir a área de pesquisa.

Índice da linha inicial da pesquisa
SearchStartRowIndex integer

O índice de linha no qual começar a procurar a cadeia de caracteres especificada, a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' estiver definido como false.

Índice da coluna inicial da pesquisa
SearchStartColIndex integer

O índice de coluna no qual começar a procurar a cadeia de caracteres especificada, a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' estiver definido como false.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
String encontrada
StringFound boolean

Retorna true se a cadeia de caracteres especificada foi encontrada.

Posição da cadeia de caracteres encontrada
StringFoundPosition integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém a posição absoluta do primeiro caractere na cadeia de pesquisa. Por exemplo, supondo uma sessão de 24 linhas por 80 colunas, a posição seria retornada como 321 se a cadeia de caracteres fosse encontrada na primeira coluna da quinta linha, pois a quinta linha conteria as posições 321 a 400.

Índice de linha encontrado da cadeia de caracteres
StringFoundRowIndex integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém o índice de linha do primeiro caractere na cadeia de pesquisa.

Índice de coluna de cadeia de caracteres encontrado
StringFoundColIndex integer

Se a cadeia de caracteres foi encontrada, esse parâmetro mantém o índice de coluna do primeiro caractere na cadeia de pesquisa.

Redefinir sessão de emulação de terminal

Redefine a sessão de mainframe atual. A ação desconecta IA-Connect Agente da sessão e desfaz todos os parâmetros de sessão que foram definidos. Depois de chamar essa ação, você precisará se conectar novamente à sessão usando a ação 'Conectar à sessão' para continuar interagindo com ela.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Status da sessão de emulação do terminal de consulta

Retorna informações sobre a sessão de mainframe conectada. Alguns emuladores de terminal podem não retornar valores para todas as saídas.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Nome longo da sessão
SessionLongName string

O nome longo da sessão de mainframe, por exemplo, SessionA.

Tipo de sessão
SessionType string

O tipo de sessão de mainframe, por exemplo 3270 ou 5250.

Número de linhas
NumberOfRows integer

O número de linhas na exibição.

Número de colunas
NumberOfCols integer

O número de colunas no visor.

Página de código
CodePage integer

A página de código, indicando a codificação de caracteres que está sendo usada.