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 - Legado | janelas

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. Esse campo é compatível apenas com 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 na atividade Try Catch e o valor da propriedade Continuar com erro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - 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 TerminalSession . Essa variável pode ser passada para outras atividades Terminal Session no campo de propriedade Conexão Existente se você quiser reutilizar a conexão já estabelecida. Este campo é compatível apenas com variáveis TerminalSession .

Opções

• DelayMS - Tempo de atraso (em milissegundos) antes que a atividade comece a executar qualquer operação. O valor padrão é 1000 milissegundos (1 segundo).
• TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que um erro seja lançado. O valor padrão é 50.000 milissegundos (50 segundos).

Propriedades da Conexão SSH

• Senha SSH - A senha do SecureShell usada para conectar ao terminal especificado, armazenada em uma variável SecureString . Este campo suporta apenas SecureString variáveis.
• Nome de usuário SSH - o nome de usuário do SecureShell usado para conectar ao terminal especificado, armazenado em uma variável String . Este campo suporta apenas strings e variáveis String .

Usar Conexão Existente

• Encerrar conexão — se esta caixa de seleção estiver marcada, a conexão existente será encerrada após a interrupção da execução da atividade. 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 TerminalSession 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 TerminalSession .

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 de host do sistema de ambiente de terminal.
• Porta - Um número de porta onde o sistema de ambiente de 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:
  • Telnet - O protocolo Telnet.
  • SSH - O protocolo SSH usado pela maioria dos sistemas Unix/Linux.
  • HPVT - Protocolo específico da HP usado em conjunto com a emulação de terminais do HP Series.
• Modo do terminal - A versão específica da emulação de terminal. O valor disponível aqui depende do valor escolhido no campo Tipo.
• 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 Tennet para especificar que o sistema de ambiente de terminal usa uma conexão criptografada SSL ou TLS.
• Nome LU — o nome da unidade lógica, usado com os tipos de terminal da família IBM.
• Resposta - Uma mensagem de texto a ser enviada ao sistema do host quando o terminal receber 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 fica disponível apenas quando o tipo de terminal selecionado for VT.
• Tipo de proxy - O tipo de protocolo usado pelo Servidor do Proxy:
  • Nenhum (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

O provedor IBM EHLLAPI funciona com qualquer software de emulação de terminal de terceiros que implemente a API EHLL. Os detalhes para a implementação da API EHLL devem ser encontrados na documentação do software do emulador de terminal de terceiros.

Nota: O software de emulação de terminal precisa ser iniciado e conectado antes de tentar se conectar a ele via EHLLAPI.

Configurações de conexão

• Dll de EHLL — o caminho para o dll usado para implementar o EHLLAPI no software emulador de terminal de terceiros.
• Função da EHLL — o nome da função de ponto de entrada na dll da EHLL. Geralmente, "hlapi".
• Sessão EHLL — o nome da sessão como aparece no software de emulação de terminal. 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 terminal para a conexão fornecida.
• EHLL aprimorada — usada para especificar se o emulador de terminal 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. As atividades no nível do campo (Get Field, Set Field etc) estão funcionando nesse 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 de 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 do EHLLAPI padrão.

O provedor Attachmate Reflection

O provedor Attachmate Reflection funciona com o emulador de terminal Attachmate Reflection.

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 de host do sistema de ambiente de terminal.
  • Porta - Um número de porta onde o sistema de ambiente de 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.