Treinamento Básico - Workflow - v00

Treinamento Básico - Workflow

NDICE Í NDICE

1 2 3 4 5 6 7

CONSIDERAÇÕES INICIAIS........................ ........................ ....................... ......................... .............. 3 P ARAMETRIZAÇÃO B ÁSICA ........................ ........................ ....................... ......................... .............. 4 OBJETOS ..................... ........................ ......................... ....................... ......................... .............. 9 DOCUMENTOS DE MODIFICAÇÃO ....................... ...................... ......................... ......................... .... 16 T AREFAS ..................... ........................ ......................... ....................... ......................... ............ 19 FERRAMENTAS DE TESTES ........................ ........................ ....................... ......................... ............ 34 LOG DE WORKFLOW ...................... ......................... ...................... ......................... ..................... 38

NDICE Í NDICE

1 2 3 4 5 6 7

CONSIDERAÇÕES INICIAIS........................ ........................ ....................... ......................... .............. 3 P ARAMETRIZAÇÃO B ÁSICA ........................ ........................ ....................... ......................... .............. 4 OBJETOS ..................... ........................ ......................... ....................... ......................... .............. 9 DOCUMENTOS DE MODIFICAÇÃO ....................... ...................... ......................... ......................... .... 16 T AREFAS ..................... ........................ ......................... ....................... ......................... ............ 19 FERRAMENTAS DE TESTES ........................ ........................ ....................... ......................... ............ 34 LOG DE WORKFLOW ...................... ......................... ...................... ......................... ..................... 38

TREINAMENTO BÁSICO - WORKFLOW Versão: 0

Data Versão: 06/12/2005

1 CONSIDERAÇÕES INICIAIS Para acessar qualquer atividade em Workflow: MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO Ou Transação SWLD.

As customizações e desenvolvimentos em Workflow são independentes de mandantes (ou “client independent”).

Elaborado em 11/12/2007

Autor: Maximiliano Araujo Pedatella

Página 3 de 40



2 P ARAMETRIZAÇÃO B ÁSICA Para a parametrização do Workflow existe a função de customizing automático, porém existem alguns itens que devem ser parametrizados manualmente. Acesso: Transação SWU3 ou o u MENU SAP / FERRAMENTAS / BUSINESS BUSINES S WORKFLOW / DESENVOLVIMENTO / UTILITÁRIOS / SWU3 – CUSTOMIZING WORKFLOW AUTOMÁTICO. Parametriza-se manualmente os seguintes itens:

1o) Configurar destino RFC É o usuário que trabalha dentro de um mandante para executar automaticamente as tarefas de workflow. O usuário RFC deve ser do tipo “Sistema” e ter os perfis: SAP_ALL e SAP_NEW. Selecionar a opção indicada Configurar destino RFC e clicar em

.

Informar o usuário e a senha do destino RFC, em seguida, clicar em Elaborado em 11/12/2007


. Página 4 de 40



Para verificar se os dados de destino RFC estão corretos, na tela dos itens de parametrização, clique em . 2o) Atualizar administrador de sistema para workflow É o usuário do mandante avisado no caso de qualquer problema no funcionamento de alguma tarefa em execução. Selecionar a opção indicada Atualizar administrador de sistema para workflow e clicar em . Informar o usuário administrador, em seguida, clicar em



.

Página 5 de 40



3o) Atualizar variante de planificação ativa É a variante de planificação considerada pelo sistema de workflow como a única válida. Selecionar a opção indicada Atualizar variante de planificação ativa e clicar em Informar ‘01’ (Plano atual), em seguida, clicar em

.

.

4o) Atualizar nos de prefixo São os três primeiros dígitos utilizados pelo sistema para identificar os objetos da administração de organização (posições, cargos, unidades organizacionais, etc.), sendo que, os últimos cinco dígitos desta identificação são atribuídos automaticamente pelo sistema. Selecionar a opção indicada Atualizar n os de prefixo e clicar em



.

Página 6 de 40



Clicar em em .

, em seguida, informar o prefixo, o sistema e o mandante. Por fim, clicar

Incluir os sistemas existentes na organização com os seus respectivos mandantes, sendo que, deverá iniciar a numeração a partir de 900.

Após executar estes 4 itens anteriores, executar o “AutoCustomize” para parametrizar o que resta, então: Selecionar a opção Verificar entradas de tabelas de controle HR e clicar em Selecionar a opção Atualiz.amb.tmp.execução e clicar em . Elaborado em 11/12/2007


.

Página 7 de 40



