Changes between Version 4 and Version 5 of WF/Jobs

Timestamp:

09/21/09 16:20:47 (15 years ago)

Author:

rufino

Comment:

Adicionado explicação e exemplo de uso do método createNewInstance

WF/Jobs

@@ -64 +64 @@
 Ao remover um Job, o arquivo que implementa o Job também é excluído do sistema de arquivos. Além disso, os Logs produzidos pelo Job também são apagados.
 
-== Exemplo ==
+== Exemplo 1 ==
 No exemplo abaixo, buscamos as instâncias que estão paradas na atividade "Avaliar Serviço" há mais de 10 dias e, chamamos a ação "Confirmar". Este Job poderia ser executado diariamente e, assim, evitar o acúmulo de instâncias.
 {{{
@@ -113 +113 @@
 }}}
 
+== Exemplo 2 ==
+Neste exemplo mostrarmos como criar uma instância automaticamente à partir de um Job. A criação da instância é realizada através do seguinte método.
+
+{{{
+final public function createNewInstance($startActivityId, $instanceName=false, $properties=false, $user=false)
+}}}
+'''Onde:'''
+ * '''startActivityId''': ID da atividade Start que criará a instância;
+ * '''instanceName''': Identificador da instância no processo;
+ * '''properties''': Array de propriedades da instância; e
+ * '''user''': uidNumber do dono da instância, que se omitido, será um usuário padrão do Job.
+
+O código fonte abaixo apresenta na prática como uma instância pode ser criada em um Job.
+
+{{{
+class CriarInstancia extends JobBase
+{
+        public function run()
+        {
+                // Cria objeto $role para pegar o código da atividade start, no caso Abrir OS
+                $role = &$this->environment['factory']->getInstance('wf_role');
+                $activityId = $role->getActivityIdByName('Abrir OS');
+
+                // Instância não necessita de identificador
+                $name = false;
+
+                // seta o array de propriedades da instância
+                $properties = array ('_servico_id' => 5
+                                     , '_roteamento' => 'end'
+                              );
+
+                // Cria a instância e grava mensagens de sucesso ou falha no log de execução do Job.
+                if ($this->createNewInstance($activityId, $name, $properties)){
+                        $this->success('Instância criada');
+                } else {
+                        $this->fail('Não foi possível criar a instância.');
+                }
+        }
+}
+}}}
+
 == Logs ==
 O Log é o resultado de cada execução de um Job. Sua listagem pode ser acessada através do ícone de um documento contendo ítens.