Framework:Importe

Um einen neuen Import zu erstellen, wechseln Sie zunächst in den Entwicklermodus und wählen den Menüpunkt Objektverwaltung.

Datendefinition

Als Datenquelle wird hier eine CoPlanner Datendefinition verwendet. Vorrangig wird diese Art des Imports für die Übernahme von Ist-Daten nach Plan verwendet (Datenassistent).

Framework, Datendefinition Import

Hinweis  Wenn die Abfrage des Basis SQL Statements des Importes > 10 Minuten dauert, wird der Import mit einem Timeout abgebrochen. Dieses Timeout kann in der svrconfig.xml gesetzt werden mit dem Parameter DBCommandTimeout.

Filter

Bei Datendefinitionsimporten können auch Filter hinzugefügt werden. Diese werden unter dem Bereich Filter definiert und man kann diese auch in SqlQueries verwenden. Zugreifen können Sie darauf zum Beispiel über <Filtername.Ausdruck> wobei das "Filtername" durch den von Ihnen vergebenen Namen ersetzt werden muss. Wenn ein Filter Lookup Special gesetzt auf eine Session-Variable gesetzt werden sollen, wird das mit Transform= angegeben. z.B. Transform=@Session_Unternehmen_ID@

Zusätzlich dienen die Filter der Parameterübergabe aus anderen Modulen (z.B. aufgerufene Makros aus Masken, Berichten, usw.). Das Mapping passiert hier auf Basis der Filternamen. Kommt beispielsweise der Plan zwei mal in der Maske vor, einmal mit dem Namen Plan und einmal mit dem Namen RefPlan und man möchte den RefPlan in den Import übergeben, so muss man dort nur den Plan auswählen und den Namen des Filters im Import auch auf RefPlan setzen.

Tabellenzuordnung

Egal welche Datenquelle Sie gewählt haben, die weiteren Schritte sind immer die Selben.

Framework, Tabellenzuordnung

Das linke Grid beinhaltet die Quellobjekte. Das rechte die Zielobjekte. Markieren Sie ein Quellobjekt, danach ein Zielobjekt und drücken Sie den Button Neu. Es wird eine Verbindung zwischen den beiden Objekten hergestellt. Durch Doppelklick auf die Zuweisung bzw. durch Navigation im Baum gelangen Sie zur Detailansicht der Zuweisung.

Framework, Detailansicht Zuordnung

Es besteht bei der Tabellenzuordnung auch die Möglichkeit, Daten der Quelle, bzw. des Ziels anzusehen. Klicken Sie mit der rechten Maustaste im Quell-/Zielgrid auf das gewünschte Objekt.

Framework, Tabellenzuordnung Vorschau

Klicken Sie im Kontextmenü auf Vorschau und es erscheint ein Dialog, der die Daten beinhaltet.

Tabellenzuordnungen Details

Um eine Tabellenzuordnung näher zu definieren wählen Sie unter Tabellenzuordnungen im Baum per Klick die entsprechende aus.

Framework, Tabellenzuordnung Detail

