CoPlanner 10 - Benutzerbeiträge [de-formal]

WebApps:Tiles

2022-08-22T07:25:37Z

L.dietrich: Aufruf von Webimporten: bei @Session_WebAppUrl@ fehlte das zweite @, was beim Kopieren sehr ärgerlich sein kann

__TOC__

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

Für die automatische Aktualisierung bei Änderungen an den Tiles, muss als Betriebssystem mind. Windows 8 oder Windows Server 2012 verwendet werden.

==Dimension NavigationTiles==

Im Modell muss die Dimension „NavigationTiles“ vorhanden sein. Auf Basis dieser Dimension werden die Kacheln aufgebaut. Dabei müssen folgende Spalten mindestens vorhanden sein:

{| class="wikitable" width={{{breite|70%}}}
|-
|Title
|Text (beliebige Länge)
|Anzeigetext
|-
|Icon
|Text (beliebige Länge)
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis
|-
|Style
|Ganzzahl - Standardwert 0
|Liefert die Darstellung des Eintrages. Auswirkungen nur auf Kacheln.
|-
|NavigationAction
|Text (beliebige Länge; empfohlen wird die maximal mögliche Anzahl von 4000)
|Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".
|-
|OpenIcon
|Text (beliebige Länge)
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 1 ist.
|-
|ReadyIcon
|Text (beliebige Länge)
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 2 ist.
|-
|ErrorIcon
|Text (beliebige Länge)
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 3 ist.
|-
|Color
|Text (beliebige Länge)
|Hintergrundfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)).
|-
|OpenColor
|Text (beliebige Länge)
|Hintergrundfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)). Diese Hintergrundfarbe wird verwendet, wenn der Status 1 ist.
|-
|ReadyColor
|Text (beliebige Länge)
|Hintergrundfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)). Diese Hintergrundfarbe wird verwendet, wenn der Status 2 ist.
|-
|ErrorColor
|Text (beliebige Länge)
|Hintergrundfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)). Diese Hintergrundfarbe wird verwendet, wenn der Status 3 ist.
|-
|TextColor
|Text (beliebige Länge)
|Schriftfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)).
|-
|IsEnabled
|Text (beliebige Länge)
|Gibt an, ob die hinterlegte Aktion ausgeführt werden kann. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|IsVisible
|Text (beliebige Länge)
|Gibt an, ob das Element angezeigt wird. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|Status
|Text (beliebige Länge)
|Über den Status kann die Hintergrundfarbe und das Bild gesteuert werden.

0 = Kein Status

1 = Offen

2 = Erledigt/abgeschlossen

3 = Fehlerhaft

Alle anderen Werte werden als „Kein Status“ interpretiert, wird keine Abfrage definiert, so ist dies ebenfalls der Fall. Es können hier auch Expressions angewendet werden.
|-
|Target
|Text (beliebige Länge)
|Über das Target kann angegeben werden, ob die ausgeführte Aktion in z.B. in einem neuen Tab geöffnet wird.

_self: wird in gleichem Tab geöffnet

_blank: wird in neuem Fenster/Tab geöffnet

weitere Möglichkeiten finden Sie unter https://www.w3schools.com/tags/att_a_target.asp.
|}

[[Image:Tiles_Neu.PNG]]

==Darstellung==

[[Image:Struktur_NavigationTiles.JPG|thumb|center|Struktur]]

Wenn diese Struktur für den Bereich Enterprise dargestellt wird, erhalten Sie folgende Anzeige

[[Image:Anzeige_NavigationTiles.PNG|thumb|center|Anzeige]]

Dimensionselemente der Ebene 1 werden nicht angezeigt.

Dimensionselemente der Ebene 2 entsprechen Anzeigesichten, über welche die Tiles aufgerufen werden.

Dimensionselemente der Ebene 3 entsprechen den Gruppen (siehe Modell, Planung, Konsolidierung, …)

Dimensionselemente der Ebene 4 entsprechen einfachen Kacheln, welche eine Navaktion auswerten können oder ein Submenü enthalten können.

Dimensionselemente der Ebene 5 entsprechen Sub-Menüs, welche über das Übergeordnete Elemente geöffnet werden. Diese können eine Navaktion auswerten oder ein Submenü enthalten.

Dimensionselemente der Ebene 6 entsprechen einer weiteren Ebene von Sub-Menüs, welche über das Übergeordnete Elemente geöffnet werden.

Dimensionselemente weiterer Ebenen werden nicht berücksichtigt.

===Gruppen===

