Projeto FS007841 – Customizações BackOffice – Parte 2
SENAI Pernambuco
21/05/2018MANUAL OPERACIONAL DA CUSTOMIZAÇÃO Sumário
1.1 Objetivo Desse Documento
1.2 Síntese
1.3 Instalando a Customização
1.4 Execução de Scripts
1.5 Executando o Instalador de Arquivos
1.6 Permissão de Acesso a Telas
1.6.1 Verificando o Perfil do Usuário
1.6.2 Liberando Acesso aos Menus
1.7 Observações Importantes
1.8 Requisitos
1.8.1 Processo customizado para lançar valores de Retificação e Suplementação no Orçamento
1.8.1.1 Pré-Requisitos / Parametrizações
1.8.1.2 Descrição do Processo
1.8.2 Req. 02 – Interface customizada para consulta dos valores orçados
1.8.2.1 Pré-Requisitos / Parametrizações
1.8.2.2 Descrição do Processo
1.8.3 Req. 03 – Anexo customizado no cadastro de Filial
1.8.3.1 Pré-Requisitos / Parametrizações
1.8.3.2 Descrição do Processo
1.8.4 Req. 04 – Anexo customizado no cadastro de Departamento
1.8.4.1 Pré-Requisitos / Parametrizações
1.8.4.2 Descrição do Processo
1.8.5 Req. 05 – Processo customizado de transferência de bens
1.8.5.1 Pré-Requisitos / Parametrizações
1.8.5.2 Descrição do Processo
1.8.6 Req. 06 – Interface customizada de aprovação de transferência de bens
1.8.6.1 Pré-Requisitos / Parametrizações
1.8.6.2 Descrição do Processo
1.8.7 Req. 07 – Alteração no processo "Integrar aquisição de compras" para solicitar código inicial dos patrimônios
1.8.7.1 Pré-Requisitos / Parametrizações
1.8.7.2 Descrição do Processo
1.8.8 Req. 08 – Alteração no processo "Alocação de patrimônios" para solicitar "Data de devolução"
1.8.8.1 Pré-Requisitos / Parametrizações
1.8.8.2 Descrição do Processo
1.9 Histórico de Atualização do Documento
1.9.1 Histórico de Versões

Objetivo Desse Documento

Prezados Senhores,
O documento a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito no documento "Especificação de Customização - Proposta nº FS007841".

Síntese

O objetivo deste projeto é detalhar a solução para atender as necessidades específicas do cliente em seus processos do BackOffice TOTVS RM.
Este documento visa descrever de forma detalhada a solução implementada pela TOTVS.

Instalando a Customização

Ambiente necessário
Sistema Operacional: Windows Server
Banco de Dados: SQL Server
Versão do TOTVS RM: TOTVS RM 12.1.20+

Execução de Scripts

Executar o script 'Totvs_Custom_Register_Action.sql';
Executar o script 'Totvs_Custom_Consolidated_All_SqlServer.sql'.

Executando o Instalador de Arquivos

O instalador é gerado com o nome "TOTVS Customização – CNI DR Pernambuco – 12.1.20.XX" e esse copiará todos os arquivos referentes a customização para a máquina do usuário. O instalador de arquivos deverá ser executado em todas as máquinas que utilizarão a Customização.

Figura – Instalador Passo 1

Figura – Instalador Passo 2

Figura – Instalador Passo 3

Figura – Instalador Passo 4




Após a instalação o usuário poderá consistir os arquivos correspondentes a customização.

Importante!
Conforme descrito na especificação, ressaltamos que plugins e dlls desenvolvidos para a versão acima podem apresentar algum tipo de incompatibilidade nas próximas versões oficiais, precisando assim serem recompilados(as). Portanto, qualquer mudança de versão deve ser previamente comunicada à TOTVS. A forma dessa comunicação é a seguinte:

