Enterprise Edition:Help pages: Difference between revisions

From CoPlanner 11
Jump to navigationJump to search
No edit summary
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:




Der CoPlanner bietet mit den Hilfeseiten die Möglichkeit, dass Benutzer sich eigene Hilfeseiten mit Ihren spezifischen Informationen erstellen können.
CoPlanner offers the possibility that users can create their own help pages with specific information.  


==Benötigte Objekte==
==Required Objects==


Um die Hilfeseiten nutzen zu können, müssen folgende Schritte ausgeführt werden:
For using help pages these steps have to be executed:
# Bitte laden Sie die Datei herunter und entzippen Sie diese [http://copsupport.coplanner.com/files/wiki/Hilfeseiten.zip]
# Download and unpack this file [http://copsupport.coplanner.com/files/wiki/Hilfeseiten.zip]
# Legen Sie eine Anwendungseigenschaft mit dem Namen REST_HELP_LINK an. Diese muss die URL zur Online-Hilfe enthalten. Der Wert besteht aus „<http|https>://<Adresse des Servers>:<Port des REST-Service>/<Pfad der Coplanner Applikation>/prototype/#/help/“ bei einem lokalen REST-Server mit http auf port 8080 würde der Wert wie folgt aussehen <nowiki>http://localhost:8080/coplanner/prototype/#/help/</nowiki>
# Create an application property with the name REST_HELP_LINK. This property includes the URL to the online help. The value consists of „<http|https>://<Adress of server>:<Port of rest service>/<Path of CoPlanner application>/prototype/#/help/“. For a local rest server using http on port 8080 the value would be <nowiki>http://localhost:8080/coplanner/prototype/#/help/</nowiki>
# In der Datenbank werden die Tabellen HelpContent und COP_Help_Links benötigt, zusätzlich die Prozedur sp_HelpContent_initialisieren. Im heruntergeladenen Ordner finden Sie das Skript SQL_Objekte_Hilfeseiten.sql. Wenn Sie dieses ausführen werden die Tabellen und die Prozedur angelegt
# Tables HelpContent and COP_Help_Links and procedure sp_HelpContent_initialisieren are needed in the database. In the downloaded folder you can find the script SQL_Objekte_Hilfeseiten.sql. When you execute this script tables and procedure will be created.
# Im CoPlanner wird die Tabelle HelpIssues, die Formel HelpIssues_link, und das Makro HelpContent_initialisieren_mak benötigt. Im heruntergeladenen Ordner befindet sich auch das Objekte_Hilfeseiten.zip. Importieren Sie diese in der Objektverwaltung und führen Sie das Makro CreateViews aus.
# Table HelpIssues, formula HelpIssues_link and macro HelpContent_initialisieren_mak are needed. In the downloaded folder you can also  find Objekte_Hilfeseiten.zip. Import this file in the object administration and execute macro CreateViews.  


After performing these steps all required objects are installed.


Nach diesen Schritten haben Sie alle benötigten Objekte.


==Create help pages==
To create a new help page open table HelpIssues.


==Erstellen der Hilfeseiten==
Create one or more new data records via button "Create new record" in the ribbon and type in the title of the help page in the column HelpIssue. Column link has not to be filled manually because afterwards a formula will fill this column.
Um eine Hilfeseite zu erstellen öffnen Sie die Tabelle HelpIssues.


Legen Sie einen oder mehrere neue Datensätze über den Button "Neuen Datensatz erstellen" im Ribbon an und vergeben den Titel der Hilfeseite in der Spalte HelpIssue. In der Spalte Link muss nichts eingegeben werden. Dieser wird über eine Formel befüllt.
Save your records.


Speichern Sie Ihre Einträge.
Execute macro HelpContent_initialisieren_mak to finally create your new pages.  


Führen Sie das Makro HelpContent_initialisieren_mak aus um die Seiten final zu erstellen.
If you click on a link in the table HelpIssues you will be forwarded to the new help page.  


Wenn Sie nun in der Tabelle HelpIssues auf einen der Links klicken, gelangen Sie zur entsprechenden Hilfeseite.
[[Image:Hilfeseite_Neu.JPG|thumb|center|Help page]]


[[Image:Hilfeseite_Neu.JPG|thumb|center|Hilfeseite]]


==Edit help pages==
To add a link to the help page press hot key Ctrl + e.


==Bearbeiten der Hilfeseiten==
Now you have on the left side the functionality to add links via a drop down and you also can see the symbol [[Image:Button_Hilfeseite_Editieren.JPG]]. A click on this symbol opens the editor for the layout of the help text.  
Um auf der Hilfeseite einen Link hinzuzufügen drücken Sie die Tastenkombination Strg + e.


Sie erhalten nun links die Möglichkeit Verlinkungen über ein Dropdown hinzuzufügen und neben dem Titel der Hilfeseite das Symbol [[Image:Button_Hilfeseite_Editieren.JPG]]. Mit Klick auf dieses Symbol öffnet sich der Editor für die Gestaltung des Hilfetextes.
[[Image:Hilfeseite_Editieren.JPG|thumb|center|Edit help page]]
[[Image:Hilfeseiten_Editieren_Funktionen.png|thumb|center|Edit help page, Functions]]


