tareas de caso de uip maestro

Sintaxis y opciones para `tareas de casos de uip maestro`, que lee y enriquece tareas dentro de una etapa en un archivo JSON de definición de gestión de casos, más la referencia de campo JSON para crear uno manualmente.

Una tarea es una unidad de trabajo dentro de una etapa de una definición de gestión de casos: una ejecución de proceso, una invocación de agente, un flujo de trabajo de API, un trabajo de RPA, un elemento de acción humana, una espera de temporizador, una actividad de conector o una espera para un evento del conector de entrada. Las entradas de tareas se encuentran dentro de los carriles de una etapa en el archivo JSON de definición de caso (la misma estructura de archivo en la que operan stages y task-entry-conditions ); uip maestro case tasks los lee y enriquece.

Para las reglas de entrada que bloquean cuándo una tarea se vuelve ejecutable, consulta uip maestro case task-entry-conditions. Para obtener el modelo de concepto general de Gestión de casos, consulta uip maestro case.

Conceptos

• Carril : las tareas dentro de una etapa se agrupan en carriles paralelos (índice 0, 1, 2, …); las tareas en el mismo carril se ejecutan secuencialmente, las tareas en diferentes carriles se ejecutan en paralelo. lane se establece de forma predeterminada en 0 al crear manualmente una tarea.
• Tipo de tarea : una de process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, wait-for-connector, execute-connector-activity, case-management. Los tipos respaldados por conector (execute-connector-activity, wait-for-connector) utilizan una forma de campo diferente a los demás (consulta a continuación).
• Enriquecimiento : varios tipos de tareas necesitan un esquema de entrada/salida y metadatos de vinculación extraídos de la plataforma (un contrato de entrada/salida real de un proceso, un esquema de campo de una actividad de conector) antes de que Studio Web pueda representarlos de forma significativa. tasks enrich y tasks describe son comandos de búsqueda para esos metadatos, útiles para descubrir qué escribir en el JSON de una tarea antes de crearla manualmente.

Sinopsis

uip maestro case tasks get <file> <stage-id> <task-id>
uip maestro case tasks enrich --type <type> --id <id> [--element-id <id>]
uip maestro case tasks describe --type <type> --id <id> [--connection-id <id>]

Campos JSON de tareas

Las tareas se añaden, editan y eliminan manualmente en las matrices de carriles de etapa de caseplan.json y luego se validan con uip maestro case validate. Referencia de campo:

Una tarea sin conector : tipos de tareas: process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, case-management (los siguientes tipos respaldados por conector son independientes). Campos: displayName, name (nombre de proceso/flujo de trabajo), folderPath, lane (índice de carril paralelo, predeterminado 0), shouldRunOnlyOnce, description, isRequired; Solo tipo action: taskTitle, priority (Low|Medium|High|Critical, predeterminado Medium), recipient (correo electrónico; también establece assignmentCriteria como user). Una tarea enriquecida (vinculaciones/entradas/salidas buscadas desde la plataforma) lleva además un elementId y enriched: true estable: utiliza tasks enrich para obtener esa carga útil antes de escribirla a mano.

Una tarea respaldada por conector : tipo de tarea execute-connector-activity (actividad) o wait-for-connector (desencadenador), identificada por un TypeCache uiPathActivityTypeId y un ID de conexión. Lleva un serviceType de Intsvc.ActivityExecution (actividad) o Intsvc.WaitForEvent (desencadenador). Valores de entrada: para una actividad, codificados por nombre de entrada (body, pathParameters, queryParameters); para un desencadenador, los valores en body se convierten en parámetros de filtro de eventos (se genera un filters.expression a partir de ellos, por ejemplo (project == 'PROJ' && issuetype == 'Bug')) y también rellenar queryParams/parameters. Utiliza tasks describe para descubrir nombres de entrada reales y la carga útil de enriquecimiento completo antes de escribir a mano una tarea.

Actualizar una tarea : fusiona los mismos campos displayName/name/folderPath/shouldRunOnlyOnce/description/isRequired en el objeto de tarea existente (los campos no enumerados mantienen su valor actual). name/folderPath no tienen efecto en una tarea wait-for-timer, que no tiene bloque data.

