Anhand dieses Dialogs lässt sich eine REST-API-Verbindung (REST = "Representational State Transfer") mit Zugangsdaten anlegen und konfigurieren. Diese erlaubt es Ihnen, aus einer externen Anwendung heraus mit der myfactory zu kommunizieren. Dies dient primär dazu, Daten aus der myfactory auszulesen und sie in der externen Anwendung, z.B. einem Auswertungs-Tool wie Microsoft PowerBI, zu verwenden. Ein entsprechendes Praxisbeispiel anhand von PowerBI entnehmen Sie bitte dem zugehörigen How-To-Kapitel (myfactory als Datenquelle: Die REST API für die Microsoft PowerBI-Auswertung nutzen).


Die eigentlichen API-Verbindungen können Sie unter Angabe eines Usernamens und Passwortes in diesem "Grundlagen"-Register anlegen.



Geben Sie hier bitte eine sinnvolle Bezeichnung für die API-Verbindung ein.


Ist diese Option gesetzt, so wird die mit diesem Flag gekennzeichnete API-Verbindung in der Übersichtsliste standardmäßig ausgeblendet. Möchten Sie das Setzen des "Inaktiv"-Flags rückgängig machen, so müssen Sie zuerst den Inaktiv-Datensatzfilter aktivieren, damit die API-Verbindung in der Liste wieder auftaucht. Anschließend können Sie den entsprechenden Haken entfernen.


Mit dem Festlegen eines Eigentümers haben Sie eine Filtermöglichkeit zur Hand, um den Datenzugriff pro API-Verbindung und Benutzer über Datensatzberechtigungen einzuschränken. Beispielsweise können Sie über das Setzen einer entsprechenden Zugriffsberechtigung auf dem Benutzer verhindern, dass Projektleiter über die API-Verbindung untereinander Einsicht in die jeweils mit einem Projekt erzielten Umsätze erhalten. Ebenso könnten Sie pro Vertreter eine eigene API-Verbindung mit jeweils unterschiedlichem Eigentümer definieren, um zu vermeiden, dass die Vertreter über die REST API untereinander ihre Kontakteinträge (z.B. die Anzahl der Besuche pro Kontakt) zu sehen bekommen.

Grundsätzlich sollte also jeder API-Verbindung aus Datenschutzgründen ein eigener Eigentümer mit individuellen Datensatzberechtigungen zugeordnet sein, damit kein Benutzer darüber mehr Berechtigungen erhält als über die myfactory selbst.
Diese Art der Datenfilterung stellt eine weitere spezifische Filtermöglichkeit dar, die auf Datensatzebene arbeitet. Über das Register "Datenkonfiguration" können Sie für jede API-Verbindung noch zusätzlich Einschränkungen auf Datentypebene vornehmen (siehe unten).


Vergeben Sie hier bitte einen beliebigen Benutzernamen sowie ein beliebiges Kennwort. Sie benötigen beides, um sich in der externen Anwendung für die Verbindung mit der myfactory-Datenquelle zu authentifizieren. Das verschlüsselte Passwort wird nach Speichern der API-Verbindung automatisch aus dem Eingabefeld entfernt. Seine Gültigkeit für die Herstellung der API-Verbindung verliert es dadurch jedoch nicht.


In dieses Textfeld können Sie eine griffige Beschreibung für die hier angelegte API-Verbindung eintragen.


Ist diese Checkbox gesetzt, dann können Berechtigungen für die einzelnen Smart Report SQL-Datenquellen individuell gesetzt werden. Ist diese Option nicht aktiviert, so stehen Ihnen alle Smart Report SQL-Datenquellen uneingeschränkt über die angelegten API-Verbindungen zur Verfügung.


Nachdem Sie die API-Verbindung mit den Zugangsdaten gespeichert haben, wird in dieser Zeile automatisch eine OData-REST-URL generiert. In einer externen Anwendung lässt sich mit dieser URL die REST API ansprechen, über welche die myfactory-Daten abgerufen und in die Anwendung importiert werden. Der Zugriff auf die REST-Schnittstelle erfolgt dabei über das OData-Protokoll (= OpenData-Protokoll), welches dem HTTP-basierten Datenaustausch zwischen zwei Softwaresystemen dient.


Hier finden Sie eine weitere URL, die Sie auch anklicken können. Nach Aufruf dieses Links öffnet sich ein neues Fenster mit einer Beschreibung aller myfactory-Datensätze, die sich über die REST API in die externe Anwendung importieren lassen. Wenn Sie eine einzelne Beschreibung (oder optional alle) aufklappen, sehen Sie außerdem eine Auflistung der einzelnen Datenfelder, die für jeden Datensatz mit importiert werden. Für den Artikelstamm sind das beispielsweise die Felder "Artikelnummer", "Artikelstatus" und "Artikeltyp".



Tragen Sie in diesem Register keine Betriebsstätte ein, so werden die Daten sämtlicher Betriebsstätten geliefert. Geben Sie z.B. eine 1 ein, so werden nur die Daten der Betriebsstätte "Zentrale" zur Auswertung in einer externen Anwendung herangezogen. Die Daten aus der Betriebsstätte 2 können hingegen nicht verwertet werden.



Anhand der Einstellungen in diesem Register legen Sie fest, welche Arten von Datentypen ein Nutzer dieser API-Verbindung in der externen Anwendung sehen und auslesen darf. So lassen sich hierüber unter anderem Artikel- und Adressdaten, sowie Fibu- oder Produktionsdaten über die Schnittstelle bereitstellen. Zusätzliche Einstellungen können Sie in den auf die "Aktiv"-Checkbox folgenden Spalten vornehmen. Beispielsweise lässt sich der Zeitraum definieren, für den die Fibu-Daten aus der myfactory ausgelesen werden sollen. Hinsichtlich des Datentyps der Verkaufsbelegpositionen haben Sie die Möglichkeit, außer den eigentlichen Artikelpositionen noch weitere Positionstypen - wie z.B. Zwischensummen, Rabattpositionen oder Zuschläge - auswerten zu lassen.

Dieses Register ist - neben der Eingrenzung über das "Eigentümer"-Auswahlfeld im Register "Grundlagen" - die zweite Möglichkeit der "API-Datenfilterung".





Wenn Sie das Änderungsprotokoll für die myfactory.API-Verbindungen aktiviert haben (siehe "Administration / Änderungsprotokoll / Konfiguration"), können Sie über dieses Register Ihre getätigten Änderungen nachvollziehen.