Função de Status FCCSImpact

A função @FCCSImpactStatus permite alterar manualmente o status de uma combinação especificada de Cenário, Ano, Período e Entidade para "Afetado" com base em determinados cálculos. Por exemplo, se o sistema estiver calculando o valor de Renda Líquida para o cenário Real de uma entidade específica, talvez seja conveniente que o sistema afete a mesma entidade para o mesmo ano e período em outro cenário chamado Previsão. A função muda o status do cálculo para Afetado independentemente do status atual.

A função @FCCSImpactStatus pode ser usada nas regras Cálculos Configuráveis (regras de inserção) e Sob Demanda. Consulte Como Trabalhar com Cálculos Configuráveis e Como Trabalhar com Regras Sob Demanda.

Sintaxe:

@FCCSImpactStatus(Scenario, Year, Period, Entity)

Você seleciona estes parâmetros para a função:

• Cenário – único membro. A seleção deve ser um membro de nível 0.

• Ano – único membro. A seleção deve ser um membro de nível 0.

• Período – único membro. A seleção deve ser um membro de nível 0 (e não um pai, como Q1 ou HY1).

• Entidade – único membro, ou função, ou lista. Membros pai e de nível 0 são suportados.

Funções como: @CURRMBR, @PREVSIBLING, @NEXTSIBLING, @LIST são suportadas.

Para Entidade, o tipo de lista das funções Conjunto de Membros é suportado usando o Nome do Membro específico em vez de @CURRMBR("Entity"). Por exemplo:

• Descendentes (inc.)

• Filhos (incl)

• Antecessores (incl)

• Irmãos (incl)

• Pais (incl)

• Descendentes de Nível 0

• Irmãos à Esquerda (incl.)

• Irmãos à Direita (incl.)

• Membro de Nível 0 Anterior

• Próximo Membro de Nível 0

• Geração Anterior

• Próxima Geração

• @List

Para as dimensões Cenário, Ano, Período e Entidade, @CURRMBR é suportada para indicar o mesmo que o membro atual que está sendo processado.

Para as dimensões Cenário, Ano, Período e Entidade, as funções @NEXTSIBLING e @PREVSIBLING são suportadas apenas quando combinadas diretamente com a função @CURRMBR. As três combinações seguintes são suportadas usando a função @CURRMBR(..):

• @CURRMBR("Cenário/Anos/Período/Entidade")

• @PREVSIBLING(@CURRMBR(…))

• @NEXTSIBLING(@CURRMBR(…))

Para a dimensão Entidade, a função @LIST é suportada onde o item pode ser @CURRMBR("Entity") ou suas combinações válidas. Por exemplo, as instruções seguintes no campo Entidade são válidas:

• @LIST(@CURRMBR("Entity"), "LE-0011-EUR" @SIBLINGS("LE-0016-BRL"))

• @LIST(@PREVSIBLING(@CURRMBR("Entity")),

• @NEXTSIBLING(@CURRMBR("Entity")), @IAncestors("LE-0011-EUR"));

O sistema afeta as dimensões Cenário/Ano/Período/Entidade conforme especificado na função @FCCSImpactStatus, independentemente de seu status de cálculo atual, além de afetar todos os pais e antecessores aplicáveis. Todos os períodos futuros com dados são afetados.

Se a entidade tiver entidades compartilhadas, a entidade principal e todas as suas entidades compartilhadas serão afetadas, assim como seus pais e antecessores correspondentes. O sistema não afeta entidades que estão bloqueadas.

Quando você usa a função @FCCSImpactStatus em cálculos configuráveis (regras de inserção), o validador de status de impacto detecta erros e pode fazer com que o processo de consolidação falhe durante a geração do script. Por padrão, uma Variável de Substituição chamada DisableImpactStatusConsolValidation é habilitada, o que permite que o validador semântico da regra de Status de Impacto ignore erros de validação e continue com a execução da regra de Consolidação. Se você definir o valor da Variável de Substituição como Falso, o validador exibirá erros de Status de Impacto com detalhes.

Exemplo: Usando a função @FCCSImpactStatus em Cálculos Configuráveis

O exemplo a seguir mostra uma amostra do script de cálculo Status do Impacto.

Os exemplos a seguir mostram o impacto da função @FCCSImpactStatus nas diversas combinações de Cenário/Ano/Período/Entidade.

