Integration Events für Entwickler

Connector 365 Easy Batch bietet verschiedene Integration Events, die es Entwicklern ermöglichen, die Funktionalität der App zu erweitern und an spezifische Anforderungen anzupassen.

Diese Dokumentation richtet sich an AL-Entwickler. Grundkenntnisse in der Business Central Extension-Entwicklung werden vorausgesetzt.

OnBeforeGetRecipientAccountNo

Dieses Event wird aufgerufen, bevor die Empfängeradressen ermittelt werden. Es ermöglicht das Setzen einer abweichenden Empfängernummer (Kreditoren/Debitoren-Nr.).

Verwendung
1
2
3
4
5
6
7
8
[IntegrationEvent(false, false)]
local procedure OnBeforeGetRecipientAccountNo(
IsSalesDoc: Boolean;
RecRef: RecordRef;
ReportUsage: Enum "Report Selection Usage";
var RecipientAccountNo: Code[20];
var IsHandled: Boolean
)
Parameter
Parameter Typ Beschreibung
IsSalesDoc: Boolean Zeigt an, ob es sich um einen Verkaufsbeleg handelt
RecRef RecordRef Enthält den Datensatz des aktuellen Belegs
ReportUsage Enum “Report Selection Usage” Enthält die aktuelle Berichtsverwendung
RecipientAccountNo Code[20] Legt die Nr. des Empfängerkontos fest, anhand der Debitor/Kreditor ermittelt wird
IsHandled Boolean Muss auf true gesetzt werden, damit die bestimmte Nummer des Empfängerkontos verwendet wird
Beispiel
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[EventSubscriber(ObjectType::Codeunit, Codeunit::"BEL365 Base", 'OnBeforeGetRecipientAccountNo', '', false, false)]
local procedure OnBeforeGetRecipientAccountNo(
    IsSalesDoc: Boolean;
    RecRef: RecordRef;
    ReportUsage: Enum "Report Selection Usage";
    var RecipientAccountNo: Code[20];
    var IsHandled: Boolean
)
var
    SalesHeader: Record "Sales Header";
    DocumentRecRef: RecordRef;
begin
    if ReportUsage = ReportUsage::"Sales Order":
        begin
            RecRef.SetTable(SalesHeader);
            RecipientAccountNo := SalesHeader."Sell-to Customer No.";
            IsHandled := true;
        end;
end;
Verwendungszweck

Verwenden Sie dieses Event, wenn Sie:

  • Für bestimmte Belegarten, die Empfängerdaten anhand eins abweichenden Debitors/Kreditors setzen möchten

Best Practices

  1. Prüfen Sie immer den Record-Typ: Verwenden Sie RecordRef.Number oder RecordRef.Name, um sicherzustellen, dass Sie den richtigen Datensatz bearbeiten
  2. Setzen Sie IsHandled bewusst: Diese Parameter bestimmen, ob die Standard-Verarbeitung durchgeführt wird
  3. Testen Sie gründlich: Events greifen tief in die Kernlogik ein und sollten ausführlich getestet werden
  4. Dokumentieren Sie Ihre Erweiterungen: Halten Sie fest, welche Events Sie verwenden und warum

Weitere Informationen

Für detaillierte technische Informationen und weitere Events konsultieren Sie bitte die AL-Objektdokumentation in Ihrer Entwicklungsumgebung oder wenden Sie sich an den BELWARE Support.

Kompatibilität

Event Verfügbar ab Version
OnBeforeGetRecipientAccountNo 2.34.0.0
Events können sich in zukünftigen Versionen ändern. Beachten Sie die Release Notes bei Updates der App.