Criar nova tarefa para um processo - API

1 - Antes de qualquer coisa, precisa-se realizar a configuração da API no equipamento do provedor, para saber como realizar esta configuração, basta acessar o link Configurando acesso ao Webservice API Apache ou Configurando acesso ao Webservice API Nginx após esta configuração, realize os passos abaixo para criar tarefas para um processo via API.

2 - Após realizar a configuração da API no equipamento do cliente, basta criar o seguinte código, nesta requisição vamos criar uma nova tarefa dentro de um processo.

 1 <?php
 2 // requerindo arquivo do webservice
 3 require(__DIR__ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
 4 // url do sistema
 5 $host = 'https://IP/webservice/v1';
 6 //token gerado no cadastro do usuario (verificar permissões)
 7 $token = 'TOKEN';
 8 //true para certificado auto assinado
 9 $selfSigned = true;
10 
11 // instanciando api requerida na primeira linha do código
12 $api = new IXCsoft\WebserviceClient($host, $token, $selfSigned);
13 
14 //array de parâmetros do método
15 $dados = array(
16     'id_setor' => '1',//obrigatorio, buscar ID na tabela empresa_setor
17     'id_processo' => '1',//obrigatorio, buscar ID na tabela wfl_processo
18     'descricao' => 'teste api',//obrigatorio, maximo 200 caractares
19     'sequencia' => '0',//obrigatorio, qual na ordem de sequencia ele pertence
20     'prazo_minutos' => '0',//obrigatorio,em minutos maximo 11 caractares, Atualmente apenas informativo.
21     'ativo' => 'S',//S = Sim ou N = Não
22     'permite_finalizar' => 'S',//permite que o processo seja finalizado sem que esta tarefa precise ser executada. S = Sim ou N = Não.
23     'finaliza_processo' => 'N',// Pode forçar a finalização do processo antes da execução de todas as tarefas. S = Sim ou N = Não.
24     'gera_comissao' => 'ROS',//ROS = Respeita definição da OS ou SF = Somente se finalizar processo
25     'decisao' => 'N',//Se marcado como "Sim", significa que permitirá a seleção da próxima tarefa (conforme a sequência). S = Sim ou N = Não.
26     'obrigatorio' => 'S',//devine se é obrigatorio na sequencia do processo. S = Sim ou N = Não.
27     'id_tarefa_anterior' => '0',//ID da tarefa anterior
28     'id_proxima_tarefa' => '2'//ID da proxima tarefa
29 );
30 
31 //execução do método POST API
32 $api->post('wfl_tarefa', $dados);
33 
34 // false para retorno em json e true para retorno em array php
35 $retorno = $api->getRespostaConteudo(false);// false para json | true para array
36 
37 //printando resultado
38 var_dump($retorno);
39 exit;
40 
41 ?>

2.1 - O retorno recebido pode ser tanto de sucesso como de erro no caso de alguma inconsistência nos dados passados. Nesse caso obtemos um retorno de sucesso:

Retorno de nova tarefa criada.png

-

Voltar ao menu Recursos da API