Eliminar una tarea : elimina su entrada directamente de la matriz de carriles de la etapa; soltar el carril por completo si se vacía.

Después de cualquier edición manual, ejecuta uip maestro case validate.

uip maestro case task get

Imprime una sola tarea desde una etapa.

Argumentos

Nombre	Obligatorio	Propósito
<file>	Sí	Ruta al archivo JSON de gestión de casos.
<stage-id>	Sí	ID de la etapa que contiene la tarea.
<task-id>	Sí	ID de la tarea que se va a recuperar.

Ejemplo

uip maestro case tasks get case.json Stage_1 ta1b2c3d

Forma de datos (--json de salida)

{
  "Code": "TaskFound",
  "Data": {
    "StageId": "Stage_1",
    "Lane": 0,
    "Index": 0,
    "Task": { "id": "ta1b2c3d", "type": "process", "displayName": "Process invoice" }
  }
}

las tareas del caso uip maestro enriquecen

Busca el esquema de entrada/salida real de un tipo de tarea y las vinculaciones desde la plataforma, sin escribir en ningún archivo. Visible en --help.

Nota:

Utilízalo para obtener una vista previa de lo que tasks add --task-type-id producirá antes de enviarlo a un archivo. Específicamente para las actividades/desencadenadores del conector, utiliza tasks describe en su lugar: enrich cubre los otros tipos enriquecidos (process, agent, rpa, action, api-workflow, case-management, flow-process) .

Opciones

Largo	Valor	Obligatorio	Descripción
--type <type>	uno de los tipos enriquebles	Sí	Tipo de tarea.
--id <id>	String	Sí	ID único de la tarea (entityKey o Action App ID, dependiendo del tipo).
--element-id <id>	String	No	ID de elemento para el ámbito de la vinculación de variables.

Ejemplo

uip maestro case tasks enrich --type process --id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Code": "TaskEnriched",
  "Data": {
    "name": "InvoiceProcess",
    "folderPath": "Shared",
    "inputs": [],
    "outputs": []
  }
}

La forma exacta Data depende de --type: una carga útil de enriquecimiento sin procesar de la plataforma, no normalizada a un esquema fijo.

descripción de las tareas del caso de uip maestro

Describe los metadatos de entrada/salida de un tipo de tarea para el descubrimiento de enlaces: la cobertura de tipo más amplia de cualquier comando de búsqueda aquí (añade connector-activity, connector-trigger, external-workflow y external-agent además de todo lo que admite enrich). Visible en --help.

Opciones

Largo	Valor	Obligatorio	Descripción
--type <type>	uno de los tipos descriptibles	Sí	Tipo de tarea: consulta la lista anterior.
--id <id>	String	Sí	ID único de la tarea (entityKey o Action App ID).
--connection-id <id>	Uuid	condicionalmente	Obligatorio para connector-activity, connector-trigger, external-workflow y external-agent : el comando falla rápidamente con un error explícito si se omite para estos tipos. No se utiliza para otros tipos.

external-workflow y external-agent se describen de forma idéntica a connector-activity (mismo proceso de enriquecimiento de Integration Service, mismo requisito --connection-id) pero resuelven su ID de tipo con un índice TypeCache diferente, ya que Studio Web los sirve desde un catálogo independiente.

Ejemplo

uip maestro case tasks describe --type connector-activity \
  --id a1b2c3d4-0000-0000-0000-000000000001 \
  --connection-id b2c3d4e5-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Code": "TaskDescribed",
  "Data": {
    "inputs": [{ "name": "body", "body": {} }],
    "outputs": [{ "name": "response" }]
  }
}

Un campo enrichment solo se incluye cuando la búsqueda subyacente devuelve uno.

Relacionado

• Caso de uip maestro : conceptos y el directorio completo del subsistema.
• condiciones-de-entrada-de-tarea del caso de uip maestro: reglas que activan cuándo una tarea se vuelve ejecutable.
• Casos y etapas del caso uip maestro : la etapa en la que vive una tarea.

Ver también

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