HTK Wiki - Benutzerbeiträge [de]

OmniMDE:Releases R2024 10 Changelog

2024-09-04T14:25:12Z

MF:

== OmniMDE ==
=== Neuerungen, Fehlerbehebungen & Verbesserungen ===
==== APP & Verarbeitung ====

* Manche Labeltexte wurden zu groß dargestellt, dies wurde behoben.
* Es erscheint nun die Meldung "Timeout" wenn der Server beispielsweise beim Suchen von Daten nicht erreichbar ist.
* Der Timeout von 30 Sekunden wird nun korrekt berücksichtigt.
* Es wurde ein Absturz im Splashscreen auf Android 14 Geräten behoben.
* Kleine Fehlerbehebung beim Suchen von Belegen ohne Versandart
* Es wurde ein Problem behoben welches die Anzeige der Versanddaten verhinderte.
* Es wurde ein Absturz behoben welcher bei Wechsel der API-Url auftreten konnte.
* Bei der Usersynchronisation mussten die ANSI Warnings aktiviert werden
* Es ist nun möglich beim speichern einer Gesamtfertigmeldung einen Sage Bericht zu drucken
* Liste Laufende Arbeitsgänge (OmniMDE) wird nun auch im Standard PPS > Auswertungen > Fertigungsauftrag Menü angezeigt.

OmniMDE:Releases R2024 10 Changelog

2024-09-03T09:10:54Z

MF:

OmniMDE:Releases R2024 10 Changelog

2024-08-30T15:27:22Z

MF:

MF: /* Kurzvideo */

Datei:Omnimde bereich produktion gesamtfertigmeldung stapel.png

2022-11-11T16:03:42Z

MF: Hochgeladen mit SimpleBatchUpload

Datei:Omnimde ablaufdiagramm produktion gesamtfertigmeldung.png

2022-11-11T16:03:41Z

MF: MF lud eine neue Version von Datei:Omnimde ablaufdiagramm produktion gesamtfertigmeldung.png hoch

OmniMDE:AppFunktionGesamtfertigmeldung

2022-11-11T14:04:32Z

MF: /* Ablaufdiagramm */

