Moeda da sessão e de referência

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Os campos de moeda padrão em Now Platform® usam dois tipos de moeda, Sessão e Referência.

    Moeda da sessão
    A moeda da sessão é definida para o usuário pela localidade do usuário ou pelo modo de moeda única.
    Referência
    O local do sistema determina a moeda de referência e é o padrão usado em toda a instância.
    Cada vez que você insere um valor em um campo de moeda ou preço, o sistema armazena três informações:
    • Valor conforme inserido, na localidade do usuário.
    • Código da moeda na localidade do usuário.
    • Valor convertido para a moeda de referência usando a taxa de câmbio atual.
    Nota:
    No modo de várias moedas, o código da moeda salvo no campo de moeda pode não ser igual ao código da moeda da sessão. Por exemplo, a moeda da sessão pode ser o Euro e o número inserido pode ser o Iene japonês.

    Moeda da sessão

    Quando os usuários exibem um valor de moeda, eles podem ver o valor conforme inserido ou no formato de moeda da sessão. O formato contém:
    • Símbolo da moeda
    • Valor convertido para a moeda da sessão e mostrado em um formato de número localizado.

    A localidade do usuário determina o formato da moeda da sessão.

    O formato do número pode diferir em recursos como o separador decimal com base na localidade. Por exemplo, a formatação dos EUA é 1.234.567,89, enquanto a formatação em alemão é 1.234.567,89. O Now Platform® determina a moeda da sessão na seguinte sequência:
    • Configuração do modo de moeda única usando glide.i18n.single_currency e glide.i18n.single_currency.code.
    • Moeda padrão para a localidade do usuário.

    Moeda de referência

    Para executar cálculos em valores de moeda hete- rogêneos, o Now Platform® armazena valores de moeda convertidos para uma moeda do sistema, chamada de moeda de referência. Cada campo de moeda contém um valor de moeda de referência. O sistema determina a moeda de referência na seguinte sequência:
    • Localidade do sistema definida usando a propriedade glide.system.locale
    • Localidade padrão do Java, normalmente en.US

    Os recursos de filtragem e agregação usam o valor da moeda de referência para executar cálculos em campos de moeda padrão. Esses recursos podem gerar resultados imprecisos devido a mudanças na taxa de conversão.

    Problemas com campos de moeda

    Os usuários geralmente ficam confusos com os resultados da filtragem, classificação e exibição de campos de moeda porque o sistema funciona com pelo menos duas moedas para cada valor: a moeda da sessão e a moeda de referência.

    Nota:
    As agregações e a filtragem de campos de moeda usam a moeda de referência e o usuário vê a moeda da sessão. Por causa das taxas de conversão em mudança, os valores de moeda de referência filtrados podem não resultar na mesma ordem que os valores de moeda da sessão sugeririam. O mesmo problema acontece com agregações.
    O usuário pode ver os seguintes problemas:
    • As listas filtradas em campos de moeda podem não estar na ordem esperada. Ele usa os valores da moeda de referência para filtragem, mas exibe os valores da moeda da sessão.
    • A agregação de campos de moeda pode não produzir os resultados esperados porque os valores de moeda de referência são agregados e convertidos para a moeda da sessão.
    • Os valores de moeda podem não aparecer como esperado porque os valores de moeda são formatados com base na localidade do usuário e não no código da moeda.

    Essa confusão pode ser resultado da diferença entre as moedas da sessão e de referência, da mudança nas taxas de conversão e de diferentes moedas de sessão usadas por diferentes usuários.