registro de casos de uip maestro

Explore y busque el registro de `Maestro Case` Management de actividades, desencadenadores, conectores y otros recursos de automatización utilizando `uip maestro case registry`.

uip maestro case registry y busca en el registro de Gestión de casos : un catálogo local en caché de los recursos de automatización (procesos, agentes, API, flujos, actividades/desencadenadores del conector, aplicaciones de acción y, opcionalmente, los recursos propios de una solución en curso) una definición de caso a las que puedes conectar tareas. Extrae el registro una vez por sesión, luego busca o recupera recursos por identificador mientras creas un caso.

Para conocer el subsistema uip maestro case general y cómo los recursos de registro se incorporan a la creación de tareas, consulta la descripción general.

Sinopsis

uip maestro case registry pull [-f, --force] [-s, --solution-id <solutionId>]
uip maestro case registry search [keyword] [-t, --type <type>] [-f, --filter <filter>] [--local]
uip maestro case registry list [--local]
uip maestro case registry get <identifier> [-t, --type <type>] [--connection-id <id>] [--local]
uip maestro case registry get-connector -t, --type <type> --activity-type-id <id>
uip maestro case registry get-connection -t, --type <type> --activity-type-id <id>

Flujo de trabajo típico:

1. uip maestro case registry pull: obtiene y almacena en caché el registro de recursos completo (se ejecuta una vez por sesión).
2. uip maestro case registry search <keyword>: encuentra un recurso.
3. uip maestro case registry get <identifier> — inspecciona su esquema completo.
4. uip maestro case registry get <identifier> --output-filter "Node.inputDefinition.fields": extrae solo los campos de entrada.

Conceptos

• Tipos de recursos : el registro indexa 17 tipos de recursos: agent, process, api, processOrchestration, caseManagement, flow, action-apps, solution, más 9 archivos de índice del conector typecache-* dividido por origen del catálogo (typecache-activities, typecache-triggers, typecache-packages y las variantes -external-automation-*/-external-agent-* de cada uno). Se mantienen como archivos de caché independientes porque los catálogos subyacentes son disjuntos: fusionarlos haría que cada extracción sobrescribiera las entradas del tipo anterior.
• Modo--local : search, list y get aceptan --local para buscar solo recursos de proyectos hermanos en la solución en lugar de la caché de todo el tenant. Requiere un archivo .uipx en el directorio actual o en uno de sus dos directorios principales; el identificador de get --local es la clave de recurso del hermano o su ID de proyecto .uipx.
• recursossolution : el tipo de recurso solution se almacena en caché solo cuando se da pull --solution-id <id>; buscar/obtener --type solution sin haberlo extraído primero devuelve una sugerencia explícita para ejecutar pull --solution-id primero.
• Enriquecimiento del conector : get enriquece automáticamente las coincidencias typecache-activities/typecache-triggers con metadatos del conector en vivo (buscados por la entrada uiPathActivityTypeId) cuando es posible; transmite --connection-id para obtener metadatos de campo personalizado específicos de la conexión. Este enriquecimiento se omite silenciosamente (no es un error) si la búsqueda falla.
• get-connector / get-connection — búsquedas de nivel inferior solo en el índice local de TypeCache (no en la caché de recursos general): get-connector resuelve una actividad del conector/entrada de desencadenador más su configuración del conector por --activity-type-id; get-connection hace la misma búsqueda y luego obtiene las conexiones disponibles del conector de Integration Service.

extracción de registro de casos de uip maestro

Obtener y almacenar en caché todos los tipos de recursos. Ejecuta todos los tipos en paralelo e informa de un desglose por tipo, incluido cualquiera que haya fallado.

Opciones

Corto	Largo	Valor	Descripción
-f	--force	Marca	Ignora la caché y vuelve a recuperar cada tipo de recurso.
-s	--solution-id <solutionId>	String	También extrae y almacena en caché los recursos propios de la solución dada (el tipo de recurso solution).

Ejemplo

