Adicionar regra de aprovação

Adiciona uma regra à configuração de aprovação de uma fase. Uma regra define, por meio de condições, quando ela se aplica a um card, e quem são os aprovadores responsáveis por votar quando ela é acionada.

As regras devem ser enviadas uma de cada vez: enviar um array com mais de uma regra em uma única chamada não é aceito. Para cadastrar várias regras, repita esta chamada uma vez para cada regra.

O campo approvers.type define o formato da votação: alternative corresponde a um fluxo horizontal, no qual qualquer aprovador do nível decide, sem seguir necessariamente a ordem dos níveis definidos em hierarchy; cumulative corresponde a um fluxo vertical, no qual os níveis de hierarchy são percorridos em cadeia — o nível 1 precisa concluir sua aprovação antes que o nível 2 seja habilitado a votar, e assim por diante. O campo hierarchy[].quantity define quantos aprovadores daquele nível precisam votar para o nível ser considerado concluído.

Cada usuário em hierarchy[].users é identificado pelo seu identificador de usuário, obtido a partir da listagem de usuários da empresa — que também traz nome e e-mail, úteis para localizar o usuário correto antes de anotar o identificador. Usuários sem acesso ao flow não podem ser adicionados como aprovadores. Já dentro de conditions, quando uma regra precisa filtrar pelo autor de uma ação anterior no card — como o responsável por um parecer técnico — a identificação correta é feita por nome ou e-mail, e não por um identificador interno de usuário.

Os operadores de condição aceitos são: gte, lt, eq, in, all, contain, is-empty e is-not-empty. Não existem operadores gt nem lte — para expressar 'maior que X' utilize gte com o valor X+1, e para 'menor ou igual a X' utilize lt com o valor X+1.

curl --location '/v1/flows//phases//approval-config//rules' \ --header 'Content-Type: application/json' \ --data '{ "conditions": [ { "rule": [ { "path": "string", "reference": "string", "condition": "gte", "target": null } ] } ], "approvers": { "type": "alternative", "hierarchy": [ { "level": 0, "quantity": 0, "users": [ "string" ] } ] } }'

Adicionar regra de aprovação

Requisição

Respostas