Terminal Session

UiPath.Terminal.Activities.TerminalSession

Description

A container that connects to a terminal and enables you to perform multiple actions within it.

Compatibilidade do projeto

Windows - Legacy | Windows

Configuração

Painel do Designer

• Configurar conexão... - Permite que você configure uma conexão. Depois que a atividade é arrastada para o designer de fluxo de trabalho, a janela Configurar conexão é aberta. Se estiver fechada, pode ser reaberta usando essa opção.
• Iniciar gravador - Depois que uma conexão é configurada, o botão Iniciar gravador pode ser usado para se conectar ao terminal e gravar as ações necessárias.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• DisplayName - O nome de exibição da atividade.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Nova Sessão

• String de conexão - A string que contém os detalhes da conexão. Este campo é compatível apenas com strings e variáveis String .
• Conexão de saída — a conexão estabelecida, armazenada em uma variável TerminalConnection . Essa variável pode ser passada para outras atividades Terminal Session no campo da propriedade Conexão Existente se você quiser reutilizar a conexão que já está estabelecida. Este campo é compatível apenas com variáveis TerminalConnection .

Opções

• DelayMS - Delay time (in milliseconds) before the activity begins performing any operations. The default value is 1000 milliseconds (1 second).
• TimeoutMS - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 50000 milliseconds (50 seconds).

Propriedades da Conexão SSH

• SSH Password - The SecureShell password used to connect to the specified terminal, stored in a SecureString variable. This field supports only SecureString variables.
• SSH Username - The SecureShell username used to connect to the specified terminal, stored in a String variable. This field supports only strings and String variables.

Usar Conexão Existente

• Fechar conexão — se esta caixa de seleção estiver marcada, a conexão existente será encerrada depois que a atividade interromper a execução. Por padrão, essa caixa de seleção fica marcada. Observe que essa propriedade será ignorada se a propriedade Conexão de saídaestiver definida.
• Conexão existente - Fornecer uma variável TerminalConnection neste campo de propriedade usa a conexão armazenada na variável para se conectar a um terminal. Este campo é compatível apenas com variáveis TerminalConnection .

A janela Configurar Conexão

A janela Configurar conexão contém várias opções de configuração que variam dependendo do tipo de provedor escolhido para fazer a conexão com o ambiente do terminal.

Propriedades independentes do provedor escolhido:

• Mostrar aplicativo do cliente - Se marcado, exibe uma visualização da tela do terminal no runtime.

O provedor de conexão direta

O provedor Direct Connection é um provedor UiPath interno que não precisa de nenhum software de emulação de terminal de terceiros na máquina do robô. A emulação é feita pelo robô, em tempo de execução.

Configurações de conexão

• Endereço - Endereço IP ou nome do host do sistema de ambiente do terminal.
• Porta - Um número de porta onde o sistema de ambiente do terminal aceita conexões.
• Tipo - O tipo de emulação de terminal necessária:
  • TN3270 - Usado comumente pelos sistemas IBM Z-series.
  • TN5250 - Usado comumente pelos sistemas IBM I-series (AS-400).
  • VT - Terminais compatíveis com DEC VT.
  • HP Series - Emulação de terminal específica da HP.
  • Tandem - Emulação de terminais de sistemas em tandem.
  • Wyse - Emulação de terminais da Wyse series.
  • ANSI - Emulação de terminal com base na especificação ANSI.
  • Sco ANSI - Extensão da especificação ANSI usada pelos sistemas SCO Unix.
• Protocolo — o protocolo de comunicação a ser usado para a conexão:
  • Telas - O protocolo Telnet.
  • SSH - O protocolo SSH usado pela maioria dos sistemas Unix/Linux.
  • HPHT - Protocolo específico da HP usado em conjunto com a emulação de terminais do HP Series.
• Modo de terminal - A versão específica da emulação de terminais. O valor disponível aqui depende do valor escolhido no campo Type.
• Codificação - A página de código usada pelo sistema de ambiente do terminal. O padrão é IBM037 para os terminais da família IBM e ASCII para outros tipos de terminais.
• Habilitar SSL/TLS - Usado em conjunto com o protocolo Esseta, para especificar que o sistema de ambiente do terminal use uma conexão criptografada por SSL ou TLS.
• Nome LU - O nome da unidade lógica, usado com os tipos de terminais da família IBM.
• Modo básico - Um modo que desabilita o processamento no nível do campo para melhor desempenho. Atividades de nível de campo, como Get Field, Set Field, não são compatíveis com esse modo.
• Resposta de volta - Uma mensagem de texto a ser enviada para o sistema do host quando o terminal recebe o caractere de controle ENQ . A mensagem pode conter a chave de controle Enter, codificada no valor da string como ^M. Esta opção de configuração está disponível apenas quando o tipo de terminal selecionado é VT.
• Tipo de proxy - O tipo de protocolo usado pelo Servidor do Proxy:
  • None (padrão) - Sem proxy
  • Túnel - Proxy HTTPS.
  • SOCKS4
  • SOCKS5
  • SOCKS4A
