WebApps:Tiles

System requirements

Supported Browsers

• Internet Explorer 11 or higher
• Edge
• Firefox
• Chrome

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: Dimension "NavigationTiles" has to exist in the model. Based on this dimension the tiles are built. These columns have to exist at least:

Title	Text (any length)	Display text
Icon	Text (any length)	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis	Path to the displayed picture starting vom the server directory
Style	Integer - standard value 0	Liefert die Darstellung des Eintrages. Derzeit sind folgende Möglichkeiten implementiert:	Representation of the entry. Currently these options are implemented: 0 = small tile 1 = big tile
NavigationAction	Text (any length; a mximum number of 4000 is recommended)	Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".	CopLink for navigation. Information for creating this link can be find in the section "Creation of a navigation link (NavigationAction)".
OpenIcon	Text (any length)	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 1 ist.	Path to the displayed image starting from the server directory. This icon will be shown if the state has value 1.
ReadyIcon	Text (any length)	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 2 ist.	Path to the displayed image starting from the server directory. This icon will be shown if the state has value 2.
ErrorIcon	Text (any length)	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Dieses Icon wird angezeigt, wenn der Status 3 ist.	Path to the displayed image starting from the server directory. This icon will be shown if the state has value 3.
Color	Text (any length)	Hintergrundfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)).	Background color. Can be defined as Hex-Value (just type) or as RGB value (Input: rgb(153,180,209)).
OpenColor	Text (any length)	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.	Background color. Can be defined as Hex-Value (just type) or as RGB value (Input: rgb(153,180,209)). This background color will be used if the state has value 1.
ReadyColor	Text (any length)	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.	Background color. Can be defined as Hex-Value (just type) or as RGB value (Input: rgb(153,180,209)). This background color will be used if the state has value 2.
ErrorColor	Text (any length)	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.	Background color. Can be defined as Hex-Value (just type) or as RGB value (Input: rgb(153,180,209)). This background color will be used if the state has value 3.
TextColor	Text (any length)	Schriftfarbe. Kann angegeben werden als Hex-Wert (einfach eingeben) oder als RGB Wert (Eingabe: rgb(153,180,209)).	font color. Can be defined as Hex-Value (just type) or as RGB value (Input: rgb(153,180,209)).
IsEnabled	Text (any length)	Gibt an, ob die hinterlegte Aktion ausgeführt werden kann. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.	Defines if specified action can be executed. True/False or an expression which returns True/False can be set here. z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
IsVisible	Text (any length)	Gibt an, ob das Element angezeigt wird. Es kann hier True/False oder eine Expression stehen, die True oder False liefert.	Defines if the element will be shown. True/False or an expression which returns True/False can be set here. z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
State	Text (any length) starting from 9.5 HF 1.9 (before it has been Integer)	Über den Status kann die Hintergrundfarbe und das Bild gesteuert werden.	Via state the background color of the picture can be defined. 0 = no state 1 = open 2 = Done/Finished 3 = Faulty Alle anderen Werte werden als „Kein Status“ interpretiert, wird keine Abfrage definiert, so ist dies ebenfalls der Fall. All other values as well as no given query will be interpreted as "no state".

Representation

Struktur

Wenn diese Struktur für den Bereich Enterprise dargestellt wird, erhalten Sie folgende Anzeige If the structure for the section Enterprise will be displayed, this will be displayed

Anzeige

Dimensionselemente der Ebene 1 werden nicht angezeigt. Dimension elements oflevel 1 will not be displayed.

Dimensionselemente der Ebene 2 entsprechen Anzeigesichten, über welche die Tiles aufgerufen werden. Dimension elements of level 2 represent display views which call the tiles.

Dimensionselemente der Ebene 3 entsprechen den Gruppen (siehe Modell, Planung, Konsolidierung, …) Dimension elements of level 3 represent groups (see model, planning, consolidation, ...)

Dimensionselemente der Ebene 4 entsprechen einfachen Kacheln, welche eine Navaktion auswerten können oder ein Submenü enthalten können. Dimension elements of level 4 represent simple tiles which can evaluate a navaction of include a submenu.

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. Dimension elements of level 5 represent submenus which are opened via the superior element. These elements can evaluate a navaction or include a submenu.

Dimensionselemente der Ebene 6 entsprechen einer weiteren Ebene von Sub-Menüs, welche über das Übergeordnete Elemente geöffnet werden. Dimension elements of level 6 represent another level of submenus which are opened via the superior element.

Dimensionselemente weiterer Ebenen werden nicht berücksichtigt. Dimension elements of further level will not be considered.

Groups

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: Groups are defined by level 3 of the dimension "NavigationTiles" and define a collection of menu entries. The group itself can not evaluate actions. These properties will be evaluated on groups:

Title	Anzeigetext. Wenn nicht vergeben zieht der Name des Dimensionselements.	Display text. If not defined name of dimension element will be used.
Icon	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis	Path to the displayed image starting from the server directory
Style	Derzeit keine Funktion	Currently not implemented
NavigationAction	Derzeit keine Funktion	Currently not implemented
OpenIcon	Derzeit keine Funktion	Currently not implemented
ReadyIcon	Derzeit keine Funktion	Currently not implemented
ErrorIcon	Derzeit keine Funktion	Currently not implemented
Color	Derzeit keine Funktion	Currently not implemented
OpenColor	Derzeit keine Funktion	Currently not implemented
ReadyColor	Derzeit keine Funktion	Currently not implemented
ErrorColor	Derzeit keine Funktion	Currently not implemented
TextColor	Font color
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.	Defines if the specified action can be executed. True/False or an expression which returns True/False can be set here. 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.	Defines if the element will be shown. True/False or an expression which returns True/False can be set here. z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
State	Currently not implemented