• Abertura de uma ocorrência junto ao suporte (suporte.totvs.com) com no mínimo 15 dias de antecedência da data marcada para conversão, solicitando ao departamento de customização a conversão do plugin.
• Após recebimento do mesmo executar a validação de suas funcionalidades em um ambiente de testes da nova versão.
  Observações Finais
  No Painel de Controle, a instalação é gerada conforme abaixo (Figura). Os nomes dos pacotes ficam respectivamente "TOTVS Customização – CNI DR Pernambuco – 12.1.20.XX".
  
  Figura – Conclusão
  

  Permissão de Acesso a Telas

  1.6.1 Verificando o Perfil do Usuário

1. O usuário deve acessar o RM.exe em C:\totvs\CorporeRM\RM.Net
2. Acessar TOTVS Serviços Globais | Segurança | Usuário;
3. No campo (Sistema: ) selecione o produto correto;
4. Busque pelo usuário desejado e clique em editar;
5. Navegue até a aba Segurança;
6. Verifique qual é o perfil do usuário (Como mostra na imagem exemplo abaixo o perfil é DBA);

Figura – Permissão - Passo 1

Figura – Permissão - Passo 2

1.6.2 Liberando Acesso aos Menus

1. TOTVS Serviços Globais | Segurança | Perfis;
2. No campo (Sistema: ) selecione o produto correto;
3. Busque pelo perfil desejado e clique em editar (como no exemplo acima o perfil será DBA);
4. Navegue até a aba Acesso a Menus;
5. Procure pelas customizações e selecione as desejadas;
6. Clique em Permitir Acesso e depois em Ok.

Figura – Liberando Acesso

Observações Importantes

Para o correto funcionamento do Novo Gerenciador de Jobs algumas configurações devem ser observadas. Dentro da pasta "X:\totvs\CorporeRM\RM.Net" cinco arquivos precisam ser verificados. São eles:

• RM.Host.exe.config
• RM.Host.Service.exe.config
• RM.exe.config
• Alias.dat
• RM.Host.JobRunner.exe.config  (SOMENTE SERVIDORES JOB)
  RM.exe.config:
  Dentro de cada arquivo existe a tag <add key="JobServer3Camadas" value="true" />. Certifique-se que em todos os arquivos as tags estão com o value igual a true.
  Se os aplicativos RM ainda estiverem sendo utilizados, dentro do diretório de cada um deles (X:\totvs\CorporeRM\RMNucleus, X:\totvs\CorporeRM\RMVitae, etc.) os arquivos de configuração também deverão ser verificados. Exemplo do aplicativo RMVitae:
• RMVitae.exe.config – Averiguar se a tag está com o value igual a true.
  RM.Host.exe.config ou/e RM.Host.Service.exe.config:
  Dentro de cada arquivo existe a tag <add key="JobServer3Camadas" value="true" />. Certifique-se que em todos os arquivos as tags estão com o value igual a true.
  Adicionar: <add key="IsolateProcess" value="true" />
  Adicionar: <add key="EnableProcessIsolation" value="true" />
  Alias.dat:
  Servidores de (Servidores de Job e APP) para que as customizações sejam carregadas:
  <RunService>true</RunService>
  RM.Host.JobRunner.exe.config  (SOMENTE SERVIDORES JOB):
  Para carregar os plug-ins de processos customizados:
  <add key="LoadCustomSlave" value="true" />
  
  
  
  
  
  
  
  
  
  
  

  Requisitos

  1.8.1 Processo customizado para lançar valores de Retificação e Suplementação no Orçamento

  1.8.1.1 Pré-Requisitos / Parametrizações

  
  Não se aplica.

  1.8.1.2 Descrição do Processo

  
  Foi desenvolvida uma interface customizada para lançamento de valores de Retificação e Suplementação no Orçamento. A tela fica localizada no TOTVS Gestão de Estoque, compras e faturamento, menu Customização – Cadastro de Valores Orçados, conforme imagem abaixo:
  
  O usuário irá visualizar todos os orçamentos cadastrados, e poderá incluir, editar ou excluir os registros:
  
  Ao incluir um novo registro, o usuário deverá inserir o Período, Natureza do Orçamento e Centro de Custo. Serão carregados na grid todos os Itens do Período de orçamento.
  Apenas o campo Orçado estará disponível para edição do valor:
  
  Após inserir o valor Orçado, o mesmo será bloqueado e o usuário poderá inserir apenas Retificação ou Suplementação, porém, não poderá incluir ambos os campos simultaneamente:
  
  Após a inclusão da retificação ou suplementação, os campos serão limpos e o valor inserido irá substituir o atual valor do Orçado. Ao salvar o registro, a customização irá atualizar os valores nas tabelas nativas do produto.
  Na tela de Consulta de Valores Orçados (Requisito 2) o usuário conseguirá visualizar a composição do valor Orçado, consultando detalhadamente quais foram os valores inseridos no campo Retificação e Suplementação.
  Obs.: Todas as regras do produto serão respeitadas na inclusão, alteração ou exclusão dos orçamentos.
  

  1.8.2 Req. 02 – Interface customizada para consulta dos valores orçados

  1.8.2.1 Pré-Requisitos / Parametrizações

  
  Não se aplica.

  1.8.2.2 Descrição do Processo

  Foi desenvolvida uma tela customizada "Consulta de valores de orçamento" disponível em TOTVS Gestão de Estoque, Compras e Faturamento | Customização.
  
  A partir dessa tela o usuário poderá consultar o detalhamento de todos os Orçamentos realizados pela tela customizada "Cadastro de Valores Orçados" (Requisito 01). Ao acessá-la, o usuário irá visualizar duas Abas principais, "Dados da Consulta" e "Consulta". A partir da primeira, o usuário terá opções de realizar filtros pelas sub-abas Centro de Custo, Período e Natureza exatamente como funciona na tela nativa "Consulta de valores do orçamento" disponível em TOTVS Gestão de Estoque, Compras e Faturamento | Orçamento.
  
  Após o preenchimento dos filtros, a Aba "Consulta" irá exibir todos os Orçamentos encontrados e irá lista-los em uma grid com todas as informações disponíveis. Ao clicar em uma das seguintes colunas, uma janela será exibida informando o detalhamento do somatório realizado:

• Orçado
• Retificado
• Suplementado
• Transposto Positivo
• Transposto Negativo
• Excedente
• Realizado

Exemplo do detalhamento da coluna Retificado:

1.8.3 Req. 03 – Anexo customizado no cadastro de Filial

1.8.3.1 Pré-Requisitos / Parametrizações

Não se aplica.

1.8.3.2 Descrição do Processo

Foi desenvolvido um anexo customizado "Dados Patrimoniais", disponível no cadastro de Filial, em TOTVS Gestão Patrimonial | Cadastros | Filiais | Anexos. Através dela, o usuário irá preencher informações relativas aos processos customizados do produto de Gestão Patrimonial. Os seguintes campos compõem a tela customizada:

• Responsável Geral: o usuário irá informar um funcionário que será o responsável geral pela aprovação das Transferências de Bens (Requisito 05).
• Valor máximo de aquisição para aprovação simples: o usuário irá definir qual o valor máximo de aquisição de um item de uma transferência para que a transferência seja submetida apenas à uma aprovação simples.
• Código da Filial para geração de patrimônio: Usuário deverá digitar o código da Filial que será utilizado como prefixo para geração do campo IPATRIMONIO.PATRIMONIO (Plaqueta) no processo detalhado no Req. 05. O valor deste campo não poderá se repetir em nenhuma outra Filial.
• Sequencial da Filial: Campo não habilitado para edição que demonstrará o sequencial controlado por Filial necessário para geração dos campos PATRIMONIO e CODPATRIMONIO no Req. 05. Este sequencial iniciará em 0. Cada inclusão de patrimônio pela rotina do Req. 05 incrementará em 1 este campo.
• Prefixos: Exibe todos os prefixos já utilizados para aquela filial.

