Appel depuis une application extérieure

Vous pouvez déclencher l'ouverture d'une page de CARL Source directement depuis une application extérieure : en ajoutant un lien dans un mail, dans un portail de navigation ou autre.

Le contenu de la page à ouvrir est passé en paramètre dans l'adresse.

Adresse de la page

L'adresse de la page se construit de la manière suivante :

Adresse de CARL Source : http://<serveur:port>/<contexte>/ par exemple : http://monserveur:8080/xnet/.
Page appelée (voir exemples ci-après), suivi de ? s'il y a des paramètres,
Liste des couples <paramètre> =<valeur> , séparés par des &.

Pour connaître l'adresse de la page affichée, utilisez le raccourci clavier "Ctrl+Shift+U".
L'URL apparaîtra dans une pop up.

Les paramètres en majuscules précisent :

L'onglet : SELECTED_TAB. L'identifiant de l'onglet peut être consulté en mode personnalisation .
L'élément à ouvrir : BEAN_ID. Il est nécessaire de connaître son identifiant.
Le formulaire personnalisé affiché : CUSTOM_FORM. Il est nécessaire de connaître l'identifiant. Il sera préfixé d'un "F", voir exemple ci-après.

Ils peuvent être suivis de paramètres forçant les valeurs dans l'écran à ouvrir.
Ces paramètres sont des attributs de l'objet dans le dictionnaire.
Ils sont préfixés selon l'objet concerné :

fa: L'animateur,

mb: L'objet métier,

sb: L'objet de recherche,

ta: La liste dans l'objet de recherche.

Les caractères spéciaux doivent être encodés.
On écrira notamment %20 pour un espace, %2B pour le signe +.

Exemples formulaires de recherche

Formulaire à afficher	Adresse URL
Formulaire de recherche des Matériels.	http://monserveur:8080/xnet/equipment/material-SEL.faces
Formulaire de recherche des points de structure, avec formulaire personnalisé.	http://monserveur:8080/xnet/equipment/box-SEL.faces?CUSTOM_FORM=F124c68e7a8a-29dd
Liste des demandes d'achat, onglet [Résultat]	http://monserveur:8080/xnet/purchase/PR-SEL.faces?SELECTED_TAB=pa_Result
Onglet [Favoris] de la liste des budgets	http://monserveur:8080/xnet/budget/budgAcc-SEL.faces?SELECTED_TAB=pa_Bookmark
Formulaire de recherche des interventions, avec les critères "État" initialisé à 'En préparation', 'En attente de validation' et nature d'intervention à 'MAINT-CORR'	http://monserveur:8080/xnet/works/WO-SEL.faces?sb:status=[REQUEST,AWAITINGVALID]&sb:actionType=MAINT-CORR
Onglet [Macroplanning], filtré et positionné sur le premier jour de la semaine prochaine	http://monserveur:8080/xnet/works/WOSchedule-SEL.faces?SELECTED_TAB=pa_Result&sb:WOBeginMin={startOfNextWeek}&fa:startDate={startOfNextWeek}

Exemples formulaires de détail

Formulaire à afficher	Adresse URL
Formulaire de détail du Matériel d'identifiant '1'	http://monserveur:8080/xnet/equipment/material-DET.faces?BEAN_ID=1
Formulaire de création de DT, avec date de fin = lendemain de la date en cours, voir Valeur par défaut dynamique	http://monserveur:8080/xnet/works/MR-DET.faces?mb:expEnd={sysDate}%2B1{day}&mb:workPriority=URGENT
Formulaire de sortie stock, acteur et magasin pré-renseignés	http://monserveur:8080/xnet/stocks/issue-DET.faces?fa:actor=DUPONT&fa:warehouse=MAGASIN1

Cas particulier de l'arborescence

Le paramètre STRUCTURE_ID désigne la structure arborescente à afficher (MATERIAL, LOCATION, MAIN, etc.).
Le paramètre STRUCTURE_ELEMENT_ID désigne l'identifiant de l'élément.

Exemple :

Arborescence des équipements sur l'onglet [Principal], positionnée sur le Matériel d'identifiant '20' : http://monserveur:8080/xnet/equipment/link-SEL.faces?STRUCTURE_ID=MAIN&STRUCTURE_ELEMENT_ID=20.