Regelbasierter nächster Prozessschritt: Belege in „Individuelle Verarbeitung“ steuern

Zielgruppe

Diese Anleitung richtet sich an Entwickler und Implementierer, die DEXPRO SQUEEZE in Business Central einsetzen und vor der eigentlichen „Individuelle Verarbeitung“-Implementierung steuern möchten, welche Belege nach der Validierung in den Status „Individuelle Verarbeitung“ wechseln sollen.

Einordnung (kommt vor der bestehenden Custom-Processing-Anleitung)

Mit dieser Konfiguration sorgst du dafür, dass ein Beleg (abhängig von Regeln) den Status „Individuelle Verarbeitung“ erhält. Ab diesem Zeitpunkt greift dann der in der bestehenden Dokumentation beschriebene Ablauf zur benutzerdefinierten Verarbeitung (Erstellen von Zieldokumenten aus „JSON Processed“).

Weiterführend (nächster Schritt, nach dieser Dokumentation):

• Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)

Verwendete (UI-)Begriffe

Die nachfolgenden Begriffe entsprechen den deutschen Beschriftungen aus den de-DE Übersetzungen:

• „Individuelle Verarbeitung“ = DXP Document Status / Custom Processing
• „Nächster Prozessschritt“ = Next Process Step
• „Standardbeleg“ = Enum-Wert Standard document
• „Regelsatz“, „Regelsatzcode“ = Rule Set, Rule Set Code
• „Regelgruppe“, „Regelgruppencode“ = Rule Group, Rule Group Code

Technischer Hintergrund

• Pro Dokumentenklasse gibt es eine Dokumentenklasseneinrichtung (DXP Document Class Setup).
• Für jede Dokumentenklasseneinrichtung wird automatisch ein SQUEEZE-Regelsatz angelegt (intern: Feld „DXP Sqz Rule Set Code“).
• In der Dokumentenklasseneinrichtung wird ein Regelgruppencode hinterlegt (intern: Feld „DXP Sqz Next Step Rule Group“).
• Beim Ermitteln des nächsten Prozessschritts werden die Regeln dieser Regelgruppe ausgewertet.
• Wenn eine Regel zutrifft und
  • Nächster Prozessschritt = „Standardbeleg“ und
  • Individuelle Verarbeitung = Ja dann wird der Dokumentstatus auf „Individuelle Verarbeitung“ gesetzt.

Wichtig:

• Ist keine Regelgruppe hinterlegt oder keine Regel zutreffend, wird auf den Standardwert „Nächster Prozessschritt“ aus der Dokumentenklasseneinrichtung zurückgefallen.

Voraussetzungen

• DEXPRO Core + DEXPRO SQUEEZE sind installiert.
• Du hast Zugriff auf die Einrichtung Dokumentenklasseneinrichtung (DXP Document Class Setup) sowie auf die Regel-Engine-Seiten (Regelgruppen/Regeln).

Schritt-für-Schritt: Regelgruppe „DXP Sqz Next Step Rule Group“ anlegen und verknüpfen

1) Dokumentenklasseneinrichtung öffnen

1. Öffne die Seite Dokumentenklasseneinrichtung.
2. Wähle die Dokumentenklasse aus, für die du das Routing auf „Individuelle Verarbeitung“ aktivieren willst.
3. Scrolle in den Bereich Squeeze → Gruppe Regeln.

2) Regelgruppe anlegen

1. In Squeeze → Rules wähle das Feld „Nächster Prozessschritt“ (technisch: DXP Sqz Next Step Rule Group).
2. Öffne die Auswahl/Lookup (Regelgruppenliste).
3. Lege eine neue Regelgruppe an:
   • Regelgruppencode: z. B. Next Step Rules
   • Beschreibung: z. B. „Routing nach Individuelle Verarbeitung“

Hinweis: Der Lookup ist durch die Dokumentenklasse bereits auf den passenden Regelsatzcode gefiltert. Du musst den Regelsatz nicht manuell suchen.

