6-2. Lieferantensuche hinzufügen

In diesem Schritt wird eine leistungsstarke Suchfunktion hinzugefügt, damit Formularbenutzer Lieferanten suchen können, bevor Sie eine Anforderung für einen neuen Lieferanten erstellen. Im Folgenden finden Sie die Übersicht des Prozesses:

1. Erstellen Sie eine Funktion in Winshuttle Query, mit der nach Lieferanten gesucht werden kann.
2. Erstellen Sie eine Lieferanten-Suchgruppe und zugehörige Felder im Formular.
3. Importieren Sie das Winshuttle Query Skript in Composer und konfigurieren Sie es.
4. Fügen Sie ein Kontrollkästchen-Element zum Composer Formular hinzu, das die Suche startet.
5. Konfigurieren Sie eine oder mehrere Regeln, die das Verhalten des Kontrollkästchens festlegen.

Auf dieser Seite

1. Das Lieferanten-Suchskript in Query erstellen
2. Den Lieferantensuche-Abschnitte des Formulars erstellen
3. Das Lieferanten-Suchskript importieren
4. Konfigurieren von Lieferanten-Suchfeldern
5. Einen Webdienst für die Suche hinzufügen
6. Eine Schaltfläche für die Lieferantensuche hinzufügen
7. Eine Regel hinzufügen, die Kleinbuchstaben in Großbuchstaben umwandelt
8. Die Suchfunktion testen

Zusätzliche Ressourcen

Query Hilfe

Das Lieferanten-Suchskript in Query erstellen

Zurück zum Anfang

	Erstellen Sie die Suchfunktion mithilfe von Winshuttle Query. Der Screenshot (rechts) zeigt die Ausgabefelder. Beachten Sie, dass das Kontrollkästchen der Auswahlspalte für Matchcodefelder aktiviert ist. Matchcode 1 (MCOD1) = Name Matchcode 3 (MCOD1) = Stadt
	Testen Sie die Suche in Winshuttle Query. Suchen Sie dort nach dem Begriff „Acme“ und die Abfrage gibt die Ergebnisse erfolgreich zurück.
	Legen Sie fest, dass die Felder in XML ausgegeben werden, und speichern Sie die Datei als Lieferantensuche.qsq.

Den Lieferantensuche-Abschnitte des Formulars erstellen

Zurück zum Anfang

In diesem Schritt wird eine Gruppe von Formularfeldern erstellt, um sie für die Informationen zur Lieferantensuche zu verwenden. Das Endergebnis sollte folgendermaßen aussehen:

Die Gruppe „Vorhandene Lieferanten suchen“ erstellen

1. Klicken Sie in Composer auf die Registerkarte Formular.

   

2. Klicken Sie auf die Registerkarte Urheber.

   

3. Klicken Sie im Menüband auf Neue Gruppe.

   

4. Klicken Sie im Bereich Eigenschaften auf Elemente.
5. Unter Grundlegende Elemente klicken Sie zwei Mal auf Textfeld, um 2 neue Textfelder zu erstellen.
6. Klicken Sie im Bereich Eigenschaften unter Containerelemente auf Wiederholte Tabelle.
7. Geben Sie im Dialogfeld Neue wiederholte Tabelle unter Spaltenanzahl 4 ein und klicken Sie dann auf OK.

   Die neu hinzugefügte Gruppe sollte nun folgendermaßen aussehen:

   

   In den verbleibenden Schritten wird die neue Gruppe formatiert und ihre Elemente werden umbenannt.

8. Klicken Sie auf Gruppenbezeichnung, anschließend auf den Platzhaltertext und ersetzen Sie ihn mit Vorhandene Lieferanten suchen.

   

   Optional: Heben Sie den Text Vorhandene Lieferanten suchen hervor, damit er besser sichtbar ist. Im Composer Menüband klicken Sie zwei Mal auf das Symbol () Schriftart vergrößern.

   

9. Klicken Sie unter Vorhandene Lieferanten suchen auf Bezeichnung (klicken zum Bearbeiten) und ersetzen Sie den Text mit Lieferantenname, wie unten dargestellt.

   

10. Klicken Sie unter Vorhandene Lieferanten suchen auf Bezeichnung (klicken zum Bearbeiten) und ersetzen Sie den Text mit Stadtname, wie unten dargestellt.

    

11. In der wiederholten Tabellen benennen Sie alle Kopfzeilen um, wie unten beschrieben:

    Kopfzeile 1: Anklicken und zu Lieferantenname umbenennen.

    Tipp: Sie können die Tabulatortaste drücken, um zur nächsten Kopfzeile zu wechseln und diese umzubenennen.

    Kopfzeile 2: Zu Stadt umbenennen.

    Kopfzeile 3: Zu Land umbenennen.

    Kopfzeile 4: Zu Kontonummer umbenennen.

    

    Im letzten Schritt wird der Abschnitt „Lieferantesuche“ über die Gruppe „Allgemeine Lieferanteninformationen“ verschoben.