Selecionar a opção Atualiz.ambiente definição e clicar em . Selecionar a opção Classificar tarefas como geral e clicar em . Para verificar se a parametrização está correta, clique em , em seguida, clique em , para ir para a pasta de entrada de Workflow. Selecione o workflow Primeira etapa em verificação de workflow , em seguida, clique em .

Clique em Executar imediatamente etapa em background. Verifique na mensagem de Notificação final se aparece a seguinte informação: Sistema configurado com êxito.



Página 8 de 40



3 OBJETOS O objeto é todo documento existente no SAP R/3 que possua uma identificação, um número ou um código (por exemplo: pedido, material, cliente). Assim, na visão do Workflow estes documentos receberam outros nomes e devem existir para que seja possível o desenvolvimento de uma tarefa. Os objetos standard podem ser encontrados acessando a transação SWO1 (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / SWO1 – BUSINESS OBJECT BUILDER), em seguida, clicando em . Será exibida uma estrutura de objetos, onde será possível selecionar, de acordo com o assunto o objeto desejado.

Boa parte dos controles de uma tarefa de workflow são definidos na criação do objeto, a seguir serão definidas partes do objeto que possuem estes controles. 1) Subtipo de objeto Um objeto deve ser copiado, pois os objetos standard não permitem modificações. Para se criar um subtipo, informe o objeto super, em seguida, clique em . Elaborado em 11/12/2007


Página 9 de 40



O objeto super deve ser delegado para o subtipo criado, se desejar que os eventos standard do sistema acionem o subtipo criado ao invés do objeto super. Para delegar um objeto, acesse a transação SWO1, clique no menu , em seguida, clique em


.


Página 10 de 40



Após criar o objeto, o mesmo deve ser implementado e, em seguida, liberado para que possa ser utilizado.

Após a liberar o objeto, o mesmo deve ser gerado, clicando em

.

Deve-se gerar o objeto sempre que alguma modificação for efetuada no mesmo.

2) Evento O evento é uma ação que ocorre sobre o objeto, sendo que, podem ser criados novos eventos além dos eventos standard.



Página 11 de 40



Para se criar um evento, clique em

, em seguida, clique em

.

3) Método O método é um procedimento executado no objeto, sendo que, uma tarefa de workflow normalmente executa um método de um determinado objeto.



Página 12 de 40



Para se criar um método, clique em

, em seguida, clique em

.

Configuração na ABA Geral : Diálogo : método de diálogo, que interage com o usuário, seu processamento não é

em background.

Síncrono : método usa parâmetros ou resultados, é sempre utilizado quando o

método é executado por uma tarefa. Configuração na ABA ABAP:

O método ao ser executado pode chamar uma função, transação, programa ou relatório, ou simplesmente executar um código ABAP desejado. Por exemplo, pode ser chamada a transação CV02N (Modificar documento):



Página 13 de 40



O código ABAP executado quando o método é acionado pode ser visualizado ou modificado, clicando no método desejado, em seguida, clicando em .



Página 14 de 40



Objeto -> quem ou o que será controlado. Evento -> quando será controlado. Método -> o que fazer quando o evento ocorrer sobre o objeto.



Página 15 de 40



4 DOCUMENTOS DE MODIFICAÇÃO O documento de modificação é um documento manipulado pelo sistema para registrar eventos que ocorrem sobre cada objeto. Os documentos de modificação podem ser encontrados acessando a transação SCDO (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / EVENTOS / DOCUMENTOS DE MODIFICAÇÃO / SCDO – SÍNTESE). Será exibida uma relação com os documentos e suas descrições.

1) Documento de Modificação X Objeto A relação existente entre o documento de modificação e o objeto define quais as ações efetuadas sobre o documento de modificação irão refletir no objeto. Esta relação pode ser encontrada acessando a transação SWED (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / EVENTOS / DOCUMENTOS DE MODIFICAÇÃO / SWED – DEFINIR CARACTERÍSTICAS DE WORKFLOW).



Página 16 de 40



2) Documento de Modificação X Objeto X Evento A relação existente entre o documento de modificação, o objeto e o evento define quais as ações efetuadas sobre o documento de modificação irão disparar um evento de um determinado objeto que poderá acionar um workflow. Esta relação pode ser encontrada acessando a transação SWEC (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / EVENTOS / DOCUMENTOS DE MODIFICAÇÃO / SWEC – ACOPLAMENTO).



Página 17 de 40



Pode-se definir condições para que o evento seja acionado, selecionando o evento que se deseja configurar e, em seguida, clicar na opção . Assim, o evento só será acionado se forem atendidas as restrições definidas.



Página 18 de 40



