Définir le contexte de l’application

Dans l’adaptateur Microsoft BizTalk pour Oracle E-Business Suite, la définition du contexte d’application est obligatoire pour certains artefacts Oracle E-Business Suite (tables d’interface, vues d’interface, programmes simultanés et ensembles de requêtes) avant de pouvoir effectuer des opérations sur ces derniers. L’adaptateur Oracle E-Business ne vous permet pas d’effectuer des opérations sur ces artefacts tant que vous n’avez pas défini le contexte de l’application. Toutefois, pour les artefacts de la base de données Oracle sous-jacente, il appartient à l’utilisateur de définir ou non le contexte de l’application.

Qu’est-ce que le contexte d’application ?

Le contexte d’application est un ensemble d’éléments associés à un artefact dans Oracle E-Business Suite qui implémente les préférences utilisateur et le contrôle d’accès sur l’artefact. Le contexte d’application se compose des éléments suivants :

• Nom d’utilisateur : utilisateur qui peut se connecter à Oracle E-Business Suite.

• Responsabilité : une responsabilité est un niveau d’accès dans Oracle E-Business Suite qui permet aux utilisateurs d’accéder uniquement aux données et fonctions appropriées à leurs rôles dans un organization. Les responsabilités peuvent autoriser l’accès à une application spécifique, à des unités d’exploitation, à un ensemble de livres et à une liste restreinte de fenêtres, de fonctions et d’autres responsabilités. En vertu de l’attribution de responsabilités à un utilisateur, vous pouvez accorder/restreindre l’accès de l’utilisateur dans Oracle E-Business Suite.

• ID d’organisation : Oracle E-Business Suite prend en charge la configuration de plusieurs organisations. Ces différentes organisations sont identifiées de manière unique par une valeur, l’ID d’organisation, dans la colonne Org_ID de la table dans Oracle E-Business Suite qui stocke des informations sur ces organisations. En vertu de l’attribution d’une responsabilité à un organization ou de la sélection explicite d’un organization, vous pouvez accorder ou restreindre l’accès d’un utilisateur à un organization.

  Pour plus d’informations sur la responsabilité, plusieurs organisations et l’ID d’organisation dans Oracle E-Business Suite, recherchez le centre d’aide Oracle.

Définition du contexte d’application

Lorsque l’adaptateur Oracle E-Business se connecte à la base de données sous-jacente dans Oracle E-Business Suite, le contexte d’application des artefacts Oracle E-Business Suite n’est pas établi ou initialisé dans l’adaptateur. Vous pouvez initialiser ou définir le contexte d’application pour ces artefacts dans l’adaptateur Oracle E-Business à l’aide de l’une des options suivantes :

• Propriétés de liaison : l’adaptateur Oracle E-Business expose les propriétés de liaison suivantes pour définir le contexte de l’application : OracleEBSOrganizationId, OracleUserName, OraclePassword, OracleEBSResponsibilityKey, OracleEBSResponsibilityName et ApplicationShortName. Vous n’avez pas besoin de spécifier des valeurs pour toutes ces propriétés de liaison afin de définir le contexte d’application pour différents artefacts. Pour plus d’informations sur les propriétés de liaison requises pour définir le contexte d’application pour un artefact, consultez Propriétés de liaison pour la définition du contexte d’application pour divers artefacts plus loin dans cette rubrique.

• Propriétés du contexte de message : l’adaptateur Oracle E-Business expose les propriétés de contexte de message suivantes pour définir le contexte de l’application : ApplicationShortName, OrganizationID, ResponsibilityKey et ResponsibilityName. Pour spécifier le nom d’utilisateur et le mot de passe, vous devez utiliser les propriétés de liaison. Pour plus d’informations sur la définition du contexte d’application à l’aide des propriétés de contexte de message, consultez Configurer le contexte d’application à l’aide des propriétés du contexte de message.

Ordre de priorité (propriétés de liaison et propriétés de contexte de message)

Si vous définissez le contexte de l’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 les autres 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 et le reste est sélectionné parmi les propriétés de liaison appropriées.

Ordre de priorité pour le nom court de l’application

Lors de la définition du contexte de l’application, le nom court de l’application est utilisé dans l’ordre de priorité suivant (du plus élevé au plus bas) :

• Nom court de l’application spécifié dans la propriété de contexte de message ApplicationShortName .

• Nom court de l’application spécifié dans l’action SOAP (pour les tables d’interface, les vues d’interface, les programmes simultanés et les jeux de requêtes uniquement).

• Nom court de l’application spécifié dans la propriété de liaison ApplicationShortName .

  Toutefois, pour les tables d’interface, les vues d’interface, les programmes simultanés et les ensembles de demandes, cet ordre de priorité s’applique uniquement lors de la définition du contexte d’application. Pour identifier les tables d’interface, les vues d’interface, les programmes simultanés et les jeux de requêtes, le nom court de l’application dans l’action SOAP est utilisé.

  Ordre de priorité pour la clé de responsabilité et le nom de responsabilité

  Lors de la définition du contexte de l’application, la clé de responsabilité et le nom de responsabilité sont utilisés dans l’ordre de priorité suivant (du plus élevé au plus bas) :

