--- sourceDocument: Yokohama Administração da Now Platform sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Administração da Now Platform ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Valores de moeda FX em listas e relatórios # Valores de moeda FX em listas e relatórios {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 de moeda FX nas exibições de lista {#fx-currency-values-lists-reports__section_evs_ng5_tjb} Nas listas, os valores de Moeda FX aparecem como uma cadeia de caracteres de moeda formatada retornada de ObDisplayValue() . * As configurações no Dígitos de exibição e. Moeda do valor de exibição campos em Localização do SistemaConfiguração da Moeda FX determine como os valores de moeda aparecem nas listas. * Para saber mais, consulte [Identifique o campo Moeda FX e seus parâmetros de exibição](https://servicenow-prod.fluidtopics.net/P~DYNrC8hFFFXFkOELpWYg "Especifique a tabela e o campo na tabela (por exemplo, Custo) ao qual a configuração de Moeda FX se aplica. Em seguida, selecione a precisão decimal e os parâmetros de exibição da moeda para o campo."). {#fx-currency-values-lists-reports__ul_x5c_jxv_pkb} 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 SistemaConfiguraçã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. Comprimento máximo Da coluna Moeda FX deve ser 32 (padrão). ## Filtrando valores de moeda FX em listas {#fx-currency-values-lists-reports__section_t3v_gcx_zjb} 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, originalmente inserido em euros, não aparecerá. Nesse caso, somente os valores de moeda originalmente inseridos em USD seriam exibidos. {#fx-currency-values-lists-reports__ul_d33_gvt_1kb} ## Campos Moeda FX dependente {#fx-currency-values-lists-reports__section_zf4_ntt_1kb} 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 SistemaConfiguraçã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](https://servicenow-prod.fluidtopics.net/WLrfSkzziODo4tmOqaiArA "Depois de estabelecer padrões de moeda global, você pode criar configurações personalizadas de Moeda FX para campos de tabela específicos. Identifique os campos da tabela que usam Moeda FX e defina como os cálculos de conversão de moeda devem ser realizados, exibidos, filtrados e agregados."). 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 FX, agregação e agrupar por {#fx-currency-values-lists-reports__section_x1q_pg5_tjb} 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 SistemaTodas 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. {#fx-currency-values-lists-reports__ul_c2h_cdq_5jb} 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®: {#fx-currency-values-lists-reports__table_wnw_24t_1mb__entry__2} | 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 (;). | [Tabela 1. Valor agregado da moeda FX] {#fx-currency-values-lists-reports__table_wnw_24t_1mb} 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. {#fx-currency-values-lists-reports__ul_kfh_xcq_5jb} 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 meio de referência com pontos no campo Moeda FX ou usando uma API como `ObDisplayValue() `. {#fx-currency-values-lists-reports__ul_l2y_yrm_1kb} **Conceitos relacionados** * [Configurando o comportamento do campo Moeda FX](https://servicenow-prod.fluidtopics.net/WLrfSkzziODo4tmOqaiArA "Depois de estabelecer padrões de moeda global, você pode criar configurações personalizadas de Moeda FX para campos de tabela específicos. Identifique os campos da tabela que usam Moeda FX e defina como os cálculos de conversão de moeda devem ser realizados, exibidos, filtrados e agregados.") **Tarefas relacionadas** * [Definindo as configurações globais de Moeda FX](https://servicenow-prod.fluidtopics.net/9pFlhoqWxvfDG409c2dhyA "Antes de configurar e usar Moeda FX, revise as propriedades do sistema relacionadas para confirmar ou modificar seu comportamento padrão.")