Anpassen des IDM-Integrations-Workflows

Sie können die erweiterten Funktionen in der Maske IDM-Dokument-Workflows zusammen mit den Hintergrund-Tasks des Anwendungsereignissystems (AES) verwenden, um die vordefinierten Workflows anzupassen oder neue Dokument-Workflows hinzuzufügen.

Im Folgenden werden einige Fälle genannt, bei denen Sie einen Dokument-Workflow bearbeiten oder hinzufügen möchten:

Ihre Anwender möchten Bestellungen finden, die auf der Bestellvertragsnummer basieren, Sie sollten dies daher als Attribut für die Suche und das Abrufen von Dokumenten in Document Management hinzufügen. Sie können einen Wert als Attribut hinzufügen, der im referenzierten IDO für den Workflow vorhanden ist.
Ihre Maske Berichte für Bestellungen enthält eine Personalisierung, die ein neues Feld enthält, und Sie möchten, dass Anwender nach diesem Feld filtern können. Die Maske mit dem personalisierten Bericht verwendet weiterhin den standardmäßigen Hintergrund-Task-Namen. In diesem Fall könnten Sie den Eigenschaftsnamen des neuen IDM-Attributs an die IDOPropertyList im Standard-Workflow-Datensatz anfügen.
Ihr Rechnungsdokument wurde mit einem vom Standard abweichenden Hintergrund-Task-Namen angepasst. Sie möchten diese Hintergrund-Task im Workflow anstelle des Standardnamens verwenden.
Sie möchten einen Workflow für eine andere Berichts-Hintergrund-Task hinzufügen, die nicht in der aktuellen vordefinierten Liste des Workflows angegeben ist.

Verwenden Sie diesen Prozess:

Öffnen Sie die Maske IDM-Dokument-Workflows.
Erstellen Sie einen neuen Workflow-Datensatz. (Wenn Sie nur ein Attribut zu einem vorhandenen Workflow hinzufügen oder den Namen der Hintergrund-Task-Namen auf Ihren anwenderdefinierten Task-Namen ändern, kopieren Sie den vorhandenen Workflow-Datensatz und löschen das Feld Aktiv für den vorhandenen Datensatz.)
Klicken Sie auf Erweitert, um die Felder für die erweiterte Einrichtung anzuzeigen.

Die Informationen in diesen Feldern definieren die Metadaten, die das Anwendungsereignissystem (AES) verwendet, um Werte aus den Hintergrund-Task-Parametern zu extrahieren. Die Werte werden über eine API an Document Management übergeben.
Geben Sie die folgenden Informationen nach Bedarf für Ihren Workflow an:
Hinweis: Ein Beispiel zur Verwendung einiger dieser Felder finden Sie unter IDM-Dokument-Workflow - Beispiel.
Anzeigen
Wählen Sie die Optionen für die Abschnitte aus, die in der Maske angezeigt werden sollen:
- Der Wert Schlüsseltext wird in AES-Ereignisvariablen aufgelöst, die durch weitere Schlüsseltext-Variablen referenziert werden können. Bis zu 15 Werte oder Formeln können als Schlüsseltext definiert werden. Sie können jeweils fünf Werte gleichzeitig anzeigen.
- Werte für Fertigstellungstext werden in AES-Ereignisvariablen aufgelöst, die durch weitere Variablen des Typs "Fertigstellungstext" referenziert werden können. Bis zu 15 Werte oder Formeln können als Fertigstellungstext definiert werden. Sie können jeweils fünf Werte gleichzeitig anzeigen.
- IDO-Werte werden verwendet, um die Datenquelle (vIdoName) der Suche zu definieren, die verwendet wird, um Document Management-Attributwerte in vIdoPropertyList festzulegen und in vIdoFilter zu filtern.
- Die folgenden Dokumentwerte werden verwendet, um festzulegen, wie das Dokument in Document Management gespeichert wird: der Document Management-Dokumenttyp, der Entitätstyp und die für dieses Dokument zu verwendende Beschreibung.
  Ein entsprechender Dokumenttyp, ein Entitätstyp und eine Beschreibung müssen in Document Management definiert werden.
vKeyText (01-15)

Wählen Sie den Satz für die Schlüsseltextfelder aus, die Sie anzeigen möchten (01-05, 06-10, 11-15). Wenn die Felder angezeigt werden, definieren Sie ggf. eine AES-ähnliche Funktion in jedem Feld. AES bewertet die Funktion oder die Serie von Funktionen, die im ersten Feld definiert wurden, und platziert den Wert in eine Ereignisvariablen mit der Bezeichnung "KeyText01". Wenn im zweiten Feld eine Funktion vorhanden ist, wird diese Funktion ausgewertet, und der zugehörige Wert wird in eine Ereignisvariable mit der Bezeichnung "KeyText02" usw. platziert.

vFinishText (01-15)

Wählen Sie den Satz mit Werten für den Fertigstellungstext aus, die Sie anzeigen möchten (01-05, 06-10, 11-15). Wenn die Felder angezeigt werden, definieren Sie die zu referenzierenden AES-Ereignisvariablen.Ggf. möchten Sie Fertigstellungstext verwenden, wenn Sie das Dokument nicht an AES senden möchten, aber ein bestimmter Wert im Dokument vorhanden ist. In diesen Fällen wird der Prozess beendet oder unterbrochen.

vFinishExpression1, vFinishOperator und vFinishExpression2

