Die Belegdokument-Vorlagen können in ein anderes CEE-System übertragen werden. Nachfolgende werden die Vorgehensweisen für den Export und den Import von Belegdokument-Vorlagen mit Hilfe des Business Integration Service (BIS), d.h der Anwendungen Daten exportieren und Daten importieren, beschrieben.
Export
Beim Export können Sie auf dem Karteireiter Eingrenzung eine oder mehrere Belegdokument-Vorlagen auswählen, die Sie exportieren möchten.
Aufgrund der Tatsache, dass praktisch alle Attribute Pflichtfelder sind, ist nur Export in Form einer XML-Datei sinnvoll.
Hinweis
Falls Sie eine Belegdokument-Vorlage exportieren, die eine Zusatz- bzw. Ersatz- Belegdokument-Vorlage enthält, müssen zuerst diese Belegdokument-Vorlagen exportiert werden, insbesondere dann, wenn Sie die exportierten Belegdokument-Vorlagen in eine andere OLTP-Datenbank importieren möchten.
Hinweis
Falls die Knowledge Store-Pfade bei einer Belegdokument-Vorlage vorkommen, werden deren Workspace-Namen, die den Datenbanknamen entsprechen, während des Exports durch die Variablen ersetzt. Beim Import werden die Variablen durch die Datenbanknamen ersetzt.
Daten exportieren
- Öffnen Sie die Anwendung Daten exportieren.
- Wählen Sie im Feld Filter den Filter für das Business Object com.cisag.app.general.obj.DocumentOutputOptions aus.
Falls der Filter noch nicht existiert, legen Sie einen neuen Filter an. Der Filter für den Import der Daten wird angezeigt. - Die ausgewählten Attribute des Filters sind bereits markiert. Bei Bedarf können Sie die Attribute noch anpassen. Im Karteireiter Filter können die Filter bearbeitet werden.
- Im Karteireiter Eingrenzung können gewünschte Eingrenzungen für den Datenexport vorgenommen werden. Nähere Informationen zu Eingrenzungen finden Sie im Kapitel Arbeitsbereich – Karteireiter Eingrenzung.
- Drücken Sie in der Standard-Symbolleiste den Button [Daten exportieren].
Das Dialogfester Daten exportieren wird geöffnet. - In diesem Dialogfenster können Sie Einstellung für die Exportdatei vornehmen.
- Durch Drücken des Buttons [Im Hintergrund] können Sie den Export durchführen.
Import
Um einen Datenimport vornehmen zu können, müssen Sie über eine zuvor aus einer anderen CEE-Umgebung exportierten Datei verfügen. Falls eine Belegdokument-Vorlage importiert werden sollte, der die Zusatz- bzw. Ersatz- Belegdokument-Vorlage zugeordnet war, müssen diese Vorlagen zuerst importiert werden.
Daten importieren
- Öffnen Sie die Anwendung Daten importieren.
- Lassen Sie sich den bzw. einen Filter für das Business Object com.cisag.app.general.obj.DocumentOutputOptions anzeigen.
Der Filter für den Import der Daten wird angezeigt. - Die ausgewählten Attribute des Filters sind bereits markiert. Bei Bedarf können Sie die Attribute noch anpassen. Im Karteireiter Filter können die Filter bearbeitet werden.
- Drücken Sie in der Standard-Symbolleiste den Button [Daten importieren].
Das Dialogfester Daten importieren wird geöffnet. - In diesem Dialogfenster können Sie Einstellung für die Importdatei vornehmen.
- Durch Drücken des Buttons [Im Hintergrund] können Sie den Import durchführen.
Arbeitsbereich – Karteireiter Eingrenzung
Unter dem Karteireiter Eingrenzung können Sie den Umfang der zu exportierenden Daten auf der Instanzebene bestimmen. Verfügbare Felder und Buttons:
- Suche – Suche, die für die Eingrenzung verwendet werden soll
- Belegdokument-Vorlagen Export – die Abfrage gilt für die konkrete Instanz
- Mit OQL-Anweisung – durch die Auswahl des Eintrags können Sie mithilfe einer OQL-Anweisung die Abfrage vornehmen
- Technischer Name (Feld mit Vorschlagswert) – zeigt das Business Entity der zu exportierenden Daten
- [Neue Suche] – Suche, mit deren Abfragemerkmalen die gewünschten Instanzen abgefragt werden können.
- [Suchmuster speichern] – Funktion zum Speichern einer Export-Eingrenzung. Folgende Optionen stehen zur Auswahl:
- [Suchmuster speichern…] – speichert das neue Suchmuster
- [Suchmuster umbenennen…] – ändert den Namen des gespeicherten Suchmusters
- [Suche anpassen…] – Funktion zur Umsetzung neuer Anforderungen an der bestehenden Suche. Über den Aktions-Button wird die Anwendung Suchen anpassen geöffnet.
- [Ansicht speichern] – speichert die festgelegte Ansicht
- [Ansicht wiederherstellen] – stellt die Standard-Ansicht wieder her
- Suchmuster auswählen – Feld zum Auswählen der festgelegten Export-Eingrenzung
- Belegdokument-Vorlage – Feld zum Auswählen der zu exportierenden Belegdokument-Vorlage. Sie können die Vorlage manuell oder über die Wertehilfe auswählen.
- Bezeichnung – ein zusätzlicher Name für die Belegdokument-Vorlage
- Ausgabemodus – Feld zum Filtern von Daten nach Ausgabemodus
- Ausgabemedium – Feld zum Filtern von Daten nach einem bestimmten Ausgabemedium
Arbeitsbereich – Karteireiter Filter
Im Folgenden werden die Pflichtfelder (P) und die Key-Attribute (K) der einzelnen Business Objects aufgeführt.
Das BIS-Datenmodell für Belegdokument-Vorlagen besteht aus dem Hauptobjekt DocumentOutputOptions und der Beziehungen Additions, Replacements und FilterDefinition. Die Beziehung FilterDefinition ist eine Fremdbeziehung. Additions und Replacements sind Abhängigkeiten (Dependents). Das Hauptobjekt DocumentOutputOptions des BIS-Datenmodells enthält folgende Attribute:
Feldname/Key-Attribut (K) | Bedeutung |
|---|---|
| code (K) (P) | Name der Belegdokument-Vorlage. Der Name darf nur Klein- und Großbuchstaben (ohne Umlaute) und die Ziffern 0-9 enthalten. Der Name ist auf 25 Zeichen beschränkt. |
| guid | GUID der Belegdokument-Vorlage |
| description | Bezeichnung der Belegdokument- Vorlage. Die Bezeichnung ist auf 65 Zeichen beschränkt und übersetzbar. |
| reportGuid | GUID eines Berichtes, der für ein Belegdokument verwendet werden soll |
| reportName (P) | Name des Berichtes, der für ein Belegdokument verwendet werden soll. Der Name ist auf 200 Zeichen beschränkt. Falls ein Entwicklungsobjekt „Bericht“ verwendet wird, muss vollqualifizierter Name angegeben werden. |
| modes (P) | Dieses Attribut enthält in kodierter Form die Modi für die Ausgabeeinstellungen. (Z.B. Einstellung Drucker, Einstellung Papiereinzug etc.) |
| values(P) | Dieses Attribut enthält in kodierter Form die Ausgabeeinstellungen. (Z.B. Mediumgröße, Anzahl Exemplare etc.) |
| outputMode (P) | Ausgabemodus, das angibt, ob die Ausgabe eines Beleges stattfinden sollte. . Mögliche Werte sind: • „Ausgeben“ • „Nicht ausgeben“ |
| outputMedium (P) | Ausgabemedium, auf das bei der Verwendung der Belegdokument-Vorlage die Ausgabe erfolgen soll. Mögliche Werte sind: • „Drucker“ • „Fax“ • „E-Mail“ Abhängig von dieser Auswahl werden spezifische Einstellungen in der Anwendung „Belegdokument-Vorlagen“ eingeblendet. |
| outputDeviceName (P) | Name des Ausgabegerätes, das während der Ausgabe eines Beleges verwendet werden sollte. Dieses Attribut wird während des Exports aufgrund des Attributes „values“ berechnet. Beim Import wird dessen Wert beim Attribut „values“ berücksichtigt. |
| printerRedirectDirectory (P) | Ordner, in dem die Datei gespeichert wird. Falls der Ordner nicht existiert, wird dieser beim Erzeugen der Datei angelegt. Das vollständige Pfad des Ordners mit dem Schema „file:///“ oder „kstore://“ muss angegeben werden. Im Dateinamen können Variablen verwendet werden. Beim Erzeugen der Datei werden die Variablen durch die Werte, für die sie stehen, ersetzt. Im Folgenden sind die Variablen und ihre Bedeutung angegeben: • {report} die Bezeichnung des Be- richts • {user} der Benutzername • {timestamp} Datum und Uhrzeit mit Millisekunden (yyyyMMdd_HHmmss_SSS) • {datetime} Datum und Uhrzeit (yyyyMMdd_HHmmss) • {date} Datum (yyyyMMdd) • {time} Uhrzeit (HHmmss) • {week} Kalenderwoche (ww) • {year} Jahr (yyyy) • {month} Monat (MM) • {day} Tag (dd) • {document} Bezeichnung des Beleges • {number} vollständige Auftragsnummer (Art und Nummer) Für Import/Export werden auch die folgenden Variablen unterstützt: • #OLTP_DATABASE# • #REPOSITORY_DATABASE# Falls die Knowledge Store-Pfade bei einer Belegdokument-Vorlage vorkommen, werden deren Workspace-Namen, die den Datenbanknamen entsprechen, während des Exports durch die Variablen ersetzt. Beim Import werden die Variablen durch die Datenbanknamen ersetzt. Dieses Attribut wird während des Exports aufgrund des Attributes „values“ berechnet. Beim Import wird dessen Wert beim Attribut „values“ berücksichtigt. |
| printerRedirectFile (P) | Name der Datei ohne Dateiendung. Im Dateinamen können Variablen verwendet werden. Dieses Attribut wird während des Exports aufgrund des Attributes „values“ berechnet. Beim Import wird dessen Wert beim Attribut „values“ berücksichtigt. |
| exportMode (P) | Exportmodus für den elektronischen Datenaustausch. Die möglichen Werte sind: • Exportieren • Nicht exportieren |
| exportFilterDefinitionGuid | Filter, der für den Export verwendet wird. Der Export-Filter muss zuvor in der Anwendung „Daten exportieren“ erfasst worden sein und zum Business Entity des Beleges, welcher mit der Belegdokument-Vorlage ausgegeben wird, passen. |
| exportCreateMode (P) | Zeitpunkt, wann der Export erfolgen soll. Die Auswahl in diesem Attribut bezieht sich auf die Einstellung in dem Attribut „Exportmodus“. Mögliche Werte sind: • Bei der Erst-Ausgabe • Bei der Erst- und Kopie-Ausgabe |
| exportDirectory (P) | Ziel-Ordner des Exports für den elektronischen Datenaustausch. Geben Sie den vollständigen Pfad des Ordners mit dem Schema „file:///“ oder „kstore://“ an. Um zu verhindern, dass zu viele Dateien in einem Ordner abgelegt werden, können Sie die folgenden Variablen zur Vergabe des Ordnernamens benutzen: • {report} der Name des Berichts • {user} der Benutzername • {timestamp} Datum und Uhrzeit mit Millisekunden (yyyyMMdd_HHmmss_SSS) • {datetime} Datum und Uhrzeit (yyyyMMdd_HHmmss) • {date} Datum (yyyyMMdd) • {oltp} OLTP-Datenbank • {time} Uhrzeit (HHmmss) • {week} Kalenderwoche (ww) • {year} Jahr (yyyy) • {month} Monat (MM) • {day} Tag (dd) • {document} Bezeichnung des Beleges • {number} vollständige Auftragsnummer (Art und Nummer) Für Import/Export werden auch die folgenden Variablen unterstützt: • #OLTP_DATABASE# • #REPOSITORY_DATABASE# Falls die Knowledge Store-Pfade bei einer Belegdokument-Vorlage vorkommen, werden deren Workspace-Namen, die den Datenbanknamen entsprechen, während des Exports durch die Variablen ersetzt. Beim Import werden die Variablen durch die Datenbanknamen ersetzt. |
| exportFileName (P) | Name der Ziel-Datei für den Export ohne Angabe der Dateiendung. Im Dateinamen können Variablen verwendet werden. Beim Erzeugen der Datei werden die Variablen durch die Werte, für die sie stehen, ersetzt. Im Folgenden sind die Variablen und ihre Bedeutung angegeben: • {report} die Bezeichnung des Be- richts • {user} der Benutzername • {timestamp} Datum und Uhrzeit mit Millisekunden (yyyyMMdd_HHmmss_SSS) • {datetime} Datum und Uhrzeit (yyyyMMdd_HHmmss) • {date} Datum (yyyyMMdd) • {time} Uhrzeit (HHmmss) • {week} Kalenderwoche (ww) • {year} Jahr (yyyy) • {month} Monat (MM) • {day} Tag (dd) • {document} Bezeichnung des Beleges • {number} vollständige Auftragsnummer (Art und Nummer) |
| exportMimeType (P) | Dateityp der beim Exportieren erzeugten Dateien. Momentan wird nur „XML (*.xml)“ unterstützt |
| archiveMode (P) | Ablagemodus für das DokumentenManagement. Mögliche Werte sind: • Ablegen • Nicht ablegen Sollten Sie das Dokumenten-Management nicht lizenziert haben, ist der Wert unveränderbar „nur ausgeben“. |
| archiveCreateMode (P) | Ablagezeitpunkt für das Dokumenten- Management. Die Auswahl in diesem Feld bezieht sich auf die Einstellung in dem Feld „Ablagemodus“. Mögliche Werte sind: • Bei der Erst-Ausgabe • Bei der Erst- und Kopie-Ausgabe |
| archiveDirectory (P) | Order für die Ablage einer Archivkopie im Dokumenten-Management in einem Arbeitsbereich. Geben Sie den vollständigen Pfad des Ordners mit dem Schema „kstore://“ an. Um zu verhindern, dass zu viele Dateien in einem Ordner abgelegt werden, können Sie die folgenden Variablen zur Vergabe des Ordnernamens benutzen: • {report} der Name des Berichts • {user} der Benutzername • {timestamp} Datum und Uhrzeit mit Millisekunden (yyyyMMdd_HHmmss_SSS) • {datetime} Datum und Uhrzeit (yyyyMMdd_HHmmss) • {date} Datum (yyyyMMdd) • {time} Uhrzeit (HHmmss) • {week} Kalenderwoche (ww) • {year} Jahr (yyyy) • {month} Monat (MM) • {day} Tag (dd) • {document} Bezeichnung des Beleges • {number} vollständige Auftragsnummer (Art und Nummer) Für Import/Export werden auch die folgenden Variablen unterstützt: • #OLTP_DATABASE# • #REPOSITORY_DATABASE# Falls die Knowledge Store-Pfade bei einer Belegdokument-Vorlage vorkommen, werden deren Workspace-Namen, die den Datenbanknamen entsprechen, während des Exports durch die Variablen ersetzt. Beim Import werden die Variablen durch die Datenbanknamen ersetzt. |
| archiveFileName (P) | Name der Datei für die Ablage im Dokumenten-Management ohne Angabe der Dateiendung. Die Dateiendung wird automatisch hinzugefügt. Im Dateinamen können Variablen verwendet werden. Im Folgenden sind die Variablen und ihre Bedeutung angegeben: • {report} die Bezeichnung des Be- richts • {user} der Benutzername • {timestamp} Datum und Uhrzeit mit Millisekunden (yyyyMMdd_HHmmss_SSS) • {datetime} Datum und Uhrzeit (yyyyMMdd_HHmmss) • {date} Datum (yyyyMMdd) • {time} Uhrzeit (HHmmss) • {week} Kalenderwoche (ww) • {year} Jahr (yyyy) • {month} Monat (MM) • {day} Tag (dd) • {document} Bezeichnung des Beleges • {number} vollständige Auftragsnummer (Art und Nummer) |
| archiveOutputFormat (P) | Dateityp der im Dokumenten- Management erzeugten Dateien. Mögliche Werte sind: • PDF (*.pdf) • Crystal Reports (*.rpt) • HTML (*.html) • Microsoft Excel (*.xls) • Microsoft Word (*.doc) • Rich Text Format (*.rtf) • Text (*.txt) • Text durch Komma getrennt (*.csv) • Text durch Tabstopp getrennt (*.tsv) • XML (*.xml) |
Der Dependent Additions des BIS-Datenmodells beschreibt die Zusatz-Belegdokument-Vorlage und enthält folgende Attribute:
Feldname/Key-Attribut (K) | Bedeutung |
|---|---|
| guid | GUID des Dependents |
| documentOutputOptionsGuid (K) | GUID der Haupt-Belegdokument-Vorlage |
| sequenceNumber (K) | Das Attribut bestimmt die Reihenfolge der Ausgabe der Zusatz-Belegdokument-Vorlagen |
| additional DocumentOutputOptionsGuid | GUID der Zusatz-Belegdokument-Vorlage |
Der Dependent Replacements des BIS-Datenmodells beschreibt die Ersatz-Belegdokument-Vorlage und enthält folgende Attribute:
Feldname/Key-Attribut (K) | Bedeutung |
|---|---|
| guid | GUID des Dependents |
| documentOutputOptionsGuid (K) | GUID der Haupt-Belegdokument-Vorlage |
| personGuid (K) | Person, für die bei der Findung der aktuellen Belegdokument-Vorlage, die Ersatz-Belegdokument-Vorlage verwendet werden soll |
| replacementDocumentOutputOptionsGuid | GUID der Ersatz-Belegdokument-Vorlage |
Die Fremdbeziehung FilterDefinition beschreibt den Filter, der für den Export verwendet wird und enthält folgende Attribute:
Feldname/Key-Attribut (K) | Bedeutung |
|---|---|
| guid | GUID des Filters |
| name (K) | Name des Filters |