Compartir a través de


IA-Connect código dinámico (versión preliminar)

IA-Connect es una plataforma "RPA" de Automatización de procesos robóticos que agrega funcionalidad RPA desde la nube a máquinas virtuales locales o a través de conexiones "RDS" de Citrix o Escritorio remoto de Microsoft. Este es el módulo para desarrollar módulos de código dinámico.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Ultima Labs
URL https://www.ultima.com/ultima-labs
Correo Electrónico IAConnect@ultima.com
Metadatos del conector
Publicador Última Empresa
Sitio web https://www.ultima.com/ultima-labs
Directiva de privacidad https://www.ultima.com/privacy-policy
Categorías Operaciones de TI; Productividad

IA-Connect es una plataforma de Automatización de procesos robóticos (RPA) que agrega funcionalidad de RPA desde Flujos de Power Automate Cloud a máquinas virtuales locales o a través de conexiones de Citrix o Escritorio remoto de Microsoft (RDS). Los conectores de IA-Connect proporcionan más de 800 acciones, lo que le permite automatizar cada tipo de aplicación local directamente desde un flujo de nube de Power Automate. Todas las acciones de IA-Connect están disponibles directamente desde Power Automate Cloud Flow, lo que proporciona una integración sencilla entre aplicaciones locales y basadas en la nube, la capacidad de aprovechar las condiciones, bucles, contenido dinámico, expresiones y control de excepciones existentes en los procesos de RPA. La utilización de los conectores de IA-Connect también proporciona un historial de ejecución completo y una auditoría del historial de ejecución de Flow, a la vez que elimina la necesidad de tener una aplicación, consola o estudio independiente para desarrollar los procesos de RPA.

Prerrequisitos

Para usar cualquiera de los conectores de IA-Connect, debe instalar el software IA-Connect. Esto es gratuito para probar durante 30 días, después de lo cual necesitará una licencia de IA-Connect.

El software IA-Connect consta de dos componentes principales:

  • La IA-Connect Orchestrator, que es una aplicación web de Azure que hospedaría en su propio inquilino de Azure. Esto controla el enrutamiento y la seguridad de los flujos de RPA a una o varias máquinas virtuales locales o basadas en la nube.

  • El agente y el director de IA-Connect, que se instalan en las máquinas virtuales donde se puede acceder al software que desea automatizar. Además, el agente de IA-Connect puede ejecutarse dentro de una sesión de Citrix o Microsoft Remote Desktop Services (RDS), donde los comandos de RPA se pasan a un canal virtual en la sesión remota para su ejecución. El agente de IA-Connect se puede ejecutar desde un recurso compartido de red y no requiere instalación.

Conectores de IA-Connect disponibles

Los conectores de IA-Connect disponibles son:

  • IA-Connect código dinámico
  • IA-Connect Java
  • IA-Connect JML
  • sistema central de IA-Connect
  • IA-Connect Microsoft Office
  • IA-Connect GUI de SAP
  • sesión de IA-Connect
  • interfaz de usuario de IA-Connect
  • explorador web de IA-Connect

Obtención de credenciales

Para recibir su licencia y comenzar su evaluación gratuita de 30 días, envíe una solicitud en nuestro sitio web (https://www.ultima.com/IA-Connect/Power-Automate).

Una vez recibida una solicitud de evaluación, nos pondrá en contacto con usted a través de la dirección de correo electrónico proporcionada para ayudar a configurar el software de IA-Connect y para proporcionarle la licencia de prueba. Esta es una prueba completa y le permitirá probar cualquiera de las 800 acciones en todos los 9 conectores IA-Connect dentro de su propio entorno durante el período de prueba.

Introducción al conector

Después de enviar una solicitud de prueba para IA-Connect, podrá descargar un archivo ZIP que contenga el software IA-Connect y la documentación que cubre la instalación y la instalación. También nos pondrá en contacto con usted para ofrecer soporte técnico e instrucciones a través del proceso de instalación según sea necesario.

Support

Durante el período de prueba, puede ponerse en contacto con Ultima Labs (IAConnect@ultima.com) para obtener soporte técnico y asistencia.

Al comprar licencias IA-Connect recibirá tokens de soporte técnico que se pueden canjear por formación o soporte técnico personalizados del Centro de Servicios Técnicos (TSC) basado en Reino Unido de Ultima.

Problemas conocidos, errores comunes y preguntas más frecuentes

Nuestra Knowledge Base contiene una serie de artículos que abarcan cualquier problema conocido, errores comunes que pueden producirse al usar los conectores de IA-Connect y las preguntas más frecuentes. Esto es accesible en https://support.ultima.com/ultimalabs y se proporciona una cuenta para acceder a estos recursos durante la prueba de IA-Connect y después de comprar una licencia de IA-Connect.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto
dirección de IA-Connect Orchestrator cuerda / cadena Especificar la dirección IA-Connect Orchestrator sin el componente HTTP(S) Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Agregar carpeta de búsqueda de ensamblados

Agrega una ruta de acceso de carpeta (en el equipo en el que se ejecuta el agente de IA-Connect) a la lista de carpetas del agente de IA-Connect para examinar cuando intenta cargar una referencia externa.

Borrar carpetas de búsqueda de ensamblados

Restablezca la lista adicional de carpetas para que el agente de IA-Connect examine cuando intenta cargar una referencia externa.

Buscar celdas de datos de IA-Connect tabla de búsqueda

Recupera todas las celdas de datos de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator), desde la primera fila que coincide con los datos de entrada y devuelve como una tabla. Esta acción no admite tablas de búsqueda cargadas en el agente de IA-Connect.

Cambiar el nombre de una columna de una tabla

Toma una tabla de entrada, cambia el nombre de una columna especificada y devuelve una nueva tabla. Si desea cambiar el nombre de una columna de una tabla en formato JSON, use la acción "Cambiar el nombre de una columna en una tabla JSON".

Cambiar el nombre de una columna en una tabla JSON

Toma una tabla de entrada en formato JSON, cambia el nombre de una columna especificada y devuelve una nueva tabla en formato JSON. Si desea cambiar el nombre de una columna de una tabla real (es decir, no en formato JSON), use la acción "Cambiar el nombre de una columna en una tabla".

Carga de CSV en IA-Connect lista de Orchestrator

Cargue los datos CSV de reemplazo en una lista de orquestador de IA-Connect, reemplazando cualquier contenido existente.

Carga de CSV en IA-Connect tabla de búsqueda de Orchestrator

Cargue los datos CSV de reemplazo en una tabla de búsqueda de IA-Connect Orchestrator, reemplazando cualquier contenido existente. Esta acción no interactuará con una tabla de búsqueda controlada por el agente de IA-Connect (un archivo CSV mantenido en disco).

Cargar IA-Connect tabla de búsqueda

Carga una tabla de búsqueda IA-Connect desde el equipo donde se ejecuta el agente de IA-Connect. Estas tablas de búsqueda se pueden usar con más IA-Connect acciones para realizar búsquedas de datos.

Columnas de búsqueda de IA-Connect tabla de búsqueda

Recupera una o varias columnas con nombre idéntico de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator) o una tabla de búsqueda cargada actualmente en el agente de IA-Connect, desde la primera fila que coincide con los datos de entrada y devuelve como una tabla. Por ejemplo, la tabla de búsqueda podría contener varias columnas de salida denominadas "Grupo de AD" para representar varios grupos de AD y se devolverán como filas independientes en la tabla de salida. Si Orchestrator tiene una tabla de búsqueda con el mismo nombre que uno cargado en el agente de IA-Connect, se usa la tabla de búsqueda de Orchestrator (si la automatización pasa por Orchestrator).

Conversión de matriz en JSON

Toma una matriz de entrada y serializa en una cadena JSON.

Creación de JSON a partir de variables de entrada

Toma una matriz de variables de entrada y devuelve en formato JSON y, opcionalmente, como una tabla JSON.

Dividir cadena mediante una expresión regular

Divide una cadena de entrada mediante una coincidencia de expresión regular (regex) y devuelve los componentes divididos individuales de la cadena como una matriz de cadenas.

Ejecución del script de PowerShell

Ejecuta un script de PowerShell en la sesión en la que se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect en la entrada "Contenido del script de PowerShell" (PowerShellScriptContents). Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente. El Agente ejecuta PowerShell con Microsoft PowerShell v3.x a v5.x (la versión instalada), no powerShell Core (6.x en adelante).

Eliminación de columnas de una tabla

Toma una tabla de entrada, elimina una columna o columnas y devuelve una nueva tabla. Si desea eliminar columnas de una tabla en formato JSON, use la acción "Eliminar columnas de una tabla JSON".

Eliminación de columnas de una tabla JSON

Toma una tabla de entrada en formato JSON, elimina una columna o columnas y devuelve una nueva tabla en formato JSON. Si desea eliminar columnas de una tabla real (es decir, no en formato JSON), use la acción "Eliminar columnas de una tabla".

Eliminación de elementos de una matriz de cadenas

Toma una matriz de entrada de elementos de cadena, elimina un elemento o elementos en una posición especificada y devuelve una nueva matriz. Si desea eliminar una fila o filas de una tabla, use la acción "Eliminar una fila de una tabla". Si desea eliminar una fila o filas de una tabla en formato JSON, use la acción "Eliminar una fila de una tabla JSON".

Eliminación de filas de una tabla

Toma una tabla de entrada, elimina una fila o filas en una posición especificada y devuelve una nueva tabla. Si desea eliminar una fila o filas de una matriz de cadenas, use la acción "Eliminar una fila de una matriz de cadenas". Si desea eliminar una fila o filas de una tabla en formato JSON, use la acción "Eliminar una fila de una tabla JSON".

Eliminación de filas de una tabla JSON

Toma una tabla de entrada en formato JSON, elimina una fila o filas en una posición especificada y devuelve una nueva tabla en formato JSON. Si desea eliminar una fila o filas de una tabla real (es decir, no en formato JSON), use la acción "Eliminar una fila de una tabla". Si desea eliminar una fila o filas de una matriz de cadenas, use la acción "Eliminar una fila de una matriz de cadenas".

Eliminación de todas las tablas de búsqueda de IA-Connect

Quita todas las tablas de búsqueda cargadas actualmente en el agente de IA-Connect.

Filtrar matriz de cadenas

Toma una matriz de entrada de elementos de cadena, filtra la matriz (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva matriz. Si desea filtrar una tabla, use la acción "Filtrar tabla". Si desea filtrar una tabla en formato JSON, use la acción "Filtrar tabla JSON".

Filtrar tabla JSON

Toma una tabla JSON de entrada, filtra la tabla (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva tabla JSON. Si desea filtrar una tabla real (es decir, no en formato JSON), use la acción "Filtrar tabla". Si desea filtrar una matriz de cadenas, use la acción "Filtrar matriz de cadenas".

Importación del ensamblado desde el archivo local

Carga un ensamblado de DotNet desde el equipo en el que se ejecuta el IA-Connect Director en el agente de IA-Connect donde se carga en la memoria y se usará si se hace referencia a él mediante código DotNet dinámico.

Insertar una fila de variables de entrada en una tabla JSON

Toma una tabla de entrada en formato JSON, inserta una fila creada a partir de variables de entrada en una posición especificada y devuelve una nueva tabla en formato JSON. El esquema de fila de entrada debe coincidir con el de la tabla de entrada (es decir, use los mismos nombres de propiedad y tipos de datos). Si desea insertar una fila en una tabla real (es decir, no en formato JSON), use la acción "Insertar una fila en una tabla". Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas".

Insertar una fila en una matriz de cadenas

Toma una matriz de entrada de elementos de cadena, inserta una fila en una posición especificada y devuelve una nueva matriz. Si desea insertar una fila en una tabla, use la acción "Insertar una fila en una tabla". Si desea insertar una fila en una tabla en formato JSON, use la acción "Insertar una fila en una tabla JSON".

Insertar una fila en una tabla

Toma una tabla de entrada, inserta una fila en una posición especificada y devuelve una nueva tabla. Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas". Si desea insertar una fila en una tabla en formato JSON, use la acción "Insertar una fila en una tabla JSON".

Insertar una fila en una tabla JSON

Toma una tabla de entrada en formato JSON, inserta una fila en una posición especificada y devuelve una nueva tabla en formato JSON. Si desea insertar una fila en una tabla real (es decir, no en formato JSON), use la acción "Insertar una fila en una tabla". Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas".

Obtención de cadena de la celda de tabla JSON

Toma una tabla de entrada en formato JSON y devuelve una celda especificada como una cadena.

Obtención de coincidencias de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve todas las coincidencias de una matriz de cadenas. La matriz estará vacía si no hubiera ninguna coincidencia.

Obtención de coincidencias de grupo de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve una lista de nombres y valores de grupo coincidentes.

Obtención de la coincidencia de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve si la cadena coincide con la expresión y los detalles de la coincidencia.

Obtención de la matriz de cadenas de la columna de tabla

Toma una tabla de entrada y devuelve una columna especificada como una matriz de cadenas. Si desea obtener una matriz de cadenas de una tabla en formato JSON, use la acción "Obtener matriz de la tabla JSON".

Obtención de la matriz de cadenas de la columna de tabla JSON

Toma una tabla de entrada en formato JSON y devuelve una columna especificada como una matriz de cadenas. Si desea obtener una matriz de cadenas de una tabla real (es decir, no en formato JSON), use la acción "Obtener matriz de la tabla".

Obtención de la tabla de la matriz de cadenas

Toma una matriz de entrada de elementos de cadena y devuelve como una tabla.

Obtención de la tabla JSON de la matriz de cadenas

Toma una matriz de entrada de elementos de cadena y devuelve como una tabla JSON.

Obtención de la versión de PowerShell

Obtiene la versión de PowerShell en la sesión donde se ejecuta el agente de IA-Connect. Esto detecta Microsoft PowerShell v3.x a v5.x, no powerShell Core (6.x en adelante).

Obtención de tabla de JSON

Toma una tabla de entrada en formato JSON y devuelve como una tabla. Esto se conoce como deserialización.

Obtener cadena entre

Toma una cadena de entrada y devuelve la primera instancia de una cadena que se encuentra entre dos cadenas especificadas o entre una cadena y el final de la línea.

Obtener columna de IA-Connect lista

Recupera una columna de una lista de orquestador de IA-Connect.

Obtener IA-Connect contenido de la lista

Recupera todos los datos de una lista de IA-Connect Orchestrator.

Obtener IA-Connect contenido de la tabla de búsqueda de Orchestrator

Recupera todos los datos de una tabla de búsqueda de IA-Connect Orchestrator que se mantiene en Orchestrator. Esto no recuperará una tabla de búsqueda controlada por el agente de IA-Connect (un archivo CSV mantenido en disco).

Obtener IA-Connect resumen de la tabla de búsqueda

Recupera un resumen de las tablas de búsqueda cargadas actualmente en el agente de IA-Connect.

Ordenar matriz de cadenas

Toma una matriz de entrada de elementos de cadena, ordena la matriz y devuelve una nueva matriz. Si desea ordenar una tabla, use la acción "Ordenar tabla". Si desea ordenar una tabla en formato JSON, use la acción "Ordenar tabla JSON".

Ordenar tabla

Toma una tabla de entrada, ordena una o varias filas y devuelve una nueva tabla. Si desea ordenar una tabla en formato JSON, use la acción "Ordenar tabla JSON". Si desea ordenar una matriz de cadenas, use la acción "Ordenar matriz de cadenas".

Ordenar tabla JSON

Toma una tabla JSON de entrada, ordena la tabla y devuelve una nueva tabla JSON. Si desea ordenar una tabla real (es decir, no en formato JSON), use la acción "Ordenar tabla". Si desea ordenar una matriz de cadenas, use la acción "Ordenar matriz de cadenas".

Quitar caracteres de la cadena

Toma una cadena de entrada y la devuelve con caracteres especificados quitados. Si los caracteres especificados no se encuentran, se devolverá la cadena original.

Quitar IA-Connect tabla de búsqueda

Quita una tabla de búsqueda cargada actualmente en el agente de IA-Connect.

Tabla de filtro

Toma una tabla de entrada, filtra la tabla (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva tabla. Si desea filtrar una tabla en formato JSON, use la acción "Filtrar tabla JSON". Si desea filtrar una matriz de cadenas, use la acción "Filtrar matriz de cadenas".

Valor de búsqueda de IA-Connect tabla de búsqueda

Recupera un valor de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator) o una tabla de búsqueda cargada actualmente en el agente de IA-Connect, desde la primera fila que coincide con los datos de entrada. Si Orchestrator tiene una tabla de búsqueda con el mismo nombre que uno cargado en el agente de IA-Connect, se usa la tabla de búsqueda de Orchestrator (si la automatización pasa por Orchestrator).

¿Está instalada la automatización de PowerShell?

Informa de si la automatización de PowerShell está disponible en el equipo en el que se ejecuta el agente de IA-Connect. Si la automatización de PowerShell no está disponible, las acciones de automatización de PowerShell no funcionarán.

¿Está instalado el módulo de PowerShell?

Busca un módulo de PowerShell especificado en el equipo donde se ejecuta el agente de IA-Connect y devuelve si está instalado.

Agregar carpeta de búsqueda de ensamblados

Agrega una ruta de acceso de carpeta (en el equipo en el que se ejecuta el agente de IA-Connect) a la lista de carpetas del agente de IA-Connect para examinar cuando intenta cargar una referencia externa.

Parámetros

Nombre Clave Requerido Tipo Description
Folder path (Ruta de acceso a la carpeta)
FolderPath True string

Ruta de acceso a la carpeta que se va a agregar a la lista de carpetas del agente de IA-Connect para examinar cuándo intenta cargar una referencia externa.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Borrar carpetas de búsqueda de ensamblados

Restablezca la lista adicional de carpetas para que el agente de IA-Connect examine cuando intenta cargar una referencia externa.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Buscar celdas de datos de IA-Connect tabla de búsqueda

Recupera todas las celdas de datos de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator), desde la primera fila que coincide con los datos de entrada y devuelve como una tabla. Esta acción no admite tablas de búsqueda cargadas en el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

Nombre de la tabla de búsqueda de Orchestrator.

JSON de datos de entrada
InputDataJSON string

Datos de entrada que se usarán para la búsqueda, en formato JSON. Por ejemplo, si la tabla de búsqueda tiene columnas de propiedad 'JobTitle' y 'Country', podría enviar el siguiente json: { "JobTitle": "Consultor", "Country": "Inglaterra" }.

Generar excepción si no hay ninguna coincidencia
RaiseExceptionIfNoMatch boolean

Establézcalo en true (valor predeterminado) para generar una excepción si la búsqueda no coincide con ningún dato. Establézcalo en false para devolver una cadena en blanco si la búsqueda no coincide con ningún dato.

Devolver celdas en blanco
ReturnBlankCells boolean

Establézcalo en true si desea incluir celdas en blanco en la tabla de retorno. Establézcalo en false (valor predeterminado) para incluir solo celdas de datos con valores.

Formato de devolución
ReturnFormat string

Formato que se va a usar al devolver los resultados.

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de tabla de búsqueda de salida
OutputLookupTableJSON string

Tabla de salida que contiene las celdas de datos de la fila que coinciden con los datos de entrada, obtenidos al buscar los datos de entrada en la tabla de búsqueda de IA-Connect. La tabla de salida tendrá una fila y una o varias columnas de datos, en formato JSON.

Tabla de búsqueda de salida
OutputLookupTable array of object

Tabla de salida que contiene las celdas de datos de la fila que coinciden con los datos de entrada, obtenidos al buscar los datos de entrada en la tabla de búsqueda de IA-Connect. La tabla de salida tendrá una fila y una o varias columnas de datos.

items
OutputLookupTable object
Número de celdas en la salida
NumberOfCellsInOutput integer

Número de celdas de la salida.

Cambiar el nombre de una columna de una tabla

Toma una tabla de entrada, cambia el nombre de una columna especificada y devuelve una nueva tabla. Si desea cambiar el nombre de una columna de una tabla en formato JSON, use la acción "Cambiar el nombre de una columna en una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Nombre de columna de origen
SourceColumnName True string

Nombre de la columna que se va a cambiar.

Nuevo nombre de columna
NewColumnName True string

Nuevo nombre de la columna.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Cambiar el nombre de una columna en una tabla JSON

Toma una tabla de entrada en formato JSON, cambia el nombre de una columna especificada y devuelve una nueva tabla en formato JSON. Si desea cambiar el nombre de una columna de una tabla real (es decir, no en formato JSON), use la acción "Cambiar el nombre de una columna en una tabla".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Nombre de columna de origen
SourceColumnName True string

Nombre de la columna que se va a cambiar.

Nuevo nombre de columna
NewColumnName True string

Nuevo nombre de la columna.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Carga de CSV en IA-Connect lista de Orchestrator

Cargue los datos CSV de reemplazo en una lista de orquestador de IA-Connect, reemplazando cualquier contenido existente.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de lista
ListName True string

Nombre de la lista de Orchestrator.

Datos CSV
CSVData True string

Datos CSV de reemplazo que se van a almacenar en la lista de Orchestrator. Si la lista ya existe, el contenido de la lista se reemplazará por estos datos CSV. No puede proporcionar una entrada CSV vacía, pero puede proporcionar una fila de encabezado CSV sin filas de datos.

Crear lista si no existe
CreateListIfNotExist boolean

Si se establece en false (valor predeterminado) y la lista con nombre aún no existe, se generará una excepción. Si se establece en true, se creará la lista con nombre, si no existe.

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
UploadCSVToIAConnectListResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Carga de CSV en IA-Connect tabla de búsqueda de Orchestrator

Cargue los datos CSV de reemplazo en una tabla de búsqueda de IA-Connect Orchestrator, reemplazando cualquier contenido existente. Esta acción no interactuará con una tabla de búsqueda controlada por el agente de IA-Connect (un archivo CSV mantenido en disco).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

Nombre de la tabla de búsqueda de Orchestrator.

Datos CSV
CSVData True string

Datos CSV de reemplazo que se almacenarán en la tabla de búsqueda de Orchestrator. Si la tabla de búsqueda ya existe, el contenido de la tabla se reemplazará por estos datos CSV. No puede proporcionar una entrada CSV vacía, pero puede proporcionar una fila de encabezado CSV sin filas de datos.

Creación de una tabla de búsqueda si no existe
CreateLookupTableIfNotExist boolean

Si se establece en false (valor predeterminado) y la tabla de búsqueda con nombre aún no existe, se generará una excepción. Si se establece en true, se creará la tabla de búsqueda con nombre, si no existe.

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
UploadCSVToIAConnectLookupTableResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Cargar IA-Connect tabla de búsqueda

Carga una tabla de búsqueda IA-Connect desde el equipo donde se ejecuta el agente de IA-Connect. Estas tablas de búsqueda se pueden usar con más IA-Connect acciones para realizar búsquedas de datos.

Parámetros

Nombre Clave Requerido Tipo Description
Ruta de acceso de la tabla de búsqueda
Path True string

Ruta de acceso completa a la tabla de búsqueda. Debe ser accesible desde la sesión en la que se ejecuta el agente de IA-Connect. Si se especifica una carpeta, se procesan todos los archivos debajo de esa carpeta.

Se produce una excepción si alguna tabla no se puede cargar
RaiseExceptionIfAnyTableFailsToLoad True boolean

Si se establece en true y cualquier IA-Connect tabla de búsqueda no se puede cargar (por ejemplo, si hay un problema en la tabla), se generará una excepción. Este es el valor predeterminado porque si alguna tabla no se carga, normalmente se producirá una excepción más adelante en el proceso. Si se establece en false, se omitirán las tablas de búsqueda de problemas y solo se podrán usar las tablas de búsqueda.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Número de tablas de búsqueda cargadas
NumberOfLookupTablesLoaded integer

Número de tablas de búsqueda que se cargaron correctamente.

Número de tablas de búsqueda que no se pudieron cargar
NumberOfLookupTablesFailedToLoad integer

Número de tablas de búsqueda que no se pudieron cargar. Esto solo se establecerá si "Generar excepción si alguna tabla no se puede cargar" está establecida en false, ya que de lo contrario habrá una excepción.

Columnas de búsqueda de IA-Connect tabla de búsqueda

Recupera una o varias columnas con nombre idéntico de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator) o una tabla de búsqueda cargada actualmente en el agente de IA-Connect, desde la primera fila que coincide con los datos de entrada y devuelve como una tabla. Por ejemplo, la tabla de búsqueda podría contener varias columnas de salida denominadas "Grupo de AD" para representar varios grupos de AD y se devolverán como filas independientes en la tabla de salida. Si Orchestrator tiene una tabla de búsqueda con el mismo nombre que uno cargado en el agente de IA-Connect, se usa la tabla de búsqueda de Orchestrator (si la automatización pasa por Orchestrator).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

El nombre de la tabla de búsqueda de Orchestrator o la tabla de búsqueda cargada en el agente de IA-Connect.

JSON de datos de entrada
InputDataJSON string

Datos de entrada que se usarán para la búsqueda, en formato JSON. Por ejemplo, si la tabla de búsqueda tiene columnas de propiedad 'JobTitle' y 'Country', podría enviar el siguiente json: { "JobTitle": "Consultor", "Country": "Inglaterra" }.

Nombre de columna de la tabla de resultados de búsqueda
SearchResultTableColumnName True string

Nombre de la columna de salida de la tabla de búsqueda que contiene el valor que se va a devolver en la tabla de salida. Si solo una columna de salida de la tabla de búsqueda tiene este nombre, la tabla de salida tendrá una sola fila. Si varias columnas de salida de la tabla de búsqueda comparten un nombre común, la tabla de salida tendrá varias filas.

Generar excepción si no hay ninguna coincidencia
RaiseExceptionIfNoMatch boolean

Establézcalo en true (valor predeterminado) para generar una excepción si la búsqueda no coincide con ningún dato. Establézcalo en false para devolver una cadena en blanco si la búsqueda no coincide con ningún dato.

Devolver celdas en blanco
ReturnBlankCells boolean

Establézcalo en true si desea incluir celdas en blanco en la tabla de retorno. Establézcalo en false (valor predeterminado) para incluir solo celdas con valores.

Formato de devolución
ReturnFormat string

Formato que se va a usar al devolver los resultados.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de tabla de búsqueda de salida
OutputLookupTableJSON string

La tabla de salida leída de las columnas de la tabla de búsqueda con el nombre especificado, obtenida al buscar los datos de entrada en la tabla de búsqueda IA-Connect. La tabla de salida tendrá una columna (que coincida con el nombre de columna de la tabla de resultados solicitada) y una o varias filas, en formato JSON.

Tabla de búsqueda de salida
OutputLookupTable array of object

La tabla de salida leída de las columnas de la tabla de búsqueda con el nombre especificado, obtenida al buscar los datos de entrada en la tabla de búsqueda IA-Connect. La tabla de salida tendrá una columna (que coincide con el nombre de columna de la tabla de resultados solicitada) y una o varias filas.

items
OutputLookupTable object
Matriz de búsqueda de salida
OutputLookupArray array of object

La matriz de salida leída de las columnas de la tabla de búsqueda con el nombre especificado, obtenida al buscar los datos de entrada en la tabla de búsqueda de IA-Connect. La matriz de salida es una sola columna con una o varias filas.

items
OutputLookupArray object
Número de filas en la salida
NumberOfRowsInOutput integer

Número de filas de la salida.

Conversión de matriz en JSON

Toma una matriz de entrada y serializa en una cadena JSON.

Parámetros

Nombre Clave Requerido Tipo Description
Input (objeto)
Input object object

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida
OutputJSON string

Cadena JSON de salida.

Creación de JSON a partir de variables de entrada

Toma una matriz de variables de entrada y devuelve en formato JSON y, opcionalmente, como una tabla JSON.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de propiedad
PropertyName string
Tipo de datos de propiedad
DataType string
Valor de propiedad
Value string
Devolver como tabla JSON
ReturnAsJSONTable True boolean

Si se establece en true, el json se devolverá en un formato de tabla o tabla de datos (es decir, con el formato [{}]). Si se establece en false, el json se devolverá como una sola entidad (es decir, con el formato {}). El formato que se va a usar depende de lo que esté haciendo con json. La mayoría de las acciones de IA-Connect esperan formato de tabla de datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida
OutputJSON string

Las variables y sus valores codificados en formato JSON.