uip maestro case registry pull

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "PullResourcesSuccess",
  "Data": {
    "TotalNodesCount": 128,
    "FromCache": false,
    "ResourceTypes": [
      {
        "Type": "typecache-activities",
        "NodesCount": 80,
        "FromCache": false,
        "AgeMinutes": null,
        "CacheWritten": true,
        "Info": null
      }
    ],
    "Errors": null
  }
}

Result es "PartialSuccess, N failed" (no "Success") cuando uno o más tipos de recursos no se pueden extraer — Errors enumera cada tipo fallido con su mensaje de error; los tipos extraídos correctamente aún se almacenan en caché y se reflejan en ResourceTypes.

búsqueda de registro de casos de uip maestro

Buscar recursos en caché por palabra clave y/o filtros de campo. Se requiere al menos uno de [keyword] o --filter.

Argumentos

Nombre	Obligatorio	Propósito
[keyword]	No*	Palabra clave de texto libre para buscar.

* Se debe proporcionar [keyword], --filter o ambos: omitir ambos falla antes de cualquier búsqueda.

Opciones

Corto	Largo	Valor	Descripción
-t	--type <type>	ENUM	Limita la búsqueda a un tipo de recurso. Uno de los tipos que se pueden buscar: consulta Conceptos para ver la lista completa de 17 tipos (todos los valores RESOURCE_TYPES son válidos aquí).
-f	--filter <filter>	String	Filtros de campo: field=value o field:operator=value, separados por comas para varios (por ejemplo name:contains=Apple,category=Pipelines). Campos: name, title, description, category, connectorKey. Operadores: equals, contains, in, startsWith, endsWith.
—	--local	Marca	Buscar solo recursos hermanos en la solución. Consulta Conceptos.

Ejemplos

uip maestro case registry search invoice

uip maestro case registry search --filter "name:contains=Apple,category=Pipelines"

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "ResourceSearchSuccess",
  "Data": {
    "Keyword": "invoice",
    "Filters": null,
    "Type": null,
    "Local": false,
    "ResultCount": 1,
    "Resources": [
      {
        "resourceType": "typecache-activities",
        "resource": {
          "name": "InvoiceParser",
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001"
        }
      }
    ],
    "FailedTypes": null,
    "Hint": null
  }
}

Hint se rellena (en lugar de omitirse) específicamente cuando --type solution devuelve cero resultados y --local no se aprobó; te dirige a registry pull --solution-id <id>. FailedTypes enumera cualquier tipo de recurso que haya dado error durante la búsqueda (se siguen devolviendo resultados parciales para los tipos que han tenido éxito).

lista de registro de casos de uip maestro

Enumera cada recurso en caché, agrupado por tipo. No llega a la red: refleja lo que pull se haya almacenado en caché por última vez; ejecuta pull primero (o de nuevo) para actualizar.

Opciones

Largo	Valor	Descripción
--local	Marca	Enumera solo los recursos hermanos en la solución en lugar de la caché de todo el tenant. Consulta Conceptos.

Ejemplo

uip maestro case registry list

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "ResourceListSuccess",
  "Data": {
    "ResourcesCount": 128,
    "Local": false,
    "ResourceTypes": [
      { "Type": "typecache-activities", "Count": 80 },
      { "Type": "typecache-triggers", "Count": 48 }
    ],
    "resources": []
  }
}

--local resuelve la solución y escanea su árbol de recursos directamente (sin caché involucrada); una solución faltante (no .uipx se ha encontrado) se informa como un error de limpieza en lugar de una lista vacía.

obtención del registro de casos de uip maestro

Obtenga uno o más registros de recursos completos por identificador.

Argumentos

Nombre	Obligatorio	Propósito
<identifier>	Sí	El recurso entityKey (tipos similares a procesos) o id (apps de acción): consulta el campo de id de cada tipo a través de Conceptos. Con --local, la clave de recurso del proyecto relacionado o el ID del proyecto .uipx en su lugar.

Opciones

