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

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

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

    Valores de moeda de FX nas exibições de lista

    Em listas, os valores de Moeda de FX aparecem como uma cadeia de caracteres de moeda formatada retornada de getDisplayValue().
    Para um campo de moeda de FX que depende de outro campo de moeda de 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ê definiu suas configurações de exibição em Localização do Sistema > Configuração de Moeda de FX.
    Nota:
    Um campo de Moeda de FX em uma tabela personalizada é um campo de referência que armazena a referência (sys_id) ao registro real. Como o sys_id tem 32 caracteres, o tamanho máximo da coluna Moeda de FX deve ser 32 (padrão).

    Filtrando valores de moeda de FX em listas

    Em listas, a filtragem do campo Moeda de 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 de 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 de campo de moeda de 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 (EU) 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 seriam exibidos.

    Campos de moeda de FX dependente

    O uso da exibição de moeda de 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 específico de Moeda de FX. Para saber mais sobre as configurações do campo Moeda de FX, consulte Configurando o comportamento do campo Moeda de FX.

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

    Emissão de relatórios, agregação e agrupamento de moeda de FX por

    Você pode selecionar campos de Moeda de 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 de 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 em Moedada sessão , a moeda da sessão atribuída ao usuário que está executando o relatório será exibida.

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

    Tabela 1. Valor agregado da moeda de FX
    Tipo Descrição
    Cadeia de caracteres Valor da agregação. Se os valores que estão sendo agregados forem valores de moeda de 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 um ponto e vírgula (;).
    Por exemplo, se o campo Custo em um registro de transação for um campo Moeda de 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 estará vazio. Por exemplo, se alguns dos valores de moeda estiverem em dólares norte-americanos, alguns em Euros e outros em Ienes, o valor agregado ficará em branco.
    Você também pode usar um comando Agrupar por nos campos de Moeda de FX.
    • É equivalente ao agrupamento por moeda e valor, ou por reference_currency e reference_amount, conforme determinado pela origem de agregação.
    • O valor do agrupamento está disponível por referência com pontos no campo Moeda de FX ou usando uma API como getDisplayValue().