Regra de NegócioPara extrair os dados do Microsiga Protheus® e criar toda a estrutura para a geração de informações gerenciais na Área Distribuição e Logística, para assunto são extraídos os dados e gerados no Fluig Smart Data e por meio de regras, em um Banco de Dados. Todas as funções são executadas pelo BIEXTRACTOR agendado pelo Schedule. Legenda | Fase 1 | Informações direcionadas ao segmento Manufatura/Back Office | Fase 2 | Novos itens do segmento Manufatura/Back Office, importantes para as linhas de produto compatibilizarem as informações do TOTVS BA com seus respectivos ERPs. | Fase 4 | Novo itens para atender o Mercado Internacional. |
HOQ Cumprimento de Contrato de Alocação de Recurso Apresenta informações referente ao cumprimento de contrato nos postos quanto aos recursos (humanos, materiais e de equipamentos) contratados e o alocado dia-a-dia. As tabelas de dimensões envolvidas para a análise das medidas de Cumprimento de Contrato de Alocação de Recurso são: Dimensões | Tabela Física | Fase | Empresa | HJ4 | 1 | Estabelecimento | HKK | 1 | Posto | HOI | 5 | Contrato | HOJ | 5 | Situação do Contrato | HOL | 5 | Tipo Contrato | HON | 5 | Status do Posto | HOO | 5 | Tipo de Recurso da Prestação de Serviço | HOP | 5 | Moeda | HJ6 | 1 | Cliente | HJ7 | 1 | Item | HJ8 | 1 | Unidade de Medida do Item | HHW | 4 | Turno | HJU | 1 | Cargo | HJP | 1 |
Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de Serviços, dimensões da fase 1 ou dimensões da fase 4 (flavour) do TOTVS BA. Indicadores: Cumprimento de Contrato | Fluxo Principal de Origem: Contrato (CN9) | Lookup de Dimensões | Origem | Fase | Empresa ( HOQ_EMPRES ) | FWGrpCompany() +FWCompany() | 1 | Estabelecimento ( HOQ_ESTABL ) | FWFilial() | 1 | Posto ( HOQ_POSTO ) | TFL_LOCAL a partir de TFJ_CODIGO utilizando índice 2 e de CN9_NUMERO + CN9_REVISA utilizando índice 5 | 5 | Contrato (HOQ_CONTRA) | CN9_NUMERO + CN9_REVISA | 5 | Situação do Contrato (HOQ_SITCON) | CN9_SITUAC | 5 | Tipo Contrato (HOQ_TPCONT) | CN9_TPCTO | 5 | Status do Posto ( HOQ_STTPOS ) | Atribuição a partir da regra especificada | 5 | Tipo de Recurso da Prestação de Serviço ( HOQ_TIPREC ) | Atribuição a partir da regra especificada | 5 | Moeda ( HOQ_MOEDA ) | Atribuída através da função BIXGetMoeFato, considerando parâmetro do Wizard. | 1 | Cliente ( HOQ_CLIENT ) | TFJ_CODENT + TFJ_LOJA a partir de CN9_NUMERO+CN9_REVISA utilizando índice 5 | 1 | Item ( HOQ_ITEM ) | Subfluxos: TFG_PRODUT / TFI_PRODUT / TFF_PRODUT | 1 | Unidade de Medida do Item ( HOQ_UNITEM ) | Subfluxos: TFG_UM / Ausente / TFF_UM | 4 | Turno ( HOQ_TURNO ) | Subfluxos: Ausente / Ausente / TFF_TURNO | 1 | Cargo ( HOQ_CARGO ) | Subfluxos: Ausente /Ausente / TFF_FUNCAO | 1 | Indicadores | Origem | Fase | Data da Cobertura ( HOQ_DATA ) | Data de cobertura analisada a partir do período de-até indicado para extração. | 5 | Saldo do Contrato ( HOQ_SLDCON ) | CN9_SALDO. Convertido com base na CN9_MOEDA e a data da cobertura. | 5 | Quantidade Contratada ( HOQ_QTDCON ) | Subfluxos: TFG_QTDVEN / TFI_QTDVEN / TFF_QTDVEN | 5 | Quantidade Alocada ( HOQ_QTDALO ) | Atribuição a partir da regra especificada | 5 | Quantidade ( HOQ_QITCON ) | Valor fixo 1 | 5 |
O fluxo principal de dados considera as informações dos contratos de prestação de serviços com orçamento de serviço ativo (TFJ_STATUS = 1, partir de CN9_NUMERO + CN9_REVISA utilizando índice 5). Os contratos podem ter tipos de serviços diferentes, correspondendo a três subfluxos: Materiais de Implantação (TFG), Locação de Equipamentos (TFI) e Recursos Humanos (TFF), gerando para cada dia pertencente ao range de datas indicado pelo usuário para a extração, um registro na tabela fato (para cada subfluxo). A Data da Agenda será o parâmetro chave para determinar as demais informações da tabela fato. O mapeamento das informações referente aos subfluxos da tabela acima apresenta os campos correspondentes separados por “/”, na ordem de identificação dos subfluxos. O vínculo entre o fluxo principal de dados e os subfluxos é realizado da seguinte forma: - Materiais de Implantação (TFG): a partir de TFF_COD utilizando índice 3, a partir de TFL_CODIGO utilizando índice 3, a partir de TFJ_CODIGO utilizando índice 2 e partir de CN9_NUMERO+CN9_REVISA utilizando índice 5.
- Locação de Equipamentos (TFI): a partir de TFL_CODIGO utilizando índice 3, a partir de TFJ_CODIGO utilizando índice 2 e partir de CN9_NUMERO+CN9_REVISA utilizando índice 5. Considerar somente itens de locação de equipamentos com motivo de cobrança do tipo Disponibilidade (TEV_MODCOB = 2, a partir de TFI_COD utilizando índice 2).
- Recursos Humanos (TFF): a partir de TFL_CODIGO utilizando índice 3, a partir de TFJ_CODIGO utilizando índice 2 e partir de CN9_NUMERO+CN9_REVISA utilizando índice 5.
Regras especificadas: O preenchimento do campo de dimensão Tipo do Recurso de Prestação De Serviço é determinado de acordo com o subfluxo de dados considerado para o registro. Quando o subfluxo tratado for o de Material de Implantação (TFG) o valor do campo será 03. Quando o subfluxo tratado for o de Locação de Equipamentos (TFI) o valor do campo será 02. E quando o subfluxo tratado for o de Recursos Humanos (TFF) o valor do campo será 01. O preenchimento do campo de dimensão Status do Posto é realizado a partir da verificação dos campo Quantidade Contratada e Quantidade Alocada, independente do subfluxo tratado. - Quando a Quantidade Contratada for igual a Quantidade Alocada, o valor do campo será 01 (Posto Coberto).
- Quando a Quantidade Contratada for maior que a Quantidade Alocada, o valor do campo será 02 (Posto Descoberto).
- Quando a Quantidade Contratada for menor que a Quantidade Alocada, o valor do campo será 03 (Posto Excedido).
- Para o subfluxo de Recursos Humanos (TFF), o campo de dimensão Status do Posto pode assumir o valor 04 (Dia de Serviço não Contratado) quando a função TxDiaTrab(Data da Agenda, Turno, Sequencia) retornar falso, indicando que a data não é um dia em que deveria ter atendentes alocados para o posto. A função TxDiaTrab é detalhada na sessão “Funções Externas” deste documento.
A Quantidade Alocada é determinada de acordo com o subfluxo tratado: - Para Materiais de Implantação (TFG): somatório de todos TFS_QUANT a partir de TFG_COD relacionado com TFS_CODTFG até a data da agenda analisada. Este cálculo indica quantos materiais foram enviados ao posto até a análise da agenda, pois cada TFS indica um procedimento de envio.
- Locação de Equipamentos (TFI): contagem de todos os registros retornados de TEW a partir de TFI_COD utilizando índice 7, desde que a data da agenda encontre-se entre TEW_DTRINI e a Data Final da Alocação do Equipamento. Para determinar a Data Final da Alocação do Equipamento deve-se seguir a seguinte regra: Caso TEW_DTAMNT esteja preenchida, esta é a Data Final de Alocação do Equipamento. Caso TEW_DTAMNT não esteja preenchida mas TEW_DTRFIM esteja preenchida, TEW_DTRFIM será a Data Final de Alocação do Equipamento. Caso nenhuma destas datas esteja preenchida, deve-se considerar que a Data Final de Alocação do Equipamento é a data em que a agenda está sendo verificada. A ausência de preenchimento de data significa que o equipamento ainda está alocado no cliente. Considerando a Data Final de Alocação do Equipamento como a data da agenda verificada, garantimos que este equipamento seja considerado ao totalizar os registro da tabela TEW.
- Recursos Humanos (TFF): as consultas de agendas de atendentes deve ser realizada para determinar a quantidade a recursos humanos alocados apenas quando a função TxDiaTrab retornar verdadeiro, indicando que deve ter atendente(s) alocado(s) no posto naquele dia. Deve-se realizar a contagem de todos os registros retornados através do relacionamento entre ABB_IDCFAL e ABQ_CONTRT + ABQ_ITEM + ABQ_ORIGEM, a partir do relacionamento entre ABQ_CODTFF e TFF_COD, desde que a data da agenda encontre-se entre ABB_DTINI e ABB_DTFIM e a agenda esteja ativa (ABB_ATIVO=1).
Indicadores Diretos: - Saldo do Contrato: Indica o saldo em relação aos valores financeiros ainda não faturados do contrato, o Saldo do Contrato sempre será referente ao dia que está sendo analisado não podendo ser somado em relação a todas as dimensões.
Quantidade Contratada: Indica a quantidade de recursos contratados para a prestação do serviço.
Quantidade Alocada: Indica a quantidade real de recurso locado/alocado para a prestação de serviço.
Quantidade: Indica a quantidade de itens de contrato atendidos/não atendidos.
Parâmetros de Extração: A extração deve ser realizada diariamente, considerando a data indicada para extração como a data da cobertura do posto. Quando uma nova extração for realizada, para a mesma data de cobertura, esta será atualizada, podendo alterar o status do posto de coberto para descoberto. Não há histórico da evolução de cobertura, exemplo: ontem o posto estaria descoberto em 05/02/2015, hoje o posto estaria coberto em 05/02/2015. HOR Alocação de AtendentesApresenta informações referente a agenda de alocações dos atendentes, prestadores de serviços. As tabelas de dimensões envolvidas para a análise das medidas de Alocação de Atendentes são: Dimensões | Tabela Física | Fase | Empresa | HJ4 | 1 | Estabelecimento | HKK | 1 | Centro de Custo | HJ5 | 1 | Turno | HJU | 1 | Cargo | HJP | 1 | Atendente | HOH | 5 | Situação do Atendente | HOM | 5 |
Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de Serviços ou das dimensões da fase 1 do TOTVS BA. Indicadores: Alocação de Atendentes | Fluxo Principal de Origem: Atendente – AA1 | Lookup de Dimensões | Origem | Fase | Empresa (HOE_EMPRES) | FWGrpCompany() +FWCompany() | 1 | Estabelecimento (HOE_ESTABL) | FWFilial() | 1 | Centro de Custo (HOR_CCUSTO) | RA_CC ou AA1_CC, de acordo com a regra especificada. | 1 | Turno (HOR_TURNO) | RA_TNOTRAB ou AA1_TURNO, de acordo com a regra especificada. | 1 | Cargo (HOR_CARGO) | RA_CODFUNC ou AA1_FUNCAO, de acordo com a regra especificada. | 1 | Atendente (HOR_ATENDE) | AA1_CODTEC | 5 | Situação do Atendente (HOR_SITATE) | Atribuição a partir da regra especificada | 5 | Indicadores | Origem | Fase | Data da Agenda (HOR_DATA) | Data da agenda analisada a partir do período de-até indicado para extração | 5 | Quantidade (HOR_QTDAGE) | Valor fixo 1 | 5 |
O fluxo principal de dados considera as informações dos atendentes (AA1), gerando para cada dia pertencente ao range de datas indicado pelo usuário para a extração, um registro na tabela fato. Para geração de registro na fato é necessário verificar se o funcionário estava a serviço da empresa na data com base na data de admissão (RA_ADMISSA) e demissão do funcionário (RA_DEMISSA). O Atendente e a Data da Agenda serão os parâmetros chaves para determinar as demais informações da tabela fato. Observações pertinentes ao fluxo: No ERP Microsiga Protheus, as agendas dos atendentes são cadastradas de forma a indicar a alocação do atendente em um período de-até. Na transformação da informação para a Fluig Smart Data (FSD), este período de-até será transformado em um registro para cada dia da agenda, este dia refletirá o valor atribuído ao campo Data da Agenda. Exemplo: Se o atendente tem uma agenda do dia 01/01/2014 até 05/01/2014 e outra agenda de 08/01/2014 até 10/01/52014 definidas no ERP, na FSD e consequentemente no DW este atendente terá para os dias 01,02,03,04 e 05 de janeiro de 2014 o registro atribuído como alocado, 06 e 07 e janeiro de 2014 o registro atribuído como ocioso e para 08,09 e 10 os registros novamente atribuídos como alocado. Regras especificadas: Para o preenchimento dos campos de dimensões Centro de Custo, Turno e Cargo é necessário verificar o preenchimento do campo AA1_CDFUNC. Caso o campo esteja com o código do funcionário devidamente cadastrado, utiliza-se os campos de dimensões vindos da tabela SRA (a partir de AA1_FUNFIL + AA1_CDFUNC utilizando índice 1 – utilizar o campo de filial indicado e não a função xFilial). Caso o campo não contenha o código de funcionário válido, utiliza-se os campos de dimensões vindos da própria tabela AA1. O campo de dimensão Situação do Atendente receberá 1 dos 3 valores possíveis para a dimensão, de acordo com o resultado das validações realizadas: - Folga (atribuir 03) – verificar, através da função TxDiaTrab (Data da Agenda, Turno, Sequencia) se o dia analisado para agenda é um dia de trabalho ou não do atendente. Caso o retorno da função seja Falso, a situação do atendente será caracterizada como 03 (Folga). Ao determinar o atendente com situação de Folga, não é necessário realizar as demais verificações.
A função TxDiaTrab é detalhada na sessão “Funções Externas” deste documento. - Alocado (atribuir 01) – verificar se o atendente possui agenda para a data da agenda analisada. Esta verificação deve ser realizada identificando a data da agenda entre as datas ABB_DTINI e ABB_DTFIM de agendas ativas (ABB_ATIVO = 1). Caso seja encontrada uma agenda para o atendente, correspondente a data da agenda tratada, a situação do atendente será caracterizada como 01 (Alocado). Ao determinar o atendente com situação de Alocado, não é necessário realizar as demais verificações.
- Ocioso (Atribuir 02) – após as verificações e a não determinação da situação do atendente como Folga ou Alocado, a situação do atendente é automaticamente caracterizada como 02 (Ocioso).
Indicadores Diretos: - Quantidade: Indica a quantidade de agendas do atendente.
Parâmetros de Extração: A extração deve ser realizada diariamente, considerando a data indicada para extração como a data da agenda do atendente. Quando uma nova extração for realizada, para a mesma data da agenda, esta será atualizada, podendo alterar o status do atendente de ocioso para alocado. Não há histórico da evolução da agenda, exemplo: ontem o atendente estava ocioso no dia 05/02/2015, hoje o atendente está alocado no dia 05/02/2015. | 