Service-Erweiterungen pflegen

Mit dieser Aktivität ändern Sie die Konfiguration bereits vorhandener Service-API-Erweiterungen und legen neue Erweiterungskonfigurationen an (siehe Service-Erweiterung).

Bei dieser Aktivität können Sie auch Folgendes durchführen:

erweiterte Servicemethoden abrufen, um sehen zu können, welche Funktionsbereiche angepasst wurden
die Ein- oder Ausgabe einer Service-API-Erweiterungsmethode anzeigen

Weitere Informationen finden Sie in den SAP-ME-API-Modulen, -Diensten und Methoden, siehe SAP-ME-Javadoc unter Anfang des Navigationspfads http://service.sap.com/instguides Navigationsschritt SAP Business Suite Applications SAP Manufacturing SAP Manufacturing Execution Ende des Navigationspfads .

Siehe auch: Beispiel: Service-API-Erweiterungen schreiben, konfigurieren und ausführen.

Felder

In der folgenden Tabelle sind die Felder aufgeführt, die einer Erläuterung bedürfen:

Suchbereich
Feld	Beschreibung
Modul	filtert Servicemethoden nach SAP-ME-API-Modulname
Service	filtert Servicemethoden nach Servicename
Methode	filtert Servicemethoden nach Servicemethodenname
Nur erweiterte	Ist dies markiert, werden nur erweiterte Servicemethoden im Suchergebnis angezeigt.

Neue Erweiterung
Feld	Beschreibung
Ausführungspunkt	der Ausführungsort einer Service-API-Erweiterung im Verhältnis zu einer Servicemethode PRE: Führt diese Service-Erweiterung vor der Servicemethode aus. POST: Führt diese Service-Erweiterung nach der Servicemethode aus. EXCEPTION: Führt diese Service-Erweiterung als Reaktion auf Fehler aus, die von der Ausführung der Servicemethode oder von anderen Service-Erweiterungen an den PRE- oder POST-Ausführungspunkten ausgelöst wurden. Hinweis Sie können den Ausführungspunkt nicht mehr ändern, nachdem Sie die Erweiterung angelegt haben. Ende des Hinweises
Erweiterungsname	Name der Service-API-Erweiterung Hinweis Dieser Wert muss für jede Erweiterung, die dieser Servicemethode angehängt sind, eindeutig sein. Ende des Hinweises
Erweiterungsaktivität	der Aktivitätstyp Service, der diese Servicemethode erweitert (siehe Aktivitätstypen)

Registerkarte Allgemein
Feld	Beschreibung
Asynchron	Ist dies markiert, wird diese Service-Erweiterung asynchron ausgeführt. Hinweis Dieses Ankreuzfeld ist ausgegraut, wenn diese Service-Erweiterung die asynchrone Ausführung nicht unterstützt. Ende des Hinweises
Aktiviert	Ist dies markiert, kann diese Service-Erweiterung ausgeführt werden
Sequenz	die Ausführungssequenz dieser Service-Erweiterung im Verhältnis zu anderen, die demselben Ausführungspunkt zugeordnet sind Hinweis Sind zwei oder mehr Service-Erweiterungen derselben Sequenz zugeordnet, werden diese in beliebiger Reihenfolge innerhalb der Sequenz ausgeführt. Ende des Hinweises

Vorgehensweise

Servicemethoden suchen

Geben Sie Suchkriterien ein, um eine Servicemethode abzurufen.
Hinweis
Sie können die folgenden Platzhalter verwenden:
- * (Asterisk): ersetzt eine beliebige Anzahl an Zeichen
- ? (Fragezeichen): ersetzt ein einziges Zeichen
Ende des Hinweises
Markieren Sie bei Bedarf das Ankreuzfeld Nur erweiterte, um die Suchergebnisse auf die erweiterten Servicemethoden zu beschränken.
Wählen Sie Suchen.

Eine neue Konfiguration für eine Service-Erweiterung anlegen

Konfigurationen für Service-Erweiterungen können folgendermaßen angelegt werden:

Die Erweiterung wird vom Entwickler definiert und durch das Laden der Initialdaten in Produktionsstätte pflegen geladen.
Verwenden der Funktion Neue Erweiterung

Erweiterungsentwickler sind häufig am besten mit den Customizing-Anforderungen vertraut. Daher müssen sie die Aktivitäts- und Erweiterungskonfiguration mittels Definitionen für die Erstdatenübernahme bereitstellen.

Sie können eine neue Erweiterungskonfiguration mit Erweiterungsaktivitäten anlegen, die für die allgemeine Verwendung vorgesehen sind. Ein Entwickler kann beispielsweise eine Erweiterungsaktivität anlegen, die zu Debugging-Zwecken Servicemethodeneingaben in das Serviceprotokoll schreibt.

Um eine neue Erweiterungskonfiguration anzulegen, gehen Sie folgendermaßen vor:

Rufen Sie die Servicemethode ab, die sie erweitern möchten.
Wählen Sie die Servicemethode in der Suchergebnistabelle aus.
Wählen Sie Neue Erweiterung.
Wählen Sie aus der Ausführungspunkt-Auswahlliste einen Ausführungspunkt für die Servicemethode aus.

Hinweis
Sie können den Ausführungspunkt nicht mehr ändern, nachdem Sie die Erweiterung angelegt haben.

