====== Dynamic master data masks ======
Settings -> configure the GUI
\\ {{:en:admin:configure_gui_menue.png|Way to configure the GUI}}
\\ The order of the master data fields can be changed for each mandator or global by using dynamic master data masks.
===== Procedure =====
{{:en:admin:configure_gui_overview.png|Overview of configure the GUI}}
\\ On the **left** are all datas.
\\ In the **middle** all datas are listed with name, description, type, if it is internal and if you can delete it.
\\ On the **right** is the I want to-panel to upload datas.
== Choose the data ==
{{:en:admin:configure_gui_datas.png|Datas to edit}}
* All -> In the middle all datas will be shown.
* Edit -> In the middle all datas of edit masks will be shown.
* Display -> In the middle all datas of display masks will be shown.
Further down the same page you see visualized examples for each [[en:admin:dyngui#dynamic_mask_type|mask]].
==== Edit a template ====
- To download a template click on the name.
- Save the data.
- Open it with an editor (for example: texteditor)
- Save the data with the changes you made. [[en:admin:dyngui#configure_of_display_masks|See further down on the same page.]]
- Go back to Settings -> configure the GUI at your 1stAnswer and click on Upload at I want to-panel\\ {{:en:admin:configure_gui_upload.png|Upload of the changed data}}
- After uploading the file you can give some more details:
- XML-file -> That is the file you want to upload. To change the file click on **Chnage**.
- Dependent to mandator -> Is the checkbox activ the file is only available for the current mandator or is it not activ it's global available (for all mandators).
- Description -> The description can help to see what changes are made.
- Mask -> The name of the file can only choose out of the given.
In 1stAnswer are already **default configurations** for each mask. Diese entsprechen dem Stand der Felder vor dieser Erweiterung und sind in der Administration als intern gekennzeichnet.Sie können diese unter Einstellungen -> GUI konfigurieren herunterladen und editieren, ein **löschen** oder **überschreiben** der internen Konfigurationen ist nicht möglich.
==== Nach dem Upload ====
Nach dem Upload befindet sich Ihre Datei ebenfalls bei den bereits existierenden Dateien in Ihrem 1stAnswer.
\\ {{:admin:kunden_guikonfigurieren.png|Ihre Datei bei den Anderen}}
\\ Ihre Datei lässt sich daran erkennen, dass Sie beim Namen ein //(custom)// zusätzlich angehängt hat, bei Intern keinen Haken hat und Sie Sie löschen können.
**Die Applikation geht beim laden der richtigen Konfiguration folgendermaßen vor:**\\ - Prüfen ob es eine Konfiguration für diesen Mandanten gibt, wenn ja wird diese verwendet\\ - Prüfen ob eine Mandantenübergreifende Konfiguration existiert die nicht intern ist. Wenn ja wird diese verwendet.\\ - Falls keiner der oberen Punkte zutrifft wird die Standardkonfiguration verwendet.
===== Dynamische Maskentypen =====
=== Display ===
^Typname^Stammdatenelement^Ort in 1stAnswer^
|Case.InfoPanel|[[admin:emails#liste_der_verfuegbaren_felder_zum_kunden_benutzer|Customer]]|Incident-Detailansicht - Kundeninformationen im Info Panel\\ {{:dyngui:infopanel.jpg|Incident-Detailansicht - Kundeninformationen im Info Panel}}|
|Case.InfoPanle.ConfigurationItem|[[admin:emails#liste_der_verfuegbaren_felder_zur_anfrage-ci_verknuepfung|ConfigurationItem]]|Incident-Detailansicht - CI-Informationen im Info Panel\\ {{:dyngui:dynamicgui_caseinfo_ci.png|Incident-Detailansicht - Kundeninformationen im Info Panel}}|
|Case.ASP|[[admin:emails#liste_der_verfuegbaren_felder_zum_kunden_benutzer|Customer]]|Incident-Detailansicht - Tab "Kunde" Abschnitt für Ansprechpartnerinformationen\\ {{:admin:asp_data.jpg|Incident-Detailansicht - Tab "Kunde" Abschnitt für Ansprechpartnerinformationen}}|
|Case.Company|[[admin:emails|Company]]|Incident-Detailansicht - Tab "Kunde" Abschnitt für Firmeninformationen\\ {{:admin:company_data.jpg|}}|
|CustomerCockpit.ASP|[[admin:emails#liste_der_verfuegbaren_felder_zum_kunden_benutzer|Customer]]|Kundencockpit - Abschnitt für Ansprechpartnerinformationen\\ {{:admin:ckpt_asp.jpg|Kundencockpit - Abschnitt für Ansprechpartnerinformationen}}|
|CustomerCockpit.Company|[[admin:emails|Company]]|Kundencockpit - Abschnitt für Firmeninformationen\\ {{:admin:ckpt_company.jpg|Kundencockpit - Abschnitt für Firmeninformationen}}|
=== Edit ===
^Typname^ Ort in 1stAnswer^
|Company.Edit|Editieren einer Firma erreichbar aus dem Firmencockpit\\ {{:dyngui:edit_company.jpg|Firma editieren aus Firmencockpit}}|
|Customer.Edit|Editieren eines Kunden in der Anfrage sowie in der Detail Ansicht aus dem Kundencockpit\\ {{:dyngui:edit_customer.jpg|Kunden editieren in einer Anfrage und aus Kundencockpit}}|
|User.Edit|Editieren der Stammdaten eines Benutzers in der Benutzeradministration\\ {{:dyngui:edit_user.jpg|Stammdaten editieren in Benutzeradministration}}|
|Case.ProblemDescription.Edit|Editieren der Problembeschreibung eines Incidents\\ FIXME|
===== Konfiguration von Anzeigemasken =====
Die Konfiguration erfolgt per XML basierend auf diesem Schema: {{:dyngui:displayschema.txt|Display-Schema}} (Endung von .txt auf .xsd ändern)
== Mögliche Elemente ==
^Elemente^Beschreibung^
|Text|Generiert einen Link auf das Stammdatenobjekt.|
|Text|**Stellt den umschlossenen Text fett dar**|
| |Zeilenumbruch|
|Text|//Stellt den umschlossenen Text kursiv dar//|
|Text|Stellt den Text in roter Farbe und in Fettschrift dar.|
== Mögliche Platzhalter ==
Die Konfiguration der Platzhalter basiert auf der von [[admin:emails|Email-Templates]].
^Platzhalter^Beschreibung^Beispiel^
|[DATA:Feldname]|Analog zur EmailTemplate Platzhalter Konfiguration|[DATA:company.CompanyName]|
|[ATTRIBUTE:attribute1]|Analog zur EmailTemplate Platzhalter Konfiguration|[ATTRIBUTE:attribute1]|
|[SALUTATION:Wert]|Lokalisierung von internen Anrede Werten|[SALUTATION:[DATA:salutation]|
|[RES:Feldname]|Ermöglicht es Lokalisierungen von 1stAnswer auszugeben|[RES:UserData.UILocalizedLabelBusinessPhone]|
|[GROUP:Inhalt der Gruppe]|Damit ist es möglich Gruppen zu definieren. D.h. wenn innerhalb dieser Gruppe ein Stammdatenplatzhalter nicht gefüllt ist, wird der komplette Inhalt der Gruppe nicht ausgeben.| [GROUP: [DATA:businessPhone] ([RES:UserData.UILocalizedLabelBusinessPhone])]|
== Beispiel ==
[DATA:company.CompanyName] - [DATA:lastName], [DATA:firstName]
[GROUP:
[DATA:businessPhone]]
[GROUP:[DATA:street]] [GROUP:[DATA:country.boCountryId]]-[GROUP:[DATA:zipCode]][GROUP: [DATA:businessPhone2]][GROUP: [DATA:mobilePhone]][GROUP: [DATA:email]]
===== Konfiguration von Edit Masken =====
== Schema ==
Die Konfiguration erfolgt per XML basierend auf diesem Schema: {{:dyngui:editschema.txt|Edit-Schema}} (Endung von .txt auf .xsd ändern)
== Elemente ==
^Element^Beschreibung^
|DynamicEditConfiguration|Der Hauptzweig, gibt an das es sich hierbei um eine Maske zum Editieren handelt. Der Verweis auf das Schema muss hier hinterlegt sein (siehe Beispiel). Desweiteren gibt es das Attribut customizeLayout **Achtung nur wenn dieses Attribut auf true gesetzt ist werden die Felder entsprechend den Angaben geordnet, andernfalls wird die Reihenfolge nicht verändert**|
|Area|Der Bereich unter dem die folgenden Elemente gerendert werden sollen. Als Werte (für das Attribut id) gelten hier: ContactData, MasterData und Settings|
|Field|Ein konkretes Element (z.B. Vorname) das Attribut type akzeptiert die Werte md (für MasterData) und ca (für CustomAttribut) und gibt damit an ob es sich um ein Standardfeld oder ein zusätzliches Attribut handelt. Das Attribut visible akzeptiert die WErte true und false, bei true ist das Element sichtbar bei false ist es ausgeblendet|
|Target|Gibt an um welches Feld es sich konkret handelt. Die Namensgebung ist an die E-Mail Template Syntax angelehnt. Ausnahme bilder hier der Feldname zipAndCity welcher angibt das es sich um die Postleitzahl und den Ort handelt|
|Mandatory|Gibt an ob das Feld ein Pflichtfeld ist oder nicht (true oder false werden akzeptiert|
|Readonly|Gibt an ob das Feld Eingaben erlaubt oder Schreibgeschützt dargestellt wird (true oder false werden akzeptiert)|
|EditRight|Gibt an ob und welches Recht benötigt wird um das Feld zu editieren. **Hinweis:** Das Recht muss bereits in 1stAnswer vorhanden sein. Es besteht die Möglichkeit ein extra Recht anlegen zu lassen, kontaktieren Sie hierzu ihren Kundenbetreuer|
|VisibilityRight|Gibt an ob und welches Recht benötigt wird um das Feld zu sehen. **Hinweis:** Das Recht muss bereits in 1stAnswer vorhanden sein. Es besteht die Möglichkeit ein extra Recht anlegen zu lassen, kontaktieren Sie hierzu ihren Kundenbetreuer|
|NotSortedCustomAttributeArea|Dieser Bereich gibt an ob die zusätzlichen Attribute, welche nicht einem anderen Bereich zugeordnet wurden, weiterhin angezeigt werden (durch das Attribut visible, akzeptiert die Werte true oder false)|
== Beispiel ==
companyName
true
false
externalCompanyNumber
street
zipAndCity
locale
PhoneNumber
FaxNumber
EMail