Integrationen ermöglichen die Erstellung von Schnittstellen zu anderen Systemen oder Applikationen.
Unterstützte Typen
Folgende Typen werden unterstützt.
| Datenbank Rohdaten-Import | Dieser Typ ermöglicht den direkten Import von Daten aus einer Datenbank in die Cameleon-Datenbank. Die Workflow-Engine von Cameleon wird nicht berücksichtigt. Zu den Anwendungsfällen zählt zum Beispiel der Import in eine Cameleon-Zwischentabelle zur weiteren Verarbeitung direkt in Cameleon. Unterstützte Quellen: Micrsoft SQL-Datenbank |
| LDAP Rohdaten-Import (verfügbar ab Version 1.6.5) | Dieser Typ ermöglicht den direkten Import aus einem Verzeichnis mittels LDAP. Die Workflow-Engine von Cameleon wird bei der Ausführung nicht berücksichtigt. Zu den Anwendungsfällen zählt zum Beispiel der Import in eine Cameleon-Zwischentabelle zur weiteren Verarbeitung direkt in Cameleon. |
| REST-API (verfügbar ab Version 1.6.6) | Dieser Typ ermöglicht den direkten Import über GET-Webservices. |
Das Mapping von Multiselect-Feldern wird momentan nur in Datenbank-Rohdaten-Importen unterstützt.
Eine Integration erstellen
- Öffnen Sie im Hauptmenü “Integrationen” > Integration Designer
- Klicken Sie auf den Button “Neu”
- Füllen Sie die erforderlichen Felder aus
- Klicken Sie auf den Button “Hinzufügen”, um den Datensatz zu erstellen
Eine Integration bearbeiten
- Öffnen Sie im Hauptmenü “Integrationen” > Integration Designer
- Wählen Sie das gewünschte Element aus der Liste aus
- Führen Sie die gewünschte Änderung durch und klicken Sie anschließend auf “Speichern”
Datenbank Rohdaten-Import
Für diese Integration ist die Erstellung eines Endpunkts mit dem folgenden Typ erforderlich.
- Microsoft SQL Server
Hier erhalten Sie Informationen, wie ein Endpunkt erstellt werden kann.
Felder und Optionen
Der Endpunkt stellt die Verbindung zur Datenquelle her.
| Endpunkt | In diesem Feld wird der Endpunkt zur Datenbank hinterlegt. |
| Tabelle auswählen | Nach der Auswahl des Endpunkts wird dieser Button angezeigt. Wählen Sie hier die gewünschte Quelldatentabelle aus. |
| Schema | Das Feld zeigt das Schema der Tabelle an. |
| Limit | Tragen Sie hier das Limit ein, wie viele Datensätze maximal importiert werden sollen. |
| Felder (Quelle) | Links sehen Sie die Felder der Tabelle und den jeweiligen Datentyp. |
| Zielmodul | Wählen Sie hier das Modul in Cameleon aus, in das die Daten importiert werden sollen. |
| Felder (Ziel) | Nach der Auswahl des Zielmoduls werden die Felder angezeigt. Sie können die Felder (Quelle) jetzt per Drag&Drop auf die gewünschten Zielfelder mappen. Wenn ein Feld gemappt ist, erscheint ein grüner Balken an dem Feld. |
Folgende Felder werden automatisch durch Cameleon gesetzt:
- UUID
- Erstellt von
- Erstellt am
- ID
Unten rechts in der Ecke befindet sich ein blauer Button, um die Integration auszuführen. Es öffnet sich ein Fenster, um die Ausführung zu bestätigen. Klicken Sie auf “Ausführen”, um die Datensätze jetzt zu importieren.
Diese Integration führt einen Datenbank-INSERT durch und eignet sich daher insbesondere für den Import von Rohdaten zur weiteren Verarbeitung in Cameleon-Hilfsmodule. Ab Version 1.6.6 sind Datenbank-UPDATE-Queries möglich.
Mapping-Eigenschaften
Klicken Sie auf eine Feld-Kachel im Mapping, um die Eigenschaften zu öffnen
| Feld | Beschreibung |
| Zielfeld | Feld in Cameleon, in das der Wert geschrieben wird |
| Datentyp des Zielfeldes | Datentyp des Zielfeldes in Cameleon |
| Quellfeld | Name des Feldes aus der Datenbank |
| Datentyp des Quellfeldes | Datentyp des Quellfeldes in der Datenbank |
| Schlüssel | Ist diese Option aktiv, wird dieses Feld als Schlüssel in Cameleon gewertet. Wenn ein Datensatz in Cameleon mit dem Schlüssel gefunden wird, wird der Datensatz in Cameleon über ein SQL-UPDATE aktualisiert. |
| Ausdruck? | Ist diese Option aktiv, kann ein fester Wert als String hinterlegt werden, der in alle Datensätze eingetragen wird. |
| Feld für Fremdschlüssel | Nur bei Multiselect-Feldern in Cameleon sichtbar. In diesem Feld wird das Cameleon-Feld ausgewählt, in dem der Fremdschlüssel gespeichert ist. Anhand dieser Information selektiert Cameleon die erforderliche UUID, um die Relation zu erstellen. |
LDAP-Rohdatenimport
Für diese Integration ist die Erstellung eines Endpunkts mit dem folgenden Typ erforderlich.
- LDAP
| Endpunkt | In diesem Feld wird der Endpunkt hinterlegt. |
| Filter | Ein Filter für die LDAP-Abfrage, zum Beispiel (objectClass=person) |
| Attribute | LDAP-Attribute, die abgerufen werden, zum Beispiel sn,cn |
Diese Integration führt einen Datenbank-INSERT durch und eignet sich daher insbesondere für den Import von Rohdaten zur weiteren Verarbeitung in Cameleon-Hilfsmodule. Ab Version 1.6.6 sind Datenbank-UPDATE-Queries möglich.
Mapping-Eigenschaften
| Feld | Beschreibung |
| Quelle | LDAP-Attribut, zum Beispiel cn |
| Ziel | Dropdown-Feld zur Auswahl des Cameleon-Zielfeldes |
| Schlüssel | Ist diese Option aktiv, wird dieses Feld als Schlüssel in Cameleon gewertet. Wenn ein Datensatz in Cameleon mit dem Schlüssel gefunden wird, wird der Datensatz in Cameleon über ein SQL-UPDATE aktualisiert. |
| Ausdruck? | Ist diese Option aktiv, kann ein fester Wert als String hinterlegt werden, der in alle Datensätze eingetragen wird. |
Rest-PI
| Endpunkt | In diesem Feld wird der Endpunkt zur Datenbank hinterlegt. Der Endpunkt definiert die Datenquelle. |
| Array | Optionale Angabe eines Feldes aus dem REST-Response, zum Beispiel “rows” |
Mapping-Eigenschaften
| Feld | Beschreibung |
| Quelle | Attribut, zum Beispiel “displayName” |
| Ziel | Dropdown-Feld zur Auswahl des Cameleon-Zielfeldes |
| Schlüssel | Ist diese Option aktiv, wird dieses Feld als Schlüssel in Cameleon gewertet. Wenn ein Datensatz in Cameleon mit dem Schlüssel gefunden wird, wird der Datensatz in Cameleon über ein SQL-UPDATE aktualisiert. |
| Ausdruck? | Ist diese Option aktiv, kann ein fester Wert als String hinterlegt werden, der in alle Datensätze eingetragen wird. |
Planen
Integrationen können automatisch ausgeführt werden. Der Zeitpunkt und das Interval der Ausführung werden in diesem Abschnitt konfiguriert.
Voraussetzungen zur Ausführung:
- Die Integration hat den Status “Wartend”
- Die Integration ist aktiv
- Die Felder im Abschnitt “Planen” sind gefüllt
| Feld | Beschreibung |
| Ausführungsart | Einmalige oder wiederholende Ausführung |
| Nächster Ausführungszeitpunkt | Der Zeitpunkt, zu dem die Integration das nächste Mal ausgeführt wird. |
| Intervall | Ein Wert für das Intervall, mögliche Einheiten sind Minuten, Stunden, Tage und Jahre |
Details
| Hersteller | Ist dieser Parameter aktiv, handelt es sich um einen Konfigurationsdatensatz, der durch den Softwarehersteller im Standard ausgeliefert wurde Hinweis: Bei Konfigurationsdatensätzen vom Hersteller können nur Anzeigelabel und der Verwendungsstatus aktualisiert werden. Diese Datensätze können nicht gelöscht werden |
| Version | Die Version des Konfigurationsdatensatzes |
| Name | Der Name der Integration |
| Typ | Der Typ der Integration |
| Erstellt am | Das Erstellungsdatum des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Aktualisiert am | Das Datum, an dem der Konfigurationsdatensatz zuletzt aktualisiert wurde Hinweis: Das Feld wird automatisch gefüllt |
| UUID | Eine eindeutige ID des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Erstellt von | Der Ersteller des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Aktualisiert von | Die Person, die den Konfigurationsdatensatz zuletzt aktualisiert hat Hinweis: Das Feld wird automatisch gefüllt |