tarefas de caso do UIP Maestro

Sintaxe e opções para "tarefas de caso uip Maestro", que lê e enriquece tarefas dentro de um estágio em um arquivo JSON de definição de gerenciamento de caso, além da referência de campo JSON para criação manual.

Uma tarefa é uma unidade de trabalho dentro de um estágio de uma definição de gerenciamento de caso — uma execução de processo, uma invocação de agente, um fluxo de trabalho de API, um trabalho de RPA, um item de ação humana, uma espera de temporizador, uma atividade de conector ou uma espera por um evento do conector de entrada. As entradas de tarefas residem dentro das faixas de um estágio no arquivo JSON de definição de caso (a mesma estrutura de arquivo stages e task-entry-conditions operam); uip maestro case tasks os lê e os enriquece.

Para regras de entrada que fecham quando uma tarefa se torna executável, consulte uip maestro case task-entry-conditions. Para o modelo de conceito geral de Gerenciamento de caso, consulte uip maestro case.

Conceitos

• Faixa — as tarefas dentro de um estágio são agrupadas em faixas paralelas (índice 0, 1, 2, …); tarefas na mesma faixa são executadas sequencialmente, tarefas em faixas diferentes são executadas em paralelo. lane assume como padrão 0 ao criar manualmente uma tarefa.
• Tipo de tarefa — um destes process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, wait-for-connector, execute-connector-activity, case-management. Tipos com conector (execute-connector-activity, wait-for-connector) usam um formato de campo diferente dos outros (veja abaixo).
• Enriquecimento — vários tipos de tarefas precisam do esquema de entrada/saída e dos metadados de associação extraídos da plataforma (o contrato de entrada/saída real de um processo, o esquema de campo de uma atividade do conector) antes que o Studio Web possa renderizá-los significativamente. tasks enrich e tasks describe são comandos de pesquisa para esses metadados, úteis para descobrir o que escrever no JSON de uma tarefa antes de criá-la manualmente.

Resumo

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 da tarefa

As tarefas são adicionadas, editadas e removidas manualmente nas matrizes de faixas de estágio do caseplan.json e, em seguida, validadas com uip maestro case validate. Referência de campo:

Uma tarefa sem conector — tipos de tarefas: process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, case-management (os tipos com conector abaixo são separados). Campos: displayName, name (nome do processo/fluxo de trabalho), folderPath, lane (índice de faixas paralelas, padrão 0), shouldRunOnlyOnce, description, isRequired; Somente para o tipo action: taskTitle, priority (Low|Medium|High|Critical, padrão Medium), recipient (email; também define assignmentCriteria como user). Uma tarefa enriquecida (vinculações/entradas/saídas pesquisadas da plataforma) também carrega um elementId e enriched: true estáveis — use tasks enrich para buscar essa carga antes de gravá-la manualmente.

Uma tarefa baseada em conector — tipo de tarefa execute-connector-activity (atividade) ou wait-for-connector (gatilho), identificada por um TypeCache uiPathActivityTypeId e um ID de conexão. Carrega um serviceType de Intsvc.ActivityExecution (atividade) ou Intsvc.WaitForEvent (gatilho). Valores de entrada: para uma atividade, chaveado pelo nome de entrada (body, pathParameters, queryParameters); para um gatilho, os valores em body se tornam parâmetros de filtro de eventos (um filters.expression é gerado a partir deles, por exemplo (project == 'PROJ' && issuetype == 'Bug')) e também preencha queryParams/parameters. Use tasks describe para descobrir nomes de entradas reais e a carga de enriquecimento completa antes de escrever uma tarefa à mão.

Atualização de uma tarefa — mescle os mesmos campos displayName/name/folderPath/shouldRunOnlyOnce/description/isRequired no objeto da tarefa existente (os campos não listados mantêm seu valor atual). name/folderPath não têm efeito em uma tarefa wait-for-timer, que não tem bloco data.

Remoção de uma tarefa — exclua sua entrada diretamente da matriz de faixas do estágio; solte a faixa totalmente se ela ficar vazia.

Após qualquer edição manual, execute uip maestro case validate.

tarefas de caso do uip Maestro obter

Imprimir uma única tarefa de um estágio.

Argumentos

Name	Required	Finalidade
<file>	sim	Caminho para o arquivo JSON de gerenciamento de caso.
<stage-id>	sim	ID do estágio que contém a tarefa.
<task-id>	sim	ID da tarefa a ser recuperada.

Exemplo

uip maestro case tasks get case.json Stage_1 ta1b2c3d

Formato dos dados (--output json)

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

tarefas de caso do uip Maestro enriquecem

Procure o esquema de entrada/saída real e as associações de um tipo de tarefa da plataforma, sem gravar em nenhum arquivo. Visível em --help.

Observação:

Use isso para visualizar o que tasks add --task-type-id produzirá antes de confirmá-lo em um arquivo. Para atividades/gatilhos de conector especificamente, use tasks describe — enrich abrange os outros tipos enriquecíveis (process, agent, rpa, action, api-workflow, case-management, flow-process) .

Opções

Long	Valor	Required	Description
--type <type>	um dos tipos enriquecíveis	sim	Tipo de tarefa.
--id <id>	String	sim	ID exclusivo da tarefa (ID da entidade ou do aplicativo de ação, dependendo do tipo).
--element-id <id>	String	não	ID do elemento para o qual delimitar a associação da variável.

Exemplo

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

Formato dos dados (--output json)

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

A Data forma exata depende de --type — uma carga de enriquecimento bruta da plataforma, não normalizada para um esquema fixo.

descrição das tarefas de caso do uip Maestro

Descreva os metadados de entrada/saída de um tipo de tarefa para descoberta de associação — a mais ampla cobertura de tipos de qualquer comando de pesquisa aqui (adiciona connector-activity, connector-trigger, external-workflow e external-agent, além de tudo o que é compatível com enrich). Visível em --help.

Opções

Long	Valor	Required	Description
--type <type>	um dos tipos descritivos	sim	Tipo de tarefa — consulte a lista acima.
--id <id>	String	sim	ID exclusivo da tarefa (ID da entidade ou do aplicativo de ação).
--connection-id <id>	UUID	condicionalmente	Necessário para connector-activity, connector-trigger, external-workflow e external-agent — o comando falha rapidamente com um erro explícito se omitido para esses tipos. Não é usado para outros tipos.

external-workflow e external-agent descrevem de forma idêntica a connector-activity (mesmo pipeline de enriquecimento do Integration Service, mesmo requisito --connection-id), mas resolvem seu ID de tipo em relação a um índice TypeCache diferente, pois o Studio Web os atende a partir de um catálogo separado.

Exemplo

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

Formato dos dados (--output json)

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

Um campo enrichment é incluído apenas quando a pesquisa subjacente retorna um.

Relacionado

• caso uip Maestro — conceitos e o diretório completo do subsistema.
• uip Maestro case task-entry- condition — regras que fecham quando uma tarefa se torna executável.
• casos e estágios de caso do uip Maestro — o estágio em que uma tarefa reside.

Veja também

• Visão geral da ferramenta Maestro
• Opções globais
• Códigos de saída