Best Practice - Erstellung von Masken

Transkript

1 Best Practice - Erstellung von Masken

2 Copyright 06 Lexmark. All rights reserved. Lexmark is a trademark of Lexmark International, Inc., registered in the U.S. and/or other countries. All other trademarks are the property of their respective owners. No part of this publication may be reproduced, stored, or transmitted in any form without the prior written permission of Lexmark.

3 Inhaltsverzeichnis Einführung.... Allgemeines zur Maskenerstellung... Erstellung einer Abfragemaske mit eingebetteter Indexmaske.... Erstellen der einzubettenden Indexmaske.... Erstellung der Abfragemaske mit eingebetteter Indexmaske... Erstellung einer Abfragemaske mit Mashup...

4 . Allgemeines zur Maskenerstellung Best Practice - Erstellung von Masken Einführung In diesem Dokument wird die Vorgehensweise bei der Erstellung von Masken beschrieben. Als Beispiel soll einmal eine Maske mit eingebetteter Indexmaske und einmal eine Maske mit Mashup erstellt werden. Eingebettete Indexmasken dienen der Anzeige und direkten Bearbeitung der vorhandenen Indexwerte aus einer Abfragemaske heraus. Es können nur Änderungen an bereits vorhandenen Indexwerten vorgenommen werden, die sofort nach der Änderung wirksam werden. Eine Erstindexierung von Dokumenten ist über eine eingebettete Indexmaske nicht möglich. Als einzubettende Indexmaske sollte eine eigene Maske erstellt werden, da sie einige spezielle Besonderheiten aufweist, damit eine optimale Darstellung in den SAPERION Clients erreicht wird. Um die Arbeitsweise der Panes zu verdeutlichen, wird die eingebettete Indexmaske auf einen eigenen Pane gelegt, der als Tab hinter den Viewer gelegt wird. Mit Hilfe von Mashups können Webinhalte, wie beispielsweise Google Maps in SAPERION Masken angezeigt werden, wobei ein Zusammenhang zwischen den Inhalten der Ergebnisliste und den Webinhalten hergestellt wird. So können beispielsweise in der Ergebnisliste enthaltene Adressen ausgewertet und direkt innerhalb der Maske in einer Google Maps Landkarte angezeigt werden. Die Mashups nutzen hierbei die offenen Programmierschnittstellen der anderen Anwendung.. Allgemeines zur Maskenerstellung Bei der Erstellung von Masken kann in SAPERION zwischen Masken die nur im Rich Client und Masken die auch im Web Client verwendet werden können unterschieden. Beachten Sie hierbei: Standardmäßig werden Masken sowohl für den Rich Client als auch für den Web Client erstellt. Hierdurch ergibt sich: Bei der automatischen Generierung einer Maske werden Systemfelder nicht berücksichtigt. Sollen Systemfelder angezeigt werden, müssen diese nachträglich manuell hinzugefügt werden Innerhalb der Maske werden Panes verwendet. Nur mit einem Titel versehene Panes können verschoben werden Panes können übereinander gelegt werden, so dass Tabs entstehen. Diese können in diesem Fall aufgelöst werden. Soll dies nicht möglich sein, muss die Tab Funktion SAPERIONs verwendet werden.