5 T AREFAS A tarefa é um procedimento que será executado para realização das atividades definidas na mesma. Em sua maioria, as tarefas visam o envio de uma mensagem workflow. Na tarefa estão declarados o objeto, o evento, o método e outras informações necessárias para que a mesma execute as suas atividades. Assim, para se desenvolver uma tarefa de workflow é necessário que, no mínimo, existam um documento de modificação e um objeto associados ao evento acionador da mesma. 1) Tipos de Tarefas As tarefas podem ser classificadas da seguinte maneira: Quanto à composição (determinada pela primeira letra do tipo): T Simples W Múltiplas Quanto à origem (determinada pela segunda letra do tipo): S Standard F Cliente Assim, as tarefas são: T Simples TS Simples Standard WS Múltipla Standard (ou Modelo Workflow) WF Múltipla Cliente

A tarefa múltipla é um conjunto formado por tarefas simples de maneira semelhante a um fluxograma passando as informações de uma para outra. 2) Tarefas Simples Standard A tarefa simples standard pode ser criada acessando a transação SWEC (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / TAREFAS/GRUPOS DE TAREFAS / PFTC_INS – CRIAR).



Página 19 de 40



Selecione o tipo de tarefa, em seguida, clique no botão tarefa, preencha os campos da seguinte forma:



. Na tela de criação da

Página 20 de 40



Configuração na ABA DdsBásicos : Abrev.: nome reduzido da tarefa, deve ser iniciado com Z, pois se trata de

componente criado pelo cliente.

Denominação : descrição da tarefa. Texto de work item : título da mensagem do work item.

Caso deseje inserir variáveis no título da mensagem do work item, pode fazê-lo clicando no botão e selecionando as variáveis desejadas. Observe que as variáveis inseridas no texto aparecerão entre dois símbolos “&”. Status da liberação : status da tarefa, que pode ser liberada, implementada,

modelada, obsoleta ou não definida.

Categoria de objetos : será sempre “Tipo de objeto BOR”. Tipo de objeto : nome do objeto que será acionado ao executar a tarefa em questão. Método : nome do método que será acionado ao executar a tarefa em questão. Método de objeto síncrono : é automaticamente assinalado quando o método utilizado

é síncrono (retorna resultados ou parâmetros).

Método de objeto c/diálogo : é automaticamente assinalado quando o método

utilizado é do tipo diálogo.

Processamento em background : deve ser assinalado quando a tarefa não necessitar

de interação com o usuário para ser processada. Esta opção não poderá ser habilitada se o método utilizado for do tipo diálogo, pois este tipo de método exige interação com o usuário.

Confirmar fim do processamento : deve ser assinalado quando for necessário

confirmar o final da execução da tarefa, sendo assim, sempre que a tarefa for executada irá aparecer uma tela para o usuário confirmar ou não o término do processamento da mesma. Configuração na ABA Descrição : TipoTxt : tipo do texto, que pode ser: •

• •

•


Descrição de tarefas: texto que aparecerá quando executada a tarefa, ou seja, trata-se do corpo da mensagem do work item. Texto de conclusão: texto que aparecerá quando concluída a tarefa. Texto p/prazo: texto que aparecerá quando vencido o prazo estipulado para conclusão da tarefa. Texto fim desejado: texto que aparecerá quando a tarefa for finalizada de forma não desejada. Autor: Maximiliano Araujo Pedatella

Página 21 de 40



•

Texto de início tardio: texto que aparecerá quando a tarefa for iniciada após o prazo estipulado.

Caso deseje modificar o texto, selecione o tipo do mesmo e clique no botão

.

Configuração na ABA Container: O container é a relação das variáveis que podem ser utilizadas pela tarefa durante a sua execução. Assim, as variáveis podem ser: criadas, copiadas, renomeadas ou excluídas.

modificadas,

visualizadas,

Na ABA Ctg.dds., deve-se definir o tipo da variável que pode ser: um objeto (marcar ), um campo de tabela (marcar ) ou um objeto do dicionário de dados (marcar ). Elaborado em 11/12/2007


Página 22 de 40



Na ABA Caracts., deve-se definir se a variável é de: recebe valores externos da tarefa deve obrigatoriamente receber valores externos envia valores para fora da tarefa possui várias linhas, ou seja, funciona como uma tabela

Na ABA Valor inicial , pode-se definir um valor default para a variável.

Configuração na ABA Eventos acionadores: Define o(s) evento(s) que irá(ão) disparar a tarefa. Pode-se inserir um evento clicando no botão desejado.

e informando o objeto e o evento

Pode-se eliminar um evento selecionando o evento desejado e clicando no botão

.

