Compartilhar via


Sessão IA-Connect

IA-Connect é uma plataforma de Automação de Processos Robóticos 'RPA' que adiciona a funcionalidade RPA da Nuvem a máquinas virtuais locais ou em conexões Citrix ou RDS da Área de Trabalho Remota da Microsoft. Este é o módulo para automatizar o ambiente, a sessão, o gerenciamento de arquivos e a configuração do IA-Connect.

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
Email IAConnect@ultima.com
Metadados do conector
Publicador Ultima Business
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 800 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
  • JML de 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 800 ações em todas as 9 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

A porta TCP está respondendo

Relata se uma porta TCP de rede está respondendo a uma tentativa de conexão pelo agente IA-Connect. Pode ser uma porta TCP no computador em que o agente de IA-Connect está em execução (insira 'localhost' para o host remoto) ou em qualquer computador remoto. Se o agente de IA-Connect se conectar com êxito a uma porta TCP, ele fechará imediatamente a conexão TCP.

A sessão está bloqueada

Informa se a sessão em que o agente IA-Connect está em execução está bloqueada.

A sessão IA-Connect existe por nome

Retorna se a sessão IA-Connect Director especificada existir. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Adiar a operação de tarefa de automação do Orchestrator existente

Adie uma tarefa existente do Orchestrator que já está na fila. A tarefa será adiada para um horário especificado no futuro. Isso geralmente é usado para adiar novamente uma tarefa existente (ou seja, a tarefa foi adiada anteriormente e agora precisa ser adiada novamente). Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Adiar a tarefa de automação do Orchestrator existente

Adie uma tarefa existente do Orchestrator que já está na fila. A tarefa será adiada para um horário especificado no futuro. Isso geralmente é usado para adiar novamente uma tarefa existente (ou seja, a tarefa foi adiada anteriormente e agora precisa ser adiada novamente). Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Adicionar arquivo ao ZIP

ZIPs um arquivo (armazena o arquivo em um arquivo de compactação).

Adicionar nova operação de tarefa adiada do Orchestrator

Adicione uma nova tarefa adiada do Orchestrator e receba uma ID da operação. A tarefa será adiada para um horário especificado no futuro. Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo). Um nome de tarefa específico será necessário se a tarefa estiver sendo processada por um sondador externo ou um gatilho Orchestrator. Essa ação difere de "Adicionar nova tarefa adiada do Orchestrator" (TasksAddNewDeferral) na medida em que ela responde com uma ID de operação inválida, em vez de uma ID de tarefa adivinho.

Adicionar nova operação de tarefa de automação do Orchestrator

Adicione uma nova tarefa de automação do Orchestrator e receba uma ID da operação. Um nome de tarefa específico será necessário se a tarefa estiver sendo processada por um sondador externo ou um gatilho Orchestrator. Essa ação difere de "Adicionar nova tarefa de automação do Orchestrator" (TasksAddNewTaskOperation) na medida em que ela responde com uma ID de Operação indissível, em vez de uma ID de Tarefa adivinhada.

Adicionar nova tarefa adiada do Orchestrator

Adicione uma nova tarefa adiada do Orchestrator em uma fila que pode ser monitorada de um Flow. A tarefa será adiada para um horário especificado no futuro. Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Adicionar nova tarefa de automação do Orchestrator

Adicione uma nova tarefa de automação do Orchestrator em uma fila que pode ser monitorada de um Flow. As tarefas podem estar prontas para serem executadas imediatamente ou adiadas para serem executadas posteriormente.

Adicionar pasta ao ZIP

Arquivos ZIPs em uma pasta em um arquivo ZIP (armazena os arquivos em um arquivo de compactação).

Adicionar permissão ao arquivo

Adiciona uma permissão a um arquivo no computador em que o agente de IA-Connect está em execução.

Adicionar permissão à pasta

Adiciona uma permissão a uma pasta no computador em que o agente IA-Connect está em execução.

Adicionar uma anotação a uma tarefa de automação do Orchestrator

Adiciona uma anotação a uma tarefa de automação do Orchestrator selecionada. Essa observação será passada para o sistema de origem vinculado a essa tarefa de automação (por exemplo, ServiceNow) e é mais comumente usada para adicionar detalhes a um tíquete. Se a tarefa de automação orchestrator não estiver vinculada a uma origem, uma exceção será gerada.

Aguarde a conclusão do thread do Agente com êxito

Aguarda que um thread do Agente seja concluído e, opcionalmente, recupere os dados de saída do thread. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Se o thread do Agente for concluído, mas em falha, uma exceção será gerada.

Aguarde IA-Connect sessão do próximo salto se conectar

Aguarda a próxima sessão de salto se conectar e para que o agente do IA-Connect esteja em execução na próxima sessão de salto.

Aguarde IA-Connect sessão fechar por nome

Aguarda o fechamento da sessão do IA-Connect Director especificado. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Alocar trabalho do Orchestrator

Aloca um trabalhador do Orquestrador de IA-Connect. Você pode solicitar um trabalho por marca ou nome de trabalho (ou nenhum dos dois), permitindo que você escolha com mais precisão qual trabalho você precisa. Depois que um trabalho é alocado, ele é atribuído ao seu fluxo e será relatado como executando o trabalho. Observe que o Orchestrator ainda considerará 'IDs de ambiente de fluxo com suporte', 'Nomes de fluxo com suporte' e 'Nomes de fluxo sem suporte' ao executar a alocação. Quando vários trabalhadores corresponderem à pesquisa, as regras normais de balanceamento de carga serão aplicadas.

Alterar o status da tarefa de automação do Orchestrator

Altera o status da tarefa de automação do Orchestrator selecionada ou outras propriedades de tarefa.

Anexar à sessão de IA-Connect camada 1

Anexa-se à sessão IA-Connect Director do Diretor que recebe as mensagens SOAP e/ou REST. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Anexar à sessão de IA-Connect mais recente

Anexa-se à sessão IA-Connect Director que mais recentemente se conectou (opcionalmente de um tipo especificado). Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Anexar à sessão IA-Connect pelo nome

Anexa-se à sessão do IA-Connect Director especificada pelo nome. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Anexar à sessão IA-Connect por índice

Anexa-se à sessão do IA-Connect Director especificada por índice (por exemplo, anexar à primeira sessão do Citrix ICA). Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Armazenar senha na memória do Agente

Armazene uma senha na memória do Agente (criptografada), na qual ela pode ser usada em qualquer ação que dê suporte a senhas armazenadas. As senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado.

Arquivo UnZIP

Descompacta um arquivo que foi compactado usando compactação ZIP.

Arrastar o mouse do meio entre coordenadas

Executa um arrastar de botão do mouse do meio entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Arrastar o mouse para a direita entre coordenadas

Executa um arrastar de botão direito do mouse entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Arrastar o mouse à esquerda entre coordenadas

Executa um arrastar de botão esquerdo do mouse entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Atribuir uma tarefa de automação do Orchestrator

Atribui uma tarefa de automação do Orchestrator selecionada a um usuário ou grupo especificado. Essa atribuição será passada para o sistema de origem vinculado a essa tarefa de automação (por exemplo, ServiceNow) e é mais comumente usada para passar um tíquete para outra pessoa ou grupo de pessoas, para processamento adicional. Se a tarefa de automação orchestrator não estiver vinculada a uma origem, uma exceção será gerada.

Atualizar o resultado das estatísticas do Orchestrator Flow

Atualize as estatísticas de resultado do Fluxo de Trabalho atual no Orquestrador de IA-Connect. Isso é usado para modificar o resultado final de uma estatística de Fluxo no Orquestrador de IA-Connect que normalmente é usado para fins de relatório. Isso só funciona para o Fluxo atual (o Orchestrator detecta a ID de execução do Flow). Você não pode modificar as estatísticas para qualquer outro Flow.

Baixar arquivo HTTP

Baixa um arquivo no computador em que o agente de IA-Connect está em execução usando HTTP(S).

Botão direito do mouse para baixo

Pressiona (e não libera) o botão direito do mouse na sessão de usuário do agente IA-Connect. Para liberar o mouse, use a ação de botão direito do mouse.

Botão direito do mouse para cima

Libera o botão direito do mouse na sessão de usuário do agente do IA-Connect.

Botão do mouse do meio para baixo

Pressiona (e não libera) o botão do mouse do meio na sessão de usuário do agente do IA-Connect. Para liberar o mouse, use a ação do botão do mouse central.

Botão do mouse do meio para cima

Libera o botão do mouse do meio na sessão de usuário do agente do IA-Connect.

Botão esquerdo do mouse para baixo

Pressiona (e não libera) o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect. Para liberar o mouse, use a ação do botão esquerdo do mouse.

Botão esquerdo do mouse para cima

Libera o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Calibrar mouse_event

Calibra o método mouse_event movendo o mouse pelo número especificado de pixels e lendo a nova posição do mouse.

Captura de tela

Captura de tela da sessão de usuário do agente IA-Connect e a retorna como uma cadeia de caracteres codificada em Base64.

Clique com o botão direito do mouse

Clica no botão direito do mouse na sessão de usuário do agente do IA-Connect.

Clique com o botão direito do mouse na coordenada

Clica no botão direito do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Clique com o botão esquerdo do mouse na coordenada

Clica no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Clique duas vezes no mouse à esquerda

Clique duas vezes no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Clique duas vezes no mouse à esquerda na coordenada

Clique duas vezes no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Clique no mouse à esquerda

Clica no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Colocar a GUI do agente de IA-Connect na frente

Traz a GUI do agente de IA-Connect para a frente para que ela fique visível na tela.

Configurar o próximo salto IA-Connect Director

Configure o diretor de próximo salto em um cenário de salto duplo. Isso só será necessário se o padrão IA-Connect configurações de diretório de próximo salto não forem adequadas.

Converter coordenadas de retângulo

Converte uma coordenada de pixel de retângulo de virtual para físico ou físico em virtual. Se você quiser converter um ponto, basta definir Right=Left e Bottom=Top. As coordenadas físicas são mapeadas diretamente para pixels no monitor. As coordenadas virtuais são dimensionadas por DPI. Se o dimensionamento de exibição subjacente de todos os dispositivos de exibição for de 100%, as coordenadas físicas e virtuais serão as mesmas.

Copiar arquivo

Copia um arquivo no computador em que o agente de IA-Connect está em execução.

Copiar arquivo de cliente para servidor

Copia um arquivo do computador local (executando o IA-Connect Director) para o computador remoto (executando o agente IA-Connect).

Copiar arquivo para área de transferência

Copia o arquivo local especificado para a área de transferência na sessão de usuário do agente do IA-Connect.

Criar arquivo de inicialização da RDS (Sessão de Área de Trabalho Remota)

Crie um arquivo de inicialização de RDS (Sessão de Área de Trabalho Remota) que pode ser usado para iniciar automaticamente uma Sessão de Área de Trabalho Remota usando parâmetros especificados, em vez de exigir a automação da interface do usuário do cliente da Área de Trabalho Remota. Um arquivo de inicialização de RDS tem a extensão '.rdp' e geralmente é chamado de arquivo RDP.

Criar diretório

Cria um diretório (pasta) no computador em que o agente IA-Connect está em execução.

Criar segredo único do Orchestrator

Um segredo único fornece uma instalação para armazenar um segredo que pode ser recuperado uma vez, por meio de uma URL exclusiva indissível. Normalmente, isso é usado para compartilhar segredos com terceiros. Você pode criar um segredo único usando a interface do usuário do Orchestrator, a API REST ou seu fluxo.

Definir a configuração de coordenadas globais do agente de IA-Connect

Configura o sistema de coordenadas globais IA-Connect Agent, que é usado para exibir locais de elementos (por exemplo: durante a inspeção do mouse) e calcular posições do mouse (por exemplo: ao executar ações globais do mouse). Os padrões fornecem a funcionalidade mais recente, mas você pode usar essa ação para reverter para o comportamento em versões anteriores do Agente ou especificar que uma API está usando um sistema de coordenadas diferente.

Definir a gui do agente de IA-Connect mais alto

Define o agente de IA-Connect como superior. Isso significa que o agente de IA-Connect sempre estará visível na tela e não poderá ficar oculto atrás de outras janelas do aplicativo.

Definir a opacidade de GUI do agente de IA-Connect

Define a opacidade do agente de IA-Connect de 1 (visível) para 0 (transparente).

Definir a posição de GUI do agente de IA-Connect

Define a posição na tela da GUI do agente IA-Connect para o local especificado.

Definir dados de saída da tarefa de automação do Orchestrator

Define os dados de saída para uma tarefa de automação do Orchestrator. Normalmente usado quando você concluiu uma tarefa e deseja fornecer dados de saída, para ser coletado pelo processo que criou a tarefa.

Definir IA-Connect chave de licença

Licencia o agente IA-Connect com uma chave de licença. Pode ser uma cadeia de caracteres de licença ou o nome amigável de uma licença mantida no Orchestrator IA-Connect.

Definir IA-Connect código de licença

Carrega uma licença de domínio do agente de estilo antigo (7.0 e 7.1) para o agente IA-Connect.

Definir impressora padrão

Define a impressora padrão para o usuário na sessão IA-Connect Agent.

Definir leitor de tela

Habilita ou desabilita o leitor de tela na sessão de usuário do agente do IA-Connect.

Definir multiplicador de mouse

Define o multiplicador de mouse global na sessão de usuário do agente do IA-Connect. Isso pode ser útil durante o desenvolvimento se você encontrar problemas com o dimensionamento de área de trabalho remota.

Definir o modo de manutenção de trabalho do Orchestrator

Coloque um IA-Connect trabalho definido no IA-Connect Orchestrator no modo de manutenção (para que os fluxos não sejam atribuídos ao trabalho) ou tire um trabalho do modo de manutenção.

Definir o método de movimentação do mouse

Define o método de movimentação do mouse atual como mouse_event ou setcursorpos.

Definir o nível de log do Agente IA-Connect

Define o nível de log do agente de IA-Connect para o valor especificado (1 sendo o nível mais baixo e 4 sendo o mais alto).

Definir o nível de log do IA-Connect Director

Define o nível de log do IA-Connect Director como o valor especificado. Os níveis de registro em log são definidos de 0 a 4. 0 está desabilitado. 1 é o nível de log mais baixo (e o padrão). 4 é o nível de log mais alto.

Definir o tempo limite de comando do agente de IA-Connect

Define o tempo limite de comando que o agente de IA-Connect usará para cada comando executado.

Definir posição do cursor do mouse

Define o cursor do mouse na sessão de usuário do agente do IA-Connect para a posição especificada. A API setcursorpos é usada para mover o mouse, independentemente da API de movimento do mouse ativo escolhida.

Definir proprietário na pasta

Define o proprietário em uma pasta no computador em que o agente de IA-Connect está em execução.

Definir proprietário no arquivo

Define o proprietário em um arquivo no computador em que o agente IA-Connect está em execução.

Definir área de transferência

Define o conteúdo da área de transferência na sessão de usuário do agente do IA-Connect.

Desabilitar IA-Connect próximo salto

Desabilita o próximo salto para que todos os comandos futuros sejam processados pelo Agente que os recebe (em vez de serem encaminhados para o agente do próximo salto).

Desbloquear sessão

Desbloqueia a sessão em que o agente de IA-Connect está em execução. Isso requer que o provedor de credenciais do desbloqueador IA-Connect seja instalado no computador que hospeda a sessão, pois apenas um Provedor de Credenciais pode desbloquear um computador.

Desconectar sessão remota

Se o agente de IA-Connect estiver em execução em uma sessão remota, essa ação desconectará a sessão remota. Isso não é o mesmo que fazer logon e deixará a sessão remota em execução em um estado desconectado. Essa ação pode ser usada onde você deseja se conectar novamente à sessão remota mais tarde e continuar do mesmo estado, em vez de iniciar uma nova sessão. Se o agente de IA-Connect estiver em execução localmente, essa ação bloqueará a sessão.

Desenhar retângulo na tela

Desenha um retângulo na tela para ajudar na identificação de coordenadas de tela ou na saída de uma ação que relata coordenadas de tela. O retângulo é removido automaticamente após 5 segundos.

Eliminar ficheiros

Exclui arquivos em uma pasta especificada que corresponde a um padrão no computador em que o agente de IA-Connect está em execução.

Encerrar IA-Connect sessão por nome

Elimina a sessão IA-Connect Director especificada se ela existir. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Encerrar processo

Elimina qualquer processo em execução na sessão de usuário do agente do IA-Connect que tem o nome do processo especificado.

Encerrar um thread do Agente

Mata (termina, anula) um thread do Agent. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. O thread do Agente não é excluído (use a ação 'Excluir um thread do Agente' para excluir threads) para permitir que todos os processos ou fluxos que monitoram o thread do Agente recebam o erro 'IA-Connect Thread do Agente foi anulado'.

Enviar chaves

Envia pressionamentos de teclas globais para a sessão de usuário do agente do IA-Connect. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Enviar chaves de senha

Envia pressionamentos de chave globais para a sessão de usuário do agente do IA-Connect, especificamente para inserir uma senha. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Enviar eventos de chave de senha

Envia eventos de pressionamento de tecla global para a sessão de usuário do agente do IA-Connect, especificamente para inserir uma senha, usando o driver de teclado de baixo nível. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Enviar eventos principais

Envia eventos de pressionamento de tecla global para a sessão de usuário do agente do IA-Connect, usando o driver de teclado de baixo nível. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Enviar mensagem para a API Web

Envie uma mensagem para uma API Web e receba uma resposta. Isso pode ser usado com qualquer API Web, mas um uso comum seria uma API REST. IA-Connect dá suporte ao envio de mensagens para APIs Web de uma máquina virtual (ou seja, para acessar recursos locais) ou em sessões da Citrix ou da Área de Trabalho Remota da Microsoft (por exemplo, para acessar APIs somente com compatibilidade de ambientes isolados).

Exclui uma credencial de usuário

Exclui uma credencial no perfil do usuário na sessão do agente IA-Connect. As credenciais podem ser exibidas no Painel de Controle do Windows.

Excluir arquivo

Exclui um arquivo no computador em que o agente de IA-Connect está em execução.

Excluir diretório

Exclui um diretório (pasta) no computador em que o agente de IA-Connect está em execução.

Excluir operação de tarefa de automação do Orchestrator

Exclua uma tarefa específica de automação do Orchestrator, fornecendo a ID de operação de tarefa exclusiva.

Excluir senha na memória do Agente

Exclua uma senha armazenada na memória do Agente ou exclua todas as senhas armazenadas do Agente.

Excluir tarefa de automação do Orchestrator

Exclua uma tarefa de automação do Orchestrator que foi adiada.

Excluir um thread do Agente

Exclui um thread do Agent ou todos os threads do Agent, matando (encerrando, anulando) o thread primeiro, se ele ainda estiver em execução. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Os processos ou fluxos que monitoram o thread do Agente receberão um erro "A ID do thread do agente não existe".

Executar agente de IA-Connect alternativo

Executa um agente de IA-Connect alternativo (por exemplo, uma versão posterior) carregando o executável do Agente de um local de arquivo.

Executar agente de IA-Connect alternativo enviado do diretor

Executa um agente de IA-Connect alternativo (por exemplo, uma versão posterior) carregando o agente alternativo do IA-Connect Director e carregando o executável do Agente alternativo.

Executar o comando generic IA-Connect Agent

Executa um comando genérico IA-Connect Agent passando argumentos como JSON e retornando dados de saída como JSON. Usado para executar comandos do Agente quando o Diretor e o Inspetor são versões mais antigas do que o Agente e, portanto, não entendem o comando.

Executar o processo do PowerShell

Inicie um processo do PowerShell, executando um script existente no disco ou fornecendo o conteúdo do script a ser executado. Em vez disso, considere usar a ação "Executar script do PowerShell", que é muito mais poderosa e fornece uma tabela de dados da saída do script do PowerShell. Use essa ação se o script do PowerShell for gerado para saída padrão ou erro padrão (por exemplo, usa Write-Host em vez de retornar uma tabela), exigir o PowerShell 7 ou estiver executando ações do Active Directory como um usuário alternativo e o CredSSP via WinRM não estiver disponível.

Executar processo

Inicie um processo, um comando ou um aplicativo.

Expandir cadeia de caracteres de senha

Aceita uma cadeia de caracteres de entrada que contém referências a IA-Connect senhas armazenadas e retorna essa cadeia de caracteres com as referências substituídas pelas senhas armazenadas.

Expandir variável de ambiente

Expande uma cadeia de caracteres que contém variáveis de ambiente (por exemplo, %USERPROFILE% ou %TEMP%) na sessão de usuário do agente IA-Connect.

Fechar agente de IA-Connect

Fecha o agente de IA-Connect. Isso não afeta a sessão do usuário em que o agente do IA-Connect estava em execução.

Gerar exceção

Crie uma exceção com a mensagem especificada se a exceção de entrada não estiver em branco. Isso é útil para disparar uma mensagem de exceção em seu fluxo (HTTP 400), que será capturada por um estágio de tratamento de erros, se uma ação anterior tiver um erro. Essa exceção não é registrada nas estatísticas de execução de fluxo do IA-Connect Orchestrator.

Gerar senha

Gera uma senha que contém palavras de dicionário, números, símbolos, caracteres, conforme definido em um formato de modelo.

Girar roda do mouse

Transforma a roda do mouse (entalhes positivos ou negativos) na sessão de usuário do agente do IA-Connect.

Gravar arquivo de texto

Cria um arquivo de texto no computador em que o agente IA-Connect está em execução e grava texto no arquivo.

Gravar em uma credencial de usuário

Grava um nome de usuário e senha em uma credencial no perfil do usuário na sessão IA-Connect Agent, criando essa credencial se ela não existir. As credenciais podem ser exibidas no Painel de Controle do Windows.

Gravar no arquivo CSV

Cria um arquivo CSV no computador em que o agente de IA-Connect está em execução. O arquivo CSV é criado a partir de uma coleção (tabela) ou de uma tabela no formato JSON.

Habilitar herança de segurança de pasta

Habilita a herança de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Habilitar IA-Connect próximo salto

Habilita o próximo salto que encaminhará todos os comandos futuros recebidos no agente IA-Connect em execução na próxima sessão de salto.

ID do processo de encerramento

Elimina um processo em execução na sessão de usuário do agente do IA-Connect que tem a ID do processo especificada. As IDs do processo são exclusivas para que apenas um processo possa corresponder à ID. As IDs do processo são dinâmicas e são diferentes para cada inicialização de um aplicativo.

Iniciar a Sessão de Área de Trabalho Remota (RDS)

Inicie uma RDS (Sessão de Área de Trabalho Remota) usando um arquivo de inicialização RDP.

Interromper herança de segurança de pasta

Interrompe a herança de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Leitura de uma credencial de usuário

Lê um nome de usuário e senha de uma credencial no perfil do usuário na sessão do agente IA-Connect. As credenciais podem ser exibidas no Painel de Controle do Windows. O nome de usuário e a senha podem ser recuperados de uma credencial genérica, enquanto apenas o nome de usuário pode ser recuperado de uma credencial do Windows.

Ler todo o texto do arquivo

Lê o conteúdo de texto de um arquivo no computador em que o agente de IA-Connect está em execução.

Limpar diretório

Limpa um diretório (pasta) no computador em que o agente IA-Connect está em execução, removendo todos os arquivos armazenados no diretório.

Limpar área de transferência

Limpa o conteúdo da área de transferência na sessão de usuário do agente do IA-Connect.

Manter a sessão ativa

Mantém a sessão de usuário do IA-Connect Agent ativa, movendo o mouse no intervalo especificado para impedir que a sessão fique ociosa.

Marcar Fluxo como concluído

Marque um Fluxo como concluído, o que informa ao IA-Connect Orchestrator que o computador de trabalho atribuído agora está disponível para processar outros Fluxos.

Matar todos os outros agentes de IA-Connect

Elimina todas as outras instâncias do agente de IA-Connect que estão em execução na sessão do usuário. Isso garantirá que apenas uma instância do agente de IA-Connect esteja em execução.

Mouse de clique do meio

Clica no botão do mouse do meio na sessão de usuário do agente do IA-Connect.

Mouse de clique do meio na coordenada

Clica no botão do mouse do meio na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Mouse de espera intermediária

Mantém o botão do mouse do meio na sessão de usuário do agente do IA-Connect para a quantidade especificada de segundos.

Mouse de espera intermediária na coordenada

Mantém o botão do mouse do meio nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Mouse de espera à direita

Mantém o botão direito do mouse na sessão de usuário do agente do IA-Connect para a quantidade de segundos especificada.

Mouse de espera à esquerda

Mantém o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect para a quantidade especificada de segundos.

Mouse de espera à esquerda na coordenada

Mantém o botão esquerdo do mouse nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Mouse do Wiggle

Move o mouse para frente e para trás pelo número especificado de coordenadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse.

Mover arquivo

Move um arquivo no computador em que o agente de IA-Connect está em execução.

Mover o mouse entre coordenadas

Move o mouse entre duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Mover o mouse para a coordenada

Move o mouse na sessão de usuário do agente IA-Connect para as coordenadas de pixel especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Mover relativo do mouse

Move o mouse na sessão de usuário do agente IA-Connect pelo número especificado de pixels, em relação à posição atual. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

O arquivo existe

Relata verdadeiro ou falso sobre se um arquivo existe no computador em que o agente de IA-Connect está em execução.

O diretório está acessível

Retorna se um diretório (pasta) está acessível e se as permissões estão restringindo o acesso a ele no computador em que o agente IA-Connect.

O diretório existe

Relata verdadeiro ou falso sobre se existe um diretório (pasta) no computador em que o agente de IA-Connect está em execução.

O leitor de tela está habilitado

Retorna se o leitor de tela foi habilitado na sessão de usuário do agente do IA-Connect.

Obter a configuração de coordenadas globais do agente de IA-Connect

Recupera a configuração da configuração do sistema de coordenadas global do agente IA-Connect, que é usada para exibir locais de elemento (por exemplo: durante a inspeção do mouse) e calcular posições do mouse (por exemplo: ao executar ações globais do mouse).

Obter a contagem de processos do agente de IA-Connect

Retorna o número de instâncias do agente IA-Connect atualmente em execução na sessão do usuário. Isso é útil para detectar se há várias instâncias do agente IA-Connect em execução.

Obter a coordenada atual do mouse

Obtém a posição atual do cursor do mouse na sessão de usuário do agente IA-Connect, usando a API setcursorpos.

Obter a cor do pixel na coordenada

Retorna a cor RGB de um pixel em uma determinada coordenada.

Obter a ID do processo pai

Retorna a ID do processo pai para qualquer processo em execução na sessão de usuário do agente IA-Connect que tenha a ID do processo especificada.

Obter a próxima tarefa de automação do Orchestrator

Recupera a próxima tarefa de automação do Orchestrator que corresponde aos critérios de pesquisa especificados. Somente as tarefas 'New' e 'Deferred' (que atingiram a data de adiamento) podem ser recuperadas. As tarefas em espera não serão recuperadas.

Obter a última ação com falha das estatísticas de fluxo do Orchestrator

Recupera os detalhes da última ação que passou pelo IA-Connect Orchestrator para um trabalhador, se essa ação falhou. Essa ação é mais comumente usada durante o tratamento de erros.

Obter arquivos

Retorna uma lista de arquivos em uma pasta (correspondendo a uma lista CSV de padrões) no computador em que o agente de IA-Connect está em execução.

Obter contagem de processos por nome

Retorna uma contagem de processos em execução na sessão de usuário do agente IA-Connect que tem o nome do processo especificado.

Obter conteúdo de arquivo como Base64

Recupere o conteúdo do arquivo especificado no formato Base64, um formato adequado para transmissão via API e convertido facilmente de volta no formato original ou binário.

Obter credencial genérica do Orchestrator

Recupera uma credencial genérica que foi armazenada no IA-Connect Orchestrator. Uma credencial pode conter nomes de usuário, senhas, nomes de host, URLs e outros dados genéricos.

Obter domínio do computador

Retorna o domínio do computador que está executando a sessão de usuário do agente IA-Connect.

Obter espaço livre em disco

Retorna a quantidade de espaço livre para um disco especificado no computador em que o agente de IA-Connect está em execução.

Obter estatísticas de disponibilidade de trabalho do Orchestrator

Retorna estatísticas de disponibilidade do IA-Connect Orchestrator. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Obter estatísticas do Flow do Orchestrator

Retorna uma lista de estatísticas de fluxo do Orquestrador de IA-Connect. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Obter IA-Connect status do próximo salto

Relata o status do diretor do próximo salto para o Agente que recebe esse comando. Se o próximo salto estiver habilitado, esse Agente encaminha comandos para o próximo salto (por meio do diretor do próximo salto). Se o próximo salto estiver desabilitado, esse Agente está processando comandos em si (o padrão).

Obter impressora padrão

Obtém o nome da impressora padrão para o usuário na sessão IA-Connect Agent.

Obter informações de ambiente

Retorna informações sobre o ambiente no qual a sessão de usuário do agente IA-Connect está em execução.

Obter informações de sessão do agente de IA-Connect

Retorna informações sobre a sessão de usuário do agente IA-Connect.

Obter informações de tipo de cliente e sessão do Diretor

Retorna os detalhes da sessão local ou remota que está sendo tratada pelo Diretor de camada 1.

Obter informações de última entrada

Obtém o tempo desde que a última entrada do usuário foi recebida na sessão de usuário do agente IA-Connect.

Obter informações do agente de IA-Connect

Retorna as propriedades do agente de IA-Connect, incluindo o número de versão e o caminho para o executável do Agente.

Obter informações do diretor do IA-Connect

Retorna as propriedades do IA-Connect Director, incluindo o número de versão e o caminho para o executável Director.

Obter lista de funcionários do Orchestrator

Recupere uma lista de trabalhadores registrados com o Orchestrator IA-Connect e seu status ao vivo.

Obter lista de impressoras

Retorna uma lista de todas as impressoras disponíveis na sessão IA-Connect Agent.

Obter lista de unidades

Retorna uma lista de unidades no computador em que o agente de IA-Connect está em execução.

Obter mapa de calor de uso do fluxo de trabalho do Orchestrator

Retorna o mapa de calor diário de uso do fluxo de trabalho do Orquestrador de IA-Connect. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Obter mensagem de erro de ação com falha do resultado do fluxo JSON

Desserializa a saída JSON de uma ou mais expressões result() de fluxo e recupera a primeira mensagem de erro localizada de uma ação com falha. A mensagem de erro pode ser armazenada no JSON em uma variedade de formatos. Essa ação processa formatos conhecidos e retorna a primeira mensagem de erro localizada.

Obter multiplicador de mouse

Recupera o multiplicador de mouse global na sessão de usuário do agente do IA-Connect. Esse padrão é (1, 1), mas pode ter sido alterado pela ação "Definir multiplicador de mouse".

Obter o estado de licença atual do agente de IA-Connect

Retorna se o agente de IA-Connect está licenciado no momento e, se licenciado, as propriedades da licença.

Obter o histórico de logon do Orchestrator

Retorna o IA-Connect histórico de logon do Orchestrator para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Obter o log do agente de IA-Connect

Retorna o log atual do IA-Connect Agent, como um arquivo ou lendo o conteúdo e retornando-o em uma variável de saída.

Obter o método de movimentação do mouse

Obtém o método de movimentação do mouse atual.

Obter o nome do computador

Retorna o nome do computador que está executando a sessão de usuário do agente IA-Connect.

Obter o nome do host do cliente

Retorna o nome do host do cliente em que o IA-Connect Director está em execução.

Obter o nível de log do Agente IA-Connect

Retorna o nível atual de registro em log do agente de IA-Connect. Os níveis de registro em log são definidos de 1 a 4, sendo 1 o nível mais baixo e 4 sendo o mais alto.

Obter o nível de log do diretor do IA-Connect

Retorna o nível de log atual do IA-Connect Director. Os níveis de registro em log são definidos de 0 a 4. 0 está desabilitado. 1 é o nível de log mais baixo (e o padrão). 4 é o nível de log mais alto.

Obter o processo por ID do processo

Retorna se um processo com a ID do processo especificado está em execução na sessão de usuário do agente IA-Connect. As IDs de processo são exclusivas para que apenas um processo possa corresponder à ID. As IDs do processo são dinâmicas e são diferentes para cada inicialização de um aplicativo.

Obter o status de disponibilidade de trabalho do Orchestrator

Recupere o status básico do Orchestrator. Isso pode ser usado para confirmar se o Orchestrator está disponível e respondendo.

Obter o status do Orchestrator

Recupere o status básico do Orchestrator. Isso pode ser usado para confirmar se o Orchestrator está disponível e respondendo.

Obter o tamanho do arquivo

Retorna o tamanho (em bytes) de um arquivo no computador em que o agente de IA-Connect está em execução.

Obter o tempo de atividade do diretor de IA-Connect

Retorna o tempo de atividade deste IA-Connect Director em segundos (ou seja, quanto tempo o Diretor está em execução).

Obter operação de tarefa de automação do Orchestrator

Recupera uma tarefa específica de automação do Orchestrator, fornecendo a ID de operação de tarefa exclusiva.

Obter pastas

Retorna todas as subpastas dentro de uma pasta especificada no computador em que o agente de IA-Connect está em execução.

Obter permissões de segurança de arquivo

Retorna uma lista de permissões definidas atualmente em um arquivo no computador em que o agente de IA-Connect está em execução.

Obter permissões de segurança de pasta

Retorna uma lista de permissões definidas atualmente em uma pasta no computador em que o agente de IA-Connect está em execução.

Obter processos

Retorna uma lista de processos em execução na sessão de usuário do agente do IA-Connect. Opcionalmente, isso pode ser filtrado fornecendo um nome de processo.

Obter propriedades da linha de comando da ID do processo

Retorna as propriedades da linha de comando para qualquer processo em execução na sessão de usuário do agente IA-Connect que tem a ID do processo especificada.

Obter resolução de tela

Retorna a resolução de tela da sessão de usuário do agente IA-Connect. Para o agente IA-Connect local em execução em uma área de trabalho física ou laptop, isso fornecerá informações sobre todos os dispositivos de exibição e seu dimensionamento. Em uma máquina virtual, normalmente apenas uma exibição será relatada, a menos que a máquina virtual tenha sido configurada para apresentar várias exibições (incomum). Em uma sessão remota, normalmente apenas uma exibição será relatada, mesmo se essa exibição abranger várias exibições locais, já que sessões remotas geralmente criam uma única exibição virtual.

Obter senha armazenada

Recupera uma senha gerada ou armazenada anteriormente.

Obter sessões de IA-Connect disponíveis

Recupera uma lista de sessões IA-Connect Director (conexões disponíveis para sessões em que o agente IA-Connect está em execução, como local, Microsoft RDP ou Citrix ICA).

