etagis Interface#
Allgemein#
Das Modul "etagis-Interface" ermöglicht eine direkte Verbindung zwischen dem Leitstand etagis APS und KUMAVISION factory365 über eine API-Schnittstelle. Neben der klassischen Integration von Verkaufs- und Fertigungsaufträgen erweitert das Modul "etagis Interface" die Funktionalität um die Einbindung von Projektplanung und -überwachung. Dadurch werden sämtliche Prozesse aus Fertigung und Projektmanagement in einer zentralen Lösung zusammengeführt, was zu erhöhter Transparenz und Effizienz beiträgt.
Die Planung und Steuerung von Montageaufträgen ist in etagis APS nicht vorgesehen.
Hinweis
Der im AppSource von etagis bereitgestellte "etagis Connector" ist nicht mit KUMAVISION factory365 kompatibel und bietet nicht den Funktionsumfang des Moduls "etagis Interface".
Lizenzierung#
Da über das Modul "etagis-Interface" Daten aus Microsoft Dynamics 365 Business Central1 in einem Fremdsystem verarbeitet, verändert und zurückgeschrieben werden (bidirektional), muss jeder etagis APS-User eine entsprechende Microsoft Dynamics 365 Business Central1-Lizenz besitzen.
Im Sinne der Microsoft1 Lizenzbedingungen handelt es sich hierbei um Multiplexing. Für den etagis-Planer und etagis-Teamleiter werden Premium-User benötigt. Für den etagis-User (der nur lesenden Zugriff hat) ist eine Teammember-Lizenz ausreichend.
Hinweis
etagis Interface ist ein Freischaltmodul, dessen Nutzung nur mit zusätzlicher Lizenzierung und Aktivierung möglich ist.
Einrichtung#
Im Nachfolgenden sind nur die wesentlichen Einrichtungen für die Schnittstelle innerhalb von KUMAVISION factory365 beschrieben.
Hinweis
Eine separate Anleitung zur Einrichtung und Installation von etagis Interface und etagis APS ist für Projektleitende sowie Administratoren verfügbar. Diese Anleitung wird Ihnen im Zuge der Projektdurchführung von Ihrer KUMAVISION-Projektleitung bereitgestellt.
Alle weitergehenden Einstellungen von etagis APS finden Sie im Handbuch der Anwendung unter Menü/Extras/Handbuch.
KUMAVISION Moduleinrichtung#
Um das etagis Interface zu verwenden, aktivieren Sie den Schalter "etagis Interface aktivieren" in der KUMAVISION Moduleinrichtung.
Benutzer#
Für den Zugriff von etagis APS ist die Einrichtung eines separaten Benutzers (OnPremise-Umgebungen) bzw. einer Microsoft Entra-ID (SaaS-Umgebungen) mit eingeschränktem Zugriff (siehe Benutzerberechtigungssätze) innerhalb von KUMAVISION factory365 erforderlich.
Beachten Sie hierbei die verschiedenen Möglichkeiten innerhalb der bereits erwähnten Anleitung zur Installation und Einrichtung von etagis Interface und etagis APS.
Benutzerberechtigungssätze#
Als Mindestanforderung für den Zugriff der Schnittstelle müssen die folgenden Berechtigungssätze zugewiesen werden:
- D365 BASIC
Berechtigungssatz im Auslieferungszustand von Microsoft Dynamics 365 Business Central1 - SYSTEM APP - BASIC
Berechtigungssatz im Auslieferungszustand von Microsoft Dynamics 365 Business Central1 - KVSFCYETAGIS
Berechtigungssatz im Auslieferungszustand der KUMAVISION factory365
Die Berechtigungssätze im Auslieferungszustand können nicht angepasst werden. Für kundenspezifische Erweiterungen der Berechtigungen muss ein separater Berechtigungssatz angelegt und zugewiesen werden.
Firmendaten#
Innerhalb von etagis APS werden die Fälligkeiten von Kundenaufträgen und Projekten grundsätzlich nicht angepasst. Daher müssen potenzielle Datumskonflikte bei Reservierungen, die beim Import aus etagis APS entstehen, entsprechend verarbeitet werden können.
Damit die Planungsergebnisse aus etagis APS fehlerfrei in KUMAVISION factory395 zurückgeschrieben werden können, muss im Inforegister "Allgemein" der Firmendaten der Schalter "Datumskonflikte aktivieren" eingeschaltet sein.
Verwendung im Prozess#
Das etagis Interface wird im Rahmen von Import- und Exportprozessen in etagis APS automatisiert im Hintergrund ausgeführt, sodass Sie nicht direkt in diese Abläufe eingebunden sind. Für die administrative Überwachung der Importe aus etagis sowie deren Weiterverarbeitung in KUMAVISION factory365 stehen dennoch verschiedene Funktionen zur Verfügung.
Hinweis
Die manuelle Verarbeitung der Etagis Importposten kann in der Konfiguration von etagis APS aktiviert werden.
Etagis Importposten#
Sie können die Übersicht der Etagis-Importposten direkt über die Anwendersuche in KUMAVISION factory365 öffnen. Dort sehen Sie zunächst eine Zusammenfassung des Verarbeitungsprotokolls der Schnittstelle sowie eine Auflistung der Tabellen, die von etagis APS an Microsoft Dynamics 365 Business Central1 übertragen wurden.
Zusätzlich zum Status des jeweiligen Importpostens werden weitere Informationen bereitgestellt, darunter der Zeitstempel für den Empfang und die Verarbeitung sowie die Anzahl der erfolgreich importierten Datensätze.
Über den Wert im Feld "Anzahl Detailzeilen" bzw. über "Postenzeilen anzeigen" im Menüband lassen sich die Etagis Importpostenzeilen aufrufen. Über "Inhalt anzeigen" kann der genaue Inhalt der JSON-Datei eingesehen werden, wie er von etagis APS übermittelt wurde.
Diese Informationen sind ebenfalls in Klartext auf der Seite "Etagis Import Feldeinträge" hinterlegt und können über die entsprechenden Etagis Importpostenzeilen abgerufen werden.
Im Menüband stehen des Weiteren für den manuellen Eingriff in die Verarbeitung die Funktionsaufrufe: "Import starten", "Verarbeitet setzen" und "Verarbeitung zurücksetzen" zur Verfügung.
Die manuelle Bearbeitung von etagis Importposten ist ausschließlich in Ausnahmefällen vorgesehen oder kann während der Einführungsphase eingesetzt werden, sofern die automatische Verarbeitung in etagis APS deaktiviert ist.
Tabellendaten der Etagis-Importposten#
Die unten aufgeführten Tabellen und Felder aus Microsoft Dynamics 365 Business Central1 werden im Rahmen der Standardkonfiguration während der Verarbeitung der Etagis Importposten berücksichtigt:
| Tabellen-ID | Beschreibung | Felder |
|---|---|---|
| 5406 | FA-Zeilen immer in Kombination mit den zugehörigen FA-Arbeitsgängen | • Startdatum/-zeit • Enddatum/-zeit • Etagis Daten: Inhalt wird in der etagis Konfiguration definiert |
| 5409 | FA-Arbeitsgänge | • Art: Arbeitsplatz bzw. Arbeitsplatzgruppe • Nr.: Nummer des Arbeitsplatzes bzw. der Arbeitsplatzgruppe • Startdatum/-zeit • Enddatum/-zeit • Etagis Daten: Inhalt wird in der etagis Konfiguration definiert |
| 1003 | Projektplanzeilen (nur wenn in Konfiguration von etagis APS die Verarbeitung der Projekte aktiviert ist) | • Startdatum • Planungsdatum |
Für projektspezifische Erweiterungen stehen entsprechende Events innerhalb von etagis Interface zur Verfügung. Hierbei ist zu beachten, dass auch die Konfiguration innerhalb von etagis APS für den Import als auch Export angepasst werden muss (siehe Handbuch unter Menü/Extras/Handbuch innerhalb von etagis APS).
Etagis Importpostenzeilen#
Die Übersicht der Etagis Importpostenzeilen lässt sich entweder direkt über die Anwendersuche in KUMAVISION factory365 öffnen oder über das Menüband der Etagis Importposten Übersicht aufrufen.
In den Etagis Importpostenzeilen werden sämtliche Datensätze angezeigt, die von etagis APS übertragen wurden. Zu jedem Datensatz erhalten Sie neben den Primärschlüssel-Informationen auch Angaben zum Verarbeitungsstatus sowie, im Falle eines Fehlers während der Verarbeitung, eine spezifische Fehlermeldung.
Mit "Herkunftsbelegzeile anzeigen" oder "Herkunftsbeleg anzeigen" im Menüband können Sie direkt auf den entsprechenden Beleg bzw. die jeweilige Belegzeile zugreifen. Über "Feldeinträge anzeigen" lassen sich die Etagis Import Feldeinträge öffnen, die ebenfalls in der Infobox der Etagis Importpostenzeilen dargestellt werden.
Für den manuellen Eingriff in die Verarbeitung der Etagis Importposten besteht an dieser Stelle die Möglichkeit, einzelne Datensätze bei Fehlern über "Zeile zurücksetzen" im Menüband für eine erneute Verarbeitung zu aktivieren. Zudem kann der spezifische Inhalt der jeweiligen JSON-Datei, die aus etagis APS übermittelt wurde, für den entsprechenden Datensatz abgerufen werden.
Etagis Import Feldeinträge#
In der Übersicht der Etagis Import Feldeinträge, die über die Etagis Importpostenzeilen aufgerufen werden kann, lassen sich die einzelnen Felder und deren Inhalte bequem einsehen. Dabei wird zu jedem Tabellenfeld in Microsoft Dynamics 365 Business Central1 der extrahierte Feldwert aus der JSON-Datei als Text angezeigt, ebenso wie dessen Übernahme als entsprechender Wert im Tabellenfeld. Bei Tabellenfeldern des Typs "DateTime" oder "Time" wird auch die Zeitzone berücksichtigt, die in der Microsoft1 Entra-Anwendung konfiguriert ist.
Etagis Import Fehlerhandling#
Um sicherzustellen, dass Sie im Falle eines Fehlers während der Hintergrundverarbeitung der Etagis Importposten informiert werden, wurden die Rollencenter "Produktionsleiter" und "Projekt-Manager" um einen "Etagis Import"-Stapel sowie das Benachrichtigungssystem von Microsoft Dynamics 365 Business Central1 erweitert.
Die im Stapel angezeigten Informationen sowie die Benachrichtigungen beziehen sich grundsätzlich auf Fehler, die beim letzten Import aus etagis aufgetreten sind.
Stapel: "etagis Import" im Rollencenter "Produktionsleiter"#
Falls bei der Verarbeitung der Etagis Importposten für Fertigungsaufträge Fehler auftreten, werden diese in diesem Stapel angezeigt. Über diesen Stapel kann anschließend die Übersicht der Etagis Importposten mit dem Status "Fehler" aufgerufen werden.
Stapel: "etagis Import" im Rollencenter "Projekt-Manager"#
Falls bei der Verarbeitung der Etagis Importposten für Projekte Fehler auftreten, werden diese in diesem Stapel angezeigt. Über diesen Stapel kann anschließend die Übersicht der Etagis Importposten mit dem Status "Fehler" aufgerufen werden.
Etagis Import Benachrichtigungen#
Im Rahmen von Fertigungsaufträgen und Projekten erhalten Sie in der jeweiligen Belegkarte eine Benachrichtigung, sobald fehlerhafte Etagis Importposten für den entsprechenden Vorgang vorliegen.
Über diese Benachrichtigung lässt sich per Klick direkt die Übersicht der fehlerhaften Etagis Importposten zum jeweiligen Beleg aufrufen. NutzerInnen können die Benachrichtigungen innerhalb der Belege bei Bedarf auch grundsätzlich deaktivieren.
Deaktivierte Benachrichtigungen lassen sich jederzeit über "Meine Benachrichtigungen" wieder aktivieren.