Admin: Admin verschob die Seite CORE AddIns nach BPM:CORE AddIns

2017-12-01T11:41:48Z

Admin verschob die Seite CORE AddIns nach BPM:CORE AddIns

← Nächstältere Version	Version vom 1. Dezember 2017, 11:41 Uhr
(kein Unterschied)

Admin: Die Seite wurde neu angelegt: „ = CORE AddIns =
CORE AddIns sind AddIns welche speziell für den HTK Server Core geschrieben wurden.
== Beschreibung ==

2017-09-21T12:24:25Z

Die Seite wurde neu angelegt: „ = CORE AddIns = <div class="level1"> CORE AddIns sind AddIns welche speziell für den HTK Server Core geschrieben wurden. </div> == Beschreibung == <div clas…“

Neue Seite

= CORE AddIns =
<div class="level1">
CORE AddIns sind AddIns welche speziell für den HTK Server Core geschrieben wurden.
</div>
== Beschreibung ==
<div class="level2">
Core AddIns stellen dem Service (Core) Jobs zur verfügung welche später innerhalb der BPM GUI als Job definiert werden können. Diese könnten Beispielsweise folgende Aufgaben übernehmen.

Datenimport
Datenexport
FTP
Webservices aufrufen / konsumieren
etc.
</div>
== Systemvorrausetzungen ==
<div class="level2">
Visual Studio 2013.
.NET Framework 4.0.
Business Process Management Kompatibler SQL-Server.
Installierter HTK Core.
</div>
== Downloads ==
<div class="level2">
[http://www.htk.de/dokuwiki/bpm/Downloads/HTKBeispielPlugin_CORE.zip Beispielprojekt] (nicht benötigt wenn man Schritt für Schritt Anleitung befolgt).
</div>
== Schritt für Schritt: Erstellung eines AddIns ==
<div class="level2">
#Nach öffnen des Visual Studio's, wählen Sie bitte Neues Projekt und erstellen eine .NET Framework 4.0 Klassenbibliothek, [[File:CORE AddIns 1.png]].
#Nun benötigen wir noch verschiedene Projektverweise. Die Basisvariante eines AddIns muss folgende Verweise enthalten.<br/> [[File:CORE AddIns 2.png|center]][https://msdn.microsoft.com/en-us/library/system.addin(v=vs.110).aspx System.Addin] kann aus dem .NET Framework Standardkatalog verwiesen werden, die anderen Verweise, HTKAddinView, HTKCommonDAL, HTKLog, HTKOLConnect und HTKServerCoreConfig, können aus dem Office-Line Shared Ordner verwiesen werden in welchem der Business Process Management Core installiert wurde.<br/> <br/> [[File:CORE AddIns 3.png]].
#Es empfiehlt sich als BestPractice, den Standardnamespace des AddIns sinnig zu hinterlegen, beispielsweise:<br/> [[File:CORE AddIns 4.png]].
#Benennen Sie nun die Datei Class1.cs enstprechend dem von Ihnen Verwendeten AddIn-Namen, die Namen sollten an allen Stellen gleich lauten und nicht mit Addin oder Plugin enden, Beispiel:[[File:CORE AddIns 5.png]]
#Jetzt müssen wir das [https://msdn.microsoft.com/en-us/library/system.addin.addinattribute(v=vs.110).aspx AddIn Attribute] hinterlegen und entsprechend füllen, Beispiel: [[File:CORE AddIns 6.png]].
#Unsere Klasse muss nun von [[/doku.php?id=wiki:htkaddinview|HTKAddinView]] erben. Anschliessend muss die Methode Start überschrieben werden und es empfiehlt sich ein Privates Addinlog zu erstellen. Die Klasse sollte nun wie folgt aussehen [[File:CORE AddIns 7.png]].
#Das _addinLog Objekt kann über folgenden Code Initialisiert werden: [[File:CORE AddIns 8.png]].
#Es empfiehlt sich die Gesamte Logik der Start Methode in einen [https://msdn.microsoft.com/en-us/library/dszsf989.aspx try-catch-finally] block zu setzen. In dem Finally Block sollten Sie Wissen ob der Job erfolgreich war oder nicht, da Sie hier entsprechend reagieren müssen. Beispiel: [[File:CORE AddIns 9.png]] Die Objektverwendung können Sie unter [[/doku.php?id=wiki:commands|Commands]], [[/doku.php?id=wiki:bag|ServerCommand.Bag]] einsehen.
#Das AddIn benötigt nun noch eine [[/doku.php?id=wiki:corexmlkonfiguration|XML Konfiguration]], diese muss in unserem Beispiel wie folgt heißen:<br/> [[File:CORE AddIns 10.png]].<br/> Stellen Sie bitte die Option '''In Ausgabeverzeichnis kopieren''' auf '''Immer kopieren''' Die [[/doku.php?id=wiki:corexmlkonfiguration|XML Konfiguration]] hat folgenden Aufbau:<br/> [[File:CORE AddIns 11.png]]<br/> <br/> Die Verwendung von Properties können Sie dem Eintrag [[/doku.php?id=wiki:servercommand|ServerCommand-Klasse]] entnehmen.
#Als Ausgabepfad sollten Sie '''C:\Program Files (x86)\Sage\Office Line\6.2\Shared\HTKData\AddIns''' oder den entsprechenden Pfad Verwenden, sowie einen unter ordner, also wäre in unserem Beispiel der Ausgabepfad: '''C:\Program Files (x86)\Sage\Office Line\6.2\Shared\HTKData\AddIns\BeispielPluginAddIn. ''' Als Zielplattform verwenden Sie bitte '''x86.'''<br/> <br/> '''ACHTUNG:''' Um eine korrekte Installation zu gewährleisten, muss der Ordner mit der Zeichenfolge '''AddIn''' enden.
#Nach dem erstellen, starten Sie bitte den [[/doku.php?id=wiki:taskmanager|HTK Taskmanager]] neu.
#Der [[/doku.php?id=wiki:taskmanager|HTK Taskmanager]] installiert nun das AddIn, details hierzu finden Sie in der Taskmanager Log.<br/> [[File:CORE AddIns 12.png]]
#Das AddIn sollte nun auch in der SQL-Server Tabelle '''HTKBPM_AddIns ''' installiert worden sein.<br/> [[File:CORE AddIns 13.png]]
</div>