En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour Oracle E-Business Suite
L’adaptateur Microsoft BizTalk pour Oracle E-Business Suite présente plusieurs propriétés de liaison. En définissant ces propriétés, vous pouvez contrôler une partie du comportement de l’adaptateur. Cette section décrit les propriétés de liaison de l’adaptateur Oracle E-Business. Il montre également comment vous pouvez y accéder à l’aide de la programmation .NET ou en définissant des propriétés sur une liaison de port physique BizTalk Server.
Propriétés de liaison de l’adaptateur
Oracle E-Business Suite est une couche d’application sur la base de données Oracle sous-jacente. Certaines propriétés de liaison configurent le comportement de l’adaptateur lors de l’interface avec Oracle E-Business Suite, tandis que d’autres propriétés configurent le comportement lors de l’interfaçage avec la base de données Oracle. Le tableau suivant montre toutes les propriétés de liaison de l’adaptateur Oracle E-Business regroupées par catégorie. La catégorie fait référence au nœud sous lequel chaque propriété de liaison apparaît dans les boîtes de dialogue présentées par différentes applications pour configurer l’adaptateur (ou la liaison).
| Binding, propriété | Category | Description | Type .NET |
|---|---|---|---|
| ClientCredentialType | Général | Spécifie le jeu d’informations d’identification spécifié lors de l’établissement d’une connexion avec Oracle E-Business Suite. Les valeurs possibles sont Database et EBusiness. - S’il est défini sur Base de données, les clients d’adaptateurs doivent spécifier les informations d’identification de base de données pour établir la connexion et les informations d’identification E-Business Suite pour les propriétés de liaison OracleUserName et OraclePassword . - S’il est défini sur EBusiness, les clients d’adaptateur doivent spécifier les informations d’identification E-Business Suite pour établir la connexion et les informations d’identification de base de données pour les propriétés de liaison OracleUserName et OraclePassword . Important: Si la propriété de liaison ClientCredentialType est définie sur EBusiness, la spécification du nom d’utilisateur et du mot de passe de la base de données pour les propriétés de liaison OracleUserName et OraclePassword est obligatoire. La valeur par défaut est Database. |
enum (ClientCredential) |
| CloseTimeout | Général | Délai d’expiration de la connexion WCF de fermeture. Spécifie une valeur d’intervalle de temps qui indique l’intervalle de temps fourni pour la fin de l’opération de fermeture du canal WCF interne. La valeur par défaut est de 1 minute. Non pris en charge. | System.TimeSpan |
| EnableBizTalkCompatibilityMode | Général | Spécifie comment l’adaptateur génère le schéma pour un DataSet. Définissez cette valeur sur True pour générer correctement le schéma pour DataSet. Lorsque vous utilisez les adaptateurs de BizTalk Server, vous devez toujours définir la propriété sur True. Lorsque vous utilisez les adaptateurs de Visual Studio, vous devez toujours définir la propriété sur False. |
bool (System.Boolean) |
| InboundOperationType | Général | Spécifie si vous souhaitez effectuer une opération entrante d’interrogation ou de notification . La valeur par défaut est Interrogation. Pour plus d’informations sur l’interrogation, consultez Prise en charge des appels entrants à l’aide de l’interrogation. Pour plus d’informations sur la notification, consultez Considérations relatives à la réception de notifications de modification de base de données à l’aide de l’adaptateur Oracle Database. |
enum |
| Nom | Général | Valeur en lecture seule qui retourne le nom du fichier généré par le plug-in Visual Studio Add Adapter Service Reference pour contenir la classe de client WCF. Le plug-in Add Adapter Service Reference forme le nom du fichier en ajoutant « Client » à la valeur de la propriété Name . La valeur retournée est « OracleEBSBinding » ; pour cette valeur, le fichier généré sera nommé « OracleEBSBindingClient ». | string |
| OpenTimeout | Général | Délai d’ouverture de la connexion WCF. Spécifie une valeur d’intervalle de temps qui indique l’intervalle de temps fourni pour l’exécution de l’opération d’ouverture de canal interne. La valeur par défaut est de 1 minute. Important: L’adaptateur Oracle E-Business utilise toujours OpenTimeout pour définir le délai d’ouverture de la connexion lorsqu’il ouvre une connexion à la base de données Oracle. L’adaptateur ignore tous les paramètres de délai d’expiration (System.TimeSpan) passés lorsque vous ouvrez un objet de communication, tel qu’un canal. |
System.TimeSpan |
| ReceiveTimeout | Général | Délai d’expiration du message WCF. Spécifie une valeur d’intervalle de temps qui indique l’intervalle de temps maximal pendant lequel l’adaptateur attend un message entrant. La valeur par défaut est 10 minutes. Important: Pour les opérations entrantes telles que l’interrogation, nous vous recommandons de définir le délai d’expiration sur la valeur maximale possible, qui est 24.20 :31 :23.64700000 (24 jours). Lorsque vous utilisez l’adaptateur avec BizTalk Server, définir le délai d’expiration sur une valeur importante n’a pas d’impact sur les fonctionnalités de l’adaptateur. |
System.TimeSpan |
| SendTimeout | Général | Délai d’envoi du message WCF. Spécifie une valeur d’intervalle de temps qui indique l’intervalle de temps fourni pour l’exécution de l’opération d’envoi de canal interne. La valeur par défaut est de 5 minutes. | System.TimeSpan |
| UseAmbientTransaction | Général | Spécifie si l’adaptateur Oracle E-Business effectue les opérations à l’aide du contexte de transaction fourni par l’appelant. La valeur par défaut est true, ce qui signifie que l’adaptateur effectue toujours les opérations dans un contexte de transaction, en supposant que le client fournit le contexte transactionnel. Si d’autres ressources participent à la transaction, les connexions créées s’inscrivent dans System.Transaction et sont élevées à une transaction MSDTC. Toutefois, il peut y avoir des scénarios dans lesquels vous ne souhaitez pas que l’adaptateur effectue des opérations dans un contexte transactionnel. Par exemple : - Lors de l’exécution d’une opération SELECT simple sur la base de données Oracle (sur un port d’envoi) - Lors de la spécification d’une instruction d’interrogation qui effectue une opération SELECT et n’implique aucune modification de la table par le biais d’une instruction DELETE ou en appelant une procédure stockée (sur un port de réception) Ces deux opérations n’effectuent aucune mise à jour de la table de base de données et, par conséquent, l’élévation de ces opérations à l’utilisation d’une transaction MSDTC peut être une surcharge de performances. Dans de tels scénarios, vous pouvez définir la propriété de liaison sur false afin que l’adaptateur Oracle E-Business n’effectue pas les opérations dans un contexte de transaction. Note: Il est recommandé de ne pas effectuer d’opérations dans un contexte transactionnel uniquement pour les opérations qui n’apportent pas de modifications à la base de données. Pour les opérations qui mettent à jour des données dans la base de données, nous vous recommandons de définir la propriété de liaison sur true, sinon vous risquez de subir une perte de messages ou des messages en double selon que vous effectuez des opérations entrantes ou sortantes. |
bool (System.Boolean) |
| DataFetchSize | Gestion des tampons | ODP.NET propriété. Spécifie la quantité de données en octets que ODP.NET extraits du jeu de résultats dans un aller-retour de serveur. La valeur par défaut est 65536. Cette propriété est utilisée pour l’optimisation des performances. | long (System.Int64) |
| InsertBatchSize | Gestion des tampons | Spécifie la taille de lot pour plusieurs opérations d’insertion d’enregistrement. Valeur par défaut : 20. Pour les valeurs de InsertBatchSize supérieures à 1, l’adaptateur Oracle E-Business traite par lot le nombre spécifié d’enregistrements en un seul appel ODP.NET. Si le nombre d’enregistrements dans l’opération Insertion n’est pas un multiple de la taille du lot, le lot final contiendra moins d’enregistrements que la valeur de taille du lot. Par exemple, si le message d’insertion contient 10 enregistrements et que InsertBatchSize a la valeur 1, l’adaptateur lit les enregistrements individuels et les écrit dans la base de données Oracle. Par conséquent, l’adaptateur effectue 10 opérations distinctes sur la base de données Oracle. De même, si le message d’insertion contient 10 enregistrements et que InsertBatchSize a la valeur 5, l’adaptateur lit et écrit 5 enregistrements à la fois dans la base de données Oracle, effectuant donc seulement 2 opérations d’insertion. Une valeur bien choisie pour InsertBatchSize peut considérablement améliorer les performances de l’adaptateur pour les opérations d’insertion de plusieurs enregistrements. |
int (System.Int32) |
| LongDatatypeColumnSize | Gestion des tampons | Spécifie la taille maximale en octets d’une colonne de type de données long Oracle. La valeur maximale de cette propriété de liaison peut être 32512. La valeur par défaut est 0. Vous devez utiliser la valeur par défaut si vous n’effectuez pas d’opération sur le type de données long. Vous devez définir explicitement une valeur appropriée pour cette propriété de liaison si vous êtes : - Exécution d’une procédure stockée qui contient des paramètres de type de données long. - Exécution d’une opération Select sur une table qui contient des colonnes avec un type de données long, et l’instruction SELECT n’inclut pas la colonne de clé primaire. Si vous souhaitez définir la valeur maximale pour cette propriété de liaison, définissez la valeur sur -1. Note: Cette propriété de liaison est déconseillée. |
int |
| MaxOutputAssociativeArrayElements | Gestion des tampons | Spécifie la taille du tableau associé créé par l’adaptateur lors de l’exécution d’opérations qui retournent un tableau associatif dans la réponse. L’adaptateur communique la taille du tableau à ODP.NET, ce qui crée à son tour une mémoire tampon en fonction de la taille du tableau. La valeur par défaut est 32. Cette propriété de liaison est utile lors de l’exécution d’opérations impliquant des types de tables PL/SQL. |
int (System.Int32) |
| MétadonnéesPooling | Gestion des tampons | ODP.NET propriété. Spécifie si ODP.NET met en cache les informations de métadonnées pour les requêtes exécutées. La valeur par défaut est true, ce qui permet le regroupement de métadonnées. La mise en cache de ces informations améliore les performances ; toutefois, si des modifications apportées aux artefacts Oracle sous-jacents se produisent sur le système Oracle, ces métadonnées mises en pool seront désynchronisées. Les opérations effectuées sur le système Oracle peuvent alors renvoyer des exceptions inattendues. Cette propriété est utilisée pour l’optimisation des performances. | bool (System.Boolean) |
| StatementCachePurge | Gestion des tampons | ODP.NET propriété. Spécifie si le cache d’instructions ODP.NET associé à une connexion est vidé lorsque la connexion est retournée au pool de connexions. La valeur par défaut est false, ce qui désactive la purge du cache d’instruction. Cette propriété est utilisée pour l’optimisation des performances. | bool (System.Boolean) |
| StatementCacheSize | Gestion des tampons | ODP.NET propriété. Spécifie le nombre maximal d’instructions pouvant être mises en cache par chaque connexion ODP.NET. Le fait de définir cette propriété sur une valeur autre que zéro active la mise en cache des instructions pour les connexions. La valeur par défaut est de 10. Cette propriété est utilisée pour l’optimisation des performances. | int (System.Int32) |
| OracleConnectionClientId | Débogage | Spécifie un identificateur client (ID) pour la connexion utilisée par l’adaptateur pour se connecter à Oracle. Cela est utile si vous avez activé le suivi côté serveur Oracle et que vous souhaitez effectuer un suivi sélectif des opérations pour un ID client particulier. Cela vous permet également de filtrer et d’afficher les traces du serveur Oracle en fonction d’un ID client. | String |
| EnablePerformanceCounters | Diagnostics | Spécifie s’il faut activer les compteurs de performances du KIT de développement logiciel (SDK) de l’adaptateur LOB WCF et le compteur de performances de latence métier de l’adaptateur E-Business Oracle. La valeur par défaut est False ; les compteurs de performances sont désactivés. Le compteur de performances de latence métier mesure le temps total passé par l’adaptateur Oracle E-Business à passer des appels à Oracle E-Business Suite. | bool (System.Boolean) |
| EnableSafeTyping | Métadonnées | Active ou désactive la saisie sécurisée. La valeur par défaut est false ; la saisie sécurisée est désactivée. Cette fonctionnalité contrôle la façon dont l’adaptateur fait surface à certains types de données Oracle. Pour plus d’informations sur la saisie sécurisée, consultez Types de données Oracle de base. | bool (System.Boolean) |
| UseSchemaInNameSpace | Métadonnées | Spécifie si le nom du schéma (SCOTT, HR, etc.) est inclus dans l’espace de noms xml pour les opérations et leurs types associés sur les artefacts de base de données sous-jacents. La valeur par défaut est True ; le nom du schéma est inclus dans l’espace de noms. L’avantage de ne pas inclure de nom de schéma dans l’espace de noms est que s’il existe une table portant le même nom (par exemple, EMP) dans deux schémas différents, le même CODE XML peut être utilisé pour effectuer les opérations SQL simples (Insérer, Mettre à jour, Supprimer, Sélectionner) sur les deux tables. Par exemple, si la propriété UseSchemaInNamespace a la valeur true, l’espace de noms pour ces opérations sur le SCOTT. La table EMP est http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMP; si elle est false, l’espace de noms est http://schemas.microsoft.com/OracleEBS/Tables/EMP.Important: L’action de message n’est pas affectée par la propriété de liaison UseSchemaInNamesapce ; il inclut toujours le nom du schéma. Important: Nous vous recommandons vivement de définir cette propriété de liaison sur True lors de la génération de métadonnées. Si vous définissez cette propriété sur false, les noms de schéma Oracle (par exemple, SCOTT) ne seront pas disponibles dans l’espace de noms XML du schéma généré. Par conséquent, s’il existe deux tables portant le même nom dans deux schémas Oracle différents et qu’elles sont ajoutées au même projet BizTalk, le projet BizTalk ne parvient pas à générer et à déployer. Si vous souhaitez inclure de tels schémas dans le même projet BizTalk, vous devez les modifier manuellement pour inclure le nom du schéma Oracle dans l’espace de noms XML. |
bool (System.Boolean) |
| MlsSettings | Prise en charge multilingue | Un instance Oracle E-Business Suite peut avoir plusieurs modules linguistiques installés. Par conséquent, si l’adaptateur récupère des métadonnées à partir d’un instance Oracle E-Business Suite qui prend en charge plusieurs langues (MLS), l’adaptateur doit présenter des informations avec le même paramètre de langue que l’utilisateur connecté préfère. La propriété de liaison MlsSettings permet aux clients d’adaptateur de spécifier les options propres à MLS. Cette propriété de liaison peut être spécifiée au moment de la conception et au moment de l’exécution. La propriété de liaison MlsSettings est une propriété de liaison complexe qui à son tour contient davantage de propriétés de liaison. Toutes ces propriétés de liaison sont facultatives. L’adaptateur utilise les propriétés de liaison de la manière suivante pour définir le contexte MLS : - Pour les propriétés de liaison qui ont des valeurs spécifiées, l’adaptateur utilise ces valeurs pour définir le contexte MLS. - Pour les propriétés de liaison qui n’ont pas de valeurs spécifiées, l’adaptateur utilise les paramètres MLS du client ODP.NET sur l’ordinateur où l’adaptateur est installé. Le tableau suivant répertorie les propriétés de liaison qui font partie de la propriété de liaison MlsSettings . Toutes ces propriétés sont facultatives. Calendrier : spécifie le système de calendrier. Cette propriété de liaison correspond au paramètre NLS_CALENDAR dans le client ODP.NET. Comparaison : spécifie une méthode de comparaison pour les clauses WHERE et la comparaison dans les blocs PL/SQL. Cette propriété de liaison correspond au paramètre NLS_COMP dans le client ODP.NET. Devise : spécifie la chaîne à utiliser comme symbole monétaire local pour l’élément de format nombre L. Pour plus d’informations sur les différents éléments de format numérique et modèles de format dans Oracle, consultez https://go.microsoft.com/fwlink/?LinkId=135807. Cette propriété de liaison correspond au paramètre NLS_CURRENCY dans le client ODP.NET. DateFormat : spécifie le format dans lequel la date est présentée. Cette propriété de liaison est mappée au paramètre NLS_DATE_FORMAT dans le client ODP.NET. DateLanguage : spécifie la langue pour les noms de jour et de mois. Cette propriété de liaison est mappée au paramètre de NLS_DATE_LANGUAGE dans le client ODP.NET DualCurrency : spécifie le symbole monétaire double, tel que Euro, pour l’élément de format de numéro U. Pour plus d’informations sur les différents éléments de format numérique et les modèles de format dans Oracle, consultez https://go.microsoft.com/fwlink/?LinkId=135807. Cette propriété de liaison est mappée au paramètre de NLS_DUAL_CURRENCY dans le client ODP.NET. ISOCurrency :Spécifie la chaîne à utiliser comme symbole monétaire international pour l’élément de format de nombre C. Pour plus d’informations sur les différents éléments de format numérique et les modèles de format dans Oracle, consultez https://go.microsoft.com/fwlink/?LinkId=135807. Cette propriété de liaison est mappée au paramètre de NLS_ISO_CURRENCY dans le client ODP.NET. Langue : spécifie la langue à définir dans le contexte MLS. Cette propriété de liaison est mappée au paramètre de NLS_LANGUAGE dans le client ODP.NET. Important: La valeur de la propriété de liaison OracleEBSResponsibilityName doit être spécifiée dans la même langue que celle spécifiée pour la propriété de liaison language . Par exemple, si vous définissez la propriété de liaison language sur Espagnol, le nom de responsabilité que vous spécifiez pour la propriété de liaison OracleEBSResponsibilityName doit également être en espagnol. LengthSemantics : permet de créer des colonnes CHAR et VARCHAR2 à l’aide de la sémantique de longueur d’octets ou de caractères (par défaut). Cette propriété de liaison est mappée au paramètre de NLS_LENGTH_SEMANTICS dans le client ODP.NET. NCharConversionException : spécifie si la perte de données pendant une conversion de type de caractères implicite ou explicite signale une erreur ou non. La valeur par défaut est True. Cette propriété de liaison est mappée au paramètre de NLS_NCHAR_CONV_EXCP dans le client ODP.NET. NumericCharacters : spécifie le caractère décimal et le séparateur de groupe. Cette propriété de liaison est mappée au paramètre de NLS_NUMERIC_CHARACTERS dans le client ODP.NET. Sort : spécifie le type de tri pour les données de caractères. Cette propriété de liaison est mappée au paramètre NLS_SORT dans le client ODP.NET. Territory : spécifie les conventions de date et de format numérique pour un territoire. Cette propriété de liaison est mappée au paramètre NLS_TERRITORY dans le client ODP.NET. TimeStampFormat : spécifie le format de chaîne pour les types de données TimeStamp. Cette propriété de liaison est mappée au paramètre NLS_TIMESTAMP_FORMAT dans le client ODP.NET. TimeStampTZFormat : spécifie le format de chaîne pour les types de données TimeStampTZ. Cette propriété de liaison est mappée au paramètre NLS_TIMESTAMP_TZ_FORMAT dans le client ODP.NET. TimeZone : spécifie le nom de la région de fuseau horaire. Cette propriété de liaison est mappée au paramètre de TIME_ZONE dans le client ODP.NET. |
enum |
| NotificationPort | Notification | Spécifie le numéro de port que ODP.NET devez ouvrir pour écouter la notification de modification de la base de données Oracle. La valeur par défaut est -1, ce qui signifie que ODP.NET utilise un numéro de port valide, aléatoire et inutilisé. Important: Les clients d’adaptateur ne recevront pas de notifications de modification de base de données si le Pare-feu Windows est activé. En outre, il n’est pas recommandé de désactiver le Pare-feu Windows pour recevoir des notifications. Par conséquent, pour recevoir des notifications sans compromettre la sécurité des ordinateurs côté client, nous vous recommandons de spécifier une valeur entière positive comme numéro de port, puis d’ajouter ce numéro de port à la liste des exceptions du Pare-feu Windows. Si vous définissez cette propriété de liaison sur la valeur par défaut -1, ODP.NET utilise un port aléatoire et les clients d’adaptateur ne savent pas quel port ajouter à la liste des exceptions du Pare-feu Windows. Pour obtenir des instructions sur l’ajout de ports à la liste des exceptions du Pare-feu Windows, consultez https://go.microsoft.com/fwlink/?LinkID=196959. Attention: Si plusieurs applications d’un domaine d’application reçoivent des notifications à l’aide de l’adaptateur Oracle E-Business, la propriété de liaison NotificationPort pour toutes les applications doit être définie sur le même numéro de port. En effet, ODP.NET crée un seul écouteur qui écoute sur un port dans un domaine d’application. |
int (System.Int32) |
| NotificationStatement | Notification | Spécifie l’instruction SELECT utilisée pour s’inscrire pour recevoir des notifications à partir d’une base de données Oracle. Un exemple d’instruction SELECT peut ressembler à ce qui suit.SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’Note: Vous devez spécifier le nom de l’objet de base de données ainsi que le nom du schéma. Par exemple : SCOTT.ACCOUNTACTIVITY.L’adaptateur reçoit un message de notification de la base de données Oracle uniquement lorsque le jeu de résultats de l’instruction SELECT spécifiée change. |
string |
| NotifyOnListenerStart | Notification | Spécifie si l’adaptateur envoie un message de notification aux clients de l’adaptateur, indiquant que l’emplacement de réception est en cours d’exécution au démarrage de l’écouteur. La valeur par défaut est True. | bool (System.Boolean) |
| ConnectionLifetime | Pool de connexions Oracle | ODP.NET propriété. Spécifie la durée maximale en secondes d’une connexion. La valeur par défaut est 0. Cette propriété est utilisée pour l’optimisation des performances. | int (System.Int32) |
| DecrPoolSize | Pool de connexions Oracle | ODP.NET propriété. Spécifie le nombre de connexions qui sont fermées lorsqu’un nombre excessif de connexions établies ne sont pas utilisées. La valeur par défaut est 1. Il est utilisé pour le réglage des performances. | int (System.Int32) |
| IncrPoolSize | Pool de connexions Oracle | ODP.NET propriété. Spécifie le nombre de nouvelles connexions à créer lorsqu’une nouvelle connexion est demandée et qu’aucune connexion n’est disponible dans le pool de connexions ODP.NET. La valeur par défaut est 5. Cette propriété est utilisée pour l’optimisation des performances. | int (System.Int32) |
| MaxPoolSize | Pool de connexions Oracle | ODP.NET propriété. Spécifie le nombre maximal de connexions dans un pool de connexions ODP.NET. La valeur par défaut est 100. Cette propriété est utilisée pour l’optimisation des performances. Important: Vous devez définir MaxPoolSize judicieusement. Il est possible d’épuiser le nombre de connexions disponibles à partir de ODP.NET, si cette valeur est trop grande. |
int (System.Int32) |
| MinPoolSize | Pool de connexions Oracle | ODP.NET propriété. Spécifie le nombre minimal de connexions dans un pool de connexions ODP.NET. La valeur par défaut est 1. Cette propriété est utilisée pour l’optimisation des performances. | int (System.Int32) |
| UseOracleConnectionPool | Pool de connexions Oracle | ODP.NET propriété. Spécifie s’il faut utiliser le pool de connexions ODP.NET. La valeur par défaut est true, ce qui active le regroupement de connexions. L’adaptateur Oracle E-Business implémente le regroupement de connexions à l’aide du pool de connexions ODP.NET. | bool (System.Boolean) |
| ApplicationShortName | OracleEBS | Nom court d’une application Oracle E-Business Suite. Vous devez fournir le nom court de l’application lors de la définition du contexte d’application pour certaines API PL/SQL et certaines tables ou vues de base de données. Mais pourquoi devons-nous définir le contexte d’application uniquement pour certaines API PL/SQL et certaines tables ou vues de base de données ? - Les API PL/SQL, associées à la base de données Oracle et aux applications dans Oracle E-Business Suite, sont également disponibles sous le nœud « Affichage basé sur les artefacts » et « Vue Schema-Based » au moment de la conception lors de l’utilisation du complément Consume Adapter Service ou du plug-in Add Adapter Reference Service. Lors de l’exécution des API PL/SQL associées à la base de données Oracle, vous n’avez pas besoin de définir cette propriété de liaison. Toutefois, lors de l’exécution d’une API PL/SQL associée à une application Oracle E-Business Suite, vous devez définir le contexte de l’application en spécifiant une valeur valide pour cette propriété de liaison. - 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 sera disponible sous le nœud « Base de données » au moment de la conception lors de l’utilisation du complément Consume Adapter Service ou du plug-in Add Adapter Service Reference Plug-in. Toutefois, étant donné que ces tables sont associées à une application Oracle E-Business, pour toute opération sur ces tables, vous devez définir le contexte de l’application. Par conséquent, pour effectuer une opération sur une API PL/SQL et des tables ou vues de base de données appartenant à Oracle E-Business Suite, vous devez toujours spécifier le nom court de l’application. Important: Lors de l’exécution d’une API PL/SQL ou d’une opération sur des tables ou vues de base de données associées à une application Oracle E-Business Suite, vous devez également : - Définissez la propriété de liaison ClientCredentialType sur EBusiness, - Définissez les propriétés de liaison OracleUserName et OraclePassword pour spécifier les informations d’identification à connecter à Oracle E-Business Suite, et - Définissez la propriété de liaison OracleEBSResponsibilityName sur le nom de responsabilité approprié. En définissant ces propriétés de liaison, vous informez l’adaptateur que l’API PL/SQL, ou la table ou la vue de base de données sur laquelle vous travaillez, est associée à une application Oracle E-Business Suite. Par conséquent, la propriété de liaison ApplicationShortName devient obligatoire. Au contraire, si vous exécutez une API PL/SQL ou une opération sur des tables ou des vues de base de données associées à une application Oracle E-Business Suite et que vous ne définissez pas correctement les propriétés de liaison ClientCredentialType, OracleUserName, OraclePassword et OracleEBSResponsibilityName , l’adaptateur ignore l’ApplicationShortName, même s’il est défini, et suppose que l’API PL/SQL ou la table de base de données sur laquelle vous effectuez des opérations appartient à la base de données Oracle. |
string |
| OracleEBSOrganizationId | OracleEBS | Spécifie l’ID organization auquel appartient une application Oracle E-Business Suite. Cette propriété est facultative et n’est considérée que dans les cas suivants : - La propriété de liaison ClientCredentialType est définie sur EBusiness, et - Les propriétés de liaison OracleUserName, OraclePassword et OracleEBSResponsibilityName sont spécifiées de manière appropriée. |
string |
| OracleEBSResponsibilityKey | OracleEBS | Clé de responsabilité associée à l’utilisateur Oracle E-Business Suite. Contrairement au nom de responsabilité (propriété de liaison OracleEBSResponsibilityName ), la clé de responsabilité ne dépend pas du langage spécifié. Cela implique que vous n’avez pas besoin de spécifier des clés de responsabilité dans différentes langues en fonction de la valeur spécifiée dans la propriété de liaison Language lors de la définition du contexte MLS. Important : - La valeur spécifiée pour la propriété de liaison OracleEBSResponsibilityKey remplace la valeur spécifiée pour la propriété de liaison OracleEBSResponsibilityName . - Si vous effectuez des opérations sur les données dans plusieurs langues et que vous ne souhaitez pas spécifier un nom de responsabilité dans chaque langue, vous devez spécifier une valeur pour cette propriété de liaison lors de l’exécution d’opérations sur les tables d’interface, en sélectionnant des valeurs à partir des vues d’interface ou en exécutant un programme ou un ensemble de requêtes simultanés. Bien sûr, vous pouvez toujours utiliser cette propriété de liaison même si vous travaillez uniquement avec des données en anglais. |
string |
| OracleEBSResponsibilityName | OracleEBS | Nom de la responsabilité associée à l’utilisateur Oracle E-Business Suite. Le nom de responsabilité dépend de la langue spécifiée. Cela implique que si vous définissez le contexte MLS en spécifiant une valeur pour la propriété de liaison Language , la valeur de la propriété de liaison OracleEBSResponsibilityName doit être spécifiée dans le même langage que celui spécifié pour la propriété de liaison Language . Par exemple, si vous définissez la propriété de liaison Language sur Espagnol, le nom de responsabilité que vous spécifiez pour la propriété de liaison OracleEBSResponsibilityName doit également être en espagnol. Important: Vous devez spécifier une valeur pour cette propriété de liaison lors de l’exécution d’opérations sur des tables d’interface, de la sélection de valeurs à partir des vues d’interface ou de l’exécution d’un programme simultané. |
string |
| OraclePassword | OracleEBS | - Si la propriété de liaison ClientCredentialType est définie sur Database, cette propriété spécifie le mot de passe d’un utilisateur de base de données Oracle. - Si la propriété de liaison ClientCredentialType est définie sur EBusiness, cette propriété spécifie le mot de passe d’un utilisateur Oracle E-Business Suite. L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour la propriété de liaison OraclePassword lorsqu’elle se connecte à Oracle E-Business Suite. Le mot de passe est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du mot de passe ou si vous souhaitez entrer un mot de passe contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles. Important : - Lors de l’exécution d’opérations sur des tables d’interface, la sélection de valeurs dans les vues d’interface, l’exécution d’un programme simultané ou l’exécution d’une API PL/SQL associée à une application Oracle E-Business Suite, vous devez définir la propriété de liaison ClientCredentialType sur EBusiness , puis spécifier un mot de passe valide pour vous connecter à Oracle E-Business Suite. - La propriété de liaison OraclePassword n’est pas disponible dans le fichier de liaison (fichier XML) ni dans le fichier app.config généré à la suite de l’utilisation du complément De projet BizTalk du service Consume Adapter ou du plug-in Visual Studio Add Adapter Service Reference. |
string |
| OracleUserName | OracleEBS | - Si la propriété de liaison ClientCredentialType est définie sur Database, cette propriété spécifie le nom d’utilisateur pour l’authentification sur la base de données Oracle. - Si la propriété de liaison ClientCredentialType est définie sur EBusiness, cette propriété spécifie le nom d’utilisateur pour l’authentification sur Oracle E-Business Suite. L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour la propriété de liaison OracleUserName lorsqu’elle se connecte à Oracle E-Business Suite. Le nom d’utilisateur est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du nom d’utilisateur ou si vous souhaitez entrer un nom d’utilisateur contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles. Important: Lors de l’exécution d’opérations sur des tables d’interface, la sélection de valeurs dans les vues d’interface, l’exécution d’un programme simultané ou l’exécution d’une API PL/SQL associée à une application Oracle E-Business Suite, vous devez définir la propriété de liaison ClientCredentialType sur EBusiness , puis spécifier un nom d’utilisateur valide pour vous connecter à Oracle E-Business Suite. |
string |
| PolledDataAvailableStatement | Interrogation | Spécifie l’instruction SELECT exécutée pour déterminer si des données sont disponibles pour l’interrogation d’une table spécifique. L’instruction spécifiée doit retourner un jeu de résultats composé de lignes et de colonnes. La valeur de la première cellule du jeu de résultats indique si l’adaptateur exécute la valeur spécifiée pour la propriété de liaison PollingInput . Si la première cellule du résultat contient une valeur positive, l’adaptateur exécute l’instruction d’interrogation. Par exemple, une instruction valide pour cette propriété de liaison sera :Select * from <table_name>Pointe: Si vous souhaitez que l’adaptateur poursuive l’interrogation, que la table interrogée ait ou non des données, vous pouvez spécifier la valeur de cette propriété de liaison comme Select 1 FROM DUAL.Note: Vous ne devez pas spécifier de procédures stockées pour cette propriété de liaison. En outre, cette instruction ne doit pas modifier la base de données Oracle sous-jacente. |
string |
| PollingAction | Interrogation | Spécifie l’action pour l’opération d’interrogation. Vous pouvez déterminer l’action d’interrogation pour une opération spécifique à partir des métadonnées que vous générez pour l’opération à l’aide du complément Consume Adapter Service. | string |
| PollingInput | Interrogation | Spécifie l’instruction d’interrogation. Vous pouvez spécifier une instruction SELECT simple ou une procédure stockée pour l’interrogation. Si vous souhaitez interroger une table ou une vue, vous devez spécifier une instruction SELECT pour cette propriété de liaison. Si vous souhaitez interroger à l’aide d’une procédure stockée, vous devez spécifier l’intégralité du message de demande pour cette propriété de liaison. Le message de demande doit être le même que celui que vous envoyez à l’adaptateur pour appeler la procédure stockée en tant qu’opération sortante. Note: L’instruction SQL ou la procédure stockée spécifiée pour cette propriété de liaison est exécutée uniquement si l’instruction exécutée par la propriété de liaison PolledDataAvailableStatement retourne certaines données. Important: L’adaptateur Oracle E-Business exécute l’instruction d’interrogation et l’instruction post-interrogation (si spécifiée) à l’intérieur d’une transaction Oracle. Si vous utilisez une instruction SELECT dans la propriété de liaison PollingInput , nous vous recommandons de spécifier une clause FOR UPDATE dans votre instruction SELECT. Cela garantit que les enregistrements sélectionnés sont verrouillés pendant la transaction et que l’instruction post-interrogation peut effectuer toutes les mises à jour requises sur les enregistrements sélectionnés. |
string |
| PollingInterval | Interrogation | Spécifie l’intervalle d’interrogation traité, c’est-à-dire l’intervalle en secondes auquel l’adaptateur Oracle E-Business exécute l’instruction que vous avez spécifiée pour la propriété de liaison PollingInput sur la base de données Oracle. La valeur par défaut est 30. L’intervalle d’interrogation est utilisé par l’adaptateur pour les éléments suivants : - Intervalle de temps entre les sondages successifs. Cet intervalle est utilisé pour exécuter les requêtes de sondage et de post-interrogation. Si ces requêtes sont exécutées dans l’intervalle spécifié, l’adaptateur est mis en veille pendant la durée restante dans l’intervalle. - Valeur de délai d’expiration de la transaction d’interrogation. Cette valeur doit être définie suffisamment grande pour inclure l’heure d’exécution de l’instruction d’interrogation, l’heure d’exécution de l’instruction post-interrogation (si spécifiée) et l’heure de réception de la réponse de l’application cliente pour valider la transaction. Si l’application cliente envoie une réponse avant l’expiration de l’intervalle d’interrogation, l’adaptateur valide la transaction et attend que l’intervalle d’interrogation soit atteint pour exécuter l’interrogation suivante. Si l’application cliente retourne une erreur, l’adaptateur met fin à la transaction. Si l’intervalle d’interrogation expire avant que l’application cliente envoie la réponse, la transaction expire. |
int (System.Int32) |
| PollWhileDataFound | Interrogation | Spécifie si l’adaptateur Oracle E-Business ignore l’intervalle d’interrogation et interroge continuellement la base de données Oracle, si des données sont disponibles dans la table interrogée. Si aucune donnée n’est disponible dans la table, l’adaptateur revient à exécuter l’instruction SQL à l’intervalle d’interrogation spécifié. La valeur par défaut est false. Envisagez un scénario où l’intervalle d’interrogation est défini sur 60 secondes et où l’instruction spécifiée pour PolledDataAvailableStatement retourne que les données sont disponibles pour l’interrogation. L’adaptateur exécute ensuite l’instruction spécifiée pour la propriété de liaison PollingInput . En supposant que l’adaptateur ne prend que 10 secondes pour exécuter l’instruction, il doit maintenant attendre 50 secondes avant d’exécuter à nouveau PolledDataAvailableStatement , puis exécuter ensuite l’instruction d’interrogation. Au lieu de cela, pour optimiser les performances, vous pouvez définir la propriété de liaison PollWhileDataFound sur true afin que l’adaptateur puisse commencer à exécuter le cycle d’interrogation suivant dès que le cycle d’interrogation précédent se termine. Note: Cette propriété de liaison s’applique à la fois à l’interrogation sur des tables et des vues et à l’interrogation à l’aide d’une procédure stockée. |
string |
| PostPollStatement | Interrogation | Spécifie un bloc d’instructions qui est exécuté après l’exécution de l’instruction spécifiée par la propriété de liaison PollingInput . La valeur par défaut est null ; aucune instruction post-sondage n’est exécutée. L’instruction post-interrogation s’exécute à l’intérieur de la transaction d’interrogation. Deux utilisations courantes de l’instruction post-sondage sont les suivantes : - Mettez à jour une colonne dans les lignes retournées dans l’instruction d’interrogation pour indiquer qu’elles ont été traitées et doivent être exclues des requêtes d’interrogation suivantes. - Déplacer les enregistrements traités vers une autre table. Important: Si une instruction post-sondage est spécifiée, PollingInterval doit être défini suffisamment grand pour que l’instruction post-sondage se termine avant l’expiration de l’intervalle. Pour plus d’informations sur l’utilisation des propriétés de liaison dans un scénario d’interrogation, consultez Vue d’ensemble des notifications modifiées de données basées sur l’interrogation. |
string |
| SkipNilNodes | Comportement de l’heure d’exécution | Spécifie si l’adaptateur Oracle E-Business ignore l’insertion ou la mise à jour des valeurs pour les nœuds marqués comme « nil » dans le xml de requête. Cette propriété de liaison s’applique à l’insertion ou à la mise à jour d’enregistrements dans une table et aux paramètres de type RECORD dans les procédures stockées. La valeur par défaut est true, ce qui signifie que l’adaptateur ignore les valeurs de passage pour les nœuds marqués comme « nil ». Dans ce cas, la valeur par défaut dans Oracle (si spécifiée) est prise en compte pour les nœuds marqués comme « nil ». Si la valeur est false, l’adaptateur transmet explicitement une valeur null pour ces nœuds. Remarque : - Pour les nœuds qui ne sont pas présents dans le code XML de requête, l’adaptateur ignore toujours les valeurs de passage, quelle que soit la valeur de la propriété de liaison SkipNilNodes . - Pour les tables PL/SQL de RECORDS, l’adaptateur transmet toujours une valeur Null pour les nœuds qui sont marqués comme « nil » ou qui ne sont pas présents dans le XML de requête, quelle que soit la valeur de la propriété de liaison SkipNilNodes . L’exemple suivant explique la différence dans la configuration de l’adaptateur en fonction de la valeur que vous avez définie pour cette propriété de liaison. Supposons qu’une requête XML ressemble à ce qui suit : <EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>Si SkipNilNodes a la valeur true, l’adaptateur exécute la commande suivante : INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);Si SkipNilNodes a la valeur false, l’adaptateur exécute la requête suivante : INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);Notez que dans la deuxième instruction, l’adaptateur insère explicitement une valeur null pour le paramètre « SAL ». |
bool (System.Boolean) |
| GeneratedUserTypesAssemblyFilePath | Génération de type .NET UDT – Temps de conception | Spécifie le nom et le chemin de la DLL générée par l’adaptateur, tout en générant des métadonnées, contenant tous les UDT utilisés dans les métadonnées. Vous devez spécifier un nom DE DLL si vous générez des métadonnées pour des packages, des procédures stockées ou des fonctions qui utilisent des UDT. La spécification du nom de la DLL est facultative pour les tables et les vues qui ont des UDT. La DLL générée est enregistrée au même emplacement que l’exécutable. Cette propriété de liaison est requise uniquement lors de la génération de métadonnées. Remarque : - Vous ne devez spécifier qu’un seul nom de fichier. Pour tous les UDT dans les métadonnées, l’adaptateur génère un seul fichier avec le nom donné. Si vous ne spécifiez pas de nom, l’adaptateur génère la DLL avec un nom GUID. - Cette propriété de liaison n’est pas disponible dans BizTalk Server lors de la configuration d’un port de réception ou d’envoi WCF-OracleEBS. |
string |
| GeneratedUserTypesAssemblyKeyFilePath | Génération de type .NET UDT – Temps de conception | Spécifie le nom et le chemin du fichier de clé que l’adaptateur utilise pour créer un assembly fortement typé. Cette propriété de liaison est facultative et n’est requise que lors de la génération de métadonnées. Note: Cette propriété de liaison n’est pas disponible dans BizTalk Server lors de la configuration d’un port de réception ou d’envoi WCF-OracleEBS. |
string |
| UserAssembliesLoadPath | Génération de type .NET UDT – Durée d’exécution | Spécifie le nom des DLL, séparés par un point-virgule, que l’adaptateur crée lors de la génération de métadonnées. Ces DLL sont enregistrées à l’emplacement que vous avez spécifié pour la propriété de liaison GeneratedUserTypesAssemblyFilePath lors de la génération de métadonnées. Vous devez copier manuellement ces DLL vers les emplacements suivants : - Pour les projets BizTalk : copiez les DLL au même emplacement que BTSNTSvc.exe. Par BizTalk Server, il est généralement disponible sous <le lecteur> d’installation :\Program Files\Microsoft BizTalk Server. - Pour les projets .NET : copiez les DLL dans le dossier \bin\Development de votre dossier de projet .NET. Cette propriété de liaison est requise uniquement lors de l’envoi et de la réception de messages pour effectuer des opérations sur Oracle E-Business Suite. |
string |
| AcceptCredentialsInUri | Non mis en évidence par le complément Consume Adapter Service ou le plug-in Add Adapter Service Reference. | Spécifie si l’URI de connexion Oracle E-Business Suite peut contenir des informations d’identification utilisateur. La valeur par défaut est false, ce qui désactive les informations d’identification utilisateur dans l’URI de connexion. Si AcceptCredentialsInUri est false et que l’URI de connexion Oracle contient des informations d’identification utilisateur, l’adaptateur Oracle E-Business lève une exception. Vous pouvez définir AcceptCredentialsInUri sur true si vous devez spécifier des informations d’identification dans l’URI. Pour plus d’informations, consultez Créer l’URI de connexion Oracle E-Business Suite. | bool (System.Boolean) |
Comment définir les propriétés de liaison ?
Vous pouvez définir les propriétés de liaison lorsque vous spécifiez une connexion à Oracle E-Business Suite. Pour plus d’informations sur la définition des propriétés de liaison lorsque vous :
Utilisez le complément De projet BizTalk du service d’adaptateur consommer ou le plug-in Visual Studio Add Adapter Service ( Ajouter une référence au service d’adaptateur). Consultez entrer la description du lien ici.
Configurez un port d’envoi ou un port de réception (emplacement) dans une solution BizTalk Server, consultez Configuration manuelle d’une liaison de port physique à l’adaptateur Oracle E-Business.
Utilisez le modèle de canal WCF dans une solution de programmation, consultez Se connecter à Oracle E-Business Suite dans Visual Studio.
Utilisez le modèle de service WCF dans une solution de programmation, consultez Se connecter à Oracle E-Business Suite dans Visual Studio.
Important
Lors de l’utilisation du complément de projet BizTalk du service Consume Adapter ou du plug-in Visual Studio Add Adapter Service, si vous ne spécifiez pas de valeur pour une propriété de liaison de type chaîne et dont la valeur par défaut est null, cette propriété de liaison ne sera pas disponible dans le fichier de liaison (fichier XML) ou le fichier app.config respectivement. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier de liaison ou le fichier app.config, si nécessaire.
Toutefois, la propriété de liaison OraclePassword n’est pas disponible dans le fichier de liaison ou dans le fichier app.config même si vous spécifiez une valeur pour cette propriété de liaison lors de l’utilisation du complément BizTalk Project Du service Consume Adapter ou du plug-in Visual Studio Add Adapter Service.