3) Regelgruppe in der Dokumentenklasseneinrichtung speichern

1. Stelle sicher, dass in der Dokumentenklasseneinrichtung im Feld „Nächster Prozessschritt“ jetzt der Regelgruppencode DXP Sqz Next Step Rule Group steht.

Schritt-für-Schritt: Regel erstellen, die auf „Individuelle Verarbeitung“ routet

4) Regeln der Regelgruppe öffnen

1. Öffne die soeben angelegte Regelgruppe DXP Sqz Next Step Rule Group.
2. Wähle die Aktion „Regeln anzeigen“ (öffnet die Regeln dieser Regelgruppe).

5) Neue Regel anlegen

1. Lege eine neue Regel an.
2. Lege eine sinnvolle Priorität fest (niedriger Wert = höhere Priorität, falls eure Umgebung so konfiguriert ist).
3. Definiere die Bedingungen (Rule Conditions), die zutreffen müssen.

[Best Practice] Starte mit einer sehr klaren, testbaren Bedingung (z. B. anhand von Belegtyp, Lieferant, Betragsschwellen, Mandant/Company, etc.), bevor du komplexe Regelketten aufbaust.

6) SQUEEZE-spezifische Felder setzen (entscheidend für „Individuelle Verarbeitung“)

Auf der Regelkarte gibt es den Bereich „DEXPRO Squeeze“ (CardPart). Setze dort:

1. Nächster Prozessschritt = „Standardbeleg“
2. Individuelle Verarbeitung = Ja

Ergebnis:

• Wenn diese Regel zutrifft, wird der Belegstatus auf „Individuelle Verarbeitung“ gesetzt.

Optional:

• Kontierungscode [Account Assignment Code] (falls du zusätzlich eine Kontierungslogik über Regeln steuern möchtest; unabhängig vom Custom-Processing-Routing).

Prüfen / Troubleshooting

Beleg landet nicht in „Individuelle Verarbeitung“

Gehe diese Punkte durch:

1. Regelgruppe hinterlegt? In der Dokumentenklasseneinrichtung muss der Regelgruppencode gesetzt sein (sonst fällt das System auf Standard „Nächster Prozessschritt“ zurück).
2. Trifft eine Regel zu? Wenn keine Regel zutrifft, wird der nächste Prozessschritt nicht überschrieben.
3. Ist „Individuelle Verarbeitung“ gesetzt UND Next Step = „Standardbeleg“?
   • Wenn „Individuelle Verarbeitung“ = Ja, aber Next Step ≠ „Standardbeleg“, wird der Status nicht auf „Individuelle Verarbeitung“ gesetzt.
4. Siehst du den Bereich „DEXPRO Squeeze“ auf der Regelkarte nicht?
   • Dann befindest du dich sehr wahrscheinlich in einem Regelsatz, der nicht zur Dokumentenklasseneinrichtung (Quelltabelle) gehört.
   • Lege die Regelgruppe im besten Fall über den Lookup aus der Dokumentenklasseneinrichtung an. Damit sparst du dir den Weg über die allgemeine Regelverwaltng

Beleg landet in „Fertig“ statt „Individuelle Verarbeitung“

Wenn eine Regel zutrifft und Nächster Prozessschritt auf einen Wert ungleich „Standardbeleg“ gesetzt wird, kann der Status auf „Fertig“ gesetzt werden (damit wird weitere Verarbeitung übersprungen). Prüfe daher die Next-Step-Auswahl in der Regel. Das ist zum Beispiel der Fall, wenn die App Breeze Interface benutzt wird.

Danach (Übergang in die bestehende Doku, zur individuellen Belegerstellung)

Sobald ein Beleg im Status „Individuelle Verarbeitung“ ist, ist es bereit für die Verarbeitung:

• „JSON Processed“ aus DXP Document lesen
• Zieldokumente erstellen
• finalen Status setzen