Intégration à d'autres systèmes
Valable pour : enaio webclient version 8.50
Vous pouvez intégrer enaio à d'autres systèmes et applications Web : les liens vers une URL enaio peuvent être intégrés partout où les URL sont évaluées, principalement dans les pages Web.
Vous avez également la possibilité d'exécuter automatiquement une action immédiatement après vous être connecté à enaio, comme par exemple ouvrir un document enaio ou effectuer une requête sauvegardée. À l'aide des paramètres de l'URL, vous déterminez l'action à exécuter ainsi que l'objet enaio qui sert à mettre en œuvre cette action.
Cette URL est construite comme suit :
http://<DOMAIN>/<Name_der_Webanwendung>/#/entry?<Parameter>=<Parameterwert>
Par exemple, vous saisissez cette URL dans votre application Web. L'action est exécutée lorsque vous cliquez sur l'URL, par exemple pour afficher un document enaio.
Les actions suivantes sont disponibles :

La page d'accueil enaio peut être intégrée.
L'URL possède la structure suivante :
http://<DOMAIN>/osweb/
Si, durant l'installation, l'application Web n'a pas été nommée osweb, l'URL aura la structure suivante :
http://<DOMAIN>/<Name_der_Webanwendung>/
Si enaio gateway utilise le port par défaut, il est facultatif de spécifier le port dans l'URL.

Pour ouvrir un objet, spécifiez son ID en cliquant sur l'URL intégrée.
L'ouverture de l'objet ou de ses données d'indexation dépend de la configuration du paramètre com.os.osdrt.hitlist.document.default.action.
Paramètre : /#/entry?osid=<Object-ID>
http://<DOMAIN>/osweb/#/entry?osid=4300
Résultat : l'objet ID 4300 s'ouvre.
Vous pouvez également spécifier l'ID du type d'objet. Cette opération ouvre l'objet plus rapidement.
Paramètre : /#/entry?osid=<Objekt-ID>&objecttypeid=<Objekttyp-ID>
http://<DOMAIN>/osweb/#/entry?osid=478645961&objecttypeid=262144
Vous pouvez également spécifier le paramètre activeVariant. Ce paramètre transforme une variante inactive interrogée de l'extérieur en variante active courante. Si le paramètre est défini sur true, le système vérifie si l'objet est la variante active de l'objet. Si l'objet n'est pas une variante active, la variante active de l'objet souhaité est ouverte. Si le paramètre n'est pas défini ou faux, l'objet exact avec l'OSID demandé est ouvert.
Paramètre : /#/entry?osid=<Objekt-ID>&activeVariant=<Wert>
http://<DOMAIN>/osweb/#/entry?osid=478645961&activeVariant=true
Résultat : la variante active de l'objet demandé avec l'ID 478645961 est ouverte.
http://<DOMAIN>/osweb/#/entry?osid=478645961&activeVariant=false
Résultat : l'objet demandé avec l'ID 478645961 est ouvert.

Pour ouvrir les données d'indexation d'un objet, spécifiez son ID en cliquant sur l'URL intégrée. L'objet peut être un classeur, un registre ou un document.
Paramètre : /#/entry?indexdata=<Object-ID>
http://<DOMAIN>/osweb/#/entry?indexdata=4300
Résultat :
Les données d'indexation de l'objet ID 4300 s'ouvrent.
Vous pouvez également spécifier l'ID du type d'objet. Cette opération ouvre les données d'indexation de l'objet plus rapidement.
Paramètre : /#/entry?indexdata=<Objekt-ID>&objecttypeid=<Objekttyp-ID>
http://<DOMAIN>/osweb/#/entry?indexdata=478645961&objecttypeid=262144
Vous pouvez également spécifier le paramètre activeVariant. Ce paramètre transforme une variante inactive interrogée de l'extérieur en variante active courante. Si le paramètre est défini sur true, le système vérifie si l'objet est la variante active de l'objet. Si l'objet n'est pas une variante active, les données d'indexation de la variante active de l'objet souhaité sont ouvertes. Si le paramètre n'est pas défini ou faux, les données d'indexation de l'objet avec l'OSID demandé sont ouvertes.
Paramètre : /#/entry?indexdata=<Objekt-ID>&activeVariant=<Wert>
http://<DOMAIN>/osweb/#/entry?indexdata=478645961&activeVariant=true
Résultat : les données d'indexation de la variante active de l'objet demandé avec l'ID 478645961 sont ouvertes.
http://<DOMAIN>/osweb/#/entry?indexdata=478645961&activeVariant=false
Résultat : les données d'indexation de l'objet demandé avec l'ID 478645961 sont ouvertes.