Pode-se definir a troca de variáveis selecionando o evento desejado e clicando no botão . Pode-se ativar ou desativar o evento acionador clicando no botão . Quando estiver desativado, mesmo que o evento ocorra, a tarefa não será acionada. Configuração na ABA Eventos encerramento: Define o(s) evento(s) que será(ão) aguardado(s) para o encerramento da tarefa. Pode-se inserir um evento clicando no botão desejado.



.

Pode-se definir a troca de variáveis selecionando o evento desejado e clicando no botão .



Página 23 de 40



Deve-se definir o responsável pela execução da tarefa clicando no menu , em seguida, em , em seguida, em .

Deve-se defini-la como tarefa geral, pois poderá ser executada por qualquer usuário que for indicado à mesma.

3) Tarefas Múltiplas Standard A tarefa múltipla standard (ou modelo de workflow) pode ser criada acessando a transação SWEC (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE DEFINIÇÃO / TAREFAS/GRUPOS DE TAREFAS / PFTC_INS – CRIAR).



Página 24 de 40



Selecione o tipo de tarefa, em seguida, clique no botão workflow, preencha os campos da seguinte forma:



. Na tela de criação do

Página 25 de 40



Configuração na ABA DdsBásicos : Abrev.: nome reduzido do workflow, deve ser iniciado com Z, pois se trata de

componente criado pelo cliente.

Denominação : descrição do workflow. Texto de work item : título da mensagem do work item.

Caso deseje inserir variáveis no título da mensagem do work item, pode fazê-lo clicando no botão e selecionando as variáveis desejadas. Observe que as variáveis inseridas no texto aparecerão entre dois símbolos “&”. Status da liberação : status do workflow, que pode ser liberado, implementado,

modelado, obsoleto ou não definido. Configuração na ABA Descrição :

TipoTxt : tipo do texto, que pode ser: •

• •

•

•

Descrição de tarefas: texto que aparecerá quando executado o workflow, ou seja, trata-se do corpo da mensagem do work item. Texto de conclusão: texto que aparecerá quando concluído o workflow. Texto p/prazo: texto que aparecerá quando vencido o prazo estipulado para conclusão do workflow. Texto fim desejado: texto que aparecerá quando o workflow for finalizado de forma não desejada. Texto de início tardio: texto que aparecerá quando o workflow for iniciado após o prazo estipulado.

Caso deseje modificar o texto, selecione o tipo do mesmo e clique no botão

.

Configuração na ABA Container: O container é a relação das variáveis que podem ser utilizadas pelo workflow durante a sua execução. Assim, as variáveis podem ser: criadas, copiadas, renomeadas ou excluídas.


modificadas,


visualizadas,

Página 26 de 40



Na ABA Ctg.dds., deve-se definir o tipo da variável que pode ser: um objeto (marcar ), um campo de tabela (marcar ) ou um objeto do dicionário de dados (marcar ).

Na ABA Caracts., deve-se definir se a variável é de: recebe valores externos do workflow deve obrigatoriamente receber valores externos envia valores para fora do workflow possui várias linhas, ou seja, funciona como uma tabela

Na ABA Valor inicial , pode-se definir um valor default para a variável.



Página 27 de 40



Configuração na ABA Eventos acionadores: Define o(s) evento(s) que irá(ão) disparar o workflow. Pode-se inserir um evento clicando no botão desejado.



.

Pode-se definir a troca de variáveis selecionando o evento desejado e clicando no botão . Pode-se ativar ou desativar o evento acionador clicando no botão . Quando estiver desativado, mesmo que o evento ocorra, o workflow não será acionado.

Deve-se definir o responsável pela execução do workflow clicando no menu , em seguida, em , em seguida, em .

Deve-se defini-lo como tarefa geral, pois poderá ser executado por qualquer usuário que for indicado ao mesmo.



Página 28 de 40



3.1) Definição do Workflow Na ABA DdsBásicos , clique no botão fluxograma de execução do workflow.

para definir o

Pode-se inserir os seguintes tipos de etapas:



Página 29 de 40



Atividade: tarefa standard previamente criada. Atividade Web: tarefa que executa um documento XML. Enviar email: envio de email a um determinado endereço. Formulário: formulário para troca de informações. Decisão de usuário: tomada de decisão pelo usuário. Documento de modelo: gera um documento conforme modelo informado. Condição: verifica se determinada condição ocorreu ou não. Condição múltipla: verifica se ocorreu uma das condições configuradas. Gerador de evento: gera um evento. Espera por evento: aguarda geração de um evento. Operação de container: atribui valor a uma variável do container. Controle de processo: vai para uma etapa do processo de workflow. Loop (until): executa um laço até que uma condição seja verificada. Loop (while): executa um laço enquanto uma condição seja verdadeira. Seção paralela: executa duas ou mais etapas paralelamente.

