Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Connectors can be created by using the CSV and JSON files in order to access the data of these files.
In the following, we will give an example to create a connector from the CSV file “Suppliers” which contains supplier information such as name, code, and industry.

Creating a new connector

From CSV File

In order to create a connector, please open the page Connector under the Design. The connector will be available to use in the Smartform after necessary configuration.

...

Connector can be created via plus sign or directly with the File button:

...

The configuration page allows you to enter the desired connector name. The type of the file can be entered as CSV or JSON.

Note

XLS and XLSX is not available at the moment.

After choosing the type, the file can be uploaded using the Upload file(s) button. Header and CSV-separator information should be provided.

...

After clicking the Save button, the connector will be saved and the “Testing” area will be available.

...

You can test the connector by clicking the “Execute connector” button.

...

From JSON File

You can easily upload a JSON file after filling the name of the connector and choosing the JSON file type:

...

Using the connector in the smartform

Custom connectors can be used in the smartform. In our example, we have created a connector for supplier information. In order to show the supplier list in the “Select” element of the smartform, “Connections” section should be opened on the left-hand side. The label and the value will be selected from the headers of the CSV file, which contain different information of suppliers.

...

Konnektoren können mithilfe der CSV- und JSON-Dateien erstellt werden, um auf die Daten dieser Dateien zuzugreifen.
Im Folgenden geben wir ein Beispiel zum Erstellen eines Konnektors aus der CSV-Datei "Lieferanten", der Lieferanteninformationen wie Name, Code und Branche enthält.

...

Erstellen eines neuen Konnektors

Aus CSV-Datei

Um einen Konnektor zu erstellen, öffnen Sie bitte die Seite Konnektor unter dem Design. Der Konnektor steht nach der erforderlichen Konfiguration im Smartform zur Verfügung.

...

Der Konnektor kann per Pluszeichen oder direkt mit der Schaltfläche Datei erstellt werden:

...

Auf der Konfigurationsseite können Sie den gewünschten Konnektornamen eingeben. Der Dateityp kann als CSV oder JSON eingegeben werden.

Note

XLS und XLSX ist derzeit nicht verfügbar.

Nachdem Sie den Typ ausgewählt haben, kann die Datei über die Schaltfläche Datei(en) hochladen hochgeladen werden. Kopfzeilen- und CSV-Trennzeicheninformationen sollten angegeben werden.

...

Nach einem Klick auf die Schaltfläche Speichern wird der Konnektor gespeichert und der Bereich "Testen" steht zur Verfügung.

...

Sie können den Konnektor testen, indem Sie auf die Schaltfläche "Konnektor ausführen" klicken.

...

...

Aus JSON-Datei

Sie können ganz einfach eine JSON-Datei hochladen, nachdem Sie den Namen des Konnektors eingegeben und den JSON-Dateityp ausgewählt haben:

...

Verwenden des Konnektors im Smartformular

Benutzerdefinierte Konnektoren können im Smartformular verwendet werden. In unserem Beispiel haben wir einen Konnektor für Lieferanteninformationen erstellt. Um die Lieferantenliste im Element "Auswählen" des Smartforms anzuzeigen, sollte auf der linken Seite der Bereich "Verbindungen" geöffnet werden. Das Label und der Wert werden aus den Kopfzeilen der CSV-Datei ausgewählt, die unterschiedliche Informationen von Lieferanten enthalten.

Info

Spaltennamen des Lieferantendokuments, die wir in diesem Beispiel wie folgt verwenden:
Customer_Code, Name, Symbol, IndustryBranche, Last updateLetzte Aktualisierung, LocationStandort, StateBundesland, RevenueUmsatz, ISIN

...

Parameter

DescriptionBeschreibung

ExampleBeispiel

Connection Anschluss 1

Custom connectors can be reached via this drop-down list.

Suppliers

JSON Path: label

This area determines the parameter which should be shown in the smartform drop-down listBenutzerdefinierte Konnektoren können über diese Dropdown-Liste erreicht werden.

Lieferanten

JSON-Pfad: label

Dieser Bereich bestimmt den Parameter, der in der Smartform-Dropdown-Liste angezeigt werden soll.

$[*]. Name

JSON Path-Pfad: valueThis area determines the parameter which will be stored in the databaseWert

Dieser Bereich bestimmt den Parameter, der in der Datenbank gespeichert wird.

$[*]. Customer_Code

Info

The names of the suppliers will be shown in the dropdown list of the smartform, but the code of the supplier will be stored in the database when the user selects the supplier nameDie Namen der Lieferanten werden in der Dropdown-Liste des Smartformulars angezeigt, aber der Code des Lieferanten wird in der Datenbank gespeichert, wenn der Benutzer den Lieferantennamen auswählt.

Info

Die Syntax for JSON path starts with a $ signfür den JSON-Pfad beginnt mit einem $ Zeichen. [*] means all rows should be included. The last part after . specifies the column name which the data will be derived.
Blank space should be avoided from the column names to reach the information via JSON.
Customer Code bedeutet, dass alle Zeilen eingeschlossen werden sollten. Der letzte Teil danach . Gibt den Spaltennamen an, von dem die Daten abgeleitet werden.
Leerzeichen aus den Spaltennamen sollten vermieden werden, um die Informationen über JSON zu erreichen.
Kundencode → Customer_Code