• Clé de responsabilité spécifiée dans la propriété de contexte du message ResponsibilityKey .

• Nom de responsabilité spécifié dans la propriété de contexte de message ResponsibilityName .

• Clé de responsabilité spécifiée dans la propriété de liaison OracleEBSResponsibilityKey .

• Nom de responsabilité spécifié dans la propriété de liaison OracleEBSResponsibilityName .

Définition du contexte d’application pour les tables d’interface, les vues d’interface, les programmes simultanés et les jeux de requêtes (obligatoire)

Vous devez définir le contexte de l’application avant d’effectuer des opérations sur les tables d’interface, les vues d’interface, les programmes simultanés et les ensembles de demandes dans l’adaptateur Oracle E-Business. Pour ce faire, vous devez fournir des valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message, comme spécifié précédemment.

Définition du contexte d’application pour les API, procédures, fonctions, tables et vues PL/SQL

• API PL/SQL : l’adaptateur Oracle E-Business expose les API PL/SQL associées à la base de données Oracle ainsi qu’à l’application Oracle E-Business Suite. Bien qu’il soit facultatif de définir le contexte d’application pour les API PL/SQL associées à la base de données Oracle, il est obligatoire de définir le contexte d’application pour les API PL/SQL associées à l’application Oracle E-Business Suite.

• Procédures et fonctions : il n’est pas obligatoire de définir le contexte de l’application pour effectuer des opérations sur les procédures et les fonctions dans la base de données Oracle.

• Tables et vues : il n’est pas obligatoire de définir le contexte de l’application pour effectuer des opérations sur les tables et les vues dans la base de données Oracle. Toutefois, pour l’application Oracle E-Business Suite personnalisée, 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 s’affiche avec les tables de base de données dans l’adaptateur Oracle E-Business. É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.

  Pour définir le contexte d’application pour ces artefacts, vous devez fournir les valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message, comme spécifié précédemment.

Définition du contexte d’application pour les opérations Poll, ExecuteNonQuery, ExecuteReader, ExecuteScalar et Composite

Outre les artefacts, vous pouvez également définir le contexte d’application pour diverses opérations effectuées sur ces artefacts.

• Pour définir le contexte de l’application pour l’opération d’interrogation, vous pouvez uniquement utiliser les propriétés de liaison spécifiées précédemment. Pour définir le contexte de l’application, vous devez fournir les valeurs appropriées pour les propriétés de liaison applicables à l’artefact sur lequel l’opération d’interrogation est effectuée. Par exemple, si l’opération De sondage est effectuée sur une table d’interface, vous devez spécifier des valeurs pour les propriétés de liaison de la table d’interface.

• Pour définir le contexte d’application pour les opérations ExecuteNonQuery, ExecuteReader et ExecuteScalar, vous devez fournir les valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message, comme spécifié précédemment. Pour définir le contexte d’application pour ces opérations, vous devez fournir des valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message applicables à l’artefact sur lequel les opérations sont effectuées.

• Pour définir le contexte d’application pour les opérations composites, vous devez fournir les valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message, comme spécifié précédemment. Pour définir le contexte d’application pour les opérations composites, vous devez fournir les valeurs appropriées pour les propriétés de liaison ou les propriétés de contexte de message applicables aux opérations individuelles. Par exemple, si une opération composite contient deux opérations : l’une sur la table d’interface et l’autre sur la table de base de données, vous devez spécifier des valeurs pour les propriétés de liaison ou les propriétés de contexte de message pour la table d’interface, ainsi que les propriétés de liaison ou les propriétés de contexte de message pour la table de base de données.

  Important

  Pour toutes ces opérations, il est obligatoire de définir le contexte de l’application si l’opération est effectuée sur un artefact dans Oracle E-Business Suite (table d’interface, vue d’interface, programmes simultanés ou ensembles de demandes). Si l’opération est effectuée sur un artefact dans la base de données sous-jacente, il n’est pas obligatoire de définir le contexte de l’application. Par exemple, si vous effectuez l’opération Interroger sur une table d’interface, il est obligatoire de définir le contexte de l’application, tandis que si l’opération d’interrogation est effectuée sur une table, il n’est pas obligatoire de définir le contexte de l’application.

Définition de 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 liaison Language sous la propriété de liaison MlsSettings et 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.

Propriétés de liaison pour la définition du contexte d’application pour divers artefacts

Le tableau suivant fournit des informations sur les propriétés de liaison pour lesquelles vous devez spécifier les valeurs appropriées pour définir le contexte d’application pour différents artefacts :

√* = Facultatif

Pour plus d’informations sur chacune de ces propriétés de liaison, consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour Oracle E-Business Suite.

Voir aussi

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