5 Erstellung einer Abfragemaske mit eingebetteter Indexmaske Sie können definieren, für welchen Client Sie die Maske anlegen möchten. Wählen Sie den jeweiligen Client aus, in welchem die von Ihnen erzeugte Maske angezeigt werden soll, indem Sie die entsprechende Checkbox ("Web Client" oder "Rich Client") im Masken-Designer aktivieren. Im SAPERION Rich Client und Web Client werden dann gemäß Ihrer Wahl in der Navigation nur solche Anwendungen angezeigt, die auch für den jeweiligen Client angelegt worden sind. i Aus Kompatibilitätsgründen werden vorhandene Masken (Masken, die vor dem SAPERION SP Release angelegt wurden), in beiden Clients angezeigt. Erstellung einer Abfragemaske mit eingebetteter Indexmaske Als Grundlage für die Abfragemaske dient die mitgelieferte Definition "examplev7", die zunächst über Ribbon DESIGN > Gruppe TABELLEN > Befehl LADEN... geladen werden muss.. Erstellen der einzubettenden Indexmaske Erstellen Sie zunächst die einzubettende Indexmaske:. Klicken sie im Ribbon DESIGN > Gruppe ANWENDUNGEN > Befehl INDEXMASKE ERSTELLEN.... Klicken Sie im Ribbon OPTIONEN > Gruppe ANSICHT > Befehl OPTIONEN. Der Dialog "Maskeneigenschaften" öffnet sich.. Aktivieren Sie die Checkboxen "Horizontale Bildlaufleiste" und "Vertikale Bildlaufleiste". Hierdurch kann eine eingebettete Indexmaske auch dann vollständig angezeigt werden, wenn der vorgesehene Platz innerhalb der Abfragemaske zu klein ist. 4. Erzeugen Sie über Ribbon START > Gruppe LAYOUT > Befehl GENERIEREN eine Standardmaske für die Indexierung 5. Löschen Sie nicht benötigte Felder. 6. Löschen Sie die automatisch eingefügten Buttons. Fügen Sie stattdessen die Buttons "Bearbeiten", "Speichern" und "Abbrechen" ein Neben den notwendigen Schaltflächen "Bearbeiten", "Speichern" und "Abbrechen" können weitere Schaltflächen, wie beispielsweise "Speichern und nächstes Dokument" eingefügt werden. Je nach Größe und Lage der eingebetteten Indexmaske auf der Abfragemaske sollten die Schaltflächen leicht erreichbar auf der Indexmaske platziert werden. 7. Passen Sie die Maske auf die passende Größe an.

6 . 8.. Erstellung der Abfragemaske mit eingebetteter Indexmaske Speichern sie die Indexmaske ab. Im hier ausgeführten Beispiel wird die Maske unter "examplev7_e" gespeichert. Erstellung der Abfragemaske mit eingebetteter Indexmaske Nachdem die einzubettende Indexmaske existiert, müssen Sie nun die Abfragemaske erstellen:. Klicken sie auf Ribbon DESIGN > Gruppe ANWENDUNGEN > Befehl SUCHMASKE ERSTELLEN.. Erzeugen Sie über Ribbon START > Gruppe LAYOUT > Befehl GENERIEREN eine Standardmaske.. Löschen Sie nicht benötigte Felder und fügen Sie benötigte Systemfelder hinzu 4. Generieren Sie über Ribbon START > Gruppe LAYOUT > Befehl NEUER BEREICH einen neuen Pane. 5. Ziehen Sie den Pane auf den automatisch generierten Pane "Anzeigen". Hierdurch werden beide Panes als Tab angezeigt. 6. Klicken Sie in die Titelzeile des neuen Panes und vergeben Sie in den Eigenschaften unter "Text" einen Titel für den Pane. In unserem Beispiel vergeben wir hier den Titel "Indexwerte" 7. Wählen Sie unter Ribbon START > Befehl EINFÜGEN in der Dropdown-Liste den Eintrag "Maske" aus und ziehen Sie auf dem Pane einen Bereich auf. 8. Wählen sie die gewünschte Indexmaske (im Beispiel "examplev7_e") aus und klicken Sie auf [OK]. 9. Aktivieren Sie unter Ribbon START > Befehl EINFÜGEN die Checkbox "Verbindungen". 0. Ziehen Sie eine Verbindung von der Ergebnisliste zur eingefügten Indexmaske.. Speichern Sie die erstellte Maske ab. Erstellung einer Abfragemaske mit Mashup Mit Hilfe von Mashups können Webinhalte, wie beispielsweise Google Maps, in SAPERION Masken angezeigt werden, wobei ein Zusammenhang zwischen den Inhalten der Ergebnisliste und den Webinhalten hergestellt wird. Im folgenden Beispiel wird die in der Ergebnisliste enthaltene Adresse in einer Google Maps Landkarte angezeigt. i Ab Google Maps API Version wird für die Nutzung in einer eigenen Anwendung kein Lizenzkey mehr von Google benötigt.

