GlideCurrencyConfig – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 GlideCurrencyConfig(Object ed)-Konstruktor aufrufen, der dem instanziierten Objekt ein bestimmtes FX-Währungsfeld zuordnet. Wenn beim Aufruf der verschiedenen GlideCurrencyConfig() -Methoden ein Datensatz in der Tabelle „FX-Währungskonfiguration“ [fx_configuration] für das Feld „FX-Währung“ 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 standardmäßigen FX-Währungskonfigurationswerte auch abrufen, indem Sie den GlideCurrencyConfig()- Konstruktor aufrufen.

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

    Diese Klasse wird im Namespace sn_currency ausgeführt.

    GlideCurrencyConfig – getAggregationSource()

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

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert des Felds „Zusammenfassungsquelle“ (aggregation_source) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

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

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. 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 vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert im Feld glide.currency2.aggregation_source in den Systemeigenschaften zurückgegeben. Andernfalls wird ein hartcodierter Standardwert der Referenzzurückgegeben.
    Mögliche Werte:
    • Standard
    • as_entered
    • Referenz

    In diesem Codebeispiel wird die standardmäßige Zusammenfassungsquelle zurückgegeben.

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

    In diesem Codebeispiel wird die Zusammenfassungsquelle 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_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.

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert des Felds „Konvertierungsdatumsquelle“ (conversion_date_source) zurückgegeben. Andernfalls wird bei einem neuen Datensatz „null“ zurückgegeben.

    Weitere Informationen zum Feld „Datumsquelle der Umrechnung“ finden Sie unter Identifizieren der Kurstabelle und der Datumsquelle für Währungsumrechnungen.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. 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 vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • 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.

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert des Felds „Anzeigeziffern“ (display_digits) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der für das FX-Währungsfeld anzuzeigenden Stellen. 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 FX-Währungskonfigurations-Datensatz [fx_configuration] zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft glide.currency2.display_digits in den Systemeigenschaften zurückgegeben. Andernfalls wird -1zurückgegeben.

    In diesem Codebeispiel wird die Standardanzahl der Anzeigeziffern zurückgegeben.

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

    In diesem Codebeispiel werden die Anzeigeziffern 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_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.

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert des Felds „Währung des Anzeigewerts“ (display_value) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Währungscode, der zum Anzeigen des Felds „FX-Währung“ verwendet werden soll. 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 vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft glide.currency2.display_value in den Systemeigenschaften zurückgegeben. Andernfalls wird as_entered zurückgegeben.
    Mögliche Werte:
    • Standard: Globaler Standard. Dies ist der Wert in der Eigenschaft glide.currency2.display_digits.
    • as_entered: Währungswert, wie vom Benutzer eingegeben.
    • in_session_currency: Währungswert, der in die Sitzungswährung konvertiert wird. 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.

    In diesem Codebeispiel wird der Standardwährungscode zurückgegeben.

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

    In diesem Code-Beispiel wird der Anzeigewährungscode 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_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 mit einem entsprechenden FX-Währungskonfigurationsdatensatz [fx_configuration] wird der Wert des Kurstabellenfelds (rate_filter_rate_table_field) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

    Weitere Informationen zu Ratentabellenfiltern finden Sie unter Zum Filtern verwendete Raten- und Zieltabellenfelder auswählen.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld in der Ratentabelle, das zum Filtern der Datensätze 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_rate_table_field“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Gibt NULLzurück.

    In diesem Codebeispiel wird das Ratentabellenfeld zurückgegeben, das zum Filtern von Ratentabellendatensätzen für ein bestimmtes 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 Ratentabellendatensätze für ein FX-Währungsfeld verwendet wird.

    Bei Aufruf für ein vorhandenes FX-Währungsfeld mit einem entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] wird der Wert des Zieltabellenfelds (rate_filter_target_table_field) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

    Weitere Informationen zu Ratentabellenfiltern finden Sie unter Zum Filtern verwendete Raten- und Zieltabellenfelder auswählen.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. 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 rate_filter_target_table_field aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Gibt NULLzurück.

    In diesem Codebeispiel wird der Standardratenfilter im Zieltabellenfeld zurückgegeben.

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

    In diesem Codebeispiel wird das Feld „Ratenfilter, Zieltabelle“ 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_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 mit einem entsprechenden FX-Währungskonfigurationsdatensatz [fx_configuration] wird der Wert des Kurstabellenfelds (rate_filter_rate_table_field) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

    Weitere Informationen zu FX-Währungskurstabellen finden Sie unter Kurstabelle und Datumsquelle für Währungsumrechnungen identifizieren.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Kurstabelle, die für die Währungsumrechnung 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_table_field“ aus dem fx_configuration-Datensatz zurückgegeben, der dem FX-Währungsfeld zugeordnet ist, das vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Wenn festgelegt, wird der Wert der Eigenschaft glide.currency2.system_rate_table aus den Systemeigenschaften zurückgegeben. Andernfalls wird fx_system_rate zurü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.

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert des Referenzwährungsfelds (reference_currency) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

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

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. 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 vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • 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, verwendet den Wert in der Systemeigenschaft glide.system.reference_currency.code.
      • Der Wert in der Systemeigenschaft glide.system.locale (der eine Währung impliziert).
      • Standardgebietsschema der Java Virtual Machine, auf der die Instanz ausgeführt wird.

    In diesem Codebeispiel wird die Standardreferenzwährung zurückgegeben.

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

    In diesem Codebeispiel wird die Referenzwährung 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_reference_currency = cur_config.getReferenceCurrency();

    GlideCurrencyConfig – getReferenceCurrencySource()

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

    Wenn es für ein vorhandenes FX-Währungsfeld aufgerufen wird, das über einen entsprechenden FX-Währungskonfigurations-Datensatz [fx_configuration] verfügt, wird der Wert (Dot-Walk-Pfad) des Felds „Referenzwährungsquelle“ (reference_currency_source) zurückgegeben. Andernfalls, wenn ein neuer Datensatz vorhanden ist, wird ein Standardwert zurückgegeben.

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

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. 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 vom im Konstruktor übergebenen GlideElementDescriptor angegeben wird. Wenn kein fx_configuration-Datensatz vorhanden ist, folgt den GlideCurrencyConfig()- Regeln.
    • GlideCurrencyConfig(): Gibt NULLzurück.

    In diesem Codebeispiel wird die Standardreferenzwährungsquelle zurückgegeben.

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

    In diesem Codebeispiel wird die Referenzwährungsquelle 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_reference_currency = cur_config.getReferenceCurrencySource();

    GlideCurrencyConfig – GlideCurrencyConfig()

    Instantiiert ein GlideCurrencyConfig-Objekt, das das Abrufen von globalen Standard-FX-Währungskonfigurationsinformationen ermöglicht.

    Beim Aufruf 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 nicht konfiguriert).

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

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

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

    GlideCurrencyConfig – GlideCurrencyConfig(Object ed)

    Instanziiert ein GlideCurrencyConfig-Objekt, das das Abrufen 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 der FX-Währungskonfiguration [fx_configuration], der dem Feld „FX-Währung“ zugeordnet ist, falls 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 : 20. Parameter
    Name Typ Beschreibung
    Hrsg GlideElementDescriptor GlideElementDescriptor-Objekt des FX-Währungsfelds, 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);