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