APIs - Tutoriais

GetProcessInstance

59 views 18/06/2021 21/06/2021 alex-serodio 0

GetProcessInstance

Obtém as informações de uma instância específica de um processo (um processo já iniciado).

Payload de entrada:

{
    "processInstance": 1    // identificador numérico do processo
}

Exemplo de request:

curl --location --request POST "https://api.senior.com.br/platform/workflow/queries/getProcessInstance" --header "Authorization: Bearer {access_token}" --header "Content-Type: application/json" --header "Accept: application/json" --data-raw "{ 'processInstance': 1 }"

Responses:

  • 200 OK
    {
        "processInstance": {
            "id": 0,                                        // identificador da instância do processo
            "process": {
                "processId": 0,                             // identificador do processo
                "currentVersion": 0,                        // versão atual do processo
                "publishedVersion": 0,                      // versão publicada do processo
                "processName": "string",                    // nome do processo
                "processRawName": "string",                 // nome do processo assim como se encontra no banco de dados
                "changed": true,                            // se o processo está modificado
                "fileName": "string",                       // nome do arquivo do processo
                "status": "Saved",                          // se o processo esta publicado ou apenas salvo. Pode ser Saved ou Published
                "description": "string",                    // descrição do processo
                "creationDate": "2021-06-19T18:13:16.297Z", // data de criação do processo
                "active": true,                             // se o processo está ativo
                "embedded": true,                           // se o processo é embarcado
                "simple": true,                             // se o processo é simples
                "tag": "string",                            // tag agrupador de processos
                "accessLevel": "EDIT_AND_START",            // indica o nível de acesso do usuário ao processo. Pode ser EDIT_AND_START, START, EDIT ou NONE
                "icon": "string",                           // ícone do processo
                "serviceEventQtyByType": [                  // listagem dos tipos e quantidade de eventos de serviço externo
                    {
                        "type": "IN_PROGRESS",              // tipo do evento
                        "quantity": 0                       // quantidade de eventos
                    }
                ]
            },
            "startedSubject": {                             // responsável que iniciou o processo
                "userCode": 0,                              // código do responsável
                "name": "string",                           // nome do responsável
                "subjectKind": "User"                       // tipo do responsável. Pode ser User, Group, Role ou UserApp
            },
            "cancelSubject": {                              // responsável que cancelou o processo
                "userCode": 0,                              // código do responsável
                "name": "string",                           // nome do responsável
                "subjectKind": "User"                       // tipo do responsável. Pode ser User, Group, Role ou UserApp
            },
            "startDate": "2021-06-19T18:13:16.297Z",
            "lastUptadeDate": "2021-06-19T18:13:16.297Z",
            "endDate": "2021-06-19T18:13:16.297Z",
            "flowExecutionStatus": "string",
            "endMessage": "string",
            "description": "string",
            "flowToken": [
                {
                    "processInstanceID": 0,
                    "step": 0,
                    "activityId": 0
                }
            ],
            "taskExpiration": "2021-06-19T18:13:16.297Z"
        }
    }
    Ou, se não encontrar uma instância de processo com o identificador informado:
    {}
  • 400 Bad Request: Requisição inválida, parâmetros obrigatórios não informados ou campo informado incorretamente
    {
       "message": "Descrição do erro",
       "errorCode": "codigoDoErro",
       "reason": "BAD_REQUEST",
       "domain": "platform",
       "service": "workflow"
    }
  • 401 Unauthorized: Usuário ou senha inválido
    {
       "error_description": "Descrição do erro",
       "error": "codigo_do_erro"
    }

Este artigo foi útil para você?