Accès aux objets via des URL

La fonction d'adressabilité des URL offre aux utilisateurs un accès direct aux objets sans avoir à naviguer dans l'interface utilisateur du client IBM FileNet P8. Après avoir ouvert une session sur un client FileNet P8, comme Workplace XT, il suffit aux utilisateurs d'entrer l'URL de l'objet dans la barre d'adresses d'un navigateur. (Les administrateurs peuvent créer des signets ou des favoris pour extraire un dossier ou un objet versionnable.)

Grâce à l'adressabilité des URL, vous pouvez :

Les URL utilisent le chemin de référence pour indiquer l'emplacement d'un objet dans un conteneur d'objets. Par exemple, pour extraire le document nommé Travaux en cours, situé dans le dossier Projets du conteneur d'objets Transport, l'utilisateur doit entrer une URL semblable à la suivante :

http://nom_serveur_client_P8/nom_application:port/getContent/Transport/Projets/Travaux+en+cours

Pour extraire des objets à l'aide d'URL basées sur le chemin, vous devez définir la préférence de site Utilisation d'URL basées sur un chemin.

Les URL basées sur l'ID utilisent des identificateurs globaux uniques pour indiquer l'emplacement d'un objet dans un conteneur d'objets. L'emplacement du document est indiqué par son identificateur global unique, ainsi que par celui du conteneur d'objets où il réside. Par exemple, pour extraire un document, l'utilisateur doit entrer une URL semblable à la suivante :

http://nom_serveur_client_P8/nom_application:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}

Les adresses basées sur l'ID sont généralement plus brèves que les adresses basées sur le chemin. Cependant, seule une URL basée sur le chemin permet de résoudre les références relatives dans un document. Par exemple, si vous demandez le fichier "example.html" avec une URL basée sur le chemin, le fichier est extrait et le navigateur résout toutes les URL supplémentaires nécessaires dans example.html (comme les balises <script>, <img> et <link>). Tous les liens (<a href=...>) sont résolus par le navigateur lorsque l'utilisateur clique dessus.

Le tableau suivant répertorie les réponses par défaut aux différents types d'objet que vous pouvez indiquer dans une URL.

Type d'objet Réponse
Dossier Renvoie une page affichant le nom du dossier.
Document Si le document comporte un contenu, celui-ci est renvoyé. Si le document contient une référence externe, le client FileNet P8 réachemine le client le cas échéant. Si le document ne comporte pas de contenu, le client FileNet P8 signale une erreur.
Définition de workflow Ouvre l'applet Process Designer.
recherche enregistrée Renvoie une page affichant le nom de la recherche enregistrée.
Modèle de recherche Renvoie une page affichant le modèle de recherche.
Modèle de publication Renvoie le contenu du modèle de publication au format XML.

Règles de syntaxe des URL basées sur le chemin

Les URL basées sur le chemin nécessitent un ID conteneur d'objets et un nom de chemin de référence. Le paramètremode=download est facultatif. Exemple :

http://serveur/application_web/getContent/objectStoreID/pathName?mode=download

où :

Exemples d'URL basées sur le chemin

Avec cette URL, la page Workplace XT avec le modèle de recherche spécifié est affichée. Le conteneur d'objets est identifié par le nom (Forms) :

http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download

Avec l'URL ci-dessous, le conteneur d'objets, Forms, est habilité par son nom de domaine, Midwest :

http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download

Règles de syntaxe des URL basées sur l'ID

Les URL prennent trois paramètres de chaîne de requête obligatoires pour l'objet dossier : objectStoreName, objectType et id. Par exemple :

http://serveur/application_web /getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}

Pour les objets document, recherche enregistrée, modèle de recherche, modèle de publication et définition de flux de travaux, l'URL comporte les paramètres objectStoreName, objectType, id et fsld. Le paramètremode=download est facultatif. Voici un exemple :

http://serveur/application_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download

ou,

http://serveur/application_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}

ou,

http://serveur/application_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download

où :