GlideCurrencyConfig : Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 10 Minuten Lesedauer

    • Die GlideCurrencyConfig -API bietet Methoden zum Abrufen verschiedener Konfigurationsinformationen für FX-Währungsfelder.

    Sie können Informationen für ein bestimmtes FX-Währungsfeld abrufen, indem Sie den Konstruktor „GlideCurrencyConfig(Object ed)“ aufrufen, der dem instanziierten Objekt ein bestimmtes FX-Währungsfeld zuordnet. Wenn beim Aufrufen der verschiedenen GlideCurrencyConfig()- Methoden in der Tabelle „FX-Währungskonfiguration“ [fx_configuration] für das Feld „FX-Währung“ ein Datensatz vorhanden ist, wird der angeforderte Wert zurückgegeben. Wenn ein Datensatz oder ein Feld nicht verfügbar ist, wird der Standardwert zurückgegeben. Sie können die Standardwerte für die FX-Währungskonfiguration auch abrufen, indem Sie den GlideCurrencyConfig()- Konstruktor aufrufen.

    Weitere Informationen zur Konfiguration der FX-Währung finden Sie unter FX-Währungsfelder einrichten und verwenden.

    Diese Klasse wird im Namespace sn_currency ausgeführt.

    GlideCurrencyConfig: GlideCurrencyConfig()

    Instanziiert ein GlideCurrencyConfig-Objekt, das den Abruf von globalen Standard-FX-Währungskonfigurationsinformationen ermöglicht.

    Beim Aufrufen der verfügbaren Methoden für diesen Typ von GlideCurrencyConfig-Objekt sind die Rückgabewerte die globalen Standardwerte für FX-Währung aus den Systemeigenschaften. Wenn in den Systemeigenschaften kein globaler Standard definiert ist, wird ein hartcodierter Standard zurückgegeben (dies kann auch ein leerer Wert sein, wenn er nicht konfiguriert ist).

    Dieses Objekt enthält keine Konfigurationsinformationen für ein bestimmtes FX-Währungsfeld. Um bestimmte Informationen im Feld „FX-Währung“ abzurufen, verwenden Sie den Konstruktor „GlideCurrencyConfig(Object ed)“.

    Weitere Informationen finden Sie unter Globale Einstellungen für FX-Währung konfigurieren.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    var cur_config = new sn_currency.GlideCurrencyConfig();

    GlideCurrencyConfig: GlideCurrencyConfig(Object ed)

    Instanziiert ein GlideCurrencyConfig-Objekt, das den Abruf der Konfigurationsinformationen für ein bestimmtes FX-Währungsfeld ermöglicht.

    Beim Aufruf der verfügbaren Methoden für diesen Typ von GlideCurrencyConfig-Objekt stammen die Rückgabewerte aus dem Datensatz „FX-Währungskonfiguration“ [fx_configuration], der dem Feld „FX-Währung“ zugeordnet ist, sofern ein Datensatz vorhanden ist. Wenn ein Datensatz nicht vorhanden ist, werden Standardwerte zurückgegeben.

    Weitere Informationen finden Sie unter Globale Einstellungen für FX-Währung konfigurieren.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Hrsg GlideElementDescriptor GlideElementDescriptor-Objekt des Felds „FX-Währung“, das dem GlideCurrencyConfig-Objekt zugeordnet werden soll. 
    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()

    Gibt den Zusammenfassungsquellwert für ein FX-Währungsfeld zurück.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld mit einem entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] gibt den Wert des Felds „Zusammenfassungsquelle“ (aggregation_source) zurück. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zur Zusammenfassungsquelle finden Sie unter Tabellenfeld und seine Währungsanzeigeparameter angeben.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Quelle der Werte für Zusammenfassungen. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „aggregation_source“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert im Feld „glide.currency2.aggregation_source“ in den Systemeigenschaften zurückgegeben. Andernfalls gibt den hartcodierten Standardwert der Referenzzurück.
    Mögliche Werte:
    • Standard
    • as_entered
    • Referenz

    Dieses Codebeispiel gibt die Standard-Zusammenfassungsquelle zurück.

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

    Dieses Codebeispiel gibt die Zusammenfassungsquelle für ein bestimmtes FX-Währungsfeld zurück.

    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()

    Gibt das Feld zurück, das als Quelle für Datum und Uhrzeit für die Währungsumrechnung verwendet wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, wird der Wert des Felds „Quelle des Konvertierungsdatums“ (conversion_date_source) zurückgegeben. Andernfalls wird bei einem neuen Datensatz „null“ zurückgegeben.

    Weitere Informationen zum Feld „Umrechnungsdatumsquelle“ finden Sie unter Kurstabelle und Datumsquelle für Währungsumrechnungen identifizieren.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld im Datensatz, das als Konvertierungsdatumsquelle verwendet wird. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „conversion_date_source“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Gibt nullzurück.

    In diesem Codebeispiel wird die Konvertierungsdatumsquelle für ein bestimmtes FX-Währungsfeld zurückgegeben.

    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()

    Gibt die Anzahl der Stellen zurück, die für ein FX-Währungsfeld angezeigt werden sollen.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, gibt den Wert des Felds „Anzeigeziffern“ (display_digits) zurück. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der Stellen, die für das Feld „FX-Währung“ angezeigt werden sollen. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird der Wert des Felds „display_digits“ im Datensatz „FX-Währungskonfiguration“ [fx_configuration] zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wurde. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft „glide.currency2.display_digits“ in den Systemeigenschaften zurückgegeben. Andernfalls wird -1zurückgegeben.

    Dieses Codebeispiel gibt die Standardanzahl der Anzeigeziffern zurück.

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

    Dieses Codebeispiel gibt die Anzeigeziffern für ein bestimmtes FX-Währungsfeld zurück.

    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()

    Gibt den Währungscode zurück, der zum Konvertieren des FX-Währungswerts verwendet wird, wenn er in Listen und Berichten angezeigt wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, gibt den Wert des Felds „Währung des Anzeigewerts“ (display_value) zurück. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Währungscode für die Anzeige des Felds „FX-Währung“. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „display_value“ zurückgegeben, das den Währungscode aus dem fx_configuration-Datensatz enthält, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft „glide.currency2.display_value“ in den Systemeigenschaften zurückgegeben. Andernfalls wird as_enteredzurückgegeben.
    Mögliche Werte:
    • Standard: Globaler Standard. Dies ist der Wert in der Eigenschaft glide.currency2.display_digits.
    • as_entered: Währungswert wie vom Anwender eingegeben.
    • in_session_currency: In die Sitzungswährung konvertierter Währungswert. Die Sitzungswährung basiert auf dem Gebietsschema des Benutzers.
    • in_reference_currency: Referenzwert, falls berechnet und gespeichert. Andernfalls wird der Währungswert in die Referenzwährung konvertiert.

    Dieses Codebeispiel gibt den Standardwährungscode zurück.

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

    Dieses Codebeispiel gibt den Anzeigewährungscode für ein bestimmtes FX-Währungsfeld zurück.

    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()

    Gibt das Ratentabellenfeld zurück, das als Ratentabellenfilter für ein FX-Währungsfeld verwendet wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, wird der Wert des Kurstabellenfelds (rate_filter_rate_table_field) zurückgegeben. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zu Ratentabellenfiltern finden Sie unter Die für die Filterung verwendeten Raten- und Zieltabellenfelder auswählen.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld in der Kostentabelle, das zum Filtern der Datensätze der Kostentabelle verwendet wird. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „rate_filter_rate_table_field“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Gibt nullzurück.

    In diesem Codebeispiel wird das Kurstabellenfeld zurückgegeben, das zum Filtern von Kurstabellendatensätzen nach einem bestimmten FX-Währungsfeld verwendet wird.

    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()

    Gibt das Zieltabellenfeld zurück, das zum Filtern der Ratentabellen-Datensätze für ein FX-Währungsfeld verwendet wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld mit einem entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] wird der Wert des Zieltabellenfelds (rate_filter_target_table_field) zurückgegeben. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zu Ratentabellenfiltern finden Sie unter Die für die Filterung verwendeten Raten- und Zieltabellenfelder auswählen.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld in der Zieltabelle, das zum Filtern der Ratentabelle verwendet wird. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „rate_filter_target_table_field“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Gibt nullzurück.

    In diesem Codebeispiel wird das Zieltabellenfeld des Standardratenfilters zurückgegeben.

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

    Dieses Codebeispiel gibt den Ratenfilter, das Zieltabellenfeld für ein bestimmtes FX-Währungsfeld zurück.

    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()

    Gibt die Kurstabelle zurück, die zum Konvertieren der Währung für ein FX-Währungsfeld verwendet wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, wird der Wert des Kurstabellenfelds (rate_filter_rate_table_field) zurückgegeben. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zu Wechselkurstabellen für Wechselkurse finden Sie unter Kurstabelle und Datumsquelle für Währungsumrechnungen identifizieren.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Kurstabelle für die Währungsumrechnung. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld „rate_table_field“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft „glide.currency2.system_rate_table“ aus den Systemeigenschaften zurückgegeben. Andernfalls wird fx_system_ratezurückgegeben.

    Gibt die Standardratentabelle zurück.

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

    Gibt die Kurstabelle zurück, die für ein bestimmtes FX-Währungsfeld verwendet wird.

    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()

    Gibt die Referenzwährung für ein FX-Währungsfeld zurück.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld, das einen entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] enthält, gibt den Wert des Felds „Referenzwährung“ (reference_currency) zurück. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zur Bezugswährung finden Sie unter Bezugswährung festlegen.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Referenzwährung als ISO-Währungscode. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld reference_currency aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Systemeigenschaft „glide.currency2.default_reference_currency“ zurückgegeben. Andernfalls wendet die Methode die folgenden Regeln in der angegebenen Reihenfolge an, um den Referenzwährungscode zu bestimmen:
      • Wenn die Systemeigenschaft „glide.system.reference_currency“ auf „true“ festgelegt ist, wird der Wert in der Systemeigenschaft „glide.system.reference_currency.code“ verwendet.
      • Der Wert in der Systemeigenschaft „glide.system.locale“ (die eine Währung impliziert).
      • Standardgebietsschema der Java Virtual Machine, auf der die Instanz ausgeführt wird.

    Dieses Codebeispiel gibt die Standardreferenzwährung zurück.

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

    Dieses Codebeispiel gibt die Referenzwährung für ein bestimmtes FX-Währungsfeld zurück.

    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()

    Gibt die Bezugswährungsquelle für ein FX-Währungsfeld zurück.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld mit einem entsprechenden Datensatz für die FX-Währungskonfiguration [fx_configuration] gibt den Wert (Dot-Walking-Pfad) des Felds „Quelle der Referenzwährung“ (reference_currency_source) zurück. Andernfalls wird bei einem neuen Datensatz ein Standardwert zurückgegeben.

    Weitere Informationen zur Bezugswährungsquelle finden Sie unter Bezugswährung festlegen.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Dot-Walk-Pfad des Felds, das als Referenzwährung verwendet wird. Der zurückgegebene Wert hängt vom Konstruktor ab, der zum Instanziieren des Objekts verwendet wird.
    • GlideCurrencyConfig(Object ed): Wenn ein fx_configuration-Datensatz vorhanden ist, wird das Feld reference_currency_source aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das durch den im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, werden die GlideCurrencyConfig()- Regeln befolgt.
    • GlideCurrencyConfig(): Gibt nullzurück.

    Dieses Codebeispiel gibt die standardmäßige Bezugswährungsquelle zurück.

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

    Dieses Codebeispiel gibt die Bezugswährungsquelle für ein bestimmtes FX-Währungsfeld zurück.

    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();