Prise en charge des types Oracle User-Defined dans Oracle Database

L’adaptateur Microsoft BizTalk pour Oracle Database prend en charge l’exécution d’opérations sur des artefacts dans la base de données Oracle qui contiennent des types oracle User-Defined (UUDT). Les UDT peuvent être présents dans les artefacts suivants :

• Tables et vues contenant des colonnes UDT.

• Packages, procédures stockées et fonctions contenant des paramètres UDT.

Qu’est-ce qu’un UDT Oracle ?

Les UDT Oracle aident à représenter des entités complexes en tant qu’objet « unique » qui peut être partagé entre les applications. Par exemple, il est possible de modéliser des entités réelles telles que « Customers » ou « Sales Orders » en tant qu’objets dans la base de données Oracle. Les UDT Oracle sont définis dans la base de données Oracle et sont des deux types suivants :

• Types d’objets. Par exemple, Oracle Object.

• Types de collection. Par exemple, les types de tables imbriquées ou les VARRAYS.

  Le nom de l’UDT Oracle respecte la casse et doit être spécifié de la manière suivante : [SCHEMA_NAME].[UDT_NAME].

Comment l’adaptateur prend-il en charge oracle UDT ?

ODP.NET prend en charge les UDT en représentant des UDT Oracle définis dans la base de données Oracle en tant que types .NET (types personnalisés). Les types personnalisés définissent le mappage entre les attributs ou les éléments Oracle UDT et les membres .NET. Les types personnalisés peuvent être des classes ou des structures .NET, et peuvent représenter des objets Oracle ou des collections Oracle. En raison du fait que l’adaptateur Oracle Database utilise ODP.NET pour se connecter à la base de données Oracle, il hérite de la prise en charge des UDT Oracle.

L’adaptateur Oracle Database utilise la ODP.NET pour spécifier un mappage de type personnalisé pour mapper un type personnalisé .NET à un UDT Oracle dans la base de données. Pour spécifier un mappage de type personnalisé, l’adaptateur Oracle Database utilise une fabrique de types personnalisée. Par conséquent, pour utiliser un UDT Oracle, un assembly (fichier.dll) est requis, définissant la fabrique de types personnalisée. L’adaptateur Oracle Database vous permet de générer un assembly pour la fabrique de types personnalisée tout en générant les métadonnées d’un artefact/opération qui contient un UDT Oracle.

Remarque

L’adaptateur génère l’assembly pour les UDT Oracle en fonction des classes utilisées par l’ODP.NET pour prendre en charge les UDT Oracle. Pour plus d’informations sur la prise en charge des UDT Oracle dans ODP.NET, consultez https://go.microsoft.com/fwlink/?LinkId=140697.

Pour générer le fichier d’assembly pour l’utilisation des UDT Oracle au moment du design, puis l’utiliser ultérieurement au moment de l’exécution, l’adaptateur Oracle Database expose les propriétés de liaison suivantes :

• GeneratedUserTypesAssemblyFilePath (heure de conception)

• GeneratedUserTypesAssemblyKeyFilePath (temps de conception)

• UserAssembliesLoadPath (heure d’exécution)

  Pour plus d’informations sur ces propriétés de liaison, consultez Configurer les propriétés de liaison pour Oracle Database.

Exécution d’opérations sur des artefacts contenant des UDT Oracle

Pour effectuer des opérations sur des artefacts contenant des UDT à l’aide de l’adaptateur Oracle Database, vous devez effectuer les opérations suivantes pendant le temps de conception et l’heure d’exécution.

Moment de la conception

Vous devez effectuer ces étapes lors de la génération du schéma de l’opération dans Visual Studio.

1. Connectez-vous à la base de données Oracle à l’aide du complément Consume Adapter Service, de l’Assistant Add Adapter Metadata Wizard ou du plug-in Add Adapter Service Reference. Pour plus d’informations sur cette opération, consultez Se connecter à Oracle Database dans Visual Studio à l’aide du service Utiliser l’adaptateur.

2. Lors de la connexion, dans l’onglet Propriétés de liaison de la boîte de dialogue Configurer l’adaptateur , spécifiez les valeurs appropriées pour les propriétés de liaison GeneratedUserTypesAssemblyFilePath et GeneratedUserTypesAssemblyKeyFilePath . Pour plus d’informations sur ces propriétés de liaison, consultez Configurer les propriétés de liaison pour Oracle Database.

3. Lorsque vous êtes connecté à la base de données Oracle dans Visual Studio, accédez à l’artefact requis qui contient un UDT Oracle. Pour plus d'informations sur la navigation des artéfacts, consultez Parcourir, rechercher et obtenir des métadonnées pour les opérations d'Oracle Database.

4. Sélectionnez l’artefact requis, puis cliquez sur OK. L’adaptateur Oracle Database génère les métadonnées de l’opération sélectionnée, ainsi que l’assembly (fichier.dll) pour l’UDT Oracle dans l’artefact sélectionné. L’assembly est créé à l’emplacement que vous avez spécifié dans la propriété de liaison GeneratedUserTypesAssemblyFilePath .

5. Passez aux autres étapes de création et de déploiement de votre projet.

Temps d’exécution

Vous devez effectuer ces étapes dans les clients d’adaptateur pour effectuer des opérations sur les UDT Oracle.

Dans BizTalk Server

• Ajoutez manuellement l’assembly Oracle UDT créé à l’étape 4 dans « Temps de conception » au Global Assembly Cache (GAC) sur votre ordinateur. Vous pouvez également copier manuellement l’assembly Oracle UDT sous l’emplacement d’installation de BizTalk Server. Pour BizTalk Server, il s’agit <généralement du lecteur> d’installation :\Program Files\Microsoft BizTalk Server.

• Lors de la configuration du port WCF-Custom ou WCF-OracleDB BizTalk Server, sous l’onglet Liaison , spécifiez l’emplacement de l’assembly UDT Oracle pour la propriété de liaison UserAssembliesLoadPath . Pour plus d’informations sur cette propriété de liaison, consultez Configurer les propriétés de liaison pour Oracle Database.

  dans Visual Studio

• Ajoutez manuellement l’assembly Oracle UDT créé à l’étape 4 dans « Temps de conception » au Global Assembly Cache (GAC) sur votre ordinateur. Vous pouvez également copier manuellement l’assembly UDT Oracle au même emplacement que le fichier exécutable du projet, qui se trouve généralement sous le dossier \bin\Debug du projet.

• Spécifiez l'emplacement de l'assembly Oracle UDT pour la propriété de liaison UserAssembliesLoadPath. Pour plus d’informations sur cette propriété de liaison, consultez Configurer les propriétés de liaison pour Oracle Database.

Voir aussi

Quelles opérations peuvent être effectuées à l’aide de l’adaptateur ?