Dividir cadena mediante una expresión regular

Divide una cadena de entrada mediante una coincidencia de expresión regular (regex) y devuelve los componentes divididos individuales de la cadena como una matriz de cadenas.

Parámetros

Nombre Clave Requerido Tipo Description
Texto de entrada que se va a dividir
TextToSplit True string

Texto de entrada que se va a dividir en la expresión regular.

Expresión regular
Regex True string

Expresión regular en la que se va a dividir el texto de entrada.

División con distinción entre mayúsculas y minúsculas
CaseSensitive boolean

Se establece en true (valor predeterminado) para una división que distingue mayúsculas de minúsculas (por ejemplo, A no es a) o se establece en false para una división sin distinción entre mayúsculas y minúsculas (por ejemplo, A y un objeto se tratan como idénticos).

Recorte de los resultados
TrimResults boolean

Establézcalo en true (valor predeterminado) si se debe recortar cada elemento de matriz de salida individual.

Quitar resultados vacíos
RemoveEmptyResults boolean

Establézcalo en true si los elementos de matriz de salida vacíos deben quitarse de la matriz de salida (es decir, no desea resultados vacíos).

Tiempo de espera de regex en segundos
RegexTimeoutInSeconds integer

Número máximo de segundos que se puede procesar la expresión regular antes de que se agote el tiempo de espera. Esto detiene los bucles infinitos causados por determinadas expresiones regulares.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of object

Matriz de cadenas de salida que contiene los componentes individuales de la cadena, divididos mediante la expresión regular.

items
OutputArray object
Número de elementos en la salida
NumberOfElementsInOutput integer

Número de elementos de la matriz de salida.

Ejecución del script de PowerShell

Ejecuta un script de PowerShell en la sesión en la que se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect en la entrada "Contenido del script de PowerShell" (PowerShellScriptContents). Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente. El Agente ejecuta PowerShell con Microsoft PowerShell v3.x a v5.x (la versión instalada), no powerShell Core (6.x en adelante).

Parámetros

Nombre Clave Requerido Tipo Description
Contenido del script de PowerShell
PowerShellScriptContents string

Contenido del script de PowerShell que se va a ejecutar. IA-Connect ejecutará este script as-is pasando directamente al motor de automatización de PowerShell. En realidad, no se crea ningún script de PowerShell en disco. Como alternativa, puede ejecutar un script de PowerShell existente en el disco; para ello, escriba lo siguiente: return & 'scriptpath'. Por ejemplo: return & 'c:\scripts\TestScript.ps1'.

Nombre del equipo
ComputerName string

Nombre del equipo en el que se va a ejecutar el script de PowerShell. Si se deja en blanco, el script se ejecutará en el equipo donde se ejecuta el agente de IA-Connect.

No se produce ningún error
IsNoResultAnError boolean

Si el comando de PowerShell no devuelve ningún dato, ¿esto sugiere un error?

Devolver tipos complejos
ReturnComplexTypes boolean

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Las entradas "Properties to return as collection", "Property names to serialize" (Nombres de propiedad para serializar) y "Property types to serialize" (Tipos de propiedad para serializar) permiten especificar qué propiedades "complejas" se deben devolver y el método utilizado para dar formato a los datos (en una base de propiedad por propiedad, elija el que mejor funciona). Esta entrada le permite especificar lo que se debe hacer con las propiedades restantes (es decir, propiedades que son "complejas" y no se denominan explícitamente). Si se establece en true, IA-Connect intentará devolver una representación de cadena de los datos mediante ToString(). Si se establece en false (valor predeterminado), IA-Connect no devolverá la propiedad .

Devolver un valor booleano como booleano
ReturnBooleanAsBoolean boolean

¿Deben devolverse propiedades booleanas como booleanos? Si es false, se devuelven como cadenas.

Devolver numérico como decimal
ReturnNumericAsDecimal boolean

¿Deben devolverse propiedades numéricas como numéricos? Si es false, se devuelven como cadenas.

Fecha de devolución como fecha
ReturnDateAsDate boolean

¿Deben devolverse las propiedades Date como fechas? Si es false, se devuelven como cadenas.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Mecanismo de autenticación
AuthenticationMechanism string

Mecanismo de autenticación que se va a usar si se conecta a un equipo remoto o ejecuta el script como usuario alternativo. Los valores admitidos son "Basic", "Credssp", "Default", "Digest", "Kerberos" y "Negotiate".

Intentos de conexión
ConnectionAttempts integer

Número de conexiones que se van a intentar si se conecta a un equipo remoto.

Nombre de usuario
Username string

Nombre de usuario que se va a usar si ejecuta el script como usuario alternativo.

Contraseña
Password password

Contraseña que se va a usar si ejecuta el script como usuario alternativo.

Ejecutar script como subproceso
RunScriptAsThread boolean

