Wichtige Hinweise
Werden in einem PBO/PAI-Zyklus zu viele Knoten zu dem SAP Tree übertragen, kann es zu einem Timeout-Abbruch kommen. Im Kapitel Inkrementeller Baumaufbau wird beschrieben, wie die Übertragungsmenge klein gehalten werden kann.
Sollen viele Teilobjekte geändert werden (z.B. 20 Texte), so sollte aus Performance-Gründen eine Methode mit Tabellenschnittstelle (update_nodes_and_items bzw. update_nodes) verwendet werden, statt 20 Einzelmethoden zu rufen. Dieses gilt auf für andere Operationen, wie das Expandieren usw.
In einem PBO/PAI-Zyklus sollten Methoden mit einer Tabellenschnittstelle nicht mehrfach gerufen werden. Anstatt 20 Methodenaufrufen ADD_NODES_… mit je 5 Knoten, sollte ein Aufruf mit allen 100 Knoten verwendet werden.
Die Exceptions des SAP Tree Methoden setzen keine Nachrichten.
Die Exceptions des SAP Tree Methoden und von Flush-Aufrufen dürfen auf keinen Fall ignoriert werden. Tritt ein Fehler auf, wird die Abarbeitung der Automation Queue abgebrochen. Hiervon sind sämtliche Controls eines internen Modus betroffen. Nach dem Auftreten des Fehlers darf ein interner Modus nicht mehr mit Controls weiterarbeiten.
Der SAP Tree ist prinzipiell nicht zur Darstellung von Listen ohne Hierarchie geeignet, da bei einem SAP Tree immer alle Wurzelknoten zum Control übertragen werden müssen. Listen mit vielen Einträgen führen somit zu Performance Problemen.
Fehlersuche
Läuft ein bisher korrektes Programm nicht mehr, sollte zunächst überprüft werden, ob die SAP Tree Beispiele noch funktionieren.
Fehler bei der Controlverarbeitung treten meist erst beim Aufruf der Methode flush auf. Die Ausnahme CNTL_ERROR sagt zunächst nur aus, dass irgend ein Fehler bei den Controls am Frontend aufgetreten ist. Der Fehler muss nicht beim SAP Tree liegen, sondern kann von einem anderen Control ausgelöst worden sein.
Für die Fehlersuche sollten Sie das Programm im Debugging erneut starten. Wählen Sie im Debugger das Bild für die Einstellungen. Markieren Sie in den Einstellungen das Ankreuzfeld Automation Controller: Aufträge immer synchron verarbeiten (siehe Services rund um die Automation Queue). Jetzt liefern die einzelnen Methoden des SAP Tree genauere Informationen über die Fehlerursachen.