Exemplo 1: Impacto Explícito de um(a) Cenário/Ano/Período/Entidade específico(a)

@FCCSImpactStatus("Budget", "FY16", "Jan", "GBP E2")

Selecione "Actual/FY16/Jan/EUR #1" para executar a Regra Sob Demanda.

A função afetará explicitamente "Budget/FY16/Jan/GBP E2" e os antecessores de GBP2 E2 em Budget/FY16/Jan.

O membro pai "EUR D1" também será afetado.

Exemplo 2: Afeta um Cenário diferente, mas o mesmo Ano/Período/Entidade

@FCCSImpactStatus("Budget",@CURRMBR("Years",@CURRMBR("Period"),@CURRMBR("Entity")

Selecione "Actual/FY16/Feb/EUR E1" para executar a Regra Sob Demanda.

Ela afetará explicitamente "Budget/FY16/Feb/EUR E1" e os antecessores de EUR E1 em Budget/FY16/Feb.

O membro pai "EUR D1" também será afetado para Fevereiro.

Exemplo 3: Afeta o Cenário/Ano/Período atual, mas Entidades diferentes usando a função @List

@FCCSImpactStatus("@CURRMBR"("Scenario"), @CURRMBR("Years"), @CURRMBR("Period"),@LIST("EUR E3", "USD E4")

Selecione "Actual / FY16 / Mar / EUR E1" para executar a Regra Sob Demanda.

Ela afetará explicitamente "Actual/FY16/Mar/EUR E3 e USD E4", bem como os antecessores de EUR E3 e USD E4 em Actual/FY16/Mar.

O Pai correspondente "USD D2" também será afetado para Março.

Exemplo 4: Afeta Cenário/Ano/Entidade atual, mas o próximo Período

@FCCSImpactStatus("@CURRMBR"("Scenario"), @CURRMBR("Years"), @NEXTSIBLING(@CURRMBR("Period")),@CURRMBR("Entity"))

Selecione "Actual/FY16/Apr/EUR E1" para executar a Regra Sob Demanda

Ela afetará explicitamente "Actual/FY16/May/EUR E1" e os antecessores de EUR E1 em Actual/FY16/May.

O Pai correspondente "EUR D1" também será afetado para Maio.

Exemplo 5: Afeta Cenário/Ano/Período/Entidade usando Valores de RTP do Calculation Manager

FIX("FCCS_Periodic", "Custom1", " Custom2", "FCCS_No Intercompany", " Custom3", "FCCS_Data Input","FCCS_Entity Input","FCCS_No Movement")
        "Account"(
                @FCCSImpactStatus({Scenario},{Years},{Period},@IDESCENDANTS({Entity})) ;
        )
ENDFIX

Este script usará os valores de Cenário, Ano, Período e Entidade dos valores de Solicitação de Tempo de Execução do Calculation Manager fornecidos durante a execução da Regra Sob Demanda.

Isso afetará as entidades com entidade pai e todos os seus descendentes.

Casos de Uso Adicional

O exemplo a seguir mostra casos de uso adicionais para a função @FCCSImpactStatus e seus resultados.

Suponha que você esteja usando essa Hierarquia de Entidade, consolidando Actual/FY19/Nov/P02 e usando a função @FCCSImpactStatus:

Caso de uso 1: @FCCSImpactStatus("Actual", "FY19", "Nov", "E03")

Como a Entidade E03 é uma descendente de P02 (e Cenário, Ano e Período são iguais), não haverá impacto.

Caso de uso 2: @FCCSImpactStatus("Actual", "FY19","Nov", "E04")

A Entidade E04 não é uma descendente de P02. Haverá impacto.

Caso de uso 3: @FCCSImpactStatus("Actual", "FY19","Dec", "E03")

Embora a Entidade E03 seja uma descendente de P02, Dec. é um período após Novembro, de modo que ele será afetado.

Caso de uso 4: @FCCSImpactStatus("Actual", "FY19", "Oct", "E03")

Não haverá impacto. Estamos consolidando Actual/FY19/Nov/P02, o que significa que P02 e todos os seus descendentes, inclusive E03, estarão OK em Actual/FY19/Nov.

Caso de uso 5: @FCCSImpactStatus("Actual", "FY19", "Oct", "E04")

Haverá impacto. A Entidade E04 não é uma descendente de P02.