Datas de conclusão

Introdução

O painel Datas de vencimento exibe informações sobre casos que cumprem ou não os prazos e os custos relacionados. As datas de vencimento podem ser predefinidas para definir um estágio significativo ou prazo de atividade nos processos. O painel Datas de vencimento pode ser usado para analisar vários aspectos das datas de vencimento nos processos. Por meio desse painel, é possível examinar datas de vencimento pré-definidas no processo, como um prazo de pagamento ou um SLA que precisa ser cumprido no prazo.

As datas de vencimento podem ter custos associados a atrasos nas datas de vencimento.

Configuração de datas de vencimento

Se você quiser usar o painel de Datas de conclusão para analisar datas de conclusão, é necessário definir essas datas para seu modelo de aplicativo.

Se houver datas de conclusão prontas para uso disponíveis para seu modelo de aplicativo, essas datas de conclusão serão exibidas no painel Datas de conclusão. Na documentação do seu modelo de aplicativo específico, você encontrará uma visão geral das datas de vencimento disponíveis. A página Modelos de aplicativos contém links para a documentação de todos os modelos de aplicativos disponíveis.

Se não houver dados disponíveis no painel de datas de conclusão, você precisará configurar suas próprias datas de conclusão no arquivo models\5_business_logic\Due_dates_base.sql usando transformações de dados. Aqui você também pode configurar quaisquer datas de vencimento padrão para suas necessidades de negócios.

Para Processo personalizado, você também pode carregar datas de vencimento usando o arquivo Due_dates_raw.csv. Consulte Campos de entrada de Processo personalizado.

Adição de lógica de negócios nas transformações

Na última etapa de transformação, a lógica de negócios é adicionada conforme necessário para a análise de dados.

Cada registro na tabela de datas de vencimento representa uma data de vencimento para um determinado evento. Exemplos de datas de vencimento são:

• um prazo de pagamento para um evento de pagamento.
• um prazo de aprovação para um evento de aprovação.

Os campos obrigatórios para esta tabela são Event_ID, Due_date, Actual_datee Expected_date.

Nem todos os eventos terão uma data de vencimento e alguns eventos podem ter várias datas de vencimento.

Consulte Transformações de dados para obter mais informações.

Providing due date configuration input using dbt seeds

Você pode fornecer dados de entrada adicionais a serem usados para os cálculos no painel Datas de vencimento usando um arquivo de semente dbt . A pasta seed\ das transformações de aplicativo para o modelo de aplicativo contém um arquivo Due_dates_configuration_raw.csv . Para todas as datas de vencimento, você pode fornecer os seguintes campos.

Name	Tipo	Description
Due_date	Texto	O nome da data de vencimento .
Due_date_type	Texto	O tipo de data de vencimento.
Fixed_costs	Booleano	Uma indicação se os custos são fixos ou baseados no tempo.
Custo	Flutuar	Custos fixos: A quantidade de custos. Custos variáveis: A quantidade de custos por Time e Type_type.
Hora	Número inteiro	Um número que indica a quantidade de tempo no caso de custos baseados em tempo.
Time_type	Texto	Tipo de período de tempo para cálculos de custos. Pode ser qualquer um dos seguintes valores: day, hour, minute, second, milisecond.

Veja a ilustração abaixo para um exemplo.

Consulte Transformações.

Exemplos de SQL para configurar datas de vencimento

Abaixo estão alguns exemplos de SQL que você pode usar para configurar datas de vencimento usando transformações.

Atenção:

Os exemplos de SQL abaixo são baseados em modelos de log de eventos e aplicativos de processos personalizados e usam Casos que têm um Case_ID. Se você quiser usar os exemplos de SQL para definir Datas de vencimento para modelos de aplicativos Purchase-to-Pay ou modelos de aplicativos Order-to-Cash, certifique-se de usar a entidade apropriada e o entity_ID interno relacionado. Para Purchase-to-Pay, você pode usar o log de eventos Purchase_order_item_end_to_end_events, a entidade Purchase_order_items e Purchase_order_item_ID_internal como Case_ID. Para Order-to-Cash, você pode usar o log de eventos Sales_order_item_end_to_end_events, a entidade Sales_order_items e Sales_order_item_ID_internal como Case_ID.

Atividade X realizada antes da data Y

Esse código SQL identifica casos em que a última ocorrência da atividade 'X' foi realizada antes da data 'Y'.

with Event_log_base as (
    select * from {{ ref('Event_log_base') }}
),

Cases_base as (
    select * from {{ ref('Cases_base') }}
),

-- Last activity X of each case
Last_activity_X as (
    select
        Event_log_base."Case_ID",
        max(Event_log_base."Event_end") as "Event_end",
        max(Event_log_base."Event_ID") as "Event_ID"
    from Event_log_base
    where Event_log_base."Activity" = 'X'
    group by Event_log_base."Case_ID"
),

-- Last activity X should be done before Case date field Y
Activity_X_done_before_date_Y as (
    select
        Last_activity_X."Case_ID",
        {{ pm_utils.as_varchar('Last activity X before Cases date field Y') }} as "Due_date",
        Last_activity_X."Event_end" as "Actual_date",
        Cases_base."Case_date_field_Y" as "Expected_date",
        Last_activity_X."Event_ID"
    from Last_activity_X
    inner join Cases_base
        on Last_activity_X."Case_ID" = Cases_base."Case_ID"
)

