Show TOC

Documentation sur la procédureExemple : écriture, configuration et exécution d'une extension de service API.

Connaiss. requises

Vous avez des connaissances pratiques sur API SAP ME et l'atelier SAP MII.

Vous avez télédéchargé les exemples qui sont attachés à la note SAP 1908404Informations publiées sur le site SAP et importés SAPMEServiceExt/PreCreateStart_CreateSFC dans l'atelier SAP MII. Vous pouvez copier et utiliser cette extension comme modèle. Après la copie, les actions API publiques SAP ME de cet exemple doivent être configurées en fonction du site correct.

Procédure

Écriture d'une extension API de service

Vous écrivez des extensions API de service dans l'atelier SAP MII (voir Atelier SAP MII).

  1. Dans l'Atelier SAP MII, créez une nouvelle transaction.

  2. Ajoutez une propriété de transaction avec le nom input_xml et le type de données xml.

  3. Définissez la valeur de la propriété input_xml.

    La valeur est définie comme suit en fonction de l'OTD de la requête entrante pour la méthode de service à étendre. Pour plus d'informations, voir Javadoc SAP ME via Début du chemin de navigation http://service.sap.com/instguidesInformations publiées sur le site SAP Etape de navigation Applications SAP Business Suite Etape de navigation SAP Manufacturing Etape de navigation SAP Manufacturing Execution Fin du chemin de navigation.

    Exemple Exemple

    Module : com.sap.me.production

    Service : SfcStartService

    Méthode : createAndStart

    OTD : CreateAndStartSfcRequest

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>

    <createAndStartSfcRequest xmlns="http://www.sap.com/me/com.sap.me.production">

    <sfc>SFC1</sfc>

    <operationRef>OperationBO:SITE,O1,A</operationRef>

    <resourceRef>ResourceBO:SITE,DEFAULT</resourseRef>

    <confirmed>false</confirmed>

    <checkWorkCenterAssignment>true</checkWorkCenterAssignment>

    <workStationRef>WorkstationBO:SITE,O,OPERATION_DEF</workStationRef>

    </createAndStartSfcRequest>

    Fin de l'exemple.

  4. Ajoutez une propriété de transaction avec le nom output_xml et le type de données XML et sélectionnez la case à cocher Paramètre de sortie.

  5. Définissez la valeur de la propriété output_xml avec la même valeur que celle définie à l'étape 3 pour la propriété input_xml.

  6. Créez les actions dans la transaction SAP MII qui sont nécessaires pour réaliser la logique personnalisée. Vous pouvez référencer les valeurs entrantes, selon vos besoins, dans la propriété input_xml.

  7. Si la transaction SAP MII doit transférer des modifications de la requête entrante vers le service, créez une action qui modifie la propriété output_xml.

  8. Configurez la sécurité pour la transaction en affectant les Rôles avec autorisation de lecture appropriés. L'utilisateur SAP ME qui déclenche la transaction doit avoir un rôle (par exemple, SAP_XMII_USER) autorisé à lire la transaction SAP MII.

Configuration de l'extension API de service

Vous configurez les extensions API de service dans la Gestion des extensions de service (voir Gestion des extensions de service).

  1. Dans SAP ME, dans la Gestion des extensions de service, cherchez la méthode de service cible à étendre.

  2. Sélectionnez la méthode dans les résultats de recherche.

  3. Sélectionnez Nouvelle extension.

  4. Sélectionnez le point d'assemblage.

  5. Saisissez un nom pour l'extension.

  6. Entrez MII_TRANS_EXT comme activité de l'extension (voir Extension de la transaction SAP MII).

  7. Dans la page à onglet Options, entrez le dossier de transaction parent et le nom de la transaction créée plus haut dans la zone TRANSACTION_NAME.

  8. Saisissez tous les paramètres à transférer à la transaction SAP MII dans la zone PARAMETERS comme suit : article_nom=M1;article_version=A

    Chaque affectation de paramètre doit être séparée par un point-virgule.

  9. Sauvegardez vos entrées.

Exécution de l'extension API de service

Pour exécuter l'extension, lancez une activité ou un plug-in dans SAP ME qui déclenche la méthode d'extension de service.

Par exemple, ajoutez un enregistrement NC nommé createNC().

De plus, les services Web API publics peuvent être utilisés pour appeler les méthodes de service directement.

L'utilisateur SAP ME qui exécute la transaction doit avoir un rôle (par exemple, SAP_XMII_USER) autorisé à lire la transaction SAP MII.