1 Themenübersicht
Die Hook-Contract-Definitionen „Artikel <Verwendung>“ dienen der Erweiterung der Anwendung „Artikel“.
In dieser Dokumentation ist beschrieben, welche Erweiterungen Sie mit diesen 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
Die Hook-Contract-Definitionen „Artikel <Verwendung>“ stellen folgende Verwaltungsmöglichkeiten zur Verfügung:
- Hinzufügen und Verwalten von neuen Attributen zur primären Business Entity.
- Hinzufügen und Verwalten eines 1:1 Dependents zur primären Business Entity
- Hinzufügen 1:n Dependents zur primären Business Entity
- Hinzufügen der neuen Attributen zu den bestehenden 1:1 Dependents der primären Business Entity
Verwendung | Hook-Contract-Definition |
„Basis“
(Primäres Business Entity com.cisag.app.general.obj.Item) |
com.cisag.app.general.item.hook.log.Item |
„Rechnungswesen“
(Primäres Business Entity com.cisag.app.financials.obj.ItemAccountingData) |
com.cisag.app.general.item.hook.log.ItemFinancialData |
„Lagerlogistik“
(Primäres Business Entity com.cisag.app.inventory.obj.InventoryItem) |
com.cisag.app.general.item.hook.log.InventoryItem |
„Disposition“
(Primäres Business Entity com.cisag.app.inventory.obj.ItemPlanningData) |
com.cisag.app.general.item.hook.log.ItemPlanningData |
„Produktion“
(Primäres Business Entity com.cisag.app.production.obj.ProductionItem) |
com.cisag.app.general.item.hook.log.ProductionItem |
„Beschaffung“
(Primäres Business Entity com.cisag.app.purchasing.obj.PurchaseItem) |
com.cisag.app.general.item.hook.log.PurchaseItem |
„Lieferanten“
(Primäres Business Entity com.cisag.app.purchasing.obj.SupplierPurchaseItem) |
com.cisag.app.general.item.hook.log.SupplierPurchaseItem |
„Vertrieb“
(Primäres Business Entity com.cisag.app.sales.obj.SalesItem) |
com.cisag.app.general.item.hook.log.SalesItem |
„Kunden-Klassifikation“
(Primäres Business Entity com.cisag.app.sales.obj.CustomerClassificationItem) |
com.cisag.app.general.item.hook.log.CustomerClassificationItem |
„Kunden“
(Primäres Business Entity com.cisag.app.sales.obj.CustomerSalesItem) |
com.cisag.app.general.item.hook.log.CustomerSalesItem |
„Kundendisposition“
(Primäres Business Entity com.cisag.app.sales.obj.CustomerPlanningData) |
com.cisag.app.general.item.hook.log.CustomerPlanningData |
3.1 Einschränkungen
Bei der Erweiterung der Anwendung „Artikel“ werden folgende Szenarien nicht unterstützt:
- Die Erweiterung von 1:n Standard-Dependents um neue Attribute und neue Dependents ist nicht möglich.
- Die Vererbbarkeit der Daten wird durch Hooks nicht beeinflusst, d.h. es werden per Hook 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 Verwendungen wird nicht unterstützt, z.B. um beim Vererben der Verwendungen datenabhängige Sperren zu setzen.
3.2 Besonderheiten
3.2.1 Objektsichten
Für jede unterstützte Verwendung existiert eine Objektsicht, die als Parameter in die meisten Hook-Methoden übergeben wird. Die 1:1 Dependents, die ebenfalls erweitert werden können, stehen über Beziehungen als Objektsichten zur Verfügung.
3.2.1.1 Basis
com.cisag.app.general.item.model.Item
1:1 Dependents
- cisag.app.general.item.model.ItemCountryData (Länderdaten)
Beziehung: CommonItemCountryData
GUI: Ansicht “Basis”, Karteireiter „Allgemeines“, Rubrik “Allgemeine Intrastat-Daten”
3.2.1.2 Rechnungswesen
com.cisag.app.general.item.model.ItemAccountingData
1:1 Dependents
- cisag.app.general.item.model.ItemValuationData (Artikelwerte)
Beziehung: CommonItemValuationData
GUI: Ansicht “Rechnungswesen”, Rubrik “Bewertungspreise”
3.2.1.3 Lagerlogistik
com.cisag.app.general.item.model.InventoryItem
1:1 Dependents
- cisag.app.general.item.model.ItemStorageData (Artikel-Lagerortdaten)
Beziehung: CommonItemStorageData
GUI: Sicht “Lagerlogistik”, Karteireiter “Allgemeines”, Rubrik „Klassifikationen“
- cisag.app.general.item.model.ItemIdentifierData (Artikel-Ausprägungsdaten)
GUI: Sicht “Lagerlogistik”, Karteireiter “Allgemeines”, Rubrik „Vorschlagswerte für Ausprägungen“
3.2.1.4 Disposition
com.cisag.app.general.item.model.ItemPlanningData
3.2.1.5 Produktion
com.cisag.app.general.item.model.ProductionItem
1:1 Dependents
- cisag.app.general.item.model.ProductionItemMethod (Produktions-Artikel-Verfahren)
Beziehung: CommonProductionItemMethod
GUI: Sicht „Produktion”, Karteireiter “Allgemeines”, Rubrik „Produktionsverfahren“ (Produktionsverfahren)
- cisag.app.general.item.model.ProductionItemPlanData (Produktions-Artikel-Plan)
Beziehung: CommonProductionItemPlanData
GUI: Sicht „Produktion”, Karteireiter “Allgemeines”, Rubrik „Produktionsverfahren“
3.2.1.6 Beschaffung
com.cisag.app.general.item.model.PurchaseItem
3.2.1.7 Lieferanten
com.cisag.app.general.item.model.SupplierPurchaseItem
3.2.1.8 Vertrieb
com.cisag.app.general.item.model.SalesItem
3.2.1.9 Kunden-Klassifikation
com.cisag.app.general.item.model.CustomerClassificationItem
3.2.1.10 Kunden
com.cisag.app.general.item.model.CustomerSalesItem
3.2.1.11 Kundendisposition
com.cisag.app.general.item.model.CustomerPlanningData
3.2.2 Import/Export, Artikel-Vorlagen
Für Erweiterung des Import/Export-Prozesses sowie der Anwendung “Artikel-Vorlagen” steht folgende Hook-Contract-Definition
com.cisag.pgm.bi.Controller (“Hooks für BIS-Controller und BIS-Registry”).
3.2.3 Artikel-Reorganisation
Mit Apps können zu den Business Entitys neue Attribute hinzugefügt werden, die den Artikel referenzieren. Es besteht auch die Möglichkeit, dass eine der Artikel-Verwendungen neue Dependents erhält. Die Artikel-Reorganisation muss auch diese berücksichtigen.
Der Hook
com.cisag.app.general.item.hook.log.ItemRegistryHook
aus der Hook-Contract-Definition
com.cisag.app.general.hook.log.RegistryExtensions
stellt die Möglichkeit zur Verfügung die neuen Dependents oder Referenzierungen bei der Artikel-Reorganisation zu registrieren.