Gruppen werden durch die Ebene 3 der Dimension „NavigationTiles“ definiert und definieren eine Sammlung von Menüeinträgen. Die Gruppe selbst kann keine Aktionen auswerten. Folgende Eigenschaften werden auf Gruppen ausgewertet:

{| class="wikitable" width={{{breite|50%}}}
|-
|Title
|Anzeigetext. Wenn nicht vergeben zieht der Name des Dimensionselements.
|-
|Icon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis
|-
|Style
|Derzeit keine Funktion
|-
|NavigationAction
|Derzeit keine Funktion
|-
|OpenIcon
|Derzeit keine Funktion
|-
|ReadyIcon
|Derzeit keine Funktion
|-
|ErrorIcon
|Derzeit keine Funktion
|-
|Color
|Derzeit keine Funktion
|-
|OpenColor
|Derzeit keine Funktion
|-
|ReadyColor
|Derzeit keine Funktion
|-
|ErrorColor
|Derzeit keine Funktion
|-
|TextColor
|Schriftfarbe
|-
|IsEnabled
|Gibt an, ob die hinterlegte Aktion ausgeführt werden kann. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|IsVisible
|Gibt an, ob das Element angezeigt wird. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|Status
|Derzeit keine Funktion
|-
|Target
|Derzeit keine Funktion
|}

===Kacheln===

Kacheln sind Elemente der Ebene 4 aus der Dimension „NavigationTiles“.
Auf Kacheln ist es möglich eine Aktion auszuführen. Dabei werden folgende Eigenschaften ausgewertet:

{| class="wikitable" width={{{breite|50%}}}
|-
|Title
|Anzeigetext. Wenn nicht vergeben zieht der Name des Dimensionselements.
|-
|Icon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis
|-
|Style
|Liefert die Darstellung des Eintrages. Derzeit sind folgende Möglichkeiten implementiert:

0 = kleine Kachel, Submenüs öffnen sich nach unten

1 = große Kachel, Submenüs öffnen sich nach unten

3 = kleine Kachel, Submenüs werden auf Kachel dargestellt

4 = große Kachel, Submenüs werden auf Kachel dargestellt
|-
|NavigationAction
|Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".
|-
|OpenIcon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 1 ist.
|-
|ReadyIcon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 2 ist.
|-
|ErrorIcon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 3 ist.
|-
|Color
|Hintergrundfarbe, wenn kein gültiger Status oder Status 0
|-
|OpenColor
|Hintergrundfarbe, wenn Status = 1
|-
|ReadyColor
|Hintergrundfarbe, wenn Status = 2
|-
|ErrorColor
|Hintergrundfarbe, wenn Status = 3
|-
|TextColor
|Schriftfarbe
|-
|IsEnabled
|Gibt an, ob die hinterlegte Aktion ausgeführt werden kann. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|IsVisible
|Gibt an, ob das Element angezeigt wird. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|Status
|Über den Status kann die Hintergrundfarbe und das Bild gesteuert werden.

0 = Kein Status

1 = Offen

2 = Erledigt/abgeschlossen

3 = Fehlerhaft

Alle anderen Werte werden als „Kein Status“ interpretiert, wird keine Abfrage definiert, so ist dies ebenfalls der Fall. Es können hier auch Expressions angewendet werden.
|-
|Target
|Über das Target kann angegeben werden, ob die ausgeführte Aktion in z.B. in einem neuen Tab geöffnet wird.

_self: wird in gleichem Tab geöffnet

_blank: wird in neuem Fenster/Tab geöffnet

weitere Möglichkeiten finden Sie unter https://www.w3schools.com/tags/att_a_target.asp.
|}

===Submenü===

Sind Alle Einträge welche sich unter der Ebene 5 befinden. Dabei werden folgende Eigenschaften ausgewertet:

{| class="wikitable" width={{{breite|50%}}}
|-
|Title
|Anzeigetext. Wenn nicht vergeben zieht der Name des Dimensionselements.
|-
|Icon
|Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis
|-
|Style
|Derzeit keine Funktion
|-
|NavigationAction
|Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".
|-
|OpenIcon
|Derzeit keine Funktion
|-
|ReadyIcon
|Derzeit keine Funktion
|-
|ErrorIcon
|Derzeit keine Funktion
|-
|Color
|Derzeit keine Funktion
|-
|OpenColor
|Derzeit keine Funktion
|-
|ReadyColor
|Derzeit keine Funktion
|-
|ErrorColor
|Derzeit keine Funktion
|-
|TextColor
|Derzeit keine Funktion
|-
|IsEnabled
|Gibt an, ob die hinterlegte Aktion ausgeführt werden kann. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|IsVisible
|Gibt an, ob das Element angezeigt wird. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.

z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
|-
|Status
|Derzeit keine Funktion
|-
|Target
|Über das Target kann angegeben werden, ob die ausgeführte Aktion in z.B. in einem neuen Tab geöffnet wird.

_self: wird in gleichem Tab geöffnet

_blank: wird in neuem Fenster/Tab geöffnet

weitere Möglichkeiten finden Sie unter https://www.w3schools.com/tags/att_a_target.asp.
|}

