Histórico da Página

Produto:

Datasul 12

Ocorrência:

O objetivo deste documento é especificar como deve ser feita a instalação de workflows para utilização junto ao Fluig.

Passo a passo:

Índice

Índice

Requisitos mínimos

TDS(TOTVS Developer Studio) ou Eclipse com plug-in Fluig instalado.

Arquivo .zip do workflow a ser instalado.

Passo 1: Configuração do Servidor do Fluig

Entrar no TDS;
No lado superior esquerdo, acessar a aba 'Fluig Servers';
Clicar com o direito sobre "Servers" e escolher o menu: Fluig > Fluig Server;

Image Modified

Informar os dados conforme abaixo:

Nome Servidor: Nome de sua escolha para o servidor de comunicação com o fluig. Ex: MinhaEmpresaProd.
Host: URL de acesso ao fluig. Ex: minhaempresa.fluig.com.
Porta: Número da porta de acesso ao fluig.
Usuário: Deve ser informado um usuário que seja admin do fluig.
Senha: Dever ser informada a senha do usuário admin.

Image Modified

Passo 2: Configuração do Dataset

Acessar no menu: Arquivo > Novo > Projeto Fluig, conforme abaixo:

Image Modified

Na janela que será apresentada, informar o campo abaixo:

Nome do Projeto: Deve ser informado o nome do Dataset que será utilizado. Ex: DatasetMinhaEmpresa.

Image Modified

Após criação do projeto, clicar com o direito sobre projeto e escolher o menu: New > Dataset Customizado Fluig.

Image Modified

Na janela que será apresentada, informar o campo abaixo:

Código do Projeto: Deve ser informado o nome do Dataset que será utilizado;
Para o produto Datasul deve ser criado o Dataset DatasulServerDS;
Para o produto Logix devem ser criados dois Datasets, LogixServerDS e LogixExecServiceDS conforme FAQ:
http://tdn.totvs.com/pages/releaseview.action?pageId=108659933.
Descrição do Projeto: Deve ser a mesma informação inserida no campo de código.

Image Modified

Após criação do Dataset, efetuar duplo clique sob o Dataset e inserir o conteúdo a baixo:

Bloco de código

title	DatasulServerDS.js

function createDataset(fields, constraints, sortFields) {
    var newDataset = DatasetBuilder.newDataset();
    // Cria as colunas
    newDataset.addColumn("server");
    newDataset.addColumn("port");
	newDataset.addColumn("email_usuario_integracao");
    
    // Cria os registros
    newDataset.addRow(new Array('server', 'port', 'email'));
    return newDataset;
}

Deverá ser alterado apenas os campos 'server' e 'port';

Supondo que a url de acesso ao Datasul seja http://totvs:8080/datasul, deverá ser informado: newDataset.addRow(new Array('totvs', '8080','[email protected]''));

Image Removed

Image Added

Para exportar o Dataset, clicar com o direito em cima do arquivo e escolher a opção “Exportar...” conforme abaixo:

Image Removed

Image Added

Na janela que irá ser apresentada, informar os dados conforme abaixo:

Servidor: Código do servidor fluig criado no Passo 1. Ex: MinhaEmpresaProd.
Selecionar a opção "Novo Dataset".
Dataset: Deve ser o código do Dataset(será sugerido).
Descrição: Deve ser a descrição do Dataset (será sugerido).
Clicar no botão “Finish”.

Image Modified

Passo 2: Pasta de formulários no fluig

Todo Workflow possui um Formulário (onde são digitadas as informações);
Todo Formulário é considerando um Documento dentro do Fluig;
Todo documento deve estar dentro um uma Pasta;
Portanto, deve ser verificado para que Pasta será exportado o Formulário;
Para isto, acessado o Ambiente do Fluig utilizado;
Acessar a área “Documentos”, localizada na barra lateral do Fluig;
Deverá ser apresentada uma tela conforme abaixo:

Image Modified

Conforme a Linha de Produto, verificar a pasta e memorizar o código, por exemplo, para Formulários Datasul o código da Pasta é 11, para Logix é 32.

Importante: Este é apenas um exemplo, deve ser verificado o código de acordo com o ambiente utilizado.

Passo 3: Instalando o Workflow

Acessar o TDS.

Acessar no menu: Arquivo > Novo > Projeto Fluig, conforme abaixo:

Image Modified

Na janela que será apresentada, informar o campo abaixo:

Nome do Projeto: Deve ser informado o código do workflow. Ex: wfutbcadfor.

Image Modified

Após criação do projeto, clicar com o direito sobre projeto e escolher o menu: Import.

Image Modified

Na janela que irá ser apresentada, escolher as opções General > Archive File > Next >.

Image Modified

Na janela apresentada informar o diretório e .zip do workflow a ser instalado e Next.

Image Modified

Passo 4: Exportando o Workflow

Exportando Mecanismos de Atribuição

Alguns workflow possuem Mecanismo de Atribuição, se ele possuir, deve ser exportado para o Fluig;
Para verificar se o workflow possui Mecanismos de Atribuição, abra a pasta do projeto e a Sub-Pasta “mechanisms”, se existir algum arquivo “.js”, ele deve ser exportado;
Para exportar o Mecanismo e Atribuição, clicar com o direito em cima do arquivo e escolher a opção “Exportar...” conforme abaixo:

