1                     Themenübersicht

Die Hook-Contract-Definitionen für die Anwendung „Partner“ dienen der Erweiterung der Anwendung. 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 in zugehörigen Entwicklungsobjekten 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

Hook-Contract-Definitionen bieten die Möglichkeit, den bestehenden Programmcode an den dazu festgelegten Einstiegspunkten durch eigenen Programmcode zu ändern. Die Hook-Contract-Definitionen für die Anwendung „Partner“ ermöglichen Ihnen beispielsweise Änderungen zu folgenden Themen:

• Vorschlagswertermittlung
• Prüfungen
• Änderungen zu Attributen des primären Business Entitys
• Hinzufügen von 1:n-Dependents zum primären Business Entity
• Änderungen zu 1:1-Dependents des primären Business Entitys
• Änderungen zu Attributen der 1:1-Dependents des primären Business Entitys

Hinweis:

Die Erweiterung von Hashcode-Business-Objects um neue Attribute wird nicht empfohlen. Stattdessen sollten entweder die primären Business Objects (z. B. Partner) erweitert oder neue Hashcode-Business-Objects definiert werden. Weitere Informationen finden Sie in der Dokumentation „Hook-Contract-Definition: HashCodeInfo“.

Folgende Hook-Contract-Definitionen stehen zur Verfügung. Zu jeder Hook-Contract-Definition ist zusätzlich die Hauptobjektsicht angegeben.

3.1        Einschränkungen

Bei der Erweiterung der Anwendungen „Partner“ und „Partner-Vorlagen“ werden folgende Szenarien nicht unterstützt:

• Die Erweiterung von 1:n-Standard-Dependents um neue Attribute und neue Dependents ist nicht möglich.
• Die Erweiterung von Standard-Dependents um neue Dependents ist nicht möglich.
• Die Vererbbarkeit der Daten wird durch Hooks nicht beeinflusst, d. h. per Hook werden keine Möglichkeiten geschaffen, die Vererbbarkeitsprüfung der Daten zu beeinflussen. Die entsprechenden Prüfungen können nur in den bestehenden Prüfmethoden eingebaut werden.
• Die Definition neuer Abhängigkeiten zwischen verschiedenen Partnerrollen wird nicht unterstützt, z. B. um beim Vererben der Rollen datenabhängige Sperren zu setzen.
• Die Ansicht „Beziehungen“ ist nicht erweiterbar.

Anpassbare Oberfläche

Für die anpassbare Oberfläche der Anwendung „Partner“ sind folgende Einschränkungen zu beachten:

• Gegebenenfalls sind die Karteireiter „Ansprechpartner“, „Text“ und „Statistik“ nicht anpassbar.
• Die Karteireiter „Bankverbindungen“ in der Rechnungswesen-Ansicht und „Kommunikationsverbindungen“ in der Basis-Ansicht sind nicht anpassbar.
• Die Reihenfolge der Felder in der Rubrik „Kommunikationsverbindungen“ wird nach wie vor über die Priorität der Kommunikationsmethoden gesteuert.
• Weitere Meldungen können nicht mit den vorhandenen Partnerbeziehungsfeldern verknüpft werden.
• Das Verschieben der Felder zwischen den Ansichten der Anwendung wird nicht unterstützt.

3.2        Besonderheiten

Beachten Sie bitte die Besonderheiten zu folgenden Themen:

• Import/Export, Partner-Vorlagen
• Partner-Reorganisation
• Anpassbare Oberfläche

3.2.1          Import/Export, Partner-Vorlagen

Für die Erweiterung des Import/Export-Prozesses sowie der Anwendung „Partner-Vorlagen“ steht der Hook Contract „Hooks für BIS-Controller und BIS-Registry“ (com.cisag.pgm.bi.Controller) zur Verfügung.

3.2.2    Partner-Reorganisation

Mit folgendem Hook steht die Möglichkeit für Apps zur Verfügung, die neuen Dependents oder Referenzierungen für die Partner-Reorganisation zu registrieren:

Hook:

com.cisag.app.general.partner.hook.log.PartnerRegistryHook

Aus der Hook-Contract-Definition:

com.cisag.app.general.hook.log.RegistryExtensions

3.2.3          Anpassbare Oberfläche

Die Layouts für die Anwendungen „Partner“, „Mitarbeiter“, „Kunden“, „Lieferanten“ und „Kontakte“ werden pro Anwendung festgelegt und sind unabhängig voneinander.

Um das Layout für die Ansicht „Mitarbeiter“ festlegen zu können, muss man vor dem Wechsel in den Designmodus entweder die Daten zu einer Person öffnen oder die Aktion „Neue Person“ ausführen.