Elementare Suchhilfen anlegen

1. Öffnen Sie den Repository Browser (Transaktionscode SE80) und navigieren Sie zu dem Paket, in dem Sie die Suchhilfe anlegen möchten.
2. Wählen Sie im Kontextmenü des Paket Anlegen → Dictionary-Objekt → Suchhilfe.

   Es erscheint ein Dialogfenster, in dem Sie den Suchhilfenamen eingeben müssen.

3. Wählen Sie den Auswahlknopf Elementare Suchhilfe und bestätigen Sie mit  mit dem Quick-Info-Text Weiter.

   Sie gelangen nun in das Pflegebild für elementare Suchhilfen.

4. Geben Sie im Feld Kurzbeschreibung einen erläuternden Kurztext ein.

   Sie können später über diesen Kurztext nach der Suchhilfe suchen.

5. Geben Sie auf der Registerkarte Definition die Selektionsmethode der Suchhilfe an.

   Sie können hier den Namen einer Tabelle oder eines Views (Datenbank-View, Projektions-View oder Help-View) eingeben. Falls Sie eine Tabelle eingeben, zu der eine Texttabelle vorhanden ist, wird der Name der Texttabelle automatisch im entsprechenden Feld eingetragen.

6. Wählen Sie im Bereich Suchhilfeparameter Felder der Selektionsmethode als Parameter. Benutzen Sie dazu die F4-Eingabehilfe. Wählen Sie hier die Felder, die im Dialogfenster zur Werteselektion oder in der Trefferliste verwendet werden müssen.

   Ist die Selektionsmethode eine Tabelle, zu der eine Texttabelle existiert, so werden bei der Eingabehilfe sowohl die Felder der Tabelle als auch die Felder der Texttabelle angeboten.

   Das Datenelement des Parameters wird automatisch aus der Selektionsmethode übernommen. Das Datenelement definiert die Ausgabeeigenschaften und die F1-Hilfe des Parameters auf der Trefferliste und auf dem Dialogfenster zur Werteselektion.

   Sie können dem Parameter ein anderes Datenelement zuordnen. Führen Sie dazu die folgenden Schritte durch:

   1. Wählen Sie auf dem Register Definition das Kennzeichen in der Spalte Modifiziert.

      Das Feld Datenelement wird nun eingabebereit.

   2. Wählen Sie ein Datenelement über die Eingabehilfe (F4-Hilfe) aus.
      Achtung

      Es können nur Datenelemente zugeordnet werden, die in Datentyp, Länge und Anzahl der Dezimalstellen mit dem bisherigen Datenelement übereinstimmen.

      Wenn Sie dem Parameter ein neues Datenelement zuordnen, entfernt das System die Verknüpfung zwischen dem Datenelement des Suchhilfeparameters und dem gleichnamigen Datenelement des Selektionsmethodenfelds. Wenn Sie die Markierung des Kennzeichens in der Spalte Modifiziert entfernen, wird wieder das Datenelement des zugeordneten Tabellenfelds verwendet.

7. Definieren Sie die Eigenschaften der Suchhilfeparameter.
   1. Markieren Sie das Kennzeichen IMP, falls es sich um einen Import-Parameter handelt. Markieren Sie das Kennzeichen EXP, falls es sich um einen Export-Parameter handelt.
   2. Definieren Sie ggf. den Dialog für die Eingabehilfe über die Felder LPos, SPos und SAnz.
      1. Tragen Sie in LPos die Position des Parameters auf der Trefferliste ein. Falls Sie hier nichts bzw. den Wert 0 eintragen, wird der Parameter nicht auf der Trefferliste angezeigt.

         Die folgende Abbildung zeigt den Funktionsumfang von Feld LPos.

   

   1. Tragen Sie in SPos die Position des Parameters auf dem Dialogfenster zur Werteselektion ein. Falls Sie hier nichts bzw. den Wert 0 eintragen, wird der Parameter nicht auf dem Dialogfenster zur Werteselektion angezeigt.

      Die folgende Abbildung zeigt den Funktionsumfang von Feld SPos.

   

   1. Markieren Sie das Kennzeichen SDis, falls der Parameter auf dem Dialogfenster zur Werteselektion ein reines Anzeigefeld sein muss. Der Benutzer wird darüber informiert, dass der Inhalt des Parameters den Wert einschränkt, er kann diese Einschränkung aber nicht ändern. Dies ist z.B. sinnvoll, wenn der Parameter ein Import-Parameter ist oder einen Defaultwert besitzt.
   2. Ordnen Sie dem Parameter im Feld Defaultwert einen Defaultwert zu.
8. Wählen Sie den Dialogtyp der Suchhilfe.

   Der Dialogtyp steuert die Anzeige der Trefferliste bei der Eingabehilfe.

9. Wählen Sie  mit der Quick-Info Sichern.

   Es erscheint ein Dialogfenster, in dem Sie der Suchhilfe ein Paket zuordnen müssen. Sie können diese Entwicklungsklasse bei Bedarf später mit Springen → Objektkatalogeintrag ändern.

10. Wählen Sie  mit dem Quick-Info-Text Aktivieren.
    Achtung

    Vergessen Sie nicht, die Suchhilfe mit einem Dynpro-Feld zu verbinden ! Die Suchhilfeanbindung gehört nicht zur Definition der Suchhilfe, sondern zur Definition des Objekts, an das die Suchhilfe angebunden wird.

Die Suchhilfe wird aktiviert. Informationen zum Ablauf der Aktivierung können Sie dem Aktivierungsprotokoll entnehmen, das Sie über Hilfsmittel → Aktivierungsprotokoll anzeigen lassen können. Falls bei der Aktivierung der Sammelsuchhilfe Fehler auftreten, wird das Aktivierungsprotokoll automatisch angezeigt.

Zusätzliche Optionen

• Kurzanwahl zuordnen:

  Falls die Suchhilfe über eine Kurzanwahl angesprochen werden soll, müssen Sie ein einstelliges Kürzel im Feld Kurzanwahl eintragen. Alle in einer Sammelsuchhilfe enthaltenen elementaren Suchhilfen müssen sich bzgl. ihrer Kurzanwahl unterscheiden.

• Suchhilfe-Exit zuordnen:

  In Ausnahmefällen kann es notwendig sein, den durch die Suchhilfe vorgegebenen Standardablauf über ein Suchhilfe-Exit zu verändern. Tragen Sie in diesem Fall den Namen des Suchhilfe-Exits im entsprechenden Feld ein.

• Suchhilfe testen:

  Um den Ablauf einer von der elementaren Suchhilfe definierten Eingabehilfe zu testen, wählen Sie  mit dem Quick-Info-Text Testen. Es erscheint ein Dialogfenster, in dem Sie das Verhalten der Suchhilfe unter verschiedenen Bedingungen simulieren können. Informationen über die auf diesem Fenster zur Verfügung stehenden Möglichkeiten können Sie über  erhalten.

Siehe auch:

Struktur einer elementaren Suchhilfe