=Aufruf im Web=
@Session_WebAppUrl@/Tiles/?menu=<Ebene 2 aus Dimension NavigationTiles>

Beispiel:

<nowiki>https://servername:4444/coplanner/Tiles/?menu=reporting</nowiki>

{| {{Bausteindesign2}}
|-
|'''Hinweis'''  Bei reiner Anwendung im Web können keine CopNav Links verwendet werden.
|}

==Erweiterter Aufruf==
:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

Beispiel:

<nowiki>https://servername:4444/coplanner/Tiles/?menu=reporting&hideSessionHeader=true</nowiki>

=Aktualisierung=
Wenn in der Dimension NavigationTiles etwas geändert wird, dann wird die Ansicht beim Benutzer gleich angepasst. Expressions bei z.B. dem Status werden nur ausgewertet, wenn es eine Änderung direkt in der NavigationTiles Dimension gab oder die Ansicht aktualisiert wird. Wird z.B. ein Status über eine Kachel gesetzt und der Benutzer soll die Änderung gleich sehen, so kann man als letzten Schritt hier noch einen Dummy-Import einbauen, der z.B. das Element "Keine Zuordnung" in der Dimension überschreibt.

Bei Verwendung einer WebAppUrl mit http (es wird empfohlen https zu verwenden) kann es sein, dass dies nicht automatisch gemacht werden kann, weil ein Virenscanner das verhindert. Entweder muss dann im Virenscanner eine Ausnahme gemacht werden, oder die Kacheln werden erst nach drücken von F5 oder erneutem Öffnen der Kacheln neu geladen.

Z.B. bei Kaspersky wird die Aktualisierung blockiert mit http. Damit es hier funktioniert muss die URL zu den Vertrauenswürdigen Webadressen hinzugefügt werden.

=Erstellen der Navigationslinks (NavigationAction) - nur Möglich, wenn aus CoPlanner aufgerufen=
Wenn Sie auf einer Zeilenmaske oder Eingabemaske Strg + J drücken erhalten Sie einen Dialog.
Wählen Sie "complete coplink (sample)" an und klicken Sie auf "build..."
Wählen Sie hier die entsprechende Aktion aus, welche Sie ausführen möchten und klicken Sie ok.
Der Link, der dadurch im grauen Feld entsteht muss wie folgt angepasst werden (um den Link anzupassen muss dieser in einen Editor kopiert werden):
* Es dürfen keine __PARAM_NOT_FOUND__ vorkommen - löschen Sie diese einfach aus dem Link
* ersetzen Sie cop:// durch copNav.html?
* Leerzeichen vor und nach den ? entfernen

Beispiel:

Ursprünglicher Link:

cop://name=Name der Aktion & aktion=Matrix Builder Eingabemaske & p1=EM Umsatzerloese Plan & p2= & p3= & p4= & frmlocation=Struktur & bild=__PARAM_NOT_FOUND__ & info=__PARAM_NOT_FOUND__ & styledefinition= & readonly=__PARAM_NOT_FOUND__

Link, der angewendet werden kann:

copNav.html?name=Name der Aktion&aktion=Matrix Builder Eingabemaske&p1=EM Umsatzerloese Plan&p2=&p3=&p4=&frmlocation=Struktur&bild=&info=&styledefinition=&readonly=

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Bei Aufrufen, die ein / enthalten, wie z.B. die PC/KST, müssen die / durch %slash% ersetzt werden.

z.B.: copNav.html?name=PC%slash%KST&aktion=Dimension&p1=PC%slash%KST&p2=&p3=&p4=&frmlocation=Struktur&bild=&info=&styledefinition=&readonly=
|}

=Erstellen der Navigationslinks für Aufrufe rein im Web=
Um die Tiles auch rein im Web verwenden zu können, müssen andere Links verwendet werden, die direkt die Webkomponenten aufrufen.

==Aufruf von Makros==

