GlideCurrencyConfig - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 11 min. de leitura

    • . GlideCurrencyConfig A API fornece métodos para recuperar várias informações de configuração para campos Moeda FX.

    Você pode adquirir informações para um campo Moeda FX específico chamando GlideCurrencyConfig (objeto ed) Construtor, que associa um campo Moeda FX específico ao objeto instanciado. Ao chamar os vários GlideCurrencyConfig() Se houver um registro na tabela Configuração da moeda FX [fx_configuration] para o campo Moeda FX, o valor solicitado será retornado. Se um registro ou campo não estiver disponível, o valor padrão será retornado. Você também pode adquirir os valores de configuração de Moeda FX padrão chamando GlideCurrencyConfig() construtor.

    Para obter informações adicionais sobre a configuração da Moeda FX, consulte Configurar e operar campos Moeda FX .

    Esta classe executada está em sn_currency namespace.

    GlideCurrencyConfig - GlideCurrencyConfig()

    Instancia um objeto GlideCurrencyConfig que permite a recuperação de informações de configuração de Moeda FX padrão global.

    Ao chamar os métodos disponíveis neste tipo de objeto GlideCurrencyConfig, os valores de retorno são os padrões globais de Moeda FX das propriedades do sistema. Se um padrão global não estiver definido nas propriedades do sistema, um padrão codificado será retornado (também pode ser um valor vazio se não estiver configurado).

    Este objeto não fornece informações de configuração para um campo Moeda FX específico. Para recuperar informações específicas do campo Moeda FX, use GlideCurrencyConfig (objeto ed) construtor.

    Para obter mais informações, consulte Definir as configurações globais de Moeda FX .

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum 
    var cur_config = new sn_currency.GlideCurrencyConfig();

    GlideCurrencyConfig - GlideCurrencyConfig(objeto ed)

    Instancia um objeto GlideCurrencyConfig que permite a recuperação das informações de configuração para um campo Moeda FX específico.

    Ao chamar os métodos disponíveis neste tipo de objeto GlideCurrencyConfig, os valores de retorno são do registro Configuração de moeda FX [fx_configuration] associado ao campo Moeda FX, se houver um registro. Se um registro não existir, os valores padrão serão retornados.

    Para obter mais informações, consulte Definir as configurações globais de Moeda FX .

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    ed GlideElementDescriptor Objeto GlideElementDescriptor do campo Moeda FX a ser associado ao objeto GlideCurrencyConfig. 
    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);

    GlideCurrencyConfig - getAggregationSource()

    Retorna o valor de origem de agregação para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do campo Origem de agregação (aggregation_source). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre origem de agregação, consulte Especifique o campo da tabela e seus parâmetros de exibição de moeda .

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Cadeia de caracteres Origem de valores para agregações. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo aggregation_source do registro fx_configuration que está associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() : Se definido, retorna o valor no campo glide.currency2.aggregation_source nas propriedades do sistema. Caso contrário, retornará um padrão codificado de referência .
    Valores possíveis:
    • padrão
    • as_entered
    • referência

    Este exemplo de código retorna a origem de agregação padrão.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_agg_source = cur_config.getAggregationSource();

    Este exemplo de código retorna a origem de agregação para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_agg_source = cur_config.getAggregationSource();

    GlideCurrencyConfig - getConversionDateSource()

    Retorna o campo usado como a origem da data e hora da conversão da moeda.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do campo Origem da data de conversão (conversion_date_source). Caso contrário, se for um novo registro, retornará "nulo".

    Para obter mais informações sobre o campo Origem da data de conversão, consulte Identifique a tabela de taxas e a origem da data para conversões de moeda .

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres Campo no registro usado como origem da data de conversão. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo conversion_date_source do registro fx_configuration que está associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() Retorna nulo .

    Este exemplo de código retorna a origem da data de conversão para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_conv_date_src = cur_config.getConversionDateSource();

    GlideCurrencyConfig - getDisplayDigits()

    Retorna o número de dígitos a serem exibidos para um campo Moeda FX.

    Se chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do campo Dígitos de exibição (display_digits). Caso contrário, se for um novo registro, retornará um valor padrão.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Número Número de dígitos a serem exibidos para o campo Moeda FX. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o valor do campo display_digits no registro Configuração de moeda FX [fx_configuration] que está associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() : Se definido, retorna o valor da propriedade glide.currency2.display_digits nas propriedades do sistema. Caso contrário, retorna -1 .

    Este exemplo de código retorna o número padrão de dígitos de exibição.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_display_digits = cur_config.getDisplayDigits();

    Este exemplo de código retorna os dígitos de exibição de um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_display_digits = cur_config.getDisplayDigits();

    GlideCurrencyConfig - getDisplayValue()

    Retorna o código da moeda usado para converter o valor da moeda FX quando ele aparece em listas e relatórios.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do campo Moeda de valor de exibição (display_value). Caso contrário, se for um novo registro, retornará um valor padrão.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres Código da moeda a ser usado para exibir o campo Moeda FX. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo display_value, que contém o código da moeda, do registro fx_configuration associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() : Se definido, retorna o valor da propriedade glide.currency2.display_value nas propriedades do sistema. Caso contrário, retorna as_entered .
    Valores possíveis:
    • Padrão: Padrão global. Este é o valor na propriedade glide.currency2.display_digits.
    • As_entered: Valor da moeda conforme inserido pelo usuário.
    • In_session_currency: Valor da moeda convertido para a moeda da sessão. A moeda da sessão é baseada na localidade do usuário.
    • In_reference_currency: Valor de referência se calculado e armazenado. Caso contrário, o valor da moeda convertido para a moeda de referência.

    Este exemplo de código retorna o código da moeda padrão.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_display_value = cur_config.getDisplayValue();

    Este exemplo de código retorna o código da moeda de exibição para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_display_value = cur_config.getDisplayValue();

    GlideCurrencyConfig - getRateFilterRateTableField()

    Retorna o campo da tabela de taxas usado como um filtro de tabela de taxas para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do Campo Tabela de taxas (rate_filter_rate_table_field). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre filtros da tabela de taxas, consulte Selecione os campos da tabela de taxa e meta usados para filtragem .

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres Campo na tabela de taxas usado para filtrar os registros da tabela de taxas. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará rate_filter_rate_table_field do registro fx_configuration associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() Retorna nulo .

    Este exemplo de código retorna o campo da tabela de taxas usado para filtrar registros da tabela de taxas para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getRateFilterRateTableField();

    GlideCurrencyConfig - getRateFilterTargetTableField()

    Retorna o campo da tabela de destino usado para filtrar os registros da tabela de taxas para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do Campo da tabela de destino (rate_filter_target_table_field). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre filtros da tabela de taxas, consulte Selecione os campos da tabela de taxa e meta usados para filtragem .

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres Campo na tabela de destino usado/a ser usado para filtrar a tabela de taxas. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará rate_filter_target_table_field do registro fx_configuration associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() Retorna nulo .

    Este exemplo de código retorna o filtro de taxa padrão, campo de tabela de destino.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_rate_filter = cur_config.getRateFilterTargetTableField();

    Este exemplo de código retorna o filtro de taxa, o campo da tabela de destino para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_rate_filter = cur_config.getRateFilterTargetTableField();

    GlideCurrencyConfig - getRateTable()

    Retorna a tabela de taxas usada para converter moeda para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do Campo Tabela de taxas (rate_filter_rate_table_field). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre tabelas de taxas de câmbio, consulte Identifique a tabela de taxas e a origem da data para conversões de moeda .

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome da tabela de taxas usada para executar a conversão da moeda. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo rate_table_field do registro fx_configuration que está associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() : Se definido, retorna o valor da propriedade glide.currency2.system_rate_table das propriedades do sistema. Caso contrário, retorna fx_system_rate .

    Retorna a tabela de taxas padrão.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_rate_table = cur_config.getRateTable();

    Retorna a tabela de taxas usada para um campo Moeda de FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_rate_table = cur_config.getRateTable();

    GlideCurrencyConfig - getReferenceCurrency()

    Retorna a moeda de referência para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor do campo Moeda de referência (reference_currency). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre a moeda de referência, consulte Defina a moeda de referência .

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres Moeda de referência como um código de moeda ISO. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo reference_currency do registro fx_configuration associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() : Se definido, retorna o valor da propriedade do sistema glide.currency2.default_reference_currency. Caso contrário, o método aplicará as seguintes regras, na ordem especificada, para determinar o código da moeda de referência:
      • Se a propriedade do sistema glide.system.reference_currency estiver definida como verdadeira, usará o valor na propriedade do sistema glide.system.reference_currency.code.
      • O valor na propriedade do sistema glide.system.locale (que implica uma moeda).
      • Localidade padrão da Java Virtual Machine na qual a instância está em execução.

    Este exemplo de código retorna a moeda de referência padrão.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_reference_currency = cur_config.getReferenceCurrency();

    Este exemplo de código retorna a moeda de referência para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getReferenceCurrency();

    GlideCurrencyConfig - getReferenceCurrencySource()

    Retorna a origem da moeda de referência para um campo Moeda FX.

    Se for chamado em um campo Moeda FX existente que tenha um registro Configuração de moeda FX correspondente [fx_configuration], retornará o valor (caminho de referência com pontos) do campo Origem da moeda de referência (reference_currency_source). Caso contrário, se for um novo registro, retornará um valor padrão.

    Para obter mais informações sobre a origem da moeda de referência, consulte Defina a moeda de referência .

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    Tipo Descrição
    Cadeia de caracteres Caminho de referência com pontos do campo usado/a ser usado como moeda de referência. O valor retornado depende do construtor usado para instanciar o objeto.
    • GlideCurrencyConfig (objeto ed) : Se existir um registro fx_configuration, retornará o campo reference_currency_source do registro fx_configuration que está associado ao campo Moeda FX especificado pelo GlideElementDescriptor passado no construtor. Se não houver registro fx_configuration, seguirá GlideCurrencyConfig() regras.
    • GlideCurrencyConfig() Retorna nulo .

    Este exemplo de código retorna a origem da moeda de referência padrão.

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_reference_currency = cur_config.getReferenceCurrencySource();

    Este exemplo de código retorna a origem da moeda de referência para um campo Moeda FX específico.

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getReferenceCurrencySource();