1.8.4 Req. 04 – Anexo customizado no cadastro de Departamento

1.8.4.1 Pré-Requisitos / Parametrizações

Não se aplica.

1.8.4.2 Descrição do Processo

Foi desenvolvido um anexo customizado "Responsável do Departamento" no cadastro de Departamento. Esta tela estará disponível em TOTVS Gestão Patrimonial | Cadastros | Departamento | Anexos.


O objetivo desta tela é informar um funcionário que será o Responsável pela aprovação das transferências de bens customizados (Requisito 05), quando o Departamento for o item de maior hierarquia para aprovação.

1.8.5 Req. 05 – Processo customizado de transferência de bens

1.8.5.1 Pré-Requisitos / Parametrizações

Preencher os anexos customizados de Filial e Departamento, descritos no Req. 03 e Req.04.

1.8.5.2 Descrição do Processo

Foi desenvolvido um processo customizado para realizar a transferência de bens. Esta tela está disponível em TOTVS Gestão Patrimonial | Customização | Transferência de bens.

Na primeira etapa do processo ("Seleção de Patrimônios"), o usuário deverá escolher quais patrimônios serão transferidos. Os registros selecionados são listados na grid.



Na segunda etapa, o usuário definirá o "Local para Transferência". Campos disponíveis:

• Filial (Obrigatório)
• Departamento (Obrigatório)
• Centro de Custo
• Localidade
• Responsável

Na etapa seguinte, "Dados para Transferência", o usuário deverá preencher os seguintes campos:

• Data de transferência: A marcação do parâmetro "Permitir a transferência de controle posterior ao período de cálculo atual" definirá se será possível ou não utilizar uma data futura à data parametrizada em TOTVS Gestão Patrimonial | Ambiente | Parâmetros | Gestão do Patrimônio | Cadastro de bens | Cálculos do Patrimônio | Período de cálculo.
• Transferir patrimônios agregados: As transferências destes patrimônios estão sob as mesmas regras descritas na primeira etapa do processo (Seleção de Patrimônios).
• Contabilizar transferência.
• Documento.
• Observação.

Neste momento, o usuário poderá executar o processo. A customização irá armazenar os dados da requisição em tabela customizada, e só irá efetivar a transferência após o processo de Aprovação ter sido concluído (Requisito 06).
Após a gravação dos dados da transferência nas tabelas citadas, caso o valor de aquisição de nenhum dos itens envolvidos na transferência superar o valor definido no campo "Valor máximo de aquisição para aprovação simples" da Filial do contexto, a customização enviará um e-mail para o funcionário Responsável de destino do maior nível selecionado no processo.
Exemplo:

• Transferência que envolve Departamento e Centro de Custo. O e-mail será enviado para o Responsável do Departamento.

Caso o valor de aquisição de algum dos itens envolvidos na transferência superar o valor definido no campo "Valor máximo de aquisição para aprovação simples" da Filial do contexto, a customização enviará um e-mail somente para o funcionário registrado no campo "Responsável geral" da Filial do contexto de execução do processo. Após o Responsável Geral aprovar a transferência, um e-mail será enviado então para o Responsável Específico, utilizando a mesma regra de hierarquia descrita acima, para que ele possa concluir o processo (Requisito 06).

1.8.6 Req. 06 – Interface customizada de aprovação de transferência de bens

1.8.6.1 Pré-Requisitos / Parametrizações

Preencher os anexos customizados de Filial e Departamento, descritos no Req. 03 e Req.04.

1.8.6.2 Descrição do Processo

Foi desenvolvido uma interface customizada para que o usuário possa visualizar todas as transferências realizadas e decidir se aprova ou não. Esta tela está disponível em TOTVS Gestão Patrimonial | Customização | Consulta de Transferências.

