Effectuer des opérations composites sur Oracle E-Business Suite

L’adaptateur Oracle E-Business permet aux clients d’adaptateur d’effectuer des opérations composites sur une base de données Oracle. Une opération composite peut inclure :

• Opérations d’insertion, de mise à jour, de suppression et de sélection sur les tables de base de données. Sélectionnez l’opération sur les vues de base de données.

• Opérations d’insertion, de mise à jour, de suppression et de sélection sur les tables d’interface. Sélectionnez l’opération sur les vues d’interface.

• Procédures et fonctions stockées, à l’intérieur ou à l’extérieur d’un package.

  Une seule opération composite peut avoir n’importe quel nombre de ces opérations, dans n’importe quel ordre. Par exemple, vous pouvez avoir deux insertions suivies d’une suppression et enfin d’une exécution de procédure stockée. En outre, vous pouvez avoir différentes opérations ciblant différentes tables ou vues de base de données. Pour plus d’informations sur la prise en charge des opérations composites par l’adaptateur, consultez Prise en charge des opérations composites. Pour plus d’informations sur la structure du message SOAP pour les opérations composites, consultez Schémas de message pour l’opération composite.

Comment effectuer des opérations composites sur Oracle Database ?

L’exécution d’une opération sur une base de données Oracle à l’aide de l’adaptateur Oracle E-Business avec BizTalk Server implique des tâches procédurales décrites dans Blocs de construction pour créer des applications Oracle E-Business Suite. Pour effectuer des opérations composites sur une base de données Oracle, ces tâches sont les suivantes :

1. Créez un projet BizTalk dans Visual Studio et générez le schéma pour toutes les opérations que vous souhaitez appeler.

2. Créez manuellement un fichier de schéma qui inclut des références à tous les schémas que vous avez générés à l’étape précédente.

3. Créez des messages dans le projet BizTalk pour envoyer et recevoir des messages à partir d’une base de données Oracle. Ces messages doivent être conformes au schéma de demande et de réponse que vous avez créé à l’étape précédente.

4. Créez une orchestration pour appeler l’opération composite sur une base de données Oracle.

5. Générez et déployez le projet BizTalk.

6. Configurez l’application BizTalk en créant des ports d’envoi et de réception physiques.

7. Démarrez l’application BizTalk.

   Cette rubrique fournit des instructions sur la façon d’effectuer ces tâches.

Génération d’un schéma

Dans cette rubrique, pour montrer comment effectuer des opérations composites, nous allons effectuer les tâches suivantes dans le même ordre :

• Insérez un enregistrement dans la table ACCOUNTACTIVITY.

• Récupérez tous les enregistrements de la table ACCOUNTACTIVITY en appelant la procédure GET_ALL_ACTIVITY dans le package ACCOUNT_PKG.

• Supprimez l’enregistrement de la table ACCOUNTACTIVITY.

  Exécutez les scripts fournis avec les exemples pour créer la table ACCOUNTACTIVITY. Pour plus d’informations sur les exemples, consultez Exemples.

  Vous devez créer un projet BizTalk et utiliser le complément Consume Adapter Service pour générer le schéma. Pour plus d’informations sur la façon de générer des schémas , consultez Récupération de métadonnées pour les opérations Oracle E-Business Suite dans Visual Studio .

Création d’une définition de schéma composite

Vous devez maintenant créer un schéma composite dans le projet Visual Studio BizTalk qui référence les schémas que vous avez créés pour les opérations individuelles. Effectuez les étapes suivantes pour créer une définition de schéma composite.

Pour ajouter une définition de schéma composite

1. Ajoutez un fichier de schéma au projet BizTalk dans Visual Studio. Cliquez avec le bouton droit sur le nom de la solution, pointez sur Ajouter, puis cliquez sur Nouvel élément. Dans la boîte de dialogue Ajouter un nouvel élément , dans la zone Catégories , cliquez sur Fichiers de schéma. Dans la zone Modèles , cliquez sur Schéma. Spécifiez un nom pour le fichier de schéma, puis cliquez sur OK.

   Pour cet exemple, spécifiez le nom du fichier de schéma en tant que CompositeSchema.xsd.

2. Ajoutez des références au schéma généré pour les différentes opérations que vous souhaitez effectuer. Dans cet exemple, les différents schémas générés pour les opérations sont les suivants :

   • OracleEBSBinding.xsd, pour les opérations d’insertion et de suppression sur la table ACCOUNTACTIVITY.

   • OracleEBSBinding2.xsd, pour la procédure GET_ALL_ACTIVITY.

     Pour ajouter des références :

   1. Cliquez avec le bouton droit sur le nœud de schéma> racine< dans CompositeSchema.xsd, puis cliquez sur Propriétés.

   2. Dans la zone Propriété , cliquez sur le bouton de sélection (...) par rapport à la propriété Imports .

      

   3. Dans la boîte de dialogue Importations , dans la liste Importer un nouveau schéma en tant que , sélectionnez Importation XSD, puis cliquez sur Ajouter.

   4. Dans la boîte de dialogue Sélecteur de type BizTalk , développez le nœud Nom du projet BizTalk, Schémas, puis sélectionnez le schéma à importer. Pour cet exemple, sélectionnez <BizTalk_project_name>. OracleEBSBinding.xsd. Cliquez sur OK.

      Répétez cette étape pour importer <BizTalk_project_name>. OracleEBSBinding2.xsd aussi.

   5. Dans la boîte de dialogue Importations , cliquez sur OK.

3. Ajoutez deux nœuds enfants au nœud de schéma racine. Un nœud enfant correspond au schéma de demande pour l’exécution de l’opération composite. L’autre nœud enfant correspond au schéma de réponse. Le nœud qui correspond au schéma de requête peut avoir n’importe quel nom. Le nœud qui correspond au schéma de réponse doit être appelé <request_schema_node>Response. Pour cet exemple, nous allons appeler le nœud de schéma de requête en tant que Requête. Par conséquent, le nœud de schéma de réponse est appelé RequestResponse.

   Notes

   Par défaut, un nœud racine est également ajouté à un nouveau fichier de schéma. Vous pouvez renommer le nœud racine en Requête. Pour renommer un nœud, cliquez avec le bouton droit sur le nom du nœud, puis cliquez sur Renommer.

   Pour ajouter un nœud sous le <nœud Schéma> :

   1. Cliquez avec le bouton droit sur le <nœud Schéma> , pointez sur Insérer un nœud de schéma, puis cliquez sur Enregistrement enfant.

   2. Renommez le nouveau nœud RequestResponse.

4. Ajoutez des nœuds enfants sous le nœud Requête qui correspondent au schéma de requête pour chaque opération que vous allez effectuer dans le cadre de l’opération composite. Pour cet exemple, vous devez ajouter des nœuds enfants correspondant aux éléments suivants :

   • Opérations d’insertion et de suppression sur la table ACCOUNTACTIVITY.

   • GET_ALL_ACTIVITY procédure.

   Important

   Vous devez ajouter les nœuds dans l’ordre dans lequel vous souhaitez effectuer les opérations. Par exemple, si vous souhaitez insérer un enregistrement, exécuter une procédure stockée, puis supprimer un enregistrement, vous devez d’abord ajouter un nœud pour l’opération Insérer, suivi d’un nœud pour la procédure stockée et enfin d’un nœud pour l’opération Supprimer.

   Pour ajouter des nœuds enfants au nœud Requête :

   1. Cliquez avec le bouton droit sur le nœud Requête , pointez sur Insérer un nœud de schéma, puis cliquez sur Enregistrement enfant.

      

   2. Renommez l’enregistrement pour qu’il corresponde à un schéma de requête pour une opération que vous effectuez dans le cadre de l’opération composite. Par exemple, renommez le nœud « Insert ».

   3. Mappez le nœud Insérer au schéma de requête pour l’opération Insérer sur la table ACCOUNTACTIVITY. Pour ce faire, cliquez avec le bouton droit sur le nœud Insérer , puis cliquez sur Propriétés. Dans la zone Propriétés, dans la liste Type de structure de données, sélectionnez Insérer (référence).

      

   4. Répétez ces étapes pour ajouter des nœuds pour les schémas de requête pour GET_ALL_ACTIVITY procédure stockée et l’opération Delete. Spécifiez les noms de nœud et mappez-les au schéma correspondant, comme indiqué dans le tableau suivant.

      Nom du nœud	Mappé au schéma
      GET_ALL_ACTIVITY	GET_ALL_ACTIVITY (référence)
      Supprimer	Supprimer (référence)

5. Ajoutez des nœuds enfants sous le nœud RequestResponse qui correspondent au schéma de réponse pour chaque opération que vous allez effectuer dans le cadre de l’opération composite. Pour cet exemple, vous devez ajouter des nœuds enfants correspondant aux éléments suivants :

   • Opérations d’insertion et de suppression sur la table ACCOUNTACTIVITY.

   • GET_ALL_ACTIVITY procédure stockée.

   Important

   Vous devez ajouter les nœuds enfants dans le même ordre que les nœuds enfants sous le nœud Requête .

   Pour ajouter des nœuds enfants au nœud RequestResponse :

   1. Cliquez avec le bouton droit sur le nœud RequestResponse , pointez sur Insérer un nœud de schéma, puis cliquez sur Enregistrement enfant.

   2. Renommez l’enregistrement pour qu’il corresponde à un schéma de réponse pour une opération que vous effectuez dans le cadre de l’opération composite. Par exemple, renommez le nœud « InsertResponse ».

   3. Mappez le nœud InsertResponse au schéma de réponse de l’opération Insert sur la table ACCOUNTACTIVITY. Pour ce faire, cliquez avec le bouton droit sur le nœud InsertResponse , puis cliquez sur Propriétés. Dans la zone Propriétés , dans la liste Type de structure de données , sélectionnez InsertResponse (Référence) .

   4. Répétez ces étapes pour ajouter des nœuds aux schémas de réponse pour la procédure stockée GET_ALL_ACTIVITY et l’opération Delete. Spécifiez les noms de nœuds et mappez-les au schéma correspondant, comme indiqué dans le tableau suivant.

      Nom du nœud	Mappé au schéma
      GET_ALL_ACTIVITYResponse	GET_ALL_ACTIVITYResponse (référence)
      DeleteResponse	DeleteResponse (Référence)

6. Enregistrez le fichier CompositeSchema.xsd .

Définition des messages et des types de messages

Le schéma composite que vous avez créé à la dernière étape décrit les « types » requis pour les messages dans une orchestration. Un message est généralement une variable, dont le type est défini par le schéma correspondant. Vous devez maintenant créer des messages pour l’orchestration et les lier au schéma que vous avez créé à l’étape précédente.

Pour créer des messages et créer un lien vers le schéma

1. Ajoutez une orchestration au projet BizTalk dans Visual Studio. À partir Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet BizTalk, pointez sur Ajouter, puis cliquez sur Nouvel élément. Tapez un nom pour l’orchestration BizTalk, puis cliquez sur Ajouter.

2. Si la fenêtre Vue Orchestration du projet BizTalk n’est pas déjà ouverte, ouvrez-la. Pour ce faire, cliquez sur Affichage, pointez sur Autres fenêtres, puis cliquez sur Vue d’orchestration.

3. Dans la vue Orchestration, cliquez avec le bouton droit sur Messages, puis cliquez sur Nouveau message.

4. Cliquez avec le bouton droit sur le message nouvellement créé, puis sélectionnez Fenêtre Propriétés.

5. Dans le volet Propriétés du Message_1, procédez comme suit :

   Propriété	Pour
   Identificateur	Saisissez Request
   Type de message	Dans la liste déroulante, développez Schémas, puis sélectionnez Composite_Op.CompositeSchema.Request, où Composite_Op est le nom de votre projet BizTalk. CompositeSchema est le schéma que vous avez créé manuellement pour les opérations composites.

6. Répétez l’étape 2 pour créer un message. Dans le volet Propriétés du nouveau message, procédez comme suit :

   Propriété	Pour
   Identificateur	Saisissez Response
   Type de message	Dans la liste déroulante, développez Schémas, puis sélectionnez Composite_Op.CompositeSchema.RequestResponse.

Configuration de l’orchestration

Vous devez créer une orchestration BizTalk pour utiliser BizTalk Server pour effectuer des opérations composites sur une base de données Oracle. Dans cette orchestration, vous supprimez un message de demande à un emplacement de réception défini. Le message de demande doit être conforme au schéma composite que vous avez créé précédemment. L’adaptateur Oracle E-Business consomme ce message et le transmet à la base de données Oracle. La réponse de la base de données Oracle est enregistrée à un autre emplacement. Vous devez inclure des formes Envoyer et Recevoir pour envoyer des messages à la base de données Oracle et recevoir des réponses, respectivement. Une orchestration de base pour l’exécution d’opérations composites ressemble à ce qui suit :

Ajout de formes de message

Veillez à spécifier les propriétés suivantes pour chacune des formes de message. Les noms répertoriés dans la colonne Forme sont les noms des formes de message affichées dans l’orchestration qui vient d’être mentionnée.

Ajout de ports

Veillez à spécifier les propriétés suivantes pour chacun des ports logiques. Les noms répertoriés dans la colonne Port sont les noms des ports affichés dans l’orchestration.

Spécifier des messages pour les formes d’action et les connecter aux ports

Le tableau suivant spécifie les propriétés et leurs valeurs que vous devez définir pour spécifier des messages pour les formes d’action et lier les messages aux ports. Les noms répertoriés dans la colonne Forme sont les noms des formes de message affichées dans l’orchestration mentionnée précédemment.

Une fois que vous avez spécifié ces propriétés, les formes et les ports de message sont connectés et votre orchestration est terminée.

Vous devez maintenant générer la solution BizTalk et la déployer sur un BizTalk Server. Pour plus d’informations, consultez Génération et exécution d’orchestrations.

Configuration de l’application BizTalk

Une fois que vous avez déployé le projet BizTalk, l’orchestration que vous avez créée précédemment est répertoriée sous le volet Orchestrations de la console d’administration BizTalk Server. Vous devez utiliser la console Administration BizTalk Server pour configurer l’application. Pour obtenir une procédure pas à pas, consultez Procédure pas à pas : déploiement d’une application BizTalk de base.

La configuration d’une application implique :

• Sélection d’un hôte pour l’application.

• Mappage des ports que vous avez créés dans votre orchestration aux ports physiques dans la console Administration BizTalk Server. Pour cette orchestration, vous devez :

  • Définissez un emplacement sur le disque dur et un port de fichier correspondant où vous allez supprimer un message de demande. L’orchestration BizTalk consomme le message de requête et l’envoie à la base de données Oracle.

  • Définissez un emplacement sur le disque dur et un port de fichier correspondant où l’orchestration BizTalk supprime le message de réponse contenant la réponse de la base de données Oracle.

  • Définissez un WCF-Custom physique ou WCF-OracleEBS un port d’envoi pour envoyer des messages à la base de données Oracle. Étant donné que les opérations qui font partie de l’opération composite sont exécutées dans une transaction unique, assurez-vous que la propriété de liaison UseAmbientTransaction a la valeur True.

    Vous devez également spécifier l’action dans le port d’envoi. L’action d’une opération composite est « CompositeOperation ». Pour plus d’informations sur la création de ports, consultez Configuration manuelle d’une liaison de port physique à l’adaptateur Oracle E-Business. Pour plus d’informations sur la spécification d’actions pour les ports, consultez Configurer l’action SOAP pour Oracle E-Business Suite.

    Important

    Dans le cadre d’opérations composites, si vous exécutez des opérations sur des objets, par exemple des procédures stockées, des fonctions, des tables d’interface ou des vues d’interface, qui appartiennent à une application Oracle E-Business Suite, vous devez définir le contexte de l’application en spécifiant les propriétés de liaison requises. Pour plus d’informations sur la définition du contexte d’application, consultez Définir le contexte d’application.

    Vous pouvez définir le contexte de l’application en spécifiant les propriétés de liaison ou en définissant les propriétés de contexte de message exposées par l’adaptateur Oracle E-Business. Pour obtenir des instructions sur la définition des propriétés de liaison, consultez Configurer les propriétés de liaison pour Oracle E-Business Suite. Pour obtenir des instructions sur la définition du contexte d’application à l’aide des propriétés du contexte de message, consultez Configurer le contexte d’application à l’aide des propriétés du contexte de message dans Oracle E-Business Suite.

    Notes

    La génération du schéma à l’aide du complément De projet BizTalk du service Consume Adapter crée également un fichier de liaison qui contient des informations sur les ports et les actions à définir pour ces ports. Vous pouvez importer ce fichier de liaison à partir de la console d’administration BizTalk Server pour créer des ports d’envoi (pour les appels sortants) ou de réception (pour les appels entrants). Pour plus d’informations, consultez Configurer une liaison de port physique à l’aide d’un fichier de liaison de port vers Oracle E-Business Suite. Si vous importez ce fichier de liaison, l’action sur le port d’envoi est définie sur une action dynamique impliquant toutes les opérations que vous avez sélectionnées dans le complément Consumer Adapter Service lors de la génération du schéma. Pour une opération composite, vous devez remplacer l’action dynamique par « CompositeOperation ».

Démarrage de l’application

Vous devez démarrer l’application BizTalk pour effectuer des opérations composites sur une base de données Oracle. Pour obtenir des instructions sur le démarrage d’une application BizTalk, consultez Guide pratique pour démarrer une orchestration.

À ce stade, assurez-vous que :

• Le port de réception FILE pour recevoir les messages de demande pour l’orchestration est en cours d’exécution.

• Le port d’envoi FILE pour recevoir les messages de réponse de l’orchestration est en cours d’exécution.

• Le port d’envoi WCF-Custom ou WCF-OracleEBS pour envoyer des messages à la base de données Oracle est en cours d’exécution.

• L’orchestration BizTalk pour l’opération est en cours d’exécution.

Exécution de l’opération

Après avoir exécuté l’application, vous devez supprimer un message de demande à l’emplacement de réception FILE. Le schéma du message de demande doit être conforme au schéma pour les opérations composites que vous avez créées précédemment. Par exemple, un message de demande qui insère un enregistrement dans la table ACCOUNTACTIVITY, appelle la procédure stockée GET_ALL_ACTIVITY et supprime un enregistrement de la table ACCOUNTACTIVITY est :

<Request xmlns="http://Composite_Op.CompositeSchema">  
  <Insert xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Tables/SCOTT/ACCOUNTACTIVITY">  
    <RECORDSET>  
      <InsertRecord xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/TableViewRecord/SCOTT/ACCOUNTACTIVITY">  
        <TID InlineValue="tid_seq.nextval"></TID>  
        <ACCOUNT>100001</ACCOUNT>  
        <AMOUNT>1500</AMOUNT>  
        <DESCRIPTION></DESCRIPTION>  
        <TRANSDATE InlineValue="sysdate">1999-05-31T13:20:00</TRANSDATE>  
        <PROCESSED>n</PROCESSED>  
      </InsertRecord>  
    </RECORDSET>  
  </Insert>  
  <GET_ALL_ACTIVITY xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/PackageApis/SCOTT/ACCOUNT_PKG" />  
  <Delete xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Tables/SCOTT/ACCOUNTACTIVITY">  
    <FILTER>WHERE AMOUNT = 1500</FILTER>  
  </Delete>  
</Request>  

Le message de demande précédent insère d’abord un enregistrement, puis appelle la procédure GET_ALL_ACTIVITY pour obtenir tous les enregistrements de la table ACCOUNTACTIVITY. Ensuite, l’enregistrement inséré est supprimé en spécifiant une clause FILTER. Consultez Schémas de message pour les opérations composites pour plus d’informations sur le schéma de message de requête pour effectuer des opérations composites sur une base de données Oracle à l’aide de l’adaptateur Oracle E-Business.

L’orchestration consomme le message et l’envoie à la base de données Oracle. La réponse de la base de données Oracle est enregistrée à l’autre emplacement FILE défini dans le cadre de l’orchestration. Par exemple, la réponse de la base de données Oracle pour le message de requête précédent ressemble à ce qui suit :

<?xml version="1.0" encoding="utf-8" ?>   
<RequestResponse xmlns="http://Composite_Op.CompositeSchema">  
  <InsertResponse xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Tables/SCOTT/ACCOUNTACTIVITY">  
    <InsertResult>1</InsertResult>   
  </InsertResponse>  
  <GET_ALL_ACTIVITYResponse xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/PackageApis/SCOTT/ACCOUNT_PKG">  
    <ALLRECS>  
      <xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
        <xs:element msdata:IsDataSet="true" name="NewDataSet">  
          <xs:complexType>  
            <xs:sequence>  
              <xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable">  
                <xs:complexType>  
                  <xs:sequence>  
                    <xs:element minOccurs="0" name="TID" type="xs:decimal" />   
                    <xs:element minOccurs="0" name="ACCOUNT" type="xs:decimal" />   
                    <xs:element minOccurs="0" name="AMOUNT" type="xs:decimal" />   
                    <xs:element minOccurs="0" name="DESCRIPTION" type="xs:string" />   
                    <xs:element minOccurs="0" name="TRANSDATE" type="xs:dateTime" />   
                    <xs:element minOccurs="0" name="PROCESSED" type="xs:string" />   
                  </xs:sequence>  
                </xs:complexType>  
              </xs:element>  
            </xs:sequence>  
          </xs:complexType>  
        </xs:element>  
      </xs:schema>  
      <diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
        <NewDataSet xmlns="">  
          <NewTable>  
            ......   
            ......   
          </NewTable>  
          ......  
          ......  
          <NewTable>  
            <TID>10</TID>   
            <ACCOUNT>100001</ACCOUNT>   
            <AMOUNT>1000</AMOUNT>   
            <TRANSDATE>2008-07-28T21:39:57</TRANSDATE>   
            <PROCESSED>n</PROCESSED>   
          </NewTable>  
        </NewDataSet>  
      </diffgr:diffgram>  
    </ALLRECS>  
  </GET_ALL_ACTIVITYResponse>  
  <DeleteResponse xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Tables/SCOTT/ACCOUNTACTIVITY">  
    <DeleteResult>1</DeleteResult>   
  </DeleteResponse>  
</RequestResponse>  

La réponse précédente contient plusieurs jeux de résultats correspondant aux différentes opérations effectuées dans le cadre de l’opération composite. Par exemple, l’élément InsertResult contient « 1 », indiquant le nombre de lignes insérées par l’opération Insert. De même, l’élément DeleteResult contient « 1 », indiquant le nombre de lignes supprimées par l’opération Delete.

Bonnes pratiques

Une fois que vous avez déployé et configuré le projet BizTalk, vous pouvez exporter les paramètres de configuration vers un fichier XML appelé fichier de liaison. Une fois que vous avez généré un fichier de liaison, vous pouvez importer les paramètres de configuration à partir du fichier, de sorte que vous n’avez pas besoin de créer des éléments tels que des ports d’envoi et des ports de réception pour la même orchestration. Pour plus d’informations sur les fichiers de liaison, consultez Réutiliser les liaisons d’adaptateur avec Oracle E-Business Suite.

Voir aussi

Développer des applications BizTalk à l’aide de l’adaptateur Oracle E-Business Suite