Comment intégrer Oracle Forms et JavaScript ?
Oracle Forms - À Propos d'Oracle Forms et des appens d'événements extérieurs
Dans les versions précédentes d'Oracle Forms, il fallait implémenter OLE et DDE pour interagir avec un nombre limité de types d'événements en dehors de Forms. Dans les versions ultérieures, Forms offrait web.show_document et l'intégration de Java pour interagir avec des sources d'applications externes.
Mais en ce qui concerne l'appel à la page Web où Forms est affiché, il n'y avait pas de solution simple. Il n'était également pas possible d'appeler depuis la page Web vers Forms, par exemple pour mettre à jour une valeur obtenue à partir d'un formulaire HTML.
L'intégration de JavaScript permet aux événements JavaScript d'appeler Forms, ou à Forms d'exécuter des événements JavaScript. La figure suivante montre comment JavaScript et Oracle Forms fonctionnent ensemble. Sur le côté gauche de l'image, JavaScript est exécuté dans la page où l'applet Forms est hébergée. Oracle Forms a désormais la capacité d'appeler des fonctions JavaScript en utilisant des fonctions natives intégrées. De plus, les fonctions JavaScript peuvent désormais déclencher un déclencheur Oracle Forms en utilisant une nouvelle API qui a été fournie.
Figure -22 Oracle Forms et JavaScript
.png)
Deux nouveaux appels sont disponibles dans le package intégré web :
- web.javascript_eval_expr
- web.javascript_eval_function
Le premier appel, web.javascript_eval_expr, est une procédure qui prend deux arguments : une expression et une cible, tous deux de type de données varchar2. Cette expression JavaScript valide est interprétée dans la page Web dans laquelle l'applet Forms est intégré. L'expression peut être un appel à une fonction définie dans la page cible ou toute expression JavaScript valide pouvant être exécutée sur la page cible, par exemple, document.bgColor='red'. L'expression est exécutée, en utilisant la méthode JSObject.eval() de LiveConnect, dans le contexte de la page ou de la frame nommée dans l'argument cible. Si l'argument cible est nul, alors elle est exécutée dans la page ou la frame dans laquelle l'applet Forms est intégré.
Le deuxième appel, web.javascript_eval_function, est une fonction qui renvoie une valeur de type varchar2. web.javascript_eval_expr et web.javascript_eval_function ont la même fonctionnalité, sauf que javascript_eval_expr ne renvoie aucune valeur du client Forms vers les services Forms. Si votre application n'a pas besoin de renvoyer une valeur, utilisez web.javascript_eval_expr. Le voyage réseau supplémentaire nécessaire pour transporter la valeur de retour du client Forms vers les services Forms est ainsi éliminé.
Pour définir la valeur d'un élément de texte HTML avec l'ID outside_field_id à la valeur du champ Forms appelé inside, vous pourriez écrire ce code PL/SQL :
web.javascript_eval_expr('
document.getElementById("outside_field_id").value='
||:inside
);
Remarquez que la chaîne PL/SQL doit utiliser des guillemets simples tandis que JavaScript est suffisamment flexible pour utiliser des guillemets simples ou doubles. L'utilisation de guillemets doubles à l'intérieur de l'expression fonctionne sans avoir à utiliser des séquences d'échappement. Vous pourriez également écrire une fonction dans la page Web :
<SCRIPT>
function set_field(field_id, myvalue){
document.getElementById(field_id).value=myvalue;
};
</SCRIPT>
Pour obtenir la valeur du champ externe et l'assigner au champ interne, vous pourriez écrire le code PL/SQL suivant :
:inside:=web.javascript_eval_function('
document.getElementById("outside_field_id").value
');