7 Erstellung einer Abfragemaske mit Mashup Hierfür wird eine DDC mit Adressinformationen ("STREET" umfasst Straße und Hausnummer; "CITY" die Postleitzahl und Stadt) zugrunde gelegt. Im Gegensatz zum vorherigen Beispiel wird hier das Mashup nicht auf einem eigenen Pane gelegt, sondern als zusammen mit dem Viewer auf Tabs in einem Pane platziert.. Klicken sie auf Ribbon DESIGN > Gruppe ANWENDUNGEN > Befehl SUCHMASKE ERSTELLEN.. Erzeugen Sie über "Ribbon START > Gruppe LAYOUT > Befehl GENERIEREN eine Standardmaske.. Löschen Sie nicht benötigte Felder und fügen Sie benötigte Systemfelder hinzu. 4. Wechseln Sie auf den Pane "Anzeige". 5. Wählen Sie unter Ribbon START > Befehl EINFÜGEN in der Dropdown-Liste den Eintrag "Mashup" aus und ziehen Sie einen Bereich auf. 6. Es öffnet sich der Dialog "Mashup bearbeiten", über den der HTML-Text des Mashups eingegeben werden kann. 7. Aktivieren Sie den Radiobutton "HTML-Text" und geben Sie das gewünschte Listing ein. Als Beispiellisting für ein Mashup soll hier die Anzeige in Google Maps dienen: var map = null; var geocoder = null; var mashstreet = ""; var mashcity = ""; function initialize() { var mylatlng = new google.maps.latlng(5.04,9.8445); var myoptions = { zoom: 4, center: mylatlng, maptypeid: google.maps.maptypeid.roadmap map = new google.maps.map(document.getelementbyid("map_canvas"), myoptions); geocoder = new google.maps.geocoder(); function showaddress() { if (! geocoder ) initialize(); if (geocoder) { var mashaddress = mashstreet ", " mashcity; geocoder.geocode({'address': mashaddress, function (results, statuscode) { if(statuscode == google.maps.geocoderstatus.ok) { map.setcenter(results[0].geometry.location); map.setzoom(5); var marker = new google.maps.marker({ map: map, position: results[0].geometry.location ); 4

8 . Erstellung der Abfragemaske mit eingebetteter Indexmaske var infowindow = new google.maps.infowindow({ 'content': mashaddress ); infowindow.open(map, marker); else { alert('address was not found.'); ); else { alert('geocoder is not set.'); function setvalue( name, value) { switch (name.tolowercase()) { case "street": mashstreet = value; break; case "city": mashcity = value; break; default: break; function execute() { if (mashstreet!= "" && mashcity!= "") { showaddress(); </script> </body> </html> Für die Verwendung von Mashups sind folgende Funktionen vorhanden: SetValue: Mit SetValue (String Name, String Value) werden die Indexwerte aus der Maske im Mashup gesetzt. Execute: Mit Hilfe von Execute () werden für die Indexwerte eine Operation ausgeführt. 5

9 i Erstellung einer Abfragemaske mit Mashup Die JavaScript-Methoden "SetValue" und "Execute" werden automatisch von der Maske aufgerufen, wenn vom Benutzer ein neuer Ergebnislisteneintrag ausgewählt wird. Pro Ergebnislistenspalte wird "SetValue" mit dem Namen der Spalte und dem Spaltenwert der aktuellen Auswahl aufgerufen. Nachdem alle Werte übergeben wurden, wird automatisch die "Execute" Methode aufgerufen. 8. Klicken Sie auf [OK]. 9. Aktivieren Sie unter Ribbon START > Befehl EINFÜGEN die Checkbox "Verbindungen". 0. Ziehen Sie eine Verbindung von der Ergebnisliste zur eingefügten Mashup.. Klicken Sie Ribbon START > Gruppe LAYOUT > Befehl GRUPPEN. Es öffnet sich der Dialog "Feld-Gruppen", in dem für jedes angelegte Element über den Button [Neu] eine eigene Gruppe erzeugt wird, die anschließend dem jeweiligen Tab zugeordnet wird.. Klicken Sie auf Ribbon START > Gruppe EINFÜGEN > Befehl TAB. Es öffnet sich der Dialog "Tab-Control bearbeiten", über den die Tabs angelegt werden. Angelegt werden die Tabs über die Schaltfläche [Neu], wodurch eine Zeile in der Liste der angelegten Tabs erzeugt wird. Nach Anklicken der Zelle "Text" kann an dieser Stelle der angezeigte Text des Reiters eingegeben werden. Über einen langsamen Doppelklick werden Ihnen anschließend im Bereich Gruppe die angelegten Feldgruppen angezeigt, aus denen die jeweilige Gruppe ausgewählt werden kann.. Wenn Sie alle gewünschten Elemente einem Tab zugeordnet haben, klicken Sie auf [OK]. 4. Speichern Sie die gewünschte Maske ab. 6