Noções básicas sobre valores de moeda FX em listas e relatórios

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

    • Por padrão, os valores de moeda que aparecem nos campos Moeda FX em listas e relatórios são os valores que você insere diretamente nos campos Moeda FX. Para relatórios, as agregações de campos de Moeda FX são, por padrão, valores de moeda de referência.

    Valores de Moeda FX em exibições de lista

    Em listas, os valores de moeda FX aparecem como uma cadeia de caracteres de moeda formatada retornada de getDisplayValue().
    Para um campo de moeda FX que depende de outro campo de moeda FX, o valor da moeda vem do registro de instância de moeda [fx_currency2_instance] associado a este último. O formato do valor de exibição é baseado em como você configurou suas configurações de exibição em Localização do Sistema > Configuração da Moeda FX.
    Nota:
    Um campo de moeda FX em uma tabela personalizada é um campo de referência que armazena a referência (sys_id) para o registro real. Como o sys_id tem 32 caracteres, o Tamanho máximo da coluna Moeda FX deve ser 32 (padrão).

    Filtrando valores de moeda FX em listas

    Em listas, a filtragem do campo Moeda FX se comporta de forma diferente dos campos de moeda padrão. A filtragem ocorre usando o tipo de moeda selecionado quando um valor de moeda é inserido originalmente em um campo de Moeda FX. Ele não leva em conta as moedas de referência quando você filtra uma lista. Portanto, se a lista não filtrada contiver entradas do campo Moeda FX em várias moedas, uma lista filtrada conterá somente os registros inseridos originalmente usando a moeda de filtragem especificada.
    • Por exemplo, se você inseriu um valor de moeda em Euros (Euros) e a moeda de referência for Dólar americano (USD), o valor da moeda de referência poderá aparecer em uma lista não filtrada.
    • No entanto, se você filtrar a lista e selecionar USD como a moeda, o valor da moeda, originalmente inserido em Euros, não será exibido. Nesse caso, somente os valores de moeda inseridos originalmente em USD serão exibidos.

    Campos de Moeda FX dependente

    O uso da exibição de Moeda FX ou de campos dependentes permite que você use configurações de exibição alternativas definidas em Localização do Sistema > Configuração da Moeda FX para um campo de Moeda FX específico. Para saber mais sobre as configurações do campo Moeda FX, consulte Configurando o comportamento do campo Moeda FX.

    Ao criar um campo de moeda FX, você pode marcá-lo como dependente de outro campo de moeda FX. Marcar um campo de Moeda FX como dependente permite que ele use as definições de configuração do campo Moeda FX original para exibir os valores de valor em uma moeda diferente. As mudanças feitas no campo dependente não afetam o campo de Moeda FX original.

    Relatório de Moeda FX, agregação e grupo por

    Você pode selecionar campos de Moeda FX para inclusão em relatórios e eles são exibidos da mesma maneira que nas exibições de lista.
    • Os campos de moeda FX aparecem como uma cadeia de caracteres de moeda formatada retornada de getDisplayValue().
    • Se você definir o campo Moeda do valor de exibição em Localização do Sistema > Todas as Propriedades para Exibir na Moeda da Sessão, a moeda da sessão atribuída ao usuário que está executando o relatório é exibida.

    Você pode agregar valores semelhantes de moeda de referência em um registro de instância de moeda. A seguir está o formato de dados agregados da Moeda FX no Now Platform®:

    Tabela 1. Agregar valor da moeda FX
    Tipo Descrição
    Cadeia de caracteres Valor da agregação. Se os valores que estão sendo agregados forem valores de moeda FX, o valor retornado estará no formato currency_code:currency_value, como:

    USD: 134.980000

    Caso contrário, o valor retornado será apenas o valor da moeda, como: 134.980000.
    Nota:
    Se o campo contiver valores de moeda FX de tipos de moeda mista, os valores não poderão ser agregados. O valor é retornado como ponto e vírgula (;).
    Por exemplo, se o campo Custo em um registro de transação for um campo Moeda FX, você poderá agrupar por cost.amount ou cost.currency.
    • Operações de agregação, como SUM, são traduzidas como SUM(amount) ou SUM(reference_amount). A origem de agregação determina a conversão quando a moeda associada aos valores de moeda no agrupamento é a mesma.

      Por exemplo, o valor agregado retornado por GlideAggregate.getAggregate() é uma cadeia de caracteres no formato USD; 1234.56. O valor total da moeda é expresso na única moeda de referência que está associada a todos os valores de moeda no agrupamento.

    • Se houver moedas diferentes associadas aos valores de moeda no agrupamento, o valor agregado ficará em branco. Por exemplo, se alguns dos valores da moeda estiverem em dólares americanos, alguns em Euros e outros em Yen, o valor agregado ficará em branco.
    Você também pode usar um comando Agrupar por nos campos de Moeda FX.
    • É equivalente ao agrupamento por moeda e valor, ou por reference_currency e reference_amount, conforme ditado pela origem de agregação.
    • O valor do agrupamento está disponível por referência com pontos no campo Moeda FX ou usando uma API como getDisplayValue().