Ao acessar a interface, o usuário irá visualizar todas as transferências em que ele seja o Requisitante ou Responsável pela aprovação. O usuário Requisitante terá a opção de excluir a transferência ou alguns de seus patrimônios se a requisição ainda estiver com status Pendente. A inclusão ou alteração não estão disponíveis por meio dessa interface.



Para realizar a aprovação, o responsável deverá selecionar a transferência e executar o processo "Aprovar/Reprovar Transferência". Uma tela com uma grid será exibida, e o usuário deverá incluir todos os patrimônios que serão aprovados. Ao executar o processo, aqueles não escolhidos serão marcados como reprovados. Se a aprovação for composta, após o Responsável geral executar o processo, um e-mail será enviado para o Responsável específico para finalizar a rotina de aprovação.

Após o Responsável específico rodar o processo de aprovação, e pelo menos um patrimônio tiver sido aprovado, a rotina nativa de Transferência será acionada (TOTVS Gestão Patrimonial (TOTVS Gestão Patrimonial | Operações patrimoniais | Transferência de controle | Transferência de controle) e o processo nativo será executado. Neste instante será possível visualizar os dados da Transferência pela tela padrão do sistema: TOTVS Gestão Patrimonial | Operações patrimoniais | Transferência de Controle | Consulta.

1.8.7 Req. 07 – Alteração no processo "Integrar aquisição de compras" para solicitar código inicial dos patrimônios

1.8.7.1 Pré-Requisitos / Parametrizações

Não se aplica.

1.8.7.2 Descrição do Processo

O objetivo deste requisito é detalhar a interferência customizada que será realizada no processo "Integrar aquisição de compras" disponível em TOTVS Gestão Patrimonial | Relatórios / Integrações | Integrar aquisição de compras.

Na primeira etapa do processo (Opções de seleção), assim que o usuário clicar no botão Avançar, será validado a seleção de Filiais. Só será permitido avançar de etapa se o usuário selecionar uma única filial. Não é permitido não selecionar nenhuma ou selecionar mais de uma.

A segunda intervenção será realizada ao finalizar a execução do processo, em que o código da Plaqueta será gerado pela customização, utilizando a seguinte regra:

• Plaqueta (IPATRIMONIO.PATRIMONIO):

A máscara deste código deve ser: ####### - Onde os dois primeiros dígitos correspondem ao informado no campo "Código da Filial para geração de patrimônio" do anexo customizado "Dados patrimoniais" da Filial. Os últimos 5 números são gerados via sequencial, e completados com 0 a esquerda caso não totalizem 4 caracteres.

• Bem (IPATRIMONIO.CODPATRIMONIO):

O campo será gerado sequencialmente com as regras específicas do produto Padrão.

1.8.8 Req. 08 – Alteração no processo "Alocação de patrimônios" para solicitar "Data de devolução"

1.8.8.1 Pré-Requisitos / Parametrizações

Não se aplica.

1.8.8.2 Descrição do Processo

O objetivo deste requisito é detalhar a interferência customizada que será realizada no processo "Alocação de patrimônio" disponível em TOTVS Gestão Patrimonial | Cadastros | Patrimônio | Processos.

Na etapa "Informação de dados para a alocação" será disponibilizado um campo customizado "Data de devolução" para que o usuário preencha. Este campo é de preenchimento obrigatório e somente será possível avançar desta etapa ao preenchê-lo. Caso seja selecionada uma data menor que a data atual, será emitida a mensagem: "Não é permitido selecionar uma data inferior à data atual".


Ao finalizar o processo, o valor informado no campo "Data de Devolução" será salvo em tabela customizada (ZALOCACAO).
Observações:

• • A "Data de devolução" não será visualizada na interface nativa de "Consulta de alocação". Para visualizá-la o cliente deverá desenvolver relatórios com essa informação.
  • A "Data de devolução" é solicitada para os tipos de alocação "Interna" ou "Externa" e NÃO deve ser solicitada para o tipo de alocação "Retorna para controle atual".

Histórico de Atualização do Documento

Histórico de Versões