Totais de metas acumuladas

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para acumular dados na hierarquia de metas, use a mensagem RecalculateRequest. Ela recalcula os valores de campo de acúmulo da meta, como o Goal.ActualMoney ou Goal.ActualInteger, para todas as metas da hierarquia. Um valor acumulado para cada meta é executado no contexto do administrador da meta. Isso significa que somente os registros aos quais um administrador de uma meta tem acesso de leitura participam do valor acumulado. O sistema troca automaticamente o contexto do administrador de cada meta durante o valor acumulado, já que cada meta pode ter um administrador diferente.

As metas são acumuladas a partir das metas secundárias para as primárias, da hierarquia mais baixa à superior. O total final das metas raiz no topo da hierarquia é uma soma cumulativa de todos os totais da hierarquia. Por exemplo, se for usada a métrica de receita, o total é uma soma cumulativa de valores monetários. Se uma métrica de contagem for usada, o total é uma contagem cumulativa de registros reais no sistema, como chamadas telefônicas. Independentemente de qual meta específica é um alvo da operação de recalcular, todos os totais em uma dada hierarquia são atualizados.

Se você definir Goal.RollupOnlyFromChildGoals para true, apenas os registros secundários de metas são usados no valor acumulado. Se você definir para false, o valor acumulado inclui os registros secundários e outros registros de participação de metas. Um registro de participação deve cumprir com as seguintes condições:

• A data do registro de origem deve ser entre a data de início e a data de término do período da meta, ou ser exatamente na data de início ou data de término do período da meta.

• O estado e status do registro devem corresponder aos valores definidos na métrica da meta.

• Se uma consulta de valor acumulado for específica para a meta, todas as condições de consulta devem ser cumpridas.

• O administrador da meta deve ter acesso de leitura ao registro.

Para especificar as horas de expiração do valor acumulado, use o atributo Organization.GoalRollupExpiryTime. Por exemplo, se o horário de expiração do valor acumulado for definido para seis meses, as metas mais antigas do que seis meses não serão acumuladas automaticamente. Para especificar a frequência do valor acumulado da meta, use o atributo Organization.GoalRollupFrequency. A frequência pode ser definida a cada hora. Por padrão, os valores reais da meta são recalculados a cada 24 horas.

Substituir valores calculados

Para substituir o sistema calculado real, em andamento, ou valores acumulados de campos personalizados da meta, use a mensagem UpdateRequest para atualizar o registro de metas. Você deve definir o atributo Goal.IsOverride para true para notificar o sistema que os valores acumulados de campo podem ser atualizados. Para sinalizar o sistema que os valores acumulados do campo da meta foram substituídos e não precisam ser atualizados durante a próxima operação de recalcular, defina o atributo Goal.IsOverridden para true. Se Goal.IsOverride é false, uma exceção é jogada durante a operação de atualização. Se Goal.IsOverridden é false, os valores acumulados do campo da meta serão substituídos durante a próxima operação de recalcular com os valores calculados do sistema.

Confira Também

Entidades de gerenciamento de metas
Exemplo: Obter o valor acumulado dos dados da meta de um período personalizado em relação à receita de destino
Exemplo: Obter o valor acumulado dos dados da meta de um período fiscal em relação à contagem de destino de ampliação
Mensagens e métodos da entidade Goal

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais