Opérations sur des tables d’interface et des vues d’interface
L’adaptateur Microsoft BizTalk pour Oracle E-Business Suite expose un ensemble d’opérations standard (Sélectionner, Insérer, Mettre à jour et Supprimer) pour chaque table d’interface, et l’opération Sélectionner pour chaque affichage d’interface dans Oracle E-Business Suite. À l’aide de ces opérations, vous pouvez exécuter les instructions SELECT, INSERT, UPDATE et DELETE qualifiées par une clause WHERE sur la table d’interface cible, et l’instruction SELECT qualifiée par une clause WHERE dans la vue de l’interface cible. Ces opérations sont également appelées opérations DML (Data Manipulation Language).
Important
Avant de pouvoir effectuer des opérations sur les tables d’interface et les vues d’interface, vous devez définir le contexte des applications pour ces artefacts dans l’adaptateur Oracle E-Business. Cela est dû au fait que la définition du contexte des applications facilite les transactions sécurisées dans Oracle E-Business Suite en définissant les préférences de l’utilisateur (telles que les paramètres de responsabilité, de organization et de langue) et le contrôle d’accès pour un artefact. Pour plus d’informations sur le contexte des applications et la façon de le définir, consultez Définir le contexte d’application.
Opérations DML prises en charge
Le tableau suivant présente les opérations DML que l’adaptateur Oracle E-Business prend en charge :
| Opération | Description |
|---|---|
| Sélectionnez | Effectue une opération de sélection sur la table d’interface ou la vue d’interface cible en fonction d’une liste fournie de noms de colonnes et d’une chaîne de filtre qui spécifie une clause SQL WHERE. La valeur de retour d’une opération Select est un jeu de résultats fortement typé qui contient les colonnes et lignes spécifiées. |
| Insérer | Effectue une opération d’insertion sur la table d’interface cible. L’opération Insert prend en charge l’insertion de plusieurs enregistrements dans la table d’interface cible en fonction d’un jeu d’enregistrements fourni. La valeur de retour d’une opération Insert est le nombre de lignes insérées. InlineValue Pour tous les enregistrements de données simples dans une opération Insert, vous pouvez choisir de remplacer la valeur d’un enregistrement en spécifiant une valeur pour un attribut facultatif appelé InlineValue. L’attribut InlineValue peut être utilisé pour insérer des valeurs calculées dans des tables d’interface, telles que le remplissage de la colonne clé primaire à l’aide d’une séquence ou l’insertion de date système (à l’aide de SYSDATE) dans une colonne de date. Par exemple, dans l’instruction INSERT suivante : <Insert xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/InterfaceTables/AR/AR_ARCHIVE_PURGE_INTERIM"> <RECORDSET> <InsertRecord xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/TableViewRecord/AR/AR_ARCHIVE_PURGE_INTERIM"> <TRNS_DATE InlineValue="sysdate">2008-06-21T15:52:19</TRNS_DATE> <EMPNAME>John</EMPNAME> </InsertRecord> </RECORDSET> </Insert>Même si « 2008-06-21T15 :52 :19 » est spécifié comme valeur pour TRNS_DATE, la valeur de l’attribut InlineValue , « SYSDATE », (date système) est insérée dans la table d’interface cible. Lors de l’utilisation de l’attribut InlineValue : - Évitez d’utiliser des valeurs constantes pour l’attribut InlineValue. Par exemple, dans l’instruction INSERT, si vous spécifiez <EMPNAME InlineValue="John"/> , cela génère une erreur. Cela est dû au fait que la valeur de l’attribut InlineValue est transmise telle quelle à Oracle, et dans ce cas, John est passé à Oracle E-Business Suite, qui n’est pas la valeur attendue (la valeur attendue est « John »). Vous devez utiliser des guillemets simples autour du nom de l’employé. Par exemple : <EMPNAME InlineValue="’John’"/>.- Si vous souhaitez utiliser une requête select pour l’attribut InlineValue, vous devez placer l’instruction SELECT entre parenthèses et vous assurer que la requête select n’extrait qu’un seul enregistrement. Par exemple : <EMPNAME InlineValue="(SELECT NAME FROM MS_SAMPLE_EMPLOYEES WHERE ID=123)"/>.Note: Si un élément est marqué comme NOT NULL dans Oracle E-Business Suite, vous devez spécifier une valeur pour cet élément même si vous avez spécifié une valeur inline. Si vous ne le faites pas, la validation du schéma échoue. |
| Update | Effectue une opération de mise à jour sur la table d’interface cible. Les enregistrements à mettre à jour sont spécifiés par une chaîne de filtre qui spécifie une clause SQL WHERE. Les valeurs de la mise à jour sont spécifiées dans un enregistrement de modèle. La valeur de retour d’une opération de mise à jour est le nombre de lignes mises à jour. |
| Supprimer | Effectue une opération Delete sur la table d’interface cible basée sur une clause SQL WHERE spécifiée dans une chaîne de filtre. La valeur de retour d’une opération Delete est le nombre de lignes supprimées. |
Détails importants
L’adaptateur Oracle E-Business affiche le même ensemble d’opérations standard (Sélectionner, Insérer, Mettre à jour et Supprimer) pour chaque table, et l’opération Sélectionner pour chaque vue dans la base de données Oracle sous-jacente. Les opérations DML ci-dessus sont également valides pour les tables et vues de base de données Oracle sous-jacentes.
- Il n’est pas nécessaire de définir le contexte des applications pour effectuer des opérations sur les tables et les vues dans la base de données Oracle. Toutefois, pour les applications Oracle E-Business Suite personnalisées, les utilisateurs peuvent inscrire ou non les tables de base de données en tant que tables d’interface. Si une table de base de données n’est pas inscrite en tant que table d’interface, elle est disponible sous le sous-nœud Tables dans le nœud Vue basée sur les artefacts ou dans le nœud Vue basée sur le schéma au moment de la conception lors de l’utilisation du complément de service Consommer l’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Reference Service.
Ces tables sont associées à une application Oracle E-Business. Ainsi, pour toute opération sur ces tables, vous devez définir le contexte de l’application. Consultez Définir le contexte del’application entrer la description du lien ici.
- Il n’est pas nécessaire de définir le contexte des applications pour effectuer des opérations sur les tables et les vues dans la base de données Oracle. Toutefois, pour les applications Oracle E-Business Suite personnalisées, les utilisateurs peuvent inscrire ou non les tables de base de données en tant que tables d’interface. Si une table de base de données n’est pas inscrite en tant que table d’interface, elle est disponible sous le sous-nœud Tables dans le nœud Vue basée sur les artefacts ou dans le nœud Vue basée sur le schéma au moment de la conception lors de l’utilisation du complément de service Consommer l’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Reference Service.
Voir aussi
Quelles opérations peuvent être effectuées à l’aide de l’adaptateur ?