IA-Connect código dinâmico (versão prévia)
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 desenvolver módulos de código dinâmico.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| Metadados do conector | |
|---|---|
| Publicador | Ultima 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 automação do Power |
Relata se a automação do PowerShell está disponível no computador em que o agente de IA-Connect está em execução. Se a automação do PowerShell não estiver disponível, as ações de automação do PowerShell não funcionarão. |
| Adicionar pasta de pesquisa do assembly |
Adiciona um caminho de pasta (no computador em que o agente de IA-Connect está em execução) à lista de pastas para o agente de IA-Connect verificar quando ele tenta carregar uma referência externa. |
| Carregar CSV na lista IA-Connect Orchestrator |
Carregue dados CSV de substituição em uma lista IA-Connect Orchestrator, substituindo qualquer conteúdo existente. |
| Carregar CSV para IA-Connect tabela de pesquisa do Orchestrator |
Carregue dados CSV de substituição em uma tabela de pesquisa IA-Connect Orchestrator, substituindo qualquer conteúdo existente. Essa ação não interagirá com uma tabela de pesquisa manipulada pelo agente IA-Connect (um arquivo CSV mantido em disco). |
| Carregar IA-Connect tabela de pesquisa |
Carrega uma tabela de pesquisa IA-Connect do computador em que o agente de IA-Connect está em execução. Essas tabelas de pesquisa podem ser usadas por outras ações IA-Connect para executar pesquisas de dados. |
| Classificar matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres, classifica a matriz e retorna uma nova matriz. Se você quiser classificar uma tabela, use a ação "Classificar tabela". Se você quiser classificar uma tabela no formato JSON, use a ação 'Classificar tabela JSON'. |
| Classificar tabela JSON |
Usa uma tabela JSON de entrada, classifica a tabela e retorna uma nova tabela JSON. Se você quiser classificar uma tabela real (ou seja, não no formato JSON), use a ação "Classificar tabela". Se você quiser classificar uma matriz de cadeia de caracteres, use a ação "Classificar matriz de cadeia de caracteres". |
| Colunas de pesquisa de IA-Connect tabela de pesquisa |
Recupera uma ou mais colunas nomeadas de forma idêntica de uma tabela de pesquisa do Orchestrator (para automações que usam o Orchestrator) ou uma tabela de pesquisa atualmente carregada no agente de IA-Connect, da primeira linha que corresponde aos dados de entrada e retorna como uma tabela. Por exemplo, a tabela de pesquisa pode conter várias colunas de saída chamadas "Grupo do AD" para representar vários grupos do AD e elas serão retornadas como linhas separadas na tabela de saída. Se o Orchestrator tiver uma tabela de pesquisa com o mesmo nome que uma carregada no agente de IA-Connect, a tabela de pesquisa do Orchestrator será usada (se a automação estiver passando pelo Orchestrator). |
| Converter matriz em JSON |
Usa uma matriz de entrada e serializa em uma cadeia de caracteres JSON. |
| Criar JSON com base em variáveis de entrada |
Usa uma matriz de variáveis de entrada e retorna no formato JSON e, opcionalmente, como uma tabela JSON. |
| Dividir cadeia de caracteres usando uma expressão regular |
Divide uma cadeia de caracteres de entrada usando uma correspondência de expressão regular (regex) e retorna os componentes de divisão individuais da cadeia de caracteres como uma matriz de cadeia de caracteres. |
| Excluir colunas de uma tabela |
Usa uma tabela de entrada, exclui uma coluna ou colunas e retorna uma nova tabela. Se você quiser excluir colunas de uma tabela no formato JSON, use a ação 'Excluir colunas de uma tabela JSON'. |
| Excluir colunas de uma tabela JSON |
Usa uma tabela de entrada no formato JSON, exclui uma coluna ou colunas e retorna uma nova tabela no formato JSON. Se você quiser excluir colunas de uma tabela real (ou seja, não no formato JSON), use a ação "Excluir colunas de uma tabela". |
| Excluir itens de uma matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres, exclui um item ou itens em uma posição especificada e retorna uma nova matriz. Se você quiser excluir uma linha ou linha de uma tabela, use a ação "Excluir uma linha de uma tabela". Se você quiser excluir uma linha ou linha de uma tabela no formato JSON, use a ação 'Excluir uma linha de uma tabela JSON'. |
| Excluir linhas de uma tabela |
Usa uma tabela de entrada, exclui uma linha ou linhas em uma posição especificada e retorna uma nova tabela. Se você quiser excluir uma linha ou linha de uma matriz de cadeia de caracteres, use a ação "Excluir uma linha de uma matriz de cadeia de caracteres". Se você quiser excluir uma linha ou linha de uma tabela no formato JSON, use a ação 'Excluir uma linha de uma tabela JSON'. |
| Excluir linhas de uma tabela JSON |
Usa uma tabela de entrada no formato JSON, exclui uma linha ou linhas em uma posição especificada e retorna uma nova tabela no formato JSON. Se você quiser excluir uma linha ou linha de uma tabela real (ou seja, não no formato JSON), use a ação 'Excluir uma linha de uma tabela'. Se você quiser excluir uma linha ou linha de uma matriz de cadeia de caracteres, use a ação "Excluir uma linha de uma matriz de cadeia de caracteres". |
|
Executar script do Power |
Executa um script do PowerShell na sessão em que o agente de IA-Connect está em execução, em que o conteúdo do script é passado para o agente de IA-Connect na entrada 'Conteúdo de script do PowerShell' (PowerShellScriptContents). Essa é a ação recomendada para executar seu próprio código personalizado do PowerShell. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior de um script do PowerShell, executado como um thread do Agente. O Agente executa o PowerShell usando o Microsoft PowerShell v3.x para v5.x (qualquer versão instalada), não o powershell core (6.x em diante). |
| Filtrar matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres, filtra a matriz (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova matriz. Se você quiser filtrar uma tabela, use a ação 'Filtrar tabela'. Se você quiser filtrar uma tabela no formato JSON, use a ação 'Filtrar tabela JSON'. |
| Filtrar tabela |
Usa uma tabela de entrada, filtra a tabela (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova tabela. Se você quiser filtrar uma tabela no formato JSON, use a ação 'Filtrar tabela JSON'. Se você quiser filtrar uma matriz de cadeia de caracteres, use a ação 'Filtrar matriz de cadeia de caracteres'. |
| Filtrar tabela JSON |
Usa uma tabela JSON de entrada, filtra a tabela (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova tabela JSON. Se você quiser filtrar uma tabela real (ou seja, não no formato JSON), use a ação 'Filtrar tabela'. Se você quiser filtrar uma matriz de cadeia de caracteres, use a ação 'Filtrar matriz de cadeia de caracteres'. |
| Importar assembly do arquivo local |
Carrega um assembly DotNet do computador em que o diretor do IA-Connect está em execução no agente de IA-Connect em que ele é carregado na memória e será usado se referenciado pelo código DotNet dinâmico. |
| Inserir uma linha de variáveis de entrada em uma tabela JSON |
Usa uma tabela de entrada no formato JSON, insere uma linha criada a partir de variáveis de entrada em uma posição especificada e retorna uma nova tabela no formato JSON. O esquema de linha de entrada deve corresponder ao da tabela de entrada (ou seja, usar os mesmos nomes de propriedade e tipos de dados). Se você quiser inserir uma linha em uma tabela real (ou seja, não no formato JSON), use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres". |
| Inserir uma linha em uma matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres, insere uma linha em uma posição especificada e retorna uma nova matriz. Se você quiser inserir uma linha em uma tabela, use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma linha em uma tabela no formato JSON, use a ação "Inserir uma linha em uma tabela JSON". |
| Inserir uma linha em uma tabela |
Usa uma tabela de entrada, insere uma linha em uma posição especificada e retorna uma nova tabela. Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres". Se você quiser inserir uma linha em uma tabela no formato JSON, use a ação "Inserir uma linha em uma tabela JSON". |
| Inserir uma linha em uma tabela JSON |
Usa uma tabela de entrada no formato JSON, insere uma linha em uma posição especificada e retorna uma nova tabela no formato JSON. Se você quiser inserir uma linha em uma tabela real (ou seja, não no formato JSON), use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres". |
| Limpar pastas de pesquisa do assembly |
Redefina a lista adicional de pastas para o agente de IA-Connect verificar quando tentar carregar uma referência externa. |
|
O módulo do Power |
Pesquisa um módulo do PowerShell especificado no computador em que o agente de IA-Connect está em execução e retorna se ele está instalado. |
| Obter a tabela JSON da matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres e retorna como uma tabela JSON. |
|
Obter a versão do Power |
Obtém a versão do PowerShell na sessão em que o agente de IA-Connect está em execução. Isso detecta o Microsoft PowerShell v3.x para v5.x, não o powershell core (6.x em diante). |
| Obter cadeia de caracteres da célula da tabela JSON |
Usa uma tabela de entrada no formato JSON e retorna uma célula especificada como uma cadeia de caracteres. |
| Obter cadeia de caracteres entre |
Usa uma cadeia de caracteres de entrada e retorna a primeira instância de uma cadeia de caracteres que está localizada entre duas cadeias de caracteres especificadas ou entre uma cadeia de caracteres e o final da linha. |
| Obter coluna de IA-Connect lista |
Recupera uma coluna de uma lista IA-Connect Orchestrator. |
| Obter correspondência de expressão regular |
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna se a cadeia de caracteres correspondeu à expressão e aos detalhes da correspondência. |
| Obter correspondências de expressão regular |
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna todas as correspondências em uma matriz de cadeia de caracteres. A matriz estará vazia se não houver correspondências. |
| Obter correspondências de grupo de expressões regulares |
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna uma lista de valores e nomes de grupo correspondentes. |
| Obter IA-Connect conteúdo da lista |
Recupera todos os dados de uma lista IA-Connect Orchestrator. |
| Obter IA-Connect conteúdo da tabela de pesquisa do Orchestrator |
Recupera todos os dados de uma tabela de pesquisa do Orchestrator IA-Connect mantida no Orchestrator. Isso não recuperará uma tabela de pesquisa manipulada pelo agente IA-Connect (um arquivo CSV mantido em disco). |
| Obter IA-Connect resumo da tabela de pesquisa |
Recupera um resumo das tabelas de pesquisa atualmente carregadas no agente de IA-Connect. |
| Obter matriz de cadeia de caracteres da coluna da tabela JSON |
Usa uma tabela de entrada no formato JSON e retorna uma coluna especificada como uma matriz de cadeia de caracteres. Se você quiser obter uma matriz de cadeia de caracteres de uma tabela real (ou seja, não no formato JSON), use a ação "Obter matriz da tabela". |
| Obter matriz de cadeia de caracteres da coluna de tabela |
Usa uma tabela de entrada e retorna uma coluna especificada como uma matriz de cadeia de caracteres. Se você quiser obter uma matriz de cadeia de caracteres de uma tabela no formato JSON, use a ação "Obter matriz da tabela JSON". |
| Obter tabela da matriz de cadeia de caracteres |
Usa uma matriz de entrada de itens de cadeia de caracteres e retorna como uma tabela. |
| Obter tabela do JSON |
Usa uma tabela de entrada no formato JSON e retorna como uma tabela. Isso é conhecido como desserialização. |
| Pesquisar células de dados de IA-Connect tabela de pesquisa |
Recupera todas as células de dados de uma tabela de pesquisa do Orchestrator (para automações usando o Orchestrator), da primeira linha que corresponde aos dados de entrada e retorna como uma tabela. Essa ação não dá suporte a tabelas de pesquisa carregadas no agente de IA-Connect. |
| Remover caracteres da cadeia de caracteres |
Usa uma cadeia de caracteres de entrada e retorna-a com os caracteres especificados removidos. Se os caracteres especificados não estiverem localizados, a cadeia de caracteres original será retornada. |
| Remover IA-Connect tabela de pesquisa |
Remove uma tabela de pesquisa atualmente carregada no agente de IA-Connect. |
| Remover todas as tabelas de pesquisa IA-Connect |
Remove todas as tabelas de pesquisa atualmente carregadas no agente de IA-Connect. |
| Renomear uma coluna em uma tabela |
Usa uma tabela de entrada, renomeia uma coluna especificada e retorna uma nova tabela. Se você quiser renomear uma coluna de uma tabela no formato JSON, use a ação "Renomear uma coluna em uma tabela JSON". |
| Renomear uma coluna em uma tabela JSON |
Usa uma tabela de entrada no formato JSON, renomeia uma coluna especificada e retorna uma nova tabela no formato JSON. Se você quiser renomear uma coluna de uma tabela real (ou seja, não no formato JSON), use a ação "Renomear uma coluna em uma tabela". |
| Tabela de classificação |
Usa uma tabela de entrada, classifica uma ou mais linhas e retorna uma nova tabela. Se você quiser classificar uma tabela no formato JSON, use a ação 'Classificar tabela JSON'. Se você quiser classificar uma matriz de cadeia de caracteres, use a ação "Classificar matriz de cadeia de caracteres". |
| Valor de pesquisa de IA-Connect tabela de pesquisa |
Recupera um valor de uma tabela de pesquisa do Orchestrator (para automações usando o Orchestrator) ou uma tabela de pesquisa atualmente carregada no agente de IA-Connect, da primeira linha que corresponde aos dados de entrada. Se o Orchestrator tiver uma tabela de pesquisa com o mesmo nome que uma carregada no agente de IA-Connect, a tabela de pesquisa do Orchestrator será usada (se a automação estiver passando pelo Orchestrator). |
A automação do PowerShell está instalada
Relata se a automação do PowerShell está disponível no computador em que o agente de IA-Connect está em execução. Se a automação do PowerShell não estiver disponível, as ações de automação do PowerShell não funcionarã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 |
|---|---|---|---|
|
A automação do PowerShell está instalada
|
PowerShellAutomationIsInstalled | boolean |
Retornará true se a automação do PowerShell estiver disponível ou false se não estiver. |
Adicionar pasta de pesquisa do assembly
Adiciona um caminho de pasta (no computador em que o agente de IA-Connect está em execução) à lista de pastas para o agente de IA-Connect verificar quando ele tenta carregar uma referência externa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
FolderPath | True | string |
O caminho para a pasta a ser adicionada à lista de pastas para o agente de IA-Connect verificar quando ele tenta carregar uma referência externa. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Carregar CSV na lista IA-Connect Orchestrator
Carregue dados CSV de substituição em uma lista IA-Connect Orchestrator, substituindo qualquer conteúdo existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da lista
|
ListName | True | string |
O nome da lista Orchestrator. |
|
Dados CSV
|
CSVData | True | string |
Os dados CSV de substituição a serem armazenados na lista orchestrator. Se a lista já existir, o conteúdo da lista será substituído por esses dados CSV. Você não pode fornecer uma entrada CSV vazia, mas pode fornecer uma linha de cabeçalho CSV sem linhas de dados. |
|
Criar lista se não existir
|
CreateListIfNotExist | boolean |
Se definido como false (o padrão) e a lista nomeada ainda não existir, uma exceção será gerada. Se definido como true, a lista nomeada será criada, se ela não existir. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UploadCSVToIAConnectListResult | 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. |
Carregar CSV para IA-Connect tabela de pesquisa do Orchestrator
Carregue dados CSV de substituição em uma tabela de pesquisa IA-Connect Orchestrator, substituindo qualquer conteúdo existente. Essa ação não interagirá com uma tabela de pesquisa manipulada pelo agente IA-Connect (um arquivo CSV mantido em disco).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa orchestrator. |
|
Dados CSV
|
CSVData | True | string |
Os dados CSV de substituição a serem armazenados na tabela de pesquisa do Orchestrator. Se a tabela de pesquisa já existir, o conteúdo da tabela será substituído por esses dados CSV. Você não pode fornecer uma entrada CSV vazia, mas pode fornecer uma linha de cabeçalho CSV sem linhas de dados. |
|
Criar tabela de pesquisa se não existir
|
CreateLookupTableIfNotExist | boolean |
Se definido como false (o padrão) e a tabela de pesquisa nomeada ainda não existir, uma exceção será gerada. Se definido como true, a tabela de pesquisa nomeada será criada, se ela não existir. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UploadCSVToIAConnectLookupTableResult | 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. |
Carregar IA-Connect tabela de pesquisa
Carrega uma tabela de pesquisa IA-Connect do computador em que o agente de IA-Connect está em execução. Essas tabelas de pesquisa podem ser usadas por outras ações IA-Connect para executar pesquisas de dados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da tabela de pesquisa
|
Path | True | string |
O caminho completo para a tabela de pesquisa. Isso deve estar acessível na sessão em que o agente do IA-Connect está em execução. Se uma pasta for especificada, todos os arquivos abaixo dessa pasta serão processados. |
|
Gerar exceção se alguma tabela falhar ao carregar
|
RaiseExceptionIfAnyTableFailsToLoad | True | boolean |
Se definido como true e qualquer tabela de pesquisa IA-Connect falhar ao carregar (por exemplo, se houver um problema na tabela), uma exceção será gerada. Esse é o padrão porque, se alguma tabela não for carregada, isso geralmente resultará em uma exceção posteriormente no processo. Se definido como false, as tabelas de pesquisa de problemas serão ignoradas e somente tabelas de pesquisa utilizáveis serão carregadas3d. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de tabelas de pesquisa carregadas
|
NumberOfLookupTablesLoaded | integer |
O número de tabelas de pesquisa que foram carregadas com êxito. |
|
Falha ao carregar o número de tabelas de pesquisa
|
NumberOfLookupTablesFailedToLoad | integer |
O número de tabelas de pesquisa que não foram carregadas. Isso só será definido se 'Gerar exceção se alguma tabela não carregar' for definida como false, pois caso contrário, haverá uma exceção. |
Classificar matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres, classifica a matriz e retorna uma nova matriz. Se você quiser classificar uma tabela, use a ação "Classificar tabela". Se você quiser classificar uma tabela no formato JSON, use a ação 'Classificar tabela JSON'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Classificação crescente
|
Ascending | boolean |
Defina como true para classificar em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Diferencia maiúsculas de minúsculas
|
CaseSensitive | boolean |
Definido como true para uma classificação diferenciada de maiúsculas e minúsculas (ou seja, maiúsculas e minúsculas classificadas separadamente). Defina como false para uma classificação que não diferencia maiúsculas de minúsculas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída classificada
|
OutputArray | array of string |
A matriz de saída classificada de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Classificar tabela JSON
Usa uma tabela JSON de entrada, classifica a tabela e retorna uma nova tabela JSON. Se você quiser classificar uma tabela real (ou seja, não no formato JSON), use a ação "Classificar tabela". Se você quiser classificar uma matriz de cadeia de caracteres, use a ação "Classificar matriz de cadeia de caracteres".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Nome da coluna de classificação
|
SortColumnName | True | string |
O nome da coluna pelo qual classificar. |
|
Classificação crescente
|
Ascending | boolean |
Defina como true para classificar em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 2
|
SortColumnName2 | string |
Um nome opcional de segunda coluna a ser classificado (após a classificação pela primeira coluna). |
|
|
Classificação crescente 2
|
Ascending2 | boolean |
Defina como true para classificar o nome da segunda coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 3
|
SortColumnName3 | string |
Um nome opcional de terceira coluna para classificar (após a classificação pela primeira e segunda colunas). |
|
|
Classificação crescente 3
|
Ascending3 | boolean |
Defina como true para classificar o nome da terceira coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Colunas de pesquisa de IA-Connect tabela de pesquisa
Recupera uma ou mais colunas nomeadas de forma idêntica de uma tabela de pesquisa do Orchestrator (para automações que usam o Orchestrator) ou uma tabela de pesquisa atualmente carregada no agente de IA-Connect, da primeira linha que corresponde aos dados de entrada e retorna como uma tabela. Por exemplo, a tabela de pesquisa pode conter várias colunas de saída chamadas "Grupo do AD" para representar vários grupos do AD e elas serão retornadas como linhas separadas na tabela de saída. Se o Orchestrator tiver uma tabela de pesquisa com o mesmo nome que uma carregada no agente de IA-Connect, a tabela de pesquisa do Orchestrator será usada (se a automação estiver passando pelo Orchestrator).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa do Orchestrator ou da tabela de pesquisa carregada no agente de IA-Connect. |
|
JSON de dados de entrada
|
InputDataJSON | string |
Dados de entrada a serem usados para a pesquisa, no formato JSON. Por exemplo, se a tabela de pesquisa tiver colunas de propriedade 'JobTitle' e 'Country', você poderá enviar o seguinte JSON: { "JobTitle": "Consultant", "Country": "England" }. |
|
|
Nome da coluna da tabela de resultados da pesquisa
|
SearchResultTableColumnName | True | string |
O nome da coluna de saída na tabela de pesquisa que contém o valor a ser retornado na tabela de saída. Se apenas uma coluna de saída na tabela de pesquisa tiver esse nome, a tabela de saída terá uma única linha. Se várias colunas de saída na tabela de pesquisa compartilharem um nome comum, a tabela de saída terá várias linhas. |
|
Gerar exceção se não houver correspondência
|
RaiseExceptionIfNoMatch | boolean |
Defina como true (o padrão) para gerar uma exceção se a pesquisa não corresponder a nenhum dado. Defina como false para retornar uma cadeia de caracteres em branco se a pesquisa não corresponder a nenhum dado. |
|
|
Retornar células em branco
|
ReturnBlankCells | boolean |
Defina como true se você quiser incluir células em branco na tabela de retorno. Defina como false (o padrão) para incluir apenas células com valores. |
|
|
Formato de retorno
|
ReturnFormat | string |
O formato a ser usado ao retornar os resultados. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de pesquisa de saída JSON
|
OutputLookupTableJSON | string |
A tabela de saída lida de uma ou mais colunas de tabela de pesquisa com o nome especificado, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. A tabela de saída terá uma coluna (correspondendo ao nome da coluna da tabela de resultados solicitada) e uma ou mais linhas, no formato JSON. |
|
Tabela de pesquisa de saída
|
OutputLookupTable | array of object |
A tabela de saída lida de uma ou mais colunas de tabela de pesquisa com o nome especificado, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. A tabela de saída terá uma coluna (correspondendo ao nome da coluna da tabela de resultados solicitada) e uma ou mais linhas. |
|
items
|
OutputLookupTable | object | |
|
Matriz de pesquisa de saída
|
OutputLookupArray | array of object |
A matriz de saída lida de uma ou mais colunas de tabela de pesquisa com o nome especificado, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. A matriz de saída é uma única coluna com uma ou mais linhas. |
|
items
|
OutputLookupArray | object | |
|
Número de linhas na saída
|
NumberOfRowsInOutput | integer |
O número de linhas na saída. |
Converter matriz em JSON
Usa uma matriz de entrada e serializa em uma cadeia de caracteres JSON.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Objeto de entrada
|
Input object | object |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
JSON de saída
|
OutputJSON | string |
A cadeia de caracteres JSON de saída. |
Criar JSON com base em variáveis de entrada
Usa uma matriz de variáveis de entrada e retorna no formato JSON e, opcionalmente, como uma tabela JSON.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da propriedade
|
PropertyName | string | ||
|
Tipo de dados de propriedade
|
DataType | string | ||
|
Valor da propriedade
|
Value | string | ||
|
Retornar como tabela JSON
|
ReturnAsJSONTable | True | boolean |
Se definido como true, o JSON será retornado em um formato de tabela/datatable (ou seja, no formato [{}]). Se definido como false, o JSON será retornado como uma única entidade (ou seja, no formato {}). Qual formato usar depende do que você está fazendo com o JSON. A maioria das ações IA-Connect espera um formato de datatable. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
JSON de saída
|
OutputJSON | string |
As variáveis e seus valores codificados no formato JSON. |
Dividir cadeia de caracteres usando uma expressão regular
Divide uma cadeia de caracteres de entrada usando uma correspondência de expressão regular (regex) e retorna os componentes de divisão individuais da cadeia de caracteres como uma matriz de cadeia de caracteres.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada a ser dividido
|
TextToSplit | True | string |
O texto de entrada a ser dividido em relação à expressão regular. |
|
Expressão regular
|
Regex | True | string |
A expressão regular para dividir o texto de entrada. |
|
Divisão diferenciada de maiúsculas e
|
CaseSensitive | boolean |
Definido como true (o padrão) para uma divisão que diferencia maiúsculas de minúsculas (por exemplo, A não é um) ou definido como false para uma divisão que não diferencia maiúsculas de minúsculas (por exemplo, A e um são tratados como idênticos). |
|
|
Resultados do corte
|
TrimResults | boolean |
Defina como true (o padrão) se cada elemento de matriz de saída individual deve ser cortado. |
|
|
Remover resultados vazios
|
RemoveEmptyResults | boolean |
Defina como true se elementos de matriz de saída vazios devem ser removidos da matriz de saída (ou seja, você não deseja resultados vazios). |
|
|
Tempo limite do Regex em segundos
|
RegexTimeoutInSeconds | integer |
O número máximo de segundos que a expressão regular pode ser processada antes do tempo limite. Isso interrompe loops infinitos causados por determinadas expressões regulares. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of object |
A matriz de cadeia de caracteres de saída que contém os componentes individuais da cadeia de caracteres, é dividida usando a expressão regular. |
|
items
|
OutputArray | object | |
|
Número de elementos na saída
|
NumberOfElementsInOutput | integer |
O número de elementos na matriz de saída. |
Excluir colunas de uma tabela
Usa uma tabela de entrada, exclui uma coluna ou colunas e retorna uma nova tabela. Se você quiser excluir colunas de uma tabela no formato JSON, use a ação 'Excluir colunas de uma tabela JSON'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Iniciar índice de coluna
|
StartColumnIndex | integer |
O índice da coluna em que começar a excluir. Use 1 para excluir a primeira coluna, N para excluir a coluna Nth. Se você quiser excluir uma coluna por nome, deixe essa entrada em branco e use a entrada "Nome da coluna a ser excluído". |
|
|
Nome da coluna a ser excluído
|
ColumnNameToDelete | string |
O nome opcional da coluna a ser excluída. Se você quiser excluir uma coluna por índice, deixe essa entrada em branco e use a entrada 'Índice iniciar coluna' em vez disso. |
|
|
Número de colunas a serem excluídas
|
NumberOfColumnsToDelete | True | integer |
O número de colunas a serem excluídas, começando no índice ou nome especificado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Excluir colunas de uma tabela JSON
Usa uma tabela de entrada no formato JSON, exclui uma coluna ou colunas e retorna uma nova tabela no formato JSON. Se você quiser excluir colunas de uma tabela real (ou seja, não no formato JSON), use a ação "Excluir colunas de uma tabela".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Iniciar índice de coluna
|
StartColumnIndex | integer |
O índice da coluna em que começar a excluir. Use 1 para excluir a primeira coluna, N para excluir a coluna Nth. Se você quiser excluir uma coluna por nome, deixe essa entrada em branco e use a entrada "Nome da coluna a ser excluído". |
|
|
Nome da coluna a ser excluído
|
ColumnNameToDelete | string |
O nome opcional da coluna a ser excluída. Se você quiser excluir uma coluna por índice, deixe essa entrada em branco e use a entrada 'Índice iniciar coluna' em vez disso. |
|
|
Número de colunas a serem excluídas
|
NumberOfColumnsToDelete | True | integer |
O número de colunas a serem excluídas, começando no índice ou nome especificado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Excluir itens de uma matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres, exclui um item ou itens em uma posição especificada e retorna uma nova matriz. Se você quiser excluir uma linha ou linha de uma tabela, use a ação "Excluir uma linha de uma tabela". Se você quiser excluir uma linha ou linha de uma tabela no formato JSON, use a ação 'Excluir uma linha de uma tabela JSON'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Iniciar índice de item
|
StartItemIndex | True | integer |
O índice do item no qual começar a excluir. Use 1 para excluir o primeiro item, N para excluir o Nth item. |
|
Número de itens a serem excluídos
|
NumberOfItemsToDelete | True | integer |
O número de itens a serem excluídos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of string |
A matriz de saída de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Excluir linhas de uma tabela
Usa uma tabela de entrada, exclui uma linha ou linhas em uma posição especificada e retorna uma nova tabela. Se você quiser excluir uma linha ou linha de uma matriz de cadeia de caracteres, use a ação "Excluir uma linha de uma matriz de cadeia de caracteres". Se você quiser excluir uma linha ou linha de uma tabela no formato JSON, use a ação 'Excluir uma linha de uma tabela JSON'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Iniciar índice de linha
|
StartRowIndex | True | integer |
O índice da linha em que começar a excluir. Use 1 para excluir a primeira linha, N para excluir a Nª linha. |
|
Número de linhas a serem excluídas
|
NumberOfRowsToDelete | True | integer |
O número de linhas a eliminar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Excluir linhas de uma tabela JSON
Usa uma tabela de entrada no formato JSON, exclui uma linha ou linhas em uma posição especificada e retorna uma nova tabela no formato JSON. Se você quiser excluir uma linha ou linha de uma tabela real (ou seja, não no formato JSON), use a ação 'Excluir uma linha de uma tabela'. Se você quiser excluir uma linha ou linha de uma matriz de cadeia de caracteres, use a ação "Excluir uma linha de uma matriz de cadeia de caracteres".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Iniciar índice de linha
|
StartRowIndex | True | integer |
O índice da linha em que começar a excluir. Use 1 para excluir a primeira linha, N para excluir a Nª linha. |
|
Número de linhas a serem excluídas
|
NumberOfRowsToDelete | True | integer |
O número de linhas a eliminar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Executar script do PowerShell
Executa um script do PowerShell na sessão em que o agente de IA-Connect está em execução, em que o conteúdo do script é passado para o agente de IA-Connect na entrada 'Conteúdo de script do PowerShell' (PowerShellScriptContents). Essa é a ação recomendada para executar seu próprio código personalizado do PowerShell. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior de um script do PowerShell, executado como um thread do Agente. O Agente executa o PowerShell usando o Microsoft PowerShell v3.x para v5.x (qualquer versão instalada), não o powershell core (6.x em diante).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo de script do PowerShell
|
PowerShellScriptContents | string |
O conteúdo do script do PowerShell a ser executado. IA-Connect executará esse script as-is passando diretamente para o mecanismo de automação do PowerShell. Nenhum script do PowerShell é realmente criado em disco. Como alternativa, você pode executar um script existente do PowerShell em disco, inserindo o seguinte: retornar > "scriptpath". Por exemplo: return &'c:\scripts\TestScript.ps1'. |
|
|
Nome do computador
|
ComputerName | string |
O nome do computador no qual executar o script do PowerShell. Se deixado em branco, o script será executado no computador em que o agente IA-Connect está em execução. |
|
|
Não é resultado de um erro
|
IsNoResultAnError | boolean |
Se nenhum dado for retornado pelo comando do PowerShell, isso sugerirá um erro? |
|
|
Retornar tipos complexos
|
ReturnComplexTypes | boolean |
Se os dados retornados do PowerShell contiverem propriedades 'complexas' (por exemplo, coleções de valores, matrizes, tabelas ou classes), essas propriedades não serão retornadas, por padrão, na resposta IA-Connect PowerShell. As entradas 'Propriedades a serem retornadas como coleção', 'Nomes de propriedade para serializar' e 'Tipos de propriedade a serem serializados' permitem especificar quais propriedades 'complexas' devem ser retornadas e o método usado para formatar os dados (em uma base propriedade por propriedade, escolha a que funciona melhor). Essa entrada permite que você especifique o que deve ser feito com as propriedades restantes (ou seja, propriedades que são 'complexas' e não nomeadas explicitamente). Se definido como true, IA-Connect tentará retornar uma representação de cadeia de caracteres dos dados usando ToString(). Se definido como false (o padrão), IA-Connect não retornará a propriedade. |
|
|
Retornar booliano como booliano
|
ReturnBooleanAsBoolean | boolean |
As propriedades boolianas devem ser retornadas como boolianos? Se forem falsas, elas serão retornadas como cadeias de caracteres. |
|
|
Retornar numérico como decimal
|
ReturnNumericAsDecimal | boolean |
As propriedades numéricas devem ser retornadas como numéricos? Se forem falsas, elas serão retornadas como cadeias de caracteres. |
|
|
Data de retorno como data
|
ReturnDateAsDate | boolean |
As propriedades date devem ser retornadas como datas? Se forem falsas, elas serão retornadas como cadeias de caracteres. |
|
|
Propriedades a serem retornadas como coleção
|
PropertiesToReturnAsCollectionJSON | string |
Se os dados retornados do PowerShell contiverem propriedades 'complexas' (por exemplo, coleções de valores, matrizes, tabelas ou classes), essas propriedades não serão retornadas, por padrão, na resposta IA-Connect PowerShell. Essa opção permite especificar quais propriedades 'complexas' (por nome) IA-Connect devem tentar retornar como uma coleção. Dependendo da propriedade, do tipo e dos valores, você também deve considerar o uso das entradas alternativas 'Nomes de propriedade para serializar' e 'Tipos de propriedade para serializar' (escolha um). Essa entrada pode ser inserida no formato JSON ou CSV. Por exemplo: para retornar as propriedades de matriz EmailAddresses e MemberOf, insira [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabela JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) ou EmailAddresses,MemberOf (formato CSV). |
|
|
Mecanismo de autenticação
|
AuthenticationMechanism | string |
O mecanismo de autenticação a ser usado se estiver se conectando a um computador remoto ou executando o script como um usuário alternativo. Os valores com suporte são 'Basic', 'Credssp', 'Default', 'Digest', 'Kerberos' e 'Negotiate'. |
|
|
Tentativas de conexão
|
ConnectionAttempts | integer |
O número de conexões para tentar se conectar a um computador remoto. |
|
|
Nome de usuário
|
Username | string |
O nome de usuário a ser usado se estiver executando o script como um usuário alternativo. |
|
|
Senha
|
Password | password |
A senha a ser usada se estiver executando o script como um usuário alternativo. |
|
|
Executar script como thread
|
RunScriptAsThread | boolean |
Se definido como false (o padrão), o agente IA-Connect executará o script do PowerShell imediatamente e retornará os resultados ao Diretor quando o script for concluído. Se estiver executando um script longo ou complexo do PowerShell, essa ação poderá acabar. Se definido como true, o agente de IA-Connect executará o script do PowerShell como um thread do Agente e o IA-Connect Director (ou Orchestrator, módulo do PowerShell, Blue Prism) poderá monitorar o status desse thread do Agente, aguardando que ele seja concluído. Isso permite que scripts longos ou complexos do PowerShell executem sem tempo limite. IA-Connect Agentes 9.3 e anteriores não podem executar scripts do PowerShell como um thread do Agente. |
|
|
Recuperar dados de saída para a ID do thread
|
RetrieveOutputDataFromThreadId | integer |
Se você executou anteriormente um script do PowerShell como um thread do Agente e definiu "Segundos para esperar por thread" como 0, 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. Defina como 0 (o padrão) se você estiver simplesmente executando um script do PowerShell (e, portanto, não recuperando os resultados de um script anterior do PowerShell executado como um thread do Agente). |
|
|
Segundos para aguardar o thread
|
SecondsToWaitForThread | integer |
Se 'Executar script como thread' for definido como true, quantos segundos aguardar a conclusão do thread do Agente. Se o thread do Agente que executa o script do PowerShell não tiver sido concluído neste momento, uma exceção será gerada. Definido como 0 para ignorar a espera: o Agente continuará executando o script do PowerShell, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados do script 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 "Executar script do PowerShell" com a entrada "Recuperar dados de saída para id de thread" definida para a ID de thread do Agente. |
|
|
O script contém senha armazenada
|
ScriptContainsStoredPassword | boolean |
Defina como true se o script contiver um identificador de senha armazenado IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica IA-Connect Orchestrator, no formato {OrchestratorCredential:FriendlyName}. A frase { } será substituída pela senha especificada, escapada e colocada entre aspas simples (a menos que já esteja entre aspas no script). |
|
|
Saída detalhada do log
|
LogVerboseOutput | boolean |
Defina como true para registrar qualquer saída detalhada do PowerShell nos logs de IA-Connect. Isso pode ser útil para depuração. Para fazer logon detalhadamente em seu script, use o seguinte PowerShell: Write-Verbose 'Minha mensagem' -Detalhado. |
|
|
Retornar cadeias de caracteres seguras
|
ReturnSecureStrings | boolean |
Defina como true para retornar quaisquer propriedades de cadeia de caracteres seguras na saída de script do PowerShell. Defina como false (o padrão) para não retornar nenhuma propriedade mantida como uma cadeia de caracteres segura. Somente definido como true se você souber o que está fazendo, pois isso poderá resultar na transmissão de senhas (se houver senhas na saída do script do PowerShell). |
|
|
Nomes de propriedade para serializar
|
PropertyNamesToSerializeJSON | string |
Se os dados retornados do PowerShell contiverem propriedades 'complexas' (por exemplo, coleções de valores, matrizes, tabelas ou classes), essas propriedades não serão retornadas, por padrão, na resposta IA-Connect PowerShell. Essa opção permite que você especifique quais propriedades 'complexas' (por nome) IA-Connect devem ser serializados como JSON, para que sejam retornadas como um tipo de cadeia de caracteres (que você pode desserializar, uma vez recebido). Dependendo da propriedade, seu tipo e valores, você também deve considerar o uso das entradas alternativas 'Propriedades a serem retornadas como coleção' e 'Tipos de propriedade para serializar' (escolha um). Por exemplo: para serializar as propriedades EmailAddresses e MemberOf, insira [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabela JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) ou EmailAddresses,MemberOf (formato CSV). |
|
|
Tipos de propriedade para serializar
|
PropertyTypesToSerializeJSON | string |
Se os dados retornados do PowerShell contiverem propriedades 'complexas' (por exemplo, coleções de valores, matrizes, tabelas ou classes), essas propriedades não serão retornadas, por padrão, na resposta IA-Connect PowerShell. Essa opção permite que você especifique quais propriedades 'complexas' (por tipo) IA-Connect devem ser serializados como JSON, para que sejam retornadas como um tipo de cadeia de caracteres (que você pode desserializar, uma vez recebido). Dependendo da propriedade, do tipo e dos valores, você também deve considerar usar as entradas alternativas 'Propriedades a serem retornadas como coleção' e 'Nomes de propriedade para serializar' (escolha um). Essa entrada é uma coleção com um único campo 'PropertyType'. Por exemplo: para serializar qualquer propriedade do tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], enter [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabela JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) ou 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV). |
|
|
Nome
|
Name | string |
O nome do parâmetro de entrada do PowerShell. Isso deve atender aos formatos de nomenclatura de variável do PowerShell (ou seja, é recomendável evitar espaços ou símbolos especiais). Os nomes das variáveis do PowerShell não diferenciam maiúsculas de minúsculas. Por exemplo: MyVariable resultaria em uma variável $MyVariable sendo criada. |
|
|
Valor da cadeia de caracteres
|
StringValue | string |
O valor da cadeia de caracteres a ser atribuído ao parâmetro de entrada do PowerShell. Como alternativa, use as outras entradas de valor se você estiver inserindo um valor booliano ou numérico. |
|
|
Valor inteiro
|
IntValue | integer |
O valor inteiro (número inteiro) a ser atribuído ao parâmetro de entrada do PowerShell. Como alternativa, use as outras entradas de valor se você estiver inserindo um valor numérico, booliano ou de cadeia de caracteres. |
|
|
Valor booliano
|
BooleanValue | boolean |
O valor booliano (verdadeiro ou falso) a ser atribuído ao parâmetro de entrada do PowerShell. Como alternativa, use as outras entradas de valor se você estiver inserindo uma cadeia de caracteres ou um valor numérico. |
|
|
Valor decimal
|
DecimalValue | double |
O valor decimal a ser atribuído ao parâmetro de entrada do PowerShell. Como alternativa, use as outras entradas de valor se você estiver inserindo um valor de cadeia de caracteres, booliano ou inteiro. |
|
|
Valor do objeto
|
ObjectValue | object |
O valor do objeto a ser atribuído ao parâmetro de entrada do PowerShell. Isso se tornará uma variável de cadeia de caracteres serializada JSON no script do PowerShell, portanto, desserialize para um objeto usando ConvertFrom-Json. Como alternativa, use as outras entradas de valor se você estiver inserindo um valor numérico, booliano ou de cadeia de caracteres. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
JSON de saída do PowerShell
|
PowerShellJSONOutput | string |
A saída do script do PowerShell, formatada como JSON. |
|
Thread Id
|
ThreadId | integer |
Se o script do PowerShell estiver sendo executado como um thread do Agente, essa saída conterá a ID de thread do Agente que pode ser usada para monitorar a execução do script do PowerShell e recuperar os resultados do script do PowerShell quando o script for concluído. |
Filtrar matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres, filtra a matriz (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova matriz. Se você quiser filtrar uma tabela, use a ação 'Filtrar tabela'. Se você quiser filtrar uma tabela no formato JSON, use a ação 'Filtrar tabela JSON'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Nome da coluna
|
ColumnName | True | string |
O nome a ser usado para a coluna de tabela que mantém a matriz durante a operação de filtro. Esse nome pode ser usado como o nome da coluna na sintaxe do filtro de linha .NET DataView. Por exemplo, MyColumn, que pode ser chamado de [MyColumn]. |
|
Filter
|
Filter | True | string |
O filtro na sintaxe do rowfilter .NET DataView. Por exemplo: [Nome] como '*Elemento'. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída filtrada
|
OutputArray | array of string |
A matriz de saída filtrada de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Filtrar tabela
Usa uma tabela de entrada, filtra a tabela (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova tabela. Se você quiser filtrar uma tabela no formato JSON, use a ação 'Filtrar tabela JSON'. Se você quiser filtrar uma matriz de cadeia de caracteres, use a ação 'Filtrar matriz de cadeia de caracteres'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Filter
|
Filter | True | string |
O filtro na sintaxe do rowfilter .NET DataView. Por exemplo: [Nome] como '*Elemento'. |
|
Nome da coluna de classificação
|
SortColumnName | string |
Um nome de coluna opcional para classificar, depois de aplicar o filtro. Se você quiser classificar por várias colunas, liste a vírgula de colunas separada. |
|
|
Classificação crescente
|
Ascending | boolean |
Defina como true para classificar em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 2
|
SortColumnName2 | string |
Um nome opcional de segunda coluna a ser classificado (após a classificação pela primeira coluna). |
|
|
Classificação crescente 2
|
Ascending2 | boolean |
Defina como true para classificar o nome da segunda coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 3
|
SortColumnName3 | string |
Um nome opcional de terceira coluna para classificar (após a classificação pela primeira e segunda colunas). |
|
|
Classificação crescente 3
|
Ascending3 | boolean |
Defina como true para classificar o nome da terceira coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Filtrar tabela JSON
Usa uma tabela JSON de entrada, filtra a tabela (usando a sintaxe do filtro de linha .NET DataView) e retorna uma nova tabela JSON. Se você quiser filtrar uma tabela real (ou seja, não no formato JSON), use a ação 'Filtrar tabela'. Se você quiser filtrar uma matriz de cadeia de caracteres, use a ação 'Filtrar matriz de cadeia de caracteres'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Filter
|
Filter | True | string |
O filtro na sintaxe do rowfilter .NET DataView. Por exemplo: [Nome] como '*Elemento'. |
|
Nome da coluna de classificação
|
SortColumnName | string |
Um nome de coluna opcional para classificar, depois de aplicar o filtro. Se você quiser classificar por várias colunas, liste a vírgula de colunas separada. |
|
|
Classificação crescente
|
Ascending | boolean |
Defina como true para classificar em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 2
|
SortColumnName2 | string |
Um nome opcional de segunda coluna a ser classificado (após a classificação pela primeira coluna). |
|
|
Classificação crescente 2
|
Ascending2 | boolean |
Defina como true para classificar o nome da segunda coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 3
|
SortColumnName3 | string |
Um nome opcional de terceira coluna para classificar (após a classificação pela primeira e segunda colunas). |
|
|
Classificação crescente 3
|
Ascending3 | boolean |
Defina como true para classificar o nome da terceira coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Importar assembly do arquivo local
Carrega um assembly DotNet do computador em que o diretor do IA-Connect está em execução no agente de IA-Connect em que ele é carregado na memória e será usado se referenciado pelo código DotNet dinâmico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de assembly local
|
LocalAssemblyFilePath | True | string |
O caminho do arquivo para o arquivo de assembly local na sessão local (em que o IA-Connect Director está em execução). |
|
Nome do assembly
|
AssemblyName | True | string |
O nome do assembly a ser importado. |
|
Comprimir
|
Compress | boolean |
O assembly deve ser compactado antes de carregar? |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Inserir uma linha de variáveis de entrada em uma tabela JSON
Usa uma tabela de entrada no formato JSON, insere uma linha criada a partir de variáveis de entrada em uma posição especificada e retorna uma nova tabela no formato JSON. O esquema de linha de entrada deve corresponder ao da tabela de entrada (ou seja, usar os mesmos nomes de propriedade e tipos de dados). Se você quiser inserir uma linha em uma tabela real (ou seja, não no formato JSON), use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Índice de linha
|
RowIndex | True | integer |
O índice da linha a ser inserida. Use 0 para inserir no início da tabela, 1 para inserir após a linha 1, N para inserir após a linha N. -1 ou qualquer número igual ou superior ao número de itens na tabela a serem inseridos no final da tabela (útil se você não souber por quanto tempo a tabela está). |
|
Nome da propriedade
|
PropertyName | string | ||
|
Tipo de dados de propriedade
|
DataType | string | ||
|
Valor da propriedade
|
Value | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Inserir uma linha em uma matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres, insere uma linha em uma posição especificada e retorna uma nova matriz. Se você quiser inserir uma linha em uma tabela, use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma linha em uma tabela no formato JSON, use a ação "Inserir uma linha em uma tabela JSON".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Índice de linha
|
RowIndex | True | integer |
O índice da linha a ser inserida. Use 0 para inserir no início da matriz, 1 para inserir após a linha 1, N para inserir após a linha N. -1 ou qualquer número igual ou superior ao número de itens na matriz a serem inseridos no final da matriz (útil se você não souber por quanto tempo a matriz está). |
|
Valor a ser inserido
|
ValueToInsert | string |
O valor da cadeia de caracteres a ser inserido na nova linha. Deixe em branco se você quiser inserir uma linha vazia. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of string |
A matriz de saída de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Inserir uma linha em uma tabela
Usa uma tabela de entrada, insere uma linha em uma posição especificada e retorna uma nova tabela. Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres". Se você quiser inserir uma linha em uma tabela no formato JSON, use a ação "Inserir uma linha em uma tabela JSON".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Índice de linha
|
RowIndex | True | integer |
O índice da linha a ser inserida. Use 0 para inserir no início da tabela, 1 para inserir após a linha 1, N para inserir após a linha N. -1 ou qualquer número igual ou superior ao número de itens na tabela a serem inseridos no final da tabela (útil se você não souber por quanto tempo a tabela está). |
|
Linha JSON a ser inserida
|
RowToInsertJSON | string |
O conteúdo da linha a ser inserida no formato JSON. Deixe em branco se você quiser inserir uma linha vazia. Por exemplo: para inserir 'Fernandes' na coluna 'Name' use {"Name":"Simon"} e, além disso, insira 'Inglaterra' na coluna 'Country' use {"Name":"Simon","Country":"England"}. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Inserir uma linha em uma tabela JSON
Usa uma tabela de entrada no formato JSON, insere uma linha em uma posição especificada e retorna uma nova tabela no formato JSON. Se você quiser inserir uma linha em uma tabela real (ou seja, não no formato JSON), use a ação "Inserir uma linha em uma tabela". Se você quiser inserir uma cadeia de caracteres em uma matriz de cadeia de caracteres, use a ação "Inserir uma linha em uma matriz de cadeia de caracteres".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Índice de linha
|
RowIndex | True | integer |
O índice da linha a ser inserida. Use 0 para inserir no início da tabela, 1 para inserir após a linha 1, N para inserir após a linha N. -1 ou qualquer número igual ou superior ao número de itens na tabela a serem inseridos no final da tabela (útil se você não souber por quanto tempo a tabela está). |
|
Linha JSON a ser inserida
|
RowToInsertJSON | string |
O conteúdo da linha a ser inserida no formato JSON. Deixe em branco se você quiser inserir uma linha vazia. Por exemplo: para inserir 'Fernandes' na coluna 'Name' use {"Name":"Simon"} e, além disso, insira 'Inglaterra' na coluna 'Country' use {"Name":"Simon","Country":"England"}. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Limpar pastas de pesquisa do assembly
Redefina a lista adicional de pastas para o agente de IA-Connect verificar quando tentar carregar uma referência externa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
O módulo do PowerShell está instalado
Pesquisa um módulo do PowerShell especificado no computador em que o agente de IA-Connect está em execução e retorna se ele está instalado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Módulo PowerShell
|
PowerShellModuleName | True | string |
O nome do módulo do PowerShell a ser pesquisado. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
O módulo do PowerShell está instalado
|
PowerShellModuleIsInstalled | boolean |
Retornará true se o módulo do PowerShell especificado estiver instalado ou false, caso contrário. |
Obter a tabela JSON da matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres e retorna como uma tabela JSON.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Nome da coluna
|
ColumnName | True | string |
O nome a ser usado para a coluna da tabela. |
|
Remover itens vazios
|
DropEmptyItems | boolean |
Defina como true para ignorar (soltar) itens vazios na matriz. Defina como false para incluir todos os itens. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída (deve ser sempre 1). |
Obter a versão do PowerShell
Obtém a versão do PowerShell na sessão em que o agente de IA-Connect está em execução. Isso detecta o Microsoft PowerShell v3.x para v5.x, não o powershell core (6.x em diante).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do computador
|
ComputerName | string |
O nome do computador para verificar a versão do PowerShell. Se deixado em branco, o computador em que o agente IA-Connect está em execução será usado. |
|
|
Mecanismo de autenticação
|
AuthenticationMechanism | string |
O mecanismo de autenticação a ser usado se estiver se conectando a um computador remoto ou executando o script como um usuário alternativo. Os valores com suporte são 'Basic', 'Credssp', 'Default', 'Digest', 'Kerberos' e 'Negotiate'. |
|
|
Tentativas de conexão
|
ConnectionAttempts | integer |
O número de conexões para tentar se conectar a um computador remoto. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Versão principal do PowerShell
|
PowerShellMajorVersion | integer |
A versão principal (inteiro) do PowerShell. Por exemplo: o PowerShell 5.1 retornaria 5. |
|
Versão secundária do PowerShell
|
PowerShellMinorVersion | integer |
A versão secundária (após o local decimal) do PowerShell. Por exemplo: o PowerShell 5.1 retornaria 1. |
Obter cadeia de caracteres da célula da tabela JSON
Usa uma tabela de entrada no formato JSON e retorna uma célula especificada como uma cadeia de caracteres.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Índice de linha
|
RowIndex | integer |
O índice da linha que contém a célula a ser recuperada. Use 1 para a primeira linha, N para a nª linha. |
|
|
Índice de coluna
|
ColumnIndex | integer |
O índice da coluna que contém a célula a ser recuperada. Use 1 para a primeira coluna, N para a coluna Nth. Se você quiser recuperar uma coluna por nome, deixe essa entrada em branco e use a entrada "Nome da coluna". |
|
|
Nome da coluna
|
ColumnName | string |
O nome opcional da coluna que contém a célula a ser recuperada. Se você quiser recuperar uma coluna por índice, deixe essa entrada em branco e use a entrada "Índice de coluna". |
|
|
Fallback se a célula não existir
|
FallBackIfCellDoesNotExist | boolean |
Essa entrada controla o resultado se o índice de linha, o índice de coluna ou o nome especificados não existirem. Se essa entrada for definida como false (o padrão), haverá uma exceção. Se essa entrada for definida como true, a "cadeia de caracteres de saída" será definida como o valor de fallback, que pode estar em branco ou um valor de sua escolha. |
|
|
Valor de fallback
|
FallbackValue | string |
Se o índice de linha, o índice de coluna ou o nome especificados não existirem e a entrada 'Fallback se a célula não existir' for definida como true, esse valor de fallback será usado para a cadeia de caracteres de saída. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Cadeia de caracteres de saída
|
OutputString | string |
O conteúdo da célula de saída como uma cadeia de caracteres. |
Obter cadeia de caracteres entre
Usa uma cadeia de caracteres de entrada e retorna a primeira instância de uma cadeia de caracteres que está localizada entre duas cadeias de caracteres especificadas ou entre uma cadeia de caracteres e o final da linha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de entrada
|
InputString | string |
A cadeia de caracteres de entrada na qual a pesquisa é executada. |
|
|
Iniciar cadeia de caracteres de pesquisa
|
StartSearchString | string |
A cadeia de caracteres iniciar pesquisa. |
|
|
Cadeia de caracteres de pesquisa final
|
EndSearchString | string |
A cadeia de caracteres de pesquisa final ou deixe em branco se estiver pesquisando até o final da linha. |
|
|
Pesquisar linha por linha
|
SearchLineByLine | boolean |
Defina como true se você quiser pesquisar a cadeia de caracteres de entrada linha por linha e para que o resultado contenha apenas a cadeia de caracteres correspondente na linha atual. Defina como false para tratar a cadeia de caracteres de entrada como um único item. |
|
|
Gerar exceção se não for encontrado
|
ThrowExceptionIfNotFound | boolean |
Defina como true se você quiser que uma exceção seja gerada se a cadeia de caracteres de pesquisa não foi encontrada ou definida como false se a ação deve retornar 'String between found'=false quando a cadeia de caracteres de pesquisa não foi encontrada. |
|
|
Resultado do corte
|
TrimResult | boolean |
Defina como true se você quiser que espaços ou guias antes ou depois do resultado sejam cortados. |
|
|
A pesquisa é uma expressão regular
|
SearchIsRegularExpression | boolean |
Defina como true se as cadeias de caracteres de pesquisa forem expressões regulares. Defina como false se as cadeias de caracteres de pesquisa forem texto normal. |
|
|
Pesquisa confidencial de maiúsculas e minúsculas
|
CaseSensitiveSearch | boolean |
Defina como true se a pesquisa diferenciar maiúsculas de minúsculas. Defina como false para pesquisas que não diferenciam maiúsculas de minúsculas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Cadeia de caracteres de pesquisa encontrada
|
SearchStringFound | boolean |
Se 'Gerar exceção se não for encontrado' for definido como false, essa saída será definida como true se a cadeia de caracteres de pesquisa tiver sido encontrada, false se não for. |
|
Cadeia de caracteres entre
|
StringBetween | string |
A cadeia de caracteres encontrada entre as cadeias de caracteres especificadas. |
Obter coluna de IA-Connect lista
Recupera uma coluna de uma lista IA-Connect Orchestrator.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da lista
|
ListName | True | string |
O nome da lista Orchestrator. |
|
Índice de coluna de pesquisa
|
SearchColumnIndex | integer |
O índice da coluna na lista a ser retornada. Esse padrão é 1, que retorna a primeira coluna. Se você quiser recuperar uma coluna por nome, defina-a como 0 e especifique um nome de coluna. |
|
|
Nome da coluna de pesquisa
|
SearchColumnName | string |
O nome da coluna na lista a ser retornada, caso deseje recuperar uma coluna da lista pelo nome. Defina 'Índice de coluna de pesquisa' como 0, se você quiser usar essa entrada. |
|
|
Retornar células em branco
|
ReturnBlankCells | boolean |
Defina como true se você quiser incluir células em branco nos dados de retorno. Defina como false (o padrão) para incluir apenas células com valores. |
|
|
Fallback se a lista não existir
|
FallBackIfListDoesNotExist | boolean |
Essa entrada controla o resultado se a lista especificada não existir. Se essa entrada for definida como false (o padrão), haverá uma exceção. Se essa entrada for definida como true, a 'Lista de saída' (formatada no formato de retorno solicitado) será definida como o valor de fallback, que pode estar em branco ou um valor de sua escolha. |
|
|
Valor de fallback
|
FallbackValue | string |
Se a lista especificada não existir e a entrada 'Fallback se a lista não existir' for definida como true, esse valor de fallback será usado para a saída, formatada no formato de retorno solicitado. Isso é útil se você estiver lendo dados de tabelas de pesquisa e alguns itens de dados representarem uma lista, enquanto alguns itens são os dados reais. |
|
|
Formato de retorno
|
ReturnFormat | string |
O formato a ser usado ao retornar os resultados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
JSON da lista de saída
|
OutputListJSON | string |
A coluna de saída da lista, no formato JSON. |
|
Lista de saída
|
OutputList | array of object |
A coluna de saída da lista, no formato de tabela de dados. |
|
items
|
OutputList | object | |
|
Matriz de lista de saída
|
OutputListArray | array of object |
A coluna de saída da lista, em formato de matriz. |
|
items
|
OutputListArray | object | |
|
Número de linhas na saída
|
NumberOfRowsInOutput | integer |
O número de linhas na saída. |
Obter correspondência de expressão regular
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna se a cadeia de caracteres correspondeu à expressão e aos detalhes da correspondência.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada a ser correspondido
|
TextToMatch | True | string |
O texto de entrada a ser correspondido com a expressão regular. |
|
Expressão regular
|
Regex | True | string |
A expressão regular com a qual corresponder o texto de entrada. |
|
Índice de pesquisa
|
SearchIndex | integer |
O índice do resultado da correspondência a ser recuperado, começando em 1. Se você quiser corresponder ao primeiro resultado (o comportamento padrão), insira 1. Por exemplo: se uma cadeia de caracteres de entrada for esperada para corresponder à expressão regular em 5 locais e você estiver interessado na quarta correspondência, insira 4. |
|
|
Correspondência diferenciada de maiúsculas de minúscula
|
CaseSensitive | boolean |
Definido como true (o padrão) para uma correspondência que diferencia maiúsculas de minúsculas (por exemplo, A não é um) ou definido como false para uma correspondência que não diferencia maiúsculas de minúsculas (por exemplo, A e um são tratados como idênticos). |
|
|
Tempo limite do Regex em segundos
|
RegexTimeoutInSeconds | integer |
O número máximo de segundos que a expressão regular pode ser processada antes do tempo limite. Isso interrompe loops infinitos causados por determinadas expressões regulares. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Correspondência bem-sucedida
|
SuccessfulMatch | boolean |
True se houver uma correspondência bem-sucedida (no índice de pesquisa especificado) ou false se não houver. |
|
Corresponder ao valor da cadeia de caracteres
|
MatchStringValue | string |
Se houver uma correspondência bem-sucedida, esse valor de cadeia de caracteres mantém o texto do texto de entrada que correspondeu à expressão regular. |
|
Índice de posição de correspondência
|
MatchIndex | integer |
Se houver uma correspondência bem-sucedida, esse valor manterá a posição dentro do texto de entrada para corresponder onde a correspondência está localizada. Esse valor começa em 0, o que representa o início da cadeia de caracteres de texto de entrada. |
|
Comprimento da cadeia de caracteres de correspondência
|
MatchStringLength | integer |
Se houver uma correspondência bem-sucedida, esse valor mantém o comprimento do texto do texto de entrada que correspondeu à expressão regular (ou seja, o comprimento do valor de saída 'Valor da cadeia de caracteres de correspondência'). |
Obter correspondências de expressão regular
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna todas as correspondências em uma matriz de cadeia de caracteres. A matriz estará vazia se não houver correspondências.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada a ser correspondido
|
TextToMatch | True | string |
O texto de entrada a ser correspondido com a expressão regular. |
|
Expressão regular
|
Regex | True | string |
A expressão regular com a qual corresponder o texto de entrada. |
|
Máximo de correspondências a serem executadas
|
MaximumMatches | integer |
A quantidade máxima de correspondências de expressão regular a serem executadas. Para um número ilimitado de correspondências (ou seja, continuar correspondendo até que não haja mais correspondências) insira nenhum valor ou um valor de 0 (o padrão). Essa entrada foi projetada para evitar loops infinitos de expressão regular colocando um limite no número de correspondências. |
|
|
Correspondência diferenciada de maiúsculas de minúscula
|
CaseSensitive | boolean |
Definido como true (o padrão) para uma correspondência que diferencia maiúsculas de minúsculas (por exemplo, A não é um) ou definido como false para uma correspondência que não diferencia maiúsculas de minúsculas (por exemplo, A e um são tratados como idênticos). |
|
|
Resultados do corte
|
TrimResults | boolean |
Defina como true (o padrão) se cada elemento de matriz de saída individual deve ser cortado. |
|
|
Remover resultados vazios
|
RemoveEmptyResults | boolean |
Defina como true se elementos de matriz de saída vazios devem ser removidos da matriz de saída (ou seja, você não deseja resultados vazios). |
|
|
Tempo limite do Regex em segundos
|
RegexTimeoutInSeconds | integer |
O número máximo de segundos que a expressão regular pode ser processada antes do tempo limite. Isso interrompe loops infinitos causados por determinadas expressões regulares. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of object |
A matriz de cadeia de caracteres de saída que contém as correspondências de expressão regular individuais. |
|
items
|
OutputArray | object | |
|
Número de elementos na saída
|
NumberOfElementsInOutput | integer |
O número de elementos na matriz de saída. |
Obter correspondências de grupo de expressões regulares
Executa uma correspondência de expressão regular (regex) em uma cadeia de caracteres de entrada e retorna uma lista de valores e nomes de grupo correspondentes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada a ser correspondido
|
TextToMatch | True | string |
O texto de entrada a ser correspondido com a expressão regular. |
|
Expressão regular
|
Regex | True | string |
A expressão regular com a qual corresponder o texto de entrada. |
|
Grupos a serem recuperados
|
GroupsToRetrieve | array of string |
Uma matriz de cadeia de caracteres que contém os nomes dos grupos de expressões regulares a serem recuperados. Se uma matriz em branco for fornecida, todos os grupos serão recuperados. Por exemplo: se uma expressão regular contiver (?<NeedsUpdating>(Sim|Não)) e você especifica que o grupo 'NeedsUpdating' deve ser recuperado e, em seguida, o valor correspondente desse grupo nomeado será retornado. |
|
|
Índice de pesquisa
|
SearchIndex | integer |
O índice do resultado da correspondência a ser recuperado, começando em 1. Se você quiser corresponder ao primeiro resultado (o comportamento padrão), insira 1. Por exemplo: se uma cadeia de caracteres de entrada for esperada para corresponder à expressão regular em 5 locais e você estiver interessado na quarta correspondência, insira 4. |
|
|
Correspondência diferenciada de maiúsculas de minúscula
|
CaseSensitive | boolean |
Definido como true (o padrão) para uma correspondência que diferencia maiúsculas de minúsculas (por exemplo, A não é um) ou definido como false para uma correspondência que não diferencia maiúsculas de minúsculas (por exemplo, A e um são tratados como idênticos). |
|
|
Tempo limite do Regex em segundos
|
RegexTimeoutInSeconds | integer |
O número máximo de segundos que a expressão regular pode ser processada antes do tempo limite. Isso interrompe loops infinitos causados por determinadas expressões regulares. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Grupos de expressões regulares
|
RegexGroups | array of object |
Uma matriz que contém os nomes e valores dos grupos de expressões regulares correspondentes à cadeia de caracteres de entrada. |
|
Propriedade
|
RegexGroups.Property | string | |
|
Value
|
RegexGroups.Value | string | |
|
Número de grupos
|
NumberOfRegexGroups | integer |
O número de grupos de expressões regulares. |
Obter IA-Connect conteúdo da lista
Recupera todos os dados de uma lista IA-Connect Orchestrator.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da lista
|
ListName | True | string |
O nome da lista Orchestrator. |
|
Formato de retorno
|
ReturnFormat | string |
O formato a ser usado ao retornar os resultados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
JSON da lista de saída
|
OutputListJSON | string |
Os dados de saída da lista, no formato JSON. |
|
Lista de saída
|
OutputList | array of object |
Os dados de saída da lista, no formato de tabela de dados. |
|
items
|
OutputList | object | |
|
CSV da lista de saída
|
OutputListCSV | string |
Os dados de saída da lista, no formato CSV. |
|
Número de linhas na saída
|
NumberOfRowsInOutput | integer |
O número de linhas na saída. |
|
Número de colunas na saída
|
NumberOfColumnsInOutput | integer |
O número de colunas na saída. |
Obter IA-Connect conteúdo da tabela de pesquisa do Orchestrator
Recupera todos os dados de uma tabela de pesquisa do Orchestrator IA-Connect mantida no Orchestrator. Isso não recuperará uma tabela de pesquisa manipulada pelo agente IA-Connect (um arquivo CSV mantido em disco).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa orchestrator. |
|
Formato de retorno
|
ReturnFormat | string |
O formato a ser usado ao retornar os resultados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de pesquisa de saída JSON
|
OutputLookupTableJSON | string |
Os dados de saída da tabela de pesquisa, no formato JSON. |
|
Tabela de pesquisa de saída
|
OutputLookupTable | array of object |
Os dados de saída da tabela de pesquisa, no formato de tabela de dados. |
|
items
|
OutputLookupTable | object | |
|
CSV da tabela de pesquisa de saída
|
OutputLookupTableCSV | string |
Os dados de saída da tabela de pesquisa, no formato CSV. |
|
Número de linhas na saída
|
NumberOfRowsInOutput | integer |
O número de linhas na saída. |
|
Número de colunas na saída
|
NumberOfColumnsInOutput | integer |
O número de colunas na saída. |
Obter IA-Connect resumo da tabela de pesquisa
Recupera um resumo das tabelas de pesquisa atualmente carregadas no agente de 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 |
|---|---|---|---|
|
Tabelas de pesquisa JSON
|
LookupTablesJSON | array of object |
As tabelas de pesquisa carregadas no agente de IA-Connect. |
|
Nome
|
LookupTablesJSON.Name | string | |
|
ThenColumnIndex
|
LookupTablesJSON.ThenColumnIndex | integer | |
|
NumberOfRows
|
LookupTablesJSON.NumberOfRows | integer | |
|
NumberOfColumns
|
LookupTablesJSON.NumberOfColumns | integer | |
|
NumberOfUniqueHeaderProperties
|
LookupTablesJSON.NumberOfUniqueHeaderProperties | integer | |
|
Número de tabelas de pesquisa
|
NumberOfLookupTables | integer |
O número de tabelas de pesquisa atualmente carregadas no agente de IA-Connect. |
Obter matriz de cadeia de caracteres da coluna da tabela JSON
Usa uma tabela de entrada no formato JSON e retorna uma coluna especificada como uma matriz de cadeia de caracteres. Se você quiser obter uma matriz de cadeia de caracteres de uma tabela real (ou seja, não no formato JSON), use a ação "Obter matriz da tabela".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Índice de coluna
|
ColumnIndex | integer |
O índice da coluna a ser retornado como uma matriz. Use 1 para a primeira coluna, N para a coluna Nth. Se você quiser recuperar uma coluna por nome, deixe essa entrada em branco e use a entrada "Nome da coluna". |
|
|
Nome da coluna
|
ColumnName | string |
O nome opcional da coluna a ser retornada como uma matriz. Se você quiser recuperar uma coluna por índice, deixe essa entrada em branco e use a entrada "Índice de coluna". |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of string |
A matriz de saída de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Obter matriz de cadeia de caracteres da coluna de tabela
Usa uma tabela de entrada e retorna uma coluna especificada como uma matriz de cadeia de caracteres. Se você quiser obter uma matriz de cadeia de caracteres de uma tabela no formato JSON, use a ação "Obter matriz da tabela JSON".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Índice de coluna
|
ColumnIndex | integer |
O índice da coluna a ser retornado como uma matriz. Use 1 para a primeira coluna, N para a coluna Nth. Se você quiser recuperar uma coluna por nome, deixe essa entrada em branco e use a entrada "Nome da coluna". |
|
|
Nome da coluna
|
ColumnName | string |
O nome opcional da coluna a ser retornada como uma matriz. Se você quiser recuperar uma coluna por índice, deixe essa entrada em branco e use a entrada "Índice de coluna". |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Matriz de saída
|
OutputArray | array of string |
A matriz de saída de cadeias de caracteres. |
|
Número de itens
|
NumberOfItems | integer |
O número de itens na matriz de saída. |
Obter tabela da matriz de cadeia de caracteres
Usa uma matriz de entrada de itens de cadeia de caracteres e retorna como uma tabela.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Matriz de entrada
|
InputArray | True | array of string |
A matriz de entrada de cadeias de caracteres. |
|
Nome da coluna
|
ColumnName | True | string |
O nome a ser usado para a coluna da tabela. |
|
Remover itens vazios
|
DropEmptyItems | boolean |
Defina como true para ignorar (soltar) itens vazios na matriz. Defina como false para incluir todos os itens. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída (deve ser sempre 1). |
Obter tabela do JSON
Usa uma tabela de entrada no formato JSON e retorna como uma tabela. Isso é conhecido como desserialização.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Iniciar índice de linha
|
StartRowIndex | True | integer |
O índice da primeira linha a ser recuperada. Use 1 para iniciar na primeira linha, N para iniciar na Nª linha. |
|
Número de linhas a serem recuperadas
|
NumberOfRowsToRetrieve | integer |
O número de linhas a serem recuperadas. Use 0 (ou deixe em branco) para recuperar todas as linhas. |
|
|
Iniciar índice de coluna
|
StartColumnIndex | integer |
O índice da primeira coluna a ser recuperada. Use 1 para iniciar na primeira coluna, N para iniciar na coluna Nth. Se você quiser especificar a primeira coluna a ser recuperada pelo nome, deixe essa entrada em branco e use a entrada "Nome da coluna Iniciar". |
|
|
Nome da coluna Iniciar
|
StartColumnName | string |
O nome opcional da primeira coluna a ser recuperada. Se você quiser recuperar colunas por índice, deixe essa entrada em branco e use a entrada "Índice iniciar coluna". |
|
|
Número de colunas a serem recuperadas
|
NumberOfColumnsToRetrieve | integer |
O número de colunas a serem recuperadas. Use 0 (ou deixe em branco) para recuperar todas as colunas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída (deve ser sempre 1). |
Pesquisar células de dados de IA-Connect tabela de pesquisa
Recupera todas as células de dados de uma tabela de pesquisa do Orchestrator (para automações usando o Orchestrator), da primeira linha que corresponde aos dados de entrada e retorna como uma tabela. Essa ação não dá suporte a tabelas de pesquisa carregadas no agente de IA-Connect.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa orchestrator. |
|
JSON de dados de entrada
|
InputDataJSON | string |
Dados de entrada a serem usados para a pesquisa, no formato JSON. Por exemplo, se a tabela de pesquisa tiver colunas de propriedade 'JobTitle' e 'Country', você poderá enviar o seguinte JSON: { "JobTitle": "Consultant", "Country": "England" }. |
|
|
Gerar exceção se não houver correspondência
|
RaiseExceptionIfNoMatch | boolean |
Defina como true (o padrão) para gerar uma exceção se a pesquisa não corresponder a nenhum dado. Defina como false para retornar uma cadeia de caracteres em branco se a pesquisa não corresponder a nenhum dado. |
|
|
Retornar células em branco
|
ReturnBlankCells | boolean |
Defina como true se você quiser incluir células em branco na tabela de retorno. Defina como false (o padrão) para incluir apenas células de dados com valores. |
|
|
Formato de retorno
|
ReturnFormat | string |
O formato a ser usado ao retornar os resultados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de pesquisa de saída JSON
|
OutputLookupTableJSON | string |
A tabela de saída que contém as células de dados da linha que corresponde aos dados de entrada, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. A tabela de saída terá uma linha e uma ou mais colunas de dados no formato JSON. |
|
Tabela de pesquisa de saída
|
OutputLookupTable | array of object |
A tabela de saída que contém as células de dados da linha que corresponde aos dados de entrada, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. A tabela de saída terá uma linha e uma ou mais colunas de dados. |
|
items
|
OutputLookupTable | object | |
|
Número de células na saída
|
NumberOfCellsInOutput | integer |
O número de células na saída. |
Remover caracteres da cadeia de caracteres
Usa uma cadeia de caracteres de entrada e retorna-a com os caracteres especificados removidos. Se os caracteres especificados não estiverem localizados, a cadeia de caracteres original será retornada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de entrada
|
InputString | string |
A cadeia de caracteres de entrada na qual a remoção do caractere é executada. |
|
|
Caracteres a serem removidos da cadeia de caracteres de entrada
|
CharactersToRemoveFromInputString | string |
Uma cadeia de caracteres que contém todos os caracteres que você deseja remover das entradas. Por exemplo: !@&?^*. |
|
|
Remover diacríticos da cadeia de caracteres de entrada
|
RemoveDiacriticsFromInputString | boolean |
Se definido como true, IA-Connect tentará remover todos os diacríticos da cadeia de caracteres de entrada, substituindo caracteres por um diacrítico pelo mesmo caractere menos o diacrítico. Por exemplo: substituindo "acentos agudos a" por "a". Em cenários em que não há mapeamento direto para um caractere simples, o caractere é removido. Por exemplo: o S afiado alemão é removido. |
|
|
Remover não alfanumérico da cadeia de caracteres de entrada
|
RemoveNonAlphaNumericFromInputString | boolean |
Se definido como true, IA-Connect removerá todos os caracteres não alfanuméricos da cadeia de caracteres de entrada. |
|
|
Remover caracteres numéricos da cadeia de caracteres de entrada
|
RemoveNumericFromInputString | boolean |
Se definido como true, IA-Connect removerá todos os caracteres numéricos da cadeia de caracteres de entrada. |
|
|
Remover caracteres minúsculos da cadeia de caracteres de entrada
|
RemoveLowercaseCharactersFromInputString | boolean |
Se definido como true, IA-Connect removerá todos os caracteres alfabéticos minúsculos da cadeia de caracteres de entrada. |
|
|
Remover caracteres maiúsculos da cadeia de caracteres de entrada
|
RemoveUppercaseCharactersFromInputString | boolean |
Se definido como true, IA-Connect removerá todos os caracteres alfabéticos maiúsculos da cadeia de caracteres de entrada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Cadeia de caracteres de saída
|
OutputString | string |
A cadeia de caracteres com os caracteres removidos. Essa será a cadeia de caracteres original se nenhum caractere especificado for encontrado. |
Remover IA-Connect tabela de pesquisa
Remove uma tabela de pesquisa atualmente carregada no agente de IA-Connect.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa carregada no agente de IA-Connect. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
RemoveIAConnectLookupTableResult | 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. |
Remover todas as tabelas de pesquisa IA-Connect
Remove todas as tabelas de pesquisa atualmente carregadas no agente de 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 |
|---|---|---|---|
|
Resultado do comando
|
RemoveAllIAConnectLookupTablesResult | 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. |
Renomear uma coluna em uma tabela
Usa uma tabela de entrada, renomeia uma coluna especificada e retorna uma nova tabela. Se você quiser renomear uma coluna de uma tabela no formato JSON, use a ação "Renomear uma coluna em uma tabela JSON".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Nome da coluna de origem
|
SourceColumnName | True | string |
O nome da coluna a ser renomeada. |
|
Nome da nova coluna
|
NewColumnName | True | string |
O novo nome da coluna. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Renomear uma coluna em uma tabela JSON
Usa uma tabela de entrada no formato JSON, renomeia uma coluna especificada e retorna uma nova tabela no formato JSON. Se você quiser renomear uma coluna de uma tabela real (ou seja, não no formato JSON), use a ação "Renomear uma coluna em uma tabela".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela JSON de entrada
|
JSONTable | True | string |
A tabela de entrada no formato JSON. |
|
Nome da coluna de origem
|
SourceColumnName | True | string |
O nome da coluna a ser renomeada. |
|
Nome da nova coluna
|
NewColumnName | True | string |
O novo nome da coluna. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela JSON de saída
|
OutputJSONTable | string |
A tabela de saída no formato JSON. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Tabela de classificação
Usa uma tabela de entrada, classifica uma ou mais linhas e retorna uma nova tabela. Se você quiser classificar uma tabela no formato JSON, use a ação 'Classificar tabela JSON'. Se você quiser classificar uma matriz de cadeia de caracteres, use a ação "Classificar matriz de cadeia de caracteres".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tabela de entrada
|
Input table | object | ||
|
Nome da coluna de classificação
|
SortColumnName | True | string |
O nome da coluna pelo qual classificar. Se você quiser classificar por várias colunas, liste a vírgula de colunas separada. |
|
Classificação crescente
|
Ascending | True | boolean |
Defina como true para classificar em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
Nome da coluna de classificação 2
|
SortColumnName2 | string |
Um nome opcional de segunda coluna a ser classificado (após a classificação pela primeira coluna). |
|
|
Classificação crescente 2
|
Ascending2 | boolean |
Defina como true para classificar o nome da segunda coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
|
|
Nome da coluna de classificação 3
|
SortColumnName3 | string |
Um nome opcional de terceira coluna para classificar (após a classificação pela primeira e segunda colunas). |
|
|
Classificação crescente 3
|
Ascending3 | boolean |
Defina como true para classificar o nome da terceira coluna em uma ordem crescente. Defina como false para classificar em uma ordem decrescente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tabela de saída
|
OutputTable | array of object |
A tabela de saída. |
|
items
|
OutputTable | object | |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na tabela de saída. |
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na tabela de saída. |
Valor de pesquisa de IA-Connect tabela de pesquisa
Recupera um valor de uma tabela de pesquisa do Orchestrator (para automações usando o Orchestrator) ou uma tabela de pesquisa atualmente carregada no agente de IA-Connect, da primeira linha que corresponde aos dados de entrada. Se o Orchestrator tiver uma tabela de pesquisa com o mesmo nome que uma carregada no agente de IA-Connect, a tabela de pesquisa do Orchestrator será usada (se a automação estiver passando pelo Orchestrator).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela de pesquisa
|
LookupTableName | True | string |
O nome da tabela de pesquisa do Orchestrator ou da tabela de pesquisa carregada no agente de IA-Connect. |
|
JSON de dados de entrada
|
InputDataJSON | string |
Dados de entrada a serem usados para a pesquisa, no formato JSON. Por exemplo, se a tabela de pesquisa tiver colunas de propriedade 'JobTitle' e 'Country', você poderá enviar o seguinte JSON: { "JobTitle": "Consultant", "Country": "England" }. |
|
|
Nome da coluna de valor do resultado da pesquisa
|
SearchResultValueColumnName | True | string |
A coluna na tabela de pesquisa que contém o valor retornado a ser lido. |
|
Índice de coluna de valor do resultado da pesquisa
|
SearchResultValueColumnIndex | integer |
Se definido como 1 (o padrão), o valor da primeira coluna de resultado correspondente ao nome solicitado será retornado. Defina como um valor mais alto (N) para retornar a coluna de correspondência Nth. |
|
|
Gerar exceção se não houver correspondência
|
RaiseExceptionIfNoMatch | boolean |
Defina como true (o padrão) para gerar uma exceção se a pesquisa não corresponder a nenhum dado. Defina como false para retornar uma cadeia de caracteres em branco se a pesquisa não corresponder a nenhum dado. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor de pesquisa de saída
|
OutputLookupValue | string |
O valor de saída da coluna da tabela de pesquisa especificada, obtida pesquisando os dados de entrada na tabela de pesquisa IA-Connect. |