• Host do Proxy - Endereço IP ou nome do host do Servidor do Proxy.
• Porta do Proxy - O número da porta usado pelo Servidor do Proxy.
• Usuário do Proxy - O nome de usuário a ser usado para autenticação no Servidor do Proxy.
• Senha do Proxy - A senha a ser usada para autenticação no Servidor do Proxy.
  Observação:

  O provedor de conexão direta usa uma biblioteca DLL nativa que não é assinada pela UiPath. A biblioteca é chamada ttermdotnet.dll. Se você usar esse provedor, você precisa permitir o carregamento e a execução dessa biblioteca.

O provedor IBM EHLLAPI

The IBM EHLLAPI provider works with any 3rd party terminal emulation software that implements the EHLL API. The details for the implementation of the EHLL API should be found in the 3rd party terminal emulator software documentation.

Observação:

The terminal emulation software needs to be started and connected before attempting to connect to it via EHLLAPI.

Configurações de conexão

• Dll de EHLL – O caminho para a dll usada para implementar o EHLLAPI no software emulador de terminais de terceiros.
• Função EHLL - O nome da função de ponto de entrada na dll do EHLL. Geralmente, "hllapi".
• Sessão EHLL - O nome da sessão como aparece no software de emulação de terminais. Geralmente "A", mas ao usar várias sessões simultâneas, o valor pode variar.
• Codificação EHLL - A codificação usada pelo software de emulação de terminais para a conexão fornecida.
• EHLL aprimorada - Usado para especificar se o emulador de terminais de terceiros implementa a versão padrão ou aprimorada da API do EHLL.
• Codificação - A página de código usada pelo sistema de ambiente do terminal. O padrão é IBM037 para os terminais da família IBM e ASCII para outros tipos de terminais.
• Modo básico - Um modo que desabilita o processamento no nível do campo para melhor desempenho. Atividades de nível de campo, como Get Field, Set Field, não são compatíveis com esse modo.
• Execução em processo - Controla a maneira como a comunicação com a emulação de terminais de terceiros é feita por meio da API do EHLL. Por padrão, isso é desabilitado e, nesse caso, a comunicação é feita por meio de um processo de proxy, um executável diferente que faz parte do pacote de atividades do terminal. No runtime, o processo do proxy se comunica com o processo do UiPath Executor por meio do IPC (Comunicação entre processos). Quando habilitada, a comunicação com o software de emulação de terminais de terceiros é feita dentro do processo do UiPath Executor. Essa opção deve ser habilitada apenas se o funcionamento adequado do processo de proxy for impedido pelo software antivírus ou pelas políticas de segurança de software.
  Observação:

  Alterar o parâmetro Run in process para True pode resultar na sessão do terminal não funcionando corretamente devido à diferença na arquitetura (32 bits versus 64 bits) entre o emulador de terceiros e o processo do UiPath Studio/Executor. As bibliotecas EHLL de 32 bits só funcionam corretamente em projetos do Windows - Legado, enquanto as bibliotecas EHLL de 64 bits só funcionam corretamente em projetos do Windows.

Observação:

Devido a uma limitação na especificação do EHLLAPI, a versão aprimorada do EHLLAPI não suporta o trabalho com várias sessões do EHLLAPI quando a opção Executar no processo está marcada. Apenas a implementação padrão do EHLLAPI é compatível com esse cenário. Isso significa que a opção EHLL aprimorada está desmarcada e o arquivo DLL listado no campo EHLL dll é uma versão que implementa a especificação EHLLAPI padrão.

The TandemHLLAPI provider

The TandemHLLAPI provider works only with the Reflection Desktop NonStop AddOn terminal emulation software that is used to connect to Tandem/HP NonStop terminal hosts. It implements the an API similar to HLLAPI, called THLLAPI.

Observação:

The terminal emulation software needs to be started and connected before attempting to connect to it via EHLLAPI.

Configurações de conexão