Option	Eigenschaft
Aktiv	Definiert ob dieser Importschritt ausgeführt wird oder nicht
Nur neu	Besteht ein Datensatz mit der angegebenen Kombination an Überprüfungen schon am System, wird dieser nicht aktualisiert.
Import in eine Dimension	Um einen Import in eine Dimension zu machen, wählen Sie bitte diese Option. Option Eigenschaft Parent-Schlüsselfeld in der Quelle Definieren Sie hier das Parent-Schlüsselfeld. Dieses Feld ist notwendig, um die Hierachie aufbauen zu können. Schlüsselfeld in der Quelle Definieren Sie hier das Schlüsselfeld der Quelle. Dieses Feld dient für die eindeutige Zuordnung der neuen zu schon existierenden Einträgen. Schlüsselfeld im Ziel Definieren Sie hier das Schlüsselfeld im Ziel, also jenes, über welches die Einträge des Schlüsselfelds aus der Quelle dem Ziel eindeutig zugeordnet werden können. Bezeichnung des Dimensionselementes in der Quelle Definieren Sie hier, welches Feld der Quelle den Namen des Dimensionselementes beinhaltet. Mandantenschlüssel in Quelle Handelt es sich bei der Dimension um eine Mandatendimension, so muss auch das Mapping angegeben werden. Hier definieren Sie den Schlüssel für das eindeutige Mapping in der Quelle. Mandantenschlüssel im Ziel Hier definieren Sie über welches Feld des Unternehmens Sie das eindeutige Mapping zur Quelle machen wollen. nur neue Dimensionselemente importieren Es werden nur Dimensionselemente importiert zu denen es den Schlüssel noch nicht gibt. vorhandene Dimensionselementsnamen ersetzen Gibt an, ob bei bestehenden Dimensionselementen der Name ersetzt werden soll sofern er sich geändert hat. nicht zuordenbare auf Dimensionswurzel importieren (sonst auf "keine Zuordnung") Gibt an, ob Elemente zu denen kein Parent gefunden wurde unter das Rootelement gehängt werden sollen oder wie standardmäßig auf keine Zuordnung. Parent-Child Beziehungen aktualisieren Definiert, ob die Struktur angepasst werden soll, sofern sich in der Quelle etwas geändert hat oder nicht. Dimensionselement mit gleichem Namen erlauben Definiert, ob durch den Import zugelassen wird, dass es mehrere Elemente den gleichen Namen erhalten Sessionberechtigungen benutzen (Ab CoPlanner 11 Release 3 2023) Definiert, ob bei der Ausführung die Berechtigungen der aktuellen Session ausgewertet werden sollen. Ist diese Option deaktiviert, wird der Import mit Systemrechten ausgeführt.
Import in Zielplan	Standardmäßig wird, sofern die Zieltabelle planabhängig ist, in den Plan importiert auf dem man angemeldet ist. Sollte in einen anderen Plan importiert werden, treffen Sie hier bitte die Auswahl in welchen.
Sparchabhängig importieren	Um Dateninhalte auf mehrsprachige Felder von Tabellen oder Dimensionen zu importieren stellen Sie die gewünschte Zielsprache hier an. Sie benötigen eine Tabellenzuordnung pro Zielsprache.

Feldzuordnung

Die Objektzuordnungen wurden getroffen. Nun muss noch definiert werden, welches Feld der Quelle in welches Feld des Ziels geschrieben werden soll.

Framework, Feldzuordnung

Gleich wie bereits bei der Tabellenzuordnung gibt es wieder zwei Grids. Links die Spalten des Quellobjekts, rechts jene des Zielobjekts. Selektieren Sie eine Quellspalte und eine Zielspalte und drücken Sie den „Neu“ Button. Durch Doppelklick auf die Zuweisung bzw. durch den Baum gelangen Sie zur Detailansicht.

Hinweis  Verwenden Sie die Schaltfläche „Automatisch“, um alle Felder, deren Quell- und Zielnamen gleich sind, automatisch zu verknüpfen.

Framework, Feldzuordnung Detailansicht

Hinweis  Für Dimensionselemente muss im Detail der Feldzuordnung noch angegeben werden, über welches Zielfeld in der Dimension die Zuordnung erfolgt. Dieses Feld beschreibt jene Spalte, die mit der Quelltabelle vergleichbar ist. Bei Importen aus Vorsystemen ist das in der Regel das Feld vs_key, bei Transfers zwischen CoPlanner-Tabellen die Spalte COPSYS_ID. Steht also in der Quelltabelle in der Spalte KST der Wert 4711 und ist im Feld vs_key der Dimension PC/KST eben dieser Schlüssel zu finden, dann wird hier das Feld „vs_key“ ausgewählt.

Starten des Imports

Sind alle Einstellungen gespeichert (kein Button mehr rot), drücken Sie Import starten (gleicher Effekt wie Doppelklick des Objekts in der Objektverwaltung). Im Baum können Sie im Import Verlauf mitverfolgen, ob der Import funktionierte bzw. welche Teilschritte ausgeführt wurden.

Details zum Datendefinitionsimport

Wie bereits erwähnt dient dieser für die Übernahme von Istdaten im CoPlanner in Plantabellen, oder zum Übertragen von Daten des Plans A nach Plan B. Hierfür ist es oft erforderlich, eine Datenmatrix mit mehr als zwei Achsen als Quelle zu erstellen. Um den Aufbau dieser zu beschleunigen, wurde am Server eine Optimierungsroutine implementiert. Diese wird aktiv wenn:

• mindestens eine Achse als Ausrichtung „Keine“ besitzt
• kein Subset als Achse verwendet wird

Des Weiteren wird ja, wenn ein Import auf eine Lookup-Spalte erfolgt, eine Zuweisung über eine Schlüsselspalte benötigt (um Beispielsweise über einen Vorsystemschlüssel auf das CoPlanner Dimensionselement rück schließen zu können). Ist die Schlüsselspalte die COPSYS_ID Spalte (bei Datendefinitionsimport default und empfohlen, werden Serverseitig Dimensionsinformationen nicht geladen und Verknüpfungs-IDs 1:1 übernommen. Dies hat wieder eine Zeitersparnis zur Folge.