{{#invoke:Infobox|ShowInfoBoxOmniMDE}}
{{DISPLAYTITLE:Funktion: Gesamtfertigmeldung}}

== Beschreibung ==
 
Die Funktion '''Gesamtfertigmeldung''' gibt Ihnen die Möglichkeit ''schnell und einfach'' einen Fertigungsauftrag im gesamten fertigzumelden. Es werden hierbei für den Fertigungsartikel alle arten von Sage 100 Artikeln unterstützt (Varianten, Seriennummern, Chargen, Kombi aus Seriennummern und Chargen etc.). Das verhalten bei Materialpositionen innerhalb des Fertigungsauftrags die Seriennummern, Chargen oder eine Kombi aus Seriennummern und Chargen benötigen, verhält sich die OmniMDE gemäß Sage Standard und diese müssen nachrangig in der Sage 100 definiert werden.
 
== Bedienung ==
 
Um die Android-App Funktion '''Gesamtfertigmeldung''' zu nutzen, ist es erforderlich, dass der Android-App Bereich '''Produktion (PPS)''' [https://wiki.htk.de/OmniMDE:Lizenzierung Lizensiert] wurde. Wählen Sie bitte im App-Bereich [https://wiki.htk.de/OmniMDE:AppBereichProduktion Produktion] den Menüeintrag '''Gesamtfertigmeldung'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung.png|250px|RTENOTITLE]]</li>
 
=== Android App ===
 
Nach dem Klick auf den Menüeintrag '''Gesamtfertigmeldung''' öffnet sich zunächst eine '''Fertigungsauftragssuche'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_fertigungsauftragssuche.png|250px|RTENOTITLE]]</li>
 Sobald Sie dort einen Fertigungsauftrag bzw. das zu fertigende Produkt manuell gewählt oder gescannt haben, gibt es im Anschluss je nach Artikelart eine von 4 verschiedenen Ablaufmöglichkeiten, siehe hier auch:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/index.php?title=OmniMDE:OmniMDE:AppFunktionGesamtfertigmeldung#Ablaufdiagramm Ablaufdiagramm ]
 
<big>
* Der Artikel '''ist nicht''' ''Nachweispflichtig''
* Der Artikel '''ist''' ''Seriennummernpflichtig''
* Der Artikel '''ist''' ''Chargenpflichtig''
* Der Artikel '''ist sowohl''' ''Chargenpflichtig'' '''als auch''' ''Seriennummernpflichtig''
</big> 
Unten stehend finden Sie weiterführende Links, wie Sie Artikel-Nachweise erfassen können:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionErfassungSeriennummern Seriennummernerfassung]
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionErfassungChargen Chargenerfassung]
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppBedienungErfassungChargenSeriennummernKombiartikel Erfassung von Seriennummernpflichtigen und Chargenpflichtigen "Kombiartikeln"]
 
Wenn Sie einen '''nicht Nachweispflichtigen''' Artikel gewählt haben, erscheint ein Popup welches um die Eingabe der Rückmeldemenge bittet.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_rueckmeldemenge.png|250px|RTENOTITLE]]</li>
 
Anschließend muss noch das Ziellager des zu fertigenden Artikels gesetzt werden.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_lagersuche.png|250px|RTENOTITLE]]</li>
 
Nun öffnet sich der '''Gesamtfertigmeldestapel'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_charge.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_seriennummer.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_charge_seriennummer.png|250px|RTENOTITLE]]</li>
 
Der '''Gesamtfertigmeldestapel''' ist der Zentrale Ausgangspunkt der Funktion '''Gesamtfertigmeldung''' und bietet Ihnen die Möglichkeit über die [https://wiki.htk.de/OmniMDE:AppGrundlagen#Bottom-Navigation-Bar_(Footer) Bottom-Navigation-Bar] Fotos zu erfassen, weitere Mengen des zu fertigenden Artikels dem '''Gesamtfertigmeldestapel''' hinzuzufügen, Details/Optionen festzulegen und den '''Gesamtfertigmeldestapel''' abschließen. Siehe hierzu auch:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionFotofassung Fotoerfassung]
 
Fehlerhafte Datensätze können durch einen [https://wiki.htk.de/OmniMDE:AppGrundlagen#Swipe_(nach_Links_wischen) Swipe nach Links] und einem anschließendem klick auf das Löschen Symbol entfernt werden.
 
Wenn alle Materialien dem Rückmeldestapel hinzugefügt wurden, sie ggf. noch ein [https://wiki.htk.de/OmniMDE:AppFunktionMemoErfassung Memo] erfasst, [https://wiki.htk.de/OmniMDE:AppFunktionFotofassung Fotos] hinterlegt haben, können Sie über den '''Schliessen''' Button am unteren Bildrand den '''Rückmeldestapel''' abschließen und zurück zu der '''Fertigungsauftragssuche''' gelangen.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_stapel_ende.png|250px|RTENOTITLE]]</li>
 

=== Sage 100 ===
Nachdem Sie eine Materialrückmeldung gebucht haben:
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_01.png|250px|RTENOTITLE]]</li>
 
verarbeitet das Backend i.d.R. innerhalb weniger Sekunden den Rückmeldestapel und erzeugt die entsprechenden Sage 100 Entitäten.
Öffnen Sie hierzu den Sage 100 Menüpunkt '''Produktion''' -> '''Fertigung''' -> '''Rückmeldungen verwalten'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_02.png|250px|RTENOTITLE]]</li>
 
Wenn die den entsprechenden '''Fertigungsauftrag''' ausgewählt haben, können Sie die entsprechenden '''Materialrückmeldungen''' einsehen.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_03.png|640px|RTENOTITLE]]</li>
 

== Anhang ==
=== Kurzvideo ===
 
Hier finden Sie ein kurzes Schnelldurchlauf-Video der Funktion '''Materialrückmeldung''' innerhalb der Android-App.
 
[[File:omnimde_bedienung_produktion_materialrueckmeldung.mp4||494px]]
 

=== Weiterführende Links===
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppGrundlagen Grundlagen (Bedienelemente, Visualisierungen, Begriffsklärungen etc.)]
 
=== Ablaufdiagramm===
 
<li style="display: inline-block;">[[File:omnimde_ablaufdiagramm_produktion_gesamtfertigmeldung.png|250px|RTENOTITLE]]</li>

OmniMDE:AppFunktionGesamtfertigmeldung

2022-11-11T14:04:05Z

MF: /* Android App */

{{#invoke:Infobox|ShowInfoBoxOmniMDE}}
{{DISPLAYTITLE:Funktion: Gesamtfertigmeldung}}

== Beschreibung ==
 
Die Funktion '''Gesamtfertigmeldung''' gibt Ihnen die Möglichkeit ''schnell und einfach'' einen Fertigungsauftrag im gesamten fertigzumelden. Es werden hierbei für den Fertigungsartikel alle arten von Sage 100 Artikeln unterstützt (Varianten, Seriennummern, Chargen, Kombi aus Seriennummern und Chargen etc.). Das verhalten bei Materialpositionen innerhalb des Fertigungsauftrags die Seriennummern, Chargen oder eine Kombi aus Seriennummern und Chargen benötigen, verhält sich die OmniMDE gemäß Sage Standard und diese müssen nachrangig in der Sage 100 definiert werden.
 
== Bedienung ==
 
Um die Android-App Funktion '''Gesamtfertigmeldung''' zu nutzen, ist es erforderlich, dass der Android-App Bereich '''Produktion (PPS)''' [https://wiki.htk.de/OmniMDE:Lizenzierung Lizensiert] wurde. Wählen Sie bitte im App-Bereich [https://wiki.htk.de/OmniMDE:AppBereichProduktion Produktion] den Menüeintrag '''Gesamtfertigmeldung'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung.png|250px|RTENOTITLE]]</li>
 
=== Android App ===
 
Nach dem Klick auf den Menüeintrag '''Gesamtfertigmeldung''' öffnet sich zunächst eine '''Fertigungsauftragssuche'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_fertigungsauftragssuche.png|250px|RTENOTITLE]]</li>
 Sobald Sie dort einen Fertigungsauftrag bzw. das zu fertigende Produkt manuell gewählt oder gescannt haben, gibt es im Anschluss je nach Artikelart eine von 4 verschiedenen Ablaufmöglichkeiten, siehe hier auch:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/index.php?title=OmniMDE:OmniMDE:AppFunktionGesamtfertigmeldung#Ablaufdiagramm Ablaufdiagramm ]
 
<big>
* Der Artikel '''ist nicht''' ''Nachweispflichtig''
* Der Artikel '''ist''' ''Seriennummernpflichtig''
* Der Artikel '''ist''' ''Chargenpflichtig''
* Der Artikel '''ist sowohl''' ''Chargenpflichtig'' '''als auch''' ''Seriennummernpflichtig''
</big> 
Unten stehend finden Sie weiterführende Links, wie Sie Artikel-Nachweise erfassen können:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionErfassungSeriennummern Seriennummernerfassung]
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionErfassungChargen Chargenerfassung]
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppBedienungErfassungChargenSeriennummernKombiartikel Erfassung von Seriennummernpflichtigen und Chargenpflichtigen "Kombiartikeln"]
 
Wenn Sie einen '''nicht Nachweispflichtigen''' Artikel gewählt haben, erscheint ein Popup welches um die Eingabe der Rückmeldemenge bittet.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_rueckmeldemenge.png|250px|RTENOTITLE]]</li>
 
Anschließend muss noch das Ziellager des zu fertigenden Artikels gesetzt werden.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_lagersuche.png|250px|RTENOTITLE]]</li>
 
Nun öffnet sich der '''Gesamtfertigmeldestapel'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_charge.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_seriennummer.png|250px|RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_gesamtfertigmeldung_stapel_charge_seriennummer.png|250px|RTENOTITLE]]</li>
 
Der '''Gesamtfertigmeldestapel''' ist der Zentrale Ausgangspunkt der Funktion '''Gesamtfertigmeldung''' und bietet Ihnen die Möglichkeit über die [https://wiki.htk.de/OmniMDE:AppGrundlagen#Bottom-Navigation-Bar_(Footer) Bottom-Navigation-Bar] Fotos zu erfassen, weitere Mengen des zu fertigenden Artikels dem '''Gesamtfertigmeldestapel''' hinzuzufügen, Details/Optionen festzulegen und den '''Gesamtfertigmeldestapel''' abschließen. Siehe hierzu auch:
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppFunktionFotofassung Fotoerfassung]
 
Fehlerhafte Datensätze können durch einen [https://wiki.htk.de/OmniMDE:AppGrundlagen#Swipe_(nach_Links_wischen) Swipe nach Links] und einem anschließendem klick auf das Löschen Symbol entfernt werden.
 
Wenn alle Materialien dem Rückmeldestapel hinzugefügt wurden, sie ggf. noch ein [https://wiki.htk.de/OmniMDE:AppFunktionMemoErfassung Memo] erfasst, [https://wiki.htk.de/OmniMDE:AppFunktionFotofassung Fotos] hinterlegt haben, können Sie über den '''Schliessen''' Button am unteren Bildrand den '''Rückmeldestapel''' abschließen und zurück zu der '''Fertigungsauftragssuche''' gelangen.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_stapel_ende.png|250px|RTENOTITLE]]</li>
 

=== Sage 100 ===
Nachdem Sie eine Materialrückmeldung gebucht haben:
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_01.png|250px|RTENOTITLE]]</li>
 
verarbeitet das Backend i.d.R. innerhalb weniger Sekunden den Rückmeldestapel und erzeugt die entsprechenden Sage 100 Entitäten.
Öffnen Sie hierzu den Sage 100 Menüpunkt '''Produktion''' -> '''Fertigung''' -> '''Rückmeldungen verwalten'''.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_02.png|250px|RTENOTITLE]]</li>
 
Wenn die den entsprechenden '''Fertigungsauftrag''' ausgewählt haben, können Sie die entsprechenden '''Materialrückmeldungen''' einsehen.
 
<li style="display: inline-block;">[[File:omnimde_bereich_produktion_materialruechmeldung_sage_03.png|640px|RTENOTITLE]]</li>
 

== Anhang ==
=== Kurzvideo ===
 
Hier finden Sie ein kurzes Schnelldurchlauf-Video der Funktion '''Materialrückmeldung''' innerhalb der Android-App.
 
[[File:omnimde_bedienung_produktion_materialrueckmeldung.mp4||494px]]
 

=== Weiterführende Links===
 
{{#fas:book-atlas}}      [https://wiki.htk.de/OmniMDE:AppGrundlagen Grundlagen (Bedienelemente, Visualisierungen, Begriffsklärungen etc.)]
 
=== Ablaufdiagramm===
 
<li style="display: inline-block;">[[File:omnimde_ablauf_produktion_materialrueckmeldungen.png|250px|RTENOTITLE]]</li>

OmniMDE:AppFunktionGesamtfertigmeldung

Modul:Infobox

2022-10-31T13:40:04Z

MF:

OmniMDE:InstallationApi

2022-10-20T10:25:31Z

MF: /* Weiterführende Links */

{{#invoke:Infobox|ShowInfoBoxOmniMDE}}
{{DISPLAYTITLE: Installation: Back-End API}}
 
== Haftungsausschluss IIS-Server ==
----
:<div style="text-indent:10px;"><big>'''Achtung'''</big>   Der HTK API Server (Microsoft IIS Server) muss immer durch Ihren IT-Verantwortlichen Installiert und konfiguriert werden! Sollte dies aus besonderen Gründen nicht möglich sein und eine Microsoft IIS Installation explizit durch HTK gewünscht sein, so übernehmen wir keinerlei Haftung für dessen Sicherheit! Desweiteren empfehlen wir ausdrücklich keine Freigabe von Ports, welche eine Nutzung der OmniMDE API von außerhalb des internen Firmennetzwerks möglich machen. Wenn die MDE Geräte über das Intranet nicht auf den IIS-Server zugreifen können, dann bietet sich hier eine VPN Lösung an. HTK bietet hierfür allerdings keine eigene Lösung an und empfiehlt dieses Anwendungsszenario nicht. Wir weisen nochmals darauf hin, dass die OmniMDE Lösung nur für den Einsatz im Intranet konzipiert wurde. Die Lösung verwendet keine geeigneten Sicherheitsprotokolle um außerhalb des Intranets genutzt zu werden!.</div>
----
== Quelldaten ==
 
Nachdem Sie den heruntergeladenen Release entpackt haben, finden Sie die folgende Ordnerstruktur:
 
<li style="display: inline-block;">[[File:omnimde_installation_releaseordner.png|250px|RTENOTITLE]]</li>
 
Die Back-End API befindet sich im Ordner '''PHP API'''
 
<li style="display: inline-block;">[[File:omnimde_installation_releaseordner_api.png|250px|RTENOTITLE]]</li>
 

== Beschreibung ==
Die Installation der Back-End API sollte gemäß den [https://wiki.htk.de/OmniMDE:Systemvoraussetzungen#HTK_API_Server_(Microsoft_IIS-Server) Systemvoraussetzungen des HTK API Server (Microsoft_IIS-Server)] auf einem dediziertem/abgesicherten Server erfolgen. Die Installation besteht aus mehreren (Teil-)Schritten.
 Der grobe Ablauf sieht wie folgt aus:
 '''NEUINSTALLATION''' 
* '''Schritt 1''': [https://wiki.htk.de/OmniMDE:InstallationApi#Installation_IIS Installation IIS]
* '''Schritt 2''': [https://wiki.htk.de/OmniMDE:InstallationApi#Installation_PHP_und_Tools Installation PHP und Tools]
* '''Schritt 3''': [https://wiki.htk.de/OmniMDE:InstallationApi#Installation_Backend-API Installation Backend-API]
* '''Schritt 4''': [https://wiki.htk.de/OmniMDE:InstallationApi#Konfiguration_Zugriffsrechte Konfiguration Zugriffsrechte]
* '''Schritt 5''': [https://wiki.htk.de/OmniMDE:InstallationApi#Pr%C3%BCfung/Konfiguration_PHP.INI Prüfung/Konfiguration PHP.INI]
* '''Schritt 6''': [https://wiki.htk.de/OmniMDE:InstallationApi#Einrichtung_Webseite Einrichtung Webseite]
* '''Schritt 7''': [https://wiki.htk.de/OmniMDE:InstallationApi#Ermittlung_Api_Url Ermittlung der API-Url]
* '''Schritt 8''': [https://wiki.htk.de/OmniMDE:InstallationApi#API-Test API-Test]
'''UPGRADE/UPDATE''' 
* '''Schritt 1''': [https://wiki.htk.de/OmniMDE:InstallationApi#Installation_Backend-API Installation Backend-API]
* '''Schritt 2''': [https://wiki.htk.de/OmniMDE:InstallationApi#Konfiguration_Zugriffsrechte Konfiguration Zugriffsrechte]
* '''Schritt 3''': [https://wiki.htk.de/OmniMDE:InstallationApi#Pr%C3%BCfung/Konfiguration_PHP.INI Prüfung/Konfiguration PHP.INI]
* '''Schritt 4''': [https://wiki.htk.de/OmniMDE:InstallationApi#Ermittlung_Api_Url Ermittlung der API-Url]
* '''Schritt 5''': [https://wiki.htk.de/OmniMDE:InstallationApi#API-Test API-Test]
 

== Installation ==
=== Installation IIS ===
==== Serverrolle (IIS) ====
 
Zuerst muss auf dem dafür vorgesehenen dediziertem/abgesichertem Server die IIS-Serverrolle installiert/hinzugefügt werden.
Falls dies bereits der Fall ist, kann dieser Schritt übersprungen werden.
 
Zur Installation der Serverrolle gehen Sie bitte wie folgt vor:
 
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den ''Server-Manager''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_server_manager_app.png{{!}}250px{{!}}RTENOTITLE]]</li>

 
Im Server-Manager klicken Sie bitte oben Rechts auf ''Verwalten'' dann auf ''Rollen und Features hinzufügen'':
 
<li style="display: inline-block;">[[File:omnimde_install_iis_server_manager_uebersicht.png{{!}}250px{{!}}RTENOTITLE]]</li>

 
In dem sich daraufhin öffnendem Assistenten wählen Sie bitte zunächst ''Rollenbasierte oder Featurebasierte Installation'' und klicken Sie auf ''weiter''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_server_manager_rolle_01.png{{!}}250px{{!}}RTENOTITLE]]</li>

 
Anschließend wählen Sie bitte ''Einen Server aus dem Serverpool wählen''. I.d.R. gibt es in der Liste nur einen Server zur Auswahl, sollte dies nicht so sein, müssten Sie den richtigen Server aus dem Pool wählen und dann ''weiter'' klicken.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_server_manager_rolle_02.png{{!}}250px{{!}}RTENOTITLE]]</li>

 
Im nächsten Schritt des Assistenten markieren Sie bitte alle Punkt im Bereich ''Webserver (IIS)'' außer ''FTP-Server''.
Danach bestätigen Sie den Assistenten mit ''weiter''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_server_manager_rolle_03.png{{!}}250px{{!}}RTENOTITLE]]</li>

 
Im nächsten und letzten Schritt klicken Sie bitte einfach auf ''Installieren''.
Sobald dies abgeschlossen ist, können Sie den ''Server-Manager'' schließen.
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
==== Webplattform-Manager ====
Um der IIS-Serverrolle bzw. dem IIS-Server die nötigen Komponenten (PHP, MSSQL-PHP-Treiber) muss zunächst der Microsoft-Webplattform-Manager installiert werden.
Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Gehen Sie hierzu bitte wie folgt vor:
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den '''Internetinformationsdienste (IIS)-Manager'''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Anschließend klicken Sie bitte auf ''Neue Webplattformkomponenten abrufen''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webplatform_manager.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Es öffnet sich nun der Standard Internet-Browser des Systems. Auf der Microsoft-Website klicken Sie bitte auf den grünen Button ''install this extension''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_webplatforminstaller_website.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Sollte der Link nicht funktionieren können Sie unseren [https://wiki.htk.de/OmniMDE:InstallationApi#Weiterf%C3%BChrende_Links HTK-Mirror] verwenden.
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== Installation PHP und Tools ===
==== PHP & MSSQL-PHP-Treiber ====
Es folgt nun die Installation von PHP und dem entsprechenden MSSQL-Treiber für PHP. Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den '''Internetinformationsdienste (IIS)-Manager'''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Anschließend klicken Sie bitte auf ''Neue Webplattformkomponenten abrufen''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webplatform_manager.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Es öffnet sich nun der ''Webplatform Installer''. Bitte filtern Sie dort auf '''PHP 8.0 (x64)'''.
Drücken Sie daraufhin bitte bei '''PHP 8.0.0 (x64)''' und '''Microsoft Drivers 5.9 (x64) for PHP v.8.0 for SQL Server in IIS''' jeweils den Button ''hinzufügen''.
'''BITTE WÄHLEN SIE NICHT DIE PUNKTE MIT IISExpress IM NAMEN'''. Drücken Sie anschließend ''Installieren''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_webplatforminstaller_php8_mssql_64.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
===== PHP Manager =====
Nun installieren wir den ''PHP Manager for IIS'. Unserer Erfahrung nach schlägt die Installation des ''PHP-Managers'' über den ''Webplattform Installer'' seit geraumer Zeit leider wegen eines CRC Fehlers fehl. Die Installation erfolgt daher Manuell. Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Zur Installation öffnen Sie einfach den [https://wiki.htk.de/OmniMDE:InstallationApi#Weiterf%C3%BChrende_Links entsprechenden Weblink]. Wenn Sie den Offiziellen Microsoft Link öffnen öffnet sich die Microsoft-Webseite in Ihrem Standard Internet-Browser und Sie können den '''PHP-Manager''' über ''install this extension'' installieren.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_phpmanager_website.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== Installation Backend-API ===
Zur Installation der Backend-API müssen Sie die entsprechenden Dateien aus dem Release-Ordner in den IIS '''wwwroot'''-Ordner installieren.
 
Die Back-End API befindet sich im Ordner '''PHP API'''
 
<li style="display: inline-block;">[[File:omnimde_installation_releaseordner_api.png|250px|RTENOTITLE]]</li>
 
Erstellen Sie bitte unter '''C:\inetpub\wwwroot''' einen Ordner '''OmniMDE''' und fügen Sie den Gesamten Inhalt des Ordners '''PHP API''' dort ein.
----
:<div style="text-indent:10px;"><big>'''Achtung'''</big>   Sollte es bereits eine installierte/konfigurierte '''OmniMDE''' geben, empfehlen wir dringend das Sie die '''config.db''' Datei unter '''C:\inetpub\wwwroot\OmniMDE\core\config\''' sichern!</div>
----
 
<li style="display: inline-block;">[[File:omnimde_install_backend_api_wwwroot.png|250px|RTENOTITLE]]</li>
 
==== Konfiguration Zugriffsrechte ====
Nun müssen die entsprechenden Windows-Dateiberechtigungen gesetzt werden. Hierbei ist es wichtig das der Benutzer '''IUSR''' volle Berechtigungen hat.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_webseite_berechtigungen.png|250px|RTENOTITLE]]</li>
 
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== Prüfung/Konfiguration PHP.INI ===
Nun muss die PHP.INI modifiziert bzw. geprüft werden. '''ACHTUNG! Ohne diese Einstellungen kann es zu einer niedrigeren Performance und zu Problemen beim Fotoupload kommen! Bitte beachten Sie allerdings das ALLE Intranet-Anwendungen die PHP-Basiert sind von den Änderungen betroffen sind!'''
Der einfachste Weg die aktuell verwendete PHP.INI zu lokalisieren ist über den ''PHP-Manager for IIS'' im ''Internetinformationsdienste (IIS) Manager''.
Klicken Sie hierzu im Linken Baum auf Ihren Servernamen und dann in der Übersicht auf den PHP-Manager.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_phpmanager.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Anschließend öffnet sich der PHP-Manager und Sie können direkt den Pfad zur PHP.INI einsehen und diese öffnen.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_phpmanager_version.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Bearbeiten Sie die Datei mit dem Textverarbeitungsprogramm Ihrer Wahl, wir empfehlen i.d.R. die Freeware [https://notepad-plus-plus.org/downloads/ Notepad++].
Suchen Sie nun manuell (STRG+F) die folgenden Einträge und setzen Sie bitte die folgenden Werte. Weitere Informationen zu den einzelnen Werten finden Sie unter [https://wiki.htk.de/OmniMDE:InstallationApi#Weiterf%C3%BChrende_Links Weiterführende Links].
 
*<code>'''post_max_size''' = '''2000M''' </code>
*<code>'''upload_max_filesize''' = '''2000M''' </code>
*<code>'''max_file_uploads''' = '''100''' </code>
*<code>'''memory_limit''' = '''2048M''' </code>
 
Anschließend starten Sie den IIS-Serverdienst bitte einmal neu. '''ACHTUNG! Alle Intranet-Anwendungen die auf dem IIS-Server installiert sind, können ggf. während des Neustarts einen kurzen Moment ausfallen!'''
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_neustart.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== Einrichtung Webseite ===
Nun muss noch eine entsprechende Webseite im ''Internetinformationsdienste (IIS) Manager'' hinzugefügt werden.
Führen Sie hierzu einen Rechtsklick auf den Servernamen im linken Baum aus und wählen Sie '''Webseite hinzufügen'''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webseite_hinzufuegen.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
im Anschließenden Dialog konfigurieren Sie bitte die Webseite wie folgt und bestätigen Sie diesen Dialog mit OK.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webseite_hinzufuegen_details.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
'''ACHTUNG! Bitte konfigurieren Sie hier einen entsprechend abgesicherten Port! Siehe hierzu auch [https://wiki.htk.de/OmniMDE:InstallationApi#Haftungsausschluss_IIS-Server Haftungsausschluss]
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== Ermittlung Api Url ===
Um die API-URL zu ermitteln, öffnen Sie eine '''Windows Powershell''' Konsole als '''Administrator'''.
 
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_01.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Führen Sie nun die beiden folgenden Kommandos aus:
 
* <code>Get-NetIPAddress -AddressFamily IPv4</code>
* <code>Get-Website</code>
 
Die API-Url im folgenden Beispiel lautet:
 
'''http://192.168.178.28:80/OmniMDE'''
 
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_02.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 
=== API-Test ===
Sie können die API prüfen indem Sie zuerst die [https://wiki.htk.de/OmniMDE:InstallationApi#Ermittlung_Api_Url API-URL ermitteln] (in unserem Beispiel ''http://192.168.178.28:80/OmniMDE'') und dann folgenden webseite in Ihrem Standard-Internerbrowser aufrufen:
 
* <code>'''http://192.168.178.28:80/OmniMDE/admin'''</code>
 
Wenn die OmniMDE korrekt installiert wurde, öffnet sich die Backend-Konfiguration.
 
<li style="display: inline-block;">[[File:Omnimde_konfiguration_backend_api_01_A.png{{!}}250px{{!}}RTENOTITLE]]</li> 
<li style="display: inline-block;">[[File:Omnimde_konfiguration_backend_api_01.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
----
:<div style="text-indent:10px;"><big>'''Achtung'''</big>   Wenn sich die Einstellungen innerhalb der Backend-Konfiguration nicht ändern lassen, liegt dies i.d.R. an einer fehlende Dateiberechtigung des IUSR Benutzers.</div>
----
 
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
 

== Anhang ==
=== Videos ===
 
* '''Schritt 1: Installation IIS'''
** [[File:omnimde_installation_iis_backend_api_schritt_1.mp4||494px]] 
* '''Schritt 2: Installation PHP und Tools'''
** [[File:omnimde_installation_iis_backend_api_schritt_2.mp4||494px]] 
* '''Schritt 3: Installation Backend-API'''
** [[File:omnimde_installation_iis_backend_api_schritt_3.mp4||494px]] 
* '''Schritt 4: Konfiguration Zugriffsrechte'''
** [[File:omnimde_installation_iis_backend_api_schritt_4.mp4||494px]] 
* '''Schritt 5: Prüfung/Konfiguration PHP.INI'''
** [[File:omnimde_installation_iis_backend_api_schritt_5.mp4||494px]] 
* '''Schritt 6: Einrichtung Webseite'''
** [[File:omnimde_installation_iis_backend_api_schritt_6.mp4||494px]] 
* '''Schritt 7 & 8: Ermittlung der API-Url & API-Test'''
** [[File:omnimde_installation_iis_backend_api_schritt_7_8.mp4||494px]] 

=== Weiterführende Links ===
 [https://wiki.htk.de/OmniMDE:Systemvoraussetzungen#HTK_API_Server_(Microsoft_IIS-Server) '''OmniMDE Systemvoraussetzungen'''] 
 '''PHP.INI SETTINGS''' 
[https://www.php.net/manual/de/ini.core.php#ini.post-max-size PHP.INI: post_max_size] 
[https://www.php.net/manual/de/ini.core.php#ini.max-file-uploads PHP.INI: max_file_uploads] 
[https://www.php.net/manual/de/ini.core.php#ini.upload-max-filesize PHP.INI: upload_max_filesize] 
[https://www.php.net/manual/de/ini.core.php#ini.memory-limit PHP.INI: memory_limit] 
'''WEBPLATFORM-INSTALLER ''' 
[https://go.microsoft.com/fwlink/?LinkId=209096 '''DOWNLOAD''' -> OFFIZIELL: WebPlatformInstaller_x64_en-US.msi] 
[https://wiki.htk.de/filemirror/WebPlatformInstaller_x64_en-US.msi '''DOWNLOAD''' -> HTK-MIRROR: WebPlatformInstaller_x64_en-US.msi] 
'''PHP-MANAGER FOR IIS''' 
[https://www.iis.net/downloads/community/2018/05/php-manager-150-for-iis-10 '''DOWNLOAD''' -> OFFIZIELL: PHPManagerForIIS_V1.5.0.msi] 
[https://wiki.htk.de/filemirror/PHPManagerForIIS_V1.5.0.msi '''DOWNLOAD''' -> HTK-MIRROR: PHPManagerForIIS_V1.5.0.msi] 
'''VC-REDIST + PHP EXT + ODBC DRIVER''' 
[https://wiki.htk.de/filemirror/vcredist_phpext_odbc.zip '''DOWNLOAD''' -> HTK-MIRROR: vcredist_phpext_odbc.zip]