Image Modified

Na janela que irá ser apresentada, escolher as opções Fluig > Exportar para Servidor Fluig > Next >.

Image Modified

Na janela que irá ser apresentada, informar os dados conforme abaixo:

Servidor: Código do servidor fluig criado no Passo 1. Ex: MinhaEmpresaProd.
Selecionar a opção "Novo Mecânismo".
Código: Deve ser o código do Mecanismo (será sugerido).
Nome: Deve ser o nome do Mecanismo (será sugerido).
Descrição: Deve ser a descrição do Mecanismo (será sugerido).
Clicar no botão “Finish”.

Image Modified

Importante: Este processo deve ser repetido para todos os arquivos “.js” que existirem na Sub-Pasta “mechanisms”;

Exportando Formulário

Todo workflow possui um formulário principal;
Este formulário pode ser encontrado na Sub-Pasta “forms\<Código do Projeto>”;
O Formulário principal será aquele que tem o mesmo nome do Projeto e termina com “.html”;
Para exporta-lo deve-se clicar com o direto em cima dele e escolher a opção “Exportar...”;

Image Modified

Na janela que irá ser apresentada, escolher as opções Fluig > Exportar para Servidor Fluig > Next >.

Image Modified

Na janela que irá ser apresentada, informar os dados conforme abaixo:

Servidor: Código do servidor fluig criado no Passo 1. Ex: MinhaEmpresaProd.
Selecionar a opção "Novo formulário".
Formulário: Deve ser o código do formulário (será sugerido).
Nome Dataset: Deve ser o código do Dataset (será sugerido).
Pasta Destino: Informar o código da Pasta de Formulários do Fuig, conforme verificado no Passo 2.
As demais informações não precisam ser alteradas;
Clicar no botão “Next >”.

Image Modified

Será apresentada a Janela abaixo, com os eventos do Formulário;
Selecionar todos os itens que forem apresentados (a quantidade varia conforme cada workflow);
Após selecionados os eventos, clicar em "Finish".

Image Modified

Configurando o Formulário do Processo

No processo do workflow é configurado o Servidor do Fluig e o Formulário que foi exportado;
Quando realizado o desenvolvimento do workflow, este foi configurado com Servidor e Formulário no Processo;
Como as informações internas Totvs são diferentes de servidores de clientes, estas informações devem ser configuradas novamente;
Para isto, deve ser aberto o Processo do workflow, ele se encontra na Sub-Pasta “workflow\diagrams\<Código do Projeto>.process”, conforme exemplo abaixo;
Para abrir, basta dar dois clicks em cima do processo;

Obs: Se apresentar uma mensagem perguntado se quer trabalhar “Off-line”, responder “Sim”;

Image Modified

Primeiramente deve ser alterado o Servidor do Fluig;

Após a abertura do Processo, deve ser clicado na parte “branco” (Seta 1);
Clicar na Aba “Propriedades” (Seta 2);
Clicar na Sub-Aba “Geral” (Seta 3);
No campo “Servidor” escolher o servidor Fluig criado no Passo 1(Seta 4);
Clicar no botão de “Refesh” do servidor (Seta 5);

Image Modified

Na tela seguinte deverá ser informado o formulário do processo;
Para isto deve-se, selecionar a Sub-Aba “Formulário” (Seta 1);
No campo “Definição de Formulário” escolher “Servidor” (Seta 2);
Escolher o formulário, que terá o mesmo código que foi informado foi verificado no Passo 2(Seta 3); Obs: Se existir mais de um com o mesmo código, escolher o último.

Image Modified

Depois disto, deve salvar a alteração do Processo, clicando no botão “Salvar” na barra superior de botões.

Exportando o Processo do Workflow

Para exportar o Processo do Formulário, basta clicar com o direito em cima do arquivo do processo e escolher a opção “Exportar...” conforme exemplo abaixo:

Image Modified

Na janela que irá ser apresentada, escolher as opções Fluig > Exportar para Servidor Fluig > Next >.

Image Modified

Na janela que irá ser apresentada, informar os dados conforme abaixo:

Servidor: Código do servidor fluig criado no Passo 1. Ex: MinhaEmpresaProd.
Selecionar a opção "Novo Processo".
Processo: Deve ser o nome do processo (será sugerido).
Selecionar a opção "Liberar Versão".
Clicar no botão “Next >”.

Image Modified

Consultando o Workflow

O WorkFlow, deverá aparecer abaixo da Categoria informada no processo;
Conforme exemplos abaixo, no TDS (Primeira Imagem) e no Fluig (Segunda Imagem):

Image Modified

Atualizando o Workflow (Novas Versões)

Atualizando Workflow

Acessar a Pasta que representa a área de trabalho do TDS;
Clicar com o direito sob a Sub-Pasta que tenha o nome igual ao Código do WorkFlow e escolher o menu: Import;
Realizar a importação do workflow, conforme Passo 3;
Será apresentada mensagem questionando a confirmação para sobrepor os arquivos, clicar em "Sim para todos";
Clicar com o direito sob a Sub-Pasta que tenha o nome igual ao Código do WorkFlow e escolher o menu: "Atualizar";