Partager via

Opérations sur les programmes concurrents

  • Article

Les programmes simultanés dans Oracle E-Business Suite sont exposés en tant qu’opérations dans l’adaptateur Microsoft BizTalk pour Oracle E-Business Suite. En plus des programmes simultanés spécifiques à une application Oracle, l’adaptateur Oracle E-Business présente également les trois opérations standard suivantes : Get_Status, Wait_For_Request et Submit_Request. Cela implique que si une application Oracle a deux programmes simultanés, cinq opérations sont exposées : une pour chaque programme simultané et trois pour les opérations standard.

Pour obtenir des informations sur :

Important

Vous devez définir le contexte des applications pour les programmes simultanés dans l’adaptateur Oracle E-Business avant de pouvoir effectuer des opérations sur des programmes simultanés. Cela est dû au fait que la définition du contexte des applications facilite les transactions sécurisées dans Oracle E-Business Suite en définissant les préférences de l’utilisateur (telles que les paramètres de responsabilité, de organization et de langue) et le contrôle d’accès pour un artefact. Pour plus d’informations sur le contexte des applications et la façon de le définir, consultez Définir lecontexte d’application d’un jeu de contextes d’application.

Les sections suivantes fournissent des informations sur les opérations exposées par l’adaptateur Oracle E-Business pour les programmes simultanés.

<> Concurrent_Program_Name, opération

Comme mentionné précédemment, il y aura autant d’opérations <Concurrent_Program_Name> que le nombre de programmes simultanés dans une application Oracle A. L’opération <Concurrent_Program_Name> prend cinq paramètres standard : trois de type complexe et deux de type simple.

Notes

Pour les programmes simultanés qui n’exposent pas leurs métadonnées, l’adaptateur Oracle E-Business expose 100 paramètres facultatifs pour chacun de ces programmes simultanés. Pour appeler correctement ces programmes simultanés, l’utilisateur doit consulter la documentation Oracle E-Business Suite pour déterminer les paramètres d’un programme simultané qui nécessite une valeur, puis les spécifier. L’importation de journaux (nom réel : GLLEZL) dans l’application Registre général est un exemple de programme simultané.

Paramètres de type complexe

  • SetOptions : vous permet de définir des options pour le programme simultané avant d’envoyer la demande. SetOptions prend les options suivantes en tant que paramètres :

    • Implicite : indique s’il faut afficher la demande simultanée dans le formulaire Demandes simultanées de l’utilisateur dans Oracle E-Business Suite. Vous pouvez spécifier l’une des quatre valeurs suivantes : Non, Oui, Erreur ou Avertissement. Si vous spécifiez Non, les demandes sont affichées dans le formulaire Demandes simultanées de l’utilisateur dans Oracle E-Business Suite. La spécification de Oui implique que la demande ne peut être consultée qu’à partir du formulaire Demandes simultanées privilégiées de l’administrateur système. La spécification d’une erreur entraîne l’affichage de la demande dans le formulaire Demandes simultanées de l’utilisateur uniquement en cas d’échec. La spécification de l’avertissement entraîne l’affichage de la demande dans le formulaire Demandes simultanées de l’utilisateur uniquement en cas d’avertissement ou d’erreur.

    • Protégé : indique si la demande simultanée est protégée contre les mises à jour effectuées à l’aide du formulaire Demandes simultanées dans Oracle E-Business Suite. Vous pouvez spécifier Oui (protégé) ou Non (non protégé).

    • Langue : indique la langue NLS (National Language Support). Si aucune valeur n’est spécifiée, la langue actuelle est définie par défaut.

    • Territory : indique le territoire de langue. Si aucune valeur n’est spécifiée, elle est définie par défaut sur le territoire de langue actuel.

    • ContinueOnFail : indique si la soumission simultanée de la demande doit continuer ou lever une exception en cas d’échec de SetOptions . Vous pouvez spécifier True (continuer) ou False (lever une exception).

  • SetPrintOptions : vous permet de définir les options d’impression du programme simultané avant d’envoyer la demande. SetPrintOptions prend les options suivantes en tant que paramètres :

    • Imprimante : indique le nom de l’imprimante où la sortie de la demande simultanée doit être envoyée. Vous ne pouvez pas remplacer cette option d’impression si elle est déjà définie dans le formulaire Programmes simultanés dans Oracle E-Business Suite.

    • Style : indique le style d’impression utilisé pour imprimer la sortie de la demande simultanée. Par exemple, vous pouvez spécifier l’orientation (Paysage ou Portrait). Si le style d’impression est déjà défini dans le formulaire Programmes simultanés d’Oracle E-Business Suite et que la zone Style requis case activée est sélectionnée, vous ne pouvez pas remplacer cette option d’impression.

    • Copies : indique le nombre de copies à imprimer de la sortie de la demande simultanée.

    • SaveOutput : indique si le fichier de sortie doit être enregistré ou non. Vous pouvez indiquer Oui ou Non.

    • PrintTogether : applicable uniquement aux demandes qui contiennent des sous-requêtes. Indique comment la sortie des sous-requêtes est imprimée. Si vous spécifiez Y, la sortie des sous-requêtes est imprimée uniquement une fois toutes les sous-demandes terminées. Si vous spécifiez N, la sortie de chaque sous-requête est imprimée à mesure qu’elle se termine.

    • ContinueOnFail : indique si la soumission simultanée de la demande doit continuer ou lever une exception en cas d’échec de SetPrintOptions . Vous pouvez spécifier True (continuer) ou False (lever une exception).

  • SetRepeatOptions : vous permet de définir les options de répétition pour le programme simultané avant d’envoyer la demande. SetRepeatOptions prend les options suivantes en tant que paramètres :

    • RepeatTime : indique l’heure de la journée pour répéter la requête simultanée.

    • RepeatInterval : ce paramètre s’applique uniquement lorsque RepeatTime a la valeur NULL. Indique l’intervalle entre les renvois de la requête. Utilisez cette option avec RepeatUnit pour spécifier le délai entre les réadmissions.

    • RepeatUnit : ce paramètre s’applique uniquement lorsque RepeatTime a la valeur NULL. Unité de temps utilisée avec RepeatInterval pour spécifier le temps entre les nouvelles soumissions de la requête. Vous pouvez spécifier minutes, heures, jours ou mois.

    • RepeatType : ce paramètre s’applique uniquement lorsque RepeatTime a la valeur NULL. Indique si l’intervalle de répétition est appliqué après le « début » d’une exécution de requête simultanée ou après la « fin » d’une exécution de requête simultanée.

    • RepeatEndTime : indique la date et l’heure d’arrêt du renvoi de la demande simultanée.

    • ContinueOnFail : indique si la soumission de demande simultanée doit continuer ou lever une exception dans le cas de SetRepeatOptions. Vous pouvez spécifier True (continuer) ou False (lever une exception).

    Paramètres de type simple

  • Description : description de la demande simultanée.

  • StartTime : indique l’heure à laquelle la requête simultanée doit commencer à s’exécuter.

Get_Status opération

L’opération standard, Get_Status, retourne la phase/status de requête et le message d’achèvement d’un programme simultané. Cette opération prend l’ID de demande d’un programme simultané (RequestID) comme entrée, puis retourne les informations suivantes :

  • Phase : phase de demande conviviale de FND_LOOKUPS.

  • État : la demande conviviale status à partir de FND_LOOKUPS.

  • DevPhase : phase de demande en tant que chaîne qui peut être utilisée pour les comparaisons de logiques de programme.

  • DevStatus : la requête status en tant que chaîne qui peut être utilisée pour les comparaisons de logiques de programme.

  • Message : message d’achèvement si la demande est terminée.

Wait_For_Request opération

L’opération standard, Wait_For_Request, attend l’achèvement de la demande, puis retourne la phase/status de requête et le message d’achèvement. Cette opération prend l’ID de demande d’un programme simultané (RequestID), le nombre de secondes à attendre entre les vérifications (Interval) et la durée maximale en secondes d’attente de l’achèvement de la requête (MaxWait) en tant que paramètres d’entrée, puis retourne les mêmes informations que dans l’opération Get_Status.

Submit_Request opération

L’opération standard, Submit_Request, envoie une demande simultanée pour traitement par un gestionnaire simultané. Si la demande se termine correctement, cette opération retourne l’ID de demande simultanée. Sinon, elle retourne « 0 ».

L’opération Submit_Request prend six paramètres standard : trois de type simple de type complexe chacun. Outre ces paramètres, il prend également les arguments du programme simultané comme tableau de chaîne.

Paramètres de type complexe

L’opération Submit_Request prend SetOptions, SetPrintOptions et SetRepeatOptions comme paramètres d’entrée. Pour plus d’informations sur ces paramètres, consultez <Concurrent_Program_Name> Opération plus haut dans cette section.

Paramètres de type simple

  • Programme : nom court du programme simultané pour lequel la demande doit être envoyée.

  • Description : description de la demande simultanée.

  • StartTime : heure à laquelle la requête simultanée doit commencer à s’exécuter.

Voir aussi

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