Opérations et instructions des objets métier BAPI

Instructions et opérations prises en charge par les objets métier BAPI. L'opération d'un objet métier BAPI indique l'appel BAPI à exécuter dans le système SAP pour cet objet. La méthode BAPI détermine l'opération qui lui est associée. L'instruction d'un objet métier BAPI indique l'état de l'objet.

Opérations prises en charge

Les opérations d'un objet métier sont appelées par le composant client qui passe les appels vers SAP via l'adaptateur.Les interfaces API JCo SAP permettent d'effectuer l'appel du système SAP.

Le tableau ci-dessous définit les opérations prises en charge par l'adaptateur.
Remarque : Les définitions répertoriées dans la table correspondent aux utilisations attendues des opérations. L'action entreprise dans l'application SAP est basée sur la signification de la BAPI elle-même.
Tableau 1. Opérations prises en charge : objets métier BAPI
Opération Définition
After-Image Create Crée une entité dans SAP qui correspond aux données et à la structure de l'objet métier entrant. L'objet métier renvoyé par cette opération reflète l'entité nouvellement créée dans SAP.
After-Image Update with Delete Forme spéciale de l'opération UpdateWithDelete qui offre de meilleures performances. Elle requiert toujours un ChangeSummary, qui doit inclure des informations sur les créations et suppressions effectuées au niveau de l'objet métier. Cela permet à l'adaptateur d'effectuer des opérations sans subir le coût de l'extraction des entités existantes dans SAP et de procéder à des comparaisons, puisque l'interface ChangeSummary indique ce qu'il faut faire. Si le ChangeSummary est vide, l'adaptateur n'entreprend aucune action relative à la requête.
Retrieve Reconstruit la hiérarchie d'objet métier complète. L'adaptateur vérifie que l'objet métier hiérarchique renvoyé correspond exactement à l'état de la base de données de l'entité de l'application. Des valeurs non clés peuvent être utilisées comme critères.

Accepte une image postérieure ou un objet métier. Dans les deux cas, la comparaison se fait uniquement par égalité.

L'objet métier de la requête peut contenir :

  • Un objet métier de niveau supérieur mais pas d'objet enfant, même si la définition de l'objet métier comprend des enfants
  • Un objet métier contenant l'objet métier de niveau supérieur et certain de ces enfants définis
  • Un objet métier hiérarchique complet contenant tous les objets métier enfant

L'opération Retrieve est censée renvoyer un objet métier simple unique répondant aux critères définis par l'utilisateur. L'exigence d'exécution de l'opération Retrieve dépend totalement de l'objet BAPI. Tout ce que la BAPI juge “obligatoire” permet à l'opération Retrieve d'aboutir.

After-Image Delete Supprime une entité existante dans SAP, avec les éventuelles entités enfant qu'elle contient. Notez que le concept de SAP est basé sur la suppression logique, c'est-à-dire que l'enregistrement est marqué comme supprimé mais l'entité existe toujours. Cette approche est utilisée dans certains cas pour assurer l'intégrité de la base de données lorsqu'il est fait référence à l'entité “supprimée” dans d'autres entités. Le comportement After-Image Delete dépend donc de l'appel BAPI.

Pour une opération non prise en charge ou ne correspondant pas à l'instruction du graphique métier, l'adaptateur consigne l'erreur appropriée et génère une exception ResourceException.

Instructions prises en charge

Le tableau ci-après récapitule les instructions prises en charge par l'adaptateur pour les objets métier BAPI.

Tableau 2. Instructions prises en charge : objets métier BAPI
Instruction Définition
Create L'objet métier de niveau supérieur et tous les enfants qu'il contient ont été créés, s'il s'agit d'un événement entrant, ou doit être créé dans l'interface SAP, s'il s'agit d'une requête sortante.
UpdateWithDelete L'objet métier de niveau supérieur a été ou doit être modifié ; cette action peut également inclure l'ajout ou la suppression d'enfants.
Delete L'objet métier de niveau supérieur, ainsi que tout enfant qu'il contient, ont été, ou doivent être, créés.

Pour les instructions non prises en charge, l'adaptateur génère une erreur ResourceException.


Conditions d'utilisation |


(c) Copyright IBM Corporation 2005, 2006.
Ce centre de documentation repose sur la technologie Eclipse (http://www.eclipse.org)