Motivation
Mit Release 133 wird die Erstellung von Debtiorenrechnungen einen tiefgreifenden Umbau erfahren. Die Auswirkungen auf die Templates und Formularentwicklung werden in diesem Kapitel erläutert.
Folgende Templates sind betroffen und müssen gegebenenfalls im kundenindividuellen Projekt angepasst werden:
- debitorInvoice.rptdesign
- debitorInvoiceRLM.rptdesign
Dieses Dokument beschreibt die Änderungen und nötigen Schritte zur Migration.
Empfohlenes Vorgehen
Um die betroffenen Templates im kundeneigenen Projekt anzupassen und die Auswirkungen des zukünftigen Datenmodells direkt nachvollziehen zu können, wurde mit Release 133 eine neue Grundeinstellungen eingeführt: DEBITOR_INVOICE_REMOVE_DEPRECATED_VALUES. Diese kann die Werte “true”/”false” annehmen und wird im Standard mit “false” ausgeliefert.
Die Auswirkungen der Grundeinstellung sind wie folgt: Bei Bestimmung der an die UI bzw. Formularschicht (Datasets) gereichten Werte einer Debitorenrechnung werden bestimmte Felder gefüllt oder nicht. Diese Felder basieren teilweise auf überholten Datenstrukturen.
Ist die Grundeinstellung mit Wert “false” belegt, werden die überholten Datenstrukturen ausgegeben und somit sollten alle bisherigen Entwickungen wie bisher funktionieren. Um die Formularentwicklung auf Basis der neuen Datenstrukturen umzusetzen, sollte daher die Grundeinstellung auf “true” gesetzt werden. Dadurch werden ausschließlich die neuen Datenstrukturen gefüllt und es sollte möglich sein, die fehlenden Informationen zu identifizieren.
Mit Release 133 wurden die Standardtemplates von NLI auf die neuen Datenstrukturen angepasst und können als Vorlage verwendet werden. Welche Datasets betroffen sind, können der im folgenden Kapitel aufgeführten Tabelle entnommen werden.
Temporäre Lösung: Verwendung alter Datasets
Um in einem ersten, weniger arbeits-intensiven Schritt die Templates zu aktualisieren, sind nur die Verwendungen der Full-Qualified Package-Namen zu ändern.
Vorheriges Package:
myBusinessSupplier\contract\java\src\main\java\com\nextlevel\fastlane\myBusinessSupplier\contract\reporting\
Neues, vorübergehendes Package:
myBusinessSupplier\contract\java\src\main\java\com\nextlevel\fastlane\myBusinessSupplier\contract\reporting\deprecated
Im Zuge der Auslieferung von Release 133 werden alle bisherigen DataSets im Ordner “reporting\deprecated” in ihrer bisherigen Ausprägung bereitgestellt.
Eventuell gleichnamige DataSets werden im Ordner “reporting” sind bereits auf die neuen Datenstrukturen angepasst.
Umbau auf DebitorInvoiceItems / Verwendung neuer Datasets
Perspektivisch sind alle DataSets im Ordner “deprecated” von der Verwendung zu auszuschließen. D.h. es müssen die neuen DataSets bzw. Datenobjekte verwendet werden.
Die Tabelle im folgenden Kapitel gibt eine komplette Übersicht aller überholten und neuen bzw. überarbeiteten DataSets.
Übersicht DataSets
Verwendung der DataSets in einer Beispielrechnung
Die folgenden Bilder zeigen eine NLI-Standard Rechnungs-PDF (SLP-Kunde, debitorInvoice.rptdesign). Die betroffen DataSets sind hervorgehoben.
Liste der neuen DataSets
| reporting (Release 133) | reporting/deprecated (Release < 133) | Änderungen / Handlung | Beschreibung |
|---|---|---|---|
| InvoiceAdditionalPositionsDataSet | - | - | Ersetzt auf Seite 1 verschiedene DataSets zu Einzelpositionen, z.B. Boni, Gutschriften, Mahngebühren u.ä. |
Liste der überarbeiteten Datasets
| reporting (Release 133) | reporting/deprecated (Release < 133) | Änderungen / Handlung | Beschreibung |
|---|---|---|---|
| InvoiceConsumptionsDataSet | InvoiceConsumptionsDataSet | Neues Objekt DebitorInvoiceConumptions eingeführt | Block “Verbrauch” |
| DebitorInvoiceMeterDataSet | DebitorInvoiceMeterDataSet | Neues Objekt DebitorInvoiceConumptions eingeführt | Block “Verbrauch” |
| DebitorInvoiceDataSet | DebitorInvoiceDataSet | Korrektur Berechnung Gesamtwert | Enthält übergreifende Werte |
| - | InvoiceCreditChargebacksDataSet | Zu ersetzen durch InvoiceAdditionalPositionsDataSet, neues Objekt DebitorInvoiceItem eingeführt | wird im NLI-Standard nicht mehr verwendet |
| - | InvoiceDebitChargebacksDataSet | Zu ersetzen durch InvoiceAdditionalPositionsDataSet, neues Objekt DebitorInvoiceItem eingeführt | wird im NLI-Standard nicht mehr verwendet |
| - | InvoiceOldOpenEntriesDataSet | Zu ersetzen durch InvoiceAdditionalPositionsDataSet, neues Objekt DebitorInvoiceItem eingeführt | wird im NLI-Standard nicht mehr verwendet |
| InvoiceExpensesDataSet | InvoiceExpensesDataSet | Neues Objekt DebitorInvoiceItem und InvoiceExpenseRendered eingeführt | Block “Abrechnungsrelevante Positionen” |
| InvoiceExpensesRealDataSet | InvoiceExpensesRealDataSet | Neues Objekt DebitorInvoiceItem und InvoiceExpenseRendered eingeführt | Block “Informationen Netznutzung” |
| InvoicePayedAdvancedPaysDataSet | InvoicePayedAdvancedPaysDataSet | Neues Objekt DebitorInvoiceItem eingeführt | wird im NLI-Standard nicht mehr verwendet |
| - | InvoicePayedAdvancedPaysRenderedDataSet | - | wird im NLI-Standard nicht mehr verwendet |
| InvoiceServiceBaseFeeDataSet | InvoiceServiceBaseFeeDataSet | Neues Objekt DebitorInvoiceItem eingeführt | Block “Abrechnungsrelevante Positionen” |
| InvoiceServicesDataSet | InvoiceServicesDataSet | Neues Objekt DebitorInvoiceItem eingeführt | Block “Abrechnungsrelevante Positionen” |
| InvoiceServicesGroupsDataSet | InvoiceServicesGroupsDataSet | Neues Objekt DebitorInvoiceItem / DebitorInvoiceConsumptions eingeführt | Block “Abrechnungsrelevante Positionen” |
| - | InvoicServicesByTimeSliceDataSet | Zu ersetzen durch InvoiceServicesDataSet / InvoiceServicesGroupsDataSet | wird im NLI-Standard nicht mehr verwendet |
| - | MBSRegisterConsumptionDataSet | Zu ersetzen InvoiceConsumptionsDataSet | wird im NLI-Standard nicht mehr verwendet |
| - | OtherOpenInvoicesDataSet | Zu ersetzen durch InvoiceAdditionalPositionsDataSet | wird im NLI-Standard nicht mehr verwendet |
Liste der überarbeiteten Rendered-Objekte
| reporting (Release 133) | reporting/deprecated (Release < 133) | Änderungen / Handlung | Beschreibung |
|---|---|---|---|
| InvoiceExpensesRendered | InvoiceExpensesRendered | Neues Objekt DebitorInvoiceItem eingeführt | Verwendung in InvoiceExpensesDataSet und InvoiceExpensesRealDataSet |
| InvoiceServicesGroup | InvoiceServicesGroup | Neues Objekt DebitorInvoiceItem eingeführt | Verwendung in InvoiceServicesGroupsDataSet |
| PriceComponentsInSlice | PriceComponentsInSlice | Neues Objekt DebitorInvoiceItem eingeführt | Verwendung in InvoiceServicesGroupsDataSet |
| - | RegisterConsumptionRendered | Zu ersetzen durch DebitorInvoiceConsumptionReport | wird im NLI-Standard nicht mehr verwendet |