Gestion des extensions de service

Vous utilisez cette activité pour modifier la configuration des extensions API de service existantes et pour créer de nouvelles configurations d'extensions (voir Extension de service).

Elle vous permet également d'effectuer les opérations suivantes :

Récupérer des méthodes de service étendues pour afficher quels domaines fonctionnels ont été personnalisés.
Afficher l'entrée ou la sortie d'une méthode d'extension API de service.

Pour plus d'informations sur les modules, services et méthodes API SAP ME, voir Javadoc SAP ME à l'adresse Début du chemin de navigation http://service.sap.com/instguides Etape de navigation Applications SAP Business Suite SAP Manufacturing SAP Manufacturing Execution Fin du chemin de navigation .

Voir également : Exemple : Écriture, configuration et exécution d'une extension de service API.

Zones

Les tableaux suivants décrivent les zones nécessitant une explication :

Panneau de recherche
Zone	Description
Module	Filtre les méthodes de service par nom de module API SAP ME.
Service	Filtre les méthodes de service par nom de service.
Méthode	Filtre les méthodes de service par nom de méthode de service.
Étendue uniquement	Si cette option est sélectionnée, seules les méthodes de service étendues apparaissent dans les résultats.

Nouvelle extension
Zone	Description
Point d'exécution	Position d'exécution d'une extension API de service relative à une méthode de service. PRE : exécute cette extension de service avant que la méthode de service ne soit exécutée. POST : exécute cette extension de service après que la méthode de service a été exécutée. EXCEPTION : exécute l'extension de service en réponse aux erreurs issues de la méthode de service ou d'une autre extension de service exécutée aux points d'exécution PRE ou POST. Note Vous ne pouvez pas modifier le point d'exécution après que l'extension a été créée. Fin de la note.
Nom de l'extension	Nom de l'extension API de service. Note Cette valeur doit être unique parmi toutes les extensions affectées à cette méthode de service. Fin de la note.
Activité d'extension	Activité du type de Service qui étend cette méthode de service (voir Types d'activités).

Onglet Principal
Zone	Description
Asynchrone	Si cette option est sélectionnée, cette extension de service est exécutée de manière asynchrone. Note Cette case est désactivée si l'extension de service ne prend pas en charge l'exécution asynchrone. Fin de la note.
Activé	Si cette option est sélectionnée, l'extension de service peut être exécutée.
Séquence	L'ordre d'exécution de cette extension de service relatif à d'autres extensions de service associée au même point d'exécution. Note Si deux ou plusieurs extensions ont la même séquence, elles sont exécutées dans n'importe-quel ordre dans la séquence. Fin de la note.

Procédure

Recherche de méthodes de service

Entrez des critères de recherche pour récupérer une méthode de service.
Note
Vous pouvez utiliser les caractères génériques suivants :
- * (astérisque) : correspond à tous les caractères.
- ? (point d'interrogation) : correspond à un seul caractère.
Fin de la note.
Si nécessaire, cochez la case Étendue uniquement pour limiter les résultats de la recherche aux méthodes de services étendues.
Sélectionnez Rechercher.

Création d'une nouvelle configuration d'extension de service

La configuration d'extension de service peut être créée de l'une des façons suivantes :

le développeur la définit et la charge grâce au chargement des données initial dans la Gestion des sites ;
à l'aide de la fonction Nouvelle extension.

Dans de nombreux cas, les développeurs d'extension ont une compréhension très complète des conditions requises de personnalisation ; le développeur doit donc déterminer la configuration de l'activité et de l'extension à l'aide de définitions de reprise des données initiales.

Vous pouvez créer une nouvelle configuration d'extension à l'aide d'activités d'extension conçues pour une utilisation générale. Par exemple, un développeur peut créer une activité d'extension qui écrit une entrée de méthode de service dans le journal du serveur à des fins de débogage.

Pour créer une nouvelle extension de configuration, procédez comme suit :

Récupérez la méthode de service que vous souhaitez étendre.
Sélectionnez la méthode de service dans la table des résultats de recherche.
Sélectionnez Nouvelle extension.
Sélectionnez une méthode d'exécution de service à partir de la liste déroulante Point d'exécution.

Note
Vous ne pouvez pas modifier le point d'exécution après que l'extension a été créée.

Fin de la note.
Saisissez un nom pour la nouvelle extension dans la zone Nom de l'extension.
Saisissez un nom pour l'activité d'extension de service dans la zone Activité d'extension.
Sauvegardez vos entrées.

La nouvelle configuration d'extension de service s'affiche pour une modification supplémentaire dans le panneau inférieur.

Note
L'extension de service est créée uniquement dans le site actuel.

Fin de la note.
Configurez les options et les filtres de l'extension de service.

Configuration des options d'extension de service

Alors que les options de configuration affichées dans les pages à onglet Principal et Filtre sont communes à toutes les extensions de service, certaines extensions peuvent prendre en charge des options supplémentaires spécifiques à son objectif. Par exemple, l'activité HTTP_TRANSPORTER prend en charge une option appelée HTTP_DESTINATION_NAME qui spécifie le nom de la destination HTTP utilisée pour communiquer avec un système externe (voir Transporteur HTTP).

Les activités d'extension d'API de service fournies avec SAP ME incluent l'aide à l'application qui décrit l'objectif de ces zones d'options. Vous utilisez l'aide à l'application pour déterminer comment configurer chaque zone d'option.

Note Note

L'aide à l'application n'est pas fournie pour les activités d'extension de service de tiers. Contactez le fournisseur de l'extension pour comprendre comment configurer les zones d'options.

Fin de la note.

Vous pouvez également définir les valeurs d'options dans la définition de l'activité d'extension de service au moyen des règles d'activité dans la Gestion des activités. Ceci est utile lorsque vous souhaitez définir le même paramètre d'option pour plus d'une configuration d'extension de service (sinon vous devriez répéter le paramètre dans chaque configuration d'extension de service).