• EHLL dll - The path to the dll used for implementing the THLLAPI in Reflection NonStop AddOn. Usually THLLW6.DLL for the 64-bit version and THLLW3.DLL for the 32-bit version.
• EHLL function - The name of the entry point function in the THLLAPI dll. Usually, "thllapi".
• EHLL session - The name of the session as it appears in the terminal emulation software. Usually "A", but when using multiple simultaneous sessions, the value may vary.
• Codificação EHLL - A codificação usada pelo software de emulação de terminais para a conexão fornecida.
• Basic mode - A mode that disables field level processing for better performance. Field-level activities, such as Get Field, Set Field, do not support this mode.
• Execução em processo - Controla a maneira como a comunicação com a emulação de terminais de terceiros é feita por meio da API do EHLL. Por padrão, isso é desabilitado e, nesse caso, a comunicação é feita por meio de um processo de proxy, um executável diferente que faz parte do pacote de atividades do terminal. No runtime, o processo do proxy se comunica com o processo do UiPath Executor por meio do IPC (Comunicação entre processos). Quando habilitada, a comunicação com o software de emulação de terminais de terceiros é feita dentro do processo do UiPath Executor. Essa opção deve ser habilitada apenas se o funcionamento adequado do processo de proxy for impedido pelo software antivírus ou pelas políticas de segurança de software.
  Observação:

  Alterar o parâmetro Run in process para True pode resultar na sessão do terminal não funcionando corretamente devido à diferença na arquitetura (32 bits versus 64 bits) entre o emulador de terceiros e o processo do UiPath Studio/Executor. As bibliotecas EHLL de 32 bits só funcionam corretamente em projetos do Windows - Legado, enquanto as bibliotecas EHLL de 64 bits só funcionam corretamente em projetos do Windows.

O provedor Attachmate Reflection

The Attachmate Reflection provider works with the Attachmate Reflection terminal emulator.

Disponível apenas para projetos do Windows - Legado.

Configurações de conexão

• Anexar à sessão existente - Nesse modo, espera-se que o emulador de terminais já esteja iniciado e conectado. Nenhum perfil de configuração é usado nesse caso.
• Usar um perfil existente - Nesse modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.
• Especificar endereço manualmente - Nesse modo, nenhum perfil de configuração é usado. As propriedades de configuração precisam ser especificadas manualmente:
  • Endereço - Endereço IP ou nome do host do sistema de ambiente do terminal
  • Porta - Um número de porta onde o sistema de ambiente do terminal aceita conexões
  • Tipo - O tipo de emulação de terminal necessária:
    • TN3270
    • TN5250
    • VT

O provedor Attachmate Extra

O provedor Attachmate Extra funciona com o Attachmate Extra! emulador de terminal.

Configurações de conexão

Usar um perfil existente - Um caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.

O provedor Reflection for UNIX

O provedor Reflection for UNIX funciona com o emulador de terminal Reflection for Unix.

Configurações de conexão

Usar um perfil existente - Um caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.

O provedor Reflection for IBM

O provedor Reflection for IBM funciona com o Reflection para o emulador de terminais da IBM.

Configurações de conexão

• Usar um perfil existente - Nesse modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.
• Especificar endereço manualmente - Nesse modo, nenhum perfil de configuração é usado. As propriedades de configuração precisam ser especificadas manualmente:
  • Endereço - Endereço IP ou nome do host do sistema de ambiente do terminal
  • Porta - Um número de porta onde o sistema de ambiente do terminal aceita conexões
  • Tipo - O tipo de emulação de terminal necessária:
    • TN3270
    • TN5250
    • VT

O provedor Rocket BlueZone

O provedor Rocket BlueZone funciona com o emulador de terminais Rocket BlueZone.

Configurações de conexão

• Usar um perfil existente - Nesse modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.
• Especificar endereço manualmente - Nesse modo, nenhum perfil de configuração é usado. As propriedades de configuração precisam ser especificadas manualmente:
  • Endereço - Endereço IP ou nome do host do sistema de ambiente do terminal.
  • Porta - Um número de porta onde o sistema de ambiente do terminal aceita conexões.
  • Tipo - O tipo de emulação de terminal necessária:
    • TN3270
    • TN5250
    • VT

O provedor IBM Personal Communications

O provedor IBM Personal Communications funciona com o emulador de terminal IBM Personal Communications.

Configurações de conexão

• Usar um perfil existente - Nesse modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminais é iniciado automaticamente.