macro:<Makroname>:<Kontext>

Beispiel für einen Aufruf ohne Kontextübergabe:

macro:mkr_Transfer_Umsatzerloese_IST_PLAN

Beispiel für einen Aufruf mit Kontextübergabe:

macro:mkr_Transfer_Umsatzerloese_IST_PLAN:"Zeit" eq "2015010101" and "Unternehmen" eq "631835758818687263" and "Produkte" mu "633951975478981696" and "PC/KST" mu "1" and "Regionen/Kunden" mu "1" and "Umsatzerloesarten" eq "1"

{| {{Bausteindesign1}}
|-
| '''Hinweis:'''  Makros und Importe werden ohne @Session_WebAppUrl@ aufgerufen.
|}

==Aufruf von Importen==

import:<Importname>:<Kontext>

Beispiel für einen Aufruf ohne Kontextübergabe:

import:Transfer_Umsatzerloese_IST_PLAN

Beispiel für einen Aufruf mit Kontextübergabe:

import:Transfer_Umsatzerloese_IST_PLAN:"Zeit" eq "2015010101" and "Unternehmen" eq "631835758818687263" and "Produkte" mu "633951975478981696" and "PC/KST" mu "1" and "Regionen/Kunden" mu "1" and "Umsatzerloesarten" eq "1"

{| {{Bausteindesign1}}
|-
| '''Hinweis:'''  Makros und Importe werden ohne @Session_WebAppUrl@ aufgerufen.
|}

==Aufruf der Zeitdimensionserstellung==

copaction://createtimedimension

{| {{Bausteindesign1}}
|-
| '''Hinweis:'''  Makros und Importe werden ohne @Session_WebAppUrl@ aufgerufen.
|}

==Aufruf für das Erstellen einer neuen Webimportdefinition==
Verfügbar ab CoP 10 HF 2.2

@Session_WebAppUrl@/Import/?importname=[new]

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}

==Aufruf einer Webimportdefinition==
Verfügbar ab CoP 10 HF 2.2

@Session_WebAppUrl@/Import/?importname=<Importname>

==Aufruf von Eingabemasken==
@Session_WebAppUrl@/pivottable/?pivotform=<Maskenname>

Weitere Aufrufparameter und Informationen zur Eingabemaske finden Sie [[WebApps:Eingabemaske|hier]].

==Aufruf von Zeilensichten==
@Session_WebAppUrl@/pivottable/?tableform=<Maskenname>

Weitere Aufrufparameter und Informationen zur Zeilensicht finden Sie [[WebApps:Zeilensicht|hier]].

==Aufruf von Dimensionen==
@Session_WebAppUrl@/dimensioneditor/?name=<Dimensionsname>

Weitere Informationen zur Dimensionswartung finden Sie [[WebApps:Dimensionswartung|hier]].

==Aufruf von Subsets==
@Session_WebAppUrl@/DimensionEditor/?subsetid=<Subsetname>

Weitere Informationen zur Subsetwartung finden Sie [[WebApps:Subsetwartung|hier]].

==Aufruf des Szenariomanagers==
@Session_WebAppUrl@/dimensioneditor/?name=Plan

Weitere Informationen zum Szenariomanager finden Sie [[WebApps:Szenariomanager|hier]].

==Aufruf der Anwendungseigenschaften==
@Session_WebAppUrl@/dimensioneditor/?name=sys_Anwendungseigenschaften

Weitere Informationen zu den Anwendungseigenschaften finden Sie [[WebApps:Anwendungseigenschaften|hier]].

==Aufruf eines Dashboards==
@Session_WebAppUrl@/dashboard/?dashboard=<Dashboard Name>

==Aufruf des Diagrammdesigners==
@Session_WebAppUrl@/diagram/?diagramId=<Diagrammname>

==Aufruf für das Erstellen eines neuen Dashboards==
@Session_WebAppUrl@/Dashboard/Dashboard=[new]
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}

==Aufruf für das Erstellen eines neuen Diagramms==
@Session_WebAppUrl@/Diagram/diagramId=[new]
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}
==Aufruf für das Erstellen eines neuen Gantt-Diagramms==

@Session_WebAppUrl@/Diagram/?charttype=gantt&diagramId=[new]

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}
==Aufruf für das Erstellen eines neues neuen Einzelsatzes==
Verfügbar ab CoP 10 HF 1.4

@Session_WebAppUrl@/singlerow/?singlerowid=[new]

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}

==Aufruf eines bestehenden Einzelsatzes==
Verfügbar ab CoP 10 HF 1.4