Obter tarefa de automação do Orchestrator

Recupera uma tarefa específica de automação do Orchestrator.

Obter texto CSV como coleção

Retorna um arquivo CSV no computador em que o agente de IA-Connect está em execução como uma coleção (tabela). Requer apenas acesso de leitura ao arquivo CSV.

Obter threads do Agente

Retorna uma lista de threads do Agente. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Normalmente, depois que um thread do Agent for concluído e seus dados recuperados, o thread do Agente será excluído e não aparecerá na lista de threads.

Obter todas as estatísticas de comando IA-Connect

Retorna todas as estatísticas armazenadas no momento nas quais os comandos do agente IA-Connect foram executados na sessão atual.

Obter todas as tarefas de automação do Orchestrator

Recupera todas as tarefas de automação do Orchestrator que correspondem aos filtros.

Obter trabalho do Orchestrator

Recupere detalhes e status ao vivo de um trabalho individual registrado no Orquestrador IA-Connect.

Obter área de transferência

Obtém o conteúdo atual da área de transferência na sessão de usuário do agente do IA-Connect.

Parar de manter a sessão ativa

Interrompe a sessão de usuário do agente do IA-Connect manter-se ativa.

Recuperar o status de um thread do Agente

Recupera o status de um thread do Agente e, opcionalmente, recupera os dados de saída do thread. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações.

Redefinir configurações do próximo salto IA-Connect Director

Redefine as configurações personalizadas do IA-Connect Director que foram definidas, restaurando as configurações padrão.

Redefinir estatísticas de comando IA-Connect

Redefine todas as estatísticas armazenadas no momento nas quais os comandos do agente IA-Connect foram executados na sessão atual.

Remover identidade da segurança da pasta

Remove uma identidade (por exemplo, um usuário, grupo ou computador) das permissões de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Remover identidade da segurança do arquivo

Remove uma identidade (por exemplo, usuário, grupo ou computador) das permissões de segurança em um arquivo no computador em que o agente IA-Connect está em execução.

Segurar o mouse à direita na coordenada

Mantém o botão direito do mouse nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Sessão de bloqueio

Bloqueia a sessão em que o agente de IA-Connect está em execução.

Sessão remota de logoff

Faz logoff da sessão remota em que o agente do IA-Connect está em execução.

Substituir dados variáveis no arquivo INI

Atualiza uma única variável em um arquivo INI.

A porta TCP está respondendo

Relata se uma porta TCP de rede está respondendo a uma tentativa de conexão pelo agente IA-Connect. Pode ser uma porta TCP no computador em que o agente de IA-Connect está em execução (insira 'localhost' para o host remoto) ou em qualquer computador remoto. Se o agente de IA-Connect se conectar com êxito a uma porta TCP, ele fechará imediatamente a conexão TCP.

Parâmetros

Nome Chave Obrigatório Tipo Description
Host remoto
RemoteHost True string

O endereço IPv4, o endereço DNS ou o nome do host do computador ao qual se conectar. Insira 'localhost' para verificar uma porta TCP no computador em que o agente de IA-Connect está em execução. Exemplos: 192.168.1.10 ou www.test.com ou vm-server19.

porta TCP
TCPPort True integer

O número da porta TCP ao qual se conectar no host remoto (ou local) especificado. Uma porta TCP deve ser 1 ou superior e 65535 ou inferior. Exemplos de portas conhecidas comuns são 80 (HTTP), 443 (HTTPS), 445 (SMB/compartilhamento de arquivos).

Tempo limite, em segundos
TimeoutInSeconds integer

O número máximo de segundos a aguardar pela conexão TCP. Isso usa como padrão 10 segundos, mas a maioria das conexões em funcionamento deve se conectar dentro de alguns segundos (pela Internet) ou menos de um segundo (rede local).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Porta TCP conectada
TCPPortConnected boolean

Defina como true se a porta TCP estiver conectada ou falsa se a porta TCP falhar ao se conectar.

Mensagem de erro de conexão
ConnectionErrorMessage string

A mensagem de erro se a porta TCP não se conectar. Normalmente, isso será um erro de pesquisa de nome/DNS ou um tempo limite.

A sessão está bloqueada

Informa se a sessão em que o agente IA-Connect está em execução está bloqueada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
A sessão está bloqueada
SessionIsLocked boolean

Defina como true se a sessão em que o agente de IA-Connect está em execução estiver bloqueada.

A sessão IA-Connect existe por nome

Retorna se a sessão IA-Connect Director especificada existir. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Parâmetros

Nome Chave Obrigatório Tipo Description
IA-Connect nome da sessão
IAConnectSessionName True string

O nome da sessão IA-Connect a ser verificada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
IA-Connect sessão existe
IAConnectSessionExists boolean

Retornará true se houver uma sessão com o nome especificado ou false se não existir.

Adiar a operação de tarefa de automação do Orchestrator existente

Adie uma tarefa existente do Orchestrator que já está na fila. A tarefa será adiada para um horário especificado no futuro. Isso geralmente é usado para adiar novamente uma tarefa existente (ou seja, a tarefa foi adiada anteriormente e agora precisa ser adiada novamente). Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da operação
OperationId True string

A ID da operação da tarefa Orchestrator a ser adiada (ou adiada novamente).

Tempo de adiamento em minutos
DeferralTimeInMinutes integer

Por quantos minutos a tarefa de automação deve ser atrasada.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais a serem armazenados com essa tarefa. Ele ficará disponível para o processo/fluxo quando continuar a partir de um adiamento. Isso geralmente é usado para armazenar dados que você calculou durante o processo/fluxo que você precisa para ficar disponível novamente após o adiamento. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo continue no estágio 'Exchange' quando ele continuar após o adiamento, insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa (1 sendo o nível mais alto).

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksDeferExistingTaskOperationResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Adiar a tarefa de automação do Orchestrator existente

Adie uma tarefa existente do Orchestrator que já está na fila. A tarefa será adiada para um horário especificado no futuro. Isso geralmente é usado para adiar novamente uma tarefa existente (ou seja, a tarefa foi adiada anteriormente e agora precisa ser adiada novamente). Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa de automação do Orchestrator existente a ser adiada (ou adiada novamente).

Tempo de adiamento em minutos
DeferralTimeInMinutes integer

Por quantos minutos a tarefa de automação deve ser atrasada.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais a serem armazenados com essa tarefa. Ele ficará disponível para o processo/fluxo quando continuar a partir de um adiamento. Isso geralmente é usado para armazenar dados que você calculou durante o processo/fluxo que você precisa para ficar disponível novamente após o adiamento. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo continue no estágio 'Exchange' quando ele continuar após o adiamento, insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa (1 sendo o nível mais alto).

Colocar a tarefa em espera
TaskOnHold boolean

Se você definir esse valor como true, a tarefa será colocada em espera e, portanto, não será processada em um fluxo de trabalho de tarefa típico, mesmo quando a data de adiamento for atingida. Você pode alterar o status "Em espera" posteriormente, usando a ação "Alterar o status da tarefa de automação do Orchestrator".

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksDeferExistingTaskResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Adicionar arquivo ao ZIP

ZIPs um arquivo (armazena o arquivo em um arquivo de compactação).

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo de origem a ser adicionado ao ZIP
SourceFilenameToAddToZIP True string

O caminho do arquivo para o arquivo a ser adicionado ao zip. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Caminho do arquivo ZIP de saída
OutputZIPFilename True string

O caminho do arquivo para o qual o ZIP deve ser gerado. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Adicionar nome de arquivo à pasta no ZIP
AddFilenameToFolderInZIP string

Se você quiser adicionar o arquivo de origem a uma pasta no arquivo ZIP, insira o nome da pasta aqui.

Nome do arquivo de origem a ser adicionado ao comentário ZIP
SourceFilenameToAddToZIPComment string

Um comentário opcional para este arquivo adicionado ao ZIP.

Comprimir
Compress boolean

O arquivo deve ser compactado ao compactar?

Adicionar ao arquivo ZIP existente
AddToExistingZIPFile boolean

Defina como True para adicionar a um arquivo ZIP existente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Adicionar nova operação de tarefa adiada do Orchestrator

Adicione uma nova tarefa adiada do Orchestrator e receba uma ID da operação. A tarefa será adiada para um horário especificado no futuro. Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo). Um nome de tarefa específico será necessário se a tarefa estiver sendo processada por um sondador externo ou um gatilho Orchestrator. Essa ação difere de "Adicionar nova tarefa adiada do Orchestrator" (TasksAddNewDeferral) na medida em que ela responde com uma ID de operação inválida, em vez de uma ID de tarefa adivinho.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da automação
AutomationName string

Um nome amigável fornecido para ajudar a identificar a tarefa posteriormente ou associá-la a um fluxo específico. Várias tarefas podem usar o mesmo nome de automação.

Tempo de adiamento em minutos
DeferralTimeInMinutes integer

Por quantos minutos a tarefa de automação deve ser atrasada.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais a serem disponibilizados para a tarefa quando ela for iniciada. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais a serem armazenados com essa tarefa. Ele ficará disponível para o processo/fluxo quando continuar a partir de um adiamento. Isso geralmente é usado para armazenar dados que você calculou durante o processo/fluxo que você precisa para ficar disponível novamente após o adiamento. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve ser iniciado. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo comece no estágio 'Exchange', insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa de automação (1 sendo o nível mais alto).

Organização
Organisation string

Opcionalmente, especifique a organização à qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

Opcionalmente, especifique o departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

Opcionalmente, especifique a descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas a serem atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Retornos

Nome Caminho Tipo Description
ID da operação
OperationId string

A ID da Operação do Orchestrator adiou a tarefa que foi criada. Essa ID da Operação pode ser usada para recuperar a tarefa posteriormente. A ID da Operação é uma cadeia de caracteres exclusiva e indisponível, limitando a capacidade de um terceiro adivinhar a ID de uma operação que eles não criaram.

Adicionar nova operação de tarefa de automação do Orchestrator

Adicione uma nova tarefa de automação do Orchestrator e receba uma ID da operação. Um nome de tarefa específico será necessário se a tarefa estiver sendo processada por um sondador externo ou um gatilho Orchestrator. Essa ação difere de "Adicionar nova tarefa de automação do Orchestrator" (TasksAddNewTaskOperation) na medida em que ela responde com uma ID de Operação indissível, em vez de uma ID de Tarefa adivinhada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da automação
AutomationName string

Um nome amigável fornecido para ajudar a identificar a tarefa posteriormente ou associá-la a um fluxo específico. Várias tarefas podem usar o mesmo nome de automação.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais a serem disponibilizados para a tarefa quando ela for iniciada. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve ser iniciado. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo comece no estágio 'Exchange', insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa de automação (1 sendo o nível mais alto).

SLA em minutos
SLA integer

Defina a quantidade de minutos necessária para o SLA. Defina isso como 0 se você não tiver um SLA. Por padrão, as tarefas de automação próximas ao final do SLA terão prioridade sobre outras tarefas.

Organização
Organisation string

Opcionalmente, especifique a organização à qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

Opcionalmente, especifique o departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

Opcionalmente, especifique a descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas a serem atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Retornos

Nome Caminho Tipo Description
ID da operação
OperationId string

A ID da Operação da tarefa de automação orchestrator que foi criada. Essa ID da Operação pode ser usada para recuperar a tarefa posteriormente. A ID da Operação é uma cadeia de caracteres exclusiva e indisponível, limitando a capacidade de um terceiro adivinhar a ID de uma operação que eles não criaram.

Adicionar nova tarefa adiada do Orchestrator

Adicione uma nova tarefa adiada do Orchestrator em uma fila que pode ser monitorada de um Flow. A tarefa será adiada para um horário especificado no futuro. Use essa ação para suspender temporariamente uma tarefa por um período de tempo especificado (por exemplo, se você estiver esperando por algo).

Parâmetros

Nome Chave Obrigatório Tipo Description
Definir o nome da automação
SetAutomationName string

Selecione 'Auto' se você quiser usar o nome do fluxo como o nome da tarefa ou selecionar 'Manual' e insira um nome no campo 'Nome da Automação' para usar esse nome.

Nome da automação
AutomationName string

Isso só será usado se 'Manual' for escolhido no campo 'Definir nome da automação'. Um nome amigável fornecido para ajudar a identificar a tarefa posteriormente ou associá-la a um fluxo específico. Várias tarefas podem usar o mesmo nome de automação.

Tempo de adiamento em minutos
DeferralTimeInMinutes integer

Por quantos minutos a tarefa de automação deve ser atrasada.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais a serem disponibilizados para a tarefa quando ela for iniciada. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais a serem armazenados com essa tarefa. Ele ficará disponível para o processo/fluxo quando continuar a partir de um adiamento. Isso geralmente é usado para armazenar dados que você calculou durante o processo/fluxo que você precisa para ficar disponível novamente após o adiamento. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo continue no estágio 'Exchange' quando ele continuar após o adiamento, insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa (1 sendo o nível mais alto).

Colocar a tarefa em espera
TaskOnHold boolean

Especifique o status "Em espera" da tarefa. Uma tarefa definida como "Em espera" não será recuperada pela ação "Obter a próxima tarefa de automação do Orchestrator" e, portanto, não será processada em um fluxo de trabalho de tarefa típico.

Organização
Organisation string

Opcionalmente, especifique a organização à qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

Opcionalmente, especifique o departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

Opcionalmente, especifique a descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas a serem atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
ID da tarefa
TaskId integer

A ID da tarefa de adiamento que foi criada.

Adicionar nova tarefa de automação do Orchestrator

Adicione uma nova tarefa de automação do Orchestrator em uma fila que pode ser monitorada de um Flow. As tarefas podem estar prontas para serem executadas imediatamente ou adiadas para serem executadas posteriormente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Definir o nome da automação
SetAutomationName string

Selecione 'Auto' se você quiser usar o nome do fluxo como o nome da tarefa ou selecionar 'Manual' e insira um nome no campo 'Nome da Automação' para usar esse nome.

Nome da automação
AutomationName string

Isso só será usado se 'Manual' for escolhido no campo 'Definir nome da automação'. Um nome amigável fornecido para ajudar a identificar a tarefa posteriormente ou associá-la a um fluxo específico. Várias tarefas podem usar o mesmo nome de automação. Um nome de tarefa específico será necessário se a tarefa estiver sendo processada por um sondador externo ou um gatilho Orchestrator.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais a serem disponibilizados para a tarefa quando ela for iniciada. Você é livre para armazenar dados em qualquer formato, mas JSON é um formato comumente usado.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve ser iniciado. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo comece no estágio 'Exchange', insira o valor 'Exchange'.

Priority
Priority integer

Defina o nível de prioridade dessa tarefa de automação (1 sendo o nível mais alto).

SLA em minutos
SLA integer

Defina a quantidade de minutos necessária para o SLA. Defina isso como 0 se você não tiver um SLA. Por padrão, as tarefas de automação próximas ao final do SLA terão prioridade sobre outras tarefas.

Colocar a tarefa em espera
TaskOnHold boolean

Especifique o status "Em espera" da tarefa. Uma tarefa definida como "Em espera" não será recuperada pela ação "Obter a próxima tarefa de automação do Orchestrator" e, portanto, não será processada em um fluxo de trabalho de tarefa típico.

Organização
Organisation string

Opcionalmente, especifique a organização à qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

Opcionalmente, especifique o departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

Opcionalmente, especifique a descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas a serem atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
ID da tarefa
TaskId integer

A ID da tarefa de automação orchestrator que foi criada. Essa ID da Tarefa pode ser usada para recuperar a tarefa posteriormente.

Adicionar pasta ao ZIP

Arquivos ZIPs em uma pasta em um arquivo ZIP (armazena os arquivos em um arquivo de compactação).

Parâmetros

Nome Chave Obrigatório Tipo Description
Pasta de origem a ser adicionada ao ZIP
SourceFolderToAddToZIP True string

O caminho para a pasta a ser adicionada ao zip. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Caminho do arquivo ZIP de saída
OutputZIPFilename True string

O caminho do arquivo para o qual o ZIP deve ser gerado. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Adicionar arquivos à pasta no ZIP
AddFilesToFolderInZIP string

Se você quiser adicionar os arquivos de origem a uma pasta no arquivo ZIP, insira o nome da pasta aqui.

Comprimir
Compress boolean

A pasta deve ser compactada ao compactar?

Adicionar ao arquivo ZIP existente
AddToExistingZIPFile boolean

Defina como True para adicionar a um arquivo ZIP existente.

Incluir subpastas
IncludeSubfolders boolean

As subpastas dentro da pasta de origem também devem ser adicionadas ao ZIP?

Incluir arquivos de expressão regular
IncludeFilesRegEx string

Uma expressão regular opcional para permitir que você especifique quais arquivos devem ser extraídos. Corresponde somente ao nome de arquivo.

Excluir expressão regular de arquivos
ExcludeFilesRegEx string

Uma expressão regular opcional para permitir que você especifique quais arquivos devem ser excluídos da extração. Corresponde somente ao nome de arquivo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de arquivos adicionados com êxito
FilesAddedSuccessfully integer

O número de arquivos que foram adicionados com êxito ao ZIP.

Número de arquivos excluídos
FilesExcluded integer

O número de arquivos que foram excluídos (se estiver usando a entrada "Excluir expressão regular de arquivos").

Adicionar permissão ao arquivo

Adiciona uma permissão a um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
FilePath True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade
Identity True string

A identidade do usuário ou grupo a ser atribuída à permissão. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Permissão
Permission True string

Forneça a permissão a ser atribuída (Read, ReadAndExecute, Modify ou FullControl) ou deixe em branco para o padrão (Leitura).

Deny
Deny boolean

A permissão está sendo negada?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Adicionar permissão à pasta

Adiciona uma permissão a uma pasta no computador em que o agente IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade
Identity True string

A identidade (por exemplo, um usuário, grupo ou computador) a ser atribuída à permissão. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Permissão
Permission True string

Forneça a permissão a ser atribuída (Read, ReadAndExecute, Modify ou FullControl) ou deixe em branco para o padrão (Leitura).

Aplicar à pasta
ApplyToFolder boolean

A permissão deve ser aplicada à própria pasta?

Aplicar a subpastas
ApplyToSubFolders boolean

A permissão deve se propagar para subpastas?

Aplicar a arquivos
ApplyToFiles boolean

A permissão deve ser aplicada aos arquivos dentro da pasta?

Deny
Deny boolean

A permissão está sendo negada?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Adicionar uma anotação a uma tarefa de automação do Orchestrator

Adiciona uma anotação a uma tarefa de automação do Orchestrator selecionada. Essa observação será passada para o sistema de origem vinculado a essa tarefa de automação (por exemplo, ServiceNow) e é mais comumente usada para adicionar detalhes a um tíquete. Se a tarefa de automação orchestrator não estiver vinculada a uma origem, uma exceção será gerada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa Orchestrator à qual adicionar a anotação.

Anotar texto
NoteText True string

A mensagem de texto de anotação.

Tipo de anotação
NoteType string

Se o sistema de origem der suporte a diferentes tipos de anotação (por exemplo, uma nota de trabalho, uma nota de fechamento ou um comentário), insira o tipo de nota aqui. Isso será interpretado de forma diferente, dependendo do sistema de origem. Os tipos com suporte no momento são 'WorkNote' (o padrão), 'CloseNote', 'Comment'. Se houver apenas um tipo de observação, insira "WorkNote". Se você tiver uma nota de trabalho personalizada, insira "Outros".

Tipo de observação outro
NoteTypeOther string

Se você tiver um tipo de anotação personalizado, escolha um "Tipo de observação" de "Outro" e insira o tipo personalizado nesse campo.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksAddNoteResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Aguarde a conclusão do thread do Agente com êxito

Aguarda que um thread do Agente seja concluído e, opcionalmente, recupere os dados de saída do thread. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Se o thread do Agente for concluído, mas em falha, uma exceção será gerada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread Id
ThreadId True integer

Se você executou anteriormente uma ação do Agente como um thread, forneça a ID do thread para recuperar o status do thread. Essa ID de thread terá sido fornecida como uma saída da execução anterior da ação como um thread.

Segundos para aguardar o thread
SecondsToWaitForThread True integer

Quantos segundos aguardar a conclusão do thread. Se o thread não tiver sido concluído neste momento, uma exceção será gerada (a menos que "Gerar exceção se o thread não for concluído" for definido como false).

Recuperar dados de saída de thread
RetrieveThreadOutputData boolean

Defina como true para recuperar os dados de saída do thread no formato JSON. É recomendável recuperar dados de saída de thread chamando a mesma ação usada para criar o thread, definindo a entrada 'Recuperar dados de saída para id de thread' para a ID do thread, mas essa opção permite que você recupere diretamente os dados de saída do thread e, opcionalmente, não exclua os dados.

Excluir thread após os dados de saída recuperados
ClearOutputDataFromMemoryOnceRead boolean

Se o thread tiver sido concluído com êxito e os dados de saída forem recuperados (consulte a entrada 'Recuperar dados de saída do thread'), defina essa entrada como true para excluir o thread após o retorno dos resultados. Isso excluirá os dados de saída do thread e o thread em si, portanto, você não poderá consultar o thread novamente.

Gerar exceção se o thread não for concluído
RaiseExceptionIfThreadNotCompleted boolean

