Valores de moeda FX em listas e relatórios

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 dos campos Moeda FX são, por padrão, valores de moeda de referência.

    Valores da moeda FX nas exibições de lista

    Em listas, os valores de moeda FX aparecem como uma cadeia de caracteres de moeda formatada retornada de ObDisplayValue() .
    Para um campo Moeda FX que depende de outro campo Moeda FX, o valor da moeda vem do registro 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 da moeda FX.
    Nota:
    Um campo Moeda FX em uma tabela personalizada é um campo de referência que armazena a referência (sys_id) no 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 Moeda FX. As moedas de referência não são consideradas quando você filtra uma lista. Portanto, se a lista não filtrada contiver entradas de campo Moeda FX em várias moedas, uma lista filtrada conteria somente os registros inseridos originalmente usando a moeda de filtragem especificada.
    • Por exemplo, se você inseriu um valor de moeda em euros (EUR) e a moeda de referência for dólares americanos (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 moeda, o valor da moeda, inserido originalmente em euros, não será exibido. Nesse caso, somente os valores de moeda inseridos originalmente em USD seriam exibidos.

    Campos Moeda FX dependente

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

    Ao criar um campo Moeda FX, você pode marcá-lo como dependente de outro campo Moeda FX. Marcar um campo 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 moeda diferente. As mudanças feitas no campo dependente não afetam o campo Moeda FX original.

    Moeda de FX, agregação e agrupar por

    Você pode selecionar campos Moeda FX para inclusão em relatórios e eles são exibidos da mesma maneira que nas exibições de lista.
    • Os campos Moeda FX aparecem como uma cadeia de caracteres de moeda formatada retornada de ObDisplayValue() .
    • Se você definir Moeda do valor de exibição campo 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 executa o relatório é 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 ServiceNow AI Platform®:

    Tabela 1. Valor da moeda FX agregado
    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 Custo O campo em um registro de transação é um campo Moeda FX, que você pode agrupar por cost.amountou cost.currency.
    • As operações de agregação, como SOMA, são traduzidas como SOMA (valor) ou SOMA(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 moeda de referência única que está associada a todos os valores de moeda no agrupamento.

    • Se houver moedas diferentes associadas a valores de moeda no agrupamento, o valor agregado estará vazio. Por exemplo, se alguns dos valores da moeda estiverem em dólares americanos, alguns estiverem em euros e outros em ienes, o valor agregado estará vazio.
    Você também pode usar um comando Agrupar por nos campos 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 ObDisplayValue() .