Services und Runtime-Objekt

In einer BSP-Anwendung ermöglicht das Runtime-Objekt ( runtime) den Zugriff auf laufzeit-relevante Informationen z.B. zum aktuellen Dokument (Methode get_document). Dazu zählen aber auch die Informationen, die explizit für die Visualisierung eingestellt werden müssen. Sie können über das Service-Objekt ddic_utils zum Runtime-Objekt bestimmt werden.

Die gelieferten Daten können in der BSP-Anwendung direkt genutzt werden. So kann z.B. die Werteliste aus einer einfachen Wertehilfe auf der Seite der BSP-Appliaktion visualisiert werden.

Das Service-Objekt ddic_utils stellt folgende Services zur Verfügung:

• Bestimmung von sprachabhängigen Texten (aus dem Dictionary und dem Kalender)

  • Methode GET_FIELD_LABEL für die Zuordnung des Feld-Labels.

    Siehe auch: Feld-Label

  • Methode GET_QUICKINFO liefert eine Kurzbeschreibung zu elementaren Datenobjekten mit Dictionary-Bezug.

    Siehe auch: Hilfe zur Anwendung

  • Methode GET_DAY_COLLECTION liefert im Dictionary abgelegte Tagesnamen zurück.

  • Methode GET_MONTH_COLLECTION liefert im Dictionary abgelegte Monatsnamen zurück.

• Bestimmung einer lokalen oder globalen History-ID

  • Methode GET_HISTORY_ID bestimmt eine globale History-ID.

    Siehe auch: Feld-History

  • Methode GET_LOCAL_HISTORY_ID bestimmt eine lokale History-ID.

    Siehe auch: Feld-History

• Bestimmung einer Werteliste

  • Methode GET_SIMPLE_HELPVALUES liefert eine Werteliste aus einer einfachen Wertehilfe zurück.

    Siehe auch: Wertehilfe

Der Teil der Methoden, die typspezifische Informationen aus dem Dictionary bestimmt, besitzt als Importing-Parameter eine Referenz auf ein Datenobjekt. Dieses Datenobjekt muss einen direkten oder indirekten Bezug zu einem elementaren Dictionary-Typ (Datenelement oder Komponente einer Struktur) besitzen, da die entsprechenden visualisierungsrelevanten Informationen (z.B. sprachabhängige Texte) im Dictionary bei den elementaren Dictionary-Typen definiert sind. Als aktuelles Argument kann z.B. eine Referenz auf ein Datenobjekt mit einem Bezug zu einer elementaren Komponente einer Dictionary-Struktur ( DATA: var TYPE strucname-compname) oder ein Datenobjekt mit direktem Bezug zu einem Datenelement ( DATA: var TYPE dtelname) übergeben werden.