Pour ouvrir l'emplacement d'un objet, spécifiez son ID en cliquant sur l'URL incorporée. Si l'objet spécifié est un classeur, son contenu s'ouvre.
Paramètre : /#/entry?location=<Object-ID>
http://<DOMAIN>/osweb/#/entry?location=4300
Résultat : l'emplacement de l'objet ID 4300 s'ouvre.
Vous pouvez également spécifier l'ID du type d'objet. Cette opération ouvre l'emplacement de l'objet plus rapidement.
Paramètre : /#/entry?location=<Objekt-ID>&objecttypeid=<Objekttyp-ID>
http://<DOMAIN>/osweb/#/entry?location=478645961&objecttypeid=262144
Si un objet a plusieurs emplacements, vous pouvez déterminer l'emplacement à ouvrir en cliquant sur l'URL intégrée en spécifiant l'ID de l'objet et l'ID du registre.
Paramètre : /#/entry?location=<Objekt-ID>&parentid=<Parent-ID>
http://<DOMAIN>/osweb/#/entry?location=4300&parentid=110
Résultat : le registre avec l'ID 110 et l'objet s'ouvrira avec l'ID 4300.
Vous pouvez également spécifier l'ID du type de registre. Cette opération ouvre l'emplacement de l'objet plus rapidement.
Paramètre : /#/entry?location=<Objekt-ID>&parentid=<Register-ID>&parenttypeid=<Registertyp-ID>
http://<DOMAIN>/osweb/#/entry?location=478645961&parentid=55632&parenttypeid=110
Outre l'ID du type de registre, vous pouvez également spécifier l'ID du type d'objet. Cette opération ouvre l'emplacement de l'objet plus rapidement.
Paramètre : /#/entry?location=<Objekt-ID>&objecttypeid=<Objekttyp-ID>&parentid=<Register-ID>&parenttypeid=<Registertyp-ID>
http://<DOMAIN>/osweb/#/entry?location=478&objecttypeid=264&parentid=532&parenttypeid=110
Vous pouvez également spécifier le paramètre flat. Ce paramètre vous permet de passer à une vue de dossier plane. La structure du registre est désactivée et tous les documents d'un dossier sont affichés dans une liste de résultats. Si le paramètre est défini sur vrai, la structure du registre est désactivée. Si le paramètre n'est pas défini ou faux, la structure du registre s'affiche.
Paramètre : /#/entry?location=<Objekt-ID>&flat=<Wert>
http://<DOMAIN>/osweb/#/entry?location=478645961&flat=true
Résultat : la structure du registre de l'objet demandé avec l'ID 478645961 est désactivée.
http://<DOMAIN>/osweb/#/entry?location=478645961&flat=false
Résultat : la structure du registre de l'objet demandé avec l'ID 478645961 est affichée.

Pour ouvrir un élément de travail de workflow, spécifiez son ID en cliquant sur l'URL intégrée.
Les ID des éléments de travail peuvent être déterminés à l'aide des bibliothèques logicielles, comme par exemple Java Workflow API.
Paramètre : /#/entry?workflow=<ID of process step>
http://<DOMAIN>/osweb/#/entry?workflow=0A3F88A13FA4445AA5D0CFE062B941E
Résultat : l'élément de travail de workflow avec l'ID 0A3F88A13FA4445AA5D0CFE062B941E est ouvert. Si vous êtes l'un des éditeurs de l'élément de travail, celui-ci apparaîtra ultérieurement dans votre boîte de réception.