@Session_WebAppUrl@/singlerow/?singlerowid=<Einzelsatzname>
==Aufruf der Benutzerverwaltung==
Verfügbar ab CoP 10 HF 3.0

@Session_WebAppAurl@/useradministration

Weitere Informationen zur Benutzerverwaltung finden Sie [[WebApps:Benutzerverwaltung|hier]].

==Aufruf von Coplanner Berichten==
@Session_WebAppUrl@/reportviewer/?description=&reportname=<reportname>

__NOEDITSECTION__

[[Category:WebApps|Tiles]]
[[en:WebApps:Tiles]]

WebApps:Webimport

2022-08-22T07:24:51Z

L.dietrich: Aufruf von Webimporten: bei @Session_WebAppUrl@ fehlte das zweite @, was beim Kopieren sehr ärgerlich sein kann

__TOC__

Verfügbar ab CoP 10 HF 2.2

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Einstiegspunkte=
:* Neuanlage einer Webimportdefinition via Tiles: @Session_WebAppUrl@/Import/?importname=[new]
:* Bearbeiten einer bestehenden Webimportdefinition via Tiles: @Session_WebAppUrl@/Import/?importname=<NAME>
:* Drag-and-drop auf Zeilensicht (Einzelsatz noch nicht implementiert!)
:* Buttons in Zeilensicht/Matrixmaske (im Designer definierbar)

=Unterstützte Quellen=
:* CSV (*.csv, *.txt)
:* XLSX
:* Stage (Ab CoP 10 HF 2.5)

[[Image:EE_Webimport_Quellen.jpg|thumb|center|Webimport Quellen]]

=Allgemein=
Es gibt vier Schritte im Import: Quellen, Vorschau, Ziel und Ergebnis. Je nachdem von wo der Import aufgerufen wird variieren diese Schritte teilweise, da manche Schritte in gewissen Konstellationen nicht benötigt werden. Für Benutzer, die nicht im PowerUser-Modus sind, zieht die Ihnen zugeordnete Security.

==Quellen==
===CSV/Excel===
Nachdem der Typ CSV oder Excel bei der Quelle ausgewählt wurde, kann man die Datei, die man hochladen möchte auswählen. Bei Excel-Dateien kann man auch noch das Blatt auswählen, welches verwendet werden soll.

[[Image:EE_Webimport_Quelle1.jpg|thumb|center|Webimport Quellen]]

===Stage===
Nachdem der Typ Stage ausgewählt wurde, kann man die Verbindung auswählen. Hier steht die "CopSystemDB", die Datenbank vom CoPlanner zur Auswahl und zusätzlich alle, die in der svrconfig unter DBCon definiert wurden.
Beim SQL-Statement kann man seine Abfrage eingeben und auch einfach auf Session-Variablen oder Anwendungseigenschaften zugreifen.

==Vorschau==
===CSV/Excel===
In der Vorschau kann man ein Mapping für die Zeit erstellen und sieht eine Vorschau der Daten. Als Ziel-Zeitdimensionen stehen nur Dimensionen vom Typ Zeitdimension zur Verfügung.

Über Von und Bis kann der Importzeitraum verkleinert werden, sofern nicht alle Daten importiert werden sollen.

Werden in der Vorschau keine Daten angezeigt, stimmt vermutlich das Mapping für die Zeit nicht oder die Daten sind außerhalb der Ziel-Zeitdimension.

Zusätzlich kann hier definiert werden, ob die Daten Überschriften haben und ab welcher Zeile die Daten beginnen.

===Stage===
Man erhält hier nur eine Vorschau der Daten.

[[Image:EE_Webimport_Vorschau.jpg|thumb|center|Webimport Vorschau]]

==Ziel==
Hier muss eine Zieltabelle ausgewählt werden. Anhand der Namen wird versucht schon ein erstes automatisches Mapping zu erstellen. Sollten Sie Anpassungen vornehmen wollen, können Sie die Zuordnungen von Quelle zu Ziel via Drag-und-drop machen. Für Dimensions- und Tabellenlookups können auch Standardwerte ausgewählt werden, welche dann herangezogen werden, wenn keine Zuordnung zu einer Quellspalte erfolgt. Bei Lookups, die eine Zuordnung von einer Quellspalte haben, ist es möglich das Attribut für die Zuordnung zu wählen.