Se definido como true e o thread não tiver sido concluído no tempo especificado, uma exceção será gerada. Se definida como false, essa ação aguardará até o tempo solicitado (para que o thread seja concluído) e relatará o status do thread (consulte as saídas 'Thread está em execução' etc. Uma exceção sempre será gerada se o thread for concluído, mas em falha.

Gerar exceção se houver erro de thread
RaiseExceptionIfThreadError boolean

Se definido como true (o comportamento padrão) e o thread tiver uma condição de erro (thread concluído, mas não bem-sucedido), uma exceção será gerada e o thread será excluído. Se definido como false, o erro será armazenado na saída 'Mensagem de erro thread' e o thread não será excluído (você deve excluir o thread usando a ação 'Excluir um thread do Agente' quando apropriado).

Segundos para aguardar por chamada
SecondsToWaitPerCall integer

Os "Segundos para esperar por thread" serão divididos em fatias de tempo menores para evitar tempos limite. Essa entrada opcional permite que você especifique o tamanho da fatia de tempo menor. Não defina como um valor maior que 80% do tempo limite do RPA ou você pode receber erros de tempo limite.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O thread foi iniciado
ThreadStarted boolean

True se o thread tiver sido iniciado. False se o thread ainda não foi iniciado, o que sugere que algo deu errado desde que o thread é iniciado imediatamente. Útil somente se "Gerar exceção se o thread não for concluído" for definido como false, pois caso contrário, uma exceção será gerada se o thread não tiver sido concluído no tempo de espera especificado.

O thread está em execução
ThreadRunning boolean

True se o thread estiver em execução no momento. False se o thread nunca foi iniciado (altamente improvável) ou se o thread já foi concluído. Útil somente se "Gerar exceção se o thread não for concluído" for definido como false, pois caso contrário, uma exceção será gerada se o thread não tiver sido concluído no tempo de espera especificado.

O thread foi concluído
ThreadCompleted boolean

True se o thread tiver sido concluído. False se o thread nunca tiver sido iniciado (altamente improvável) ou se o thread ainda estiver em execução. Útil somente se "Gerar exceção se o thread não for concluído" for definido como false, pois caso contrário, uma exceção será gerada se o thread não tiver sido concluído no tempo de espera especificado.

Thread bem-sucedido
ThreadSuccess boolean

True se o thread tiver sido concluído com êxito. False se o thread nunca tiver sido iniciado (altamente improvável), o thread ainda estará em execução ou se o thread falhou. Útil somente se "Gerar exceção se o thread não for concluído" for definido como false, pois caso contrário, uma exceção será gerada se o thread não tiver sido concluído no tempo de espera especificado.

Runtime do thread em segundos
ThreadRuntimeInSeconds integer

O número total de segundos em que o thread foi executado.

IA-Connect nome da ação
IAConnectActionName string

O nome interno da ação IA-Connect Agent que está sendo executada como um thread.

Mensagem de status do thread
ThreadStatusMessage string

Uma cadeia de caracteres de texto que descreve o status do thread. Essa mensagem é calculada com base nas propriedades ThreadStarted, ThreadRunning, ThreadCompleted, ThreadSuccess. Essa cadeia de caracteres de texto é independente de linguagem (ela não será alterada para corresponder à localidade).

Mensagem de erro de thread
ThreadErrorMessage string

Se o thread tiver falhado, essa saída conterá a mensagem de erro. Útil somente se 'Gerar exceção se o erro de thread' for definido como false, pois caso contrário, uma exceção será gerada se o thread tiver um erro.

JSON de dados de saída de thread
ThreadOutputJSON string

Se 'Recuperar dados de saída de thread' for definido como true, essa saída manterá os dados de saída de thread brutos no formato JSON.

Aguarde IA-Connect sessão do próximo salto se conectar

Aguarda a próxima sessão de salto se conectar e para que o agente do IA-Connect esteja em execução na próxima sessão de salto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço do diretor do próximo salto
NextHopDirectorAddress string

O endereço opcional do Próximo salto IA-Connect Director para encaminhar comandos para se nenhum dos parâmetros 'Próximo salto Diretor é localhost', 'Endereço do diretor do próximo salto é nome do host', 'Endereço do diretor do próximo salto é FQDN' ou 'Endereço do diretor do próximo salto é pipe nomeado' são definidos como true.

Porta TCP do diretor do próximo salto
NextHopDirectorTCPPort integer

A porta TCP na qual o diretor do próximo salto está escutando (o Diretor no computador em que o Agente está sendo executado).

O Diretor do próximo salto usa HTTPS
NextHopDirectorUsesHTTPS boolean

Defina como True se o diretor do próximo salto estiver usando HTTPS ou false, caso contrário.

O endereço do diretor do próximo salto é localhost
NextHopDirectorAddressIsLocalhostname boolean

O endereço do diretor do próximo salto (em relação ao Agente) é 'localhost'.

O endereço do diretor do próximo salto é nome do host
NextHopDirectorAddressIsHostname boolean

O endereço do diretor do próximo salto é o nome do host do computador que executa o Agente (ou seja, aquele que executa o Agente e o Diretor).

O endereço do diretor do próximo salto é FQDN
NextHopDirectorAddressIsFQDN boolean

O endereço do diretor do próximo salto é o FQDN (nome de domínio totalmente qualificado) do computador que executa o Agente (ou seja, aquele que executa o Agente e o Diretor).

Incrementar a porta TCP do diretor do próximo salto pela ID da sessão
IncrementNextHopDirectorTCPPortBySessionId boolean

Para garantir que a porta TCP do diretor do próximo salto seja exclusiva (se houver várias sessões paralelas usando o próximo salto do mesmo host), a ID da Sessão poderá ser adicionada à porta TCP do Diretor do Próximo salto.

Tempo em segundos para esperar
SecondsToWait double

O número máximo de segundos para aguardar a próxima sessão de salto se conectar.

O endereço do diretor do próximo salto é chamado pipe
NextHopDirectorAddressIsNamedPipe boolean

O endereço do diretor do próximo salto (em relação ao Agente) está usando um pipe nomeado em vez de um serviço Web TCP/IP. Esse é o padrão para evitar o uso de portas TCP/IP no primeiro salto.

Desabilitar o próximo salto existente
DisableExistingNextHop boolean

O salto duplo deve ser desabilitado (se estiver ativo no momento) antes de habilitar novamente? Se definido como true (o padrão), qualquer nova instrução de habilitação de salto duplo substituirá as anteriores. Se definido como false, isso habilitará o salto triplo, pois as instruções serão recebidas pelo agente de IA-Connect de salto duplo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Sessão do próximo salto conectada
NextHopSessionConnected boolean

Retornará true se a sessão do próximo salto estiver conectada antes que o tempo máximo de espera seja excedido.

Aguarde IA-Connect sessão fechar por nome

Aguarda o fechamento da sessão do IA-Connect Director especificado. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Parâmetros

Nome Chave Obrigatório Tipo Description
IA-Connect nome da sessão
IAConnectSessionName True string

O nome da sessão IA-Connect a ser verificada.

Tempo de espera em segundos
TimeToWaitInSeconds integer

Se não houver nenhuma sessão do tipo especificado (se um tipo específico tiver sido especificado), quanto tempo IA-Connect deve esperar por ele?

Gerar exceção se o tempo limite for esgotado
RaiseExceptionIfTimedout boolean

Deve IA-Connect gerar uma exceção se uma nova sessão não tiver se conectado antes que o período de tempo limite tenha decorrido?

Anexar à sessão de IA-Connect camada 1 com êxito
AttachToTier1IAConnectSessionOnSuccess boolean

Deve IA-Connect se conectar novamente à sessão de IA-Connect de camada 1 (a sessão IA-Connect Director do Diretor que está recebendo as mensagens SOAP e/ou REST) se a sessão tiver sido fechada com êxito?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
sessão de IA-Connect fechada
IAConnectSessionClosed boolean

Retornará true se a sessão com o nome especificado tiver sido fechada ou false, caso contrário.

Nome da sessão de IA-Connect da camada 1 anexada
AttachedTier1IAConnectSessionName string

O nome da sessão de IA-Connect camada 1 que foi conectada.

Alocar trabalho do Orchestrator

Aloca um trabalhador do Orquestrador de IA-Connect. Você pode solicitar um trabalho por marca ou nome de trabalho (ou nenhum dos dois), permitindo que você escolha com mais precisão qual trabalho você precisa. Depois que um trabalho é alocado, ele é atribuído ao seu fluxo e será relatado como executando o trabalho. Observe que o Orchestrator ainda considerará 'IDs de ambiente de fluxo com suporte', 'Nomes de fluxo com suporte' e 'Nomes de fluxo sem suporte' ao executar a alocação. Quando vários trabalhadores corresponderem à pesquisa, as regras normais de balanceamento de carga serão aplicadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Marca de trabalho
WorkerTag string

A marca opcional do trabalho a ser alocado. As marcas permitem categorizar os trabalhadores em grupos. Os nomes de marcas não diferenciam maiúsculas de minúsculas. Você pode especificar várias marcas inserindo-as em linhas separadas e o mecanismo de alocação considerará qualquer trabalho com qualquer uma dessas marcas (apenas uma marca precisa corresponder). Você pode executar uma pesquisa curinga usando o formato Curinga: Tag* (por exemplo, Curinga: JML*) e uma pesquisa de expressão regular usando o formato RegEx: TagExpression (por exemplo, RegEx: ^JML).

Nome do trabalhador
WorkerName string

O nome opcional do trabalho a ser alocado. Os nomes de trabalho não diferenciam maiúsculas de minúsculas. Você pode especificar vários trabalhadores inserindo-os em linhas separadas e o mecanismo de alocação considerará qualquer trabalho com um nome correspondente. Você pode executar uma pesquisa curinga usando o formato Curinga: Nome* (por exemplo, Curinga: vmrpa*) e uma pesquisa de expressão regular usando o formato RegEx: Expressão (por exemplo, RegEx: ^vmrpa).

Gerar exceção se o trabalho não estiver disponível imediatamente
RaiseExceptionIfWorkerNotImmediatelyAvailable boolean

Se definido como true e um trabalho adequado não puder ser alocado, uma exceção será gerada. Se definido como false (o padrão) e um trabalho adequado não puder ser alocado, o Orchestrator retornará o código de status HTTP 500, fazendo com que o fluxo de PA aguarde, de acordo com a "política de repetição".

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome do trabalho alocado
WorkerNameAllocated string

O nome do trabalho alocado. Em branco se nenhum trabalhador foi alocado.

Alterar o status da tarefa de automação do Orchestrator

Altera o status da tarefa de automação do Orchestrator selecionada ou outras propriedades de tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa Orchestrator a ser modificada.

Novo status da tarefa de automação
AutomationTaskStatus string

O novo status da tarefa para a tarefa de automação especificada ou deixe em branco se você não quiser alterar o status da tarefa existente. Se você quiser adiar uma tarefa existente, use a ação "Adiar a tarefa de automação do Orchestrator existente".

Colocar a tarefa em espera
TaskOnHold boolean

Especifique o status "Em espera" da tarefa. Somente tarefas novas ou adiadas podem estar em espera, portanto, uma exceção será gerada se você tentar colocar qualquer outro status de tarefa em espera.

Apagar dados de entrada da tarefa
EraseTaskInputData boolean

Se você definir esse valor como true, todos os dados de entrada da tarefa serão apagados. Normalmente, isso é usado para economizar espaço de armazenamento para uma tarefa concluída ou com falha, pois os dados brutos não são mais necessários.

Apagar dados armazenados de adiamento
EraseDeferralStoredData boolean

Se você definir esse valor como true, todos os dados armazenados de adiamento serão apagados. Normalmente, isso é usado para economizar espaço de armazenamento para uma tarefa concluída ou com falha, pois os dados brutos não são mais necessários.

Atualizar o sistema de origem
UpdateSourceSystem boolean

Se você definir esse valor como true e a tarefa Orchestrator estiver vinculada a um sistema de origem (por exemplo, ServiceNow), o Orchestrator executará todas as ações especificadas na configuração do sistema de origem no Orchestrator (por exemplo, feche o tíquete).

Motivo do fechamento da tarefa
TaskClosureReason string

Forneça um motivo de fechamento de tarefa para tarefas 'Concluídas' ou 'Com Falha', que serão armazenadas na tarefa. Além disso, se a tarefa Orchestrator estiver vinculada a um sistema de origem (por exemplo, ServiceNow), você estiver alterando o status e "Atualizar sistema de origem" for definido como true, o motivo também será passado para o sistema de origem (por exemplo, como uma nota de trabalho do ServiceNow). Somente tarefas concluídas ou com falha podem ter um motivo de fechamento, portanto, uma exceção será gerada se você tentar definir o motivo do fechamento para qualquer outro status de tarefa.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksChangeTaskStatusResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Anexar à sessão de IA-Connect camada 1

Anexa-se à sessão IA-Connect Director do Diretor que recebe as mensagens SOAP e/ou REST. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Parâmetros

Nome Chave Obrigatório Tipo Description
O canal virtual deve estar conectado
VirtualChannelMustBeConnected boolean

O IA-Connect Director deve validar se o canal virtual está conectado ao anexar à sessão? Isso garante que o agente de IA-Connect esteja em execução na sessão especificada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome da sessão de IA-Connect da camada 1 anexada
AttachedTier1IAConnectSessionName string

O nome da sessão de IA-Connect camada 1 que foi conectada.

Anexar à sessão de IA-Connect mais recente

Anexa-se à sessão IA-Connect Director que mais recentemente se conectou (opcionalmente de um tipo especificado). Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de sessão de IA-Connect de pesquisa
SearchIAConnectSessionType string

O tipo de sessão a ser pesquisado, por exemplo, 'Agente Local', 'Microsoft RDP', 'Citrix ICA' ou 'Remote' para qualquer tipo de sessão remota. Deixe em branco para pesquisar qualquer tipo de sessão.

Tempo de espera em segundos
TimeToWaitInSeconds integer

Se não houver nenhuma sessão do tipo especificado (se um tipo específico tiver sido especificado), quanto tempo IA-Connect deve esperar por ele?

Gerar exceção se o tempo limite for esgotado
RaiseExceptionIfTimedout boolean

Deve IA-Connect gerar uma exceção se uma nova sessão não tiver se conectado antes que o período de tempo limite tenha decorrido?

O canal virtual deve estar conectado
VirtualChannelMustBeConnected boolean

O IA-Connect Director deve validar se o canal virtual está conectado ao anexar à sessão? Isso garante que o agente de IA-Connect esteja em execução na sessão especificada.

Contar somente sessões não vistas antes
OnlyCountSessionsNotSeenBefore boolean

Se definido como true, as sessões vistas pela ação "Obter IA-Connect sessões disponíveis" anteriormente (ou as sessões de exibição do Inspetor de IA-Connect) não serão contadas no índice. Isso permite que apenas sessões 'novas' sejam contadas (por exemplo, anexar à primeira nova sessão do Citrix).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome da sessão IA-Connect anexado
AttachedIAConnectSessionName string

O nome da sessão de IA-Connect anexada.

Anexado à sessão
AttachedToSession boolean

Retornará true se IA-Connect tiver anexado a uma sessão ou false, caso contrário.

Anexar à sessão IA-Connect pelo nome

Anexa-se à sessão do IA-Connect Director especificada pelo nome. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Parâmetros

Nome Chave Obrigatório Tipo Description
IA-Connect nome da sessão
IAConnectSessionName True string

O nome da sessão IA-Connect à qual se conectar.

O canal virtual deve estar conectado
VirtualChannelMustBeConnected boolean

O IA-Connect Director deve validar se o canal virtual está conectado ao anexar à sessão? Isso garante que o agente de IA-Connect esteja em execução na sessão especificada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Anexar à sessão IA-Connect por índice

Anexa-se à sessão do IA-Connect Director especificada por índice (por exemplo, anexar à primeira sessão do Citrix ICA). Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de sessão de IA-Connect de pesquisa
SearchIAConnectSessionType string

O tipo de sessão a ser pesquisado, por exemplo, 'Agente Local', 'Microsoft RDP', 'Citrix ICA' ou 'Remote' para qualquer tipo de sessão remota. Deixe em branco para pesquisar qualquer tipo de sessão.

Índice de sessão de IA-Connect de pesquisa
SearchIAConnectSessionIndex integer

O índice da sessão à qual se conectar, por exemplo, 1 para o primeiro tipo de sessão correspondente, 2 para o segundo tipo de sessão correspondente.

Tempo de espera em segundos
TimeToWaitInSeconds integer

Se a sessão com o índice especificado não existir, quanto tempo IA-Connect deve esperar por ela?

Gerar exceção se o tempo limite for esgotado
RaiseExceptionIfTimedout boolean

Deve IA-Connect gerar uma exceção se uma nova sessão não tiver se conectado antes que o período de tempo limite tenha decorrido?

O canal virtual deve estar conectado
VirtualChannelMustBeConnected boolean

O IA-Connect Director deve validar se o canal virtual está conectado ao anexar à sessão? Isso garante que o agente de IA-Connect esteja em execução na sessão especificada.

Contar somente sessões não vistas antes
OnlyCountSessionsNotSeenBefore boolean

Se definido como true, as sessões vistas pela ação "Obter IA-Connect sessões disponíveis" anteriormente (ou as sessões de exibição do Inspetor de IA-Connect) não serão contadas no índice. Isso permite que apenas sessões 'novas' sejam contadas (por exemplo, anexar à primeira nova sessão do Citrix).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome da sessão IA-Connect anexado
AttachedIAConnectSessionName string

O nome da sessão de IA-Connect anexada.

Anexado à sessão
AttachedToSession boolean

Retornará true se IA-Connect tiver anexado a uma sessão ou false, caso contrário.

Armazenar senha na memória do Agente

Armazene uma senha na memória do Agente (criptografada), na qual ela pode ser usada em qualquer ação que dê suporte a senhas armazenadas. As senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador
Identifier True string

Um identificador exclusivo para a senha. Se o identificador já estiver em uso, ele será substituído. Por exemplo: SAPGUILogon. As senhas são recuperadas usando a frase {IAConnectPassword:Identifier}.

Senha
Password True password

A senha a ser armazenada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
StorePasswordInAgentMemoryResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Arquivo UnZIP

Descompacta um arquivo que foi compactado usando compactação ZIP.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo ZIP
ZIPFilename True string

O caminho completo para o arquivo ZIP a ser descompactado. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Extrair pasta
ExtractFolder string

O caminho da pasta na qual extrair o ZIP. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Extrair todos os arquivos para uma única pasta
ExtractAllFilesToSingleFolder boolean

Se definido como True, a estrutura da pasta dentro do ZIP será ignorada e todos os arquivos serão extraídos para a pasta especificada.

Incluir arquivos de expressão regular
IncludeFilesRegEx string

Uma expressão regular opcional para permitir que você especifique quais arquivos devem ser extraídos. Corresponde somente ao nome de arquivo.

Excluir expressão regular de arquivos
ExcludeFilesRegEx string

Uma expressão regular opcional para permitir que você especifique quais arquivos devem ser excluídos da extração. Corresponde somente ao nome de arquivo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de arquivos extraídos com êxito
FilesExtractedSuccessfully integer

O número de arquivos que foram extraídos do ZIP com êxito.

Falha ao extrair o número de arquivos
FilesFailedToExtract integer

O número de arquivos que falharam ao extrair do ZIP.

Número de arquivos excluídos
FilesExcluded integer

O número de arquivos que foram excluídos (se estiver usando a entrada "Excluir expressão regular de arquivos").

Arrastar o mouse do meio entre coordenadas

Executa um arrastar de botão do mouse do meio entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Parâmetros

Nome Chave Obrigatório Tipo Description
Iniciar pixels X
StartXCoord True integer

O valor da coordenada X inicial (em pixels).

Iniciar pixels Y
StartYCoord True integer

O valor da coordenada Y inicial (em pixels).

Pixels de extremidade X
EndXCoord True integer

O valor da coordenada X final (em pixels).

Pixels de fim Y
EndYCoord True integer

O valor da coordenada Y final (em pixels).

Número de etapas
NumberOfSteps integer

O número de etapas em que a ação de arrastar deve ser dividida.

Tempo total em segundos
TotalTimeInSeconds double

O tempo total que a ação de arrastar deve levar do início ao fim.

Tremulação máxima do pixel de movimento
MaximumMovementPixelJitter integer

O tremulação máxima de pixel ao executar a ação de arrastar. Um valor igual a 1 ou superior permite o tremulação de movimento. O tremulação é suavizado em cada etapa, para evitar picos de movimento. O valor dessa entrada controla o máximo que o tremulação pode estar em qualquer ponto específico, limitando o quão longe o mouse pode se desviar do caminho. Quanto maior o valor, menos "suave" a ação de arrastar será exibida. O tremulação em cada ponto só pode desviar do valor de tremulação anterior entre -2 e 2 (por padrão), portanto, o tremulação máximo possível é 2 x NumberOfSteps, independentemente do que você definir o máximo.

Tremulação máxima do pixel de extremidade
MaximumEndPixelJitter integer

O tremulação máxima de pixel no final da ação de arrastar. Quanto maior o valor, menos preciso será o arrastar ao atingir a coordenada final.

Delta de tremulação de pixel de movimento máximo
MaximumMovementPixelJitterDelta integer

Se estiver usando o tremulação de movimento do mouse (o movimento máximo do pixel é 1 ou superior), o máximo de tremulação em cada ponto pode se desviar do ponto anterior. Isso é usado para garantir que o tremulação seja suave. Um valor maior resulta em menos suavidade.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Arrastar o mouse para a direita entre coordenadas

Executa um arrastar de botão direito do mouse entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Parâmetros

Nome Chave Obrigatório Tipo Description
Iniciar pixels X
StartXCoord True integer

O valor da coordenada X inicial (em pixels).

Iniciar pixels Y
StartYCoord True integer

O valor da coordenada Y inicial (em pixels).

Pixels de extremidade X
EndXCoord True integer

O valor da coordenada X final (em pixels).

Pixels de fim Y
EndYCoord True integer

O valor da coordenada Y final (em pixels).

Número de etapas
NumberOfSteps integer

O número de etapas em que a ação de arrastar deve ser dividida.

Tempo total em segundos
TotalTimeInSeconds double

O tempo total que a ação de arrastar deve levar do início ao fim.

Tremulação máxima do pixel de movimento
MaximumMovementPixelJitter integer

O tremulação máxima de pixel ao executar a ação de arrastar. Um valor igual a 1 ou superior permite o tremulação de movimento. O tremulação é suavizado em cada etapa, para evitar picos de movimento. O valor dessa entrada controla o máximo que o tremulação pode estar em qualquer ponto específico, limitando o quão longe o mouse pode se desviar do caminho. Quanto maior o valor, menos "suave" a ação de arrastar será exibida. O tremulação em cada ponto só pode desviar do valor de tremulação anterior entre -2 e 2 (por padrão), portanto, o tremulação máximo possível é 2 x NumberOfSteps, independentemente do que você definir o máximo.

Tremulação máxima do pixel de extremidade
MaximumEndPixelJitter integer

O tremulação máxima de pixel no final da ação de arrastar. Quanto maior o valor, menos preciso será o arrastar ao atingir a coordenada final.

Delta de tremulação de pixel de movimento máximo
MaximumMovementPixelJitterDelta integer

Se estiver usando o tremulação de movimento do mouse (o movimento máximo do pixel é 1 ou superior), o máximo de tremulação em cada ponto pode se desviar do ponto anterior. Isso é usado para garantir que o tremulação seja suave. Um valor maior resulta em menos suavidade.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Arrastar o mouse à esquerda entre coordenadas

Executa um arrastar de botão esquerdo do mouse entre as duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Parâmetros

Nome Chave Obrigatório Tipo Description
Iniciar pixels X
StartXCoord True integer

O valor da coordenada X inicial (em pixels).

Iniciar pixels Y
StartYCoord True integer

O valor da coordenada Y inicial (em pixels).

Pixels de extremidade X
EndXCoord True integer

O valor da coordenada X final (em pixels).

Pixels de fim Y
EndYCoord True integer

O valor da coordenada Y final (em pixels).

Número de etapas
NumberOfSteps integer

O número de etapas em que a ação de arrastar deve ser dividida.

Tempo total em segundos
TotalTimeInSeconds double

O tempo total que a ação de arrastar deve levar do início ao fim.

Tremulação máxima do pixel de movimento
MaximumMovementPixelJitter integer

O tremulação máxima de pixel ao executar a ação de arrastar. Um valor igual a 1 ou superior permite o tremulação de movimento. O tremulação é suavizado em cada etapa, para evitar picos de movimento. O valor dessa entrada controla o máximo que o tremulação pode estar em qualquer ponto específico, limitando o quão longe o mouse pode se desviar do caminho. Quanto maior o valor, menos "suave" a ação de arrastar será exibida. O tremulação em cada ponto só pode desviar do valor de tremulação anterior entre -2 e 2 (por padrão), portanto, o tremulação máximo possível é 2 x NumberOfSteps, independentemente do que você definir o máximo.

Tremulação máxima do pixel de extremidade
MaximumEndPixelJitter integer

O tremulação máxima de pixel no final da ação de arrastar. Quanto maior o valor, menos preciso será o arrastar ao atingir a coordenada final.

Delta de tremulação de pixel de movimento máximo
MaximumMovementPixelJitterDelta integer

Se estiver usando o tremulação de movimento do mouse (o movimento máximo do pixel é 1 ou superior), o máximo de tremulação em cada ponto pode se desviar do ponto anterior. Isso é usado para garantir que o tremulação seja suave. Um valor maior resulta em menos suavidade.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Atribuir uma tarefa de automação do Orchestrator

Atribui uma tarefa de automação do Orchestrator selecionada a um usuário ou grupo especificado. Essa atribuição será passada para o sistema de origem vinculado a essa tarefa de automação (por exemplo, ServiceNow) e é mais comumente usada para passar um tíquete para outra pessoa ou grupo de pessoas, para processamento adicional. Se a tarefa de automação orchestrator não estiver vinculada a uma origem, uma exceção será gerada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa Orchestrator a ser atribuída.

Atribuir à ID do usuário
AssignToUserId string

A ID do usuário à qual atribuir a tarefa. Use essa entrada se atribuir a tarefa a um usuário e você souber a ID do usuário. Use a ID de usuário ou a entrada do nome de usuário, não ambos, ou se estiver atribuindo a um grupo, deixe essa entrada em branco.

Atribuir ao nome de usuário
AssignToUserName string

O nome do usuário ao qual atribuir a tarefa. Use essa entrada se atribuir a tarefa a um usuário e você souber o nome de usuário. Use a ID de usuário ou a entrada de nome de usuário, não ambos, ou se estiver atribuindo a um grupo, deixe essa entrada em branco.

Atribuir à ID do grupo
AssignToGroupId string

A ID do grupo ao qual atribuir a tarefa. Use essa entrada se atribuir a tarefa a um grupo e você souber a ID do grupo. Use a ID do grupo ou a entrada do nome do grupo, não ambos, ou se estiver atribuindo a um usuário, deixe essa entrada em branco.

Atribuir ao nome do grupo
AssignToGroupName string

O nome do grupo ao qual atribuir a tarefa. Use essa entrada se atribuir a tarefa a um grupo e você souber o nome do grupo. Use a ID do grupo ou a entrada do nome do grupo, não ambos, ou se estiver atribuindo a um usuário, deixe essa entrada em branco.

Remover atribuição de usuário se estiver em branco
RemoveUserAssignmentIfBlank boolean

Se os campos de atribuição de usuário estiverem em branco e esse campo for definido como true, qualquer usuário atribuído no momento será removido, caso contrário, as atribuições de usuário serão deixadas inalteradas.

Remover atribuição de grupo se estiver em branco
RemoveGroupAssignmentIfBlank boolean

Se os campos de atribuição de grupo estiverem em branco e esse campo for definido como true, qualquer grupo atribuído no momento será removido, caso contrário, as atribuições de grupo serão deixadas inalteradas.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksAssignTaskResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Atualizar o resultado das estatísticas do Orchestrator Flow

Atualize as estatísticas de resultado do Fluxo de Trabalho atual no Orquestrador de IA-Connect. Isso é usado para modificar o resultado final de uma estatística de Fluxo no Orquestrador de IA-Connect que normalmente é usado para fins de relatório. Isso só funciona para o Fluxo atual (o Orchestrator detecta a ID de execução do Flow). Você não pode modificar as estatísticas para qualquer outro Flow.

Parâmetros

Nome Chave Obrigatório Tipo Description
Êxito da última ação do fluxo
FlowLastActionSuccess boolean

Defina como true para especificar que a última ação em uma estatística do Orchestrator Flow é um sucesso. Defina como false para especificar que a última ação em uma estatística do Orchestrator Flow é uma falha. Deixe esse campo em branco se você não quiser atualizar o status da última ação do fluxo (por exemplo: se desejar atualizar apenas o último código de ação.

Mensagem de erro da última ação do fluxo
FlowLastActionErrorMessage string

Se especificar que a última ação do Flow foi uma falha, forneça uma mensagem de erro aqui.

Código da última ação de fluxo
FlowLastActionCode integer

Um código opcional a ser atribuído à estatística do Flow. Normalmente, isso é usado como um código de erro (por exemplo, para distinguir entre exceções de Sistema e Negócios), mas pode ser usado como um código de êxito.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
UpdateOrchestratorFlowStatsResultResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Baixar arquivo HTTP

Baixa um arquivo no computador em que o agente de IA-Connect está em execução usando HTTP(S).

Parâmetros

Nome Chave Obrigatório Tipo Description
Transferir URL
DownloadURL True string

A URL de download HTTP ou HTTPS.

Salvar caminho do arquivo
SaveFilename string

O caminho completo para salvar o nome do arquivo. Se esse campo estiver em branco e você tiver especificado "Retornar conteúdo como cadeia de caracteres" como True, o arquivo não será salvo no computador.

Substituir arquivo existente
OverwriteExistingFile boolean

Se já existir um arquivo com o nome especificado na entrada 'Salvar caminho do arquivo', ele deverá ser substituído?

Autenticação de passagem
PassthroughAuthentication boolean

As credenciais do usuário devem ser passadas para o servidor Web? Normalmente, isso só seria usado para sites internos da Intranet.

Agente do usuário
UserAgent string

Isso permite que você defina o Agente de Usuário relatado para a página da Web. Normalmente, isso não é necessário e só deve ser alterado se uma página da Web exigir uma cadeia de caracteres de agente específica.

Aceitar
Accept string

Esse parâmetro especifica quais tipos de conteúdo têm suporte. Isso só deverá ser alterado se o conteúdo que você está baixando exigir um tipo de conteúdo diferente.

Suporte ao TLS10
SupportTLS10 boolean

Defina como True para dar suporte ao protocolo de criptografia TLS 1.0.

Suporte ao TLS11
SupportTLS11 boolean

Defina como True para dar suporte ao protocolo de criptografia TLS 1.1.

Suporte a TLS12
SupportTLS12 boolean

Defina como True para dar suporte ao protocolo de criptografia TLS 1.2.

Descompactar automaticamente o deflate
AutoDecompressDeflate boolean

Algum conteúdo da Web é retornado compactado usando compactação 'deflate'. Definir esse valor como True informa ao servidor Web que há suporte para 'deflate' e, se o conteúdo for enviado usando essa compactação, ele será descompactado automaticamente.

Descompactar o GZip automaticamente
AutoDecompressGZIP boolean

Algum conteúdo da Web é retornado compactado usando a compactação 'GZIP'. Definir esse valor como True informa ao servidor Web que há suporte para 'GZIP' e, se o conteúdo for enviado usando essa compactação, ele será descompactado automaticamente.

Retornar conteúdo como cadeia de caracteres
ReturnContentsAsString boolean

O conteúdo do arquivo deve ser retornado como uma cadeia de caracteres?

Retornar codificação de conteúdo
ReturnContentEncoding string

A codificação do conteúdo baixado. Isso só será usado se 'Retornar conteúdo como cadeia de caracteres' for True e definir a codificação do conteúdo baixado para que ele possa ser interpretado corretamente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Baixar conteúdo do arquivo
DownloadFileContents string

O conteúdo do arquivo baixado.

Botão direito do mouse para baixo

Pressiona (e não libera) o botão direito do mouse na sessão de usuário do agente IA-Connect. Para liberar o mouse, use a ação de botão direito do mouse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Botão direito do mouse para cima

Libera o botão direito do mouse na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Botão do mouse do meio para baixo

Pressiona (e não libera) o botão do mouse do meio na sessão de usuário do agente do IA-Connect. Para liberar o mouse, use a ação do botão do mouse central.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Botão do mouse do meio para cima

Libera o botão do mouse do meio na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Botão esquerdo do mouse para baixo

Pressiona (e não libera) o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect. Para liberar o mouse, use a ação do botão esquerdo do mouse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Botão esquerdo do mouse para cima

Libera o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Calibrar mouse_event

Calibra o método mouse_event movendo o mouse pelo número especificado de pixels e lendo a nova posição do mouse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tamanho da calibragem em pixels
CalibrationSizeInPixels integer

O número de pixels que o mouse será movido para calibrar. Quanto menor o valor, menos preciso será a calibragem.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Multiplicador do Mouse X
MouseXMultiplier double

O valor do multiplicador X do mouse. Um valor de 1,0 não indica nenhum multiplicador.

Multiplicador do Mouse Y
MouseYMultiplier double

O valor do multiplicador Y do mouse. Um valor de 1,0 não indica nenhum multiplicador.

Captura de tela

Captura de tela da sessão de usuário do agente IA-Connect e a retorna como uma cadeia de caracteres codificada em Base64.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tela inteira
Fullscreen boolean

A captura de tela deve incluir a tela inteira?

Pixels X esquerdos
LeftXPixels integer

Se não estiver tirando uma captura de tela de toda a tela, o valor X (em pixels) de onde a captura de tela deve ser iniciada. Em uma única exibição, o pixel X mais à esquerda é 0. Em uma exibição de vários monitores, o pixel X mais à esquerda pode ser negativo (dependendo de qual exibição é marcada como primária e onde ela é relativa às outras exibições).

Principais pixels Y
TopYPixels integer

Se não estiver tirando uma captura de tela de toda a tela, o valor Y (em pixels) de onde a captura de tela deve ser iniciada. Em uma única exibição, o pixel Y superior é 0. Em uma exibição de vários monitores, o pixel Y superior pode ser negativo (dependendo de qual exibição é marcada como primária e onde ela é relativa às outras exibições).

Pixels de largura
WidthPixels integer

Se não estiver tirando uma captura de tela de toda a tela, a largura da captura de tela da posição inicial.

Pixels de altura
HeightPixels integer

Se não estiver tirando uma captura de tela de toda a tela, a altura da captura de tela da posição inicial.

Formato de imagem
ImageFormat string

Forneça o formato de imagem (PNG, JPG, BMP ou GIF).

Usar dispositivo de exibição
UseDisplayDevice boolean

O agente de IA-Connect deve levar em consideração as informações do dispositivo de exibição? Isso funcionará melhor com o dimensionamento de DPI e fornecerá suporte para várias exibições.

Gerar exceção no erro
RaiseExceptionOnError boolean

Se definir o true: o agente de IA-Connect gerará uma exceção se a captura de tela falhar (por exemplo, se a sessão estiver bloqueada). Se definir o false: o IA-Connect retornará um bitmap em branco se a captura de tela falhar e preencherá as saídas "Captura de tela bem-sucedida" e "Mensagem de erro de captura de tela".

Ocultar Agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça a captura de tela.

Usar coordenadas físicas
UsePhysicalCoordinates boolean

Defina como true para especificar que as coordenadas fornecidas são físicas (não dimensionadas por DPI e, portanto, correspondem aos pixels físicos na exibição). Defina como false (o padrão) para especificar que as coordenadas fornecidas são virtuais (DPI dimensionada). Ações UIA, Java e Web normalmente usam coordenadas virtuais.

Exibir id do dispositivo
DisplayDeviceId integer

Essa entrada só funciona quando a entrada "Usar dispositivo de exibição" é definida como true. Defina como 0 (o padrão) para incluir todos os monitores. Defina como 1 para incluir apenas o monitor primário. Defina como 2 ou superior para incluir apenas o monitor secundário relevante.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Imagem de tela como Base64
ScreenBitmapBase64 string

A imagem da tela como uma cadeia de caracteres codificada em Base64. Isso pode ser exibido usando o utilitário fornecido 'Base64 para bitmap'.

Captura de tela bem-sucedida
ScreenshotSuccessful boolean

Defina como true se a captura de tela for bem-sucedida. Defina como false se a captura de tela falhou e "Gerar exceção no erro" foi definido como false. Uma exceção será gerada se a captura de tela falhar e "Gerar exceção ao erro" tiver sido definida como true.

Mensagem de erro de captura de tela
ScreenshotErrorMessage string

Se a captura de tela falhou e "Gerar exceção no erro" foi definido como false, esse campo de saída conterá a mensagem de erro. Essa é uma alternativa para definir 'Gerar exceção no erro' como true, o que resultará em uma exceção se houver um erro ao executar a captura de tela.

Clique com o botão direito do mouse

Clica no botão direito do mouse na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique com o botão direito do mouse na coordenada

Clica no botão direito do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique com o botão esquerdo do mouse na coordenada

Clica no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique duas vezes no mouse à esquerda

Clique duas vezes no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Atraso em milissegundos
DelayInMilliseconds integer

O atraso entre cada clique, em milissegundos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique duas vezes no mouse à esquerda na coordenada

Clique duas vezes no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Atraso em milissegundos
DelayInMilliseconds integer

O atraso entre cada clique, em milissegundos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique no mouse à esquerda

Clica no botão esquerdo do mouse na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Colocar a GUI do agente de IA-Connect na frente

Traz a GUI do agente de IA-Connect para a frente para que ela fique visível na tela.

Parâmetros

Nome Chave Obrigatório Tipo Description
Foco
Focus boolean

A GUI do agente de IA-Connect deve estar focada?

Clique global do mouse à esquerda
GlobalLeftMouseClick boolean

Um clique global do mouse esquerdo deve ser usado para colocar o Agente na frente? Isso garante um evento de entrada para a frente em um cenário em que o método de foco poderia ser restringido pelo sistema operacional impedindo que os aplicativos se colocassem na frente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Configurar o próximo salto IA-Connect Director

Configure o diretor de próximo salto em um cenário de salto duplo. Isso só será necessário se o padrão IA-Connect configurações de diretório de próximo salto não forem adequadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
SOAP habilitado
SOAPEnabled boolean

A interface SOAP deve ser habilitada no diretor do próximo salto?

REST habilitado
RESTEnabled boolean

A interface REST deve ser habilitada no diretor do próximo salto?

Servidor Web habilitado
WebServerEnabled boolean

O servidor Web (para hospedar o inspetor de IA-Connect) deve ser habilitado no diretor de próximo salto?

O diretor é somente localhost
DirectorIsLocalhostOnly boolean

As interfaces DIRECTOR SOAP e REST devem escutar apenas em 'localhost'? Isso deve ser definido como true, pois nenhum outro computador deve precisar se comunicar com essas interfaces.

Porta TCP SOAP
SOAPTCPPort integer

Se a interface SOAP estiver habilitada, em qual porta TCP ela deve ser executada (padrão para 8002)?

Porta TCP REST
RESTTCPPort integer

Se a interface REST estiver habilitada, em qual porta TCP ela deve ser executada (padrão para 8002)?

SOAP usa HTTPS
SOAPUsesHTTPS boolean

A interface SOAP está usando HTTPS (em vez de HTTP)? Se definido como True, um certificado será necessário no computador de primeiro salto para facilitar o HTTPS. Isso pode ser compartilhado com o certificado usado para REST.

REST usa HTTPS
RESTUsesHTTPS boolean

A interface REST está usando HTTPS (em vez de HTTP)? Se definido como True, um certificado será necessário no computador de primeiro salto para facilitar o HTTPS. Isso pode ser compartilhado com o certificado usado para SOAP.

Incrementar porta TCP do Diretor por SessionId
IncrementDirectorTCPPortBySessionId boolean

Para garantir que a porta TCP do Diretor seja exclusiva (se houver várias sessões paralelas usando o salto duplo do mesmo host de primeiro salto), a ID da Sessão de primeiro salto poderá ser adicionada à porta TCP do Diretor. Isso só será necessário se SOAP ou REST estiver habilitado no diretor de primeiro salto e eles normalmente não estiverem habilitados porque os pipes nomeados são usados por padrão.

SOAP usa autenticação de usuário
SOAPUsesUserAuthentication boolean

Defina como True se você quiser que a porta TCP HTTP SOAP use a autenticação do usuário. Consulte o Guia de Instalação do IA-Connect para obter informações sobre como configurar isso.

O REST usa a autenticação do usuário
RESTUsesUserAuthentication boolean

Defina como True se você quiser que a porta TCP REST HTTP use a autenticação do usuário. Consulte o Guia de Instalação do IA-Connect para obter informações sobre como configurar isso.

Comando chamado pipe habilitado
CommandNamedPipeEnabled boolean

O agente de primeiro salto deve usar pipes nomeados para se comunicar com o diretor de primeiro salto? Esse é o método de comunicação padrão.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Converter coordenadas de retângulo

Converte uma coordenada de pixel de retângulo de virtual para físico ou físico em virtual. Se você quiser converter um ponto, basta definir Right=Left e Bottom=Top. As coordenadas físicas são mapeadas diretamente para pixels no monitor. As coordenadas virtuais são dimensionadas por DPI. Se o dimensionamento de exibição subjacente de todos os dispositivos de exibição for de 100%, as coordenadas físicas e virtuais serão as mesmas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Retângulo da tela da borda esquerda pixel X
RectangleLeftPixelXCoord True integer

A borda do pixel esquerdo do retângulo a ser convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Coordenada Y do pixel Y da tela de borda superior do retângulo
RectangleTopPixelYCoord True integer

A borda de pixel superior do retângulo a ser convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Retângulo da tela da borda direita pixel X
RectangleRightPixelXCoord True integer

A borda do pixel direito do retângulo a ser convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Coordenada Y do pixel Y da tela de borda inferior do retângulo
RectangleBottomPixelYCoord True integer

A borda inferior do pixel do retângulo a ser convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Tipo de conversão
ConversionType True string

O tipo de conversão: de físico para virtual (PhysicalToVirtual ou P2V) ou virtual para físico (VirtualToPhysical ou V2P).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Coordenada X do pixel de tela de borda esquerda do retângulo convertido
ConvertedRectangleLeftPixelXCoord integer

A borda do pixel esquerdo do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Coordenada Y do pixel Y da tela de borda superior do retângulo convertido
ConvertedRectangleTopPixelYCoord integer

A borda de pixel superior do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Coordenada X do pixel X do retângulo retângulo convertido na borda direita
ConvertedRectangleRightPixelXCoord integer

A borda do pixel direito do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Coordenada Y do pixel Y da tela de borda inferior do retângulo convertido
ConvertedRectangleBottomPixelYCoord integer

A borda inferior do pixel do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Largura do retângulo convertido
ConvertedRectangleWidth integer

A largura em pixels do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Altura do retângulo convertido
ConvertedRectangleHeight integer

A altura em pixels do retângulo convertido. Pode estar em pixels virtuais ou físicos dependendo do tipo de conversão.

Copiar arquivo

Copia um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo de origem
SourceFilePath True string

O caminho completo para o arquivo de origem. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Caminho do arquivo de destino
DestFilePath True string

O caminho completo para o destino para o qual o arquivo deve ser copiado. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Copiar arquivo de cliente para servidor

Copia um arquivo do computador local (executando o IA-Connect Director) para o computador remoto (executando o agente IA-Connect).

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo do cliente
ClientFilePath True string

O caminho do arquivo do qual copiar o arquivo (no computador local que executa o IA-Connect Director).

Caminho do arquivo do servidor
ServerFilePath True string

O caminho do arquivo para o qual copiar o arquivo (no computador que executa o agente de IA-Connect).

Comprimir
Compress boolean

O arquivo deve ser compactado ao copiar?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Copiar arquivo para área de transferência

Copia o arquivo local especificado para a área de transferência na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do arquivo
Filepath True string

O caminho do arquivo para o arquivo local a ser copiado para a área de transferência.

Recortar
Cut boolean

Se definido como true, o arquivo será cortado em vez de copiado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
CopyFileToClipboardResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Criar arquivo de inicialização da RDS (Sessão de Área de Trabalho Remota)

Crie um arquivo de inicialização de RDS (Sessão de Área de Trabalho Remota) que pode ser usado para iniciar automaticamente uma Sessão de Área de Trabalho Remota usando parâmetros especificados, em vez de exigir a automação da interface do usuário do cliente da Área de Trabalho Remota. Um arquivo de inicialização de RDS tem a extensão '.rdp' e geralmente é chamado de arquivo RDP.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço remoto
RemoteAddress True string

O endereço do sistema remoto ao qual se conectar. Pode ser um endereço IP, nome do host ou FQDN (Nome de Domínio Totalmente Qualificado).

Caminho da pasta de saída
OutputFolderPath True string

A pasta na qual salvar o arquivo RDP.

Nome de arquivo RDP
RDPFileName True string

O nome do arquivo RDP que será criado no caminho da pasta de saída.

Substituir o arquivo RDP se já existir
OverwriteRDPFileIfAlreadyExists boolean

Defina como true para substituir automaticamente qualquer arquivo RDP com a mesma pasta/nome de arquivo. Defina como false se um novo arquivo RDP não deve ser criado se já existir um arquivo RDP existente com a mesma pasta/nome de arquivo.

Confiar no computador remoto
TrustRemoteComputer boolean

Defina como true para marcar o endereço remoto como confiável (no Registro do Windows), principalmente para fins de redirecionamento de dispositivo, eliminando um pop-up que você pode receber ao iniciar o arquivo RDP.

Armazenar credenciais
StoreCredentials boolean

Defina como true para criar uma credencial de usuário para manter os detalhes da autenticação da Área de Trabalho Remota. Isso pode permitir que você se conecte ao sistema de Área de Trabalho Remota sem ser solicitado a autenticação.

UserName
UserName string

Se estiver armazenando uma credencial para manter os detalhes da autenticação da Área de Trabalho Remota, isso permitirá que você especifique o nome de usuário a ser armazenado na credencial.

Senha
Password string

Se estiver armazenando uma credencial para manter os detalhes da autenticação da Área de Trabalho Remota, isso permitirá que você especifique a senha a ser armazenada na credencial.

Tipo de credencial
CredentialType string

Se você armazenar uma credencial para manter os detalhes da autenticação da Área de Trabalho Remota, permitirá que você especifique o tipo de credencial: Windows ou Generic. Para salvar uma credencial RDP, você normalmente criaria uma credencial do Windows.

Persistência de credencial
CredentialPersistence string

Se estiver armazenando uma credencial para manter os detalhes de autenticação da Área de Trabalho Remota, isso permitirá que você especifique a persistência de credencial: Sessão (dura apenas para esta sessão de logon), LocalMachine (persiste para esse usuário em sessões e reinicializações somente neste computador) ou Enterprise (pode vagar para isso entre computadores). O padrão ao criar arquivos RDP é "Sessão".

Redirecionar impressoras
RedirectPrinters boolean

As impressoras na sessão local devem ser mapeadas para a sessão da área de trabalho remota? Essa configuração pode ser imposta no final remoto e, portanto, não entrar em vigor.

Redirecionar todas as unidades
RedirectAllDrives boolean

Todas as letras da unidade (por exemplo, C:) na sessão local devem ser mapeadas para a sessão da área de trabalho remota? Essa configuração pode ser imposta no final remoto e, portanto, não entrar em vigor.

Área de transferência de redirecionamento
RedirectClipboard boolean

A área de transferência deve ser compartilhada entre o sistema local e remoto, permitindo copiar e colar entre os dois sistemas? Essa configuração pode ser imposta no final remoto e, portanto, não entrar em vigor.

Tela inteira
Fullscreen boolean

Se a sessão da área de trabalho remota estiver em tela inteira.

Largura da área de trabalho
DesktopWidth integer

A largura da sessão de área de trabalho remota em pixels se a sessão da área de trabalho remota não estiver em tela inteira.

Altura da área de trabalho
DesktopHeight integer

A altura da sessão da área de trabalho remota em pixels se a sessão de área de trabalho remota não estiver em tela inteira.

Usar vários monitores
UseMultiMonitor boolean

Defina como false se uma sessão de área de trabalho remota de tela inteira deve usar apenas um único monitor. Defina como true se uma sessão de área de trabalho remota de tela inteira deve usar todos os monitores. Não tem efeito em um sistema de monitor único (e, portanto, na maioria das máquinas virtuais).

Profundidade da cor da sessão
SessionBPP integer

A profundidade da cor da sessão de área de trabalho remota em bits por pixel (BPP). Um número maior resulta em mais cores. Os valores com suporte são 15, 16, 24, 32.

Dimensionamento inteligente
SmartSizing boolean

Defina como true para o computador local dimensionar automaticamente o conteúdo da sessão remota para ajustar o tamanho das janelas. Defina como false para não dimensionar automaticamente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Caminho do arquivo RDP
RDPFilePath string

O caminho completo do arquivo RDP gerado.

Criar diretório

Cria um diretório (pasta) no computador em que o agente IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Erro se já existir
ErrorIfAlreadyExists boolean

Deve IA-Connect gerar um erro se o diretório (pasta) já existir?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Criar segredo único do Orchestrator

Um segredo único fornece uma instalação para armazenar um segredo que pode ser recuperado uma vez, por meio de uma URL exclusiva indissível. Normalmente, isso é usado para compartilhar segredos com terceiros. Você pode criar um segredo único usando a interface do usuário do Orchestrator, a API REST ou seu fluxo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome amigável
FriendlyName True string

Esse é um nome descritivo que é puramente usado para identificar esse segredo único. A única finalidade desse nome é exibir na lista de segredos na interface do usuário do Orchestrator.

Valor do segredo
SecretValue password

O valor de segredo único que você deseja compartilhar e disponibilizar por meio de uma URL única.

Frase de recuperação 1
RetrievalPhrase1 password

Essa é uma frase necessária para recuperar o segredo único, por meio da URL exclusiva. Se estiver em branco, uma frase de recuperação não será necessária. As fases de recuperação diferenciam maiúsculas de minúsculas.

Frase de recuperação 2
RetrievalPhrase2 password

Esta é uma segunda frase necessária para recuperar o segredo único, por meio da URL exclusiva. Se estiver em branco, uma frase de recuperação não será necessária. As fases de recuperação diferenciam maiúsculas de minúsculas.

Recuperações máximas antes da exclusão
MaximumRetrievalsBeforeDeletion integer

Quantas vezes esse segredo único pode ser recuperado antes de ser excluído do Orchestrator? Por padrão, isso é definido como 1 (uma vez). Definido apenas como um valor mais alto se várias pessoas precisarem acessar esse segredo.

O segredo tem uma data de início
SecretHasAStartDate boolean

Habilite se o segredo não deve estar disponível para recuperação até uma data e hora específicas.

Data e hora de início do segredo
SecretStartDateTime date-time

A data e a hora em que esse segredo ficará disponível para recuperação. As datas e horas são inseridas no formato dd/MM/yyyyy HH:mm e armazenadas e processadas em UTC/GMT+0. Por exemplo: '2022-01-24T07:00:00' impediria que o segredo único fosse recuperado antes das 07:00 horas UTC (GMT+0) no dia 24 de janeiro de 2022 (você receberá um 404). Como alternativa, use a entrada "Horas até a hora de início do segredo". Ao usar essa entrada, você deve definir 'Segredo tem uma data de início' como true ou a entrada será ignorada.

Horas até a hora de início do segredo
HoursUntilSecretStartTime integer

O número de horas até que esse segredo esteja disponível para recuperação. Como alternativa, use a entrada "Data e hora de início do segredo". Ao usar essa entrada, você deve definir 'Segredo tem uma data de início' como true.

O segredo tem uma data de expiração
SecretHasAnExpiryDate boolean

Habilite se o segredo deve ser excluído automaticamente após um período de tempo, independentemente de ele ter sido recuperado.

Data e hora de expiração do segredo
SecretExpiryDateTime date-time

A data e a hora em que esse segredo será excluído automaticamente, independentemente de ele ter sido recuperado. As datas e horas são inseridas no formato yy-MM-ddTHH:mm:ss e armazenadas e processadas em UTC/GMT+0. Por exemplo: '2022-01-24T07:00:00' excluiria o segredo único às 07:00 horas UTC (GMT+0) no dia 24 de janeiro de 2022. Como alternativa, use a entrada "Horas até a expiração secreta". Ao usar essa entrada, você deve definir 'Segredo tem uma data de expiração' como true ou a entrada será ignorada.

Horas até a expiração do segredo
HoursUntilSecretExpiry integer

O número de horas até que esse segredo seja excluído automaticamente, independentemente de ele ter sido recuperado. Como alternativa, use a entrada "Data e hora de expiração do segredo". Ao usar essa entrada, você deve definir 'Segredo tem uma data de expiração' como true.

Retornos

Nome Caminho Tipo Description
URL de recuperação
RetrievalURL string

A URL única, usada para recuperar o segredo único.

ID de recuperação
RetrievalId string

A ID de recuperação exclusiva. Essa URL única é criada com base nessa ID exclusiva. Essa ID poderá ser útil se você precisar construir sua própria URL, em um cenário personalizado.

Definir a configuração de coordenadas globais do agente de IA-Connect

Configura o sistema de coordenadas globais IA-Connect Agent, que é usado para exibir locais de elementos (por exemplo: durante a inspeção do mouse) e calcular posições do mouse (por exemplo: ao executar ações globais do mouse). Os padrões fornecem a funcionalidade mais recente, mas você pode usar essa ação para reverter para o comportamento em versões anteriores do Agente ou especificar que uma API está usando um sistema de coordenadas diferente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Funcionalidade de vários monitores
MultiMonitorFunctionality string

Defina como "Somente exibição primária" (PrimaryMonitor) para reverter para um comportamento mais antigo, que só dá suporte ao realce de elementos e à execução de ações globais do mouse no dispositivo de exibição primário (o único modo disponível no IA-Connect 9.3 e anterior). Defina como "Todas as exibições" (MultiMonitor) para habilitar o realce de elementos e executar ações globais do mouse em todos os monitores e detectar automaticamente o dimensionamento de DPI em cada monitor (o padrão desde IA-Connect 9.4). Defina como "Não definido" (NotSet) para não fazer nenhuma alteração.

Multiplicador de inspeção de mouse de conjunto automático
AutoSetMouseInspectionMultiplier string

Defina como "Auto" (1) (o padrão desde IA-Connect 9.4) para calcular automaticamente o multiplicador de inspeção do mouse no dispositivo de exibição primário na inicialização do Agente e sempre que a inspeção do mouse for executada. Defina como "Manual" (0) para exigir que o multiplicador de inspeção seja definido manualmente (a única opção disponível no IA-Connect 9.3 e anterior). Defina como em branco ou "NotSet" para deixar essa opção inalterada. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Multiplicador de mouse global de conjunto automático
AutoSetGlobalMouseMultiplier string

Defina como "Auto" (1) (o padrão desde IA-Connect 9.4) para calcular automaticamente o multiplicador de movimento global do mouse no dispositivo de exibição primário na inicialização do Agente e sempre que a inspeção do mouse for executada. Defina como "Manual" (0) para exigir que o multiplicador global de movimento do mouse seja definido manualmente (a única opção disponível no IA-Connect 9.3 e anterior). Defina como em branco ou "NotSet" para deixar essa opção inalterada. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Multiplicador X de inspeção do mouse
MouseInspectionXMultiplier double

O multiplicador de inspeção horizontal (X) do mouse a ser definido (para quando o Agente realça o que está sob o mouse). Por exemplo: se IA-Connect estiver exibindo o retângulo de inspeção em metade do local real do mouse X, defina um valor de 0,5. Defina como 0 para deixar o valor atual inalterado. Essa opção só tem qualquer efeito quando 'Funcionalidade de vários monitores' está desabilitada e 'Multiplicador de inspeção de conjunto automático de mouse' está desabilitado.

Multiplicador Y de inspeção do mouse
MouseInspectionYMultiplier double

O multiplicador vertical de inspeção do mouse (Y) a ser definido (para quando o Agente realça o que está sob o mouse). Por exemplo: se IA-Connect estiver exibindo o retângulo de inspeção em metade do local real do mouse Y, defina um valor de 0,5. Defina como 0 para deixar o valor atual inalterado. Essa opção só tem qualquer efeito quando 'Funcionalidade de vários monitores' está desabilitada e 'Multiplicador de inspeção de conjunto automático de mouse' está desabilitado.

Multiplicador global do mouse X
GlobalMouseXMultiplier double

O multiplicador de movimento do mouse global horizontal (X) a ser definido (para quando o Agente move o mouse). Defina como 0 para deixar o valor atual inalterado. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Multiplicador global do mouse Y
GlobalMouseYMultiplier double

O multiplicador de movimento do mouse global vertical (Y) a ser definido (para quando o Agente move o mouse). Defina como 0 para deixar o valor atual inalterado. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Aplicar a mouse_event
GlobalMouseMultiplierApplyToMouseEvent boolean

Isso especifica se os valores do multiplicador de mouse global devem ser aplicados ao método mouse_event. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Aplicar a SetCursorPos
GlobalMouseMultiplierApplyToSetCursorPos boolean

Esse argumento especifica se os valores do multiplicador de mouse global devem ser aplicados ao método SetCursorPos. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Aplicar ao método de movimentação do mouse atual
GlobalMouseMultiplierApplyToCurrentMouseMoveMethod boolean

Esse argumento especifica se os valores do multiplicador de mouse global devem ser aplicados ao método de movimentação do mouse atual (por exemplo: se SetCursorPos for o método de movimentação do mouse atual, o multiplicador será aplicado a SetCursorPos). Se isso for definido como true, as entradas "Aplicar a mouse_event" e "Aplicar a SetCursorPos" serão ignoradas. Essa opção só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Sistema de coordenadas Java
JavaCoordinateSystem string

Defina como "Virtual" (o padrão e a única opção disponível no IA-Connect 9.3 e anterior) para informar ao Agente que a Ponte de Acesso java está fornecendo coordenadas virtuais (dimensionadas por DPI). Defina como "Físico" para informar ao Agente que a Ponte de Acesso java está fornecendo coordenadas físicas (que são mapeadas diretamente para pixels). Defina como "Não definido" (NotSet) para não fazer nenhuma alteração.

Sistema de coordenadas SAP GUI
SAPGUICoordinateSystem string

Defina como "Virtual" (o padrão e a única opção disponível no IA-Connect 9.3 e anterior) para informar ao Agente que a API de script sap GUI está fornecendo coordenadas virtuais (dimensionadas por DPI). Defina como "Físico" para informar ao Agente que a API de script sap GUI está fornecendo coordenadas físicas (que são mapeadas diretamente para pixels). Defina como "Não definido" (NotSet) para não fazer nenhuma alteração.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
SetAgentGlobalCoordinateConfigurationResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Definir a gui do agente de IA-Connect mais alto

Define o agente de IA-Connect como superior. Isso significa que o agente de IA-Connect sempre estará visível na tela e não poderá ficar oculto atrás de outras janelas do aplicativo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Superior
TopMost boolean

O agente de IA-Connect deve ser definido na parte superior (true) ou deve ser desabilitado (false)?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir a opacidade de GUI do agente de IA-Connect

Define a opacidade do agente de IA-Connect de 1 (visível) para 0 (transparente).

Parâmetros

Nome Chave Obrigatório Tipo Description
Opacidade
Opacity True double

O valor de opacidade a ser definido, entre 1 (visível) e 0 (transparente).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir a posição de GUI do agente de IA-Connect

Define a posição na tela da GUI do agente IA-Connect para o local especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
X
X True integer

A coordenada X para a qual definir o Agente, em pixels.

S
Y True integer

A coordenada Y para a qual definir o Agente, em pixels.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir dados de saída da tarefa de automação do Orchestrator

Define os dados de saída para uma tarefa de automação do Orchestrator. Normalmente usado quando você concluiu uma tarefa e deseja fornecer dados de saída, para ser coletado pelo processo que criou a tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa Orchestrator à qual adicionar a anotação.

Dados de saída da tarefa
TaskOutputData string

A cadeia de caracteres de dados de saída. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto. A cadeia de caracteres de dados de saída pode ser exibida na interface do usuário do Orchestrator ou acessada por meio da API REST TasksGetTask.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksSetOutputDataResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Definir IA-Connect chave de licença

Licencia o agente IA-Connect com uma chave de licença. Pode ser uma cadeia de caracteres de licença ou o nome amigável de uma licença mantida no Orchestrator IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Chave de licença
LicenseString True string

O IA-Connect cadeia de caracteres de chave de licença ou o nome amigável de uma licença mantida no Orquestrador de IA-Connect (se estiver controlando IA-Connect por meio do Orquestrador IA-Connect).

Armazenar no Registro
StoreInRegistry boolean

A licença IA-Connect deve ser armazenada temporariamente no registro? Isso garante que o agente de IA-Connect será licenciado durante a sessão do usuário, mesmo que o Agente seja fechado e relançado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Dias até que a licença expire
DaysUntilLicenseExpires integer

O número de dias restantes até que a licença de IA-Connect expire.

Definir IA-Connect código de licença

Carrega uma licença de domínio do agente de estilo antigo (7.0 e 7.1) para o agente IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome de domínio netBIOS do cliente
CustomerNETBIOSDomainName True string

O nome de domínio NetBIOS do computador em que o agente de IA-Connect está em execução.

Nome de exibição do cliente
CustomerDisplayName True string

O nome do cliente a ser exibido na barra de título do agente IA-Connect.

Nome do fornecedor
VendorName True string

O IA-Connect nome do fornecedor.

Data de expiração da licença
LicenseExpiryDate True string

A data de expiração da licença IA-Connect.

Código de ativação
ActivationCode True string

O código de ativação da licença IA-Connect.

Armazenar no Registro
StoreInRegistry boolean

A licença IA-Connect deve ser armazenada temporariamente no registro? Isso garante que o agente de IA-Connect será licenciado durante a sessão do usuário, mesmo que o Agente seja fechado e relançado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir impressora padrão

Define a impressora padrão para o usuário na sessão IA-Connect Agent.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da impressora padrão
DefaultPrinterName True string

O nome da impressora padrão para o usuário.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir leitor de tela

Habilita ou desabilita o leitor de tela na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Habilitar leitor de tela
EnableScreenReader boolean

Se definido como true, o leitor de tela será habilitado. Se definido como false, o leitor de tela será desabilitado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir multiplicador de mouse

Define o multiplicador de mouse global na sessão de usuário do agente do IA-Connect. Isso pode ser útil durante o desenvolvimento se você encontrar problemas com o dimensionamento de área de trabalho remota.

Parâmetros

Nome Chave Obrigatório Tipo Description
Multiplicador X
MouseXMultiplier double

O multiplicador de mouse global horizontal (X) a ser definido (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Multiplicador Y
MouseYMultiplier double

O multiplicador de mouse global vertical (Y) a ser definido (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Aplicar a mouse_event
ApplyToMouseEvent boolean

Esse argumento especifica se os valores do multiplicador de mouse global devem ser aplicados ao método mouse_event.

Aplicar a SetCursorPos
ApplyToSetCursorPos boolean

Esse argumento especifica se os valores do multiplicador de mouse global devem ser aplicados ao método SetCursorPos.

Aplicar ao método de movimentação do mouse atual
ApplyToCurrentMouseMoveMethod boolean

Esse argumento especifica se os valores do multiplicador de mouse global devem ser aplicados ao método de movimentação do mouse atual (por exemplo: se SetCursorPos for o método de movimentação do mouse atual, o multiplicador será aplicado a SetCursorPos). Se isso for definido como true, as entradas "Aplicar a mouse_event" e "Aplicar a SetCursorPos" serão ignoradas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o modo de manutenção de trabalho do Orchestrator

Coloque um IA-Connect trabalho definido no IA-Connect Orchestrator no modo de manutenção (para que os fluxos não sejam atribuídos ao trabalho) ou tire um trabalho do modo de manutenção.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do trabalho
WorkerId integer

A ID do trabalhador. Esse é um valor inteiro (1 ou superior), interno para o Orchestrator. Você pode determinar a ID de um trabalho exibindo os detalhes do trabalho na interface do usuário do Orchestrator e procurando a ID na URL do navegador. Se você quiser pesquisar o trabalho pelo nome, defina esse valor como 0 e insira um nome no campo 'Nome do trabalho'.

Nome do trabalhador
WorkerName string

O nome do trabalho. Isso fará com que o Orchestrator pesquise sua lista de trabalhos em busca de um trabalho com o nome especificado. Ao pesquisar por nome, defina 'ID do Trabalho' como 0 (para desabilitar usando a ID de trabalho).

Modo de manutenção
MaintenanceMode boolean

Defina como true (o padrão) para habilitar o modo de manutenção, de modo que os fluxos não sejam atribuídos ao trabalho. Defina como false para sair do modo de manutenção, permitindo que os fluxos sejam atribuídos ao trabalhador (supondo que o trabalho não seja negado por outras regras).

Retornos

Nome Caminho Tipo Description
Resultado do comando
SetOrchestratorWorkerMaintenanceModeResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Definir o método de movimentação do mouse

Define o método de movimentação do mouse atual como mouse_event ou setcursorpos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Definir o método de movimentação do mouse
MouseMoveMethod True string

Forneça o método de movimentação do mouse (mouse_event ou setcursorpos).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o nível de log do Agente IA-Connect

Define o nível de log do agente de IA-Connect para o valor especificado (1 sendo o nível mais baixo e 4 sendo o mais alto).

Parâmetros

Nome Chave Obrigatório Tipo Description
Nível de log
LoggingLevel True integer

O nível de registro em log para o qual o agente de IA-Connect deve ser definido.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o nível de log do IA-Connect Director

Define o nível de log do IA-Connect Director como o valor especificado. Os níveis de registro em log são definidos de 0 a 4. 0 está desabilitado. 1 é o nível de log mais baixo (e o padrão). 4 é o nível de log mais alto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nível de log
LoggingLevel True integer

O nível de registro em log para o qual o IA-Connect Director deve ser definido.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o tempo limite de comando do agente de IA-Connect

Define o tempo limite de comando que o agente de IA-Connect usará para cada comando executado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tempo limite do comando em segundos
CommandTimeoutInSeconds True integer

O tempo limite de comando que o agente de IA-Connect usará. Se estiver lendo ou gravando grandes quantidades de dados, talvez você queira aumentar o período de tempo limite.

Encerrar threads de comando RPA de tempo limite
TerminateTimedoutRPACommandThreads boolean

O thread de comando deve ser encerrado se tiver o tempo limite limite?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir posição do cursor do mouse

Define o cursor do mouse na sessão de usuário do agente do IA-Connect para a posição especificada. A API setcursorpos é usada para mover o mouse, independentemente da API de movimento do mouse ativo escolhida.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
X True integer

O valor da coordenada X (em pixels).

Pixels Y
Y True integer

O valor da coordenada Y (em pixels).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir proprietário na pasta

Define o proprietário em uma pasta no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade do usuário
UserIdentity True string

A identidade do usuário a ser atribuído à propriedade. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir proprietário no arquivo

Define o proprietário em um arquivo no computador em que o agente IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
FilePath True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade do usuário
UserIdentity True string

A identidade do usuário a ser atribuído à propriedade. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir área de transferência

Define o conteúdo da área de transferência na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Novos dados da área de transferência
NewClipboardData string

Os dados a serem definidos na área de transferência.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desabilitar IA-Connect próximo salto

Desabilita o próximo salto para que todos os comandos futuros sejam processados pelo Agente que os recebe (em vez de serem encaminhados para o agente do próximo salto).

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desbloquear sessão

Desbloqueia a sessão em que o agente de IA-Connect está em execução. Isso requer que o provedor de credenciais do desbloqueador IA-Connect seja instalado no computador que hospeda a sessão, pois apenas um Provedor de Credenciais pode desbloquear um computador.

Parâmetros

Nome Chave Obrigatório Tipo Description
Desbloquear senha
UnlockPassword True string

A senha para desbloquear a sessão atual. Essa é a senha de usuário do Windows para a conta que está registrada na sessão que está bloqueada no momento. Se essa for uma senha 'Armazenada', insira no formato {IAConnectPassword:StoredPasswordIdentifier} e defina a entrada 'stored password' como true. Se essa for uma credencial genérica do Orchestrator, insira o formato {OrchestratorCredential:FriendlyName} e defina a entrada "senha armazenada" como true.

A senha contém senha armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha for um identificador de senha armazenado IA-Connect (por exemplo: gerado pela ação 'Gerar senha') ou uma credencial genérica do Orchestrator IA-Connect (por exemplo: Se estiver usando IA-Connect com um fluxo de PA).

Detectar se bloqueado
DetectIfLocked True boolean

Se o agente de IA-Connect tentar detectar se a sessão está bloqueada. Se definido como true e a sessão não for detectada como bloqueada, essa ação simplesmente não fará nada (já que não há nada a fazer). Definido apenas como false se IA-Connect estiver detectando incorretamente se a sessão está bloqueada e você deseja forçar uma tentativa de desbloqueio (que falhará se a sessão não estiver bloqueada).

Detectar provedor de credenciais
DetectCredentialProvider True boolean

Se o agente IA-Connect tentar detectar a existência do provedor de credenciais do desbloqueador IA-Connect antes de enviar uma solicitação de desbloqueio. Você só deverá desabilitar isso se o provedor de credenciais IA-Connect estiver presente e em execução, mas, por algum motivo, o agente de IA-Connect não o estiver detectando.

Segundos para aguardar o desbloqueio
SecondsToWaitForUnlock integer

Por quanto tempo (em segundos) o agente de IA-Connect deve aguardar evidências de que a área de trabalho foi desbloqueada com êxito (detectando o estado de desbloqueio da área de trabalho). Por padrão, isso é de até 5 segundos. Defina como 0 para desabilitar esse recurso e continue sem verificar se a área de trabalho foi desbloqueada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Desbloqueio de sessão executado
SessionUnlockPerformed boolean

Definido como true se a sessão foi bloqueada e uma ação de desbloqueio foi executada. Definido como false se a sessão não estiver bloqueada e "Detectar se bloqueado" tiver sido definido como true, resultando em nenhuma ação sendo executada.

Desconectar sessão remota

Se o agente de IA-Connect estiver em execução em uma sessão remota, essa ação desconectará a sessão remota. Isso não é o mesmo que fazer logon e deixará a sessão remota em execução em um estado desconectado. Essa ação pode ser usada onde você deseja se conectar novamente à sessão remota mais tarde e continuar do mesmo estado, em vez de iniciar uma nova sessão. Se o agente de IA-Connect estiver em execução localmente, essa ação bloqueará a sessão.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para esperar
SecondsToWait integer

O tempo de espera antes de emitir o comando de desconexão para o sistema operacional para que o agente de IA-Connect possa relatar a conclusão do comando antes de perder o contato (o que só ocorreria em uma sessão remota).

Não desconecte se o agente local
DoNotDisconnectIfLocalAgent boolean

Se definido como true e o agente de IA-Connect estiver em execução em uma sessão local (ou seja, diretamente no trabalho), essa ação será silenciosamente ignorada. Isso é útil porque desconectar um Agente local bloquearia a sessão e, portanto, limitaria as funções RPA até que a sessão seja desbloqueada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desenhar retângulo na tela

Desenha um retângulo na tela para ajudar na identificação de coordenadas de tela ou na saída de uma ação que relata coordenadas de tela. O retângulo é removido automaticamente após 5 segundos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Retângulo da tela da borda esquerda pixel X
RectangleLeftPixelXCoord True integer

A borda do pixel esquerdo do retângulo a ser exibido. Pode estar em pixels virtuais ou físicos, dependendo da entrada 'Coordenadas são físicas'.

Retângulo da tela da borda direita pixel X
RectangleRightPixelXCoord True integer

A borda do pixel direito do retângulo a ser exibido. Pode estar em pixels virtuais ou físicos, dependendo da entrada 'Coordenadas são físicas'.

Coordenada Y do pixel Y da tela de borda superior do retângulo
RectangleTopPixelYCoord True integer

A borda de pixel superior do retângulo a ser exibido. Pode estar em pixels virtuais ou físicos, dependendo da entrada 'Coordenadas são físicas'.

Coordenada Y do pixel Y da tela de borda inferior do retângulo
RectangleBottomPixelYCoord True integer

A borda inferior do pixel do retângulo a ser exibido. Pode estar em pixels virtuais ou físicos, dependendo da entrada 'Coordenadas são físicas'.

Cor da caneta
PenColour string

A cor do retângulo a ser desenhado (por exemplo, vermelho, verde, azul, amarelo, roxo ou laranja) ou um código hexáxe de cadeia de caracteres, por exemplo, #FF0000.

Pixels de espessura da caneta
PenThicknessPixels integer

A espessura (em pixels) da borda do retângulo de realce.

Segundos a serem exibidos
SecondsToDisplay integer

O número de segundos para exibir o retângulo.

As coordenadas são físicas
CoordinatesArePhysical boolean

Defina como true se as coordenadas fornecidas forem coordenadas de tela física. Defina como false se as coordenadas fornecidas forem virtuais. Se o dimensionamento de exibição subjacente for 100%, as coordenadas físicas e virtuais serão as mesmas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
DrawRectangleOnScreenResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Eliminar ficheiros

Exclui arquivos em uma pasta especificada que corresponde a um padrão no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Padrão
Pattern string

Um padrão a ser correspondido com arquivos a serem excluídos, por exemplo . para todos os arquivos ou *.txt para arquivos com uma extensão .txt.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de arquivos excluídos
NumberOfFilesDeleted integer

O número de arquivos que foram excluídos com êxito.

Falha ao excluir o número de arquivos
NumberOfFilesFailedToDelete integer

O número de arquivos que não puderam ser excluídos.

Encerrar IA-Connect sessão por nome

Elimina a sessão IA-Connect Director especificada se ela existir. Esta é a sessão na qual os comandos para um agente de IA-Connect são enviados. O nome será conhecido de uma ação anterior de "Anexar".

Parâmetros

Nome Chave Obrigatório Tipo Description
IA-Connect nome da sessão
IAConnectSessionName True string

O nome da sessão de IA-Connect a ser morto.

Anexar à sessão de IA-Connect camada 1 com êxito
AttachToTier1IAConnectSessionOnSuccess boolean

Deve IA-Connect se conectar novamente à sessão de IA-Connect de camada 1 (a sessão IA-Connect Director do Diretor que está recebendo as mensagens SOAP e/ou REST) se a sessão tiver sido fechada com êxito?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
IA-Connect sessão encerrada
IAConnectSessionKilled boolean

Retornará true se a sessão com o nome especificado tiver sido morta ou false, caso contrário.

Nome da sessão de IA-Connect da camada 1 anexada
AttachedTier1IAConnectSessionName string

O nome da sessão de IA-Connect camada 1 que foi conectada.

Encerrar processo

Elimina qualquer processo em execução na sessão de usuário do agente do IA-Connect que tem o nome do processo especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo
ProcessName True string

O processo a ser morto. por exemplo, bloco de notas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de processos encerrados
NumberOfProcessesKilled integer

O número de processos que foram mortos.

Encerrar um thread do Agente

Mata (termina, anula) um thread do Agent. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. O thread do Agente não é excluído (use a ação 'Excluir um thread do Agente' para excluir threads) para permitir que todos os processos ou fluxos que monitoram o thread do Agente recebam o erro 'IA-Connect Thread do Agente foi anulado'.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread Id
ThreadId True integer

Se você executou anteriormente uma ação do Agente como um thread, forneça a ID do thread para encerrar o thread (interromper permanentemente a execução do thread). Essa ID de thread terá sido fornecida como uma saída da execução anterior da ação como um thread.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
KillAgentThreadResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Enviar chaves

Envia pressionamentos de teclas globais para a sessão de usuário do agente do IA-Connect. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Texto
Text True string

A tecla pressiona para ser simulada na sessão de usuário do agente do IA-Connect. Os códigos de chave estão documentados na sintaxe "Enviar chaves" no "guia do usuário da interface do usuário". Para inserir alfanuméricos, basta fornecer o texto as-is. Exemplo para pressionar CTRL+C: ^c. Exemplo para pressionar ALT+F: %f.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada tecla.

É senha
IsPassword boolean

A entrada é um valor de senha? Nesse caso, a ação alternativa "Enviar chaves de senha" deve ser usada.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos no texto não devem ser interpretados como chaves especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar chaves de senha

Envia pressionamentos de chave globais para a sessão de usuário do agente do IA-Connect, especificamente para inserir uma senha. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Senha
Password True password

A senha a ser inserida usando pressionamentos de tecla simulados na sessão de usuário do agente do IA-Connect. Os códigos de chave estão documentados na sintaxe "Enviar chaves" no "guia do usuário da interface do usuário". Se essa for uma senha 'Armazenada', insira no formato {IAConnectPassword:StoredPasswordIdentifier} e defina a entrada 'stored password' como true. Se essa for uma credencial genérica do Orchestrator, insira o formato {OrchestratorCredential:FriendlyName} e defina a entrada "senha armazenada" como true.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada tecla.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos na senha não devem ser interpretados como chaves especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

A senha contém senha armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha for um identificador de senha armazenado IA-Connect (por exemplo: gerado pela ação 'Gerar senha') ou uma credencial genérica do Orchestrator IA-Connect (por exemplo: Se estiver usando IA-Connect com um fluxo de PA).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar eventos de chave de senha

Envia eventos de pressionamento de tecla global para a sessão de usuário do agente do IA-Connect, especificamente para inserir uma senha, usando o driver de teclado de baixo nível. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Senha
Password True password

A senha a ser inserida na sessão de usuário do agente do IA-Connect, usando o driver de teclado de nível inferior. Os códigos-chave são documentados na sintaxe "Enviar eventos de chave" no "guia do usuário da interface do usuário". Se essa for uma senha 'Armazenada', insira no formato {IAConnectPassword:StoredPasswordIdentifier} e defina a entrada 'stored password' como true. Se essa for uma credencial genérica do Orchestrator, insira o formato {OrchestratorCredential:FriendlyName} e defina a entrada "senha armazenada" como true.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada evento de pressionamento de teclas.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos na senha não devem ser interpretados como chaves especiais (por exemplo, {SHIFT} para Shift, {CTRL} para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

A senha contém senha armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha for um identificador de senha armazenado IA-Connect (por exemplo: gerado pela ação 'Gerar senha') ou uma credencial genérica do Orchestrator IA-Connect (por exemplo: Se estiver usando IA-Connect com um fluxo de PA).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar eventos principais

Envia eventos de pressionamento de tecla global para a sessão de usuário do agente do IA-Connect, usando o driver de teclado de baixo nível. Isso simula um usuário pressionando essas teclas no teclado. Verifique se o elemento janela de destino está focado ou se as teclas podem ser recebidas pelo aplicativo errado ou ignoradas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Texto
Text True string

A tecla pressiona para ser inserida na sessão de usuário do agente do IA-Connect, usando o driver de teclado de nível baixo. Os códigos-chave são documentados na sintaxe "Enviar eventos de chave" no "guia do usuário da interface do usuário". Exemplo para pressionar e liberar escape: {Escape}. Exemplo para pressionar Win+D para mostrar a área de trabalho (deprimir a tecla esquerda do Windows, pressionar e liberar d, liberar a tecla esquerda do Windows): <{LWin}d>{LWin}. Exemplo para pressionar CTRL+C (deprimir o controle esquerdo, pressionar e soltar c, liberar o controle esquerdo): <{Ctrl}c>{Ctrl}. Lembre-se de liberar chaves deprimidas ou elas permanecerão deprimidas (por exemplo, se você usar < para deprimir uma chave modificadora, use > para liberá-la).

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada evento de pressionamento de teclas.

É senha
IsPassword boolean

A entrada é um valor de senha? Nesse caso, a ação alternativa "Enviar eventos de chave de senha" deve ser usada.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos no texto não devem ser interpretados como chaves especiais (por exemplo, {SHIFT} para Shift, {CTRL} para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Enviar mensagem para a API Web

Envie uma mensagem para uma API Web e receba uma resposta. Isso pode ser usado com qualquer API Web, mas um uso comum seria uma API REST. IA-Connect dá suporte ao envio de mensagens para APIs Web de uma máquina virtual (ou seja, para acessar recursos locais) ou em sessões da Citrix ou da Área de Trabalho Remota da Microsoft (por exemplo, para acessar APIs somente com compatibilidade de ambientes isolados).

Parâmetros

Nome Chave Obrigatório Tipo Description
URL
URL string

A URL completa da API para a qual enviar uma mensagem. Por exemplo: https://myapi.remotesystem.com/path/action.

Método
Method string

O método a ser usado é o HTTP. Isso precisa corresponder ao esperado da API remota.

Tempo limite, em segundos
TimeoutInSeconds integer

O número de segundos para aguardar a resposta. Se o tempo limite for atingido antes que a resposta HTTP seja recebida, uma exceção será gerada.

Tipo de conteúdo
ContentType string

O tipo de conteúdo para os dados transmitidos no corpo da mensagem (se presente). Isso deve corresponder ao esperado da API remota. Se chamar uma API REST que espera um conteúdo JSON no corpo, o tipo de conteúdo provavelmente será application/json; charset=utf-8.

Aceitar
Accept string

Os formatos aceitáveis para os dados de resposta. Isso deve corresponder ao esperado da API remota. Se chamar uma API REST que retorna um conteúdo JSON, o valor de aceitação provavelmente será application/json. Para aceitar qualquer resposta, insira /.

Corpo da mensagem
MessageBody string

Se chamar uma API Web que espera dados no corpo da mensagem (comum com PUT, POST, PATCH), insira o conteúdo do corpo nessa entrada. Se chamar uma API REST, isso provavelmente conterá dados JSON. Se chamar uma API REST que espera dados JSON, mas nenhum dado está sendo enviado, talvez seja necessário inserir {} essa entrada. Por padrão, a codificação UTF-8 é usada, mas você pode alterá-la usando a entrada "Codificação".

Codificação de transmissão
TransmitEncoding string

A codificação do corpo da mensagem transmitida (se presente). As codificações UTF são usadas para transmitir dados Unicode. BE é grande-endiano.

Codificação de resposta
ResponseEncoding string

A codificação dos dados de resposta no corpo da resposta (se presente). É altamente provável que a codificação de resposta corresponda à codificação de transmissão. As codificações UTF são usadas para transmitir dados Unicode. BE é grande-endiano.

Tamanho do buffer
BufferSize integer

O tamanho de cada leitura individual do fluxo de saída. Altamente improvável que isso precise ser modificado. Isso não limita o tamanho da resposta; É um tamanho de bloco.

Propriedade
Property string
Value
Value string
Negociar tls 1.0
NegotiateTLS10 boolean

Defina como true se o uso da segurança HTTPS e TLS 1.0 deve ser negociado com o sistema remoto. Você pode negociar mais de um nível de segurança do TLS e o nível de negociação mais alto comum entre o cliente e o sistema remoto será usado. Aviso: o TLS 1.0 foi preterido, portanto, você não deve habilitar, a menos que o sistema remoto não dê suporte a um nível mais alto (possivelmente antigo e potencialmente não agendado), e você entenda e aceite os riscos de segurança.

Negociar tls 1.1
NegotiateTLS11 boolean

Defina como true se o uso da segurança HTTPS e TLS 1.1 deve ser negociado com o sistema remoto. Você pode negociar mais de um nível de segurança do TLS e o nível de negociação mais alto comum entre o cliente e o sistema remoto será usado. Aviso: o TLS 1.1 foi preterido, portanto, você não deve habilitar, a menos que o sistema remoto não dê suporte a um nível mais alto (possivelmente antigo e potencialmente não agendado), e você entenda e aceite os riscos de segurança.

Negociar tls 1.2
NegotiateTLS12 boolean

Defina como true se o uso da segurança HTTPS e TLS 1.2 deve ser negociado com o sistema remoto. Você pode negociar mais de um nível de segurança do TLS e o nível de negociação mais alto comum entre o cliente e o sistema remoto será usado. O TLS 1.2 é o nível de segurança mínimo recomendado.

Negociar tls 1.3
NegotiateTLS13 boolean

Defina como true se o uso da segurança HTTPS e TLS 1.3 deve ser negociado com o sistema remoto. Você pode negociar mais de um nível de segurança do TLS e o nível de negociação mais alto comum entre o cliente e o sistema remoto será usado. O TLS 1.3 só tem suporte do Windows 11 e superior e do Server 2022 e superior.

Mantenha-se vivo
KeepAlive boolean

Defina como true se keep-alive deve ser habilitado. Isso reutiliza a conexão TCP se você estiver fazendo várias solicitações de API para o mesmo ponto de extremidade em um curto período de tempo (menos de um minuto) e, portanto, melhora o desempenho. Defina como false se você pretende apenas fazer uma única chamada à API ou se o tempo entre as chamadas à API for maior que um minuto. Haverá danos mínimos ao configurar isso incorretamente, pois isso afeta apenas o desempenho.

Espere que 100 continuem
Expect100Continue boolean

Defina como true se você estiver usando uma solicitação POST, enviando uma grande quantidade de dados e quiser determinar se o servidor aceitará a solicitação, antes de enviar os dados. False funciona melhor na maioria dos cenários, pois reduz o número de pacotes enviados ao servidor, melhorando o tempo de resposta.

Retornar cabeçalhos de resposta
ReturnResponseHeaders boolean

Defina como true se você quiser que o agente de IA-Connect retorne cabeçalhos HTTP recebidos do sistema remoto, na resposta. A resposta estará no formato JSON. Use esse recurso somente se você pretende processar os cabeçalhos de resposta para obter informações (por exemplo, um cookie retornado), pois ele aumenta o tamanho da resposta.

Executar como thread
RunAsThread boolean

Se definido como false, o agente de IA-Connect executará a ação imediatamente e retornará os resultados quando a ação for concluída, mas falhará se levar mais tempo do que o tempo limite de comando de trabalho/RPA. Se definido como true, o agente IA-Connect executará essa ação como um thread do Agente e a monitorará até que ela seja concluída. Isso permite que a ação seja executada por mais tempo do que o tempo limite do comando worker/RPA.

Aguardar thread
WaitForThread boolean

Usado somente se 'Executar como thread' for definido como true. Defina essa entrada como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado por "Tempo limite em segundos". Defina como false para ignorar a espera; O Agente continuará executando a ação em segundo plano, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados em um momento posterior usando a ação "Aguardar que o thread do Agente seja concluído com êxito" para aguardar a conclusão do thread do Agente e, em seguida, executar novamente essa ação com a entrada 'Recuperar dados de saída para id de thread' definida para a ID de thread do Agente.

Recuperar dados de saída para a ID do thread
RetrieveOutputDataFromThreadId integer

Se você definiu anteriormente 'Aguardar thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), forneça a ID de thread do Agente para recuperar os resultados. Essa ID de thread do Agente terá sido fornecida pela chamada anterior para essa ação. Caso contrário, defina como 0 (o padrão).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Código de status de resposta
ResponseStatusCode integer

O código de resposta HTTP. As respostas bem-sucedidas comuns são 200 (OK), 201 (Criado), 202 (Aceito). Códigos de resposta 3xx são mensagens de redirecionamento. Códigos de resposta 4xx são mensagens de erro do cliente (por exemplo, se houver algo errado com a solicitação). Códigos de resposta 5xx são mensagens de erro do servidor. Os códigos de resposta 4xx e 5xx geralmente não aparecerão nessa saída, pois uma exceção será gerada.

Mensagem de resposta
ResponseMessage string

O conteúdo da mensagem de resposta do corpo da resposta HTTP.

Tipo de conteúdo de resposta
ResponseContentType string

O tipo de conteúdo do corpo da resposta, se houver um corpo de resposta e se o tipo tiver sido fornecido.

JSON de cabeçalhos de resposta
ResponseHeadersJSON string

Se a entrada 'Retornar cabeçalhos de resposta' tiver sido definida como true, essa saída conterá os cabeçalhos de resposta HTTP, no formato JSON. Use esse recurso somente se você pretende processar os cabeçalhos de resposta para obter informações (por exemplo, um cookie retornado), pois ele aumenta o tamanho da resposta.

Thread Id
ThreadId integer

Se você tiver definido 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), essa saída conterá a ID de thread do Agente que pode ser usada para monitorar o processo da ação e recuperar os resultados posteriormente, quando o thread for concluído.

Exclui uma credencial de usuário

Exclui uma credencial no perfil do usuário na sessão do agente IA-Connect. As credenciais podem ser exibidas no Painel de Controle do Windows.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço de credencial
CredentialAddress True string

O nome/endereço da credencial.

Tipo de credencial
CredentialType True string

O tipo de credencial: Windows ou Generic.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
CredentialDeleteResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Excluir arquivo

Exclui um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
Filename True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Excluir diretório

Exclui um diretório (pasta) no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Recursivo
Recursive boolean

Os subdiretórios (subpastas) e os arquivos no diretório também devem ser excluídos?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Excluir operação de tarefa de automação do Orchestrator

Exclua uma tarefa específica de automação do Orchestrator, fornecendo a ID de operação de tarefa exclusiva.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da operação
OperationId True string

A ID da Operação da tarefa Orchestrator a ser excluída.

Atualizar o sistema de origem
UpdateSourceSystem boolean

Se definido como true (o padrão) e a tarefa Orchestrator estiver vinculada a um sistema de origem (por exemplo, ServiceNow), o Orchestrator executará todas as ações especificadas na configuração do sistema de origem no Orchestrator (por exemplo, feche o tíquete). Se definido como false ou a tarefa não estiver vinculada a um sistema de origem, a tarefa será excluída apenas do Orchestrator.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksDeleteTaskOperationResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Excluir senha na memória do Agente

Exclua uma senha armazenada na memória do Agente ou exclua todas as senhas armazenadas do Agente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Excluir todas as senhas
DeleteAllPasswords boolean

Defina como true para excluir todas as senhas armazenadas na memória do Agente. Defina como false (o padrão) para excluir uma única senha correspondente ao identificador fornecido.

Identificador
Identifier string

Um identificador exclusivo para a senha a ser excluída. Por exemplo: SAPGUILogon.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
DeletePasswordInAgentMemoryResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Excluir tarefa de automação do Orchestrator

Exclua uma tarefa de automação do Orchestrator que foi adiada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa de automação orchestrator a ser excluída.

Atualizar o sistema de origem
UpdateSourceSystem boolean

Se definido como true (o padrão) e a tarefa Orchestrator estiver vinculada a um sistema de origem (por exemplo, ServiceNow), o Orchestrator executará todas as ações especificadas na configuração do sistema de origem no Orchestrator (por exemplo, feche o tíquete). Se definido como false ou a tarefa não estiver vinculada a um sistema de origem, a tarefa será excluída apenas do Orchestrator.

Retornos

Nome Caminho Tipo Description
Resultado do comando
TasksDeleteTaskResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Excluir um thread do Agente

Exclui um thread do Agent ou todos os threads do Agent, matando (encerrando, anulando) o thread primeiro, se ele ainda estiver em execução. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Os processos ou fluxos que monitoram o thread do Agente receberão um erro "A ID do thread do agente não existe".

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread Id
ThreadId integer

Se você executou anteriormente uma ação do Agente como um thread, forneça a ID do thread para encerrar e excluir o thread. Essa ID de thread terá sido fornecida como uma saída da execução anterior da ação como um thread. Se a ID de thread do Agente especificada não existir, uma exceção será gerada.

Excluir todos os threads do Agente
DeleteAllAgentThreads boolean

Defina como true para excluir todos os threads do Agente. Defina como false (o padrão) para excluir um único thread do Agente especificado pela entrada 'ID do Thread'.

Gerar exceção se o thread do Agente não for excluído
RaiseExceptionIfAgentThreadFailsToDelete boolean

Defina como true para gerar uma exceção se um thread do Agente não for excluído. Observe que isso pode fazer com que uma exceção seja gerada se um thread do Agent for concluído durante a emissão dessa ação (já que ela não existirá mais no ponto de exclusão). Defina como false (o padrão) para ignorar erros ao excluir threads do Agente. A saída "Número de threads do Agente excluídos" relatará quantos threads do Agent foram excluídos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de threads do Agente excluídos
NumberOfAgentThreadsDeleted integer

Se 'Excluir todos os threads do Agente' for true, essa saída conterá o número de threads do Agente excluídos (0 ou superior). Se 'Excluir todos os threads do Agente' for falso e uma ID de thread do Agente tiver sido fornecida, essa saída será definida como 0 ou 1.

Executar agente de IA-Connect alternativo

Executa um agente de IA-Connect alternativo (por exemplo, uma versão posterior) carregando o executável do Agente de um local de arquivo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do Arquivo
Filename True string

O caminho completo para o IA-Connect Agent.exe alternativo a ser executado. Esse caminho deve estar acessível na sessão em que o agente de IA-Connect está em execução no momento.

Arguments
Arguments string

Todos os argumentos opcionais a serem passados para o IA-Connect Agent.exe quando ele for executado.

Carregar na memória
LoadIntoMemory boolean

A alternativa IA-Connect Agent deve ser executada na memória? Se definido como true, o novo Agente será carregado na memória e executado em um assembly do Agente existente. Se definido como false, o novo Agente será executado como um processo normal e o EXE do agente existente será encerrado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Executar agente de IA-Connect alternativo enviado do diretor

Executa um agente de IA-Connect alternativo (por exemplo, uma versão posterior) carregando o agente alternativo do IA-Connect Director e carregando o executável do Agente alternativo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do arquivo local
LocalFilename True string

O caminho completo para o IA-Connect Agent.exe alternativo acessível do diretor do IA-Connect.

Nome de arquivo remoto
RemoteFilename string

O caminho completo para o local para copiar o IA-Connect Agent.exe alternativo (no sistema remoto). Se não for especificado, um nome de arquivo temporário será escolhido. Se a alternativa IA-Connect Agent estiver sendo carregada na memória, esse arquivo não será criado (já que não é necessário), a menos que você defina "Salvar em disco mesmo se estiver executando da memória" como true. Você só definiria isso como true se quisesse usar as ações de Código Dinâmico do IA-Connect que exigiam 'Assembly de execução de referência' (por exemplo, para acessar IA-Connect métodos internos).

Comprimir
Compress boolean

A alternativa IA-Connect executável do Agente deve ser compactada durante o upload?

Arguments
Arguments string

Todos os argumentos opcionais a serem passados para o IA-Connect Agent.exe quando ele for executado.

Permitir downgrade
PermitDowngrade boolean

As versões anteriores do IA-Connect Agent devem ser permitidas?

Ignorar verificação de versão
SkipVersionCheck boolean

A versão do IA-Connect Agents (existente e nova) não deve ser verificada, resultando na nova versão sendo usada em todos os cenários (mesmo na mesma versão)?

Carregar na memória
LoadIntoMemory boolean

A alternativa IA-Connect Agent deve ser executada na memória? Se definido como true, o novo Agente será carregado na memória e executado em um assembly do Agente existente. Se definido como false, o novo Agente será executado como um processo normal e o EXE do agente existente será encerrado.

Salvar em disco mesmo se estiver em execução na memória
SaveToDiskEvenIfRunningFromMemory boolean

O agente de IA-Connect alternativo deve ser salvo no disco mesmo que esteja sendo executado na memória? Você só definiria isso como true se quisesse usar as ações de Código Dinâmico do IA-Connect que exigiam 'Assembly de execução de referência' (por exemplo, para acessar IA-Connect métodos internos).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Arquivo alternativo copiado
AlternativeFileCopied boolean

Relata se o agente de IA-Connect alternativo foi usado.

Executar o comando generic IA-Connect Agent

Executa um comando genérico IA-Connect Agent passando argumentos como JSON e retornando dados de saída como JSON. Usado para executar comandos do Agente quando o Diretor e o Inspetor são versões mais antigas do que o Agente e, portanto, não entendem o comando.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do comando do agente do IA-Connect
CommandName True string

O nome interno do comando IA-Connect Agent. Uma lista de nomes de comando pode ser fornecida pela ação 'GetAgentActionsInClass'.

JSON de entrada
InputJSON string

A entrada para o comando IA-Connect Agent, no formato JSON.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
JSON de saída
OutputJSON string

A saída do comando IA-Connect Agent, no formato JSON.

Executar o processo do PowerShell

Inicie um processo do PowerShell, executando um script existente no disco ou fornecendo o conteúdo do script a ser executado. Em vez disso, considere usar a ação "Executar script do PowerShell", que é muito mais poderosa e fornece uma tabela de dados da saída do script do PowerShell. Use essa ação se o script do PowerShell for gerado para saída padrão ou erro padrão (por exemplo, usa Write-Host em vez de retornar uma tabela), exigir o PowerShell 7 ou estiver executando ações do Active Directory como um usuário alternativo e o CredSSP via WinRM não estiver disponível.

Parâmetros

Nome Chave Obrigatório Tipo Description
Executável do PowerShell
PowerShellExecutable string

O caminho para o executável do PowerShell. Deixe como padrão 'PowerShell.exe' para executar o executável padrão do PowerShell, conforme definido no caminho do Windows. Use '%SYSTEMROOT%\system32\WindowsPowerShell\v1.0\PowerShell.exe' para o PowerShell 5.x. Use 'C:\Program Files\PowerShell\7\pwsh.exe' para o PowerShell 7. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Caminho do arquivo de script do PowerShell
PowerShellScriptFilePath string

O caminho para um script existente do PowerShell a ser executado. O script do PowerShell deve ser acessível pelo agente do IA-Connect (ou seja, se o Agente estiver em execução em uma sessão remota, o script deverá estar no sistema remoto ou acessível a partir do sistema remoto). Como alternativa, deixe essa entrada em branco e forneça o conteúdo do script do PowerShell na entrada 'Conteúdo do script do PowerShell'. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Conteúdo de script do PowerShell
PowerShellScriptContents string

O conteúdo do script do PowerShell a ser executado, em vez de fornecer o caminho para um script existente do PowerShell.

Pasta de Trabalho
WorkingDirectory string

A pasta/diretório de trabalho para o script do PowerShell. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Não criar nenhuma janela
CreateNoWindow boolean

Se definido como true (o padrão), o script do PowerShell será executado de forma invisivelmente. Se definido como false, a janela de script do PowerShell será exibida. Isso pode ser útil se o script do PowerShell solicitar entrada e você planeja usar o UIA e ações globais de mouse e teclado para interagir com ele.

Estilo de janela
WindowStyle string

Forneça o estilo da janela (normal, maximizado, minimizado ou oculto), se o script do PowerShell estiver configurado para ser executado visivelmente.

Aguardar o processo
WaitForProcess boolean

O agente de IA-Connect deve aguardar a conclusão do script do PowerShell? Isso é definido como true, por padrão, para permitir que o agente IA-Connect obtenha a saída do script. Definido como false para fogo-e-esquecer.

Redirecionar saída padrão
RedirectStandardOutput boolean

Se definido como true (o padrão), a saída padrão do script será redirecionada, permitindo que o Agente o retorne na variável StandardOutput. Isso é útil se você quiser retornar a saída do script para o Agente (por exemplo, saída de Write-Host).

Erro padrão de redirecionamento
RedirectStandardError boolean

Se definido como true, o erro padrão do script será redirecionado, permitindo que o Agente o retorne na variável StandardError.

Redirecionar o erro padrão para a saída
RedirectStandardErrorToOutput boolean

Se definido como true, o erro padrão do script será redirecionado para a saída padrão, mesclando-os em uma única saída.

Codificação de saída padrão
StandardOutputEncoding string

Forneça a codificação de saída padrão (UTF8, UTF7, UTF16, ASCII ou UTF16BE).

Codificação de erro padrão
StandardErrorEncoding string

Forneça a codificação de erro padrão (UTF8, UTF7, UTF16, ASCII ou UTF16BE).

Nome de domínio RunAs
RunAsDomain string

O domínio da execução como usuário. Se o domínio não for especificado, o nome de usuário deverá estar no formato username@domainFQDN.

Nome de usuário RunAs
RunAsUsername string

O nome de usuário da execução como usuário.

Senha RunAs
RunAsPassword password

A senha da execução como usuário.

Executar como carregar o perfil do usuário
RunAsLoadUserProfile boolean

O perfil de usuário do Windows da execução como usuário deve ser carregado?

RunAs elevate
RunAsElevate boolean

O script do PowerShell deve ser executado com privilégios elevados? Você pode ter extrema dificuldade em aceitar a solicitação de privilégios elevados.

Tempo limite, em segundos
TimeoutInSeconds integer

O número máximo de segundos para aguardar a conclusão do script do PowerShell.

Pasta temporária de script do PowerShell
PowerShellScriptTempFolder string

Por padrão, se você fornecer um script do PowerShell na entrada 'Conteúdo do script do PowerShell', o agente de IA-Connect salvará o script no arquivo '%TEMP%\IA-Connect\TempPowerShell-{Date}-{Time}.ps1', passes it to PowerShell.exe por meio da entrada -File e excluirá o arquivo quando o script for concluído. Esse caminho padrão poderá não ser aceitável se você estiver usando um nome de usuário RunAs, já que o usuário RunAs pode não conseguir acessar o perfil da conta que executa o agente de IA-Connect. Use essa entrada para fornecer uma pasta alternativa. Por exemplo: '%SYSTEMDRIVE% emp'. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Processo iniciado
ProcessStarted boolean

Retornará true se o processo de script do PowerShell (PowerShell.exe) tiver sido iniciado.

Código de saída
ExitCode integer

Retorna o código de saída do processo de script do PowerShell (PowerShell.exe).

Tempo limite do processo
ProcessTimedOut boolean

Retornará true se o processo de script do PowerShell (PowerShell.exe) tiver esgotado.

ID do processo
ProcessId integer

A ID do processo de script do PowerShell (PowerShell.exe) que foi iniciado.

Saída padrão
StandardOutput string

O conteúdo de saída padrão.

Erro padrão
StandardError string

O conteúdo de erro padrão.

Executar processo

Inicie um processo, um comando ou um aplicativo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo
ProcessName True string

O processo a ser executado. por exemplo, notepad.exe ou C:\windows\system32\notepad.exe. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Arguments
Arguments string

Todos os argumentos de linha de comando a serem usados ao iniciar o aplicativo.

Pasta de Trabalho
WorkingDirectory string

A pasta/diretório de trabalho para o processo. O agente de IA-Connect expandirá todas as variáveis de ambiente no caminho.

Usar a execução do Shell
UseShellExecute boolean

O processo deve ser iniciado usando o shell do sistema operacional?

Não criar nenhuma janela
CreateNoWindow boolean

O processo deve ser iniciado sem janela?

Estilo de janela
WindowStyle string

Forneça o estilo da janela (normal, maximizado, minimizado ou oculto).

Aguardar o processo
WaitForProcess boolean

Devemos aguardar a conclusão do processo? Isso provavelmente só seria usado ao executar um programa ou script que precisasse ser concluído antes de continuarmos.

Redirecionar saída padrão
RedirectStandardOutput boolean

A saída padrão deve ser redirecionada?

Erro padrão de redirecionamento
RedirectStandardError boolean

O erro padrão deve ser redirecionado?

Redirecionar o erro padrão para a saída
RedirectStandardErrorToOutput boolean

O erro padrão deve ser redirecionado para a saída?

Codificação de saída padrão
StandardOutputEncoding string

Forneça a codificação de saída padrão (UTF8, UTF7, UTF16, ASCII ou UTF16BE).

Codificação de erro padrão
StandardErrorEncoding string

Forneça a codificação de erro padrão (UTF8, UTF7, UTF16, ASCII ou UTF16BE).

Nome de domínio RunAs
RunAsDomain string

O domínio da execução como usuário. Se o domínio não for especificado, o nome de usuário deverá estar no formato username@domainFQDN.

Nome de usuário RunAs
RunAsUsername string

O nome de usuário da execução como usuário.

Senha RunAs
RunAsPassword password

A senha da execução como usuário.

Executar como carregar o perfil do usuário
RunAsLoadUserProfile boolean

O perfil de usuário do Windows da execução como usuário deve ser carregado?

RunAs elevate
RunAsElevate boolean

O processo deve ser executado com privilégios elevados?

Tempo limite, em segundos
TimeoutInSeconds integer

O número máximo de segundos para aguardar a conclusão do processo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Processo iniciado
ProcessStarted boolean

Retorna true se o processo foi iniciado.

Código de saída
ExitCode integer

Retorna o código de saída do processo.

Tempo limite do processo
ProcessTimedOut boolean

Retorna true se o processo atingiu o tempo limite.

ID do processo
ProcessId integer

A ID do processo que foi iniciado.

Saída padrão
StandardOutput string

O conteúdo de saída padrão.

Erro padrão
StandardError string

O conteúdo de erro padrão.

Expandir cadeia de caracteres de senha

Aceita uma cadeia de caracteres de entrada que contém referências a IA-Connect senhas armazenadas e retorna essa cadeia de caracteres com as referências substituídas pelas senhas armazenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Cadeia de caracteres de entrada
InputString string

A cadeia de caracteres de entrada que contém IA-Connect identificadores de senha armazenados. Por exemplo: 'Bem-vindo novo iniciador, sua nova senha de conta é {IAConnectPassword:GeneratedPassword}' em que 'GeneratedPassword' é o nome de uma senha de IA-Connect armazenada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Cadeia de caracteres de saída
OutputString string

A cadeia de caracteres de saída que contém a cadeia de caracteres de entrada com identificadores de senha substituídos pelas senhas reais. Por exemplo: 'Bem-vindo novo iniciador, sua nova senha de conta é Fantastic12Monkeys!'.

Expandir variável de ambiente

Expande uma cadeia de caracteres que contém variáveis de ambiente (por exemplo, %USERPROFILE% ou %TEMP%) na sessão de usuário do agente IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Cadeia de caracteres de entrada
InputString True string

A cadeia de caracteres de entrada que contém variáveis de ambiente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Cadeia de caracteres de saída
OutputString string

A cadeia de caracteres com todas as variáveis de ambiente expandidas.

Fechar agente de IA-Connect

Fecha o agente de IA-Connect. Isso não afeta a sessão do usuário em que o agente do IA-Connect estava em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para esperar
SecondsToWait integer

O tempo de espera antes de emitir o comando close para que o agente de IA-Connect possa relatar a conclusão do comando.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Gerar exceção

Crie uma exceção com a mensagem especificada se a exceção de entrada não estiver em branco. Isso é útil para disparar uma mensagem de exceção em seu fluxo (HTTP 400), que será capturada por um estágio de tratamento de erros, se uma ação anterior tiver um erro. Essa exceção não é registrada nas estatísticas de execução de fluxo do IA-Connect Orchestrator.

Parâmetros

Nome Chave Obrigatório Tipo Description
Exceção de entrada
InputException string

Se essa exceção de entrada não for uma cadeia de caracteres vazia, uma exceção será gerada com a "mensagem de exceção" fornecida. Se essa exceção de entrada estiver em branco, essa ação não fará nada.

Mensagem de exceção
ExceptionMessage string

A mensagem de exceção a ser gerada.

Retornos

Nome Caminho Tipo Description
Resultado do comando
RaiseExceptionResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Gerar senha

Gera uma senha que contém palavras de dicionário, números, símbolos, caracteres, conforme definido em um formato de modelo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Formato de senha
PasswordFormat True string

O formato da senha gerada descrita usando símbolos. O símbolo 'w' representa uma palavra de dicionário, 'u' representa uma palavra de dicionário em maiúsculas, 'n' representa um número, 's' representa um símbolo, 'l' representa uma letra minúscula, 'L' representa uma letra maiúscula, 'z' não representa nada (útil em combinações). Por exemplo, wnnwsl pode gerar Pluto35Marmite!b. Um número seguido por dois ou mais símbolos entre colchetes criará uma combinação aleatória desse número de símbolos. Por exemplo, 8(Lln) pode produzir 6hP2AxP0 e 4(Lsz) pode produzir S!-A (símbolos LssL) ou pode produzir J$ (símbolos Lszz). Caracteres dentro de aspas simples são usados as-is. Por exemplo, w'--'w'_'nn pode produzir Jersey-- Mountain_64.

Comprimento mínimo
MinimumLength integer

O comprimento mínimo da senha gerada. Se a senha gerada for muito curta, palavras de dicionário adicionais serão adicionadas até que o comprimento seja atingido. Defina como 0 se não houver nenhum requisito de comprimento mínimo.

Retornar como texto sem formatação
ReturnAsPlainText boolean

Defina como true para retornar a senha como texto sem formatação.

Armazenar senha como identificador
StorePasswordAsIdentifier string

Se um identificador for fornecido, essa senha será armazenada criptografada dentro do Orchestrator ou Agent (consulte 'Gerar em') para recuperação/uso posterior por quaisquer comandos que possam usar as credenciais armazenadas. Se geradas pelo Agente, essas senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado. Por exemplo, MyExchangePassword será recuperável usando {IAConnectPassword:MyExchangePassword}.

Símbolos com suporte
SupportedSymbols string

Permite que você forneça uma lista de símbolos a serem usados aleatoriamente quando o símbolo 's' é usado no formato de uma senha gerada. Se não for especificado, uma lista interna será usada. Por exemplo: !$()*.

Tentar senhas exclusivas
AttemptUniquePasswords boolean

Defina como true (o padrão) para o Orchestrator ou Agent (consulte 'Gerar em') para evitar a duplicação de sequências de números aleatórios e, portanto, verifique se as senhas geradas são exclusivas sempre que possível em uma sessão específica. Se gerado pelo Agente, isso não garante senhas exclusivas entre agentes separados ou se o Agente está fechado ou reiniciado, portanto, você sempre deve garantir que suas senhas sejam altamente aleatórias usando senhas complexas (por exemplo: wnnws é mais aleatório do que wnw).

Gerar em
GenerateAt string

Especifique qual componente IA-Connect gerará a senha.

Minúscula mínima
MinimumLowercase integer

O número mínimo de caracteres minúsculos que devem estar presentes na senha. Se isso não for possível (por exemplo, se o formato de senha não tiver símbolos l, w ou u suficientes), uma exceção será gerada. Definido como 0 para nenhum mínimo.

Maiúsculas mínimas
MinimumUppercase integer

O número mínimo de caracteres maiúsculos que devem estar presentes na senha. Se isso não for possível (por exemplo, se o formato de senha não tiver símbolos L, w ou u suficientes), uma exceção será gerada. Definido como 0 para nenhum mínimo.

Números mínimos
MinimumNumbers integer

O número mínimo de números que devem estar presentes na senha. Se isso não for possível (por exemplo, se o formato de senha não tiver n símbolos suficientes), uma exceção será gerada. Definido como 0 para nenhum mínimo.

Símbolos mínimos
MinimumSymbols integer

O número mínimo de símbolos que devem estar presentes na senha. Se isso não for possível (por exemplo, se o formato de senha não tiver símbolos suficientes), uma exceção será gerada. Definido como 0 para nenhum mínimo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Senha de texto sem formatação
PlainTextPassword string

A senha em texto sem formatação, se solicitado. A senha pode ser solicitada em texto sem formatação porque a senha é uma senha única destinada a ser transmitida por SMS ou email (por exemplo) e, portanto, precisa ser vista as-is.

Girar roda do mouse

Transforma a roda do mouse (entalhes positivos ou negativos) na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Roda gira
WheelTurns True integer

O número de voltas de roda a serem executadas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Gravar arquivo de texto

Cria um arquivo de texto no computador em que o agente IA-Connect está em execução e grava texto no arquivo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
Filename True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Texto a ser gravado
TextToWrite string

O conteúdo do texto a ser gravado no arquivo.

Acrescentar arquivo existente
AppendExistingFile boolean

Se o arquivo já existir, o novo texto a ser gravado deverá ser acrescentado ao final do arquivo existente?

Codificação
Encoding string

Forneça a codificação de arquivo (Unicode, UTF8, UTF7 ou ASCII) ou deixe em branco para o padrão (UTF8).

Criar pasta, se necessário
CreateFolderIfRequired boolean

Se a pasta para armazenar o arquivo no que foi fornecido no parâmetro 'Caminho do arquivo' não existir, essa pasta deverá ser criada?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Gravar em uma credencial de usuário

Grava um nome de usuário e senha em uma credencial no perfil do usuário na sessão IA-Connect Agent, criando essa credencial se ela não existir. As credenciais podem ser exibidas no Painel de Controle do Windows.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço de credencial
CredentialAddress True string

O nome/endereço da credencial.

Nome de usuário
UserName True string

O nome de usuário da credencial.

Senha
Password True string

A senha da credencial.

Tipo de credencial
CredentialType True string

O tipo de credencial: Windows ou Generic.

Persistência de credencial
CredentialPersistence string

A persistência de credencial: Sessão (dura apenas para esta sessão de logon), LocalMachine (persiste para esse usuário em sessões e reinicializações somente neste computador) ou Enterprise (pode vagar para isso entre computadores).

Chave de criptografia simétrica
SymmetricKey string

Uma chave de criptografia simétrica opcional usada para criptografar a credencial. Você só poderá recuperar essa credencial se souber a chave. Somente utilizável com credenciais genéricas.

Armazenar senha como identificador
StorePasswordAsIdentifier string

Se um identificador for fornecido, essa senha também será armazenada criptografada dentro do Agente para recuperação/uso posterior por quaisquer comandos que possam usar as credenciais armazenadas. Essas senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado. Por exemplo: MyExchangePassword.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
CredentialWriteResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Gravar no arquivo CSV

Cria um arquivo CSV no computador em que o agente de IA-Connect está em execução. O arquivo CSV é criado a partir de uma coleção (tabela) ou de uma tabela no formato JSON.

Parâmetros

Nome Chave Obrigatório Tipo Description
Propriedades
Properties object
JSON da tabela de entrada
InputTableJSON string

Uma tabela de dados a ser gravada no arquivo CSV, no formato JSON.

Caminho do arquivo CSV de saída
CSVFilePath True string

O caminho completo para o arquivo CSV. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Codificação de saída
OutputEncoding string

O formato de codificação de texto a ser usado ao gravar no arquivo CSV. As codificações com suporte são UTF8, UTF7, Unicode e ASCII.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
WriteCollectionToCSVFileResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Habilitar herança de segurança de pasta

Habilita a herança de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Habilitar IA-Connect próximo salto

Habilita o próximo salto que encaminhará todos os comandos futuros recebidos no agente IA-Connect em execução na próxima sessão de salto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço do diretor do próximo salto
NextHopDirectorAddress string

O endereço opcional do Próximo salto IA-Connect Director para encaminhar comandos para se nenhum dos parâmetros 'Próximo salto Diretor é localhost', 'Endereço do diretor do próximo salto é nome do host', 'Endereço do diretor do próximo salto é FQDN' ou 'Endereço do diretor do próximo salto é pipe nomeado' são definidos como true.

Porta TCP do diretor do próximo salto
NextHopDirectorTCPPort integer

A porta TCP na qual o diretor do próximo salto está escutando (o Diretor no computador em que o Agente está sendo executado).

O Diretor do próximo salto usa HTTPS
NextHopDirectorUsesHTTPS boolean

Defina como True se o diretor do próximo salto estiver usando HTTPS ou false, caso contrário.

O endereço do diretor do próximo salto é localhost
NextHopDirectorAddressIsLocalhostname boolean

O endereço do diretor do próximo salto (em relação ao Agente) é 'localhost'.

O endereço do diretor do próximo salto é nome do host
NextHopDirectorAddressIsHostname boolean

O endereço do diretor do próximo salto é o nome do host do computador que executa o Agente (ou seja, aquele que executa o Agente e o Diretor).

O endereço do diretor do próximo salto é FQDN
NextHopDirectorAddressIsFQDN boolean

O endereço do diretor do próximo salto é o FQDN (nome de domínio totalmente qualificado) do computador que executa o Agente (ou seja, aquele que executa o Agente e o Diretor).

Incrementar a porta TCP do diretor do próximo salto pela ID da sessão
IncrementNextHopDirectorTCPPortBySessionId boolean

Para garantir que a porta TCP do diretor do próximo salto seja exclusiva (se houver várias sessões paralelas usando o próximo salto do mesmo host), a ID da Sessão poderá ser adicionada à porta TCP do Diretor do Próximo salto.

Desabilitar antes de habilitar
DisableBeforeEnable boolean

O salto duplo deve ser desabilitado (se estiver ativo no momento) antes de habilitar novamente? Se definido como true (o padrão), qualquer nova instrução de habilitação de salto duplo substituirá as anteriores. Se definido como false, isso habilitará o salto triplo, pois as instruções serão recebidas pelo agente de IA-Connect de salto duplo.

Verifique se o diretor do próximo salto está em execução
CheckNextHopDirectorIsRunning boolean

O próximo salto requer um IA-Connect Director em execução no mesmo computador que o Agente. Se essa configuração for verdadeira, o Agente verificará se o Diretor do próximo salto está em execução conforme descrito e não habilitará o próximo salto se o diretor do próximo salto não estiver em execução. Se essa configuração for falsa, o Agente não executará nenhuma verificação e simplesmente habilitará o próximo salto.

Verificar se o agente do próximo salto está em execução
CheckNextHopAgentIsRunning boolean

O próximo salto requer um IA-Connect Director em execução no mesmo computador que o Agente E um agente de IA-Connect em execução na sessão de próximo salto. Se essa configuração for verdadeira, o Agente verificará se o Agente do próximo salto está em execução conforme descrito e não habilitará o próximo salto se o agente do próximo salto não estiver em execução. Se essa configuração for falsa, o Agente não executará nenhuma verificação e simplesmente habilitará o próximo salto.

O endereço do diretor do próximo salto é chamado pipe
NextHopDirectorAddressIsNamedPipe boolean

O endereço do diretor do próximo salto (em relação ao Agente) está usando um pipe nomeado em vez de um serviço Web TCP/IP. Esse é o padrão para evitar o uso de portas TCP/IP no primeiro salto.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Endereço do Diretor do próximo salto ativo
ActiveNextHopDirectorAddress string

O endereço do diretor de próximo salto ativo, se um estiver sendo usado.

Porta TCP do Active Next Hop Director
ActiveNextHopDirectorTCPPort integer

A porta TCP do diretor de próximo salto ativo, se um estiver sendo usado.

O Active Next Hop Director usa HTTPS
ActiveNextHopDirectorUsesHTTPS boolean

Retorna true se o diretor de próximo salto ativo estiver usando HTTPS.

Active next hop Director URL
ActiveNextHopDirectorURL string

A URL do diretor de próximo salto ativo.

ID do processo de encerramento

Elimina um processo em execução na sessão de usuário do agente do IA-Connect que tem a ID do processo especificada. As IDs do processo são exclusivas para que apenas um processo possa corresponder à ID. As IDs do processo são dinâmicas e são diferentes para cada inicialização de um aplicativo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Processo
ProcessID True integer

A ID do processo a ser morto.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de processos encerrados
NumberOfProcessesKilled integer

O número de processos que foram mortos.

Iniciar a Sessão de Área de Trabalho Remota (RDS)

Inicie uma RDS (Sessão de Área de Trabalho Remota) usando um arquivo de inicialização RDP.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo RDP
RDPFilePath True string

O caminho completo para um arquivo RDP (que pode existir previamente ou ser criado usando a ação: 'Criar arquivo de inicialização de RDS (Sessão de Área de Trabalho Remota)').

Confiar no computador remoto
TrustRemoteComputer boolean

Defina como true para marcar o endereço remoto (definido no arquivo RDP) como confiável (no registro do Windows), principalmente para fins de redirecionamento de dispositivo, eliminando um pop-up que você pode receber ao iniciar o arquivo RDP.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
LaunchRemoteDesktopSessionResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Interromper herança de segurança de pasta

Interrompe a herança de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Converter herdado em explícito
ConvertInheritedToExplicit boolean

Alguma permissão herdada no momento deve ser convertida em permissões explícitas?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Leitura de uma credencial de usuário

Lê um nome de usuário e senha de uma credencial no perfil do usuário na sessão do agente IA-Connect. As credenciais podem ser exibidas no Painel de Controle do Windows. O nome de usuário e a senha podem ser recuperados de uma credencial genérica, enquanto apenas o nome de usuário pode ser recuperado de uma credencial do Windows.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço de credencial
CredentialAddress True string

O nome/endereço da credencial.

Tipo de credencial
CredentialType True string

O tipo de credencial: Windows ou Generic.

Chave de criptografia simétrica
SymmetricKey string

Uma chave de criptografia simétrica opcional usada para descriptografar a senha de credencial (use se a credencial foi criptografada com uma chave). Somente utilizável com credenciais genéricas, pois a senha de uma credencial do Windows não pode ser recuperada.

Armazenar senha como identificador
StorePasswordAsIdentifier string

Se um identificador for fornecido, a senha de credencial recuperada será armazenada criptografada dentro do Agente para recuperação/uso posterior por quaisquer comandos que possam usar as credenciais armazenadas. Essas senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado. Somente utilizável com credenciais genéricas, pois a senha de uma credencial do Windows não pode ser recuperada. Por exemplo: MyExchangePassword.

Senha de retorno do dont
DontReturnPassword boolean

Se definido como true, a senha de credencial não será retornada. Isso é útil se você estiver armazenando a senha dentro do Agente para uso por comandos adicionais (ou seja, 'Armazenar senha como identificador' é verdadeiro), mas você não precisa realmente saber a senha dentro do fluxo de trabalho.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome de usuário
UserName string

O nome de usuário da credencial.

Senha
Password string

A senha da credencial.

Ler todo o texto do arquivo

Lê o conteúdo de texto de um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
Filename True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Conteúdo do texto do arquivo
FileTextContents string

O conteúdo do texto do arquivo.

Limpar diretório

Limpa um diretório (pasta) no computador em que o agente IA-Connect está em execução, removendo todos os arquivos armazenados no diretório.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Recursivo
Recursive boolean

Todas as subpastas também devem ser limpas?

Excluir nível superior
DeleteTopLevel boolean

A pasta de nível superior também deve ser excluída?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Limpar área de transferência

Limpa o conteúdo da área de transferência na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Manter a sessão ativa

Mantém a sessão de usuário do IA-Connect Agent ativa, movendo o mouse no intervalo especificado para impedir que a sessão fique ociosa.

Parâmetros

Nome Chave Obrigatório Tipo Description
Movimento X
XWiggle integer

O número de pixels para mover o mouse horizontalmente.

Y wiggle
YWiggle integer

O número de pixels para mover o mouse verticalmente.

Atraso de movimento em segundos
WiggleDelayInSeconds double

O número de segundos entre os movimentos do mouse ao se mexer.

Limite ocioso em segundos
IdleThresholdInSeconds integer

O número de segundos que devem ter decorrido desde a última entrada antes de mover o mouse.

Período de verificação ocioso em segundos
IdleCheckPeriodInSeconds integer

O número de segundos entre a verificação do último tempo de entrada (para verificar se o limite ocioso foi passado).

Tempo de execução keepalive total em segundos
TotalKeepaliveRuntimeInSeconds integer

O número total de segundos para o qual manter a sessão ativa.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
KeepSessionAliveResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Marcar Fluxo como concluído

Marque um Fluxo como concluído, o que informa ao IA-Connect Orchestrator que o computador de trabalho atribuído agora está disponível para processar outros Fluxos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Matar todos os outros agentes de IA-Connect

Elimina todas as outras instâncias do agente de IA-Connect que estão em execução na sessão do usuário. Isso garantirá que apenas uma instância do agente de IA-Connect esteja em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de agentes mortos
NumberOfAgentsKilled integer

O número de processos do agente IA-Connect que foram mortos.

Número de agentes que falharam ao matar
NumberOfAgentsFailedToKill integer

O número de processos do agente IA-Connect que não foram mortos.

Mouse de clique do meio

Clica no botão do mouse do meio na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de clique do meio na coordenada

Clica no botão do mouse do meio na sessão de usuário do agente do IA-Connect nas coordenadas especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de espera intermediária

Mantém o botão do mouse do meio na sessão de usuário do agente do IA-Connect para a quantidade especificada de segundos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão do mouse do meio.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de espera intermediária na coordenada

Mantém o botão do mouse do meio nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão do mouse do meio.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de espera à direita

Mantém o botão direito do mouse na sessão de usuário do agente do IA-Connect para a quantidade de segundos especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão direito do mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de espera à esquerda

Mantém o botão esquerdo do mouse na sessão de usuário do agente do IA-Connect para a quantidade especificada de segundos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão esquerdo do mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse de espera à esquerda na coordenada

Mantém o botão esquerdo do mouse nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão esquerdo do mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mouse do Wiggle

Move o mouse para frente e para trás pelo número especificado de coordenadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Movimento X
XWiggle integer

O número de pixels para mover o mouse horizontalmente.

Y wiggle
YWiggle integer

O número de pixels para mover o mouse verticalmente.

Atraso de movimento em segundos
WiggleDelayInSeconds double

O número de segundos entre os movimentos do mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mover arquivo

Move um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo de origem
SourceFilePath True string

O caminho completo para o arquivo de origem. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Caminho do arquivo de destino
DestFilePath True string

O caminho completo para o destino para o qual o arquivo deve ser movido. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mover o mouse entre coordenadas

Move o mouse entre duas coordenadas especificadas na sessão de usuário do agente IA-Connect. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas. Há suporte para um tremulação opcional no movimento do mouse, para torná-lo mais parecido com um movimento da mão humana.

Parâmetros

Nome Chave Obrigatório Tipo Description
Iniciar pixels X
StartXCoord True integer

O valor da coordenada X inicial (em pixels).

Iniciar pixels Y
StartYCoord True integer

O valor da coordenada Y inicial (em pixels).

Pixels de extremidade X
EndXCoord True integer

O valor da coordenada X final (em pixels).

Pixels de fim Y
EndYCoord True integer

O valor da coordenada Y final (em pixels).

Número de etapas
NumberOfSteps integer

O número de etapas em que a ação de movimento deve ser dividida.

Tempo total em segundos
TotalTimeInSeconds double

O tempo total que a ação de movimento deve levar do início ao fim.

Tremulação máxima do pixel de movimento
MaximumMovementPixelJitter integer

O tremulação máxima de pixel ao executar a ação de arrastar. Um valor igual a 1 ou superior permite o tremulação de movimento. O tremulação é suavizado em cada etapa, para evitar picos de movimento. O valor dessa entrada controla o máximo que o tremulação pode estar em qualquer ponto específico, limitando o quão longe o mouse pode se desviar do caminho. Quanto maior o valor, menos "suave" a ação de arrastar será exibida. O tremulação em cada ponto só pode desviar do valor de tremulação anterior entre -2 e 2 (por padrão), portanto, o tremulação máximo possível é 2 x NumberOfSteps, independentemente do que você definir o máximo.

Tremulação máxima do pixel de extremidade
MaximumEndPixelJitter integer

O tremulação máxima de pixel no final da ação de arrastar. Quanto maior o valor, menos preciso será o arrastar ao atingir a coordenada final.

Delta de tremulação de pixel de movimento máximo
MaximumMovementPixelJitterDelta integer

Se estiver usando o tremulação de movimento do mouse (o movimento máximo do pixel é 1 ou superior), o máximo de tremulação em cada ponto pode se desviar do ponto anterior. Isso é usado para garantir que o tremulação seja suave. Um valor maior resulta em menos suavidade.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mover o mouse para a coordenada

Move o mouse na sessão de usuário do agente IA-Connect para as coordenadas de pixel especificadas. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels) para o qual mover o mouse.

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels) para o qual mover o mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mover relativo do mouse

Move o mouse na sessão de usuário do agente IA-Connect pelo número especificado de pixels, em relação à posição atual. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O número de pixels X para mover o mouse, começando da posição atual.

Pixels Y
YCoord True integer

O número de pixels Y para mover o mouse, começando da posição atual dele.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

O arquivo existe

Relata verdadeiro ou falso sobre se um arquivo existe no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
Filename True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O arquivo existe
FileExists boolean

Retornará true se o arquivo existir ou false se não existir.

O diretório está acessível

Retorna se um diretório (pasta) está acessível e se as permissões estão restringindo o acesso a ele no computador em que o agente IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Diretório acessível
DirectoryAccessible boolean

Retornará true se o diretório estiver acessível ou falso, caso contrário.

Acesso de diretório não autorizado
DirectoryAccessUnauthorised boolean

Retornará true se o diretório não for acessível, pois as permissões estão restringindo o acesso a ele ou false, caso contrário.

O diretório existe

Relata verdadeiro ou falso sobre se existe um diretório (pasta) no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O diretório existe
DirectoryExists boolean

Retornará true se o diretório (pasta) existir ou false se não existir.

O leitor de tela está habilitado

Retorna se o leitor de tela foi habilitado na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Leitor de tela habilitado
ScreenReaderEnabled boolean

Retornará true se o leitor de tela tiver sido habilitado.

Obter a configuração de coordenadas globais do agente de IA-Connect

Recupera a configuração da configuração do sistema de coordenadas global do agente IA-Connect, que é usada para exibir locais de elemento (por exemplo: durante a inspeção do mouse) e calcular posições do mouse (por exemplo: ao executar ações globais do mouse).

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Funcionalidade de vários monitores
MultiMonitorFunctionality string

Retornará 'PrimaryMonitor' se o agente de IA-Connect estiver configurado para dar suporte apenas a elementos de realce e executar ações globais do mouse no dispositivo de exibição primário. Retornará 'MultiMonitor' se o agente de IA-Connect realçar elementos em todos os monitores (o padrão desde IA-Connect 9.4).

Multiplicador de inspeção de mouse de conjunto automático
AutoSetMouseInspectionMultiplier boolean

Retornará true se o agente de IA-Connect calcular automaticamente o multiplicador de inspeção do mouse no dispositivo de exibição primário na inicialização do Agente e toda vez que a inspeção do mouse for executada (o padrão desde IA-Connect 9.4). Retornará false se o agente de IA-Connect exigir que o multiplicador de inspeção do mouse seja definido manualmente (a única opção disponível no IA-Connect 9.3 e anterior). Essa opção só tem efeito quando o modo de vários monitores é desabilitado.

Multiplicador de mouse global de conjunto automático
AutoSetGlobalMouseMultiplier boolean

Retornará true se o agente de IA-Connect calcular automaticamente o multiplicador global de movimento do mouse no dispositivo de exibição primário na inicialização do Agente e toda vez que a inspeção do mouse for executada (o padrão desde IA-Connect 9,4). Retornará false se o agente de IA-Connect exigir que o multiplicador global de movimento do mouse seja definido manualmente (a única opção disponível no IA-Connect 9.3 e anterior). Essa opção só tem efeito quando o modo de vários monitores é desabilitado.

Multiplicador X de inspeção do mouse
MouseInspectionXMultiplier double

O multiplicador de inspeção de mouse horizontal (X) atual (para quando o Agente realça o que está sob o mouse). Por exemplo: se IA-Connect estiver exibindo o retângulo de inspeção pela metade do local real do mouse X, esse valor será 0,5. O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada, já que os multiplicadores são calculados dinamicamente quando o agente de IA-Connect é configurado para reconhecimento de vários monitores.

Multiplicador Y de inspeção do mouse
MouseInspectionYMultiplier double

O multiplicador de inspeção do mouse vertical (Y) atual (para quando o Agente realça o que está sob o mouse). Por exemplo: se IA-Connect estiver exibindo o retângulo de inspeção pela metade do local real do mouse Y, esse valor será 0,5. O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada, já que os multiplicadores são calculados dinamicamente quando o agente de IA-Connect é configurado para reconhecimento de vários monitores.

Multiplicador global do mouse X
GlobalMouseXMultiplier double

O multiplicador de movimento do mouse global horizontal (X) atual (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada, já que os multiplicadores são calculados dinamicamente quando o agente de IA-Connect é configurado para reconhecimento de vários monitores.

Multiplicador global do mouse Y
GlobalMouseYMultiplier double

O multiplicador de movimento do mouse global vertical (Y) atual (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada, já que os multiplicadores são calculados dinamicamente quando o agente de IA-Connect é configurado para reconhecimento de vários monitores.

Método de movimentação global do mouse
GlobalMouseMoveMethod string

Retorna o método de movimento do mouse global atual (mouse_event ou setcursorpos).

Sistema de coordenadas Java
JavaCoordinateSystem string

Retorna o sistema de coordenadas Java atual que pode ser 'Virtual' (o padrão) ou 'Físico' (novo no IA-Connect 9.4). As coordenadas virtuais são dimensionadas por DPI, enquanto as coordenadas físicas são mapeadas diretamente para pixels. Esse valor deve ser definido como qualquer sistema de coordenadas que esteja sendo apresentado pela Ponte de Acesso java.

Sistema de coordenadas SAP GUI
SAPGUICoordinateSystem string

Retorna o sistema de coordenadas de API de script sap gui atual que pode ser 'Virtual' (o padrão) ou 'Físico' (novo em IA-Connect 9.4). As coordenadas virtuais são dimensionadas por DPI, enquanto as coordenadas físicas são mapeadas diretamente para pixels. Esse valor deve ser definido como qualquer sistema de coordenadas que esteja sendo apresentado pela API de script sap GUI.

Obter a contagem de processos do agente de IA-Connect

Retorna o número de instâncias do agente IA-Connect atualmente em execução na sessão do usuário. Isso é útil para detectar se há várias instâncias do agente IA-Connect em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de processos
NumberOfProcesses integer

O número de processos do agente IA-Connect que estão em execução na sessão do usuário.

Obter a coordenada atual do mouse

Obtém a posição atual do cursor do mouse na sessão de usuário do agente IA-Connect, usando a API setcursorpos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Pixels X
X integer

O valor da coordenada X (em pixels).

Pixels Y
Y integer

O valor da coordenada Y (em pixels).

Obter a cor do pixel na coordenada

Retorna a cor RGB de um pixel em uma determinada coordenada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X esquerdos
LeftXPixels True integer

A posição X do pixel a ser lido. Em uma única exibição, o pixel X mais à esquerda é 0. Em uma exibição de vários monitores, o pixel X mais à esquerda pode ser negativo (dependendo de qual exibição é marcada como primária e onde ela é relativa às outras exibições).

Principais pixels Y
TopYPixels True integer

A posição Y do pixel a ser lido. Em uma única exibição, o pixel Y superior é 0. Em uma exibição de vários monitores, o pixel Y superior pode ser negativo (dependendo de qual exibição é marcada como primária e onde ela é relativa às outras exibições).

Ocultar Agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o pixel que está sendo lido.

Usar coordenadas físicas
UsePhysicalCoordinates boolean

Defina como true para especificar que as coordenadas fornecidas são físicas (não dimensionadas por DPI e, portanto, correspondem aos pixels físicos na exibição). Defina como false (o padrão) para especificar que as coordenadas fornecidas são virtuais (DPI dimensionada). Ações UIA, Java e Web normalmente usam coordenadas virtuais.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Valor vermelho
RedValue integer

Retorna o valor vermelho do pixel de 0 (sem vermelho) para 255 (vermelho completo).

Valor verde
GreenValue integer

Retorna o valor verde do pixel de 0 (sem verde) para 255 (verde completo).

Valor azul
BlueValue integer

Retorna o valor azul do pixel de 0 (sem azul) para 255 (azul completo).

Valor alfa
AlphaValue integer

Retorna o valor alfa do pixel de 0 (completamente transparente) para 255 (totalmente opaco).

Valor de hexadecimação RRGGBB
RRGGBBHexValue string

Retorna o valor hexáxe RRGGBB do pixel. Por exemplo: FF0000 é vermelho completo, 00FF00 é verde completo, 0000FF é azul, 000000 é preto, FFFFFF é branco completo.

Valor hexadecima de AARRGGBB
AARRGGBBHexValue string

Retorna o valor hexadecima de AARRGGBB do pixel que é o mesmo que RRGGBB, mas com o valor alfa hex incluído no início. Para pixels totalmente opacos (os mais comuns), isso conterá o valor FFRRGGBB. Por exemplo: FFFF0000 é totalmente opaca em vermelho completo.

Obter a ID do processo pai

Retorna a ID do processo pai para qualquer processo em execução na sessão de usuário do agente IA-Connect que tenha a ID do processo especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do processo
ProcessId True integer

A ID do processo filho.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
ID do processo pai
ParentProcessId integer

A ID do processo pai.

Processo pai ainda em execução
ParentProcessStillRunning boolean

Retornará true se o processo pai ainda estiver em execução e não tiver sido encerrado.

Nome do processo pai
ParentProcessName string

O nome do processo pai.

Obter a próxima tarefa de automação do Orchestrator

Recupera a próxima tarefa de automação do Orchestrator que corresponde aos critérios de pesquisa especificados. Somente as tarefas 'New' e 'Deferred' (que atingiram a data de adiamento) podem ser recuperadas. As tarefas em espera não serão recuperadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da automação
AutomationName string

Deixe em branco para retornar tarefas de automação do Orchestrator com qualquer nome. Insira um valor para recuperar apenas tarefas com esse nome de automação.

Nomes de automação
AutomationNames array of string

Se você precisar retornar tarefas do Orchestrator que correspondam a qualquer um dos dois ou mais nomes de automação, insira os nomes nesta lista, em vez de inserir na entrada "Nome da Automação".

Nível mínimo de prioridade
MinimumPriorityLevel integer

Retorne somente as tarefas de automação do Orchestrator que têm o nível de prioridade especificado ou superior. Por exemplo: a configuração 2 retornará tarefas com um nível de prioridade de 1 e 2.

Alterar o status para
StatusChange string

Se definido como 'Recuperado': ao recuperar uma tarefa, o status da tarefa será alterado para 'Recuperado' para impedir que outras ações tentem executar a mesma tarefa. Se definido como "Não fazer nada", o status da tarefa não será alterado.

Minutos até a data de adiamento
MinutesUntilDeferralDate integer

Retorne somente as tarefas de automação do Orchestrator que estão prontas para serem executadas dentro do número de minutos especificado. Defina como 0 se você quiser apenas tarefas de automação que estão prontas para serem executadas agora.

Ignorar o SLA
IgnoreSLA boolean

Defina isso como true para ignorar todos os SLAs que foram definidos na tarefa. Por padrão, uma tarefa com um SLA que em breve violará tem prioridade sobre todo o resto.

Excluir IDs de tarefa
ExcludeTaskIds array of integer

Uma lista de IDs de tarefa a serem exlúdios do processamento.

Retornos

Nome Caminho Tipo Description
Tarefa recuperada
TaskRetrieved boolean

Definido como true se uma tarefa foi recuperada. Defina como false se não houver tarefas que correspondam aos critérios de pesquisa.

ID da tarefa
TaskId integer

A ID da tarefa de automação do Orchestrator recuperada.

ID da operação
OperationId string

A ID da Operação da tarefa Orchestrator recuperada. Essa ID da Operação (ou a ID da tarefa) pode ser usada para recuperar a tarefa em uma data posterior. A ID da Operação é uma cadeia de caracteres exclusiva e indisponível, limitando a capacidade de um terceiro adivinhar a ID de uma operação que eles não criaram.

Nome da automação
AutomationNameOutput string

O nome da tarefa de automação recuperada.

Data e hora do adiamento
DeferralDateTime string

A data e a hora em que a tarefa Orchestrator recuperada está agendada para estar pronta. Isso será retornado como uma cadeia de caracteres em UTC.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais armazenados quando a tarefa foi adiada. Geralmente, esses são dados que você precisa para continuar o processo/fluxo, mas você pode usar esse campo para qualquer finalidade.

Contagem de adiamentos
DeferralCount integer

Com que frequência essa tarefa foi adiada. Isso normalmente será 0 para uma nova tarefa que nunca foi adiada ou 1 ou mais para uma tarefa adiada. Sempre que uma tarefa adiada for adiada novamente, o Orchestrator aumentará automaticamente esse número.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais armazenados quando a tarefa foi criada. Geralmente, são dados usados para iniciar o processo/fluxo, mas você pode usar esse campo para qualquer finalidade. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Dados de saída da tarefa
TaskOutputData string

Dados opcionais armazenados, pela automação, quando a tarefa foi processada. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Priority
Priority integer

O nível de prioridade dessa tarefa orchestrator (1 sendo o nível mais alto).

Status da tarefa de automação
AutomationTaskStatus string

O status da tarefa Orchestrator recuperada.

Estágio do processo
ProcessStage string

O ponto no qual o processo/fluxo adiado deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida.

Data e hora recebidas
ReceivedDateTime string

A data e a hora em que a tarefa foi recebida inicialmente pelo Orchestrator. Isso será retornado como uma cadeia de caracteres em UTC.

Minutos até a data de adiamento
MinutesUntilDeferralDateOutput integer

O número de minutos até a data de adiamento dessa tarefa (ou seja, quando essa tarefa estiver pronta para ser executada). Se essa tarefa estiver pronta para executar os minutos será 0.

Nome do tipo de origem
SourceTypeName string

O nome da origem da tarefa. A 'interface do usuário da Web' representa uma tarefa inserida manualmente por meio da interface do usuário. A 'API REST' representa uma tarefa criada por meio da API REST do Orchestrator. 'ServiceNow' representa uma tarefa criada a partir da integração interna do ServiceNow 'Sources' do Orchestrator.

Nome amigável da origem
SourceFriendlyName string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém o nome amigável dessa origem.

ID do tíquete de origem
SourceTicketId string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém a ID do tíquete de origem. Para o ServiceNow, isso manteria a tarefa de catálogo sys_id.

Sub-ID do tíquete de origem
SourceTicketSubId string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém a ID do tíquete de origem. Para o ServiceNow, isso manteria o item de solicitação sys_id.

Organização
Organisation string

A organização à qual esta tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

O departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

A descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Obter a última ação com falha das estatísticas de fluxo do Orchestrator

Recupera os detalhes da última ação que passou pelo IA-Connect Orchestrator para um trabalhador, se essa ação falhou. Essa ação é mais comumente usada durante o tratamento de erros.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Trabalho alocado para execução de fluxo
WorkerAllocatedToFlowRun boolean

Retornará true se houver um trabalho alocado para essa execução de fluxo e, portanto, informações poderão ser fornecidas sobre o último erro de ação. Retornará false se não houver nenhum trabalho alocado para essa execução de fluxo (um nunca foi alocado ou o trabalho agora foi disponibilizado para outra execução de fluxo) e, portanto, nenhuma informação pode ser fornecida sobre o último erro.

Falha na última ação
LastActionFailed boolean

Retornará true se a última ação nessa execução de fluxo (que é executada em um trabalho alocado para essa execução de fluxo) falhar: as outras saídas dessa ação conterão os detalhes. Retornará false se a última ação nesta execução de fluxo não falhar: as outras saídas ficarão em branco.

Último caminho de solicitação de ação com falha
LastFailedActionRequestPath string

Se a última ação nessa execução de fluxo (que é executada em um trabalho alocado para essa execução de fluxo) falhar, essa saída conterá o caminho da solicitação de ação. Isso pode ser usado para determinar qual ação falhou. Se a última ação nessa execução de fluxo não falhar, esse valor ficará em branco.

Última mensagem de erro de ação com falha
LastFailedActionErrorMessage string

Se a última ação nessa execução de fluxo (que é executada em um trabalho alocado para essa execução de fluxo) falhar, essa saída conterá a mensagem de erro. Se a última ação nessa execução de fluxo não falhar, esse valor ficará em branco.

Obter arquivos

Retorna uma lista de arquivos em uma pasta (correspondendo a uma lista CSV de padrões) no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

CSV de padrões
PatternsCSV True string

Uma lista separada por vírgulas de padrões de arquivo a serem correspondentes, por exemplo . para todos os arquivos ou '.txt,.docx' para arquivos com uma extensão .txt ou .docx.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Arquivos JSON
FilesJSON string

Uma lista de arquivos contidos na pasta, no formato JSON.

Número de arquivos lidos com êxito
NumberOfFilesReadSuccessfully integer

O número de arquivos que foram lidos com êxito.

Falha na leitura do número de arquivos
NumberOfFilesFailedToRead integer

O número de arquivos que não puderam ser lidos.

Obter contagem de processos por nome

Retorna uma contagem de processos em execução na sessão de usuário do agente IA-Connect que tem o nome do processo especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo
ProcessName True string

O nome do processo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de processos
NumberOfProcesses integer

O número de processos que correspondem ao nome do processo fornecido.

Obter conteúdo de arquivo como Base64

Recupere o conteúdo do arquivo especificado no formato Base64, um formato adequado para transmissão via API e convertido facilmente de volta no formato original ou binário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
FilePath True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Comprimir
Compress boolean

Defina como true para GZip compactar o conteúdo do arquivo antes de converter em Base64. O arquivo é intocado, todas as operações são executadas na memória. Esse recurso só será útil se você conseguir GUnzip o conteúdo do arquivo depois de recuperar o Base64 (ao decodificar de volta para o conteúdo do arquivo original texto ou dados binários). Defina como false se você estiver passando o Base64 diretamente para uma ação que aceita Base64 como entrada e não tem um recurso GUnzip.

Tamanho máximo do arquivo
MaxFileSize integer

O tamanho máximo do arquivo, acima do qual uma exceção será gerada em vez de recuperar o conteúdo do arquivo. Isso permite que você evite a situação em que o Agente é solicitado a recuperar um arquivo enorme, o que fará com que a ação tenha um tempo limite. Defina como -1 para desabilitar a verificação de tamanho do arquivo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Conteúdo do arquivo como Base64
FileContentsAsBase64 string

O conteúdo do arquivo no formato Base64.

Obter credencial genérica do Orchestrator

Recupera uma credencial genérica que foi armazenada no IA-Connect Orchestrator. Uma credencial pode conter nomes de usuário, senhas, nomes de host, URLs e outros dados genéricos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome amigável
FriendlyName string

Nome amigável da credencial armazenada no Orchestrator.

Recuperar senha de texto sem formatação
RetrievePlainTextPassword boolean

Se marcada, a senha da credencial genérica do Orchestrator especificada será retornada como texto sem formatação, se a configuração de credencial genérica do Orchestrator 'Não expor senha' tiver sido desabilitada (permitindo que as senhas sejam recuperadas). É recomendável não recuperar senhas como texto sem formatação e, em vez disso, usar IA-Connect ações que dão suporte a senhas armazenadas (por exemplo: "Senha de entrada na ação UIA") em que o Orchestrator inserirá a senha diretamente na ação em tempo de execução.

Retornos

Nome Caminho Tipo Description
Nome de usuário
Username string

O nome de usuário mantido na credencial genérica.

Senha de texto sem formatação
PlainTextPassword string

A senha, mantida na credencial genérica, como uma cadeia de caracteres de texto sem formatação. As senhas do orquestrador são armazenadas criptografadas, mas serão retornadas como texto sem formatação para permitir que você as passe para ações que exigem elas.

Nome do host
Hostname string

O nome do host ou o nome de domínio mantido na credencial genérica, se usado.

URL
Url string

A URL mantida na credencial genérica, se usada.

Propriedade genérica 1
GenericProperty1 string

Uma propriedade genérica mantida na credencial genérica, se usada. Isso pode ser usado para armazenar dados que podem estar associados à credencial.

Propriedade genérica 2
GenericProperty2 string

Uma propriedade genérica mantida na credencial genérica, se usada. Isso pode ser usado para armazenar dados que podem estar associados à credencial.

Propriedade genérica 3
GenericProperty3 string

Uma propriedade genérica mantida na credencial genérica, se usada. Isso pode ser usado para armazenar dados que podem estar associados à credencial.

Obter domínio do computador

Retorna o domínio do computador que está executando a sessão de usuário do agente IA-Connect.

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 de domínio
DomainName string

O nome de domínio NetBIOS do computador que está executando a sessão de usuário do agente IA-Connect.

Nome de domínio DNS
DNSDomainName string

O nome de domínio DNS do computador que está executando a sessão de usuário do agente IA-Connect.

Obter espaço livre em disco

Retorna a quantidade de espaço livre para um disco especificado no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Letra da unidade
DriveLetter True string

A letra da unidade do disco a ser verificada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Bytes de espaço livre em disco
FreeSpaceBytes integer

A quantidade de espaço livre em disco, em bytes.

KB de espaço livre em disco
FreeSpaceKB integer

A quantidade de espaço livre em disco, em quilobytes.

Mb de espaço livre em disco
FreeSpaceMB integer

A quantidade de espaço livre em disco, em megabytes.

Gb de espaço livre em disco
FreeSpaceGB integer

A quantidade de espaço livre em disco, em gigabytes.

Obter estatísticas de disponibilidade de trabalho do Orchestrator

Retorna estatísticas de disponibilidade do IA-Connect Orchestrator. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Parâmetros

Nome Chave Obrigatório Tipo Description
No último número de dias
WithinLastNumberOfDays integer

Filtre os resultados para recuperar somente aqueles iniciados no último número especificado de dias. Defina como 0 para não filtrar.

Nome do fluxo
SearchFlowName string

Filtre os resultados para recuperar somente aqueles com o nome de fluxo especificado. Defina como em branco para não filtrar pelo nome do fluxo.

Janela de início da hora de início do fluxo
SearchFlowStartTimeStartWindow date-time

Filtre os resultados para recuperar somente aqueles iniciados após a hora de início especificada. Defina como em branco para não filtrar. Por exemplo: '2022-01-24T07:00:00' retornaria todas as estatísticas do Orchestrator Flow for Flows iniciadas em ou após 07h no dia 24 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Retornos

Nome Caminho Tipo Description
Estatísticas de disponibilidade de trabalho JSON
WorkerAvailabilityStatsJSON string

Uma lista de estatísticas de disponibilidade do trabalho, no formato JSON.

Número de estatísticas de disponibilidade do trabalho
NumberOfWorkerAvailabilityStats integer

O número de estatísticas de disponibilidade de trabalho que foram retornadas.

Obter estatísticas do Flow do Orchestrator

Retorna uma lista de estatísticas de fluxo do Orquestrador de IA-Connect. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Parâmetros

Nome Chave Obrigatório Tipo Description
No último número de dias
WithinLastNumberOfDays integer

Filtre os resultados para recuperar somente aqueles iniciados no último número especificado de dias. Defina como 0 para não filtrar.

Nome do fluxo
SearchFlowName string

Filtre os resultados para recuperar somente aqueles com o nome de fluxo especificado. Defina como em branco para não filtrar pelo nome do fluxo.

Resultado da última ação do fluxo
SearchFlowLastActionResult boolean

Filtre os resultados para recuperar somente aqueles com o resultado da última ação especificado. Definido como true para recuperar apenas fluxos bem-sucedidos. Defina como false para recuperar apenas fluxos com falha. Não defina um valor/definido como em branco para não filtrar pelo resultado da última ação do Flow.

Janela de início da hora de início do fluxo
SearchFlowStartTimeStartWindow date-time

Filtre os resultados para recuperar somente aqueles iniciados após a hora de início especificada. Defina como em branco para não filtrar. Por exemplo: '2022-01-24T07:00:00' retornaria todas as estatísticas do Orchestrator Flow for Flows iniciadas em ou após 07h no dia 24 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Janela de término da hora de início do fluxo
SearchFlowStartTimeEndWindow date-time

Filtre os resultados para recuperar somente aqueles iniciados antes da hora de início especificada. Defina como em branco para não filtrar. Por exemplo: '2022-01-25T07:00:00' retornaria todas as estatísticas do Orchestrator Flow para Fluxos iniciados em ou antes das 07:00 horas no dia 25 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Retornos

Nome Caminho Tipo Description
JSON de estatísticas do Orchestrator Flow
OrchestratorFlowStatsJSON string

Uma lista de todas as estatísticas do Orchestrator Flow, no formato JSON.

Número de estatísticas de fluxo
NumberOfOrchestratorFlowStats integer

O número de estatísticas do Flow que foram retornadas.

Obter IA-Connect status do próximo salto

Relata o status do diretor do próximo salto para o Agente que recebe esse comando. Se o próximo salto estiver habilitado, esse Agente encaminha comandos para o próximo salto (por meio do diretor do próximo salto). Se o próximo salto estiver desabilitado, esse Agente está processando comandos em si (o padrão).

Parâmetros

Nome Chave Obrigatório Tipo Description
Verifique se o diretor do próximo salto está em execução
CheckNextHopDirectorIsRunning boolean

O próximo salto requer um IA-Connect Director em execução no mesmo computador que o Agente. Se essa configuração for verdadeira, o Agente verificará se o diretor do próximo salto está em execução, conforme descrito. Se essa configuração for falsa, o Agente não executará nenhuma verificação e simplesmente verificará o status do próximo salto.

Verificar se o agente do próximo salto está em execução
CheckNextHopAgentIsRunning boolean

O próximo salto requer um IA-Connect Director em execução no mesmo computador que o Agente E um agente de IA-Connect em execução na sessão de próximo salto. Se essa configuração for verdadeira, o Agente verificará se o Agente do próximo salto está em execução, conforme descrito. Se essa configuração for falsa, o Agente não executará nenhuma verificação e simplesmente verificará o status do próximo salto.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Próximo salto habilitado
NextHopEnabled boolean

Retornará true se o próximo salto estiver habilitado no momento.

Endereço do Diretor do próximo salto ativo
ActiveNextHopDirectorAddress string

O endereço do diretor de próximo salto ativo, se um estiver sendo usado.

Porta TCP do Active Next Hop Director
ActiveNextHopDirectorTCPPort integer

A porta TCP do diretor de próximo salto ativo, se um estiver sendo usado.

O Active Next Hop Director usa HTTPS
ActiveNextHopDirectorUsesHTTPS boolean

Retorna true se o diretor de próximo salto ativo estiver usando HTTPS.

O Active Next Hop Director está em execução
ActiveNextHopDirectorIsRunning boolean

Retornará true se o diretor de próximo salto ativo estiver em execução ou false, caso contrário.

Active next hop Director URL
ActiveNextHopDirectorURL string

A URL do diretor de próximo salto ativo.

O agente de próximo salto ativo está em execução
ActiveNextHopAgentIsRunning boolean

Retornará true se o agente de próximo salto ativo estiver em execução ou false se não estiver.

Obter impressora padrão

Obtém o nome da impressora padrão para o usuário na sessão IA-Connect Agent.

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 da impressora padrão
DefaultPrinterName string

O nome da impressora padrão para o usuário.

Obter informações de ambiente

Retorna informações sobre o ambiente no qual a sessão de usuário do agente IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Versão principal do sistema operacional
OSVersionMajor integer

A versão principal do sistema operacional.

Versão secundária do sistema operacional
OSVersionMinor integer

A versão secundária do sistema operacional.

Versão de build do sistema operacional
OSVersionBuild integer

A versão de build do sistema operacional.

O sistema operacional é de 64 bits
OSIs64Bit boolean

Retornará true se o sistema operacional for de 64bits.

Contagem de processadores
ProcessorCount integer

A contagem de processadores.

Total de RAM física em MB
TotalPhysicalRAMInMB integer

A quantidade de RAM física (em MB).

Total de RAM virtual em MB
TotalVirtualRAMInMB integer

A quantidade de RAM virtual (em MB).

RAM física disponível em MB
AvailablePhysicalRAMInMB integer

A quantidade de RAM física que está disponível no momento (em MB).

RAM virtual disponível em MB
AvailableVirtualRAMInMB integer

A quantidade de RAM virtual que está disponível no momento (em MB).

Nome completo do sistema operacional
OSFullName string

O nome completo do sistema operacional, por exemplo, Microsoft Windows Server 2019 Standard.

Nome da cultura da interface do usuário instalado
InstalledUICultureName string

O idioma da interface do usuário instalado com o sistema operacional, por exemplo, en-US.

Nome da cultura da interface do usuário atual
CurrentUICultureName string

O idioma padrão da interface do usuário, por exemplo, en-US.

Nome da cultura atual
CurrentCultureName string

A localidade do usuário padrão, por exemplo, en-GB.

Obter informações de sessão do agente de IA-Connect

Retorna informações sobre a sessão de usuário do agente IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Id da Sessão
SessionId integer

A ID da sessão do usuário remoto atual.

Tipo de sessão
SessionType integer

O tipo de sessão remota, 1 (Citrix), 2 (RDP) ou 0 (Console).

Nome do tipo de sessão
SessionTypeName string

O tipo de sessão remota, ICA (Citrix), RDP ou Console.

Obter informações de tipo de cliente e sessão do Diretor

Retorna os detalhes da sessão local ou remota que está sendo tratada pelo Diretor de camada 1.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Tipo de cliente remoto
RemoteClientType string

O tipo de cliente remoto ('Local', 'Citrix ICA' ou 'Microsoft RDP').

Canal virtual conectado
VirtualChannelConnected boolean

True, se o canal virtual estiver conectado, entre o Diretor e o Agente.

Versão do diretor
DirectorVersion string

A versão da DLL do IA-Connect Director. Por exemplo: 1.67.21.0.

Versão do lançamento do diretor
DirectorReleaseVersion string

A versão de versão IA-Connect do IA-Connect Director. Por exemplo: 9.4.

Versão do agente
AgentVersion string

A versão do IA-Connect Agent EXE à qual este Diretor está conectado. Por exemplo: 1.74.21.0.

Versão de versão do agente
AgentReleaseVersion string

A versão de versão IA-Connect do agente de IA-Connect à qual este Diretor está conectado. Por exemplo: 9.4.

O agente está licenciado
AgentIsLicensed boolean

True, se o agente de IA-Connect ao qual este Diretor está conectado, está licenciado. False, se o agente de IA-Connect não estiver licenciado. Nulo se o estado de licença do Agente for desconhecido.

Recursos de licença do agente
AgentLicenseFeatures string

Uma lista separada por vírgulas de IA-Connect recursos de licença atribuídos ao agente de IA-Connect ao qual este Diretor está conectado. Por exemplo: JML, DEV.

Nome do host do diretor
DirectorHostname string

O nome do host do computador no qual o Diretor está em execução. Por exemplo: vmrpa1.

Nome de domínio do NetBIOS do Diretor
DirectorNetBIOSDomainName string

O nome de domínio NetBIOS do computador no qual o Diretor está em execução. Por exemplo: domain1. Se o computador não for um membro de um domínio, isso normalmente retornará o nome do host.

Nome de domínio DNS do diretor
DirectorDNSDomainName string

O nome de domínio DNS do computador no qual o Diretor está em execução. Por exemplo: domain1.myorg.local. Se o computador não for um membro de um domínio, isso normalmente retornará o nome do host.

Anexado ao diretor do próximo salto
AttachedToNextHopDirector boolean

Defina como false se a sessão IA-Connect estiver anexada ao Agente ao qual este Diretor está conectado. Defina como true se o Diretor estiver encaminhando todas as ações (ou seja, anexadas) a outro Diretor (que está conectado a um agente diferente). Por exemplo, se esse Diretor for um diretor local se comunicando com um agente local, mas a sessão IA-Connect estiver anexada ao Citrix, esse valor será verdadeiro.

Tipo de sessão do Diretor do próximo salto
NextHopDirectorSessionType string

Se esse Diretor estiver anexado a um diretor do próximo salto, esse valor conterá o tipo de sessão do próximo salto. Por exemplo, se este Diretor for um diretor local comunicando-se com um agente local, mas a sessão IA-Connect estiver anexada ao Citrix no momento, esse valor será "Citrix ICA", enquanto o valor "Tipo de cliente remoto" será "Local" (representando um diretor local encaminhando ações para o Citrix).

Obter informações de última entrada

Obtém o tempo desde que a última entrada do usuário foi recebida na sessão de usuário do agente IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Últimos segundos totais de entrada
LastInputTotalSeconds integer

O número de segundos decorridos desde a última entrada.

Último total de minutos de entrada
LastInputTotalMinutes integer

O número de minutos decorridos desde a última entrada.

Últimas horas totais de entrada
LastInputTotalHours integer

O número de horas decorridos desde a última entrada.

Obter informações do agente de IA-Connect

Retorna as propriedades do agente de IA-Connect, incluindo o número de versão e o caminho para o executável do Agente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
versão do agente do IA-Connect
IAConnectAgentVersion string

O número de versão completo do agente de IA-Connect.

Versão clr do DotNet
DotNetCLRVersion string

A versão CLR (Common Language Runtime) do DotNet.

IA-Connect Agent executado como nome de usuário
IAConnectAgentRunAsUsername string

O nome de usuário da sessão de usuário em que o agente IA-Connect está em execução.

IA-Connect Agent executado como userdomain
IAConnectAgentRunAsUserdomain string

O domínio do usuário da sessão de usuário em que o agente do IA-Connect está em execução.

Caminho do Agente IA-Connect
IAConnectAgentPath string

O caminho completo para o executável do agente de IA-Connect.

IA-Connect Agent é um processo de 64 bits
IAConnectAgentIs64bitProcess boolean

Retornará true se o agente de IA-Connect for um processo de 64 bits ou false se não for.

Versão de versão do agente do IA-Connect
IAConnectAgentReleaseVersion string

A versão de versão do IA-Connect Agent, por exemplo, 8.0.

Tempo limite do comando RPA do agente IA-Connect
IAConnectAgentRPACommandTimeout integer

O tempo limite do comando RPA do agente IA-Connect. Esse padrão é de 30 segundos e pode ser definido usando a ação "Definir tempo limite de comando do Agente IA-Connect".

Nome de arquivo de log do agente do IA-Connect
IAConnectAgentLogFilename string

O nome do arquivo de log do agente IA-Connect. Esse valor é exclusivo para cada inicialização do agente de IA-Connect, pois ele tem a data e a hora de inicialização no nome do arquivo.

Obter informações do diretor do IA-Connect

Retorna as propriedades do IA-Connect Director, incluindo o número de versão e o caminho para o executável Director.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
versão do IA-Connect Director
IAConnectDirectorVersion string

O número de versão completo do IA-Connect Director.

Versão clr do DotNet
DotNetCLRVersion string

A versão CLR (Common Language Runtime) do DotNet.

IA-Connect Director executar como nome de usuário
IAConnectDirectorRunAsUsername string

O nome de usuário da sessão de usuário em que o IA-Connect Director está em execução.

IA-Connect Director executar como userdomain
IAConnectDirectorRunAsUserdomain string

O domínio do usuário da sessão do usuário em que o IA-Connect Director está em execução.

caminho do diretor IA-Connect
IAConnectDirectorPath string

O caminho completo para o executável do IA-Connect Director.

IA-Connect Director é um processo de 64 bits
IAConnectDirectorIs64bitProcess boolean

Retornará true se o IA-Connect Director for um processo de 64 bits ou false se não for.

versão de versão do IA-Connect Director
IAConnectDirectorReleaseVersion string

A versão de versão do IA-Connect Director, por exemplo, 8.0.

nome do arquivo de log do IA-Connect Director
IAConnectDirectorLogFilename string

O nome do arquivo de log do IA-Connect Director. Esse valor é exclusivo para cada inicialização do IA-Connect Director, pois ele tem a data e a hora de inicialização no nome do arquivo.

Obter lista de funcionários do Orchestrator

Recupere uma lista de trabalhadores registrados com o Orchestrator IA-Connect e seu status ao vivo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Retornar somente trabalhadores ativos
OnlyReturnLiveWorkers boolean

Definido como true, para retornar apenas trabalhadores dinâmicos (trabalhadores que estão conectados ativamente ao Orchestrator).

Retornos

Nome Caminho Tipo Description
Funcionários do orchestrator
OrchestratorWorkers array of object

A lista de trabalhadores registrados no IA-Connect Orchestrator e seu status ao vivo.

ID
OrchestratorWorkers.Id integer
Nome
OrchestratorWorkers.Name string
CurrentFlowDisplayName
OrchestratorWorkers.CurrentFlowDisplayName string
LiveStatus
OrchestratorWorkers.LiveStatus boolean
LiveStatusLastContactTicks
OrchestratorWorkers.LiveStatusLastContactTicks integer
SecondsSinceLastContact
OrchestratorWorkers.SecondsSinceLastContact integer
MaintenanceMode
OrchestratorWorkers.MaintenanceMode boolean
Priority
OrchestratorWorkers.Priority integer
AgentIsLicensed
OrchestratorWorkers.AgentIsLicensed boolean
IsAvailableForWork
OrchestratorWorkers.IsAvailableForWork boolean
Número de trabalhadores
NumberOfOrchestratorWorkers integer

O número de funcionários do Orchestrator na resposta.

Obter lista de impressoras

Retorna uma lista de todas as impressoras disponíveis na sessão IA-Connect Agent.

Parâmetros

Nome Chave Obrigatório Tipo Description
Listar impressoras locais
ListLocalPrinters boolean

As impressoras locais devem ser retornadas?

Listar impressoras de rede
ListNetworkPrinters boolean

As impressoras de rede devem ser retornadas?

Retornar informações detalhadas
ReturnDetailedInformation boolean

Informações detalhadas como localização, nome da porta, nome do driver e status de cada impressora devem ser retornadas?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Impressoras JSON
PrintersJSON string

Uma lista de todas as impressoras encontradas, no formato JSON.

Número de impressoras
NumberOfPrinters integer

O número de impressoras que foram encontradas.

Obter lista de unidades

Retorna uma lista de unidades no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Unidades JSON
DrivesJSON string

Uma lista de unidades no computador em que o agente IA-Connect está em execução, no formato JSON.

Obter mapa de calor de uso do fluxo de trabalho do Orchestrator

Retorna o mapa de calor diário de uso do fluxo de trabalho do Orquestrador de IA-Connect. Usado para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Janela de início da hora de início do fluxo
SearchStartDateStartWindow True date-time

Filtre os resultados para recuperar apenas o mapa de calor de uso do fluxo de trabalho após a data de início especificada (o componente de hora é ignorado). Defina como em branco para não filtrar. Por exemplo: '2022-01-24T00:00:00' retornaria um mapa de calor de trabalho para fluxos que começaram em ou após o dia 24 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Janela de término da hora de início do fluxo
SearchStartDateEndWindow True date-time

Filtre os resultados para recuperar apenas o mapa de calor de uso do fluxo de trabalho antes da data de início especificada (o componente de hora é ignorado). Defina como em branco para não filtrar. Por exemplo: '2022-01-25T00:00:00' retornaria um mapa de calor de trabalho para Flow iniciado em ou antes do dia 25 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Deslocamento de minutos de fuso horário de UTC
TimeZoneMinutesOffsetFromUTC integer

O deslocamento de fuso horário de UTC em minutos para alinhar o mapa de calor diário. Por exemplo: se você especificar 60 minutos, os mapas de calor diários serão executados de 01:00 UTC a 01:00 UTC.

IA-Connect nomes de trabalho
WorkerNames string

Uma lista dos nomes de IA-Connect Workers para o qual retornar um mapa de calor, no formato JSON ou CSV. Se deixado em branco, um mapa de calor será gerado para todos os trabalhadores atualmente conhecidos pelo Orchestrator. Por exemplo: [{"WorkerName": "Worker1"}, {"WorkerName": "Worker2"}] (formato de tabela JSON), ["Worker1", "Worker2"] (formato de matriz JSON) ou Worker1,Worker2 (formato CSV).

Retornos

Nome Caminho Tipo Description
JSON do mapa de calor de uso do fluxo de trabalho
WorkerFlowUsageHeatmapJSON string

Um mapa de calor de uso do fluxo de trabalho, no formato JSON.

Número de itens de mapa de calor de uso do fluxo de trabalho
NumberOfWorkerFlowUsageHeatmapItems integer

O número de itens de mapa de calor de uso do fluxo de trabalho que foram retornados. Um item por trabalho por dia.

Obter mensagem de erro de ação com falha do resultado do fluxo JSON

Desserializa a saída JSON de uma ou mais expressões result() de fluxo e recupera a primeira mensagem de erro localizada de uma ação com falha. A mensagem de erro pode ser armazenada no JSON em uma variedade de formatos. Essa ação processa formatos conhecidos e retorna a primeira mensagem de erro localizada.

Parâmetros

Nome Chave Obrigatório Tipo Description
JSON do resultado do fluxo
PowerAutomateResultJSON True array of string

Uma matriz de JSON que deve conter as saídas de uma ou mais expressões result() de fluxo. Se você estiver processando apenas a saída de uma única expressão result() de fluxo, basta inseri-la no primeiro item de matriz.

Status da pesquisa
SearchStatus string

O status da ação que contém a mensagem de erro. Isso só deverá ser alterado se você estiver procurando um status diferente do padrão de "Falha".

Retornos

Nome Caminho Tipo Description
Mensagem de erro de ação
ActionErrorMessage string

Retorna a mensagem de erro de ação extraída do JSON de resultado. Se uma mensagem de erro não puder ser localizada, um valor em branco será retornado.

Nome da ação
ActionName string

Retorna o nome da ação associada à mensagem de erro.

Código de ação
ActionCode string

Retorna o código de resultado da ação associada à mensagem de erro.

Obter multiplicador de mouse

Recupera o multiplicador de mouse global na sessão de usuário do agente do IA-Connect. Esse padrão é (1, 1), mas pode ter sido alterado pela ação "Definir multiplicador de mouse".

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Multiplicador X
MouseXMultiplier double

O multiplicador de mouse global horizontal (X) atual (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Multiplicador Y
MouseYMultiplier double

O multiplicador de mouse global vertical (Y) atual (para quando o Agente move o mouse). O multiplicador só tem qualquer efeito quando a "funcionalidade de vários monitores" é desabilitada.

Método de movimentação do mouse
MouseMoveMethod string

Retorna o método de movimento do mouse global atual (mouse_event ou setcursorpos).

Obter o estado de licença atual do agente de IA-Connect

Retorna se o agente de IA-Connect está licenciado no momento e, se licenciado, as propriedades da licença.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Está licenciado
IsLicensed boolean

Retornará true se o agente de IA-Connect estiver licenciado no momento ou false, caso contrário.

Tipo de licença
LicenseType string

O tipo de licença IA-Connect sendo usada.

Nome de domínio do agente
CustomerNETBIOSDomainName string

O nome de domínio NetBIOS do computador em que o agente de IA-Connect está em execução, se licenciado por nome de domínio (IA-Connect 7.0 ou 7.1).

Nomes de host do diretor
DirectorHostnameCSV string

Os nomes de host dos computadores em que o IA-Connect Director pode ser instalado, se licenciado pelo nome do host (pós-IA-Connect 7.2).

Nome de exibição do cliente
CustomerDisplayName string

O nome do cliente a ser exibido na barra de título do agente IA-Connect.

Nome do fornecedor
VendorName string

O IA-Connect nome do fornecedor.

Data de expiração da licença
LicenseExpiryDate string

A data de expiração da licença IA-Connect.

Dias até que a licença expire
DaysUntilLicenseExpires integer

O número de dias restantes até que a licença de IA-Connect expire.

Recursos de licença
LicenseFeatures string

Recursos adicionais de licença, normalmente fornecendo acesso a funcionalidades adicionais.

É a licença JML
IsJMLLicense boolean

Essa licença fornece acesso à funcionalidade JML.

Obter o histórico de logon do Orchestrator

Retorna o IA-Connect histórico de logon do Orchestrator para fins de relatório. Opcionalmente, você pode usar um ou mais filtros para limitar os resultados retornados.

Parâmetros

Nome Chave Obrigatório Tipo Description
No último número de dias
WithinLastNumberOfDays integer

Filtre os resultados para recuperar somente logons do Orchestrator dentro do número de dias especificado. Defina como 0 para não filtrar.

Endereço de email
SearchByEmail string

Filtre os resultados para recuperar somente logons do Orchestrator com o endereço de email especificado. Defina como em branco para não filtrar por endereço de email.

Janela de início do histórico de logon
SearchLoginHistoryTimeStartWindow date-time

Filtre os resultados para recuperar somente logons do Orchestrator após a hora de início especificada. Defina como em branco para não filtrar. Por exemplo: '2022-01-24T07:00:00' retornaria todos os logons do Orchestrator em ou após 07:00 horas no dia 24 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Janela de término do histórico de logon
SearchLoginHistoryTimeEndWindow date-time

Filtre os resultados para recuperar somente logons do Orchestrator antes da hora de início especificada. Defina como em branco para não filtrar. Por exemplo: '2022-01-25T07:00:00' retornaria todos os logons do Orchestrator em ou antes das 07:00 horas no dia 25 de janeiro de 2022. Todos os datetimes estão em UTC (GMT+0), portanto, talvez você queira usar a ação Converter DateTime para converter sua hora local em UTC.

Retornos

Nome Caminho Tipo Description
JSON do histórico de logon do orchestrator
OrchestratorLoginHistoryJSON string

Uma lista de todos os logons do Orchestrator que atendem aos filtros especificados, no formato JSON.

Número de logons do Orchestrator
NumberOfOrchestratorLogins integer

O número de logons do Orchestrator retornados.

Obter o log do agente de IA-Connect

Retorna o log atual do IA-Connect Agent, como um arquivo ou lendo o conteúdo e retornando-o em uma variável de saída.

Parâmetros

Nome Chave Obrigatório Tipo Description
Comprimir
Compress boolean

A alternativa IA-Connect executável do Agente deve ser compactada durante o upload?

Retornar somente os últimos logs de comando
ReturnLastCommandOnly boolean

O log do agente de IA-Connect deve ser restrito ao resultado do último comando em vez de todo o log?

Salvar log no arquivo
SaveLogToFile boolean

O log do agente de IA-Connect deve ser salvo como um arquivo?

Colocar o conteúdo do log no item de dados
PlaceLogContentInDataItem boolean

O conteúdo do log deve ser retornado em uma variável de saída?

Pasta de salvamento local
LocalSaveFolder string

O caminho de arquivo para a pasta na qual salvar o logon do agente do IA-Connect.

Usar o nome do arquivo de log do Agente
UseAgentLogFilename boolean

O arquivo de log deve receber o mesmo nome que o nome do arquivo de log no Agente? Se definido como false, você poderá definir 'Nome de arquivo de salvamento local' para especificar o nome do arquivo.

Nome do arquivo de salvamento local
LocalSaveFilename string

O nome do arquivo somente do arquivo de salvamento local para o log do agente de IA-Connect. Isso só será usado se 'Usar nome de arquivo de log do Agente' for definido como false.

Máximo de bytes a serem lidos
MaxBytesToRead integer

O número máximo de bytes a serem lidos do log do Agente (do final para trás). Isso pode ser definido como 0 ou -1 para recuperar todo o log.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Conteúdo do log do agente
IAConnectAgentLogContentsBase64 string

O conteúdo do log do agente IA-Connect.

Nome do arquivo de log salvo local
IAConnectAgentLogFilenameOnly string

O caminho para o nome do arquivo de log salvo.

Obter o método de movimentação do mouse

Obtém o método de movimentação do mouse atual.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Método de movimentação do mouse
MouseMoveMethod string

Retorna o método de movimentação do mouse atual (mouse_event ou setcursorpos).

Obter o nome do computador

Retorna o nome do computador que está executando a sessão de usuário do agente IA-Connect.

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 do computador
MachineName string

O nome do computador que está executando a sessão de usuário do agente IA-Connect.

Obter o nome do host do cliente

Retorna o nome do host do cliente em que o IA-Connect Director está em execução.

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 do host do cliente
ClientHostname string

O nome do host do cliente em que o IA-Connect Director está em execução.

Obter o nível de log do Agente IA-Connect

Retorna o nível atual de registro em log do agente de IA-Connect. Os níveis de registro em log são definidos de 1 a 4, sendo 1 o nível mais baixo e 4 sendo o mais alto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nível de log
LoggingLevel integer

O nível de log atual do agente de IA-Connect.

Nome de arquivo de log do agente do IA-Connect
IAConnectAgentLogFilename string

O nome do arquivo de log do agente IA-Connect. Esse valor é exclusivo para cada inicialização do agente de IA-Connect, pois ele tem a data e a hora de inicialização no nome do arquivo.

Obter o nível de log do diretor do IA-Connect

Retorna o nível de log atual do IA-Connect Director. Os níveis de registro em log são definidos de 0 a 4. 0 está desabilitado. 1 é o nível de log mais baixo (e o padrão). 4 é o nível de log mais alto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nível de log
LoggingLevel integer

O nível de log atual do IA-Connect Director.

nome do arquivo de log do IA-Connect Director
IAConnectDirectorLogFilename string

O nome do arquivo de log do IA-Connect Director. Esse valor é exclusivo para cada inicialização, pois tem a data e a hora de inicialização no nome do arquivo.

Obter o processo por ID do processo

Retorna se um processo com a ID do processo especificado está em execução na sessão de usuário do agente IA-Connect. As IDs de processo são exclusivas para que apenas um processo possa corresponder à ID. As IDs do processo são dinâmicas e são diferentes para cada inicialização de um aplicativo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do processo
ProcessId True integer

A ID do processo a ser obtido.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Processo em execução
ProcessRunning boolean

Retorna true se um processo com a ID do processo fornecido foi encontrado.

Obter o status de disponibilidade de trabalho do Orchestrator

Recupere o status básico do Orchestrator. Isso pode ser usado para confirmar se o Orchestrator está disponível e respondendo.

Retornos

Nome Caminho Tipo Description
Número total de trabalhadores
TotalWorkersCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, estejam eles trabalhando ou não.

Número de trabalhadores disponíveis
AvailableWorkersCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, que estão disponíveis para trabalho. Disponível significa que eles estão respondendo, licenciados, não no modo de manutenção, não executando fluxos (automações) no momento. Esse é o número de trabalhadores disponíveis para aceitar novos trabalhos de entrada.

Número de trabalhadores indisponíveis
UnavailableWorkersCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, que não estão disponíveis para o trabalho. Isso é igual ao número total de trabalhadores menos o número de trabalhadores disponíveis.

Número de trabalhadores executando fluxos
WorkersRunningFlowsCount integer

O número de IA-Connect trabalhos definidos no Orchestrator, que estão executando fluxos (automações). Esses trabalhadores não estão disponíveis para o trabalho, porque estão ocupados.

Número de trabalhadores no modo de manutenção
WorkersInMaintenanceModeCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, que estão no modo de manutenção. Esses trabalhadores não estão disponíveis para o trabalho, pois foram configurados manualmente para não aceitarem novos trabalhos.

Número de trabalhadores ativos
LiveWorkersCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, que estão respondendo. Esses trabalhadores podem ou não estar disponíveis para o trabalho, pois podem não ter licença, no modo de maintence ou fluxos em execução (automações).

Número de trabalhadores licenciados
LicensedWorkersCount integer

O número de IA-Connect trabalhadores definidos no Orchestrator, que estão respondendo e licenciados. Um trabalhador licenciado sempre estará respondendo, porque o Orchestrator só conhece o estado licenciado de um trabalhador se o trabalhador estiver respondendo (e, portanto, informando o Orchestrator de seu estado). Se um trabalhador parar de responder, o Orchestrator não o considerará mais licenciado. Esses trabalhadores podem ou não estar disponíveis para o trabalho, pois podem estar no modo maintence ou executando fluxos (automações).

Obter o status do Orchestrator

Recupere o status básico do Orchestrator. Isso pode ser usado para confirmar se o Orchestrator está disponível e respondendo.

Retornos

Nome Caminho Tipo Description
Versão do Orchestrator
OrchestratorVersion string

A versão de software do Orchestrator.

Erros de inicialização do Orchestrator
NumberOfStartupErrors integer

O número de erros de inicialização do Orchestrator.

Tempo de atividade do orchestrator em segundos
UptimeInSeconds integer

O número de segundos que o Orchestrator está executando.

Obter o tamanho do arquivo

Retorna o tamanho (em bytes) de um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
Filename True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Tamanho do arquivo
FileSize integer

O tamanho do arquivo, em bytes.

Obter o tempo de atividade do diretor de IA-Connect

Retorna o tempo de atividade deste IA-Connect Director em segundos (ou seja, quanto tempo o Diretor está em execução).

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Tempo de atividade do diretor em segundos
UpTimeInSeconds integer

O número de segundos em que o IA-Connect Director está em execução.

Obter operação de tarefa de automação do Orchestrator

Recupera uma tarefa específica de automação do Orchestrator, fornecendo a ID de operação de tarefa exclusiva.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da operação
OperationId True string

A ID da Operação da tarefa Orchestrator que você deseja recuperar.

Retornos

Nome Caminho Tipo Description
Nome da automação
AutomationName string

O nome da tarefa Orchestrator recuperada.

Data e hora do adiamento
DeferralDateTime string

A data e a hora em que a tarefa Orchestrator recuperada está agendada para estar pronta. Isso será retornado como uma cadeia de caracteres em UTC.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais armazenados quando a tarefa foi adiada. Geralmente, são dados que você precisa para continuar o processo/fluxo.

Contagem de adiamentos
DeferralCount integer

Com que frequência essa tarefa foi adiada. Isso normalmente será 0 para uma nova tarefa que nunca foi adiada ou 1 ou mais para uma tarefa adiada. Sempre que uma tarefa adiada for adiada novamente, o Orchestrator aumentará automaticamente esse número.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais armazenados quando a tarefa foi criada. Geralmente, são dados usados para iniciar o processo/fluxo, mas você pode usar esse campo para qualquer finalidade. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Dados de saída da tarefa
TaskOutputData string

Dados opcionais armazenados, pela automação, quando a tarefa foi processada. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Priority
Priority integer

O nível de prioridade dessa tarefa orchestrator (1 sendo o nível mais alto).

Status da tarefa de automação
AutomationTaskStatus string

O status da tarefa Orchestrator recuperada.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo continue no estágio 'Exchange' quando ele continuar após o adiamento, insira o valor 'Exchange'.

Data e hora recebidas
ReceivedDateTime string

A data e a hora em que a tarefa foi recebida inicialmente pelo Orchestrator. Isso será retornado como uma cadeia de caracteres em UTC.

Minutos até a data de adiamento
MinutesUntilDeferralDate integer

O número de minutos até a data de adiamento dessa tarefa (ou seja, quando essa tarefa estiver pronta para ser executada). Se essa tarefa estiver pronta para executar os minutos será 0.

Em espera
OnHold boolean

Será definido como true se a tarefa estiver em espera. Uma tarefa em espera nunca será recuperada pela ação "Obter a próxima tarefa de automação do Orchestrator" e, portanto, não será processada em um fluxo de trabalho de tarefa típico.

Organização
Organisation string

A organização à qual esta tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

O departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

A descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Obter pastas

Retorna todas as subpastas dentro de uma pasta especificada no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do diretório
DirectoryPath True string

O caminho completo para o diretório (pasta). Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
JSON de pastas
FoldersJSON string

Uma lista de subpastas contidas na pasta, no formato JSON.

Número de pastas lidas com êxito
NumberOfFoldersReadSuccessfully integer

O número de subpastas que foram lidas com êxito.

Falha na leitura do número de pastas
NumberOfFoldersFailedToRead integer

O número de subpastas que não puderam ser lidas.

Obter permissões de segurança de arquivo

Retorna uma lista de permissões definidas atualmente em um arquivo no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
FilePath True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Permissões de segurança JSON
SecurityPermissionsJSON string

As permissões atualmente definidas no arquivo especificado, no formato JSON.

Obter permissões de segurança de pasta

Retorna uma lista de permissões definidas atualmente em uma pasta no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Permissões de segurança JSON
SecurityPermissionsJSON string

As permissões definidas atualmente na pasta especificada, no formato JSON.

Obter processos

Retorna uma lista de processos em execução na sessão de usuário do agente do IA-Connect. Opcionalmente, isso pode ser filtrado fornecendo um nome de processo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo
ProcessName string

Um filtro opcional para o nome do processo.

Obter a linha de comando do processo
GetProcessCommandLine boolean

Se definido como true, os detalhes da linha de comando do processo serão retornados.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de processos
NumberOfProcesses integer

O número de processos em execução na sessão do usuário.

Processos JSON
ProcessesJSON string

A lista de processos em execução na sessão do usuário, no formato JSON.

Obter propriedades da linha de comando da ID do processo

Retorna as propriedades da linha de comando para qualquer processo em execução na sessão de usuário do agente IA-Connect que tem a ID do processo especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do processo
ProcessId True integer

A ID do processo do qual recuperar as propriedades da linha de comando.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Processar linha de comando
ProcessCommandLine string

As propriedades da linha de comando para o processo.

Argumentos do processo
ProcessArguments string

Os argumentos que foram usados ao iniciar o processo.

Processar o diretório de trabalho atual
ProcessCurrentWorkingDirectory string

O diretório de trabalho atual do processo.

Nome do caminho da imagem do processo
ProcessImagePathName string

O caminho para o executável que iniciou o processo.

Obter resolução de tela

Retorna a resolução de tela da sessão de usuário do agente IA-Connect. Para o agente IA-Connect local em execução em uma área de trabalho física ou laptop, isso fornecerá informações sobre todos os dispositivos de exibição e seu dimensionamento. Em uma máquina virtual, normalmente apenas uma exibição será relatada, a menos que a máquina virtual tenha sido configurada para apresentar várias exibições (incomum). Em uma sessão remota, normalmente apenas uma exibição será relatada, mesmo se essa exibição abranger várias exibições locais, já que sessões remotas geralmente criam uma única exibição virtual.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resolução horizontal
HorizontalResolution integer

A resolução física horizontal da tela primária. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Resolução vertical
VerticalResolution integer

A resolução física vertical da tela primária. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Número de telas
NumberOfScreens integer

O número de telas nesta sessão.

Resolução horizontal de segunda exibição
SecondDisplayHorizontalResolution integer

A resolução física horizontal da segunda tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Resolução vertical de segunda exibição
SecondDisplayVerticalResolution integer

A resolução física vertical da segunda tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Terceira resolução horizontal de exibição
ThirdDisplayHorizontalResolution integer

A resolução física horizontal da terceira tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Terceira resolução vertical de exibição
ThirdDisplayVerticalResolution integer

A resolução física vertical da terceira tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Quarta resolução horizontal de exibição
FourthDisplayHorizontalResolution integer

A resolução física horizontal da quarta tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Quarta resolução vertical de exibição
FourthDisplayVerticalResolution integer

A resolução física vertical da quarta tela, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de borda esquerda da tela virtual
VirtualScreenLeftEdgePixels integer

A borda esquerda de toda a exibição virtual (todas as exibições detectadas). As coordenadas virtuais são dimensionadas por DPI.

Pixels de borda superior da tela virtual
VirtualScreenTopEdgePixels integer

A borda superior de toda a exibição virtual (todas as exibições detectadas). As coordenadas virtuais são dimensionadas por DPI.

Pixels de largura de tela virtual
VirtualScreenWidthPixels integer

A largura de toda a exibição virtual (todas as exibições detectadas). As coordenadas virtuais são dimensionadas por DPI.

Pixels de altura da tela virtual
VirtualScreenHeightPixels integer

A altura de toda a exibição virtual (todas as exibições detectadas). As coordenadas virtuais são dimensionadas por DPI.

Dimensionamento de exibição primário
PrimaryDisplayScaling double

O multiplicador de dimensionamento de DPI da exibição primária como uma decimal. Por exemplo: 100% seriam retornados como 1,0 e 125% seriam retornados como 1,25.

Dimensionamento da segunda exibição
SecondDisplayScaling double

O multiplicador de dimensionamento de DPI da segunda exibição como uma decimal. Por exemplo: 100% seriam retornados como 1,0 e 125% seriam retornados como 1,25.

Terceiro dimensionamento de exibição
ThirdDisplayScaling double

O multiplicador de dimensionamento de DPI da terceira exibição como uma decimal. Por exemplo: 100% seriam retornados como 1,0 e 125% seriam retornados como 1,25.

Dimensionamento da quarta exibição
FourthDisplayScaling double

O multiplicador de dimensionamento de DPI da quarta exibição como uma decimal. Por exemplo: 100% seriam retornados como 1,0 e 125% seriam retornados como 1,25.

Pixels de borda esquerda da tela física
PhysicalScreenLeftEdgePixels integer

A borda esquerda de toda a exibição física (todas as exibições detectadas). As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de borda superior da tela física
PhysicalScreenTopEdgePixels integer

A borda superior de toda a exibição física (todas as exibições detectadas). As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de largura de tela física
PhysicalScreenWidthPixels integer

A largura de toda a exibição física (todas as exibições detectadas). As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de altura da tela física
PhysicalScreenHeightPixels integer

A altura de toda a exibição física (todas as exibições detectadas). As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de borda esquerda de exibição primária
PrimaryDisplayLeftEdgePixels integer

A borda física esquerda da exibição primária. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Pixels de borda superior de exibição primária
PrimaryDisplayTopEdgePixels integer

A borda física superior da exibição primária. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Segundo pixels de borda esquerda de exibição
SecondDisplayLeftEdgePixels integer

A borda física esquerda da segunda exibição, se for detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Segundo pixels de borda superior de exibição
SecondDisplayTopEdgePixels integer

A borda física superior da segunda exibição, se for detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Terceiro pixels de borda esquerda de exibição
ThirdDisplayLeftEdgePixels integer

A borda física esquerda da terceira exibição, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Terceiro pixels de borda superior de exibição
ThirdDisplayTopEdgePixels integer

A borda física superior da terceira exibição, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Quarta exibição de pixels de borda esquerda
FourthDisplayLeftEdgePixels integer

A borda física esquerda da quarta exibição, se for detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Quarto pixels de borda superior de exibição
FourthDisplayTopEdgePixels integer

A borda física superior da quarta exibição, se uma tiver sido detectada. As coordenadas físicas são mapeadas diretamente para pixels no monitor.

Obter senha armazenada

Recupera uma senha gerada ou armazenada anteriormente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de senha
PasswordIdentifier string

O identificador da senha armazenada. Essas senhas são armazenadas apenas na memória e são perdidas quando o Agente é fechado. Por exemplo: MyExchangePassword.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Senha de texto sem formatação
PlainTextPassword string

A senha em texto sem formatação. A senha poderá ser necessária em texto sem formatação se a senha for uma senha única destinada a ser transmitida via SMS ou email (por exemplo) e, portanto, precisar ser vista as-is.

Obter sessões de IA-Connect disponíveis

Recupera uma lista de sessões IA-Connect Director (conexões disponíveis para sessões em que o agente IA-Connect está em execução, como local, Microsoft RDP ou Citrix ICA).

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
IA-Connect sessões JSON
IAConnectSessionsJSON string

Uma lista de todas as sessões IA-Connect, formatadas como JSON.

Número de sessões de IA-Connect
NumberOfIAConnectSessions integer

O número total de sessões IA-Connect abertas.

Número de sessões de IA-Connect locais
NumberOfLocalIAConnectSessions integer

O número de sessões de IA-Connect locais que estão abertas.

Número de sessões de IA-Connect do Citrix ICA
NumberOfCitrixICAIAConnectSessions integer

O número de sessões de IA-Connect do Citrix ICA que estão abertas.

Número de sessões de IA-Connect do Microsoft RDP
NumberOfMicrosoftRDPIAConnectSessions integer

O número de sessões de IA-Connect do Microsoft RDP que estão abertas.

Obter tarefa de automação do Orchestrator

Recupera uma tarefa específica de automação do Orchestrator.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
TaskId True integer

A ID da tarefa Orchestrator que você deseja recuperar.

Alterar o status para
StatusChange string

Se definido como 'Recuperado': ao recuperar uma tarefa, o status da tarefa será alterado para 'Recuperado' para impedir que outras ações tentem executar a mesma tarefa. Se definido como "Não fazer nada", o status da tarefa não será alterado.

Retornos

Nome Caminho Tipo Description
Nome da automação
AutomationName string

O nome da tarefa Orchestrator recuperada.

ID da operação
OperationId string

A ID da Operação da tarefa Orchestrator recuperada. Essa ID da Operação (ou a ID da tarefa) pode ser usada para recuperar a tarefa em uma data posterior. A ID da Operação é uma cadeia de caracteres exclusiva e indisponível, limitando a capacidade de um terceiro adivinhar a ID de uma operação que eles não criaram.

Data e hora do adiamento
DeferralDateTime string

A data e a hora em que a tarefa Orchestrator recuperada está agendada para estar pronta. Isso será retornado como uma cadeia de caracteres em UTC.

Dados armazenados de adiamento
DeferralStoredData string

Dados opcionais armazenados quando a tarefa foi adiada. Geralmente, são dados que você precisa para continuar o processo/fluxo.

Contagem de adiamentos
DeferralCount integer

Com que frequência essa tarefa foi adiada. Isso normalmente será 0 para uma nova tarefa que nunca foi adiada ou 1 ou mais para uma tarefa adiada. Sempre que uma tarefa adiada for adiada novamente, o Orchestrator aumentará automaticamente esse número.

Dados de entrada da tarefa
TaskInputData string

Dados opcionais armazenados quando a tarefa foi criada. Geralmente, são dados usados para iniciar o processo/fluxo, mas você pode usar esse campo para qualquer finalidade. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Dados de saída da tarefa
TaskOutputData string

Dados opcionais armazenados, pela automação, quando a tarefa foi processada. Isso pode ser formatado como qualquer formato de texto de sua escolha, por exemplo, JSON ou XML ou texto bruto.

Priority
Priority integer

O nível de prioridade dessa tarefa orchestrator (1 sendo o nível mais alto).

Status da tarefa de automação
AutomationTaskStatus string

O status da tarefa Orchestrator recuperada.

Estágio do processo
ProcessStage string

O ponto em que o processo/fluxo de automação deve continuar após o adiamento. Esse é um valor de cadeia de caracteres opcional que será exclusivo para o processo/fluxo específico. Isso será usado por uma condição dentro do processo/fluxo adiado para decidir qual etapa executar em seguida. Por exemplo: se você quiser que o processo/fluxo continue no estágio 'Exchange' quando ele continuar após o adiamento, insira o valor 'Exchange'.

Data e hora recebidas
ReceivedDateTime string

A data e a hora em que a tarefa foi recebida inicialmente pelo Orchestrator. Isso será retornado como uma cadeia de caracteres em UTC.

Minutos até a data de adiamento
MinutesUntilDeferralDate integer

O número de minutos até a data de adiamento dessa tarefa (ou seja, quando essa tarefa estiver pronta para ser executada). Se essa tarefa estiver pronta para executar os minutos será 0.

Em espera
OnHold boolean

Será definido como true se a tarefa estiver em espera. Uma tarefa em espera nunca será recuperada pela ação "Obter a próxima tarefa de automação do Orchestrator" e, portanto, não será processada em um fluxo de trabalho de tarefa típico.

Nome do tipo de origem
SourceTypeName string

O nome da origem da tarefa. A 'interface do usuário da Web' representa uma tarefa inserida manualmente por meio da interface do usuário. A 'API REST' representa uma tarefa criada por meio da API REST do Orchestrator. 'ServiceNow' representa uma tarefa criada a partir da integração interna do ServiceNow 'Sources' do Orchestrator.

Nome amigável da origem
SourceFriendlyName string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém o nome amigável dessa origem.

ID do tíquete de origem
SourceTicketId string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém a ID do tíquete de origem. Para o ServiceNow, isso manteria a tarefa de catálogo sys_id.

Sub-ID do tíquete de origem
SourceTicketSubId string

Se a tarefa foi criada a partir de uma integração interna de 'Sources' do Orchestrator (por exemplo, ServiceNow), isso contém a ID do tíquete de origem. Para o ServiceNow, isso manteria o item de solicitação sys_id.

Organização
Organisation string

A organização à qual esta tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Departamento
Department string

O departamento ao qual essa tarefa está associada. Normalmente usado para tarefas de pesquisa e filtragem.

Description
Description string

A descrição dessa tarefa. Normalmente usado para tarefas de pesquisa e filtragem.

Etiquetas
Tags string

Uma lista opcional de uma ou mais marcas atribuídas a essa tarefa. Normalmente usado para categorizar uma tarefa para pesquisa e filtragem. Não diferencia maiúsculas de minúsculas. Um por linha.

Obter texto CSV como coleção

Retorna um arquivo CSV no computador em que o agente de IA-Connect está em execução como uma coleção (tabela). Requer apenas acesso de leitura ao arquivo CSV.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo CSV
CSVFilePath True string

O caminho completo para o arquivo CSV. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

A primeira linha é o cabeçalho
FirstLineIsHeader boolean

A primeira linha no arquivo CSV é uma linha de cabeçalho?

Cortar cabeçalhos
TrimHeaders boolean

Os cabeçalhos devem ser cortados para remover qualquer espaço em branco à esquerda ou à direita?

Permitir linhas em branco
AllowBlankRows boolean

Se definido como true (o padrão), linhas completamente em branco nos dados CSV são permitidas e serão retornadas como uma linha vazia. Se definido como false, linhas completamente em branco serão removidas nos dados retornados (o arquivo será deixado intocado).

Estender colunas se necessário
ExtendColumnsIfRequired boolean

Se definido como true e se houver células nos dados sem um cabeçalho de coluna correspondente (ou seja, uma linha com mais células do que a linha de cabeçalho), um cabeçalho de coluna será criado automaticamente com o nome Column_N (em que N é o índice de coluna). Se definido como false (o padrão), haverá uma exceção se uma linha contiver dados sem uma coluna correspondente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
JSON de dados CSV
CSVDataJSON string

O conteúdo do arquivo CSV, no formato JSON.

Obter threads do Agente

Retorna uma lista de threads do Agente. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações. Normalmente, depois que um thread do Agent for concluído e seus dados recuperados, o thread do Agente será excluído e não aparecerá na lista de threads.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ordem de classificação
SortOrder string

A ordem de classificação para a lista de saída de threads do Agente. Os pedidos de classificação com suporte são 'None', 'ThreadStartTime', 'ThreadStartTime_Desc', 'ThreadEndTime', 'ThreadEndTime_Desc', 'ThreadId', 'ThreadId_Desc', 'ThreadActionName', 'ThreadActionName_Desc', 'ThreadRuntime', 'ThreadRuntime_Desc'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Número de threads do Agente
NumberOfAgentThreads integer

O número de threads do Agente que ainda estão em execução ou disponíveis para recuperação. Normalmente, depois que um thread do Agent for concluído e seus dados recuperados, o thread do Agente será excluído e não aparecerá na lista de threads.

Threads do agente
AgentThreads array of object

A lista de threads do Agente e todas as informações de thread disponíveis (exceto os dados internos do thread).

ThreadId
AgentThreads.ThreadId integer
IAConnectActionName
AgentThreads.IAConnectActionName string
ThreadStartDateTimeUTC
AgentThreads.ThreadStartDateTimeUTC date-time
ThreadCompletedDateTimeUTC
AgentThreads.ThreadCompletedDateTimeUTC date-time
ThreadRuntimeInSeconds
AgentThreads.ThreadRuntimeInSeconds integer
ThreadStarted
AgentThreads.ThreadStarted boolean
ThreadRunning
AgentThreads.ThreadRunning boolean
ThreadCompleted
AgentThreads.ThreadCompleted boolean
ThreadSuccess
AgentThreads.ThreadSuccess boolean
ThreadStatusMessage
AgentThreads.ThreadStatusMessage string
ThreadErrorMessage
AgentThreads.ThreadErrorMessage string

Obter todas as estatísticas de comando IA-Connect

Retorna todas as estatísticas armazenadas no momento nas quais os comandos do agente IA-Connect foram executados na sessão atual.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
JSON de estatísticas de comando
CommandStatsJSON string

A lista de comandos executados pelo agente IA-Connect na sessão atual, no formato JSON. Essa lista conterá o nome de cada ação e o número de vezes que ela foi executada.

Obter todas as tarefas de automação do Orchestrator

Recupera todas as tarefas de automação do Orchestrator que correspondem aos filtros.

Parâmetros

Nome Chave Obrigatório Tipo Description
Filtro de nome de automação
AutomationName string

Insira um valor para recuperar apenas tarefas com esse nome de automação. Deixe em branco para retornar tarefas de automação do Orchestrator com qualquer nome (ou seja, desabilite esse filtro).

Filtro de status da tarefa de automação
AutomationTaskStatus string

Filtre as tarefas de automação pelo status da tarefa de automação especificada. Deixe o campo em branco para retornar todos os status da tarefa de automação (ou seja, desabilite esse filtro).

Filtrar por consulta de propriedade
FilterByPropertyQuery string

Filtre as tarefas de automação usando uma cadeia de caracteres de consulta. Isso é idêntico à entrada "Filtrar por propriedade" na interface do usuário das tarefas do Orchestrator. Deixe o campo em branco para não filtrar por propriedade (ou seja, desabilite esse filtro). Um filtro de pesquisa deve estar no formato "valor da condição da propriedade". Há suporte apenas para um único filtro de pesquisa (você não pode usar e ou). As propriedades com suporte são: name, org, dept, tags, stage, ticketid. As condições com suporte são iguais, contêm, não são iguais, não contêm. Por exemplo: Nome é igual a Novos iniciantes, Nome contém starter, Org not equals Acme, Dept contains sales.

Minutos até a data de adiamento
MinutesUntilDeferralDate integer

Retorne somente as tarefas de automação do Orchestrator que estão prontas para serem executadas dentro do número de minutos especificado. Defina como 0 se você quiser apenas tarefas de automação que estão prontas para serem executadas agora. Deixe em branco se você quiser recuperar tarefas independentemente do adiamento.

Nível mínimo de prioridade
MinimumPriorityLevel integer

Retorne somente as tarefas de automação do Orchestrator que têm o nível de prioridade especificado ou superior. Por exemplo: a configuração 2 retornará tarefas com um nível de prioridade de 1 e 2.

Classificar por data de adiamento
SortByDeferralDate boolean

Defina como true para retornar os dados classificados pela data e hora do adiamento. Defina como false para que os dados retornados na ordem sejam armazenados.

Recuperar tarefas em espera
RetrieveOnHoldTasks boolean

Se definido como true (o padrão, para compatibilidade com versões anteriores), as tarefas serão recuperadas mesmo se estiverem em espera. Se definido como false, as tarefas em espera não serão recuperadas.

Ignorar
Skip integer

Se recuperar muitas centenas de resultados, você poderá usar Skip e MaxResults para recuperar um bloco de resultados. Skip especifica quantos resultados devem ser ignoradas antes de retornar o primeiro item no bloco. A configuração Ignorar para 0 retorna os resultados desde o início.

Resultados máximos
MaxResults integer

Se recuperar muitas centenas de resultados, você poderá usar Skip e MaxResults para recuperar um bloco de resultados. MaxResults especifica o número máximo de resultados a serem retornados ou 0 para retornar todos os resultados, depois de processar a entrada Skip.

Excluir dados da tarefa
ExcludeTaskData boolean

Se definido como true, as propriedades de dados da tarefa (TaskData, DeferralStoredData, TaskOutputData) não serão retornadas na resposta. Isso pode reduzir significativamente o tamanho da resposta se suas tarefas tiverem muitos dados armazenados.

Retornos

Nome Caminho Tipo Description
Tarefas de Automação
AutomationTasks array of object

Um datatable que contém todas as tarefas de automação do Orchestrator que atendem aos critérios de pesquisa especificados. Datatables são um formato de dados .NET comum, mas armazenam nulos como DbNull. O módulo IA-Connect PowerShell resolve isso convertendo a maioria das cadeias de caracteres DbNull em ''. As respostas de datetime do Orchestrator estarão no formato de cadeia de caracteres.

items
AutomationTasks object
Número de tarefas de automação
NumberOfAutomationTasks integer

O número de tarefas de automação retornadas.

Obter trabalho do Orchestrator

Recupere detalhes e status ao vivo de um trabalho individual registrado no Orquestrador IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do trabalho de pesquisa
SearchWorkerId integer

A ID do trabalho a ser recuperado. Defina como um valor igual a 1 ou superior, para recuperar os detalhes de um trabalho com essa ID específica. Defina como 0, se você não quiser recuperar um trabalho por Id.

Nome do trabalho de pesquisa
SearchWorkerName string

O nome do trabalho a ser recuperado. Defina como em branco ou nulo se você não quiser recuperar um trabalho por nome.

Retornos

Nome Caminho Tipo Description
ID do trabalho
WorkerId integer

A ID interna do Orchestrator para este trabalho.

Nome do Trabalho
WorkerName string

O nome interno do Orchestrator para este trabalho.

Descrição do trabalho
WorkerDescription string

A descrição interna do Orchestrator para este trabalho.

Nome de exibição do fluxo atual
CurrentFlowDisplayName string

O nome de exibição do fluxo que está sendo processado por esse trabalho ou em branco se o trabalho estiver ocioso.

Status ao vivo do trabalho
LiveStatus boolean

True, se o trabalhador estiver conectado ao Orchestrator e respondendo às pesquisas. False, se o trabalho não estiver conectado.

Últimos tiques de contato
LiveStatusLastContactTicks integer

A hora, em escalas, quando o Orchestrator teve contato pela última vez com o trabalhador. Esse é o número de intervalos de 100 nanossegundos decorridos desde 12:00:00 meia-noite, 1º de janeiro de 0001 UTC. Esse é um formato de tempo comum, universal.

Segundos desde o último contato
SecondsSinceLastContact integer

O tempo, em segundos, que passou desde a última vez que o Orchestrator teve contato com o trabalhador. Isso representa o mesmo ponto no tempo que "Tiques de último contato", mas expresso em segundos relativos.

Trabalho no modo de manutenção
MaintenanceMode boolean

True, se o trabalho estiver atualmente no modo de manutenção. False, se o trabalho não estiver no modo de manutenção.

Prioridade de trabalho
Priority integer

Um valor inteiro igual a 1 ou superior, que representa a prioridade atribuída ao trabalhador. A prioridade 1 é a prioridade mais alta. Os fluxos serão enviados para um trabalhador disponível com a prioridade mais alta. Vários trabalhadores podem ter a mesma prioridade e o Orchestrator usará o "método de balanceamento de carga de trabalho" (consulte 'Configurações do site') para escolher um trabalho disponível.

Tempo limite do trabalho em segundos
TimeoutInSeconds integer

Por quanto tempo em segundos o Orchestrator deve aguardar uma resposta da API REST do diretor do IA-Connect antes do tempo limite.

O trabalho está licenciado
AgentIsLicensed boolean

True, se o trabalho estiver licenciado no momento. False, se o trabalhador não estiver licenciado. Nulo, se o Orchestrator não souber se o trabalhador está licenciado (talvez não esteja respondendo, pode ser um agente muito antigo que não fornece atualizações de licenciamento ao vivo na pesquisa).

Recursos de licença do agente
AgentLicenseFeatures string

Recursos específicos de licença do Agente. Por exemplo: JML para a licença Joiner, Mover, Leaver.

O trabalho está disponível para o trabalho
IsAvailableForWork boolean

True, se o trabalho estiver disponível para o trabalho, o que significa que o trabalhador pode aceitar o trabalho de entrada. False, se o trabalho não for. Disponível para trabalho é determinado por a) O status do trabalho está ativo, b) É o trabalhador no modo de manutenção, c) É o trabalhador licenciado, d) É o trabalhador que está processando um fluxo no momento.

ID do tipo de conexão de trabalho
WorkerConnectionTypeId integer

A ID do tipo de conexão de trabalho configurado, usado para conectar o trabalho ao Orchestrator. Isso pode ser 1 para 'Retransmissão do WCF do Azure', 2 para 'Conexão Híbrida do Azure', 3 para 'Rede Virtual do Azure (VNet)', 4 para 'Direct'.

Nome do tipo de conexão de trabalho
WorkerConnectionTypeName string

O nome do tipo de conexão de trabalho configurado, usado para conectar o trabalho ao Orchestrator. Isso pode ser AzureWCFRelay, AzureHybridConnection, AzureVNet, Direct.

URL da API REST do Diretor
DirectorRestApiUrl string

Se o tipo de conexão configurado for conexões híbridas, VNet ou diretas, essa propriedade conterá a URL da API REST de trabalho, que geralmente é HTTP porque o tráfego HTTP é criptografado dentro de um túnel HTTPS (por exemplo, conexão híbrida ou gateway de dados local). Se o tipo de conexão configurado for retransmissão do WCF do Azure, essa propriedade conterá a URL de retransmissão do WCF.

Namespace do Barramento de Serviço do Azure
AzureServiceBusNamespace string

Se o tipo de conexão configurado for Retransmissão do WCF do Azure, ele conterá o namespace do Barramento de Serviço do Azure.

Nome da retransmissão do WCF do Azure
AzureWCFRelayName string

Se o tipo de conexão configurado for Retransmissão do WCF do Azure, essa propriedade conterá o nome da retransmissão do WCF do Azure.

Nome do tipo de conexão do agente
IAConnectAgentConnectionTypeName string

O nome do tipo de conexão do Agente. Isso pode ser "Agente Local", "Citrix ICA" ou "Microsoft RDP".

Anexado ao diretor de próximo salto
AttachedToNextHopDirector boolean

Se o Diretor conectado ao Orchestrator (geralmente o Diretor hospedado pelo Agente local) estiver encaminhando ações para um diretor de próximo salto (geralmente um Citrix ICA ou Microsoft RDP Director), essa propriedade será definida como True. Se o Diretor estiver enviando ações diretamente ao Agente ao qual está conectado (geralmente o Agente local), essa propriedade será definida como False.

Tipo de sessão do diretor de próximo salto
NextHopDirectorSessionType string

Se o Diretor conectado ao Orchestrator (geralmente o Diretor hospedado pelo Agente local) estiver encaminhando ações para um diretor de próximo salto (geralmente um Citrix ICA ou Microsoft RDP Director), essa propriedade conterá o nome do tipo de conexão, que será 'Citrix ICA' ou 'Microsoft RDP'.

Versão do diretor
DirectorVersion string

A versão interna do IA-Connect Director, que processa a interface da API REST e fornece o Inspetor de IA-Connect, para o agente IA-Connect, que está em execução no trabalho IA-Connect.

Versão do agente
AgentVersion string

A versão interna do agente IA-Connect, que está em execução no trabalho IA-Connect.

Versão do lançamento do diretor
DirectorReleaseVersion double

O IA-Connect versão de versão do IA-Connect Director, que processa a interface da API REST e fornece o Inspetor de IA-Connect, para o agente IA-Connect, que está em execução no trabalho IA-Connect.

Versão de versão do agente
AgentReleaseVersion double

A versão de versão IA-Connect do agente IA-Connect, que está em execução no trabalho IA-Connect.

Nome do host do diretor
DirectorHostname string

O nome do host do sistema operacional que hospeda o IA-Connect Director. Esse é o nome do host do trabalho, que geralmente é o mesmo que o nome do trabalho.

Nome de domínio netbios do diretor
DirectorNetBIOSDomainName string

O nome de domínio NETBIOS do Sistema Operacional que hospeda o IA-Connect Director, que é um componente do agente IA-Connect, em execução no IA-Connect trabalho. Para um grupo de trabalho, geralmente esse é o nome do host de trabalho. Para um domínio do Active Directory, esse é o nome netBIOS do domínio. Por exemplo: MYDOMAIN.

Nome de domínio DNS do diretor
DirectorDNSDomainName string

O nome de domínio DNS do Sistema Operacional que hospeda o IA-Connect Director, que é um componente do agente IA-Connect, em execução no trabalho IA-Connect. Para um grupo de trabalho, isso geralmente está em branco. Para um domínio do Active Directory, esse é o nome DNS do domínio. Por exemplo: mydomain.local.

Número de IDs de ambiente de fluxo com suporte
SupportedFlowEnvironmentIdsCount integer

Se o trabalho estiver configurado apenas para processar fluxos de IDs de ambiente de fluxo especificadas, essa propriedade manterá o número de IDs de ambiente de fluxo com suporte na lista. Se o trabalho puder processar fluxos de qualquer ambiente, essa propriedade será mantida como 0.

Número de nomes de fluxo com suporte
SupportedFlowNamesCount integer

Se o trabalho estiver configurado apenas para processar fluxos com nomes específicos, essa propriedade manterá o número de nomes de fluxo com suporte na lista. Se o trabalho puder processar fluxos com qualquer nome, essa propriedade será mantida como 0.

Número de nomes de fluxo sem suporte
UnsupportedFlowNamesCount integer

Se o trabalho estiver configurado para recusar o processamento de fluxos com nomes específicos, essa propriedade manterá o número de nomes de fluxo sem suporte na lista. Se o trabalho não estiver configurado para recusar fluxos específicos, essa propriedade será mantida como 0.

Número de marcas de trabalho
WorkerTagsCount integer

Se o trabalho estiver configurado com algumas marcas, essa propriedade armazenará o número de marcas na lista. Se o trabalhador não tiver marcas, essa propriedade será mantida como 0.

Número de marcas obrigatórias de trabalho
WorkerMandatoryTagsCount integer

Se o trabalho estiver configurado com algumas marcas obrigatórias, essa propriedade armazenará o número de marcas obrigatórias na lista. Se o trabalhador não tiver marcas obrigatórias, essa propriedade será mantida como 0.

Obter área de transferência

Obtém o conteúdo atual da área de transferência na sessão de usuário do agente do IA-Connect.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Dados da área de transferência
ClipboardData string

Os dados contidos na área de transferência.

Parar de manter a sessão ativa

Interrompe a sessão de usuário do agente do IA-Connect manter-se ativa.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
StopKeepSessionAliveResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Recuperar o status de um thread do Agente

Recupera o status de um thread do Agente e, opcionalmente, recupera os dados de saída do thread. Um thread do Agent pode ser usado para executar determinadas ações em um thread, permitindo que as ações sejam executadas por um longo tempo (maior que o tempo limite do RPA) ou para serem executadas em paralelo com outras ações.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread Id
ThreadId True integer

Se você executou anteriormente uma ação do Agente como um thread, forneça a ID do thread para recuperar o status do thread. Essa ID de thread terá sido fornecida como uma saída da execução anterior da ação como um thread.

Recuperar dados de saída de thread
RetrieveThreadOutputData boolean

Defina como true para recuperar os dados de saída do thread no formato JSON. É recomendável recuperar dados de saída de thread chamando a mesma ação usada para criar o thread, definindo a entrada 'Recuperar dados de saída para id de thread' para a ID do thread, mas essa opção permite que você recupere diretamente os dados de saída do thread e, opcionalmente, não exclua os dados.

Excluir thread após os dados de saída recuperados
ClearOutputDataFromMemoryOnceRead boolean

Se o thread tiver sido concluído com êxito e os dados de saída forem recuperados (consulte a entrada 'Recuperar dados de saída do thread'), defina essa entrada como true para excluir o thread após o retorno dos resultados. Isso excluirá os dados de saída do thread e o thread em si, portanto, você não poderá consultar o thread novamente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O thread foi iniciado
ThreadStarted boolean

True se o thread tiver sido iniciado. False se o thread ainda não foi iniciado, o que sugere que algo deu errado desde que o thread é iniciado imediatamente.

O thread está em execução
ThreadRunning boolean

True se o thread estiver em execução no momento. False se o thread nunca foi iniciado (altamente improvável) ou se o thread já foi concluído.

O thread foi concluído
ThreadCompleted boolean

True se o thread tiver sido concluído. False se o thread nunca tiver sido iniciado (altamente improvável) ou se o thread ainda estiver em execução.

Thread bem-sucedido
ThreadSuccess boolean

True se o thread tiver sido concluído com êxito. False se o thread nunca tiver sido iniciado (altamente improvável), o thread ainda estará em execução ou se o thread falhou.

Runtime do thread em segundos
ThreadRuntimeInSeconds integer

O número total de segundos em que o thread foi executado.

IA-Connect nome da ação
IAConnectActionName string

O nome interno da ação IA-Connect Agent que está sendo executada como um thread.

Mensagem de status do thread
ThreadStatusMessage string

Uma cadeia de caracteres de texto que descreve o status do thread. Essa mensagem é calculada com base nas propriedades ThreadStarted, ThreadRunning, ThreadCompleted, ThreadSuccess. Essa cadeia de caracteres de texto é independente de linguagem (ela não será alterada para corresponder à localidade).

Mensagem de erro de thread
ThreadErrorMessage string

Se o thread tiver falhado, essa saída conterá a mensagem de erro.

JSON de dados de saída de thread
ThreadOutputJSON string

Se 'Recuperar dados de saída de thread' for definido como true, essa saída manterá os dados de saída de thread brutos no formato JSON.

Redefinir configurações do próximo salto IA-Connect Director

Redefine as configurações personalizadas do IA-Connect Director que foram definidas, restaurando as configurações padrão.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Redefinir estatísticas de comando IA-Connect

Redefine todas as estatísticas armazenadas no momento nas quais os comandos do agente IA-Connect foram executados na sessão atual.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Remover identidade da segurança da pasta

Remove uma identidade (por exemplo, um usuário, grupo ou computador) das permissões de segurança em uma pasta no computador em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
FolderPath True string

O caminho completo para a pasta. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade a ser removida
IdentityToRemove True string

A identidade do usuário ou grupo a ser removido. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
A permissão foi removida
PermissionWasRemoved boolean

Retorna true se a permissão foi removida com êxito.

Remover identidade da segurança do arquivo

Remove uma identidade (por exemplo, usuário, grupo ou computador) das permissões de segurança em um arquivo no computador em que o agente IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo
FilePath True string

O caminho completo para o arquivo. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Identidade a ser removida
IdentityToRemove True string

A identidade do usuário ou grupo a ser removido. Isso pode estar no formato 'username', 'DOMAIN\username' ou 'username@domainfqdn'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
A permissão foi removida
PermissionWasRemoved boolean

Retorna true se a permissão foi removida com êxito.

Segurar o mouse à direita na coordenada

Mantém o botão direito do mouse nas coordenadas especificadas na sessão de usuário do agente IA-Connect para a quantidade especificada de segundos. A API de movimento do mouse atualmente ativa (mouse_event ou setcursorpos) é usada para mover o mouse. O dimensionamento de DPI e várias exibições são levados em conta ao calcular coordenadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Pixels X
XCoord True integer

O valor da coordenada X (em pixels).

Pixels Y
YCoord True integer

O valor da coordenada Y (em pixels).

Segundos para segurar
SecondsToHold True double

O número de segundos para segurar o botão direito do mouse.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Sessão de bloqueio

Bloqueia a sessão em que o agente de IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Bloquear após minutos de inatividade da ação
LockAfterMinutesOfActionInactivity integer

Se definido como um valor maior que 0, o Agente não bloqueará imediatamente, mas bloqueará após o número especificado de minutos de inatividade da ação (o Agente não recebe nenhuma ação). Isso impede que o Agente bloqueie e desbloqueie continuamente quando há muitos fluxos executando de volta para trás. Defina como 0 para bloquear imediatamente. O valor padrão é 5 minutos.

Segundos para aguardar após o bloqueio
SecondsToWaitAfterLock integer

Após o bloqueio, aguarde o número especificado de segundos. Isso dá tempo de sessão para bloquear totalmente. Isso geralmente é usado se você espera a possibilidade de um evento de desbloqueio (ou seja, outra sessão começando) imediatamente após o bloqueio, o que poderá falhar se a sessão anterior ainda estiver sendo bloqueada. Usado somente se 'Bloquear após minutos de inatividade da ação' for definido como 0 (causando um bloqueio imediato).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Resultado do comando
LockSessionResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Sessão remota de logoff

Faz logoff da sessão remota em que o agente do IA-Connect está em execução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Segundos para esperar
SecondsToWait integer

O tempo de espera após a emissão do comando de log off para o sistema operacional para que o agente de IA-Connect possa relatar a conclusão do comando.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Substituir dados variáveis no arquivo INI

Atualiza uma única variável em um arquivo INI.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do arquivo INI
InputFilename True string

O caminho completo para o arquivo INI. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução.

Caminho do arquivo INI de saída
OutputFilename string

Se você quiser gravar o arquivo INI atualizado em um arquivo alternativo, insira o caminho completo para o arquivo de saída aqui. O arquivo INI de entrada não será modificado – o arquivo INI de saída conterá as alterações.

Seção de pesquisa INI
SearchSection string

O nome opcional da seção que contém a variável a ser alterada.

Nome da variável de pesquisa INI
SearchVariable string

O nome da variável a ser atualizada.

Dados de substituição
ReplaceData string

Os dados de substituição para os qual atualizar a variável.

Codificação de arquivo INI
InputFilenameEncoding string

Forneça a codificação de arquivo INI (Unicode, UTF8, UTF7 ou ASCII) ou especifique o valor de codificação (por exemplo, 1252 para a Europa Ocidental).

Criar um novo arquivo se o arquivo de entrada não existir
CreateNewFileIfNotExists boolean

Se o arquivo de entrada não existir, um novo deverá ser criado?

Espaço de gravação antes igual a
WriteSpaceBeforeEquals boolean

Um espaço deve ser gravado antes do sinal igual a ( = ) ?

Espaço de gravação após igual
WriteSpaceAfterEquals boolean

Um espaço deve ser gravado após o sinal igual a ( = ) ?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()