Árvore de páginas

Índice

Objetivo

Esta ferramenta extrai os  dados do ERP Microsiga Protheus® e cria toda a estrutura relacional para gerar informações gerenciais necessárias ao assunto  de Desempenho dos Recebimentos, Gestão da Qualidade, Gestão de Compras e Gestão de Estoque, todos relacionados com a área de Serviços.

Saídas

São as tabelas com toda estrutura relacional e com os dados gerenciais extraídos do  ERP Microsiga Protheus:

 

    Dimensões Relacionadas

    HOH Atendente (Função BIXAtendente)

    Visualiza as informações pelo código e nome do atendente. Atendente representa a pessoa/recurso disponível para a prestação de serviços contratados.

    Deve ser declarada no X2_UNICO da tabela fato? NÃO

    Dimensão: Atendente (HOH)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOH_ATENDE

    AA1_FILIAL + AA1_CODTEC

    Código

    HOH_CODIGO

    AA1_CODTEC

    Nome

    HOH_NOME

    AA1_NOMTEC

    HOI Posto (Função BIXPosto)

    Visualiza as informações pelo código e descrição do posto. Posto é o local exato para a prestação de serviço. Exemplo: Posto TOTVS Braz Leme 2º andar.

    Deve ser declarada no X2_UNICO da tabela fato? NÃO

    Dimensão: Posto (HOI)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOI_POSTO

    ABS_FILIAL + ABS_LOCAL

    Código

    HOI_CODIGO

    ABS_LOCAL

    Descrição

    HOI_DESC

    ABS_DESCRI

    HOJ Contrato (Função BIXContrato)

    Visualiza as informações pelo código e revisão do contrato. Contrato é o acordo firmado entre as partes que define os recursos necessários na contratação da prestação do serviço.

    Deve ser declarada no X2_UNICO da tabela fato? NÃO

    Dimensão: Contrato (HOJ)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOJ_CONTRA

    CN9_FILIAL + CN9_NUMERO + CN9_REVISA

    Código

    HOJ_CODIGO

    CN9_NUMERO

    Revisão

    HOJ_REVISA

    CN9_REVISA

    HOK Área do Posto (Função BIXAreaPosto)

    Visualiza as informações pelo código e descrição da área. Área é a região em que o posto está localizado. Esta área pode ser configurada de acordo com a necessidade do cliente, delimitando zonas ou regiões que melhor caracterizam determinados locais de atendimento. Exemplo: Área 1 - Zona Norte, Área 2 - Grande ABC, etc.

    Deve ser declarada no X2_UNICO da tabela fato? SIM

    Dimensão: Área do Posto (HOK)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOK_AREA

    X5_FILIAL + X5_CHAVE

    Código

    HOK_CODIGO

    X5_CHAVE

    Descrição

    HOK_DESC

    X5_DESC

    Dimensão: Situação do Contrato (HOL)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOL _SITCON

    Valor fixo atribuído ao código

    Código

    HOL_CODIGO

    Valor Fixo

    Descrição

    HOL_DESC 

    Valor Fixo

    Para a utilização da tabela SX5, como origem de dados da dimensão, deve-se efetuar o filtro por X5_TABELA = A2.

    HOL Situação do Contrato (Função BIXSituContato)

    Visualiza as informações pelo código e descrição da situação do contrato. Situação do contrato é a classificação da atividade do contrato. Exemplo: Vigente, Paralisado, Revisado, etc.

    Deve ser declarada no X2_UNICO da tabela fato? SIM

    Dimensão: Situação do Contrato (HOL)

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOL _SITCON

    Valor fixo atribuído ao código

    Código

    HOL_CODIGO

    Valor Fixo

    Descrição

    HOL_DESC 

    Valor Fixo

    Código

    Descrição

    01

    Cancelado

    02

    Elaboração

    03

    Emitido

    04

    Aprovação

    05

    Vigente

    06

    Paralisado

    07

    Solicitada Finalização

    08

    Finalizado

    09

    Revisão

    10

    Revisado

    HOM Situação do Atendente (Função BIXSitAtendente)

    Visualiza as informações pelo código e descrição da situação do atendente. Situação do atendente é a classificação do atendente quanto a sua agenda. Exemplo: Alocado, Ocioso, etc.

    Deve ser declarada no X2_UNICO da tabela fato? SIM

    Dimensão: Situação do Atendente (HOM)

     

     

     

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOM_SITATE

    Valor fixo atribuído ao código

     

    Código

    HOM_CODIGO

    Valor Fixo

     

    Descrição

    HOM_DESC

    Valor Fixo

    Código

    Descrição

    01

    Alocado

    02

    Ocioso

    03

    Folga

    HON Tipo de Contrato (Função BIXTpContrato)

    Visualiza as informações pelo código e descrição do tipo de contrato. Tipo de contrato atribui diversas características padronizadas para os contratos de trabalho, de acordo com o ramo das empresas. Exemplo: Terceirização, locação de equipamentos, etc.

    Deve ser declarada no X2_UNICO da tabela fato? NÃO

    Dimensão: Tipo de Contrato (HON)

     

     

     

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HON_TPCONT

    CN1_FILIAL + CN1_CODIGO

     

    Código

    HON_CODIGO

    CN1_CODIGO

     

    Descrição

    HON_DESC

    CN1_DESC

    HOO – Status do Posto (Função BIXSttPosto)

    Visualiza as informações pelo código e descrição do status do posto. Status do posto classifica o posto quanto ao atendimento dos serviços contratados. Exemplo: Posto Coberto, Posto Descoberto, Posto Excedido, etc.

    Deve ser declarada no X2_UNICO da tabela fato? SIM

    Dimensão: Status do Posto (HOO)

     

     

     

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOO_STTPOS

    Valor fixo atribuído ao código

     

    Código

    HOO_CODIGO

    Valor Fixo

     

    Descrição

    HOO_DESC

    Valor Fixo

    Código

    Descrição

    01

    Posto Coberto

    02

    Posto Descoberto

    03

    Posto Excedido

    04

    Dia de Serviço não Contratado

    HOP Tipo de Recurso da Prestação de Serviço (Função BIXTpRecurso)

    Visualiza as informações pelo código e descrição do status do posto. Status do posto classifica o posto quanto ao atendimento dos serviços contratados. Exemplo: Posto Coberto, Posto Descoberto, Posto Excedido, etc.

    Deve ser declarada no X2_UNICO da tabela fato? SIM

    Dimensão: Tipo de Recurso da Prestação de Serviço (HOP)

     

     

     

    Fase

    Campos

    Atributo Destino (Stage)

    Origem

    05

    Business Key

    HOP_TIPREC

    Valor fixo atribuído ao código

     

    Código

    HOP_CODIGO

    Valor Fixo

     

    Descrição

    HOP_DESC

    Valor Fixo

    Código

    Descrição

    01

    Recursos Humanos

    02

    Locação de Equipamentos

    03

    Material de Implantação


    Regra de Negócio

    Para 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.

    Especificação Física

     

    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 Atendentes

    Apresenta 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.