====== Dynamische Stammdatenmasken ====== Einstellungen -> GUI konfigurieren \\ {{:dyngui:gui_konfigurieren_menue.png|Weg zu GUI konfigurieren}} \\ Mit Hilfe der dynamischen Stammdatenmasken lässt sich nun je Mandant oder global die Reihenfolge der angezeigten Stammdatenfelder festlegen. ===== Vorgehensweise ===== {{:dyngui:uebersicht_guikonfigurieren.png|Übersicht bei GUI konfigurieren}} \\ **Links** sind die zur Verfügung stehenden Dateien. \\ **In der Mitte** werden alle Dateien aufgelistet mit Namen, Beschreibung, Typ, ob intern und ob Sie es löschen können. \\ **Rechts** ist das Ich möchte-Panel zum Hochladen der bearbeiteten Dateien. == Datei auswählen == {{:dyngui:dateien_guikonfigurieren.png|Dateien zum Bearbeiten}} * Alle -> In der Mitte werden alle Dateien angezeigt. * Edit -> In der Mitte werden alle Dateien von Bearbeitungsmasken angezeigt. * Display -> In der Mitte werden alle Dateien von Anzeigemasken angezeigt. Anschauliche Beispiele der einzelnen [[admin:dyngui#dynamische_maskentypen|Masken ]]finden Sie weiter unten. ==== Datei bearbeiten ==== - Klicken Sie auf den Namen der entsprechenden Datei, um diese runter zu laden. - Speichern Sie die Datei - Öffnen Sie diese mit einem Editor (Bsp.: Texteditor) - Nehmen Sie Ihre [[admin:dyngui#konfiguration_von_anzeigemasken|Änderungen]], wie weiter unten beschrieben, vor und speichern Sie diese. - Gehen Sie zurück zu Einstellungen -> GUI konfigurieren in Ihrem 1stAnswer und klicken auf Upload im Ich möchte-Panel\\ {{:dyngui:upload_guikonfigurieren.png|Upload der geänderten Datei}} - Nachdem Sie die entsprechende Datei ausgesucht und über Upload hochgeladen haben müssen/ können Sie noch kleine Angaben vornehmen: - XML-Datei -> Hier wird die Datei angezeigt, die Sie hochladen wollen. Über **Ändern** können Sie diese noch ändern. - Mandant abhängig -> Über diese Checkbox können Sie festlegen, ob die Datei Mandantenweit oder global (für alle Mandanten) gelten. - Beschreibung -> Zur besseren Nachvollziehung der Änderungen können Sie der Datei noch eine Beschreibung mit geben. - Maske -> Der Name der Datei, der nur aus den vorgegebenen ausgewählt werden kann. 1stAnswer liefert ihnen bereits die **Standardkonfigurationen** für die einzelnen Masken. 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.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}}| ===== 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| Gruppiert den eingeschlossenen Text| ||Zeigt ein Bild an. **(NEU IN 5.5.1)**| == 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])]| |[BOOLEAN_GROUP:Inhalt der Gruppe]| Ähnlich wie GROUP. Nur das der komplette Inhalt der Gruppe nicht angezeigt wird, wenn ein Stammdatenplatzhalter den Wert "False" enthält. **(NEU IN 5.5.20)** | [BOOLEAN_GROUP:
[DATA:IsSpecialCustomer] ([RES:UserData.UILocalizedLabelSpecialCustomer])]| |[WEBROOT]|**NUR BEI MÖGLICH!** Fügt den Pfad zum Webverzeichnis ein. **(NEU IN 5.5.1)**|| == 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