12. Rechtsklicken Sie auf die Gruppe Vorhandene Lieferanten suchen und klicken Sie dann auf Nach oben verschieben. Wiederholen Sie diesen Schritt, bis sich die Gruppe „Vorhandene Lieferanten suchen“ genau unter der Gruppe „Anforderer-Informationen“ befindet.

Das Endergebnis sieht folgendermaßen aus:

Das Lieferanten-Suchskript importieren

Zurück zum Anfang

1. Klicken Sie in Composer auf die Registerkarte Lösung.

   

2. Rechtsklicken Sie im Bereich Lösung auf Query Skripte und klicken Sie anschließend auf Importieren.

   

3. Klicken Sie auf Datei auswählen und navigieren Sie dann zum Ordner mit der Datei Lieferantensuche.qsq.
4. Klicken Sie auf Öffnen und dann auf Weiter.
5. Klicken Sie im Dialogfeld Bestätigen auf Ja.
6. Im Bildschirm Feldzuordnung legen Sie die folgenden Eigenschaften fest (ändern Sie die Standardwerte für nicht aufgeführte Felder nicht):

   Beschreibung: Lieferantensuche Gruppenname: Suche Zuordnungsname: Lieferantensuche Verbindung: Verwenden Sie das angemeldete Windows-Konto.

7. Klicken Sie auf Generieren.
8. Es sollte ein Bildschirm „Feldzuordnung“ angezeigt werden, ähnlich dem Beispiel unten. Klicken Sie auf OK.

   Im Bildschirm „Feldzuordnungsparameter“ klicken Sie auf „Formularfelder generieren“ und anschließend auf OK.

9. Klicken Sie zum Abschließen auf OK.

Konfigurieren von Lieferanten-Suchfeldern

Zurück zum Anfang

Jetzt konfigurieren Sie die Bindung der Eingabe- und Ausgabefelder für die Funktion „Lieferantesuche“.

1. Klicken Sie auf die Registerkarte Formular.

   

2. In der Gruppe Vorhandene Lieferanten suchen klicken Sie auf das Feld Lieferantenname.
3. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LikeOP aus.

   

4. Klicken Sie in der Gruppe Vorhandene Lieferanten suchen auf das Feld Stadtname.
5. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LikeOP_1 aus.

   

   Jetzt werden die Felder der wiederholten Tabellen mit der Ausgabe verbunden, die von der Lieferantensuche-Abfrage generiert wurde.

6. Klicken Sie in der Gruppe Vorhandene Lieferanten suchen auf das Feld Lieferantenname.
7. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LFA1_Name_1 aus.

   

8. Klicken Sie in der Gruppe Vorhandene Lieferanten suchen auf das Feld Stadt.
9. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LFA1_City aus.

   

10. Klicken Sie in der Gruppe Vorhandene Lieferanten suchen auf das Feld Land.
11. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LFA1_Country_Key aus.

    

12. Klicken Sie in der Gruppe Vorhandene Lieferanten suchen auf das Feld Kontoname.
13. Klicken Sie im Bereich Eigenschaften neben Bindung auf den Pfeil und wählen Sie dann in der Liste LFA_Account_Number_of_Vendor_or_Creditor aus.

    

Einen Webdienst für die Suche hinzufügen

Zurück zum Anfang

Um die Funktion „Lieferantensuche“ im Formular zu aktivieren, muss ein Webdienst-Element hinzugefügt werden.

Dieser Webdienst ist eine Lieferantensuche-Abfrage, die in einem vorherigen Schritt in die Lösung importiert wurde. Nun muss ein Webdienst hinzugefügt werden und mit der Abfrage verknüpft werden. In einem späteren Schritt wird eine Schaltfläche erstellt, die diesen Webdienst aktiviert.

So fügen Sie den Webdienst hinzu und konfigurieren diesen:

1. Klicken Sie in Composer auf die Registerkarte Formular.

   

2. Klicken Sie im Bereich „Eigenschaften“ auf Elemente.

   

3. Klicken Sie auf Erweiterte Elemente und anschließend auf Webdienst.

   

4. Klicken Sie unter der Registerkarte „Ansicht“ auf das Element Webdienst.

   

5. In the Properties pane, set the following properties for the Web Service element:
   • Name: (Optional) Type a name for the service (such as SAPWebService-VendorLookup), or you can leave the default name.
   • Web Service: Click the arrow, and then select Vendor Lookup from the list.
   • Invoked by Rule: Check the box.

     

Eine Schaltfläche für die Lieferantensuche hinzufügen

Zurück zum Anfang

Nun wird eine Schaltfläche zum Formular hinzugefügt, die die Funktion „Lieferantensuche“ aufruft.

1. Klicken Sie auf die Registerkarte Formular.

   

2. Klicken Sie auf die Gruppe Vorhandene Lieferanten suchen.
3. Klicken Sie im Bereich „Eigenschaften“ auf Elemente.

   

4. Klicken Sie im Bereich Eigenschaften auf Grundlegende Elemente und anschließend auf Schaltfläche.

   

5. Klicken Sie im Formular-Arbeitsbereich in der Gruppe Vorhandene Lieferanten suchen auf die Schaltfläche, die Sie eben eingefügt haben.

   

