OmniSeller:PlugIn Entwicklung: Unterschied zwischen den Versionen

(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)

Zeile 1:

[[Datei:Omniseller plugin c.png|300px|thumb]]

<h1>OmniSeller PlugIn Entwicklung</h1>

<h2>Überblick</h2>

Zeile 12:

Zeile 13:

<li><b>Abhängigkeiten:</b>

<ul>

<li>OmniSeller.Common und OmniSeller.Enums aus dem HTK NuGet Repository~~: <code>https://htkpackages/repository/</code>~~</li>

<li>OmniSeller.Common und OmniSeller.Enums aus dem HTK NuGet Repository HTKPackages</li>

</ul></li>

<li><b>Nützliche Schnittstellen und Modelle:</b>

Zeile 78:

Zeile 79:

<h3>1. Projekt einrichten</h3>

<ul>

<li>~~Erstelle~~ ein neues <b>.NET Standard 2.0</b> Class Library-Projekt in Visual Studio</li>

<li>Erstellen Sie ein neues <b>.NET Standard 2.0</b> Class Library-Projekt in Visual Studio</li>

<li>~~Füge~~ die folgenden Pakete über das HTK NuGet Repository hinzu:</li>

<li>Fügen Sie die folgenden Pakete über das HTK NuGet Repository hinzu:</li>

<pre>

OmniSeller.Common

Zeile 86:

Zeile 87:

<h3>2. PlugIn-Logik implementieren</h3>

<ul>

<li>~~Implementiere~~ die Schnittstelle <code>IEntryPointPlugin</code>.</li>

<li>Implementieren Sie die Schnittstelle <code>IEntryPointPlugin</code>.</li>

<li>~~Definiere~~ die unterstützten <code>EntryPoints</code> und <code>ShopTypes</code>.</li>

<li>Definieren Sie die unterstützten <code>EntryPoints</code> und <code>ShopTypes</code>.</li>

<li>~~Implementiere~~ die Logik in der Methode <code>Call</code>.</li>

<li>Implementieren Sie die Logik in der Methode <code>Call</code>.</li>

</ul>

<h3>3. PlugIn erstellen und veröffentlichen</h3>

<ul>

<li>~~Kompiliere~~ das Projekt.</li>

<li>Kompilieren Sie das Projekt.</li>

<li>Die resultierende <code>.dll</code>-Datei (zusammen mit ihren Abhängigkeiten) wird in das OmniSeller PlugIn-Verzeichnis kopiert:</li>

<pre>C:\OmniVersum\Apps\OmniSellerService2\PlugIns</pre></ul>

<h3>4. PlugIn testen</h3>

<ul>

<li>~~Starte~~ den OmniSeller DataService und ~~beobachte~~ die Logs.</li>

<li>Starten Sie den OmniSeller DataService und beobachten Sie die Logs.</li>

<li>Das PlugIn wird automatisch geladen und ausgeführt, wenn der entsprechende <code>EntryPoint</code> erreicht wird.</li>

</ul>

Zeile 128:

Zeile 129:

<h2>Best Practices für PlugIns</h2>

<ul>

<li><b>~~Vermeide~~ lange Blockaden:</b>

<li><b>Vermeiden Sie lange Blockaden:</b>

<ul>

<li>Die Methode <code>Call</code> sollte möglichst schnell ausgeführt werden, um Verzögerungen im DataService zu vermeiden.</li>

Zeile 134:

Zeile 135:

<li><b>Fehlerbehandlung:</b>

<ul>

<li>~~Verwende~~ <code>try-catch</code>, um Laufzeitfehler zu verhindern, die den gesamten Service beeinflussen könnten.</li>

<li>Verwenden Sie <code>try-catch</code>, um Laufzeitfehler zu verhindern, die den gesamten Service beeinflussen könnten.</li>

</ul></li>

<li><b>Testumgebung nutzen:</b>

<ul>

<li>~~Teste~~ das PlugIn in einer Entwicklungs- oder Staging-Umgebung, bevor es in die Produktion übernommen wird.</li>

<li>Testen Sie das PlugIn in einer Entwicklungs- oder Staging-Umgebung, bevor es in die Produktion übernommen wird.</li>

</ul></li>

<li><b>Log-Ausgaben:</b>

