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 :
- Extraire les documents, les dossiers, les recherches enregistrées, les modèles de recherche, les définitions de flux de travaux et les modèles de publication.
- Télécharger les types d'objet suivants et les sauvegarder sur le PC local : document, recherche enregistrée, modèle de recherche, modèle de publication et définition de flux de travaux.
- Entrez une URL basée sur un chemin ou sur un ID comme indiqué ci-dessous.
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 du serveur client P8/nom de l'application:port/getContent/Transport/Projets/Travaux+en+cours
Pour extraire des objets à l'aide d'URL basées sur le chemin, vous devez configurer les préférences 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 du serveur client P8/nom de l'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 flux de travaux |
Ouvre l'applet Concepteur de processus. |
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ètre
mode=download est facultatif. Exemple :
http://serveur/application_web/getContent/objectStoreID/pathName?mode=download
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ètre
mode=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ù :
- serveur est le nom du moteur d'applications ou du serveur Workplace XT sur lequel s'exécute l'application client
FileNet P8.
- application_web est le nom de l'application client FileNet P8.
- objectStoreName=objectStoreGUID est l'identificateur global unique du conteneur d'objets où réside l'objet. Incluez les accolades.
- objectType=type est le type d'objet à extraire. Entrez la valeur
applicable pour objectType :
Pour l'un des éléments suivants : |
objectType= |
Document |
document |
Dossier |
folder |
Recherche enregistrée |
storedsearch |
Modèle de recherche |
searchtemplate |
Définition de flux de travaux |
document |
Modèle de publication |
publishtemplate |
- id=objectGUID est l'identificateur global unique de l'objet dans le conteneur d'objets. Ce paramètre est obligatoire pour l'objet dossier.
Pour les objets document, recherche enregistrée, modèle de recherche, définition de flux de travaux et modèle de publication, l'ID est facultatif et permet d'extraire une version spécifique. Incluez les accolades.
- vsId=versionSeriesGUID est l'identificateur global unique permettant d'extraire la
version la plus récente de la liste pour les objets suivants :
document, recherche enregistrée, modèle de recherche, définition de flux de travaux et modèle de publication.
Remarque : Lorsque l'ID et le paramètre
vsld sont présents dans l'URL, l'application client FileNet P8
utilise l'ID pour extraire la version spécifiée.
Si celle-ci est introuvable, l'application client FileNet P8 signale une erreur et donne à l'utilisateur la possibilité d'extraire la dernière version, comme indiqué par le paramètre vsld.
- Le paramètre mode=download est facultatif et vous permet de sauvegarder le contenu en local.
Remarque : Vous pouvez configurer l'application client FileNet P8
pour utiliser des URL basées sur le chemin pour les demandes de document. Par conséquent, si vous entrez une URL basée sur l'ID, l'application client
FileNet P8 convertit en URL basée sur le chemin si possible, afin de conserver l'intégrité de toutes les références d'URL relative imbriquées dans le contenu du document.