Tiles

Kacheln sind Elemente der Ebene 4 aus der Dimension „NavigationTiles“. Tiles are elements of level 4 from the "NavigationTiles" dimension. Auf Kacheln ist es möglich eine Aktion auszuführen. Dabei werden folgende Eigenschaften ausgewertet: An action can be executed on tiles. These properties will be evaluated:

Title	Anzeigetext. Wenn nicht vergeben zieht der Name des Dimensionselements.	Display text. If not specified name of dimension element will be used.
Icon	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis	Path to the displayed image starting from the server directory
Style	Liefert die Darstellung des Eintrages. Derzeit sind folgende Möglichkeiten implementiert:	Representation of entry. Currently these options are implemented: 0 = small tile 1 = big tile
NavigationAction	Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".	CopLink for the navigation. Information to create this link can be found in the section "Creation of navigation links (NavigationAction)".
OpenIcon	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 1 ist.	Path to the displayed image starting from the server directory. Will be shown if the state has value 1.
ReadyIcon	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 2 ist.	Path to the displayed image starting from the server directory. Will be shown if the state has value 2.
ErrorIcon	Liefert den Pfad zum anzuzeigenden Bild ausgehend vom Serververzeichnis. Wird angezeigt, wenn der Status 3 ist.	Path to the displayed image starting from the server directory. Will be shown if the state has value 3.
Color	Hintergrundfarbe, wenn kein gültiger Status oder Status 0	Background color if no valid state or state 0
OpenColor	Hintergrundfarbe, wenn Status = 1	Background color if state = 1
ReadyColor	Hintergrundfarbe, wenn Status = 2	Background color if state = 2
ErrorColor	Hintergrundfarbe, wenn Status = 3	Background color if state = 3
TextColor	Schriftfarbe	Font color
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.	Defines if the specified action can be executed. True/False or an expression which returns True/False can be set here. 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.	Defines if the element will be shown. True/False or an expression which returns True/False can be set here. z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
State	Über den Status kann die Hintergrundfarbe und das Bild gesteuert werden.	Via the state the background color and the image can be controlled. 0 = no state 1 = open 2 = Done/Finished 3 = Faulty Alle anderen Werte werden als „Kein Status“ interpretiert, wird keine Abfrage definiert, so ist dies ebenfalls der Fall.

All other values as well as no given query will be interpreted as "no state". |}

Submenu

Sind Alle Einträge welche sich unter der Ebene 5 befinden. Dabei werden folgende Eigenschaften ausgewertet: All entries which are located below level 5. These properties will be evaluated:

Title	Display text. If not defined name of dimension element will be used.
Icon	Path to the displayed image starting from the server directory
Style	Currently not implemented
NavigationAction	Liefert den CopLink für die Navigation. Informationen zum Erstellen dieses Links finden Sie im Abschnitt "Erstellen der Navigationslinks (NavigationAction)".	CopLink for the navigation. Information to create this link can be found in the section "Creation of a navigation link (NavigationAction)".
OpenIcon	Currently not implemented
ReadyIcon	Currently not implemented
ErrorIcon	Currently not implemented
Color	Currently not implemented
OpenColor	Currently not implemented
ReadyColor	Currently not implemented
ErrorColor	Currently not implemented
TextColor	Currently not implemented
IsEnabled	Defines if the specified action can be executed. True/False or an expression which returns True/False can be set here. 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.	Defines if the element will be shown. True/False or an expression which returns True/False can be set here. z.B.: Transform=FKT_CIF(@Session_Entity_ID@=1,False,True)
Status	Currently not implemented

Invoking from Web

@Session_WebAppUrl@/Tiles/?menu=<Level 2 from dimension NavigationTiles>

Example:

https://servername:4444/coplanner/Tiles/?menu=reporting

Hint  If used only in Web no CopNav Links can be used.

Extended Invocation

Ab 9.5 HF 2.4:

• hideSessionHeader: Defines if session header will be shown or not (true suppresses Session-Header). Default while opening is false.

Example:

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

Updating

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. If changes in the dimension NavigationTiles occur the users view will be updated immediately. Expressions, for example on state, will only be evaluated if there has been an update in the dimension NavigationTiles directly or the view has been actualized. If, for example a state will be set directly via the tile and the user should see this update immediately it is possible to integrate a dummy-import which overwrites the element "no assignment" in the dimension.

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.

If using a WebAppUrl with http(it is recommended to use https) it is possible that this can not be done automatically because a virus scan blocks this action. The solution is to add an exception to the scanner or the tiles will be reloaded after closing and re-opening the dimension or pressing F5.

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.

For instance, with Kaspersky the actualization will be blocked with http. The URL has to be added to the trustful websites.

Creation of NavigationLink (NavigationAction) - only possible when called from CoPlanner

Wenn Sie auf einer Zeilenmaske oder Eingabemaske Strg + J drücken erhalten Sie einen Dialog. Wählen Sie "coplete 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

If you press in a row mask or input mask CTRL + J you will receive a dialog. Choose "complete coplink (sample)" and click on "build..." Choose your desired action which you want to execute and click ok. The link which will be generated in the grey field needs to be edited as follows (to edit the link it needs to be copied in an editor):

• No __PARAM_NOT_FOUND__ must be included- delete these from the link
• replace cop:// with copNav.html?
• Remove spaces before and after ?

Example:

Original 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, which can be used:

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

Hint  Invocations which include a / , for instance PC/KST, the / needs to be replaced with %slash%. z.B.: copNav.html?name=PC%slash%KST&aktion=Dimension&p1=PC%slash%KST&p2=&p3=&p4=&frmlocation=Struktur&bild=&info=&styledefinition=&readonly=