1                     Themenübersicht

In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Vertriebsangebote beschrieben. Diese Vorgehensweisen ent­hal­ten allgemeine Anleitungsschritte und welche Besonderheiten zu berücksichtigen sind. Sie werden außerdem über mögliche Vorausset­zungen und Auswirkungen informiert.

Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Doku­men­tation „Daten importieren“.

2                     Allgemeines

Der Import eines Vertriebsangebots basiert im Wesentlichen auf dem aktuellen Datenmodell, welches in der Repository-Datenbank hinterlegt ist. Für den Datenexport stehen mehr Attribute als für den Datenimport zur Verfügung. Deshalb ist sinnvoll, für den Export und Import separate Filter festzulegen.

1:1-Beziehungen basieren im Datenmodell in der Regel auf einem technischen GUID-Attribut. Je nach Anwendungsfall kann beim Import entweder das technische GUID-Attribut verwendet werden oder der fachliche Schlüssel aus dem Ziel-Objekt (meist code oder number). Bei einigen Business Objects ist für die Umwandlung fachlicher Schlüssel zu technischem Schlüssel eine Organisation notwendig. Die jeweils relevante Organisation steht im Normalfall nicht direkt in der Import-Quelle, sondern ist über den Belegkontext vorgegeben. Weitere Informationen dazu finden Sie im Kapitel „Übersicht: Attribute“.

Sowohl in der Basis als auch in der Position eines Vertriebsangebots werden Hash-Code-Business-Objects referenziert. Das sind fachlich zusammengehörende Attributgruppen, die für viele Angebote immer wieder gleich sind und somit durch Wiederverwendung einigen Speicherplatz in der Datenbank und im Hauptspeicher spart. Über eine spezielle Konvertierung stellen sich die Hash-Code-Business-Objects für den Export bzw. Import wie Parts dar.

Bestimmte Daten der Vertriebsangebote wie Hauswährungswerte, Artikelkonfiguration und deren Konfigurationspositionen sowie interne Hilfsattribute können nicht importiert werden.

Wenn Sie sich nicht sicher sind, welches das geeignete Format der Importdatei ist, dann gehen Sie wie folgt vor: Erfassen Sie über die Anwendung „Vertriebsangebote“ ein Beispiel-Vertriebsangebot und exportieren Sie dieses mit dem Filter für den Import im gewünschten Format mit den gewünschten Attributen. Die so entstehende Beispieldatei lässt sich als Vorlage für die zu erzeugenden Importdateien verwenden.

Beim Import gelten die gleichen Regeln wie bei der Bearbeitung über die Anwendung. Zum Beispiel kann in einer gespeicherten Position der Artikel nicht mehr nachträglich geändert werden. Attributwerte werden ignoriert, wenn sie im aktuellen Kontext nicht übernommen werden können. Ebenso wird bei der Vorschlagswertermittlung die gleiche Logik durchlaufen, sodass sich Import und Anwendung identisch verhalten. Gleiches gilt für die Prüfungen.

Hinweis:

Bestehende Vertriebsangebote können durch den Import zusätzlicher Daten erweitert werden. Die bestehenden Daten werden – sofern möglich – durch die Importdaten ersetzt.

3                     Vorgehensweise: Vertriebsangebote importieren

1. Öffnen Sie die Anwendung „Daten importieren“.
2. Lassen Sie sich den bzw. einen Filter für dieses Business Object anzeigen: cisag.app.sales.obj.CustomerProposal

• Der Filter für den Import von Vertriebsangeboten wird geöffnet.

3. Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für dieses Business Object.
4. Ändern Sie bei Bedarf die bereits ausgewählten Attribute des Filters.
5. Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.

• Das Dialogfenster „Daten importieren“ wird geöffnet.

6. Im Dialogfenster „Daten importieren“ können Sie Einstellungen für die Import­datei vornehmen. Eine Beschreibung der Felder finden Sie in der Dokumen­tation „Daten importieren“.
7. Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.

• Der Import wird ausgeführt.

4                     Automatische Freigabe nach dem Import

Sofern der Import erfolgreich durchgeführt wurde, können Sie ein bearbeitetes Vertriebsangebot automatisch nach dem Import freigeben lassen. Diese Möglichkeit ist insbesondere in Kombination mit dem Eröffnungsstatus „In Bearbeitung“ (siehe Art) sinnvoll. So verhindern Sie, dass ein noch nicht vollständig importiertes Vertriebsangebot bereits in Folgebelegen verwendet werden kann. Während der Freigabe hat das Vertriebsangebot den Status „Ungültig“, sodass das Vertriebsangebot auch in diesem Schritt nicht verwendet werden kann.

Für diese Funktionalität müssen Sie für die relevante Instanz das virtuelle Basis-Attribut autoRelease auf den Wert true setzen.

Ist diese Funktion aktiviert und bestehen keine sonstigen Fehler, dann wird im Meldungsprotokoll eine zusätzliche Informationsmeldung mit dem Hinweis ausgegeben, dass das Vertriebsangebot automatisch freigegeben wurde. War dies nicht möglich, dann wird eine Warnung ausgegeben.

