¶ Funktionsbeschreibung
¶ Konfiguration
Wie Sie eine Workflow-Action in einen Workflow hinzufügen können, erfahren Sie hier unter Einrichtung.
Um eine Workflow-Action zu konfigurieren, markieren Sie diese und klicken Sie auf die Schaltfläche Action bearbeiten.
¶ GetGoodsReceiptsAction
¶ Allgemeines
Diese Erweiterung zum aidex ist für Anbindung der mydactory erstellt worden. Sie deckt folgende use-cases ab:
- Eine Eingangsrechnung bezieht sich auf einen einzigen Wareneingang, obwohl es zu einer Bestellung mehrere Wareneingänge geben kann
- Eine Eingangsrechnung bezieht sich auf mehrere, aber nicht zwingend alle Wareneingänge zu einer Bestellung
Die Hauptaufgabe für den Benutzer ist es nun, alle Wareneingänge für die vom aidex ausgelesene Bestellnummer in myfactory zu suchen und die passenden Wareneingänge für die Rechnung auszuwählen. Dadurch kann die myfactory für die Verbuchung die passenen Wareneingänge heranziehen.
¶ Umsetzung
Die Workflowaction GetGoodyReceiptsAction prüft anhand der Bestellnummer (startet generell mit "BE") auf offene Wareneingänge. Als Ergebnis werden 2 Workflowvariablen geschrieben
| Variable | Beschreibung |
|---|---|
| @@AIDEX_VALUE_GOODS_RECEIPTS@@ | Enthält eine Kommagetrennte Liste der gefundenen offenen Wareneingänge (diese beginnen generell mit "WE") |
| @@AIDEX_VALUE_GOODS_RECEIPTS_COUNT@@ | Entält die Anzahl der gefundenen offenen Wareneingänge |
¶ Konfiguration der WorkflowAction
| Variable | Beschreibung | Standardwert |
|---|---|---|
| OrderTypeID Wareneingang | myfactory-ID für Wareneingang - normalerweise immer 3, könnte theoretisch aber in den myfactory Einstellungen geändert worden sein | 3 |
| OrderTypeID Bestellung | myfactory-ID für Bestellung - normalerweise immer 2,könnte theoretisch aber in den myfactory Einstellungen geändert worden sein | 2 |
| Basis URL | Die URL zur myfactory API | |
| Datenbankname | Der myfactory Datenbankname, auf den zugegriffen werden soll | |
| SOAP-API User | Username des myfactory API-Users | |
| SOAP-API Passwort | Passwort des myfactory API-Users | |
| Bestellnummer | Hier steht die vom aidex ausgelesene Bstellnummer, kann WF-Variable oder direkter Zugriff auf Objectproperty sein |
¶ Anpassung der docuvita.Server.exe.config
Folgender Eintrag in der docuvita.Server.exe.config muss nach dem </appSettings> Knoten eingetragen werden:
<system.serviceModel>
<bindings>
<basicHttpBinding>
<binding name="ServicesSoap"
maxReceivedMessageSize = "1000000">
<security mode="Transport" />
</binding>
<binding name="PurchaseOrdersSoap"
maxReceivedMessageSize = "1000000">
<security mode="Transport" />
</binding>
</basicHttpBinding>
</bindings>
<client>
<endpoint address="http://hier.muss-nichts.stehen/default.asmx"
binding="basicHttpBinding"
bindingConfiguration="ServicesSoap"
contract="ServicesRoot.ServicesSoap"
name="ServicesSoap" />
<endpoint address="http://hier.muss-nichts.stehen/default.asmx"
binding="basicHttpBinding"
bindingConfiguration="PurchaseOrdersSoap"
contract="PurchOrders.PurchaseOrdersSoap"
name="PurchaseOrdersSoap" />
</client>
</system.serviceModel>
¶ Anwendung
Eine mögliche Anwendung ist die Verwendung eines CustomValidiationScripts im docuvita Wokflow. Dieses füllt zunächst eine Liste mit allen gefundenen Wareneingängen. Wählt der Benutzer einen Wareneingang aus, wird dieser in ein weiteres Feld der Workflowmaske geschrieben. Bei Auswahl mehrerer Wareneingänge nacheinader werden diese kommagetrennt in das Feld geschrieben.
Das Beispielscript
fillGoodsReceiptsList.js
Download -> fillgoodsreceiptslist.js
ist entsprechend dieser Anwendung konfigurierbar:
///////////////////////////////////// SETUP ////////////////////////////////////////////////
var GRID_NAME_WE_STRING = 'AIDEX_VALUE_GOODS_RECEIPTS'
var GRID_NAME_WE_LIST='WELIST'
var GRID_NAME_CHOOSEN_WE = 'CHWELIST'
var MULTIPLE_CHOICES = false
///////////////////////////////////////////////////////////////////////////////////////////////
| Variable | Beschreibung | Standardwert |
|---|---|---|
| GRID_NAME_WE_STRING | Name des Feldes, welches den Wert der Variablen @@AIDEX_VALUE_GOODS_RECEIPTS@@ enthält | |
| GRID_NAME_WE_LIST | Dieses Feld ist die Liste der gefunden Wareneingänge, wird durch das Script anhand der GRID_NAME_WE_STRING gefüllt | |
| GRID_NAME_CHOOSEN_WE | In dieses Feld werden die ausgewälten Wareneingänge geschrieben (Kommagetrennt) | |
| MULTIPLE_CHOICES | Wenn dieses Flag auf true steht, werden die Wareneingänge in GRAD_NAME_CHOOSEN_WE kommagetrennt geschrieben, andernfalls wird der Wert stets durch die neue Auswahl vom Benutzer ersetzt |
Die erstellten Variablen können dann zur weiteren Verarbeitung benutzt werden.
¶ Beispielworkflow
Der Beispielworkflow BeispielWorkflow.json erzeugt einen Benutzertask, wenn mehr als 1 Wareneingang zur Bestellung gefunden wurde. Er veranschaulicht die Funktionsweise des CustomValidationsScripts und die Nutzung der erstellten Workflowvariablen.
Download -> beispielworkflow.json