select * from Activity_X_done_before_date_Y

Atividade X realizada dentro de 5 dias após a atividade Y

Esse código SQL identifica casos para os quais a última ocorrência da atividade 'X' aconteceu dentro de 5 dias após a última ocorrência da atividade 'Y'.

with Event_log_base as (
    select * from {{ ref('Event_log_base') }}
),

-- Last activity X of each case
Last_activity_X as (
    select
        Event_log_base."Case_ID",
        max(Event_log_base."Event_end") as "Event_end",
        max(Event_log_base."Event_ID") as "Event_ID"
    from Event_log_base
    where Event_log_base."Activity" = 'X'
    group by Event_log_base."Case_ID"
),

-- Last activity Y of each case
Last_activity_Y as (
    select
        Event_log_base."Case_ID",
        max(Event_log_base."Event_end") as "Event_end",
        max(Event_log_base."Event_ID") as "Event_ID"
    from Event_log_base
    where Event_log_base."Activity" = 'Y'
    group by Event_log_base."Case_ID"
),

-- Last activity X should be done at date of last Event Y + 5 days
Activity_X_done_within_5_days_after_activity_Y as (
    select
        Last_activity_Y."Case_ID",
        {{ pm_utils.as_varchar('Last activity X before last activity Y + 5 days') }} as "Due_date",
        {{ pm_utils.dateadd('day', 5, 'Last_activity_Y."Event_end"') }} as "Expected_date",
        Last_activity_X."Event_end" as "Actual_date",
        Last_activity_Y."Event_ID" as "Event_ID"
    from Last_activity_Y
    inner join Last_activity_X
        on Last_activity_Y."Case_ID" = Last_activity_X."Case_ID"
)

select * from Activity_X_done_within_5_days_after_activity_Y

Analyzing Due dates

Due dates dashboard

O painel Datas de vencimento permite analisar as datas de vencimento que ocorrem no processo.

Siga estas etapas para exibir o painel Datas de vencimento .

1. Selecione Datas de vencimento no menu à esquerda do painel.

O painel de Datas de vencimento é exibido.

Abaixo está uma visão geral dos gráficos disponíveis no painel Datas de vencimento .

Chart	Description	Métricas disponíveis
Due dates details	Um gráfico de barras mostrando detalhes relacionados às datas de vencimento com base na métrica selecionada.	Número de casos Tempo total de atraso Média de tempo de atraso Porcentagem sobre o tempo Custo total* Custo médio*
Histórico de atraso	Um gráfico de histórico mostrando as informações de data de vencimento para o período selecionado com base na métrica selecionada.	Tempo total de atraso Média de tempo de atraso Porcentagem sobre o tempo Custo total* Custo médio*
Distribuição de diferença	Um gráfico de distribuição mostrando o número de datas de conclusão relacionadas à quantidade de dias de atraso.

* Total cost late e Average cost late estão disponíveis apenas se Fixed_cost e Cost forem fornecidos usando o arquivo de sementes Due_dates_configuration_raw.csv .

Overview tab

Os gráficos na guia Visão geral realçam as datas de conclusão definidas para seu processo. Para cada data de conclusão, é exibido o número de casos (Casos atrasados) e o tempo total de atraso para o período selecionado.

Details tab

A guia Detalhes contém vários gráficos que permitem analisar as atividades atrasadas com mais detalhes. Veja a ilustração abaixo.

Abaixo está uma visão geral dos gráficos disponíveis no painel Datas de vencimento .

Chart	Description	Métricas disponíveis
Possíveis economias	Um gráfico de pizza mostrando a economia de tempo potencial para as datas de vencimento definidas em seu conjunto de dados.	Tempo total de atraso Média de tempo de atraso Custo total* Custo médio*
Histórico de atraso	Um gráfico de histórico mostrando as informações de data de vencimento para o período selecionado com base na métrica selecionada.	Tempo total de atraso Média de tempo de atraso Porcentagem sobre o tempo Custo total* Custo médio*
Due dates details	Um gráfico de barras mostrando detalhes relacionados às datas de vencimento com base na métrica selecionada.	Número de casos Tempo total de atraso Média de tempo de atraso Porcentagem sobre o tempo Custo total* Custo médio*
Distribuição de diferença	Um gráfico de distribuição mostrando o número de datas de conclusão relacionadas à quantidade de dias de atraso.

* Total cost late e Average cost late estão disponíveis apenas se Fixed_cost e Cost forem fornecidos usando o arquivo de sementes Due_dates_configuration_raw.csv .

Due dates details

The Due dates details chart enables you to view detailed due dates information based on different metrics and fields. You can select the following fields.

Campo	Description
Data de conclusão	O nome da data de conclusão.
Tipo de data de vencimento*	O tipo da data de vencimento.
Custo*	Os custos relacionados à data de vencimento.
Data esperada	A data prevista para a execução da atividade.
Data efetiva	A data em que a atividade é realmente executada.
On time	Atividades que são pontuais ou atrasadas. Observação: Atividadesatrasadas são atividades para as quais a data real é posterior à data esperada.
Diferença	A quantidade de tempo entre a data esperada e a data real.

* Tipo de data de vencimento e Custo só estarão disponíveis se esses campos estiverem configurados para as datas de vencimento.