Corto	Largo	Valor	Descripción
-t	--type <type>	ENUM	Limita la búsqueda a un tipo de recurso (el mismo conjunto que search --type).
—	--connection-id <id>	String	ID de conexión para metadatos de campo de Integration Service específicos del conector (campos personalizados). Solo se aplica a typecache-* coincidencias de actividad/desencadenador.
—	--local	Marca	Resolver contra recursos hermanos en la solución en lugar de la caché del tenant. Consulta Conceptos.

Ejemplo

uip maestro case registry get a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "ResourceGetSuccess",
  "Data": {
    "MatchCount": 1,
    "Local": false,
    "Resources": [
      {
        "ResourceType": "typecache-activities",
        "Resource": {
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
          "name": "InvoiceParser"
        }
      }
    ]
  }
}

Cero coincidencias es un fallo (respuesta de error sin Code), no un éxito vacío: el error Instructions difiere según el modo: un error --local sugiere volver a comprobar la clave de recurso del hermano o el ID del proyecto a través de registry list --local; un error --type solution sugiere ejecutar pull --solution-id primero; cualquier otra cosa solo informa de que "no se ha encontrado ningún recurso".

Obtener conector del registro de casos de UIP maestro

Busca una sola entrada de actividad/desencadenador del conector (y su configuración del conector) directamente desde el índice local de TypeCache, sin pasar por la búsqueda general de recursos.

Opciones

Corto	Largo	Valor	Obligatorio	Descripción
-t	--type <type>	ENUM	Sí	Escriba el índice de caché en el que buscar: typecache-activities, typecache-triggers, typecache-external-automation-activities, typecache-external-automation-triggers, typecache-external-agent-activities o typecache-external-agent-triggers.
—	--activity-type-id <id>	String	Sí	El uiPathActivityTypeId que se buscará.

Ejemplo

uip maestro case registry get-connector --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "ConnectorGetSuccess",
  "Data": {
    "Entry": {
      "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "InvoiceParser"
    },
    "Config": { "connectorKey": "uipath-connector-a" }
  }
}

obtención-conexión del registro de casos de uip maestro

Busca una actividad/desencadenador de conector (la misma búsqueda que get-connector) y luego recupera sus conexiones de Integration Service disponibles.

Opciones

Corto	Largo	Valor	Obligatorio	Descripción
-t	--type <type>	ENUM	Sí	Las mismas opciones de índice de TypeCache que get-connector.
—	--activity-type-id <id>	String	Sí	El uiPathActivityTypeId que se buscará.

Ejemplo

uip maestro case registry get-connection --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Result": "Success",
  "Code": "ConnectionGetSuccess",
  "Data": {
    "Entry": { "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001" },
    "Config": { "connectorKey": "uipath-connector-a" },
    "Connections": [
      { "id": "b2c3d4e5-0000-0000-0000-000000000001", "name": "Default" }
    ]
  }
}

Vincular una entrada de tarea a una variable

La entrada de una tarea está conectada a un valor/expresión literal o a la salida de otra tarea editando el archivo de esquema JSON de gestión de casos directamente. Referencia de campo: la entrada de una tarea en un <field-path> separado por puntos (<input-name>[.<key1>[.<key2>...]] — sin puntos establece input.value directamente; cada segmento de punto atraviesa un nivel de propiedad, por ejemplo body.body.body para el cuerpo de solicitud anidado de una actividad de conector) toma una cadena literal, una expresión con un prefijo permitido (=vars., =bindings., =js:, =metadata., =datafabric., =orchestrator.JobAttachments, =response, =result, =Error, =jsonString:), o una expresión =vars.<id> generada al obtener la salida de otra tarea. Edita la entrada de la tarea de caseplan.json directamente para establecer cualquiera de estos y luego ejecuta uip maestro case validate <file>.

Relacionado

• Caso de uip maestro : descripción general y el resto del subsistema de gestión de casos.

Ver también

• Descripción general de la herramienta de Maestro
• Opciones globales
• Códigos de salida