[[Image:Hilfeseite_Editieren.JPG|thumb|center|Hilfeseite bearbeiten]]
[[Image:Hilfeseiten_Editieren_Funktionen.png|thumb|center|Hilfeseite bearbeiten, Funktionen]]


In the drop down "Add links" existing help pages can be linked. Selected pages will be shown in the drop down. To delete a linking move the mouse over this linking. A recycle bin symbol is being shown to delete the entry. A click on this symbol deletes the link.


Im Dropdown "Links hinzufügen" können Sie andere bestehende Hilfeseiten verlinken. Ausgewählte Seiten werden unter dem Dropdown angezeigt. Um eine Verlinkung wieder zu entfernen bewegen Sie die Maus über diese Verlinkung. Ihnen wird nun am rechten Ende ein Papierkorbsymbol zum löschen angezeigt. Mit Klick auf dieses Symbol kann der Link wieder entfernt werden.
On the right side you can type in and edit your text and rework your layout.


 
Texts can be inserted at each position. Texts can be formatted with options of the editor.  
Im rechten Bereich können Sie den auf der Seite angezeigten Text erfassen, ändern und die Formatierung überarbeiten.
 
Texte können einfach an der gewünschten Stelle eingegeben werden. Texte können mit den Optionen des Editors formatiert werden.


{| {{Bausteindesign1}}
{| {{Bausteindesign1}}
|-
|-
| <span style="color: darkblue;">'''Hinweis'''</span> &nbsp; Bitte vergessen Sie nicht darauf Ihre Änderungen mit dem grauen Diskettensymbol zu speichern.
| <span style="color: darkblue;">'''Hint'''</span> &nbsp; Do not forget to save your changes with the grey disk symbol.
|}
|}






==Aufruf der Hilfeseiten==
==Invocation of help pages==
Die Hilfeseiten können über CopLinks aufgerufen werden.
 
Beispiel für einen solchen Link, wobei Hauptseite der Name der Hilfeseite ist:
Help pages can be invoked via CopLinks.
Example for such a link in which 'Hauptseite' is the name of the help page:


cop://&name=Hilfe: Hauptseite&aktion=Sonstige&p1=Browserwindow&p2=@REST_HELP_LINK@Hauptseite?SessionID=@Session_ID@&p3=Details&p4=Work&frmlocation=Work
cop://&name=Hilfe: Hauptseite&aktion=Sonstige&p1=Browserwindow&p2=@REST_HELP_LINK@Hauptseite?SessionID=@Session_ID@&p3=Details&p4=Work&frmlocation=Work

Latest revision as of 10:37, 8 February 2017


CoPlanner offers the possibility that users can create their own help pages with specific information.

Required Objects

For using help pages these steps have to be executed:

  1. Download and unpack this file [1]
  2. Create an application property with the name REST_HELP_LINK. This property includes the URL to the online help. The value consists of „<http|https>://<Adress of server>:<Port of rest service>/<Path of CoPlanner application>/prototype/#/help/“. For a local rest server using http on port 8080 the value would be http://localhost:8080/coplanner/prototype/#/help/
  3. Tables HelpContent and COP_Help_Links and procedure sp_HelpContent_initialisieren are needed in the database. In the downloaded folder you can find the script SQL_Objekte_Hilfeseiten.sql. When you execute this script tables and procedure will be created.
  4. Table HelpIssues, formula HelpIssues_link and macro HelpContent_initialisieren_mak are needed. In the downloaded folder you can also find Objekte_Hilfeseiten.zip. Import this file in the object administration and execute macro CreateViews.

After performing these steps all required objects are installed.


Create help pages

To create a new help page open table HelpIssues.

Create one or more new data records via button "Create new record" in the ribbon and type in the title of the help page in the column HelpIssue. Column link has not to be filled manually because afterwards a formula will fill this column.

Save your records.

Execute macro HelpContent_initialisieren_mak to finally create your new pages.

If you click on a link in the table HelpIssues you will be forwarded to the new help page.

Help page


Edit help pages

To add a link to the help page press hot key Ctrl + e.

Now you have on the left side the functionality to add links via a drop down and you also can see the symbol . A click on this symbol opens the editor for the layout of the help text.

Edit help page
Edit help page, Functions


In the drop down "Add links" existing help pages can be linked. Selected pages will be shown in the drop down. To delete a linking move the mouse over this linking. A recycle bin symbol is being shown to delete the entry. A click on this symbol deletes the link.

On the right side you can type in and edit your text and rework your layout.

Texts can be inserted at each position. Texts can be formatted with options of the editor.

Hint   Do not forget to save your changes with the grey disk symbol.


Invocation of help pages

Help pages can be invoked via CopLinks. Example for such a link in which 'Hauptseite' is the name of the help page:

cop://&name=Hilfe: Hauptseite&aktion=Sonstige&p1=Browserwindow&p2=@REST_HELP_LINK@Hauptseite?SessionID=@Session_ID@&p3=Details&p4=Work&frmlocation=Work