Werte für Fertigstellungstexte können verwendet werden, um das AES-Ereignis fertig zu stellen oder zu unterbrechen, wenn sich die Bedingung als wahr herausstellt. Beispiel: Wenn "FinishText01" für die Extrahierung eines bestimmten Werts definiert ist, können Sie eine Unterbrechung von AES anweisen, bevor Sie Inhalte zu Document Management hinzufügen, falls FinishText01 = “NEUDRUCK”.
Wenn Literale für die Fertigstellungsausdrucksvariablen verwendet werden, müssen diese zwischen doppelte Anführungszeichen gesetzt werden, damit AES deren Werte korrekt interpretieren kann.
Der Operator wird in der Regel in der Form von Gleichheitsoperatoren wie =, >= oder <> angezeigt.

vIDOName

Geben Sie den Namen des IDO an, das die Informationen enthält, die Sie als Attributwerte bereitstellen möchten.

vIDOFilter

Geben Sie eine AES-Funktion an, die dem String "C# string.format()" ähnelt, um einen Filter auf dem IDO zu erstellen. Der Filter sucht im IDO nach einem bestimmten Datensatz.

vIDOPropertyList

Geben Sie eine Liste der IDO-Eigenschaften an, die zu diesem in vIdoName aufgeführten IDO gehören. Abgesehen von Untersammlungen ist jeder IDO-Eigenschaftsname gültig, einschließlich UET-Eigenschaften.
Hinweis: Der Document Management-Dokumenttyp, den Sie in vExtDocName angeben, muss Attribute enthalten, die mit den Namen der IDO-Eigenschaften in dieser Liste übereinstimmen. Damit kann das Document Management-Dokument mit den Werten für IDO-Eigenschaften zum Filtern gekennzeichnet werden.

vExtDoc-Name

Geben Sie den Document Management-Dokumenttyp an, der zum Speichern des übermittelten Dokuments verwendet wird. Wenn es sich um einen neuen Dokumenttyp handelt, müssen Sie ihn ebenfalls in Document Management hinzufügen.

vExtMsgEntity

Geben Sie den Entitätstyp an, der in einer JSON-Nachricht aus SyteLine-Masken übertragen wird, in denen dieses Dokument in der Kontextanwendung Verbundene Daten verfügbar sein soll.

vExtDocDescription

Geben Sie eine AES-Funktion an, die eine aussagekräftige Dokumentdatei erstellt, die die Werte für die KeyText-Variable enthält.
Speichern Sie die Änderungen.
Wenn Sie einen Dokumentfluss für einen Bericht einrichten, der nicht in der Workflow-Liste enthalten ist, soll das Dokument wahrscheinlich in der Kontextanwendung Verbundene Daten vorhanden sind, wenn bestimmte verknüpfte SyteLine-Masken angezeigt werden. (Sie möchten beispielsweise, dass die Maske Rückbelastungen CS_SalesInvoice-Dokumente für ein bestimmtes Projekt im entsprechenden Fenster Weitere Informationen anzeigt.) Bestimmen Sie, welche SyteLine-Masken die Dokumente enthalten sollen, und stellen Sie sicher, dass die Web-Container-Nachrichten für diese Masken entsprechend eingerichtet werden. Der Maskenereignis-Handler StdObjectSelectCurrentCompleted muss den Entitätstyp und mindestens einen der Schlüsselwerte (in unserem Beispiel mit Rückbelastungen die Rechnungsnummer (InvNum)) übergeben, der mit dem Dokumenttyp verknüpft ist.
Wenn Ihre Anpassung einen neuen Berichts- oder Dokumenttyp an Document Management sendet, führen Sie die unter Document Management genannten Schritte aus:
- Richten Sie einen neuen Dokumenttyp in Document Management ein, der mit dem Wert vExtDocName übereinstimmt, den Sie im Workflow angegeben haben.
- Richten Sie Attribute für den neuen Dokumenttyp ein. Sie müssen immer die Attribute für die Abrechnungsentität, den Entitätstyp, den Speicherort und die Beschreibung berücksichtigen. Sie können weitere Attribute hinzufügen, die sich auf diesen Dokumenttyp beziehen. Diese Attribute müssen genau den IDO-Eigenschaften entsprechend, die im SyteLine-Dokument-Workflow für diesen Dokumenttyp angegeben wurden.
- Richten Sie eine Zugriffssteuerungsliste für den neuen Dokumenttyp ein.
- Richten Sie ein Geschäftskontextmodell für den neuen Dokumenttyp ein. Dieses Modell enthält eine Zuordnung der kontextbezogenen Informationen, die von SyteLine-Masken an Variablen weitergegeben werden, die die Kontextanwendung Verbundene Daten für diesen Dokumenttyp erwartet.
Weitere Informationen zu diesen Schritten finden Sie im Infor Operating Service-Administrationshandbuch.
Wenn Ihre Anpassung eines der vordefinierten Dokumente für das Senden zusätzlicher Metadaten anpasst, richten Sie alle neuen Attribute in der Zugriffssteuerungsliste für den Dokumenttyp in der Document Management-Anwendung ein. Damit wird sichergestellt, dass die neuen Metadaten für Anwender in Document Management und in der Kontextanwendung Verbundene Daten verfügbar sind. Sie müssen außerdem die neue Attribut-ID zur IDOPropertyList hinzufügen.
Öffnen Sie in SyteLine erneut die Maske Document Management-Dokument-Workflows, und wählen Sie Ihren neuen oder geänderten Hintergrund-Task-Datensatz aus. Klicken Sie auf Aktiv, um den Workflow zu aktivieren.
Generieren Sie in SyteLine das Dokument, für das Sie einen Workflow hinzugefügt oder bearbeitet haben. Stellen Sie sicher, dass das Dokument in Document Management und in der Kontextanwendung Verbundene Daten verfügbar ist.