6. Legen Sie im Bereich „Eigenschaften“ die folgenden Eigenschaften fest:
   • Name: Lieferantensuche
   • Bezeichnung: Lieferantensuche
   • Verhalten der Schaltfläche: Klicken Sie auf den Pfeil und wählen Sie dann in der Liste Benutzerdefiniert aus. (Dadurch wird die Option Regeln angezeigt, wie unten dargestellt.)

   

7. Klicken Sie neben Regeln auf die Optionen-Schaltfläche [...].
8. Klicken Sie auf Hinzufügen und dann auf Regel-Assistent.
9. Legen Sie im Bildschirm Regel erstellen folgende Eigenschaften fest:
   • Bezeichnung: Geben Sie einen Namen für die Regel ein, zum Beispiel WebdienstAufruf).
   • Typ: Klicken Sie auf den Pfeil und wählen Sie in der Liste Aktionen aus.
10. Klicken Sie auf Hinzufügen.

    

11. Legen Sie im Bildschirm „Regelaktion hinzufügen“ folgende Eigenschaften fest:
    • Aktion: Klicken Sie auf den Pfeil und wählen Sie dann in der Liste Webdienst ausführen aus.
    • Webdienststeuerung: Klicken Sie auf den Pfeil und wählen Sie dann in der Liste Lieferantensuche aus.

    Tipp: Der Name der Webdienststeuerung, die Sie hier auswählen, sollte der gleiche wie der sein, den Sie beim Importieren des Lieferanten-Suchskripts erstellt haben (für den Fall, dass es sich um einen anderen handelt als in dem Beispiel hier).

    

12. Klicken Sie auf OK.
13. Klicken sie im Bildschirm Regel erstellen auf OK.

    

14. Klicken Sie im Bildschirm Regel-Editor zum Abschließen auf OK.

Eine Regel hinzufügen, die Kleinbuchstaben in Großbuchstaben umwandelt

Zurück zum Anfang

Das Feld „Lieferantennamensuche“ muss für SAP großgeschrieben werden. Hierfür wird eine Regel/Formel hinzugefügt, um die Werte in Kleinbuchstaben zu Großbuchstaben zu ändern.

1. Klicken Sie auf die Registerkarte Formular.

   

2. Klicken Sie im Formular-Arbeitsbereich auf Lieferantenname.

   

3. Klicken Sie im Bereich Eigenschaften neben Regeln auf die Optionen-Schaltfläche [...].

   

4. Klicken Sie im Bildschirm Regel-Editor auf Hinzufügen und anschließend auf Regel-Assistent.
5. Legen Sie im Bildschirm Regel erstellen folgende Eigenschaften fest:
   • Bezeichnung: Geben Sie einen Namen für die Regel ein, zum Beispiel InGroßbuchstabenUmwandeln).
   • Typ: Klicken Sie auf den Pfeil und wählen Sie in der Liste Aktionen aus.
6. Klicken Sie auf Hinzufügen.

   

7. Legen Sie im Bildschirm „Regelaktion hinzufügen“ folgende Eigenschaften fest:
   • Aktion: Klicken Sie auf den Pfeil und wählen Sie dann in der Liste Einen Feldwert festlegen aus.
   • Feld: Klicken Sie auf den Pfeil und wählen Sie dann den Namen des Felds, das mit dem Feld „Lieferantensuche“ verbunden ist. In diesem Tutorial ist das Feld Lieferantensuche mit dem Feld LikeOP verbunden, das im Schritt Konfigurieren von Lieferanten-Suchfeldern konfiguriert wurde.

   

8. Klicken Sie auf die Schaltfläche Funktion F(x).
9. Klicken Sie im Bildschirm „Formel einfügen“ auf Funktion einfügen.

   

10. Klicken Sie im Bildschirm Funktion einfügen unter Funktionen auf den Pfeil und wählen Sie dann in der Liste toUpperCase aus.

    

11. Klicken Sie auf OK.
12. Klicken Sie im Bildschirm Formel einfügen auf die Formel und wählen Sie dann das Wort Text aus und löschen Sie es.

    

13. Mit dem Cursor zwischen () klicken Sie auf Feldwert einfügen.
14. Erweitern Sie im Bildschirm Feld auswählen die Suche, Lookup_Input und klicken Sie dann auf LFA1_SEARCH_TERM_FOR_MATCHCODE.

    In diesem Schritt wird eine Formel für das Feld „Lieferantensuche“ hinzugefügt, welche dann die Eingabe in Großbuchstaben umwandelt, nachdem die Daten vom Benutzer eingegeben wurden.

15. Das Endergebnis sollte folgendermaßen aussehen:

    

16. Klicken Sie auf OK.

    

17. Klicken Sie auf OK.

    

18. Klicken Sie auf OK.
19. Klicken Sie zum Abschließen auf OK.

Die Suchfunktion testen

Zurück zum Anfang

Sie sollten jetzt über eine vollständig funktionierende Suchfunktion verfügen, die im Formular integriert ist. Veröffentlichen Sie die Lösung in Ihrer Entwicklungsumgebung und testen Sie die Suchfunktion, um sicherzustellen, dass diese funktioniert.