1              Themenübersicht

Die Hook-Contract-Definition dient der Registrierung eines Belegtyps und definiert die dazugehörigen Eigenschaften.

Die Standard Belegtypen werden auch auf die Verwendung dieser Hook-Contract-Definition umgestellt und können daher als Beispielimplementierungen herangezogen werden.

In dieser Dokumentation ist beschrieben, welche Erweiterungen Sie mit den Hook-Contract-Definitionen vornehmen können und welche Einschränkungen und Besonderheiten Sie beachten müssen.

Eine Schnittstellenbeschreibung finden Sie im zugehörigen Entwicklungsobjekt vom Typ Hook Contract. Ausführliche Informationen zu den in den Schnittstellen deklarierten Methoden finden Sie in den zugehörigen Java-Klassen.

Informationen zur Hook-Infrastruktur finden Sie in der Dokumentation „Hook Contracts“.

2              Zielgruppe

• Entwickler

3              Beschreibung

Diese Hook-Contract-Definition liefert Informationen über einen Beleg.
Insbesondere sind die folgenden notwendig:

• Der Belegtyp (order type)
• Die Klasse des Business-Objects „Typ“
• Die Klasse des Business-Objects „Header“
• Die Klasse des Business-Objects „Detail“
• falls der Beleg Positionen unterstützt, ansonsten
• Ob in den Kopfdaten eine mehrsprachige Beschreibung vorhanden ist.

Zusätzlich sind noch die folgenden optionalen Informationen möglich

• Die Klasse, die für die Reorganisation dieses Belegs zuständig ist.
• Der Nummernkreis der für die Formatierung der Belegnummern für Kopf und Positionen verwendet wird.

Hook-Contract-Definition: com.cisag.app.general.order.hook.OrderType

Als Beispiel-Implementierung kann die Hook-Contract-Implementierung com.cisag.app.sales.order.OrderTypeSalesOrderImpl für den Belegtyp „Vertriebsauftrag“ dienen.

Hinweis:

Belegtypen, die über diesen Hook registriert werden, werden auch automatisch für inhaltsbezogene Berechtigungen registriert. Hierbei wird auch der Parametername für den Suchkontext festgelegt, abgeleitet aus dem Business-Objekt. Nur wenn Sie einen abweichenden Kontextnamen benötigen, müssen Sie auch den HookContract für Hook-Contract-Definition: Registrierungen implementieren – dieser wirkt dann stärker.

3.1        Besonderheiten

Durch Apps können keine Valuesets erweitert werden. Wenn in einem App ein komplett neuer Belegtyp eingeführt wird, so muss das Valueset com.cisag.app.general.OrderType im Standard erweitert werden.

Diese Erweiterung muss durch die Standardentwicklung erfolgen. Falls Sie dies benötigen, erstellen Sie bitte einen Erweiterungswunsch beim Supportcenter.

Solche Erweiterungen des Valuesets müssen bestimmten Namenskonventionen für den Valueset Eintrag EP_APP_SN genügen. Bitte geben Sie die folgenden Informationen in Ihrem Erweiterungswunsch an.

• EP Entwicklungspräfix
• APP Name des Apps innerhalb des Entwicklungssystem
• SN Spezifischer Name des Eintrags
  (einzelne Worte werden durch „_“ getrennt)

Die einzelnen Bestandteile des Namens enthalten jeweils nur Grossbuchstaben.

Zusätzlich muss noch eine eindeutige Bezeichnung in deutsch und englisch für jeden Eintrag erfolgen.

Hinweis:

Normalerweise entspricht die Bezeichnung dem Namen des Business-Objekts der Kopfdaten.

Beispiel: SEM_SERVICE_SERVICE_REQUEST

• EP                     sem
• APP                     service
• SN                     service request
• Bezeichnung (DE) Servicemeldung
• Bezeichnung (EN) Service request