IA-Connect Mainframe (versão prévia)
IA-Connect é uma plataforma de RPA (Automação de Processo Robótico) que adiciona a funcionalidade RPA da nuvem a máquinas virtuais locais ou em conexões Citrix ou RDS (Área de Trabalho Remota da Microsoft). Este é o módulo para automatizar sessões de Mainframe 5250 e 3270 usando aplicativos de Emulação de Terminal que dão suporte à API de HLLAPI.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| Metadados do conector | |
|---|---|
| Publicador | Ultima Labs |
| Site | 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 RPA (Automação de Processo Robótico) que adiciona a funcionalidade RPA do Power Automate Cloud Flows a máquinas virtuais locais ou em conexões Citrix ou RDS (Área de Trabalho Remota da Microsoft). Os Conectores IA-Connect fornecem mais de 650 ações, permitindo que você automatize todos os tipos de aplicativo local diretamente de um Power Automate Cloud Flow. Todas as ações IA-Connect estão disponíveis diretamente do Power Automate Cloud Flow, fornecendo fácil integração entre aplicativos baseados em 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 de 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 remove a necessidade de ter um aplicativo/console/estúdio separado para desenvolver seus processos de RPA.
Pré-requisitos
Para usar qualquer um dos conectores IA-Connect, você deve instalar o software IA-Connect. Isso é gratuito para testar por 30 dias, seguindo o qual você exigirá uma licença de 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 manipula o roteamento e a segurança dos Fluxos RPA para uma ou mais máquinas virtuais locais ou baseadas em nuvem.
O agente e o diretor do IA-Connect, que é instalado nas máquinas virtuais em que o software que você deseja automatizar está acessível. Além disso, o agente de IA-Connect pode ser executado dentro de uma sessão do Citrix ou dos Serviços de Área de Trabalho Remota da Microsoft (RDS), em que os comandos RPA são passados para baixo um canal virtual para a sessão remota para execução. O agente de IA-Connect pode ser executado em um compartilhamento de rede e não requer instalação.
Conectores de IA-Connect disponíveis
Os conectores de IA-Connect disponíveis são:
- IA-Connect código dinâmico
- Java IA-Connect
- Mainframe IA-Connect
- IA-Connect Microsoft Office
- IA-Connect SAP GUI
- Sessão IA-Connect
- IA-Connect interface do usuário
- navegador da Web IA-Connect
Como obter credenciais
Para receber sua licença e iniciar sua avaliação gratuita de 30 dias, envie uma solicitação em nosso site (https://www.ultima.com/IA-Connect/Power-Automate).
Depois que uma solicitação de avaliação for recebida, entraremos em contato com você por meio do endereço de email fornecido para ajudar a configurar o software IA-Connect e fornecer a licença de avaliação. Esta é uma avaliação totalmente em destaque e permitirá que você teste qualquer uma das 650 ações em todas as 8 IA-Connect Conectores em seu próprio ambiente durante o período de avaliação.
Introdução ao conector
Depois de enviar uma solicitação de avaliação para IA-Connect, você poderá baixar um arquivo ZIP contendo o software IA-Connect e a documentação que abrange a instalação e a instalação. Também entraremos em contato com você para oferecer suporte e diretrizes por meio do processo de instalação, conforme necessário.
Support
Durante o período de avaliação, 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 resgatados para treinamento ou suporte sob medida do TSC (Centro de Serviço Técnico) com sede no Reino Unido da Ultima.
Problemas conhecidos, erros comuns e perguntas frequentes
Nossa Base de Dados de Conhecimento contém vários artigos que abordam problemas conhecidos, erros comuns que podem ocorrer ao usar os Conectores IA-Connect e perguntas frequentes. Isso é acessível https://support.ultima.com/ultimalabs e uma conta para acessar esses recursos é fornecida durante a avaliação do IA-Connect e ao comprar uma licença IA-Connect.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 |
| endereço IA-Connect Orchestrator | cadeia | Especificar o endereço IA-Connect Orchestrator sem o componente HTTP(S) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Aguardar cadeia de caracteres na sessão de emulação de terminal |
Aguarda que uma cadeia de caracteres especificada seja exibida na sessão do emulador de terminal. Essa ação pode ser usada ao mover entre telas para validar que você está na tela correta. |
| Aguardar o sistema de emulação de terminal pronto |
Aguarda que o emulador de terminal informe que o sistema está pronto. A saída dessa ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador. |
| Aguardar o teclado de emulação de terminal desbloqueado |
Aguarda o emulador de terminal relatar que o teclado está desbloqueado. A saída dessa 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 em execução IA-Connect (IA-HLLAPI) à ID de sessão do Mainframe conectada especificada. A ID da sessão é uma ID atribuída pelo emulador de terminal que você está usando para conexões do Mainframe. A sessão mainframe deve estar em execução antes de você se conectar a ela usando essa ação. |
| Definir DLL de HLLAPI de emulação de terminal |
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 às sessões do Mainframe). |
| Definir parâmetro de sessão na sessão de emulação de terminal |
Essa ação define um parâmetro de sessão HLLAPI avançado. Essa ação só deverá ser usada se você estiver familiarizado com os parâmetros de sessão HLLAPI. |
| Definir posição do cursor de emulação de terminal |
Define a posição atual do cursor em uma sessão mainframe para a posição especificada. |
| Descartar a DLL de HLLAPI de emulação de terminal |
Desliga qualquer subsistema HLLAPI em execução IA-Connect (IA-HLLAPI). |
| Desconectar-se da sessão de emulação de terminal |
Desconecta o subsistema HLLAPI de IA-Connect em execução (IA-HLLAPI) de uma ID de sessão do Mainframe conectada especificada. A ID da sessão é uma ID atribuída pelo emulador de terminal que você está usando para conexões do Mainframe. |
| Enviar a chave de redefinição para a sessão de emulação de terminal |
Envia uma chave de redefinição para a sessão do emulador de terminal. Isso redefinirá toda a entrada e limpará um estado de entrada inválido. |
| Enviar cadeia de caracteres para a sessão de emulação de terminal |
Envia uma cadeia de caracteres para uma sessão mainframe na posição atual do cursor. Se você quiser enviar uma cadeia de caracteres para uma posição de cursor específica, poderá usar a ação "Enviar cadeia de caracteres para a sessão de emulação de terminal em posição". |
| Enviar cadeia de caracteres para a sessão de emulação de terminal na posição |
Envia uma cadeia de caracteres para uma sessão mainframe na posição do cursor especificada. |
| Enviar senha para a sessão de emulação de terminal |
Envia uma senha para uma sessão do Mainframe na posição atual do cursor. Se você quiser enviar uma senha para uma posição específica do cursor, poderá usar a ação "Enviar senha para a sessão de emulação de terminal em posição". |
| Enviar senha para a sessão de emulação de terminal na posição |
Envia uma senha para uma sessão do Mainframe na posição do cursor especificada. |
| Get is terminal emulation keyboard unlocked |
Retorna se o emulador de terminal está relatando que o teclado está desbloqueado. A saída dessa ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador. |
| Ler a tela de emulação do terminal na posição do cursor |
Lê o número especificado de caracteres da sessão Mainframe, começando na posição do cursor especificada. |
| Ler linhas de tela de emulação de terminal |
Lê as linhas de tela de uma sessão do Mainframe especificada. Essa ação é comumente usada para ler grandes quantidades de dados que podem ser filtradas, se necessário. |
| Obter o status da conexão de emulação de terminal |
Retorna o estado atual da conexão de emulação de terminal na sessão especificada. |
| Obter posição do cursor de emulação de terminal |
Obtém a posição atual do cursor em uma sessão mainframe. |
| Obter área de informações do operador de emulação de terminal (OIA) |
Retorna a Área de Informações do Operador exibida pelo emulador de terminal. Essa é 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. |
| Pesquisar cadeia de caracteres na sessão de emulação de terminal |
Pesquisa 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 do Mainframe atual. A ação desconecta IA-Connect Agent 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-se à 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 do Mainframe conectada. Alguns emuladores de terminal podem não retornar valores para todas as saídas. |
Aguardar cadeia de caracteres na sessão de emulação de terminal
Aguarda que uma cadeia de caracteres especificada seja exibida na sessão do emulador de terminal. Essa ação pode ser usada ao mover entre telas para validar que você está na tela correta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Pesquisar cadeia de caracteres
|
SearchString | True | string |
A cadeia de caracteres a ser aguardada. |
|
Pesquisar tela inteira
|
SearchEntireScreen | boolean |
A tela inteira deve ser pesquisada? Se definido como false, as entradas "Índice de linha inicial da pesquisa" e "Índice de coluna inicial de pesquisa" poderão ser usadas para restringir a área de pesquisa. |
|
|
Índice de linha inicial da pesquisa
|
SearchStartRowIndex | integer |
O índice de linha no qual começar a pesquisar a cadeia de caracteres especificada, começando a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' for definido como false. |
|
|
Índice de coluna de início de pesquisa
|
SearchStartColIndex | integer |
O índice de coluna no qual começar a pesquisar a cadeia de caracteres especificada, começando em 1. Esse valor só será usado se 'Pesquisar tela inteira' for definido como false. |
|
|
Segundos para esperar
|
SecondsToWait | True | double |
O número máximo de segundos para aguardar a exibição da cadeia de caracteres especificada. |
|
Segundos delta para esperar
|
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() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Cadeia de caracteres encontrada
|
StringFound | boolean |
Retorna true se a cadeia de caracteres especificada foi encontrada antes do período de espera máximo. |
|
Posição encontrada da cadeia de caracteres
|
StringFoundPosition | integer |
Se a cadeia de caracteres foi encontrada, esse parâmetro mantém a posição absoluta do primeiro caractere na cadeia de caracteres 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. |
|
Cadeia de caracteres encontrada índice de linha
|
StringFoundRowIndex | integer |
Se a cadeia de caracteres tiver sido encontrada, esse parâmetro conterá o índice de linha do primeiro caractere na cadeia de caracteres de pesquisa. |
|
Cadeia de caracteres encontrada índice de coluna
|
StringFoundColIndex | integer |
Se a cadeia de caracteres tiver sido encontrada, esse parâmetro conterá o índice de coluna do primeiro caractere na cadeia de caracteres de pesquisa. |
Aguardar o sistema de emulação de terminal pronto
Aguarda que o emulador de terminal informe que o sistema está pronto. A saída dessa ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Segundos para esperar
|
SecondsToWait | True | double |
O número máximo de segundos para aguardar o emulador de terminal relatar que o sistema está pronto. |
|
Segundos delta para esperar
|
DeltaSecondsToWait | double |
O número de segundos entre cada consulta para o emulador de terminal para verificar o status do sistema. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
O sistema está pronto
|
SystemReady | boolean |
Retornará true se o emulador de terminal estiver relatando que o sistema está pronto. |
Aguardar o teclado de emulação de terminal desbloqueado
Aguarda o emulador de terminal relatar que o teclado está desbloqueado. A saída dessa ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Segundos para esperar
|
SecondsToWait | True | double |
O número máximo de segundos a aguardar até que o emulador de terminal informe que o teclado está desbloqueado. |
|
Segundos delta para esperar
|
DeltaSecondsToWait | double |
O número de segundos entre cada consulta para o emulador de terminal para verificar o status de desbloqueio do teclado. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
O teclado está desbloqueado
|
KeyBoardIsUnlocked | boolean |
Retornará 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 em execução IA-Connect (IA-HLLAPI) à ID de sessão do Mainframe conectada especificada. A ID da sessão é uma ID atribuída pelo emulador de terminal que você está usando para conexões do Mainframe. A sessão mainframe deve estar em execução antes de você se conectar a ela usando essa ação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir DLL de HLLAPI de emulação de terminal
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 às sessões do Mainframe).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de arquivo DLL do HLLAPI
|
DLLFilename | True | string |
O caminho de arquivo completo para a DLL de HLLAPI fornecida pelo emulador. |
|
nome do arquivo IA-HLLAPI
|
IAHLLAPIPath | string |
O local opcional da DLL COM de 32 bits IA-HLLAPI usada como uma interface COM para a DLL HLLAPI especificada (somente se a DLL do HLLAPI for de 32bits). Isso normalmente não é necessário, pois IA-Connect tem uma DLL HLLAPI interna chamada 'IA-HLLAPI. DLL' que é usada 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 sendo usado e, se deixado em branco, IA-Connect tentará os seguintes pontos de entrada comuns: hllapi, HLLAPI, HLLAPI32, EHLLAPI EHLLAPI32. |
|
|
É uma interface aprimorada
|
IsEnhancedInterface | boolean |
Esse parâmetro deverá ser definido como true se a DLL usar a interface aprimorada do HLLAPI. |
|
|
É dLL HLLAPI de 64bits
|
Is64BitHLLAPIDLL | boolean |
Esse parâmetro deve ser definido como true se a DLL HLLAPI que você está tentando carregar for de 64bits. |
|
|
Usar COM para DLL HLLAPI de 64bits
|
UseCOMFor64BitHLLAPIDLL | boolean |
Defina como true se a DLL do HLLAPI que você está tentando carregar for de 64bits e você quiser executá-la por meio de uma DLLSurrogate COM fora do 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
Essa ação define um parâmetro de sessão HLLAPI avançado. Essa ação só deverá ser usada se você estiver familiarizado com os parâmetros de sessão HLLAPI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Parâmetro
|
Parameter | True | string |
Os parâmetros HLLAPI a serem definidos. Vários parâmetros podem ser separados por vírgulas ou espaços. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir posição do cursor de emulação de terminal
Define a posição atual do cursor em uma sessão mainframe para a posição especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Índice de linha do cursor
|
CursorRowIndex | True | integer |
O índice de linha do cursor no qual definir o cursor. |
|
Índice de coluna do cursor
|
CursorColIndex | True | integer |
O índice de coluna do cursor no qual definir o cursor. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Descartar a DLL de HLLAPI de emulação de terminal
Desliga qualquer subsistema HLLAPI em execução IA-Connect (IA-HLLAPI).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Desconectar-se da sessão de emulação de terminal
Desconecta o subsistema HLLAPI de IA-Connect em execução (IA-HLLAPI) de uma ID de sessão do Mainframe conectada especificada. A ID da sessão é uma ID atribuída pelo emulador de terminal que você está usando para conexões do Mainframe.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Enviar a chave de redefinição para a sessão de emulação de terminal
Envia uma chave de redefinição para a sessão do emulador de terminal. Isso redefinirá toda a entrada e limpará um estado de entrada inválido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Enviar cadeia de caracteres para a sessão de emulação de terminal
Envia uma cadeia de caracteres para uma sessão mainframe na posição atual do cursor. Se você quiser enviar uma cadeia de caracteres para uma posição de cursor específica, poderá usar a ação "Enviar cadeia de caracteres para a sessão de emulação de terminal em posição".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de entrada
|
InputString | True | string |
A cadeia de caracteres a ser inserida. Isso dá suporte a 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 cadeia de caracteres para a sessão de emulação de terminal na posição
Envia uma cadeia de caracteres para uma sessão mainframe na posição do cursor especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Índice de linha do cursor
|
CursorRowIndex | True | integer |
O índice de linha do cursor atual. |
|
Índice de coluna do cursor
|
CursorColIndex | True | integer |
O índice atual da coluna do cursor. |
|
Cadeia de caracteres de entrada
|
InputString | True | string |
A cadeia de caracteres a ser inserida. Isso dá suporte a 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 de terminal
Envia uma senha para uma sessão do Mainframe na posição atual do cursor. Se você quiser enviar uma senha para uma posição específica do cursor, poderá usar a ação "Enviar senha para a sessão de emulação de terminal em posição".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Senha de entrada
|
InputPassword | True | password |
A senha a ser inserida. Isso dá suporte a 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 de terminal na posição
Envia uma senha para uma sessão do Mainframe na posição do cursor especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Índice de linha do cursor
|
CursorRowIndex | True | integer |
O índice de linha do cursor atual. |
|
Índice de coluna do cursor
|
CursorColIndex | True | integer |
O índice atual da coluna do cursor. |
|
Senha de entrada
|
InputPassword | True | password |
A senha a ser inserida. Isso dá suporte a 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 is terminal emulation keyboard unlocked
Retorna se o emulador de terminal está relatando que o teclado está desbloqueado. A saída dessa ação depende de como o emulador específico implementou o HLLAPI e a saída pode variar de emulador para emulador.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
O teclado está desbloqueado
|
KeyBoardIsUnlocked | boolean |
Retornará true se o emulador de terminal estiver relatando que o teclado está desbloqueado. |
Ler a tela de emulação do terminal na posição do cursor
Lê o número especificado de caracteres da sessão Mainframe, começando na posição do cursor especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Índice de linha do cursor
|
CursorRowIndex | True | integer |
O índice de linha do cursor atual. |
|
Índice de coluna do cursor
|
CursorColIndex | True | integer |
O índice atual da coluna do cursor. |
|
Número de caracteres a serem lidos
|
ReadScreenLength | True | integer |
O número de caracteres a serem lidos da sessão mainframe. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Conteúdo da tela
|
ScreenContents | string |
O conteúdo da tela que foi lido da sessão Mainframe. |
Ler linhas de tela de emulação de terminal
Lê as linhas de tela de uma sessão do Mainframe especificada. Essa ação é comumente usada para ler grandes quantidades de dados que podem ser filtradas, se necessário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Iniciar índice de linha
|
StartRowIndex | True | integer |
O índice de linha inicial do qual começar a leitura. |
|
Índice de linha final
|
EndRowIndex | True | integer |
O índice de linha final no qual parar a leitura. |
|
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() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Linhas de tela JSON
|
ScreenRowsJSON | string |
As linhas lidas da sessão Mainframe, no formato JSON. |
Obter o status da conexão de emulação de terminal
Retorna o estado atual da conexão de emulação de terminal na sessão especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Conectado à sessão
|
ConnectedToSession | boolean |
Retornará true se você estiver conectado à ID da sessão especificada ou false, caso contrário. |
|
Sistema ocupado
|
SystemBusy | boolean |
Retornará true se o sistema Mainframe estiver relatando que ele está ocupado no momento ou false se não estiver. |
|
Teclado bloqueado
|
KeyboardLocked | boolean |
Retornará true se a sessão mainframe estiver relatando que o teclado está bloqueado no momento ou false se não estiver. |
|
Sessão em uso por outro aplicativo HLLAPI
|
SessionInUseByAnotherHLLAPIApplication | boolean |
Retornará true se a sessão Mainframe estiver atualmente em uso por outro aplicativo HLLAPI ou false, caso contrário. |
|
HLLAPI thread ID
|
HLLAPIThreadID | integer |
Relata a ID do thread HLLAPI no IA-Connect. Essa saída é apenas para fins de diagnóstico. |
|
COM thread ID
|
COMThreadID | integer |
Relata a ID do thread COM no IA-Connect. Essa saída é apenas para fins de diagnóstico. |
|
Contagem de chamadas
|
CallCount | integer |
Relata o número de ações HLLAPI executadas por IA-Connect nesta sessão. Essa saída é apenas para fins de diagnóstico. |
Obter posição do cursor de emulação de terminal
Obtém a posição atual do cursor em uma sessão mainframe.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Índice de linha do cursor
|
CursorRowIndex | integer |
O índice de linha do cursor atual. |
|
Índice de 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 área de informações do operador de emulação de terminal (OIA)
Retorna a Área de Informações do Operador exibida pelo emulador de terminal. Essa é 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
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Formato OIA
|
OIAFormat | string |
O formato OIA (Área de Informações do Operador), por exemplo, PC400. |
|
Espera do sistema
|
SystemWait | boolean |
Retornará true se o emulador de terminal estiver relatando que o sistema está aguardando a conclusão de uma ação ou false, caso contrário. |
|
CAPS
|
CAPS | boolean |
Retornará true se o emulador de terminal estiver relatando que a tecla CAPS está pressionada no momento ou false, caso contrário. |
|
Tecla SHIFT
|
ShiftKey | boolean |
Retornará true se o emulador de terminal estiver relatando que a tecla SHIFT está pressionada no momento ou false, caso contrário. |
|
Subsistema pronto
|
SubsystemReady | boolean |
Retornará true se o emulador de terminal estiver relatando que o subsistema está pronto ou falso se não estiver. |
|
Modo de inserção
|
InsertMode | boolean |
Retornará true se o emulador de terminal estiver relatando que o modo de inserção está habilitado no momento ou false, caso contrário. |
|
Entrada inválida
|
InvalidInput | boolean |
Retornará true se o emulador de terminal estiver relatando que a sessão mainframe está atualmente em um estado de entrada inválido ou false se não estiver. |
|
Tipo de entrada
|
InputType | string |
O tipo de entrada da sessão mainframe. Isso pode ser APL, Katakana, Alphanumeric, Hiragana ou Double-byte. |
Pesquisar cadeia de caracteres na sessão de emulação de terminal
Pesquisa 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
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
SessionID | True | string |
A ID da sessão mainframe de caractere único, por exemplo, A. |
|
Pesquisar cadeia de caracteres
|
SearchString | True | string |
A cadeia de caracteres a ser pesquisada. |
|
Pesquisar tela inteira
|
SearchEntireScreen | boolean |
A tela inteira deve ser pesquisada? Se definido como false, as entradas "Índice de linha inicial da pesquisa" e "Índice de coluna inicial de pesquisa" poderão ser usadas para restringir a área de pesquisa. |
|
|
Índice de linha inicial da pesquisa
|
SearchStartRowIndex | integer |
O índice de linha no qual começar a pesquisar a cadeia de caracteres especificada, começando a partir de 1. Esse valor só será usado se 'Pesquisar tela inteira' for definido como false. |
|
|
Índice de coluna de início de pesquisa
|
SearchStartColIndex | integer |
O índice de coluna no qual começar a pesquisar a cadeia de caracteres especificada, começando em 1. Esse valor só será usado se 'Pesquisar tela inteira' for definido como false. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Cadeia de caracteres encontrada
|
StringFound | boolean |
Retorna true se a cadeia de caracteres especificada foi encontrada. |
|
Posição encontrada da cadeia de caracteres
|
StringFoundPosition | integer |
Se a cadeia de caracteres foi encontrada, esse parâmetro mantém a posição absoluta do primeiro caractere na cadeia de caracteres 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. |
|
Cadeia de caracteres encontrada índice de linha
|
StringFoundRowIndex | integer |
Se a cadeia de caracteres tiver sido encontrada, esse parâmetro conterá o índice de linha do primeiro caractere na cadeia de caracteres de pesquisa. |
|
Cadeia de caracteres encontrada índice de coluna
|
StringFoundColIndex | integer |
Se a cadeia de caracteres tiver sido encontrada, esse parâmetro conterá o índice de coluna do primeiro caractere na cadeia de caracteres de pesquisa. |
Redefinir sessão de emulação de terminal
Redefine a sessão do Mainframe atual. A ação desconecta IA-Connect Agent 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-se à Sessão" para continuar interagindo com ela.
Parâmetros
| Nome | Chave | Obrigató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 do Mainframe conectada. Alguns emuladores de terminal podem não retornar valores para todas as saídas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome longo da sessão
|
SessionLongName | string |
O nome longo da sessão mainframe, por exemplo, SessionA. |
|
Tipo de sessão
|
SessionType | string |
O tipo de sessão 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 na exibição. |
|
Página de código
|
CodePage | integer |
A página de código, indicando a codificação de caractere que está sendo usada. |