Terminal Session

UiPath.Terminal.Activities.TerminalSession

Um contêiner que se conecta a um terminal e permite que você execute várias ações dentro dele. Depois que a atividade é arrastada para o designer de fluxo de trabalho, a janela Configurar conexão é aberta. Se fechado, pode ser reaberto usando o botão Configurar conexão... no corpo da atividade.

Depois que uma conexão é configurada, o botão Iniciar Gravador pode ser usado para conectar ao terminal e gravar as ações necessárias. O botão é colocado no corpo da atividade.

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 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 de acordo com o tipo de provedor escolhido para fazer a conexão com o ambiente do terminal.

Propriedades independentes do provedor escolhido:

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

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.

Propriedades de configuraçã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 - comumente usado por sistemas IBM Z-series
  • TN5250 - comumente usado por sistemas IBM I-series (AS-400)
  • VT - Terminais compatíveis com DEL
  • Série HP - Emulação de terminal específica da HP
  • Tandem - Emulação de terminal de sistemas tandem
  • Wise - Emulação de terminal da série Wise
  • ANSI - Emulação de terminal baseada na especificação ANSI
  • Sco ANSI - Extensão da especificação ANSI usada por sistemas SCO Unix

• Protocolo — o protocolo de comunicação a ser usado para a conexão:

  • Filnet — o protocolo Filnet
  • SSH - O protocolo SSH usado pela maioria dos sistemas Unix/Linux
  • HPT - Protocolo específico da HP usado em conjunto com a emulação de terminal da série HP
• 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ódigos usada pelo sistema do 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.

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.

Propriedades de configuraçã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ódigos usada pelo sistema do 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 ao nível de campo para um melhor desempenho. Observe que as atividades em nível de campo (Get Field, Set Field, etc.) não funcionarão neste modo.
• Executar no processo - Controla a maneira como a comunicação com a emulação de terminal de terceiros é feita por meio da API da EHLL. Por padrão, isso está desabilitadoe, neste caso, a comunicação é feita por meio de um processo proxy, um executável diferente que faz parte do pacote de atividades do terminal. No runtime, o processo proxy se comunicará com o processo do UiPath Executor por meio do IPC (Comunicação entre processos). Quando habilitado, a comunicação com o software de emulação de terminal 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 por software antivírus ou por políticas de segurança de software.

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 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.

O provedor Attachmate Reflection

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

Propriedades de configuração:

• Anexar à sessão existente - Neste modo, espera-se que o emulador de terminal já esteja iniciado e conectado. Nenhum perfil de configuração será usado nesse caso.
• Usar um perfil existente - Neste modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminal será iniciado automaticamente.

• Especificar endereço manualmente — neste modo, nenhum perfil de configuração será usado. As propriedades de configuração precisam ser especificadas manualmente:

  • Endereço — Endereço IP ou nome de host do sistema do ambiente do 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 Attachmate Extra

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

Propriedades de configuração:

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

O provedor Reflection for UNIX

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

Propriedades de configuração:

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

O provedor Reflection for IBM

O provedor Reflection for IBM funciona com o emulador de terminal Reflection for IBM.

Propriedades de configuração:

• Usar um perfil existente - Neste modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminal será iniciado automaticamente.

• Especificar endereço manualmente — neste modo, nenhum perfil de configuração será usado. As propriedades de configuração precisam ser especificadas manualmente:

  • Endereço — Endereço IP ou nome de host do sistema do ambiente do 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 Rocket BlueZone

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

Propriedades de configuração:

• Usar um perfil existente - Neste modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminal será iniciado automaticamente.

• Especificar endereço manualmente — neste modo, nenhum perfil de configuração será 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.

Propriedades de configuração:

• Usar um perfil existente - Neste modo, o caminho para um perfil de configuração precisa ser fornecido. O emulador de terminal será iniciado automaticamente.

Práticas recomendadas para atividades de terminal

• Ao usar as propriedades Conexão de saída/Conexão existente , certifique-se de fechar a Sessão de terminal quando ela não for mais necessária no fluxo de trabalho/processo. Deixar a Sessão de terminal aberta pode ter efeitos negativos no desempenho e na execução de outras sessões de terminal. Para fechar corretamente uma Sessão de Terminal salva anteriormente, adicione uma nova Sessão de Terminal (com o corpo vazio) ao seu fluxo de trabalho, com as seguintes propriedades:
  • Fechar conexão: Verdadeiro
  • Conexão existente: a variável TerminalSession que contém a sessão salva
• Evite usar as propriedades Conexão de saída/Conexão existente em conjunto com o provedor IBM EHLLAPI . Essas opções são usadas para garantir a persistência da conexão entre fluxos de trabalho. Como a conexão já persiste no emulador de terminal, uma segunda camada de persistência não é necessária. Além disso, isso evita a necessidade de executar etapas extras para fechar a conexão, conforme descrito acima.
• Evite usar Sessões de terminal aninhadas em outras Sessões de terminal. Isso também se aplica ao aninhamento indireto, como chamar de um corpo de Sessão de Terminal um fluxo de trabalho que contém uma Sessão de Terminal com a mesma conexão, ou chamar uma função de biblioteca que contém uma Sessão de Terminal com a mesma conexão.
• Evite usar atividades baseadas em campo, como Get Field/Set Field. Nem sempre fica claro se a tela é dividida em campos ou como isso pode levar a confusão. Além disso, diferentes provedores podem dividir a mesma tela de maneiras diferentes porque APIs diferentes são usadas. É mais seguro usar métodos semelhantes ao que humanos usarão, como combinações de atividades Move Cursor ou Send Control Key = Tab seguida de Send Keys para enviar dados para a tela. Para recuperar dados da tela, use Get Screen Área ou Get Text At Position.
• Use a atividade Aguardar texto da tela para garantir que a tela correta foi carregada antes de fazer qualquer operação nela
• Para extrair dados tabulares de telas no formato DataTable, use a atividade Get Screen Area para a parte da tela que contém a tabela e use a saída dessa atividade como entrada para a atividade Generate Data Table , do pacote UiPath.System.Activities .