Plusieurs exemples illustrent comment utiliser les paramètres de l'intégration par URL de DocuWare pour personnaliser l'accès aux documents et aux fonctions. Ces exemples de configuration montrent comment différents paramètres influencent le comportement des URL intégrées.
Vous pouvez tester tous les exemples présentés ici dans votre installation DocuWare. Il vous suffit d'avoir installé une armoire d'exemple et publié le Platform Service dans le site par défaut d'IIS. Vous devez saisir le nom réel du serveur. Tous les autres paramètres (par exemple les GUID) doivent correspondre aux valeurs de votre installation.
Toutes les URL des exemples d'adresses suivants commencent par
http://<your_servername>/Docuware/WebClient/Integration
La condition préalable aux exemples d'URL de cette section est que l'utilisateur dispose du droit d'accéder aux boîtes de dialogue de recherche, aux listes de résultats et aux listes de tâches ; voir également le chapitre Définir les droits.
Paramètre de connexion
Il s'agit d'appeler une liste de résultats &p=RLV&rl=<result list id>
avec connexion manuelle
http://<your_servername>/DocuWare/Platform/WebClient/Integration?p=RLV&rl=<result list id>
L'utilisateur doit saisir ses identifiants avant que la liste de résultats ne s'affiche.
avec authentification unique
Le paramètre pour la connexion Windows est « SSO ». Il est ajouté dans l'URL de base, avant l'ID de l'organisation :
http://<your_servername>/DocuWare/Platform/WebClient/SSO/Integration?p=RLV&rl=<result list id>
automatiquement avec les identifiants DocuWare
Il est possible d'inclure les identifiants DocuWare dans l'URL d'intégration. Les identifiants doivent être codés en base64 et chiffrés.
Identifiants : User=administrator\nPwd=admin
Identifiants codés en base64 : VXNlcj1hZG1pbmlzdHJhdG9yXG5Qd2Q9YWRtaW4=
Cette chaîne est ajoutée à l'URL avec « lc »
http://<your_servername>/<DocuWare>/<Platform>/WebClient/Integration?&p=RLV&rl=<result list id>&lc=VXNlcj1hZG1pbmlzdHJhdG9yXG5Qd2Q9YWRtaW4=
Si les identifiants sont inclus dans l'URL, DocuWare n'accepte qu'une URL chiffrée. Si vous utilisez des URL fixes et individuelles, vous pouvez les chiffrer et les déchiffrer à l'aide du DocuWare URL Creator (voir la section DocuWare URL Creator). Si vous chiffrez vous-même les paramètres chiffrables parce que les URL doivent être générées « à la volée », reportez-vous au paragraphe Chiffrement.
L'URL chiffrée est ajoutée avec le paramètre « ep » :
http://<your_servername>/<DocuWare>/<Platform>/WebClient/Integration?&ep=<encrypted parameters>
À partir de la version DocuWare 7.1, les URL non chiffrées comportant les paramètres de connexion lc ou lct ne peuvent plus être utilisées.
Pour mettre à jour les URL d'intégration existantes, procédez comme suit :
Dans l'URL Creator, sélectionnez « Parse URL » à la première étape.
Copiez l'URL dans le champ de texte et cliquez sur « Suivant ».
Activez « Use passphrase » et saisissez la phrase secrète. Vous trouverez la phrase secrète dans DocuWare Administration, dans la zone de l'organisation, sous « Général ».
Cliquez sur « Suivant » jusqu'à la page de récapitulatif et copiez la nouvelle URL avec la connexion chiffrée de manière sécurisée.
Lorsqu'une application génère votre URL, vous devez la personnaliser avec la phrase secrète issue de DocuWare Administration.
Plus d'informations sur le chiffrement
Boîtes de dialogue, listes, téléchargement et visionneuse
Pour en savoir plus sur la façon de trouver les ID des composants.
Visionneuse uniquement, sans liste de résultats, un document précis est ouvert
Le DocID du document précis est « 8 »
&p=V&rl=a60d2279-227d-454b-815c-14d64eb165a1&did=8
Si vous ne saisissez pas de DocID ici, le premier résultat de la liste de résultats s'affiche automatiquement. Vous pouvez en outre définir une requête dans l'URL.
&p=V&rl=69e807b6-70e8-48c2-8857-2864dfebc4ac
Visionneuse et liste de résultats
&p=RLV&rl=69e807b6-70e8-48c2-8857-2864dfebc4ac
La liste de résultats définie par le GUID dans cette URL doit être une liste de tâches ou une liste de résultats.
Boîte de dialogue de recherche, visionneuse et liste de résultats
&p=SRLV&sed=0c825e8b-e21f-48e8-b31f-590bf60a6c59
Aucun paramètre n'est à définir ici pour une liste de résultats, car c'est une boîte de dialogue de recherche qui s'ouvre. Une liste de résultats est toujours associée à chaque boîte de dialogue de recherche.
Boîte de dialogue d'indexation
Une boîte de dialogue d'informations peut être intégrée avec le schéma d'URL suivant :
? p=IND&rl=<Resultlist_ID>&fc=<FileCabinet_ID>&did=<doc_ID>
IND = paramètre pour la boîte de dialogue d'indexation (boîte de dialogue d'informations)
rl = ID de la liste de résultats
fc = ID de l'armoire
did = ID du document associé à la boîte de dialogue d'informations
Tous les paramètres doivent être chiffrés.
Bac
Une intégration de bac fournit à l'utilisateur l'ensemble des fonctionnalités d'un bac dans le Web Client.
Un bac peut être intégré avec ce schéma d'URL :
? p=B&bid=<Basket_ID>
B = paramètre pour le bac
bid = ID du bac
Tous les paramètres doivent être chiffrés.
Lien de document
Pour intégrer le lien vers un document, vous pouvez utiliser ce schéma d'URL :
?p=DL&fc=<FileCabinet_ID>&did=<doc_ID>&docLink=<doc_ID>
DL = paramètre pour le type d'intégration « lien de document »
fc = ID de l'armoire source. Il s'agit de l'armoire qui contient le lien.
did = ID du document associé au lien
Téléchargement
&p=D&rl=a60d2279-227d-454b-815c-14d64eb165a1&did=8
Cette URL ouvre le document dans le programme du module externe, car « Download » n'a pas été explicitement défini comme type de téléchargement. Si vous souhaitez qu'un document soit proposé au téléchargement, l'URL est la suivante :
&p=D&rl=a60d2279-227d-454b-815c-14d64eb165a1&did=8&dt=Download
Vous pouvez aussi définir une liste de tâches ou une requête pour une intégration de téléchargement. Si plusieurs résultats sont renvoyés, le premier résultat est toujours affiché dans le programme du module externe ou proposé au téléchargement.
Naturellement, pour tous les exemples de cette section, la connexion peut être définie comme paramètre ; comme alternative à la liste de tâches, vous pouvez aussi définir la requête comme paramètre.
Requêtes
Dans les exemples suivants, l'accès est accordé via les identifiants de connexion inclus dans l'URL ; le nom d'utilisateur est « guest » et le mot de passe est également « guest ». Seuls les paramètres de l'URL sont indiqués ici. L'URL de base est la même que précédemment.
Si vous définissez une requête dans l'URL et que la liste de résultats est une liste de tâches, le paramètre « q » peut affiner la requête de la liste de tâches.
Requêtes avec une expression de recherche simple
[COMPANY]="Peters Engineering"
&p=RLV&lc=VXNlcj1ndWVzdFxuUHdkPWd1ZXN0&rl=a60d2279-227d-454b-815c-14d64eb165a1&q=W0NPTVBBTlldPSJQZXRlcnMgRW5naW5lZXJpbmci
[CONTACT] LIKE "Lau*"
&p=RLV&lc=VXNlcj1ndWVzdFxuUHdkPWd1ZXN0&rl=a60d2279-227d-454b-815c-14d64eb165a1&q=W0NPTlRBQ1RdIExJS0Ugk0xhdSqT
Requête pour les documents d'une plage de dates précise
[DATE]<=CURRENTDATE(-5) AND [DATE]>=CURRENTDATE(-8)
Requêtes avec des expressions de recherche complexes
[COMPANY]="US-Steel" AND [DEPARTMENT]="Production"
&p=RLV&lc=VXNlcj1ndWVzdFxuUHdkPWd1ZXN0&rl=a60d2279-227d-454b-815c-14d64eb165a1&q=W0NPTVBBTlldPZNVUy1TdGVlbJMgQU5EIFtERVBBUlRNRU5UXT2TUHJvZHVjdGlvbpM=
[COMPANY]="Phone Wizard" AND [DEPARTMENT]="Accounting" AND [STATUS]="to be approved"
&p=RLV&lc=VXNlcj1ndWVzdFxuUHdkPWd1ZXN0&rl=a60d2279-227d-454b-815c-14d64eb165a1&q=W0NPTVBBTlldPZNQaG9uZSBXaXphcmSTIEFORCBbREVQQVJUTUVOVF09k0FjY291bnRpbmeTIEFORCBbU1RBVFVTXT2UdG8gYmUgYXBwcm92ZWSU
(([CONTACT]="Werner Moser" OR [CONTACT] LIKE "*Moser*") AND [COMPANY] LIKE "*Moser*") OR [DocuWareFulltext] LIKE "*Moser*"
Requête avec des champs numériques
Saisissez des séparateurs décimaux si vous utilisez des valeurs décimales dans des champs numériques. Avec un séparateur décimal, la requête est indépendante des paramètres régionaux et peut être utilisée avec différents réglages régionaux.
Requête avec un caractère générique
[Index Field DB Name] LIKE "*[Search Value]*"
REMARQUE : l'astérisque peut être placé au début de la valeur de recherche, après celle-ci, ou aux deux endroits.
Chiffrement
Si vous utilisez des URL fixes et individuelles, vous pouvez les chiffrer et les déchiffrer à l'aide du DocuWare URL Creator (voir la section DocuWare URL Creator). Si vous chiffrez vous-même les paramètres chiffrables parce que les URL doivent être générées « à la volée », reportez-vous au paragraphe sur le codage base64.
Algorithme de chiffrement
Certains paramètres doivent être codés en base64URL pour le chiffrement. Pour en savoir plus, reportez-vous à la section Paramètres d'URL.
Chiffrement de l'URL
Cela utilise un algorithme de chiffrement symétrique.
L'Advanced Encryption Standard (AES), conforme à la spécification FIPS-197, est utilisé pour le chiffrement, avec les paramètres suivants :
Block Size = 128 bits
Cipher size = CBC (Cipher Block Chaining)
Vecteur d'initialisation (IV) = 128 bits
Longueur de la clé = 256 bits
Pas de sel (salt)
Clés
Une clé AES de 256 bits et un vecteur d'initialisation (IV) de 128 bits sont utilisés pour le chiffrement et le déchiffrement. La clé et le vecteur d'initialisation doivent aussi être connus de l'application externe. Des phrases secrètes sont utilisées à cet effet. DocuWare se sert de cette phrase secrète pour calculer la clé et le vecteur d'initialisation. La phrase secrète est chiffrée et enregistrée comme propriété dans les paramètres de l'intégration web. L'administrateur doit également saisir et chiffrer la phrase secrète dans l'application externe.
L'algorithme suivant sert à déterminer la clé AES et le vecteur d'initialisation à partir de la phrase secrète :
Déterminer un hachage SHA-512 à partir de la phrase secrète (résultat : 512 bits). Cela peut être implémenté en .NET à l'aide de la classe SHA512Managed et est également pris en charge par Java et PHP. Des modules complémentaires tiers sont disponibles pour JavaScript.
Utiliser les 256 premiers bits (tableau de 32 octets) pour la clé AES.
Utiliser les 128 bits suivants (tableau de 16 octets) pour le vecteur d'initialisation.