Pour configurer l'option d'extension en utilisant une règle d'activité, vous devez spécifier le nom de l'option pour la règle d'activité. Lorsqu'aucune valeur n'est définie pour l'option d'extension, le paramétrage de la règle d'activité est alors utilisé. Si l'option est configurée à la fois comme règle d'activité et comme option d'extension, la valeur d'option d'extension substitue alors le paramétrage de la règle d'extension.

Note Note

Les paramétrages des règles d'activité n'héritent pas des types d'options d'extension comme les cases à cocher et les listes déroulantes car une règle est toujours définie dans l'option d'extension.

Fin de la note.

Configuration des filtres d'extension de service

Dans de nombreux scénarios de personnalisation, il est nécessaire de limiter l'exécution à une extension de service en fonction des valeurs fournies pour déterminer la méthode de service. Les filtres vous permettent de contrôler quand l'extension est exécutée en faisant correspondre les valeurs d'entrée de la méthode de service et les critères des filtres.

Par exemple, lorsqu'une extension de service est affectée à la méthode de service sfcStart, elle est exécutée indépendamment des valeurs d'entrée de la méthode comme l'utilisateur, le SFC, l'opération, l'étape de gamme ou l'article.

Les filtres sont évalués en fonction des règles suivantes :

si une zone de critère est vide il n'est pas inclus dans l'évaluation ;
si une valeur de critère de filtre qui n'est pas vide correspond à la valeur de zone fournie à la méthode de service, le filtre évalue alors la valeur vraie (l'évaluation est logique AND) ;
si plus d'un filtre est défini, alors un seul filtre doit évaluer la valeur vraie pour l'exécution afin de continuer (l'évaluation de tous les filtres est logique OR).

Note Note

Vous pouvez utiliser plusieurs filtres pour forcer l'évaluation OR logique de la même zone de saisie.

Fin de la note.

Pour configurer un ou plusieurs filtres, procédez de la manière suivante :

Dans la page à onglet Filtres, sélectionnez Nouveau filtre.
Saisissez le nom du filtre et sauvegardez vos entrées.
Sélectionnez Nouvelles zones de filtre.
Toutes les zones de filtre disponibles pour le point d'exécution sélectionné apparaissent.
Déterminez les valeurs pour les critères de filtre que vous souhaitez inclure dans l'évaluation du filtre.
Sauvegardez vos entrées.

Affichage de l'entrée/sortie de la méthode de service

Pour afficher l'entrée et la sortie complètes de la méthode de service au format XML, procédez de la manière suivante :

Récupérez la méthode de service.
Sélectionnez la méthode de service dans la table des résultats de recherche.
Sélectionnez Afficher entrée/sortie.