Pour exécuter une requête sauvegardée, vous pouvez spécifier son ID en cliquant sur l'URL incorporée.
Les requêtes enregistrées sont définies dans enaio client.
Paramètre : /#/entry?search=<Search-ID>
http://<DOMAIN>/osweb/#/entry?search=26889
Résultat : le résultat de la recherche avec l'ID 26889 s'affiche dans la liste de résultats.
Vous pouvez déterminer l'ID d'une requête sauvegardée via enaio appconnector. Pour ce faire, accédez à l'URL suivante dans votre navigateur : http://<DOMAIN>/osrest/api/documents/storedqueries?showglobal=true. Dans l'édition JSON du navigateur, vous pouvez ensuite rechercher le nom de la requête et déterminer l'ID de la requête sauvegardée.

Pour exécuter une requête sauvegardée avec des variables, vous pouvez spécifier son ID en cliquant sur l'URL incorporée.
L'action se limite aux requêtes enregistrées avec des variables dynamiques. Les requêtes enregistrées avec des variables statiques et/ou des valeurs spécifiques (#User#, #Date#, etc.) ne peuvent pas être exécutées via l'URL.
Paramètre : /#/entry?search=<Anfrage-ID>&var1=<Variablenwert>
Les variables multiples sont reliées à l'aide du caractère &.
http://<DOMAIN>/osweb/#/entry?search=26889&var1=a&var2=100077
Résultat : les résultats de la recherche avec l'ID 26889, variable 1=a et variable 2=100077 s'affichent dans la liste de résultats.
Vous pouvez déterminer l'ID d'une requête sauvegardée via enaio appconnector. Pour ce faire, accédez à l'URL suivante dans votre navigateur : http://<DOMAIN>/osrest/api/documents/storedqueries?showglobal=true. Dans l'édition JSON du navigateur, vous pouvez ensuite rechercher le nom de la requête et déterminer l'ID de la requête sauvegardée.

Vous pouvez spécifier l'ID d'un document dont le fichier de document est en cours de téléchargement en cliquant sur l'URL intégrée.
Paramètre : /#/entry?download=<ID des Dokuments>
http://<DOMAIN>/osweb/#/entry?download=4421
Résultat : le fichier document du document avec l'ID 4421 est en cours de téléchargement.
Vous pouvez également spécifier l'ID du type d'objet. Cette spécification lancera le téléchargement du fichier de document plus rapidement.
Paramètre : /#/entry?download=<Objekt-ID>&objecttypeid=<Objekttyp-ID>
http://<DOMAIN>/osweb/#/entry?download=4421&objecttypeid=2621
De plus, vous pouvez télécharger un fichier PDF du document au lieu du fichier d'origine.
Paramètre : /#/entry?download=<ID des Dokuments>&rendition=pdf
http://<DOMAIN>/osweb/#/entry?download=4421&rendition=pdf
Vous pouvez également spécifier le paramètre activeVariant. Ce paramètre transforme une variante inactive interrogée de l'extérieur en variante active courante. Si le paramètre est défini sur true, le système vérifie si l'objet est la variante active de l'objet. Si l'objet n'est pas une variante active, la variante active de l'objet souhaité est téléchargée. Si le paramètre n'est pas défini ou faux, l'objet exact avec l'OSID demandé est téléchargé.
Paramètre : /#/entry?download=<Objekt-ID>&activeVariant=<Wert>
http://<DOMAIN>/osweb/#/entry?download=478645961&activeVariant=true
Résultat : la variante active de l'objet demandé avec l'ID 478645961 est téléchargée.
http://<DOMAIN>/osweb/#/entry?download=478645961&activeVariant=false
Résultat : l'objet demandé avec l'ID 478645961 est téléchargé.
Si un document contient plusieurs fichiers de documents, ils sont téléchargés ensemble dans un fichier ZIP. De même, plusieurs fichiers d'un document sont combinés en un seul PDF lors du téléchargement à l'aide du paramètre rendition=pdf.
© Copyright OPTIMAL SYSTEMS 2020. | Mentions légales et protections des données