Configurer le contexte d’application à l’aide des propriétés de contexte de message dans Oracle E-Business Suite
Pour effectuer des opérations sur les artefacts Oracle E-Business Suite à l’aide de l’adaptateur Oracle E-Business, vous devez définir le contexte de l’application de manière appropriée. Vous pouvez définir le contexte de l’application des manières suivantes :
En spécifiant les propriétés de liaison exposées par l’adaptateur. Pour plus d’informations, consultez Définir le contexte d’application.
En utilisant les propriétés de contexte de message exposées par l’adaptateur. Vous devez tenir compte des éléments suivants lors de la définition du contexte d’application à l’aide des propriétés de contexte de message.
Vous pouvez définir des valeurs uniquement pour ApplicationShortName, OrganizationID, ResponsibilityKey et ResponsibilityName à l’aide des propriétés de contexte de message. Pour le nom d’utilisateur et le mot de passe, vous devez utiliser les propriétés de liaison. La valeur spécifiée pour la propriété de contexte de message ResponsibilityKey remplace la valeur spécifiée pour la propriété de contexte de message ResponsibilityName .
Si vous définissez le contexte d’application à l’aide des propriétés de liaison et des propriétés de contexte de message, les valeurs spécifiées pour les propriétés de contexte de message sont prioritaires et remplacent les valeurs spécifiées pour les propriétés de liaison. Toutefois, par exemple, si vous spécifiez le nom court de l’application en tant que propriété de contexte de message et que l’ID de organization et le nom de responsabilité en tant que propriétés de liaison, seule la valeur du nom court de l’application est extraite de la propriété de contexte de message. Les autres sont sélectionnés à partir des propriétés de liaison appropriées.
Pourquoi utiliser des propriétés de contexte de message plutôt que des propriétés de liaison pour définir le contexte d’application ? Si vous définissez le contexte de l’application à l’aide de propriétés de liaison, le port d’envoi WCF-Custom de l’adaptateur Oracle E-Business ne peut être utilisé que pour l’ID de organization, la responsabilité et l’application que vous avez spécifiés pour les propriétés de liaison. Au contraire, si vous utilisez la propriété de contexte de message, vous pouvez configurer un port d’envoi « générique » WCF-Custom et définir le contexte d’application au niveau du message.
Les clients d’adaptateur doivent définir les propriétés de contexte de message sur le message envoyé à Oracle E-Business Suite pour appeler une opération sur Oracle E-Business Suite. Les messages dans BizTalk Server sont immuables. Par conséquent, les clients doivent d’abord créer un message à partir du message existant, puis définir les propriétés de contexte du message sur le nouveau message. Pour la procédure décrite dans cette section, supposons que le message existant est appelé Demande et que le nouveau message est appelé New_Request.
Définir les propriétés de contexte de message pour les applications BizTalk
Ouvrez le projet BizTalk dans Visual Studio.
Dans Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter des références.
Dans la boîte de dialogue Ajouter une référence , cliquez sur l’onglet Parcourir , puis accédez à l’emplacement où la DLL de schéma de propriété BizTalk pour l’adaptateur Oracle E-Business est disponible.
Cette DLL,
Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.dll
, est installée par le pack d’adaptateurs BizTalk sur le < lecteur >d’installation :\Program Files\Microsoft BizTalk Adapter Pack\bin.Sélectionnez la DLL, puis cliquez sur Ajouter.
Dans l’orchestration BizTalk, ajoutez un message , New_Request. Pour la propriété Type de message , veillez à sélectionner le même type que le message de demande existant.
Avant la forme Envoyer à l’aide de laquelle le message est envoyé au port d’envoi, ajoutez une forme Construire un message et une forme d’affectation de message.
Double-cliquez sur la forme Affectation de message pour ouvrir l’Éditeur d’expression BizTalk.
Dans l’Éditeur d’expressions BizTalk, ajoutez ce qui suit, puis cliquez sur OK :
New_Request = Request; New_Request(Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.ApplicationShortName) = "AR"; New_Request(Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.ResponsibilityKey) = "RECEIVABLES_VISION_OPERATIONS"; New_Request(Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.ResponsibilityName) = "Receivables, Vision Operations (USA)"; New_Request(Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.OrganizationId) = "204";
Important
La valeur spécifiée pour la propriété de contexte de message ResponsibilityKey remplace la valeur spécifiée pour la propriété de contexte de message ResponsibilityName .
Assurez-vous que le traitement ultérieur de l’orchestration est effectué à l’aide du message New_Request .
Avant de pouvoir déployer cette orchestration dans BizTalk Server, vous devez ajouter la référence d’assembly pour
Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.dll
dans l’application BizTalk où vous allez déployer l’orchestration. Pour déployer un assembly dans BizTalk Server :Démarrez la console Administration BizTalk Server.
Dans l’arborescence de la console, développez BizTalk Group, puis Applications, puis l’application à laquelle vous souhaitez ajouter un assembly BizTalk.
Cliquez avec le bouton droit sur Ressources, pointez sur Ajouter, puis cliquez sur Assemblys BizTalk.
Dans la boîte de dialogue Ajouter des ressources , cliquez sur Ajouter, accédez au dossier contenant le fichier d’assembly BizTalk, qui est <le lecteur> d’installation :\Program Files\Microsoft BizTalk Adapter Pack\bin. Sélectionnez le
Microsoft.Adapters.OracleEBS.BiztalkPropertySchema.dll
fichier, puis cliquez sur Ouvrir.Sous l’onglet Options , spécifiez les options d’installation de l’assembly BizTalk sur le global assembly cache (GAC), puis cliquez sur OK.
Définir la langue pour l’exécution d’opérations
L’adaptateur Oracle E-Business prend en charge la fonctionnalité MLS (Multi-Language Support) d’Oracle E-Business Suite et vous permet de spécifier une langue lors de l’exécution d’opérations. L’adaptateur expose la propriété de contexte de message Language pour spécifier une langue pour effectuer des opérations.
La valeur spécifiée pour la propriété de contexte de message Language remplace la valeur de la propriété de liaison Language sous la propriété de liaison MlsSettings . Pour plus d’informations sur la propriété de liaison MlsSettings , consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour Oracle E-Business Suite.