Ende des Hinweises
Geben Sie in das Feld Erweiterungsname einen Namen für die neue Erweiterung ein.
Geben Sie in das Feld Erweiterungsaktivität einen Namen für die Service-Erweiterungsaktivität ein.
Sichern Sie Ihre Eingaben.

Die neue Konfiguration der Service-Erweiterung wird zur weiteren Bearbeitung im unteren Bereich angezeigt.

Hinweis
Die Service-Erweiterung wird ausschließlich für die aktuelle Produktionsstätte angelegt.

Ende des Hinweises
Konfigurieren Sie die Optionen und Filter der Service-Erweiterung.

Optionen der Service-Erweiterung konfigurieren

Während die auf den Registerkarten Allgemein und Filter angezeigten Konfigurationseinstellungen von allen Service-Erweiterungen verwendet werden, können manche Erweiterungen zusätzliche zweckspezifische Einstellungen unterstützen. Zum Beispiel unterstützt die Aktivität HTTP_TRANSPORTER die Option HTTP_DESTINATION_NAME, die den Namen der HTTP-Destination angibt, der verwendet wird, um mit einem externen System zu kommunizieren (siehe HTTP-Transporter).

Die von CORE-SAP-ME bereitgestellten Service-API-Erweiterungsaktivitäten verfügen über eine Anwendungshilfe, die den Zweck der Optionsfelder beschreibt. Verwenden Sie die Anwendungshilfe beim Konfigurieren der Optionsfelder.

Hinweis Hinweis

Die Anwendungshilfe ist für Service-Erweiterungsaktivitäten von Fremdanbietern nicht verfügbar. In diesem Fall können Sie den Anbieter der Erweiterung kontaktieren und Informationen zur Konfiguration der Optionsfelder einholen.

Ende des Hinweises

Außerdem können Sie Optionswerte in der Aktivitätsdefinition der Service-Erweiterung mit Aktivitätsregeln unter Aktivität pflegen einrichten. Dies ist empfehlenswert, wenn Sie dieselbe Optionseinstellung für mehrere Service-Erweiterungskonfigurationen verwenden möchten (ansonsten müssten Sie die Einrichtung für jede Service-Erweiterungskonfiguration wiederholen).

Um eine Erweiterungsoption mit einer Aktivitätsregel zu konfigurieren, geben Sie den Namen der Option für die Aktivitätsregel vor. Ist für die Erweiterungsoption kein Wert gesetzt, werden die Aktivitätsregeleinstellungen verwendet. Wird die Option sowohl als Aktivitätsregel als auch als Erweiterungsoption konfiguriert, übersteuert der Wert der Erweiterungsoption die Aktivitätsregeleinstellung.

Hinweis Hinweis

Erweiterungsoptionstypen wie Ankreuzfelder und Auswahllisten erben keine Aktivitätsregeleinstellungen, da für diese Typen immer ein Wert in der Erweiterungsoption definiert ist.

Ende des Hinweises

Filter der Service-Erweiterung konfigurieren

In vielen Customizing-Szenarios ist es notwendig, die Ausführung einer Service-Erweiterung anhand der für die Service-Methode bereitgestellten Werte zu beschränken. Filter ermöglichen es Ihnen zu steuern, dass die Erweiterung nur dann ausgeführt wird, wenn die Eingabewerte der Servicemethode mit den Filterkriterien übereinstimmen.

Wird beispielsweise eine Service-Erweiterung an die Service-Methode sfcStart angehängt, wird die Erweiterung unabhängig davon ausgeführt, ob die Methodeneingabewerte Benutzer, PSN, Vorgang, Arbeitsplanschritt oder Material lauten.

Filter werden nach den folgenden Regeln bewertet:

Wird ein Filterkriterium leer gelassen, wird es bei der Bewertung nicht berücksichtigt.
Entspricht jeder ausgefüllte Filterwert dem an die Servicemethode gelieferten Feldwert, so wird der Filter mit 'wahr' bewertet (die Auswertung erfolgt mit logischem AND).
Wurde mehr als ein Filter definiert, muss nur ein Filter mit 'wahr' bewertet werden, damit die Ausführung stattfindet (die Auswertung aller Filter erfolgt mit logischem OR).

Hinweis Hinweis

Sie können mehrere Filter verwenden, um eine logische OR-Bewertung für dasselbe Eingabefeld zu erzwingen.

Ende des Hinweises

Gehen Sie folgendermaßen vor, um einen oder mehrere Filter zu konfigurieren:

Wählen Sie auf der Registerkarte Filter Neuer Filter.
Geben Sie einen Namen für den Filter ein, und sichern Sie den Eintrag.
Wählen Sie Neue Filterfelder.
Alle für den ausgewählten Ausführungspunkt verfügbaren Filterfelder werden angezeigt.
Stellen Sie Werte für die Filterkriterien bereit, die Sie bei der Filterbewertung einbeziehen möchten.
Sichern Sie Ihre Eingaben.

Ein- und Ausgabe der Servicemethode anzeigen

Gehen Sie folgendermaßen vor, um die gesamten Ein- und Ausgaben der Servicemethode als XML anzuzeigen:

Rufen Sie die Servicemethode ab.
Wählen Sie die Servicemethode in der Suchergebnistabelle aus.
Wählen Sie Eingabe/Ausgabe anzeigen.