Si se establece en false (valor predeterminado), el agente de IA-Connect ejecutará el script de PowerShell inmediatamente y devolverá los resultados al director cuando se complete el script. Si ejecuta un script de PowerShell largo o complejo, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect ejecutará el script de PowerShell como un subproceso del agente y el IA-Connect Director (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del Agente, esperando a que se complete. Esto permite que los scripts de PowerShell largos o complejos se ejecuten sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores no pueden ejecutar scripts de PowerShell como subproceso del agente.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó un script de PowerShell como subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta un script de PowerShell (y, por lo tanto, no recupera los resultados de un script de PowerShell anterior se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar script como subproceso" se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que ejecuta el script de PowerShell no se ha completado en este momento, se producirá una excepción. Establezca en 0 para omitir la espera: el agente seguirá ejecutando el script de PowerShell, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados del script más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Ejecutar script de PowerShell" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

El script contiene la contraseña almacenada
ScriptContainsStoredPassword boolean

Se establece en true si el script contiene un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. La frase { } se reemplazará por la contraseña especificada, se escapará y colocará entre comillas simples (a menos que ya esté entre comillas en el script).

Salida detallada del registro
LogVerboseOutput boolean

Establézcalo en true para registrar cualquier salida detallada de PowerShell en los registros de IA-Connect. Esto podría ser útil para la depuración. Para registrar detalladamente en el script, use el siguiente PowerShell: Write-Verbose "Mi mensaje" -Verbose.

Devolver cadenas seguras
ReturnSecureStrings boolean

Establézcalo en true para devolver las propiedades de cadena seguras en la salida del script de PowerShell. Establézcalo en false (valor predeterminado) para no devolver ninguna propiedad que se mantenga como una cadena segura. Solo se establece en true si sabe lo que está haciendo, ya que esto podría dar lugar a que se transmitan contraseñas (si hay contraseñas en la salida del script de PowerShell).

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Nombre
Name string

Nombre del parámetro de PowerShell de entrada. Debe cumplir los formatos de nomenclatura de variables de PowerShell (es decir, se recomienda evitar espacios o símbolos especiales). Los nombres de variables de PowerShell no distinguen mayúsculas de minúsculas. Por ejemplo: MyVariable daría lugar a que se creara una variable $MyVariable.

Valor de cadena
StringValue string

Valor de cadena que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando un valor booleano o numérico.

Valor entero
IntValue integer

Valor entero (número entero) que se va a asignar al parámetro de PowerShell de entrada. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Valor booleano
BooleanValue boolean

Valor booleano (true o false) que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando una cadena o un valor numérico.

Valor decimal
DecimalValue double

Valor decimal que se va a asignar al parámetro de PowerShell de entrada. También puede usar de las otras entradas de valor si está especificando una cadena, un valor booleano o entero.

Valor del objeto
ObjectValue object

Valor de objeto que se va a asignar al parámetro de PowerShell de entrada. Se convertirá en una variable de cadena serializada JSON en el script de PowerShell, por lo que se deserializará en un objeto mediante ConvertFrom-Json. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Identificador de subproceso
ThreadId integer

Si el script de PowerShell se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución del script de PowerShell y recuperar los resultados del script de PowerShell cuando se haya completado el script.

Eliminación de columnas de una tabla

Toma una tabla de entrada, elimina una columna o columnas y devuelve una nueva tabla. Si desea eliminar columnas de una tabla en formato JSON, use la acción "Eliminar columnas de una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Iniciar índice de columna
StartColumnIndex integer

Índice de la columna en la que se va a empezar a eliminar. Use 1 para eliminar la primera columna, N para eliminar la columna N. Si desea eliminar una columna por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna para eliminar" en su lugar.

Nombre de columna que se va a eliminar
ColumnNameToDelete string

Nombre opcional de la columna que se va a eliminar. Si desea eliminar una columna por índice, deje esta entrada en blanco y use la entrada "Iniciar índice de columna" en su lugar.

Número de columnas que se van a eliminar
NumberOfColumnsToDelete True integer

Número de columnas que se van a eliminar, empezando por el índice o el nombre especificados.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Eliminación de columnas de una tabla JSON

Toma una tabla de entrada en formato JSON, elimina una columna o columnas y devuelve una nueva tabla en formato JSON. Si desea eliminar columnas de una tabla real (es decir, no en formato JSON), use la acción "Eliminar columnas de una tabla".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Iniciar índice de columna
StartColumnIndex integer

Índice de la columna en la que se va a empezar a eliminar. Use 1 para eliminar la primera columna, N para eliminar la columna N. Si desea eliminar una columna por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna para eliminar" en su lugar.

Nombre de columna que se va a eliminar
ColumnNameToDelete string

Nombre opcional de la columna que se va a eliminar. Si desea eliminar una columna por índice, deje esta entrada en blanco y use la entrada "Iniciar índice de columna" en su lugar.

Número de columnas que se van a eliminar
NumberOfColumnsToDelete True integer

Número de columnas que se van a eliminar, empezando por el índice o el nombre especificados.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Eliminación de elementos de una matriz de cadenas

Toma una matriz de entrada de elementos de cadena, elimina un elemento o elementos en una posición especificada y devuelve una nueva matriz. Si desea eliminar una fila o filas de una tabla, use la acción "Eliminar una fila de una tabla". Si desea eliminar una fila o filas de una tabla en formato JSON, use la acción "Eliminar una fila de una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Iniciar índice de elemento
StartItemIndex True integer

Índice del elemento en el que se va a empezar a eliminar. Use 1 para eliminar el primer elemento, N para eliminar el elemento N.

Número de elementos que se van a eliminar
NumberOfItemsToDelete True integer

Número de elementos que se van a eliminar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of string

Matriz de salida de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Eliminación de filas de una tabla

Toma una tabla de entrada, elimina una fila o filas en una posición especificada y devuelve una nueva tabla. Si desea eliminar una fila o filas de una matriz de cadenas, use la acción "Eliminar una fila de una matriz de cadenas". Si desea eliminar una fila o filas de una tabla en formato JSON, use la acción "Eliminar una fila de una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Iniciar índice de fila
StartRowIndex True integer

Índice de la fila en la que se va a empezar a eliminar. Use 1 para eliminar la primera fila, N para eliminar la fila N.

Número de filas que se van a eliminar
NumberOfRowsToDelete True integer

Número de filas que se van a eliminar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Eliminación de filas de una tabla JSON

Toma una tabla de entrada en formato JSON, elimina una fila o filas en una posición especificada y devuelve una nueva tabla en formato JSON. Si desea eliminar una fila o filas de una tabla real (es decir, no en formato JSON), use la acción "Eliminar una fila de una tabla". Si desea eliminar una fila o filas de una matriz de cadenas, use la acción "Eliminar una fila de una matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Iniciar índice de fila
StartRowIndex True integer

Índice de la fila en la que se va a empezar a eliminar. Use 1 para eliminar la primera fila, N para eliminar la fila N.

Número de filas que se van a eliminar
NumberOfRowsToDelete True integer

Número de filas que se van a eliminar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Eliminación de todas las tablas de búsqueda de IA-Connect

Quita todas las tablas de búsqueda cargadas actualmente en el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
RemoveAllIAConnectLookupTablesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Filtrar matriz de cadenas

Toma una matriz de entrada de elementos de cadena, filtra la matriz (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva matriz. Si desea filtrar una tabla, use la acción "Filtrar tabla". Si desea filtrar una tabla en formato JSON, use la acción "Filtrar tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Nombre de la columna
ColumnName True string

Nombre que se va a usar para la columna de tabla que contiene la matriz durante la operación de filtro. A continuación, este nombre se puede usar como nombre de columna en la sintaxis de filtro de fila de .NET DataView. Por ejemplo, MyColumn, al que se puede hacer referencia como [MyColumn].

Filter
Filter True string

El filtro en la sintaxis rowfilter de .NET DataView. Por ejemplo: [Name] como '*Element'.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida filtrada
OutputArray array of string

Matriz de salida filtrada de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Filtrar tabla JSON

Toma una tabla JSON de entrada, filtra la tabla (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva tabla JSON. Si desea filtrar una tabla real (es decir, no en formato JSON), use la acción "Filtrar tabla". Si desea filtrar una matriz de cadenas, use la acción "Filtrar matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Filter
Filter True string

El filtro en la sintaxis rowfilter de .NET DataView. Por ejemplo: [Name] como '*Element'.

Ordenar nombre de columna
SortColumnName string

Un nombre de columna opcional para ordenar por después de aplicar el filtro. Si desea ordenar por varias columnas, enumere las columnas separadas por comas.

Ordenar ascendente
Ascending boolean

Se establece en true para ordenar en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 2
SortColumnName2 string

Un nombre de segunda columna opcional por el que ordenar (después de ordenar por la primera columna).

Ordenar ascendente 2
Ascending2 boolean

Establézcalo en true para ordenar el segundo nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 3
SortColumnName3 string

Un nombre de tercera columna opcional por el que ordenar (después de ordenar por las columnas primera y segunda).

Ordenar ascendente 3
Ascending3 boolean

Establézcalo en true para ordenar el tercer nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Importación del ensamblado desde el archivo local

Carga un ensamblado de DotNet desde el equipo en el que se ejecuta el IA-Connect Director en el agente de IA-Connect donde se carga en la memoria y se usará si se hace referencia a él mediante código DotNet dinámico.

Parámetros

Nombre Clave Requerido Tipo Description
Ruta de acceso del archivo de ensamblado local
LocalAssemblyFilePath True string

Ruta de acceso de archivo al archivo de ensamblado local en la sesión local (donde se ejecuta el IA-Connect Director).

Nombre del ensamblado
AssemblyName True string

Nombre del ensamblado que se va a importar.

Comprimir
Compress boolean

¿Debe comprimirse el ensamblado antes de cargarlo?

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Insertar una fila de variables de entrada en una tabla JSON

Toma una tabla de entrada en formato JSON, inserta una fila creada a partir de variables de entrada en una posición especificada y devuelve una nueva tabla en formato JSON. El esquema de fila de entrada debe coincidir con el de la tabla de entrada (es decir, use los mismos nombres de propiedad y tipos de datos). Si desea insertar una fila en una tabla real (es decir, no en formato JSON), use la acción "Insertar una fila en una tabla". Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Índice de fila
RowIndex True integer

Índice de la fila en la que se va a insertar. Use 0 para insertar al principio de la tabla, 1 para insertar después de la fila 1, N para insertar después de la fila N. -1 o cualquier número igual o superior al número de elementos de la tabla que se va a insertar al final de la tabla (útil si no sabe cuánto tiempo es la tabla).

Nombre de propiedad
PropertyName string
Tipo de datos de propiedad
DataType string
Valor de propiedad
Value string

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Insertar una fila en una matriz de cadenas

Toma una matriz de entrada de elementos de cadena, inserta una fila en una posición especificada y devuelve una nueva matriz. Si desea insertar una fila en una tabla, use la acción "Insertar una fila en una tabla". Si desea insertar una fila en una tabla en formato JSON, use la acción "Insertar una fila en una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Índice de fila
RowIndex True integer

Índice de la fila en la que se va a insertar. Use 0 para insertar al principio de la matriz, 1 para insertar después de la fila 1, N para insertar después de la fila N. -1 o cualquier número igual o mayor que el número de elementos de la matriz que se van a insertar al final de la matriz (útil si no sabe cuánto tiempo es la matriz).

Valor que se va a insertar
ValueToInsert string

Valor de cadena que se va a insertar en la nueva fila. Deje en blanco si desea insertar una fila vacía.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of string

Matriz de salida de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Insertar una fila en una tabla

Toma una tabla de entrada, inserta una fila en una posición especificada y devuelve una nueva tabla. Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas". Si desea insertar una fila en una tabla en formato JSON, use la acción "Insertar una fila en una tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Índice de fila
RowIndex True integer

Índice de la fila en la que se va a insertar. Use 0 para insertar al principio de la tabla, 1 para insertar después de la fila 1, N para insertar después de la fila N. -1 o cualquier número igual o superior al número de elementos de la tabla que se va a insertar al final de la tabla (útil si no sabe cuánto tiempo es la tabla).

Fila JSON que se va a insertar
RowToInsertJSON string

Contenido de la fila que se va a insertar en formato JSON. Deje en blanco si desea insertar una fila vacía. Por ejemplo: Para insertar 'Simon' en la columna 'Name' use {"Name":"Simon"} y para insertar además 'England' en la columna 'Country' use {"Name":"Simon","Country":"England"}.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Insertar una fila en una tabla JSON

Toma una tabla de entrada en formato JSON, inserta una fila en una posición especificada y devuelve una nueva tabla en formato JSON. Si desea insertar una fila en una tabla real (es decir, no en formato JSON), use la acción "Insertar una fila en una tabla". Si desea insertar una cadena en una matriz de cadenas, use la acción "Insertar una fila en una matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Índice de fila
RowIndex True integer

Índice de la fila en la que se va a insertar. Use 0 para insertar al principio de la tabla, 1 para insertar después de la fila 1, N para insertar después de la fila N. -1 o cualquier número igual o superior al número de elementos de la tabla que se va a insertar al final de la tabla (útil si no sabe cuánto tiempo es la tabla).

Fila JSON que se va a insertar
RowToInsertJSON string

Contenido de la fila que se va a insertar en formato JSON. Deje en blanco si desea insertar una fila vacía. Por ejemplo: Para insertar 'Simon' en la columna 'Name' use {"Name":"Simon"} y para insertar además 'England' en la columna 'Country' use {"Name":"Simon","Country":"England"}.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Obtención de cadena de la celda de tabla JSON

Toma una tabla de entrada en formato JSON y devuelve una celda especificada como una cadena.

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Índice de fila
RowIndex integer

Índice de la fila que contiene la celda que se va a recuperar. Use 1 para la primera fila, N para la fila N.

Índice de columna
ColumnIndex integer

Índice de la columna que contiene la celda que se va a recuperar. Use 1 para la primera columna, N para la columna N. Si desea recuperar una columna por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna" en su lugar.

Nombre de la columna
ColumnName string

Nombre opcional de la columna que contiene la celda que se va a recuperar. Si desea recuperar una columna por índice, deje esta entrada en blanco y use la entrada "Índice de columna" en su lugar.

Reserva si la celda no existe
FallBackIfCellDoesNotExist boolean

Esta entrada controla el resultado si no existe el índice de fila, el índice de columna o el nombre especificados. Si esta entrada se establece en false (valor predeterminado), habrá una excepción. Si esta entrada se establece en true, la "Cadena de salida" se establecerá en el valor de reserva, que puede estar en blanco o en un valor de su elección.

Valor de reserva
FallbackValue string

Si el índice de fila, el índice de columna o el nombre especificados no existen y la entrada "Reserva si la celda no existe" se establece en true, este valor de reserva se usará para la cadena de salida.

Devoluciones

Nombre Ruta de acceso Tipo Description
Cadena de salida
OutputString string

El contenido de la celda de salida como una cadena.

Obtención de coincidencias de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve todas las coincidencias de una matriz de cadenas. La matriz estará vacía si no hubiera ninguna coincidencia.

Parámetros

Nombre Clave Requerido Tipo Description
Texto de entrada que debe coincidir
TextToMatch True string

Texto de entrada que se va a coincidir con la expresión regular.

Expresión regular
Regex True string

Expresión regular con la que se va a hacer coincidir el texto de entrada.

Número máximo de coincidencias que se van a realizar
MaximumMatches integer

Cantidad máxima de coincidencias de expresiones regulares que se van a realizar. Para un número ilimitado de coincidencias (es decir, mantener la coincidencia hasta que no haya más coincidencias) no escriba ningún valor o un valor de 0 (el valor predeterminado). Esta entrada está diseñada para evitar bucles infinitos de expresiones regulares colocando un límite en el número de coincidencias.

Coincidencia con distinción entre mayúsculas y minúsculas
CaseSensitive boolean

Se establece en true (valor predeterminado) para una coincidencia que distingue mayúsculas de minúsculas (por ejemplo, A no es a) o se establece en false para una coincidencia que no distingue mayúsculas de minúsculas (por ejemplo, A y un objeto se tratan como idénticos).

Recorte de los resultados
TrimResults boolean

Establézcalo en true (valor predeterminado) si se debe recortar cada elemento de matriz de salida individual.

Quitar resultados vacíos
RemoveEmptyResults boolean

Establézcalo en true si los elementos de matriz de salida vacíos deben quitarse de la matriz de salida (es decir, no desea resultados vacíos).

Tiempo de espera de regex en segundos
RegexTimeoutInSeconds integer

Número máximo de segundos que se puede procesar la expresión regular antes de que se agote el tiempo de espera. Esto detiene los bucles infinitos causados por determinadas expresiones regulares.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of object

Matriz de cadenas de salida que contiene las coincidencias de expresiones regulares individuales.

items
OutputArray object
Número de elementos en la salida
NumberOfElementsInOutput integer

Número de elementos de la matriz de salida.

Obtención de coincidencias de grupo de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve una lista de nombres y valores de grupo coincidentes.

Parámetros

Nombre Clave Requerido Tipo Description
Texto de entrada que debe coincidir
TextToMatch True string

Texto de entrada que se va a coincidir con la expresión regular.

Expresión regular
Regex True string

Expresión regular con la que se va a hacer coincidir el texto de entrada.

Grupos que se van a recuperar
GroupsToRetrieve array of string

Matriz de cadenas que contiene los nombres de los grupos de expresiones regulares que se van a recuperar. Si se proporciona una matriz en blanco, se recuperan todos los grupos. Por ejemplo: Si una expresión regular contiene (?<NeedsUpdating>(Sí|No)) y especifica que se debe recuperar el grupo "NeedsUpdating" y, a continuación, se devolverá el valor coincidente de ese grupo con nombre.

Índice de búsqueda
SearchIndex integer

Índice del resultado de coincidencia que se va a recuperar a partir de 1. Si desea coincidir con el primer resultado (el comportamiento predeterminado), escriba 1. Por ejemplo: si se espera que una cadena de entrada coincida con la expresión regular en 5 lugares y está interesado en la 4ª coincidencia, escriba 4.

Coincidencia con distinción entre mayúsculas y minúsculas
CaseSensitive boolean

Se establece en true (valor predeterminado) para una coincidencia que distingue mayúsculas de minúsculas (por ejemplo, A no es a) o se establece en false para una coincidencia que no distingue mayúsculas de minúsculas (por ejemplo, A y un objeto se tratan como idénticos).

Tiempo de espera de regex en segundos
RegexTimeoutInSeconds integer

Número máximo de segundos que se puede procesar la expresión regular antes de que se agote el tiempo de espera. Esto detiene los bucles infinitos causados por determinadas expresiones regulares.

Devoluciones

Nombre Ruta de acceso Tipo Description
Grupos de expresiones regulares
RegexGroups array of object

Matriz que contiene los nombres y valores de los grupos de expresiones regulares coincidentes con la cadena de entrada.

Propiedad
RegexGroups.Property string
Importancia
RegexGroups.Value string
Número de grupos
NumberOfRegexGroups integer

Número de grupos de expresiones regulares.

Obtención de la coincidencia de expresiones regulares

Realiza una coincidencia de expresión regular (regex) en una cadena de entrada y devuelve si la cadena coincide con la expresión y los detalles de la coincidencia.

Parámetros

Nombre Clave Requerido Tipo Description
Texto de entrada que debe coincidir
TextToMatch True string

Texto de entrada que se va a coincidir con la expresión regular.

Expresión regular
Regex True string

Expresión regular con la que se va a hacer coincidir el texto de entrada.

Índice de búsqueda
SearchIndex integer

Índice del resultado de coincidencia que se va a recuperar a partir de 1. Si desea coincidir con el primer resultado (el comportamiento predeterminado), escriba 1. Por ejemplo: si se espera que una cadena de entrada coincida con la expresión regular en 5 lugares y está interesado en la 4ª coincidencia, escriba 4.

Coincidencia con distinción entre mayúsculas y minúsculas
CaseSensitive boolean

Se establece en true (valor predeterminado) para una coincidencia que distingue mayúsculas de minúsculas (por ejemplo, A no es a) o se establece en false para una coincidencia que no distingue mayúsculas de minúsculas (por ejemplo, A y un objeto se tratan como idénticos).

Tiempo de espera de regex en segundos
RegexTimeoutInSeconds integer

Número máximo de segundos que se puede procesar la expresión regular antes de que se agote el tiempo de espera. Esto detiene los bucles infinitos causados por determinadas expresiones regulares.

Devoluciones

Nombre Ruta de acceso Tipo Description
Coincidencia correcta
SuccessfulMatch boolean

True si se produjo una coincidencia correcta (en el índice de búsqueda especificado) o false si no lo hubiera.

Coincidir con el valor de cadena
MatchStringValue string

Si se ha producido una coincidencia correcta, este valor de cadena contiene el texto del texto de entrada que coincide con la expresión regular.

Índice de posición de coincidencia
MatchIndex integer

Si se produjo una coincidencia correcta, este valor contiene la posición dentro del texto de entrada para que coincida con la ubicación de la coincidencia. Este valor comienza en 0, que representa el inicio de la cadena de texto de entrada.

Coincidencia de longitud de cadena
MatchStringLength integer

Si se ha producido una coincidencia correcta, este valor contiene la longitud del texto de entrada que coincide con la expresión regular (es decir, la longitud del valor de salida "Valor de cadena de coincidencia").

Obtención de la matriz de cadenas de la columna de tabla

Toma una tabla de entrada y devuelve una columna especificada como una matriz de cadenas. Si desea obtener una matriz de cadenas de una tabla en formato JSON, use la acción "Obtener matriz de la tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Índice de columna
ColumnIndex integer

Índice de la columna que se va a devolver como una matriz. Use 1 para la primera columna, N para la columna N. Si desea recuperar una columna por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna" en su lugar.

Nombre de la columna
ColumnName string

Nombre opcional de la columna que se va a devolver como una matriz. Si desea recuperar una columna por índice, deje esta entrada en blanco y use la entrada "Índice de columna" en su lugar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of string

Matriz de salida de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Obtención de la matriz de cadenas de la columna de tabla JSON

Toma una tabla de entrada en formato JSON y devuelve una columna especificada como una matriz de cadenas. Si desea obtener una matriz de cadenas de una tabla real (es decir, no en formato JSON), use la acción "Obtener matriz de la tabla".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Índice de columna
ColumnIndex integer

Índice de la columna que se va a devolver como una matriz. Use 1 para la primera columna, N para la columna N. Si desea recuperar una columna por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna" en su lugar.

Nombre de la columna
ColumnName string

Nombre opcional de la columna que se va a devolver como una matriz. Si desea recuperar una columna por índice, deje esta entrada en blanco y use la entrada "Índice de columna" en su lugar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida
OutputArray array of string

Matriz de salida de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Obtención de la tabla de la matriz de cadenas

Toma una matriz de entrada de elementos de cadena y devuelve como una tabla.

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Nombre de la columna
ColumnName True string

Nombre que se va a usar para la columna de tabla.

Quitar elementos vacíos
DropEmptyItems boolean

Establézcalo en true para omitir (quitar) elementos vacíos en la matriz. Establézcalo en false para incluir todos los elementos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida (siempre debe ser 1).

Obtención de la tabla JSON de la matriz de cadenas

Toma una matriz de entrada de elementos de cadena y devuelve como una tabla JSON.

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Nombre de la columna
ColumnName True string

Nombre que se va a usar para la columna de tabla.

Quitar elementos vacíos
DropEmptyItems boolean

Establézcalo en true para omitir (quitar) elementos vacíos en la matriz. Establézcalo en false para incluir todos los elementos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida (siempre debe ser 1).

Obtención de la versión de PowerShell

Obtiene la versión de PowerShell en la sesión donde se ejecuta el agente de IA-Connect. Esto detecta Microsoft PowerShell v3.x a v5.x, no powerShell Core (6.x en adelante).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre del equipo
ComputerName string

Nombre del equipo para comprobar la versión de PowerShell. Si se deja en blanco, se usará el equipo donde se ejecuta el agente de IA-Connect.

Mecanismo de autenticación
AuthenticationMechanism string

Mecanismo de autenticación que se va a usar si se conecta a un equipo remoto o ejecuta el script como usuario alternativo. Los valores admitidos son "Basic", "Credssp", "Default", "Digest", "Kerberos" y "Negotiate".

Intentos de conexión
ConnectionAttempts integer

Número de conexiones que se van a intentar si se conecta a un equipo remoto.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Versión principal de PowerShell
PowerShellMajorVersion integer

Versión principal (entero) de PowerShell. Por ejemplo: PowerShell 5.1 devolvería 5.

Versión secundaria de PowerShell
PowerShellMinorVersion integer

Versión secundaria (después de la posición decimal) de PowerShell. Por ejemplo: PowerShell 5.1 devolvería 1.

Obtención de tabla de JSON

Toma una tabla de entrada en formato JSON y devuelve como una tabla. Esto se conoce como deserialización.

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Iniciar índice de fila
StartRowIndex True integer

Índice de la primera fila que se va a recuperar. Use 1 para empezar en la primera fila, N para empezar en la fila N.

Número de filas que se van a recuperar
NumberOfRowsToRetrieve integer

Número de filas que se van a recuperar. Use 0 (o deje en blanco) para recuperar todas las filas.

Iniciar índice de columna
StartColumnIndex integer

Índice de la primera columna que se va a recuperar. Use 1 para empezar en la primera columna, N para empezar en la columna N. Si desea especificar la primera columna para recuperar por nombre, deje esta entrada en blanco y use la entrada "Nombre de columna de inicio" en su lugar.

Nombre de columna de inicio
StartColumnName string

Nombre opcional de la primera columna que se va a recuperar. Si desea recuperar columnas por índice, deje esta entrada en blanco y use la entrada "Iniciar índice de columna" en su lugar.

Número de columnas que se van a recuperar
NumberOfColumnsToRetrieve integer

Número de columnas que se van a recuperar. Use 0 (o deje en blanco) para recuperar todas las columnas.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida (siempre debe ser 1).

Obtener cadena entre

Toma una cadena de entrada y devuelve la primera instancia de una cadena que se encuentra entre dos cadenas especificadas o entre una cadena y el final de la línea.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de entrada
InputString string

Cadena de entrada en la que se realiza la búsqueda.

Iniciar cadena de búsqueda
StartSearchString string

Cadena de búsqueda inicial.

Cadena de búsqueda final
EndSearchString string

Cadena de búsqueda final o deje en blanco si busca al final de la línea.

Línea de búsqueda por línea
SearchLineByLine boolean

Se establece en true si desea buscar la línea de cadena de entrada por línea y para que el resultado solo contenga la cadena coincidente en la línea actual. Establézcalo en false para tratar la cadena de entrada como un solo elemento.

Se produce una excepción si no se encuentra
ThrowExceptionIfNotFound boolean

Establézcalo en true si desea que se produzca una excepción si no se encontró la cadena de búsqueda o si la acción debe devolver "String between found"=false cuando no se encontró la cadena de búsqueda.

Resultado de recorte
TrimResult boolean

Establézcalo en true si desea recortar espacios o pestañas antes o después del resultado.

La búsqueda es expresión regular
SearchIsRegularExpression boolean

Se establece en true si las cadenas de búsqueda son expresiones regulares. Se establece en false si las cadenas de búsqueda son texto normal.

Búsqueda con distinción entre mayúsculas y minúsculas
CaseSensitiveSearch boolean

Establézcalo en true si la búsqueda debe distinguir mayúsculas de minúsculas. Establézcalo en false para las búsquedas que no distinguen mayúsculas de minúsculas.

Devoluciones

Nombre Ruta de acceso Tipo Description
Cadena de búsqueda encontrada
SearchStringFound boolean

Si "Throw exception if not found" (Iniciar excepción si no se encuentra) se establece en false, esta salida se establece en true si se encontró la cadena de búsqueda, false si no.

Cadena entre
StringBetween string

Cadena encontrada entre las cadenas especificadas.

Obtener columna de IA-Connect lista

Recupera una columna de una lista de orquestador de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de lista
ListName True string

Nombre de la lista de Orchestrator.

Índice de columna de búsqueda
SearchColumnIndex integer

Índice de la columna de la lista que se va a devolver. Este valor predeterminado es 1, que devuelve la primera columna. Si desea recuperar una columna por nombre, establézcala en 0 y especifique un nombre de columna en su lugar.

Buscar nombre de columna
SearchColumnName string

Nombre de la columna de la lista que se va a devolver, si desea recuperar una columna de la lista por su nombre. Establezca "Search column index" (Índice de columna de búsqueda) en 0, si desea usar esta entrada.

Devolver celdas en blanco
ReturnBlankCells boolean

Establézcalo en true si desea incluir celdas en blanco en los datos devueltos. Establézcalo en false (valor predeterminado) para incluir solo celdas con valores.

Reserva si la lista no existe
FallBackIfListDoesNotExist boolean

Esta entrada controla el resultado si la lista especificada no existe. Si esta entrada se establece en false (valor predeterminado), habrá una excepción. Si esta entrada se establece en true, la "Lista de resultados" (con formato en el formato de devolución solicitado) se establecerá en el valor de reserva, que puede estar en blanco o un valor de su elección.

Valor de reserva
FallbackValue string

Si la lista especificada no existe y la entrada "Reserva si la lista no existe" se establece en true, este valor de reserva se usará para la salida, con el formato de devolución solicitado. Esto resulta útil si está leyendo datos de tablas de búsqueda y algunos elementos de datos representan una lista, mientras que algunos elementos son los datos reales.

Formato de devolución
ReturnFormat string

Formato que se va a usar al devolver los resultados.

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de lista de salida
OutputListJSON string

Columna de salida de la lista, en formato JSON.

Lista de salida
OutputList array of object

Columna de salida de la lista, en formato de tabla de datos.

items
OutputList object
Matriz de lista de salida
OutputListArray array of object

Columna de salida de la lista, en formato de matriz.

items
OutputListArray object
Número de filas en la salida
NumberOfRowsInOutput integer

Número de filas de la salida.

Obtener IA-Connect contenido de la lista

Recupera todos los datos de una lista de IA-Connect Orchestrator.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de lista
ListName True string

Nombre de la lista de Orchestrator.

Formato de devolución
ReturnFormat string

Formato que se va a usar al devolver los resultados.

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de lista de salida
OutputListJSON string

Los datos de salida de la lista, en formato JSON.

Lista de salida
OutputList array of object

Los datos de salida de la lista, en formato datatable.

items
OutputList object
CSV de lista de salida
OutputListCSV string

Los datos de salida de la lista, en formato CSV.

Número de filas en la salida
NumberOfRowsInOutput integer

Número de filas de la salida.

Número de columnas en la salida
NumberOfColumnsInOutput integer

Número de columnas de la salida.

Obtener IA-Connect contenido de la tabla de búsqueda de Orchestrator

Recupera todos los datos de una tabla de búsqueda de IA-Connect Orchestrator que se mantiene en Orchestrator. Esto no recuperará una tabla de búsqueda controlada por el agente de IA-Connect (un archivo CSV mantenido en disco).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

Nombre de la tabla de búsqueda de Orchestrator.

Formato de devolución
ReturnFormat string

Formato que se va a usar al devolver los resultados.

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de tabla de búsqueda de salida
OutputLookupTableJSON string

Los datos de salida de la tabla de búsqueda, en formato JSON.

Tabla de búsqueda de salida
OutputLookupTable array of object

Los datos de salida de la tabla de búsqueda, en formato de tabla de datos.

items
OutputLookupTable object
CSV de tabla de búsqueda de salida
OutputLookupTableCSV string

Los datos de salida de la tabla de búsqueda, en formato CSV.

Número de filas en la salida
NumberOfRowsInOutput integer

Número de filas de la salida.

Número de columnas en la salida
NumberOfColumnsInOutput integer

Número de columnas de la salida.

Obtener IA-Connect resumen de la tabla de búsqueda

Recupera un resumen de las tablas de búsqueda cargadas actualmente en el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Json de tablas de búsqueda
LookupTablesJSON array of object

Las tablas de búsqueda cargadas en el agente de IA-Connect.

Nombre
LookupTablesJSON.Name string
ThenColumnIndex
LookupTablesJSON.ThenColumnIndex integer
NumberOfRows
LookupTablesJSON.NumberOfRows integer
NumberOfColumns
LookupTablesJSON.NumberOfColumns integer
NumberOfUniqueHeaderProperties
LookupTablesJSON.NumberOfUniqueHeaderProperties integer
Número de tablas de búsqueda
NumberOfLookupTables integer

Número de tablas de búsqueda cargadas actualmente en el agente de IA-Connect.

Ordenar matriz de cadenas

Toma una matriz de entrada de elementos de cadena, ordena la matriz y devuelve una nueva matriz. Si desea ordenar una tabla, use la acción "Ordenar tabla". Si desea ordenar una tabla en formato JSON, use la acción "Ordenar tabla JSON".

Parámetros

Nombre Clave Requerido Tipo Description
Matriz de entrada
InputArray True array of string

Matriz de entrada de cadenas.

Ordenar ascendente
Ascending boolean

Se establece en true para ordenar en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Distingue mayúsculas de minúsculas
CaseSensitive boolean

Establézcalo en true para una ordenación con distinción entre mayúsculas y minúsculas (es decir, mayúsculas y minúsculas ordenadas por separado). Establézcalo en false para una ordenación que no distingue mayúsculas de minúsculas.

Devoluciones

Nombre Ruta de acceso Tipo Description
Matriz de salida ordenada
OutputArray array of string

Matriz de salida ordenada de cadenas.

Número de artículos
NumberOfItems integer

Número de elementos de la matriz de salida.

Ordenar tabla

Toma una tabla de entrada, ordena una o varias filas y devuelve una nueva tabla. Si desea ordenar una tabla en formato JSON, use la acción "Ordenar tabla JSON". Si desea ordenar una matriz de cadenas, use la acción "Ordenar matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Ordenar nombre de columna
SortColumnName True string

Nombre de columna por el que se va a ordenar. Si desea ordenar por varias columnas, enumere las columnas separadas por comas.

Ordenar ascendente
Ascending True boolean

Se establece en true para ordenar en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 2
SortColumnName2 string

Un nombre de segunda columna opcional por el que ordenar (después de ordenar por la primera columna).

Ordenar ascendente 2
Ascending2 boolean

Establézcalo en true para ordenar el segundo nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 3
SortColumnName3 string

Un nombre de tercera columna opcional por el que ordenar (después de ordenar por las columnas primera y segunda).

Ordenar ascendente 3
Ascending3 boolean

Establézcalo en true para ordenar el tercer nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Ordenar tabla JSON

Toma una tabla JSON de entrada, ordena la tabla y devuelve una nueva tabla JSON. Si desea ordenar una tabla real (es decir, no en formato JSON), use la acción "Ordenar tabla". Si desea ordenar una matriz de cadenas, use la acción "Ordenar matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla JSON de entrada
JSONTable True string

Tabla de entrada en formato JSON.

Ordenar nombre de columna
SortColumnName True string

Nombre de columna por el que se va a ordenar.

Ordenar ascendente
Ascending boolean

Se establece en true para ordenar en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 2
SortColumnName2 string

Un nombre de segunda columna opcional por el que ordenar (después de ordenar por la primera columna).

Ordenar ascendente 2
Ascending2 boolean

Establézcalo en true para ordenar el segundo nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 3
SortColumnName3 string

Un nombre de tercera columna opcional por el que ordenar (después de ordenar por las columnas primera y segunda).

Ordenar ascendente 3
Ascending3 boolean

Establézcalo en true para ordenar el tercer nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla JSON de salida
OutputJSONTable string

Tabla de salida en formato JSON.

Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Quitar caracteres de la cadena

Toma una cadena de entrada y la devuelve con caracteres especificados quitados. Si los caracteres especificados no se encuentran, se devolverá la cadena original.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de entrada
InputString string

Cadena de entrada en la que se realiza la eliminación de caracteres.

Caracteres que se van a quitar de la cadena de entrada
CharactersToRemoveFromInputString string

Cadena que contiene todos los caracteres que desea quitar de las entradas. Por ejemplo: !@&?^*.

Eliminación de diacríticos de la cadena de entrada
RemoveDiacriticsFromInputString boolean

Si se establece en true, IA-Connect intentará quitar todos los diacríticos de la cadena de entrada, reemplazando los caracteres por un diacrítico con el mismo carácter menos el diacrítico. Por ejemplo: reemplazando "agudo énfasis a" por "a". En escenarios en los que no hay ninguna asignación directa a un carácter simple, se quita el carácter. Por ejemplo: se quita el sharp S alemán.

Quitar no alfanumérico de la cadena de entrada
RemoveNonAlphaNumericFromInputString boolean

Si se establece en true, IA-Connect quitará todos los caracteres no alfanuméricos de la cadena de entrada.

Eliminación de caracteres numéricos de la cadena de entrada
RemoveNumericFromInputString boolean

Si se establece en true, IA-Connect quitará todos los caracteres numéricos de la cadena de entrada.

Eliminación de caracteres en minúsculas de la cadena de entrada
RemoveLowercaseCharactersFromInputString boolean

Si se establece en true, IA-Connect quitará todos los caracteres alfabéticos en minúsculas de la cadena de entrada.

Eliminación de caracteres en mayúsculas de la cadena de entrada
RemoveUppercaseCharactersFromInputString boolean

Si se establece en true, IA-Connect quitará todos los caracteres alfabéticos en mayúsculas de la cadena de entrada.

Devoluciones

Nombre Ruta de acceso Tipo Description
Cadena de salida
OutputString string

Cadena con los caracteres quitados. Esta será la cadena original si no se encontraron caracteres especificados.

Quitar IA-Connect tabla de búsqueda

Quita una tabla de búsqueda cargada actualmente en el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

Nombre de la tabla de búsqueda cargada en el agente de IA-Connect.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
RemoveIAConnectLookupTableResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Tabla de filtro

Toma una tabla de entrada, filtra la tabla (mediante la sintaxis de filtro de fila de .NET DataView) y devuelve una nueva tabla. Si desea filtrar una tabla en formato JSON, use la acción "Filtrar tabla JSON". Si desea filtrar una matriz de cadenas, use la acción "Filtrar matriz de cadenas".

Parámetros

Nombre Clave Requerido Tipo Description
Tabla de entrada
Input table object
Filter
Filter True string

El filtro en la sintaxis rowfilter de .NET DataView. Por ejemplo: [Name] como '*Element'.

Ordenar nombre de columna
SortColumnName string

Un nombre de columna opcional para ordenar por después de aplicar el filtro. Si desea ordenar por varias columnas, enumere las columnas separadas por comas.

Ordenar ascendente
Ascending boolean

Se establece en true para ordenar en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 2
SortColumnName2 string

Un nombre de segunda columna opcional por el que ordenar (después de ordenar por la primera columna).

Ordenar ascendente 2
Ascending2 boolean

Establézcalo en true para ordenar el segundo nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Ordenar el nombre de columna 3
SortColumnName3 string

Un nombre de tercera columna opcional por el que ordenar (después de ordenar por las columnas primera y segunda).

Ordenar ascendente 3
Ascending3 boolean

Establézcalo en true para ordenar el tercer nombre de columna en orden ascendente. Establézcalo en false para ordenar en orden descendente.

Devoluciones

Nombre Ruta de acceso Tipo Description
Tabla de salida
OutputTable array of object

Tabla de salida.

items
OutputTable object
Número de filas
NumberOfRows integer

Número de filas de la tabla de salida.

Número de columnas
NumberOfColumns integer

Número de columnas de la tabla de salida.

Valor de búsqueda de IA-Connect tabla de búsqueda

Recupera un valor de una tabla de búsqueda de Orchestrator (para automatizaciones mediante Orchestrator) o una tabla de búsqueda cargada actualmente en el agente de IA-Connect, desde la primera fila que coincide con los datos de entrada. Si Orchestrator tiene una tabla de búsqueda con el mismo nombre que uno cargado en el agente de IA-Connect, se usa la tabla de búsqueda de Orchestrator (si la automatización pasa por Orchestrator).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de la tabla de búsqueda
LookupTableName True string

El nombre de la tabla de búsqueda de Orchestrator o la tabla de búsqueda cargada en el agente de IA-Connect.

JSON de datos de entrada
InputDataJSON string

Datos de entrada que se usarán para la búsqueda, en formato JSON. Por ejemplo, si la tabla de búsqueda tiene columnas de propiedad 'JobTitle' y 'Country', podría enviar el siguiente json: { "JobTitle": "Consultor", "Country": "Inglaterra" }.

Nombre de columna de valor de resultado de búsqueda
SearchResultValueColumnName True string

Columna de la tabla de búsqueda que contiene el valor devuelto que se va a leer.

Índice de columna de valor de resultado de búsqueda
SearchResultValueColumnIndex integer

Si se establece en 1 (valor predeterminado), se devolverá el valor de la primera columna de resultados que coincida con el nombre solicitado. Establezca en un valor mayor (N) para devolver la columna de coincidencia N.

Generar excepción si no hay ninguna coincidencia
RaiseExceptionIfNoMatch boolean

Establézcalo en true (valor predeterminado) para generar una excepción si la búsqueda no coincide con ningún dato. Establézcalo en false para devolver una cadena en blanco si la búsqueda no coincide con ningún dato.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Valor de búsqueda de salida
OutputLookupValue string

Valor de salida de la columna de tabla de búsqueda especificada, obtenido al buscar los datos de entrada en la tabla de búsqueda IA-Connect.

¿Está instalada la automatización de PowerShell?

Informa de si la automatización de PowerShell está disponible en el equipo en el que se ejecuta el agente de IA-Connect. Si la automatización de PowerShell no está disponible, las acciones de automatización de PowerShell no funcionarán.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
¿Está instalada la automatización de PowerShell?
PowerShellAutomationIsInstalled boolean

Devuelve true si la automatización de PowerShell está disponible o false si no es así.

¿Está instalado el módulo de PowerShell?

Busca un módulo de PowerShell especificado en el equipo donde se ejecuta el agente de IA-Connect y devuelve si está instalado.

Parámetros

Nombre Clave Requerido Tipo Description
Módulo de PowerShell
PowerShellModuleName True string

Nombre del módulo de PowerShell que se va a buscar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
¿Está instalado el módulo de PowerShell?
PowerShellModuleIsInstalled boolean

Devuelve true si el módulo de PowerShell especificado está instalado o false si no.