Vorheriges Thema: So erstellen Sie eine dynamische Tabelle

Nächstes Thema: Konfigurieren von dynamischen Tabellen


Erstellen von dynamischen Tabellen

Sie können eine dynamische Tabelle erstellen, um strukturierte Daten von einem Berichtsdatenobjekt in ein Formular einzugeben.

Gehen Sie wie folgt vor:

  1. Sie müssen das Berichtsdatenobjekt oder das API-Plug-in, das Sie zum Auffüllen der dynamische Tabelle verwenden möchten, erstellen oder bearbeiten.
  2. Beachten Sie Folgendes: Die Daten, die von den Variablen im Berichtsdatenobjekt oder im API-Plug-in zurückgegeben werden, müssen mit dem Format übereinstimmen, das für die Spalten in der Tabelle erforderlich ist. Anderenfalls werden die Daten nicht angezeigt, wenn Anwender das Formular in einem Auftrag öffnen. In späteren Schritten werden diese Anforderungen detaillierter erläutert.
  3. Bearbeiten oder erstellen Sie das Formular, in dem Sie die Tabelle hinzufügen möchten. Erweitern Sie das Formular.
  4. Gehen Sie folgendermaßen vor, um das Tabellenelement zum Formular hinzuzufügen:
    1. (Optional) Erstellen Sie einen Feldsatz, der die Tabelle enthalten soll.
    2. Erweitern Sie den Ordner "System", ziehen Sie das Tabellenelement per Drag-and-drop auf das Formular. Ziehen Sie die Tabelle gegebenenfalls auf den Feldsatz, den Sie im vorherigen Schritt erstellt haben.
    3. Geben Sie einen _id-Wert für die Tabelle an, und speichern Sie das Formular.
  5. Gehen Sie folgendermaßen vor, um das Berichtsdatenobjekt oder das API-Plug-in zur Tabelle hinzuzufügen:
    1. Wählen Sie das Tabellenelement aus.

      Die Attribute des Tabellenelements werden angezeigt.

    2. Wenn Sie ein API-Plug-in verwenden, geben Sie die Werte der folgenden Attribute an:
      • Berichts-/Plug-in-ID: Geben Sie die zu verwendende API-Plug-in-ID ein. Sie können die Werte für diese Attribute auf der Seite "Administration", "Tools", "Plugins" finden. Kopieren Sie die gewünschte Plug-in-ID von dieser Seite, und fügen Sie sie in den Wert des Attributs "Berichts-/Plug-in-ID" ein.
      • Berichts-/Plug-in-Variablen: Öffnen Sie gegebenenfalls das ausgewählte API-Plug-in, um die Details einschließlich der Variablen anzuzeigen. Auf der Seite "Details" werden im Abschnitt "Eingaben" die ID-Werte und Beschreibungen der Eingabevariablen für das Plug-in aufgelistet. Kopieren Sie die gewünschten IDs der Variablen von dieser Seite, und fügen Sie sie in den Wert des Attributs "Berichts-/Plug-in-Variablen" ein.
    3. Wenn Sie ein Berichtsdatenobjekt verwenden, geben Sie die Werte der folgenden Attribute an:
      • Berichts-/Plug-in-ID: Geben Sie die zu verwendende ID des Berichtsdatenobjekts ein. Sie können die Werte für diese Attribute auf der Seite "Administration", "Berichts-Generator", "Datenobjekte" finden. Klicken Sie auf das Symbol "Bearbeiten" des Berichtsdatenobjekts, dessen Eigenschaften Sie anzeigen möchten. Kopieren Sie die ID des Berichtsdatenobjekts von dieser Seite, und fügen Sie sie in den Wert des Attributs "Berichts-/Plug-in-ID" ein.
      • Berichts-/Plug-in-Variablen: Klicken Sie gegebenenfalls auf das Symbol "Bearbeiten" für das Berichtsdatenobjekt, das Sie ausgewählt haben, um die Eigenschaften einschließlich der Variablen anzuzeigen. Auf der Eigenschaftsseite werden die Eingabevariablen für das Berichtsdatenobjekt folgendermaßen angezeigt:

        Für eine Abfrage: Die Eingabevariable werden als %expression%-Anweisungen angezeigt.

        Für ein Plug-in: Die Eingabevariablen werden im Feld "Argumente" angezeigt.

        Für CSV: Die Eingabevariablen sind nicht relevant.

        Kopieren Sie die gewünschten Variablen von dieser Seite, und fügen Sie sie in den Wert des Attributs "Berichts-/Plug-in-Variablen" ein.

      Geben Sie für beide Attribute die Variablen als JSON-Ausdruck ein, zum Beispiel:

      	$({'<variable name>' : '<variable value>', ...})
      
      	$({'userid':_.user.id,'rm_orgunit':ca_fdGetSelectedOptionValues(ca_fd.formId,'orgunit_id')})
      

      Wichtig! Gehen Sie bei der Eingabe der Variablen vorsichtig vor. Wenn Sie keine Variablen angeben, kann dies zu unvorhersehbaren Ergebnissen führen.

    4. Speichern Sie das Formular.

    Wenn Anwender dieses Formular während dem Anfordern eines Service ausfüllen, wird das Berichtsdatenobjekt oder das API-Plug-in ausgeführt, und die von Ihnen angegebenen Daten werden zurückgegeben.

Sie haben die dynamische Tabelle erstellt. Als Nächstens konfigurieren Sie sie.