Die Kombination von den Dimensionen/Tabellen-Lookups, welche den Löschbereich gesetzt haben werden versucht zu löschen, bevor die Daten neu importiert werden. Ist z.B. der Löschbereich nur auf der Zeit definiert und es gibt einen Datensatz mit Jan 2021, so werden alle Daten für den Jan 2021 in dieser Tabelle gelöscht. Ist der Löschbereich auf der Zeit und den Produkten, so wird für die Kombination dieser beiden gelöscht. Gibt es einen Datensatz für Jan 2021 und Produkt Bianchi, so werden alle Datengelöscht, die sich im Jan 2021 befinden und das Produkt Bianchi aufweisen.

[[Image:EE_Webimport_Ziel.jpg|thumb|center|Webimport Ziel]]

==Optionen==
Ab CoP 10 HF 3.0

===Makros===
Hier können Makros definiert werden, die vor bzw. nach der Ausführung des Imports automatisch gestartet werden. Es werden nur die serverseitigen Befehle der Makros ausgeführt. Meldungen usw. werden ignoriert.

==Ergebnis==
Sollte es fehlerhafte Datensätze geben, können diese zum Teil auch über den CoPlanner gelöst werden. Hier unterscheiden wir zwei Vorkommen:
:* Fehlerhafte Datensätze können auftreten, wenn zum Beispiel Werte den falschen Datentyp haben. Diese Werte können dann im CoPlanner einfach überschrieben werden und werden für diesen einen Importvorgang herangezogen. Wählen Sie die Datei beim nächsten Mal wieder aus, müssen Sie die gleichen Korrekturen erneut durchführen.
:* Fehlerhafte Datensätze durch fehlende Zuordnungen zu Dimensionen. Werden hier Anpassungen durchgeführt, werden diese auch im CoPlanner gespeichert. Als PowerUser haben Sie die Möglichkeit hier direkt neue Dimensionselemente anzulegen oder auch Zuordnungen des jeweiligen Attributs zu überschreiben.

Sie haben die Möglichkeit entweder alle Datensätze zu korrigieren oder die Option zu wählen, dass fehlerhafte Datensätze ignoriert werden sollen. Zusätzlich können Sie definieren, ob man diese Ergebnisseite beim Ausführen des Imports anzeigen lässt.

[[Image:EE_Webimport_Ergebnis.jpg|thumb|center|Webimport Ergebnis]]

[[Image:EE_Webimport_Abschluss.jpg|thumb|center|Webimport Abschluss]]

=Importvorgang=
:* Es zieht die Security des aktuellen Benutzers, sowohl für das Löschen als auch das Schreiben.
:* Es ist im ersten Schritt nur möglich, in eine Tabelle zu importieren.
:* Aktuell wird in Serverculture importiert.
:* Es wird momentan nur auf Blattelemente importiert. Es ist angedacht, das in Zukunft konfigurierbar zu machen.
:* Der Löschbereich definiert, dass alle Datensätze des Ziels, bei denen alle als Löschbereich gewählten Lookups auf einem importierten Wert stehen, gelöscht werden. Das bedeutet, je mehr Mappings als Löschbereich gewählt werden, desto kleiner wird der Löschbereich.
:* Die COPSYS_IMPORT_SOURCE-Spalte des Ziels wird mit der ID des Imports befüllt, falls er auf einer Definition basiert. Für einen Drag-and-drop-Import wird ein konstanter Wert geschrieben.
:* Logging erfolgt in die sys_ImportHistory-Tabelle. Es ist nicht möglich, die ID des Imports in die bisherige Spalte zu schreiben. Die Import-ID wird in die COPSYS_IMPORT_SOURCE-Spalte geschrieben.

=Import via Drag-and-drop auf eine Web-Zeilensicht=
Es gibt nun die Möglichkeit eine Datei auf eine geöffnete Web-Zeilensicht zu ziehen. Dadurch öffnet sich der Importassistent bei CSV/Excel Importen, Stageimporte werden ohne diesen Dialog ausgeführt. In diesem kann man die Zuordnung von Quell- zu Zielspalten machen und ggf. Fehler korrigieren. Die Einstellungen für den Import werden jedoch nicht gespeichert und müssen bei jedem Import gemacht werden.

=Importe im Menü von Web-Masken=
In Webmasken kann man bestehende Webimportdefinitionen hinterlegen. Eine Importdefinition merkt sich alle Einstellungen zu einem Import. Dadurch wird die Durchführung für den Endanwender einfacher, da nicht mehr alle Konfigurationsschritte ausgeführt werden müssen.

__NOEDITSECTION__

[[Category:WebApps|Webimport]]
[[en:WebApps:Web import]]