Deve-se implementar o workflow utilizando as opções acima de acordo com a lógica de execução que se deseja que o mesmo realize, como, por exemplo:



Página 30 de 40



3.1.1) Atividade A atividade é a etapa mais comumente utilizada, pois é através dela que se faz a execução de uma tarefa standard criada para acionar um método de um objeto. Elaborado em 11/12/2007


Página 31 de 40



Configuração na ABA Controle: Tarefa : nome da tarefa standard que será executada. Impressão : responsável pela execução da tarefa quando a mesma for do tipo

diálogo.

Clicar no botão para configurar a troca de valores entre as variáveis do container do workflow e as variáveis do container da tarefa.



Página 32 de 40



Configuração na ABA Prazo: Data : data de vencimento do prazo para execução desta etapa do workflow. Hora : hora de vencimento do prazo para execução desta etapa do workflow. Impressão : responsável que receberá a mensagem indicando o excesso do prazo

para execução desta etapa do workflow.

Configuração na ABA Outros: Prioridade de etapa : prioridade de execução desta etapa do workflow. Elemento múltiplas linhas : variável do container na qual para cada um dos seus

valores será gerado um work item para processamento em paralelo. Elaborado em 11/12/2007


Página 33 de 40



6 FERRAMENTAS DE TESTES 1) Geração de Eventos Pode-se gerar um determinado evento de um objeto utilizando a transação SWUE (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / UTILITÁRIOS / EVENTOS / SWUE – GERAR EVENTO).

Informar o objeto no campo , o evento no campo , e a chave do objeto desejado (que, no exemplo, são os campos chaves do documento do DMS) clicando no botão . Em seguida, clique em

.

Caso queira ver os workflows e/ou tarefas que foram acionados com a geração deste evento, clique no botão . Caso queira ativar o rastreamento de evento para verificar que eventos estão sendo gerados no sistema, execute a transação SWELS (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / UTILITÁRIOS / EVENTOS / RASTREAMENTO DE EVENTOS / SWELS – ATIVAR/DESATIVAR RASTREAMENTO DE EVENTO), em seguida, clique no botão . Elaborado em 11/12/2007


Página 34 de 40



Caso queira exibir o log do rastreamento de evento, execute a transação SWEL (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / UTILITÁRIOS / EVENTOS / RASTREAMENTO DE EVENTOS / SWEL – EXIBIR RASTREAMENTO DE EVENTO), em seguida, clique no botão . Aparecerá a seguinte tela abaixo:

Caso queira administrar a fila de eventos do sistema, execute a transação SWEQADM (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / ADMINISTRAÇÃO / GERENCIADOR DE EVENTOS / SWEQADM – FILA DE EVENTO).

2) Teste de Workflow Pode-se testar um determinado workflow utilizando a transação SWUS (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / FERRAMENTAS DE TEMPO DE EXECUÇÃO / SWUS – TESTAR WORKFLOW).



Página 35 de 40



Informar o workflow no campo e as variáveis obrigatórias ( ) do container (que, no exemplo, é o objeto DRAW) clicando em cada uma delas e informando o respectivo valor. Em seguida, clique em

.

É recomendado que antes de executar o workflow seja clicado no botão para que todas as atualizações pendentes nos workflows e tarefas do sistema sejam efetivadas.

É recomendado que quando for efetuada qualquer atualização em um workflow e/ou tarefa seja executada a transação SWU_OBUF, em seguida, clicar no botão para que os buffers de workflow dos servidores sejam atualizados. Isto vale para quando uma atualização é transportada via request.



Página 36 de 40



Caso queira ver o log do workflow executado, clique no botão

.

Aparecerá a seguinte tela abaixo:



Página 37 de 40



7 LOG DE WORKFLOW Pode-se verificar o log de um workflow utilizando a transação SWI1 (MENU SAP / FERRAMENTAS / BUSINESS WORKFLOW / DESENVOLVIMENTO / UTILITÁRIOS / SWI1 – SELEÇÃO WORK ITEM).

Informar o workflow no campo e Em seguida, clique em

e os intervalos de data e hora nos campos , respectivamente.

.

Aparecerá a seguinte tela abaixo:



Página 38 de 40



Cada uma das linhas listadas corresponde a um workflow executado. Clicando-se duas vezes sobre uma delas, pode-se verificar o log detalhado.



Página 39 de 40

Treinamento Básico - Workflow - v00

Recommend Documents