Die Suchen, die im Navigationsbereich und in Dialog-Fenstern ausführbar sind, können mithilfe der Anwendung „Suchen anpassen“ in vielen Eigenschaften angepasst werden. Durch diese relativ einfache Anpassbarkeit der Suchen können neue Anforderungen an die bestehenden Suchen kurzfristig umgesetzt werden. Die Anpassung einer Suche kann direkt auf dem Produktivsystem vorgenommen werden und erfordert keine Anpassungsprogrammierung und kein spezielles Entwicklungssystem.
1 Zielgruppe
- Systemadministratoren
- Berater
- Entwickler
- Benutzer mit technischem Vorwissen
2 Begriffsbestimmung
Business Object
Das Datenmodell zu Comarch ERP Enterprise basiert auf Business Objects. Sie enthalten ausschließlich Daten und werden deshalb auch als Datencontainer bezeichnet. Die Bearbeitung dieser Daten wird mithilfe der Anwendungslogik realisiert, die Zustandstransformationen auf den Daten durchführt. Mit den Business Objects wurden unter weitestgehender Berücksichtigung der dritten Normalform die relevanten Ausschnitte der Realität modelliert, das heißt die Einheiten wurden möglichst redundanzfrei erstellt, woraus eine Vielzahl an Business Objects resultiert. Die Beschreibung des Aufbaus eines Business Objects ist ein Entwicklungsobjekt. Eine Business-Object-Instanz ist eine Ausprägung der als Entwicklungsobjekt abgelegten Beschreibung. Der Persistenzdienst kann Business-Object-Instanzen lesen, speichern und löschen. Oftmals liegt eine Business-Object-Beschreibung in normalisierter Form vor. Dabei kann die eigentliche betriebswirtschaftliche Größe durch mehr als ein Business Object beschrieben werden. Jedoch besteht immer nur ein Haupt-Business-Object. Daher werden Business Objects zu einem Business Entity gruppiert, bei denen ein besonderes gekennzeichnetes Business Object als Repräsentant der Gruppe auftritt. Dieser Repräsentant wird mit seiner Gruppe zum Business Entity.
Entwicklungsobjekt
Ein Entwicklungsobjekt ist ein in Comarch ERP Enterprise definiertes Objekt, mit welchem Anwendungsentwickler andere Objekte entwickeln. Alle Entwicklungsobjekte werden in der Repository-Datenbank archiviert. Sie können mit der Anwendung „Entwicklungsobjekte” angelegt, geändert und gelöscht werden.
Data-Description-Column
Für die Beschreibung der Eigenschaften der Daten an der Präsentationsoberfläche wurde ein Entwicklungsobjekttyp „Data-Description-Column” eingeführt. Dieser definiert insbesondere die Ein- und Ausgabeeigenschaften zu einem Attributpfad. Diese Beschreibung enthält neben den eigentlichen Eigenschaften auch Parameter, die eine Vererbung steuern und bestimmen, ob ein Wert an einer Stelle explizit definiert ist oder der Wert vom Vorgänger übernommen wird. Instanzen bestehen keine, die Daten werden zur Laufzeit ausschließlich gelesen.
Object-Query-Language (OQL)
Die Object-Query-Language (OQL) dient zum Formulieren von Anfragen an eine Datenbank-Instanz. OQL ist eine Erweiterung zu SQL, die anstatt mit einer Tabelle mit einem Business Object oder jeweils mehreren arbeitet.
Online-Transaction-Processing-Datenbank (OLTP-Datenbank)
In einer Online-Transaction-Processing (OLTP)-Datenbank werden Stamm- und Bewegungsdaten für die betriebswirtschaftlichen Anwendungen verwaltet. Zudem sind Verhaltensweisen hinterlegt, die als „Customizing“ bezeichnet werden.Die OLTP-Datenbank wird in einem Produktivsystem von den Benutzern am stärksten belastet. Deshalb ist sie speziell darauf ausgelegt, eine hohe Anzahl an Benutzern bedienen zu können, die parallel einen gemeinsamen Datenbestand bearbeiten.
Repository-Datenbank
Die Repository-Datenbank bildet die Basis eines Comarch-ERP-Enterprise-Systems. In dieser Datenbank sind alle Entwicklungsobjekte enthalten. Die Entwicklungsobjekte beschreiben und definieren ein System. Die Repository-Datenbank ist die zentrale Stelle für das Einspielen, Aktivieren und Verteilen von Softwareaktualisierungen. Daneben enthält sie das Data-Dictionary, welches das Datenbankschema durch ein objekt-relationales Typsystem beschreibt. Die Repository-Datenbank übernimmt darüber hinaus die Rolle der zentralen System-Datenbank. Sie enthält das Systemprotokoll und die Berechtigungsfestlegungen.
Valueset
Ein Valueset ist eine Aufzählung verwandter Werte, die als Gruppe einen gemeinsamen Namen erhalten. Ein Valueset ist vergleichbar mit einem Enum-Konstrukt aus anderen Programmiersprachen, wie C oder Pascal. Die Inhalte des Valuesets werden Valueset-Elemente genannt. Sie bestimmen die konkreten Werte des Valuesets, die als Konstanten (static final short) in die generierten Klassen geschrieben werden. Jeder Wert besteht aus einem Namen, einem short-Wert und einer Bezeichnung. Der Name wird als Konstantenname, der short-Wert als Konstantenwert verwendet. Die Bezeichnung gibt den Namen an der Präsentationsoberfläche wieder.
3 Prozesse
Alle verwendeten Suchen basieren auf dem Entwicklungsobjekt OQL-Suche. Eine OQL-Suche beschreibt die Auswahl von Daten aus Business Objects, die untereinander in Beziehung stehen.
Mit der Anwendung „Suchen anpassen“ können diese Suchen erweitert werden. Diese Anpassung kommt ohne Entwicklungsaufgaben und Entwicklungsaufträge aus. Sie können je nach dem, welche Berechtigungen Sie haben, Suchen für sich oder andere Benutzer anpassen. Die der angepassten Suche zugrunde liegende OQL-Suche wird bei der Anpassung nicht verändert und verbleibt in ihrem Originalzustand.
3.1 Anpassung einer Suche
Die Anwendung „Suchen anpassen“ kann auf folgende Weisen geöffnet werden:
- Aktion „Suchen anpassen“ im Menü des Speichern-Buttons für ein Suchmuster
Wenn Sie eine Suche geöffnet haben, z. B. im Navigationsbereich, dann steht Ihnen in der Symbolleiste der Suche der Menü-Button „Suchmuster speichern“ zur Verfügung. Im Menü dieses Buttons ist die Aktion „Suche anpassen“ verfügbar.
- Button „Suche anpassen“ im Dialog-Fenster „Technische Eigenschaften“ zu einem Feld
Haben Sie die technischen Eigenschaften zu einem Feld aufgerufen, dann ist im daraufhin geöffneten Dialog-Fenster unter dem Karteireiter „Allgemein“, Rubrik „Info“, neben dem Eintrag „OQL-Suche“ der Button „Suche anpassen“ verfügbar.
Hinweis:
Wird die Wertehilfe an einem Feld durch eine Auswahlliste visualisiert, dann kann der Weg über das Dialog-Fenster mit den technischen Eigenschaften die einzige Möglichkeit zum Anpassen der Suche sein.
Wenn Sie nicht über die notwendigen Berechtigungen zum Anpassen einer Suche verfügen, werden die entsprechenden Aktionen und Button nicht angezeigt und die Anwendung „Suchen anpassen“ kann nicht geöffnet werden.
3.2 Anpassungsebenen
Über die Anpassungsebene kann gesteuert werden, welche Suche die Benutzer sehen, wenn sie eine Suche öffnen. Folgende Anpassungsebenen existieren:
- Benutzer und Datenbank
- Benutzer und System
- Datenbank
- System
Dies ist auch die Reihenfolge, in der das ERP-System ermittelt, welche Suche der Benutzer zu sehen bekommt. Öffnet ein Benutzer eine Suche und existiert eine angepasste Suche der Ebene „Benutzer und Datenbank“, dann wird die angepasste Suche angezeigt. Andernfalls wird nach einer angepassten Suche auf den nächsten Ebenen gesucht und bei Erfolg angezeigt. Wird keine angepasste Suche gefunden, wird die OQL-Suche angezeigt.
Die angepassten Suchen der Ebene „System“ sind für alle Benutzer sichtbar.
Beispiel:
Wenn eine Suche auf einer OLTP-Datenbank mit der Anpassungsebene „System“ angepasst wird, dann wird auf jeder OLTP-Datenbank beim Aufruf der Suche die angepasste Suche angezeigt.
Mit der Ebene „Datenbank“ schränkt man die Sichtbarkeit der angepassten Suche auf eine Datenbank ein.
Beispiel:
Wenn eine Suche auf einer OLTP-Datenbank mit der Anpassungsebene „Datenbank“ angepasst wird, dann wird beim Aufruf der Suche nur auf der OLTP-Datenbank die angepasste Suche angezeigt, auf der der Benutzer angemeldet war, als er die Anpassung vorgenommen hat. Auf allen anderen OLTP-Datenbanken ist die Anpassung nicht sichtbar.
Bei OQL-Suchen der Repository-Datenbank besteht kein Unterschied zwischen der Ebene „Datenbank“ und der Ebene „System“, weil in einem ERP-System nur eine Repository-Datenbank existieren kann.
Die Anpassung einer Suche kann auch für einzelne Benutzer vorgenommen werden. Die beiden Ebenen können somit noch jeweils auf einen bestimmten Benutzer eingeschränkt werden.
3.3 Migration und Löschung angepasster Suchen
Die Anpassung einer OQL-Suche gilt immer für eine bestimmte Version der OQL-Suche. Wenn eine OQL-Suche durch das Einspielen einer Softwareaktualisierung bzw. durch das Aktivieren einer Entwicklungsaufgabe verändert wurde, dann muss die Anpassung auf die neue Version der OQL-Suche migriert werden. Bei der ersten Verwendung der Suche wird versucht, die Anpassung in die neue Version der OQL-Suche zu übernehmen. Meist bemerkt der Benutzer nicht, dass eine Migration stattgefunden hat. Die Migration kann z. B. in folgenden Fällen fehlschlagen:
- Ein in der OQL-Suche verwendetes Business Object wurde verändert, z. B. ein Feld gelöscht, oder ein Feld hat einen neuen logischen Datentyp bekommen.
- Ein weiteres Feld eines Business Objects wurde gelöscht oder der Datentyp verändert.
- Verknüpfungen zwischen Business Objects wurden gelöscht oder verändert.
Wenn eine Migration der Anpassung nicht möglich ist, dann wird die Anpassung gelöscht und eine Meldung in das Systemprotokoll geschrieben.
Die Anwendung bietet auch die Möglichkeit, alle angepassten Suchen in einem Verarbeitungsvorgang zu migrieren. Wenn der Benutzer die erforderliche Berechtigung besitzt, erscheint in der Standard-Symbolleiste ein Button für die Migration aller angepassten Suchen. Auch in diesem Fall werden nicht migrierbare angepasste Suchen gelöscht.
Die Migration schreibt das Ergebnis der Verarbeitung in das Systemprotokoll. Mit der Anwendung „Meldungsprotokolle“ können Sie weitere Informationen der Migration abrufen.
Wenn Sie in Ihrem System angepasste Suchen verwenden und Softwareaktualisierungen eingespielt haben, die ggf. OQL-Suchen enthalten, dann empfiehlt es sich, alle Suchen in einem Schritt zu migrieren. Die Suchen, die bei der Migration gelöscht wurden, können Sie danach neu erstellen. Die Migration erkennt auch fehlerhafte Anpassungen, d. h. alle Suchen, die nicht ausgeführt werden können, werden ebenfalls gelöscht.
Wenn Sie die Migration aller Suchen nach einer relevanten Änderung nicht ausgeführt haben, dann kann das beim Starten einer angepassten Suche zu einer Fehlermeldung führen. In diesem Fall können Sie die Suchanpassung auch selektiv löschen.
In der Fehlermeldung wird der Name der Suche angezeigt. Öffnen Sie die Anwendung „Entwicklungsobjekte“ und die Suche. Starten Sie die Anwendung „Suchen testen“ aus den Entwicklungsobjekten heraus. Nachdem die Anwendung geöffnet ist, wählen Sie die Aktion „Suche anpassen“ in der Symbolleiste aus. Die Anwendung „Suchen anpassen“ wird daraufhin geöffnet. Nun können Sie die angepasste Suche löschen.
Alternativ können Sie über die technischen Eigenschaften zu einem Feld die Anwendung „Suchen anpassen“ öffnen.
3.4 Ausnahmen für die Anpassung von Suchen
Nicht alle Suchen dürfen angepasst werden. Dazu zählen die OQL-Suchen aus folgenden Namensräumen:
- cisag.sys.repository
- cisag.sys.dictionary
- cisag.archive
3.5 Auswirkungen auf die Leistungsfähigkeit
Beim Ausführen einer Suche wird eine Anfrage an die Datenbank gestellt, die das Suchergebnis berechnet. Je komplexer die Suche ist, d. h. insbesondere je mehr Business Objects an der Suche beteiligt sind, desto komplexer ist die Anfrage.
Beim Anpassen einer Suche können Sie neue Felder und Business Objects zu einer Suche hinzufügen. Neue Abfragefelder in Business Objects, die bereits zu der Suche gehören, haben keine negativen Auswirkungen auf die Leistungsfähigkeit. Wenn jedoch Felder aus bisher nicht verwendeten Business Objects hinzugefügt werden, dann werden auch automatisch die Business Objects zu der Suche hinzugefügt. Diese zusätzlichen Business Objects können auch dann negative Auswirkungen auf die Leistungsfähigkeit haben, wenn Sie die neuen Felder bei einer Abfrage nicht benutzen.
4 Anwendungsbeschreibung: Suchen anpassen
Mit der Anwendung „Suchen anpassen“ ändern Sie bestehende Suchen ohne Anpassungsprogrammierung. Die Anwendung besteht aus einem Identifikationsbereich und einem Arbeitsbereich.
4.1 Identifikationsbereich
| Feld | Erläuterung |
| OQL-Suche | Wenn Sie die Anwendung „Suchen anpassen“ aus einer Suche heraus öffnen, so wird der technische Name der OQL-Suche in dieses Feld übernommen. Sie können den Namen der OQL-Suche nachträglich nicht ändern. |
| Bezeichnung | Die Bezeichnung der OQL-Suche wird als Überschrift des Such-Dialog-Fensters bzw. im Navigationsbereich verwendet. Sie können die Bezeichnung nicht verändern. |
| Status | Eine angepasste Suche kann aktiviert und deaktiviert werden. Eine deaktivierte Anpassung wird nicht angezeigt, nur aktivierte Anpassungen werden berücksichtigt. |
| Anpassungsebene | Mehrere Anpassungsebenen existieren: Die Suchen können sowohl für einzelne Benutzer als auch für alle Benutzer angepasst werden. In Kombination dazu kann noch definiert werden, ob die angepasste Suche systemweit oder für eine bestimmte Datenbank gelten soll. |
| Benutzer | Wenn die Suche für einen bestimmten Benutzer angepasst wurde, erscheint in diesem Feld sein Name. Den Benutzer können Sie nur bei der Neuanlage ändern. Wenn die gewählte Anpassungsebene, die Auswahl eines Benutzers nicht benötigt, oder aber die Berechtigungen das Anpassen für andere Benutzer nicht zulassen, so ist das Feld „Benutzer“ für die Eingabe nicht freigegeben. |
| Layoutauswahl | Die Layout-Auswahl ermöglicht, zwischen dem Originallayout und einem angepassten Layout für die Anzeige des Suchergebnisses zu wechseln. Das Originallayout basiert auf der zugrunde liegende OQL-Suche. Welches Layout verwendet wird, kann dem Feld „Originallayout“ entnommen werden.
Das angepasste Layout ermöglicht, das Layout des Suchergebnisses zu manipulieren. Es können Spalten der Anzeige hinzugefügt, bzw. entfernt werden. Das Layout kann für die Suche im Navigator und der Dialogsuche unterschiedlich eingestellt werden. Für jeden der beiden Bereiche kann die Sortierung separat festgelegt werden. Für das Originallayout „programmierte Liste“ und „programmierte Tabelle“ ist die Anpassung eingeschränkt, da auf die programmierten Elemente (Felder, Icons etc.) in der Anpassung verzichtet werden muss. Diese Einschränkung gilt für das Grid-Control nicht. Die Einstellung der Layout-Auswahl hat Einfluss auf den Status der Karteireiter „Sortiermerkmale“ und „Layout“. Ist die Layout-Auswahl auf „Originallayout“ eingestellt, so ist der Karteireiter „Sortiermerkmale“ eingeschaltet und der Karteireiter „Layout“ ausgeschaltet. In der Einstellung „Angepasstes Layout“ ist der Karteireiter „Sortiermerkmale“ ausgeschaltet und der Karteireiter „Layout“ eingeschaltet. Analog zu der Einstellung werden auch die Spalten „Sortiermerkmal“ und „Anzeige“ auf dem Karteireiter „Attribut-Auswahl“ ein- und ausgeschaltet. |
| Originallayout | In der zugrunde liegenden OQL-Suche ist definiert, wie das Suchergebnis layoutet wird. Folgende Werte können hier erscheinen: Grid-Control, programmiertes Grid-Contol, programmierte Tabelle, programmierte Liste.
Der Zusatz „programmiert“ gibt an, dass für das Layout ein Java-Klasse als Hook verwendet wird. |
4.2 Arbeitsbereich
Der Arbeitsbereich enthält folgende Karteireiter:
- Karteireiter „Attribut-Auswahl“
- Karteireiter „Suchmerkmale“
- Karteireiter „Sortiermerkmale“
- Karteireiter „Layout“
- Karteireiter „Struktur“
4.2.1 Karteireiter „Attribut-Auswahl“
Jedes Attribut, das Sie in einer angepassten Suche zur Abfrage, Sortierung oder Ausgabe verwenden, müssen Sie unter dem Karteireiter „Attribut-Auswahl“ hinzufügen. Unter diesem Karteireiter können Sie die Eigenschaften der bestehenden und neuen Attribute ändern.
Der Karteireiter „Attribut-Auswahl“ enthält eine Liste mit zwei Ebenen. Die Zeilen der ersten Ebene beschreiben jeweils ein Business Object.
| Spalte | Erläuterung |
| Alias | In OQL-Ausdrücken werden Business Objects mit Alias-Namen versehen. Jedes Business Object erhält einen eigenen Alias. Der Alias von neu hinzugefügten Business Objects wird automatisch vergeben. |
| Bezeichnung | Bezeichnung des Business Objects. |
| Business Object | Technischer Name des Business Objects. |
| ON-Klausel | Dieser Ausdruck gibt an, mit welchem anderen Business Object über welches Feld dieses Business Object verbunden ist. |
Die Zeilen der zweiten Ebene beschreiben jeweils ein Feld des Business Objects.
| Spalte | Erläuterung |
| Attributname | Der Attributname ist der technische Name des Attributs in dem Business Object. |
| Originallabel verwenden | Wenn die Funktion aktiviert ist, zeigt das Textfeld „Label“ das Originallabel des Feldes. Wird die Funktion deaktiviert, dann wird das Textfeld editierbar und ein anderes Label kann in das Feld geschrieben werden. |
| Label | Ist das Feld ein Abfragefeld, dann ist der Wert das Label des Feldes in der Suche. Wenn das Feld ein Anzeigefeld ist, dann erscheint der Wert als Spaltenüberschrift. |
| Wertehilfe | Wenn das Valueset editierbar ist, dann existieren alternative Wertehilfen und können für dieses Feld ausgesucht werden. Der Eintrag „Original“ bezeichnet die Wertehilfe, welche entweder in der OQL-Suche eingetragen wurde oder aus der Data-Description ermittelt wird. |
| Erweitert | In dieser Spalte erscheint ein Symbol, wenn das Feld bei der Anpassung einer Suche hinzugefügt wurde und nicht aus der zugrunde liegenden OQL-Suche stammt. |
| Suchmerkmal | In dieser Spalte kann das Feld mithilfe der Checkbox als Suchmerkmal der Suche hinzugefügt bzw. entfernt werden. Wenn ein Feld als Abfragefeld definiert wurde, kann über den Karteireiter „Selektion“ die Position des Feldes im Abfragebereich der Suche bestimmt werden. |
| Sortierbar | In dieser Spalte kann das Feld mithilfe der Checkbox als „sortierbar“ gekennzeichnet werden. Die Ergebnisliste kann danach sortiert werden.
Verwenden Sie nur die Felder zur Sortierung, die immer einen Wert haben (d. h. die nie null sind). Wenn ein Feld keinen Wert hat (d. h. null ist), dann werden, wenn das Ergebnis mehr als eine Seite umfasst, nicht alle Ergebnisse angezeigt. |
| Sortiermerkmal | Wenn das Feld als „sortierbar“ gekennzeichnet wurde, dann wird in dieser Spalte die Checkbox editierbar und das Feld kann als Sortiermerkmal gekennzeichnet werden. Die Sortiermerkmale sind die Felder, nach denen die Ergebnisliste standardmäßig sortiert wird. Die Checkbox „Sortiermerkmal“ ist nur aktiv, wenn die Layout-Auswahl auf „Originallayout“ eingestellt ist und das Feld als „Sortierbar“ gekennzeichnet ist. Die Reihenfolge und Sortierrichtung der Sortiermerkmale kann unter dem Karteireiter „Sortiermerkmale“ eingestellt werden.
Wenn die Layout-Auswahl auf „Angepasstes Layout“ geschaltet wurde, kann über das Sortier-Dialog-Fenster des Grid-Controls unter dem Karteireiter „Layout“ die Position und Sortierrichtung bestimmt werden. |
| Anzeige | In dieser Spalte kann das Feld mithilfe der Checkbox in die Ergebnisliste der Suche aufgenommen werden. Die Checkbox ist nur aktiv, wenn die Layout-Auswahl auf „Angepasstes Layout“ eingestellt ist. |
Button „Attribute hinzufügen oder entfernen“
In der Symbolleiste der Liste befindet sich der Button „Attribute hinzufügen oder entfernen“, mit dem ein Dialog-Fenster zum Hinzufügen bzw. Entfernen von neuen Attributen der Suche aufgerufen wird. Im Dialog-Fenster werden die Elemente der Suche in einer Baumstruktur dargestellt. Die Business Objects der zugrunde liegenden OQL-Suche bilden die Elternknoten des Baumes. Ein Business Object wird als Ordner dargestellt und kann nach dem Expandieren folgende Einträge enthalten:
- Felder des Business Objects
Die Felder eines Business Objects erscheinen als Kindknoten des Business-Object-Ordners. Die Einträge für Felder haben eine Checkbox über die die Felder als Suchmerkmale in die angepasste Suche aufgenommen bzw. entfernt werden können. Handelt es sich beim Entfernen eines Feldes um ein Feld aus der zugrunde liegenden OQL-Suche, dann wird nur das Feld aus der Menge der Suchmerkmale entfernt. Nur die durch die Anpassung hinzugefügten Attribute können aus der Suche komplett entfernt werden.
- Ordner von Part-Feldern
Sind Felder eines Business Objects die Felder eines Parts, dann werden diese in einem eigenen Ordner zusammengefasst und angezeigt. Der Name des Ordners ist der Name des Parts. Wenn Parts Beziehungen zu anderen Parts besitzen, dann werden diese innerhalb dieses Ordners als Ordner dargestellt. Der Ordnername ist der Name der Beziehung und ist in kursiver Schrift dargestellt.
- Ordner von Beziehungen zu anderen Business Objects
Der Ordnername ist der Name der Beziehung. Wenn diese Ordner expandiert werden, dann haben sie denselben Aufbau wie die Elternknoten.
- Ordner von dynamischen Business Objects
Existieren zu einem Business Object erweiterte Felder, dann werden diese in einem eigenen Ordner angezeigt.
Über die Beziehungsordner (von Parts und Business Objects) können weitere Attribute zu der Suche hinzugefügt werden. Wurden über diesen Weg schon Attribute aufgenommen, dann erscheint der Ordnername nicht kursiv, sondern in normaler Schriftart und der Alias für das Business Object wird mit im Ordnernamen angezeigt. Die Checkboxen der Felder, die über diese Beziehung zur Suche hinzugefügt wurden, sind aktiviert. Werden sämtliche Checkboxen der Felder eines Business Objects deaktiviert, dann wird die komplette Verknüpfung aus der Suche entfernt.
4.2.2 Karteireiter „Suchmerkmale“
Abfragefelder (Suchmerkmale) sind die Felder im Abfragebereich einer Suche, in denen die Suchmerkmale eingegeben werden. Mit der Liste kann bestimmt werden, an welchen Stellen in der Suche die Felder erscheinen sollen. Der Abfragebereich der Suche besteht aus zwei Spalten und beliebig vielen Zeilen. Die ersten zwei Zeilen im Abfragebereich der Suche werden immer angezeigt. Darauf folgende Zeilen werden in einem Aufklappbereich untergebracht, der optional sichtbar oder unsichtbar geschaltet werden kann.
Das Feld der ersten Zeile der Liste wird im Abfragebereich der Suche in die erste Spalte und Zeile positioniert. Die weiteren Felder werden, gemäß der Reihenfolge der Liste, von links nach rechts und von oben nach unten hinzugefügt.
In der Symbolleiste der Liste befinden sich folgende Buttons:
- An die erste Position
Das markierte Element wird an die erste Stelle der Liste gesetzt.
- Eine Position höher
Das markierte Element wird um eine Position nach oben verschoben.
- Eine Position tiefer
Das markierte Element wird um eine Position nach unten verschoben.
- An die letzte Position
Das markierte Element wird ans Ende der Liste gesetzt.
Die Spalten der Liste im Einzelnen:
| Spalte | Erläuterung |
| Alias | Alias des Business Objects, zu dem das Feld gehört. |
| Attributname | Name des Feldes. |
| Label | Label des Feldes. |
Hinweis:
Optional wird in einer weiteren Spalte der Hinweistext „nicht sichtbar“ angezeigt. Dazu zählen Suchmerkmale, die zwar als solches gekennzeichnet sind, aber für den Benutzer in der Suche nicht sichtbar sind. Das können z. B. versteckte Suchmerkmale sein, die generell das Suchergebnis beeinflussen. Diese Felder können nicht entfernt werden.
4.2.3 Karteireiter „Sortiermerkmale“
Die Ergebnisliste einer Suche kann nach mehreren Merkmalen sortiert werden. Die Standard-Sortiermerkmale sind die Merkmale, nach denen standardmäßig sortiert wird. In dieser Liste werden die Standard-Sortiermerkmale angezeigt und können in der Reihenfolge und Sortierrichtung angepasst werden.
In der Symbolleiste der Liste befinden sich folgende Buttons:
- An die erste Position
Das markierte Element wird an die erste Stelle der Liste gesetzt.
- Eine Position höher
Das markierte Element wird um eine Position nach oben verschoben.
- Eine Position tiefer
Das markierte Element wird um eine Position nach unten verschoben.
- An die letzte Position
Das markierte Element wird ans Ende der Liste gesetzt.
Die Spalten der Liste im Einzelnen:
| Spalte | Erläuterung |
| Alias | Alias des Business Objects, zu dem das Feld gehört. |
| Attributname | Name des Feldes. |
| Label | Label des Feldes. |
| Sortierrichtung | Über diesen Button kann festgelegt werden, ob aufsteigend oder absteigend sortiert werden soll. |
Hinweis:
Dieser Karteireiter ist nicht auswählbar, wenn für die Layout-Auswahl der Eintrag „Angepasstes Layout“ gewählt wurde. In diesem Fall muss die Sortierung über das Sortieren-Dialog-Fenster des jeweiligen Grid-Controls unter dem Karteireiter „Layout“ festgelegt werden.
4.2.4 Karteireiter „Layout“
Der Karteireiter „Layout“ enthält zwei Grid-Controls, eines für das Layout des Suchergebnisses im Dialog-Fenster und eines für das Layout des Suchergebnisses im Navigationsbereich. Wie bei den OQL-Suchen können für beide Bereiche getrennte Layouts festgelegt werden. Darüber hinaus können zusätzliche Eigenschaften, wie z. B. die Sortierung, für jeden Bereich separat festgelegt werden.
Die Anordnung und Auswahl der Attribute erfolgt über die Drag-&-Drop-Funktionen des Grid-Controls.
Zur Anzeige gelangen alle Attribute, die unter dem Karteireiter „Attribut-Auswahl“ für die Anzeige gekennzeichnet sind. Wenn die Originaldarstellung als „programmiertes Grid-Control“ ausgewiesen ist, dann können zusätzliche Spalten im Grid-Control vorkommen. Diese Spalten lassen sich nicht über die „Attribut-Auswahl“ ausschalten.
Beide Grid-Controls bieten die Funktion „Layout zurücksetzen“ in ihren jeweiligen Symbolleisten an. Hierüber werden die Layout-Informationen des Grids wieder zurückgesetzt. Sind Layout-Informationen in der OQL-Suche hinterlegt und die Originaldarstellung der Suche steht auf „Grid-Control“ bzw. auf „programmiertes Grid-Control“, dann werden diese Layout-Informationen beim Zurücksetzen berücksichtigt.
4.2.5 Karteireiter „Struktur“
Dieser Karteireiter dient zur Visualisierung der Verknüpfungsstruktur der in der Suche vorhandenen Business Objects. Die Elemente der Suche werden in Kästchen dargestellt. Eine Verknüpfung besteht aus dem Quell-Objekt, dem Ziel-Objekt und den Informationen der Verknüpfungsart und –bedingung. Jedes dieser drei Elemente wird jeweils in einem Kasten dargestellt. Die Kästen für Quell- und Ziel-Objekte zeigen den Alias, den Anzeigenamen und den technischen Namen des jeweiligen Business Objects. Der Kasten der Verknüpfungsinformationen enthält die Verknüpfungsart und die Verknüpfungsbedingung. Die Darstellung einer Verknüpfung ist wie folgt:
Als erstes wird der Kasten des Quell-Objektes angezeigt. Mit kurzem Abstand folgt darauf der Kasten mit den Verknüpfungsinformationen. Unmittelbar an den Kasten anschließend folgt der Kasten mit dem Ziel-Objekt. Ein Business Object kann für mehrere Verknüpfungen ein Quell-Objekt sein. In diesem Fall folgt mit kleinem Abstand ein weiterer Kasten mit den Verknüpfungsinformationen, gefolgt von dem Kasten mit dem Verknüpfungsziel.
4.3 Anwendungsbezogene Aktionen
In der Standard-Symbolleiste befinden sich Buttons für die folgenden anwendungsbezogenen Aktionen:
- Angepasste Suche testen
- Alle erweiterten Suchen migrieren
4.3.1 Angepasste Suche testen
Wurde eine Suche angepasst und gespeichert, dann kann mithilfe dieser Aktion die Anwendung „Suchen testen“ geöffnet werden. Mit dieser Anwendung kann dann die Suche bezüglich ihres gewünschten Verhaltens getestet werden.
Hinweis:
Für die Anwendung „Suchen testen“ leistet die Comarch Software und Beratung AG keine Unterstützung, Wartung oder Gewährleistung. Diese Anwendung erlaubt Zugriff auf beliebige Daten, daher sollten Sie nur Administratoren für die Anwendung „Suchen testen“ berechtigen.
4.3.2 Alle erweiterten Suchen migrieren
Mithilfe dieser Aktion werden alle angepassten Suchen migriert.
4.4 Vorgehensweisen
4.4.1 Abfragefeld eines Business Objects zur Suche hinzufügen
- Öffnen Sie die Anwendung, in der Sie die Suche aufrufen können, welche Sie anpassen möchten.
- Wählen Sie im Navigationsbereich den Karteireiter „Suche“.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Wählen Sie im Kopfbereich der Liste den Button „Attribute hinzufügen oder entfernen“.
- Ein Dialog-Fenster öffnet sich.
- Expandieren Sie den Ordner des gewünschten Business Objects.
- Aktivieren Sie die Checkbox des gewünschten Feldes, welches Sie zur Suche hinzufügen möchten.
- Wählen Sie „Übernehmen“.
- Wählen Sie bei Bedarf im Identifikationsbereich den Status „Aktiv“.
- Wählen Sie in der Standard-Symbolleiste „Speichern“.
4.4.2 Abfragefeld eines Business Objects aus der Suche entfernen
- Öffnen Sie die Anwendung, in der Sie die Suche aufrufen können, welche Sie anpassen möchten.
- Wählen Sie im Navigationsbereich den Karteireiter Suche.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Wählen Sie im Kopfbereich der Liste den Button „Attribute hinzufügen oder entfernen“.
- Ein Dialog-Fenster öffnet sich.
- Expandieren Sie den Ordner des gewünschten Business Objects.
- Deaktivieren Sie die Checkbox des gewünschten Feldes, welches Sie aus Suche entfernen möchten.
- Wählen Sie „Übernehmen“.
- Wählen Sie in der Standard-Symbolleiste „Speichern“.
Hinweis:
Wenn Sie alle Checkboxen eines Business Objects deaktivieren und dieses Business Object nicht eines aus der zugrunde liegenden OQL-Suche ist, dann wird die Verbindung (Join) komplett aus der angepassten Suche entfernt. Ist allerdings dieses Business Object Quelle einer anderen Verbindung (Join) in der angepassten Suche, dann verbleibt es noch.
4.4.3 Weitere Business Objects mit Business Objects der Suche verknüpfen
- Öffnen Sie die Anwendung, in der Sie die Suche aufrufen können, welche Sie anpassen möchten.
- Wählen Sie im Navigationsbereich den Karteireiter Suche.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Wählen Sie im Kopfbereich der Liste im Arbeitsbereich den Button „Attribute hinzufügen oder entfernen“.
- Ein Dialog-Fenster öffnet sich.
- Expandieren Sie den Ordner des gewünschten Business Objects, welches eine Beziehung zu dem Business Objects besitzt, welches Sie zur Suche hinzufügen möchten.
- Expandieren Sie den Ordner der Beziehung.
- Aktivieren Sie die Checkboxen der Felder, die Sie zur Suche hinzufügen möchten.
- Wählen Sie „Übernehmen“.
- Wählen Sie bei Bedarf im Identifikationsbereich den Status „Aktiv“.
- Wählen Sie in der Standard-Symbolleiste „Speichern“.
Hinweis:
Sie können in dem Dialog-Fenster „Suchmerkmale hinzufügen“ beliebig tief den Beziehungen der Business Objects folgen und somit Felder von Business Objects beliebiger Tiefe zur Suche hinzufügen. Jedes Business Object entlang der Beziehungen, denen Sie bis zum Ziel-Objekt gefolgt sind, wird mit dem Quell-Objekt verbunden (gejoint). Sie können damit Suchen des Systems unbrauchbar machen, weil die Komplexität der Verbindung (Joins) zu keinem Ergebnis mehr führt.
4.4.4 Eine Suche für alle Benutzer anpassen
- Öffnen Sie die Anwendung, in der Sie die Suche aufrufen können, welche Sie anpassen möchten.
- Wählen Sie im Navigationsbereich den Karteireiter Suche.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Wählen Sie im Feld „Anpassungsebene“ je nach gewünschter Anpassungsebene den Eintrag „Datenbank“ oder „System“.
- Wählen Sie in der Standard-Symbolleiste „Neu“.
- Nehmen Sie die gewünschten Anpassungen vor.
- Wählen Sie in der Standard-Symbolleiste „Speichern“.
Hinweis:
Wenn Sie wissen, dass die Suche schon für alle Benutzer angepasst wurde, wählen Sie nach der Änderung der Anpassungsebene nicht „Neu“, sondern „Aktualisieren“. Dann wird die angepasste Suche angezeigt.
4.4.5 Eine angepasste Suche testen
- Öffnen Sie die Anwendung, in der Sie die Suche aufrufen können, welche Sie anpassen möchten.
- Wählen Sie im Navigationsbereich den Karteireiter Suche.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Nehmen Sie die gewünschte Anpassung vor.
- Wählen Sie in der Standard-Symbolleiste „Speichern“.
- Wählen Sie in der Standard-Symbolleiste „Angepasste Suche testen“.
- Die Anwendung zum Testen der Suche wird geöffnet.
Hinweis:
Die angepasste Suche muss zum Testen nicht aktiviert werden. Sie können auch inaktive Suchen testen.
4.4.6 Angepasste Suchen migrieren
- Öffnen Sie eine Anwendung, in der Sie eine Suche aufrufen können.
- Wählen Sie im Navigationsbereich den Karteireiter Suche.
- Wählen Sie in der Symbolleiste der Suche beim „Speichern“-Button den Button mit dem Pfeil nach unten.
- Ein Menü erscheint.
- Wählen Sie in dem Menü den Eintrag „Suchen anpassen…“.
- Die Anwendung „Suchen anpassen“ wird geöffnet.
- Wählen Sie in der Standard-Symbolleiste „Alle erweiterten Suchen migrieren“
- Alle angepassten Suchen werden auf allen angeschlossenen Datenbanken migriert.
Hinweis:
Mit dem Tool „rgzsre“ können Sie die angepassten Suchen migrieren, ohne die Anwendung „Suchen anpassen“ zu starten.
4.5 Customizing
Für die Anwendung „Suchen anpassen“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
4.6 Business Entitys
Für die Anwendung „Suche anpassen“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um
- Berechtigungen zu vergeben,
- Aktivitätsdefinitionen einzurichten oder
- Daten zu importieren oder zu exportieren.
Erweiterte OQL-Suche
com.cisag.sys.objsearch.obj.SearchExtension
4.7 Berechtigungen
Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumentation „Berechtigungen“ nachlesen.
4.7.1 Spezielle Fähigkeiten
Für die Anwendung „Suchen anpassen“ bestehen folgende spezielle Fähigkeiten, die sich auf Aktionen beziehen. Für diese Fähigkeiten können Sie in der Anwendung „Berechtigungsrollen“ Berechtigungen vergeben.
- Suchen anpassen
com.cisag.sys.objsearch.ChangeSearches
Erlaubt dem Benutzer angepasste Suchen für die Anpassungsebene „Benutzer und System“ und „Benutzer und Datenbank“ zu erstellen.
- Suchen anderer Benutzer anpassen
com.cisag.sys.objsearch.ChangeOtherUsersSearches
Erlaubt dem Benutzer angepasste Suchen für die Anpassungsebene „System“ und „Datenbank“ zu erstellen.
- Angepasste Suchen löschen
com.cisag.sys.objsearch.DeleteSearchExtensions
Erlaubt dem Benutzer die angepassten Suchen über die Tool-Shell zu löschen.
4.7.2 Organisations-Zuordnungen
Für die Anwendung „Suchen anpassen“ ist eine Organisations-Zuordnung nicht erforderlich.
4.7.3 Besonderheiten
Für die Anwendung „Suchen anpassen“ bestehen keine Besonderheiten.
4.7.4 Berechtigungen für Geschäftspartner
Die Anwendung „Suchen anpassen“ ist für Geschäftspartner nicht freigegeben.
5 Anwendungsbeschreibung: Suchen testen
In der Anwendung „Suchen anpassen“ kann mithilfe des Buttons „Angepasste Suche testen“ in der Standard-Symbolleiste die Anwendung „Suche testen“ geöffnet werden. Mit dieser Anwendung können OQL-Suchen und angepasste Suchen getestet werden.
Hinweis:
Für die Anwendung „Suche testen“ leistet die Comarch Software und Beratung AG keine Unterstützung, Wartung oder Gewährleistung. Diese Anwendung erlaubt Zugriff auf beliebige Daten, daher sollten Sie nur Administratoren für „Suchen testen“ berechtigen.
Die Anwendung „Suche testen“ ist nicht in einen Identifikations- und einen Arbeitsbereich aufgeteilt. Sie hat nur einen Arbeitsbereich mit Eingabefeldern.
5.1 Arbeitsbereich
Die Felder im Einzelnen:
| Feld | Beschreibung |
| OQL-Suche | Name der Suche, die getestet werden soll. |
| Dialogsuche testen | |
| Testfeld | Über die Wertehilfe dieses Feldes kann die Suche aufgerufen werden.
Wurde ein Objekt in der aufgerufenen Suche ausgewählt, dann wird die Identifikation dieses Objektes in diesem Feld angezeigt. |
| Testfeld (erweitert) | Über die Wertehilfe dieses Feldes kann die Suche aufgerufen werden.
Wurde ein Objekt in der aufgerufenen Suche ausgewählt, dann wird die Identifikation und die Bezeichnung dieses Objektes in diesem Feld angezeigt. |
| Einstellungen | |
| Mehrfachauswahl im Dialog
(Checkbox) |
Hierüber kann die Möglichkeit der Mehrfachauswahl in der Ergebnisliste ein und ausgeschaltet werden. |
| Angepasste Suchen verwenden
(Checkbox) |
Im Standardfall wird bei vorhanden sein einer angepassten Suche, diese angezeigt. Wenn diese Funktion nicht aktiviert ist, dann wird die originale OQL-Suche angezeigt. |
| Vorschlagswerte verwenden
(Checkbox) |
Wird diese Funktion aktiviert, dann erscheint eine zusätzliche Rubrik „Suchmerkmale vorbelegen“, in der für jedes Auswahlfeld der Suche ein Feld existiert. In diesen Feldern können Vorschlagswerte für die Suche eingetragen werden, die beim Öffnen der Suche berücksichtigt werden. |
| Anpassungen | |
| Nur aktivierte Anpassungen benutzen
(Checkbox) |
Die angepassten Suchen werden nur dann statt der Originalsuche angezeigt, wenn die angepasste Suche aktiviert ist. Diese Festlegung kann über diese Funktion übersteuert werden. |
| Anpassungsebene | Die Anpassungsebene wird vorgegeben. Wenn die Funktion „Automatische Ermittlung der Anpassungsebene“ deaktiviert wird, dann kann die Anpassungsebene gewählt werden. |
| Automatische Ermittlung der Anpassungsebene
(Checkbox) |
Ist diese Funktion deaktiviert, dann wird das Feld „Anpassungsebene“ editierbar. In diesem Fall kann die automatische Auswahl der Anpassungsebene geändert werden. |
| Benutzer | Bei benutzerbezogenen Anpassungsebenen kann der gewünschte Benutzer eingetragen werden, wenn dafür eine Berechtigung besteht. Anderenfalls wird der angemeldete Benutzer angezeigt. |
5.2 Anwendungsbezogene Aktionen
Folgende anwendungsbezogene Aktionen können über die Buttons in der Standard-Symbolleiste ausgeführt werden:
- Übernahme in die Suche im Navigationsbereich
- Anwendung „Suche anpassen“ öffnen
- Anwendung „Generische Suchen“ öffnen
5.2.1 Übernahme in die Suche im Navigationsbereich
Diese Aktion übernimmt die geöffnete OQL-Suche als Suche in den Navigationsbereich.
5.2.2 Anwendung „Suche anpassen“ öffnen
Öffnet die Anwendung „Suchen anpassen“.
5.2.3 Anwendung „Generische Suchen“ öffnen
Öffnet die Anwendung „Generische Suche“ mit der geöffneten OQL-Suche.
Hinweis:
Für die Anwendung „Generische Suche“ leistet die Comarch Software und Beratung AG keine Unterstützung, Wartung oder Gewährleistung. Diese Anwendung erlaubt Zugriff auf beliebige Daten, daher sollten Sie nur Administratoren für „Suchen testen“ berechtigen.
5.3 Customizing
Für die Anwendung „Suchen testen“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
5.4 Business Entitys
Für die Anwendung „Suche testen“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um
- Berechtigungen zu vergeben,
- Aktivitätsdefinitionen einzurichten oder
- Daten zu importieren oder zu exportieren.
Suche
com.cisag.sys.objsearch.obj.ObjectSearchDescription
5.5 Berechtigungen
Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumentation „Berechtigungen“ nachlesen.
5.5.1 Spezielle Fähigkeiten
Für die Anwendung „Suchen testen“ bestehen folgende spezielle Fähigkeiten, die sich auf Aktionen beziehen. Für diese Fähigkeiten können Sie in der Anwendung „Berechtigungsrollen“ Berechtigungen vergeben.
- Suchen anpassen
com.cisag.sys.objsearch.ChangeSearches
Erlaubt dem Benutzer angepasste Suchen für die Anpassungsebene „Benutzer und System“ und „Benutzer und Datenbank“ zu erstellen.
- Suchen anderer Benutzer anpassen
com.cisag.sys.objsearch.ChangeOtherUsersSearches
Erlaubt dem Benutzer angepasste Suchen für die Anpassungsebene „System“ und „Datenbank“ zu erstellen.
- Angepasste Suchen löschen
com.cisag.sys.objsearch.DeleteSearchExtensions
Erlaubt dem Benutzer die angepassten Suchen über die Tool-Shell zu löschen.
5.5.2 Organisations-Zuordnungen
Für die Anwendung „Suchen testen“ ist eine Organisations-Zuordnung nicht erforderlich.
5.5.3 Besonderheiten
Für die Anwendung „Suchen testen“ bestehen keine Besonderheiten.
5.5.4 Berechtigungen für Geschäftspartner
Die Anwendung „Suchen testen“ ist für Geschäftspartner nicht freigegeben.