5                     Angebotsentwürfe importieren

5.1               Angebotsversionen nach dem Import eines Entwurfs erzeugen

Angebotsversionen können nicht direkt per Import erzeugt werden. Bei ihnen muss immer der Entwurf importiert werden. Sofern der Import des Entwurfs erfolgreich durchgeführt wurde, können Sie automatisch eine neue Version erzeugen lassen. Voraussetzung dafür ist, dass in der Angebotsart des Entwurfs eine Angebotsart für Versionen hinterlegt ist. Andernfalls wird ein Fehler ausgegeben.

Für diese Funktionalität müssen Sie für die relevante Instanz das virtuelle Basis-Attribut createNewVersion auf den Wert true setzen.

Hinweis:

Das virtuelle Basis-Attribut createNewVersion wird nach dem virtuellen Basis-Attribut autoRelease ausgewertet.

5.2               Angebotsalternativen importieren

Angebotsalternativen können Sie per Import erzeugen lassen. Dafür müssen Sie sowohl in der Basis den Entwurf angeben, als auch in der Position die zu verwendende Entwurfsposition. Bei aktiven Positionen mit Alternativen können Sie nur die aktive Position oder eine der Alternativen auswählen.

6                     Übersicht: Attribute

Nachfolgend sind die Attribute der einzelnen Business Objects aufgeführt, die für den Import zur Verfügung stehen. Bei Fremdschlüsselattributen steht zusätzlich der entsprechende Beziehungsname dabei. Die Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen erweitert werden.

Bei einigen Business Objects ist für die Umwandlung fachlicher Schlüssel zu technischem Schlüssel eine Organisation notwendig. Bei den Attributlisten ist dies über die folgenden Anmerkungen in der Spalte „Attribut“ gekennzeichnet.

• Vertriebsorganisation (immer gemäß Basis)
• Firma (immer gemäß Basis)
• Land zur Firma (immer gemäß Basis)
• Lagerlogistikorganisation (gemäß Basis oder Position)

Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.

6.1               Basisdaten

6.1.1    Vertriebsangebot (CustomerProposal)

Die Identifikation eines Vertriebsangebotes besteht aus einer Vertriebs-Angebotsart und einer Nummer aus dem bei der Art hinterlegten Nummernkreis.

6.1.2          Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)

Die Kundendaten in den folgenden Verwendungen sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar. Das gleiche gilt für die Adressdaten.

Analog zu den technischen Attributnamen wurden die folgenden Part-Namen vergeben:

• customerData Angebotsempfänger
• deliveryCustomerData Lieferempfänger
• invoiceCustomerData Rechnungsempfänger

Die folgenden Attribute bestehen demnach pro Verwendung jeweils einmal.

6.1.3    Lieferdaten (deliveryData)

Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.4    Auftragslieferdaten (orderDeliveryData)

Die Auftragslieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.5    Rechnungsdaten (invoicingData)

Einige Rechnungsdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.6    Lieferpartnerdaten (deliveryPartnerData)

Einige Lieferpartnerdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.7    Vertriebsorganisationsdaten (invoicingPartyData)

Einige Daten der Vertriebsorganisation sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.8    Ausgabeeinstellungen (outputSettings)

Die Ausgabeeinstellungen sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.1.9    Vertriebspositions-Gruppen (DetailGroups)

Zulässige Werte für type

Im Attribut type müssen Sie den Namen einer Implementierung des folgenden Hook Contracts hinterlegen: com.cisag.app.sales.detailgroup.hook.SalesDetailGroupDataType

Folgende Implementierungen sind bereits vorhanden:

6.1.10       Texte (TextAssignments)

text

Bei den Texten können Sie diverse Formatierungen verwenden. Benötigen Sie Beispiele für konkrete Formatierungen, dann erfassen Sie am besten einen Musterbeleg mit den gewünschten Textformatierungen und exportieren diesen.

Hinweis:

Normalerweise werden Texte aus der Importdatei importiert und evtl. Vorschlagswerte aus den Partner-Stammdaten usw. ignoriert. Hat die Server-Property com.cisag.app.general.order.bi.applyAllwaysTextDefaults den Wert true, dann werden in jedem Fall die Vorschlagswerte ermittelt und mit den ggf. in der Importdatei vorhandenen Texten kombiniert. Hierbei ist zum einen zu beachten, dass die Nummern der Textzeilen passend gewählt sein müssen und dass zum anderen im Ergebnis nur eine Text-Zeile mit einem Artikel-text entsteht.

6.2               Positionsdaten (Grundpositionen)

6.2.1    Vertriebsangebotsposition (CustomerProposalDetail)

6.2.2    Kundenlieferdaten (deliveryCustomerData)

Die Attribute entsprechen denen in der Basis: Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)

6.2.3    Lieferdaten (deliveryData)

Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

6.2.4    Auftragslieferdaten (orderDeliveryData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Auftragslieferdaten (orderDeliveryData)

6.2.5    Lieferpartnerdaten (deliveryPartnerData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Lieferpartnerdaten (deliveryPartnerData)

6.3               Positionsdaten (Detailpositionen)

Vertriebsangebotsposition (CustomerProposalDetail)