Pipefy Bulk gql

[iannsp]

Make bulk updates.

Pipefy Recomendations:

• not more than 500reqs/30sec so it help to avoid this rate limit.
• not more than 30 mutations per bulk.

this feature also increase the result application performance.

The normal mode is execute each gql as soon requested but in this mode they are put in bulks and use the notation:

mutation{
[lineID] : [gql ]
}

• Pipefy::bulkStart() Open the bulk to write

• Pipefy::bulkEnd()
  Close the bulk for write

• Pipefy::bulkscript() return the bulk gql script.

• Pipefy::bulkExecute() Execute the bulk request.

• Pipefy::bulkResult() Return the state of each gql in the bulk after execute. Used to check for success or failure.

Use Case

You need to check for cards in the Pipe that are more than three days overdue and write a comment remember the assignee avbout the task.

$cards = new Clientedigital\Pipefy\Pipe([PipeID])->Cards();

$lastUpdateDate = (new DateTime())->sub(new DateInterval('P3D'));

$filter= new Clientedigital\Pipefy\Filter\Cards();
$filter->by('due_date', '<', $lastUpdateDate );

$cards->filter($filter);

// return the generator.
$cards = $cards->get();

Pipefy::bulkStart();

foreach($cards as $card){
    $cards->update(   
        ($card->get())
            ->addComment('Hi, This card is 3 days late. Please check the task.')
    );
}

Pipefy::bulkEnd(); 

try{
    Pipefy::bulkExecute();  
} catch(\Exception $except){
   $log->info('Some error in bulk mutation');
}

[iannsp]

GraphQL

• exec refactoring de Pipefy request (GQL) :: retonar Result
• • como validar a execucao ja que CLientId nao funciona(null)?
• Pipefy request(string gqlscrit): StdClass // refactoring... deixa de existir em prol de graphql method.

Bulk

um tipo de GQL // pode ser passado para GraphQL ->Exec(GQLInterface) Somente mutations ocorrem em Bulk.

• add(GQL): int (id do item no bulk) ao add faz um check e se faltar required lanca exception.
• remove
• list
• paginate() retonar um generator of Page que obedece CLIENTE_DIGITAL_BULK_PAGE_SIZE e suportam script() retorna null quando nao tem mais paginas.
• capacity informa o numero de scripts e a capacidate(CLIENTE_DIGITAL_BULK_PAGE_SIZE = 30) exemplo 20/30.
• script() retorna a graphql que sera executada

[iannsp]

capacity became info