<ul>

<li>~~Nutze~~ <code>Console.WriteLine</code>, um wichtige Informationen und Debug-Daten während der PlugIn-Ausführung zu loggen.</li>

<li>Nutzen Sie <code>Console.WriteLine</code>, um wichtige Informationen und Debug-Daten während der PlugIn-Ausführung zu loggen.</li>

</ul></li>

</ul>

Zeile 158:

Zeile 159:

<li><b>PlugIn wird nicht geladen:</b>

<ul>

<li>~~Überprüfe~~, ob die <code>IEntryPointPlugin</code>-Schnittstelle korrekt implementiert wurde.</li>

<li>Überprüfen Sie, ob die <code>IEntryPointPlugin</code>-Schnittstelle korrekt implementiert wurde.</li>

<li>~~Stelle~~ sicher, dass alle Abhängigkeiten (z. B. <code>OmniSeller.Common</code>) verfügbar sind.</li>

<li>Stellen Sie sicher, dass alle Abhängigkeiten (z. B. <code>OmniSeller.Common</code>) verfügbar sind.</li>

</ul></li>

<li><b>Assembly-Version inkompatibel:</b>

<ul>

<li>~~Stelle~~ sicher, dass die Hauptanwendung und das PlugIn dieselben Versionen von <code>OmniSeller.Common</code> verwenden.</li>

<li>Stellen Sie sicher, dass die Hauptanwendung und das PlugIn dieselben Versionen von <code>OmniSeller.Common</code> verwenden.</li>

</ul></li>

<li><b>Kein <code>EntryPoint</code> aktiviert:</b>

<ul>

<li>~~Prüfe~~, ob der EntryPoint des PlugIns (<code>SupportedEntryPoints</code>) mit dem vom Service ausgelösten EntryPoint übereinstimmt.</li>

<li>Prüfen Sie, ob der EntryPoint des PlugIns (<code>SupportedEntryPoints</code>) mit dem vom Service ausgelösten EntryPoint übereinstimmt.<br><br><br></li>

</ul></li>

</ul>

<h1>Hinweis zur PlugIn-Entwicklung</h1>

<p>Die Möglichkeit, individuelle PlugIns für den OmniSeller DataService zu erstellen, bietet eine flexible und maßgeschneiderte Lösung für spezifische Kundenanforderungen. Bitte beachten Sie jedoch:</p>

<ul>

<li><b>Die Entwicklung von PlugIns ist nicht Bestandteil unserer regulären Pakete, einschließlich des Enterprise-Pakets.</b></li>

<li><b>Eine PlugIn-Entwicklung erfordert immer eine gesonderte Absprache mit HTK.</b></li>

</ul>

<p>PlugIns ermöglichen Anpassungen, die über den Standardumfang hinausgehen. Sie sind ideal, um individuelle Geschäftsprozesse oder spezielle Anforderungen abzubilden, erfordern jedoch eine präzise Abstimmung zwischen Ihnen und unserem Entwicklungsteam.</p>

<h2>Was bedeutet das für Sie?</h2>

<ul>

<li><b>Keine Standardfunktion:</b> Die PlugIn-Entwicklung ist eine Zusatzleistung und nicht automatisch im Lieferumfang unserer OmniSeller-Pakete enthalten (auch nicht im Enterprise Paket).</li>

<li><b>Gesonderte Kosten:</b> Jede PlugIn-Entwicklung wird individuell kalkuliert und als separate Leistung abgerechnet.</li>

<li><b>Kundenspezifische Lösung:</b> PlugIns werden speziell für Ihre Anforderungen erstellt und sind nicht universell einsetzbar.</li>

</ul>

<p>Wenn Sie Interesse an der Entwicklung eines PlugIns haben, kontaktieren Sie bitte Ihren Ansprechpartner bei HTK. Wir freuen uns darauf, Ihre Anforderungen zu besprechen und Ihnen eine passende Lösung anzubieten.</p>

<p>

<i>HTK behält sich das Recht vor, PlugIn-Anfragen zu prüfen und gegebenenfalls abzulehnen, falls diese nicht mit den technischen oder geschäftlichen Rahmenbedingungen vereinbar sind.</i></p>

Admin (Diskussion | Beiträge)