Créez une intégration par URL en quatre étapes seulement. L'assistant URL Creator ajoute les paramètres, effectue le codage Base64 et chiffre l'URL automatiquement, si vous le souhaitez.
L'URL Creator fait partie des DocuWare Desktop Apps et peut être téléchargé depuis le DocuWare Client (Menu principal > Installer les Desktop Apps).
Important : si vous souhaitez utiliser l'intégration par URL pour intégrer des éléments DocuWare dans votre portail, vous devez ajouter votre portail à la liste d'autorisation sous DocuWare Configurations > Sécurité > Connexions externes > Intégration de portail.
Cette liste d'autorisation empêche des attaquants d'intégrer vos données dans leurs sites web.
Sélectionner le type d'URL
Sélectionnez WebClient Integration URL pour créer une intégration par URL vers un élément DocuWare.
WebClient Login URL crée un lien vers le Web Client, et non vers un élément précis.
Parse URL analyse les paramètres d'une intégration par URL existante et affiche les éléments associés. Les paramètres erronés sont ainsi faciles à repérer et à corriger.
Saisir la connexion DocuWare
Scheme : indiquez le type de connexion au serveur (http ou https).
Server Name : indiquez le chemin vers l'organisation actuelle : <your_servername>/<DocuWare>/<Platform>/WebClient
Vous trouverez ce chemin dans le DocuWare Server Manager.Organization GUID : À partir de la version DocuWare 7.1, les URL générées par DocuWare contiennent le GUID de l'organisation au lieu de l'ID de l'organisation. Les URL existantes utilisant l'ID continuent de fonctionner sans modification, même après la mise à jour.
Les clients Cloud peuvent créer une URL d'intégration sans aucun OrgGUID ni nom précisé, car l'organisation est encodée dans l'adresse de base de l'URL. Il en va de même pour les utilisateurs de DocuWare sur site lorsque le système ne comporte qu'une seule organisation. Un identifiant n'est nécessaire que lorsqu'un système DocuWare comporte plusieurs organisations.
Vous trouverez le GUID de l'organisation dans DocuWare Configurations > Paramètres de l'organisation > Diagnostic et commentaires.
Chiffrement – Utiliser une phrase secrète : pour chiffrer l'URL d'intégration, saisissez la phrase secrète définie dans Configurations > Sécurité > Sécurité de connexion > Phrase secrète. Avec Utiliser un bruit aléatoire… , l'URL est chiffrée davantage.
Authentification
En l'absence d'entrée dans cette zone, l'utilisateur doit saisir ses identifiants DocuWare pour accéder à DocuWare.
Include Credentials in URL : si des identifiants DocuWare sont saisis ici, l'utilisateur peut accéder à la boîte de dialogue de recherche, à une ou à un autre élément de DocuWare sans saisir ses identifiants.
Attempt Single Sign-On : le lien d'intégration authentifie l'utilisateur à l'aide du fournisseur d'identité défini dans DocuWare Configurations > Sécurité > Authentification unique.
Other Parameters : indiquez la période de validité de l'URL. En l'absence d'entrée, l'URL est valable indéfiniment.
Type d'intégration
Dans cet onglet, vous configurez les paramètres qui appellent des éléments de DocuWare, comme des documents archivés, des listes de résultats, etc. Selon le type d'intégration, différents champs sont à remplir.
Pour savoir comment trouver les GUID, consultez : En un coup d'œil : les ID des éléments DocuWare.
Viewer : ce type d'intégration peut afficher automatiquement un document dans le DocuWare Viewer. Vos clients ont par exemple la possibilité de consulter la dernière liste de prix.
Copiez le GUID d'une liste de résultats qui trouve le document demandé. Saisissez ce GUID dans le champ Resultlist Dialog guid. Même si la liste de résultats n'est pas affichée, la recherche du document s'exécute en arrière-plan.
Ce type d'intégration n'affiche qu'un seul document.
Result List : avec le type d'intégration Result List and Viewer, vous pouvez intégrer des listes de résultats et des listes du DocuWare Task Manager. Une liste du Task Manager fournit par exemple au collaborateur, en un coup d'œil, les factures à valider.
Copiez le GUID de la liste demandée dans le champ Resultlist Dialog guid et l'ID du document dans le champ « DWDOCID ».
L'ajout du paramètre de boîte de dialogue de recherche sed garantit que la liste de résultats est fournie comme dans le Web Client, avec toutes les restrictions de champ.
Une liste de résultats avec une arborescence de dossiers n'est pas prise en charge.
Tous les champs interrogés font partie de l'URL d'intégration. Si cette URL devient trop longue, son ouverture provoque l'affichage d'une erreur par le navigateur. Dans ce cas, raccourcissez la requête ou utilisez une intégration Search, Result List and Viewer slrv.
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.
Search : copiez le GUID de la boîte de dialogue de recherche demandée dans le champ Search Dialog guid. Comme une liste de résultats est associée à chaque boîte de dialogue de recherche, elle est également utilisée pour l'intégration.
Vous avez ensuite la possibilité de restreindre les résultats de recherche. Si l'utilisateur est susceptible d'effectuer une recherche dans un service précis, cochez l'option Dialog Values et saisissez par exemple [DEPARTMENT]=Export. Ce champ de la boîte de dialogue de recherche est alors prérempli avec « Export ». Si le préremplissage du champ ne convient pas, l'utilisateur peut modifier ou supprimer cette entrée à tout moment.
Le nom du champ doit être saisi entre crochets. Comme nom de champ, indiquez le nom de base de données du champ. Différents champs peuvent être combinés avec le symbole & : « [FieldName1]=fieldValue1&[FieldName2]=fieldValue2 ».
Remarque : avec une intégration par URL, les résultats d'une recherche en texte intégral ne sont pas mis en évidence par une couleur dans le DocuWare Viewer.
Download : crée un lien qui télécharge directement le document lorsqu'on clique dessus. Ce type d'intégration charge un seul document.
Document History : avec ce type d'intégration, toutes les versions précédentes d'un document sont affichées à côté de la plus récente. Saisissez le GUID de l'armoire et l'ID du document. Ce type d'intégration se rapporte à un seul document.
Workflow Task : lorsque le Workflow Manager est installé, une liste de tâches s'affiche dans le Web Client ; elle contient les tâches à effectuer par un collaborateur. Workflow Task intègre une seule tâche dans, par exemple, un logiciel de comptabilité. Moyennant un peu de programmation supplémentaire, une tâche s'ouvre dans une application tierce.
Vous trouverez les deux ID dans le Platform Service, sous Organization > Workflow.
Workflow Task List : des listes de tâches différentes s'affichent pour les utilisateurs ayant le rôle « Conception » ou « Contrôler ». « Conception » désigne ici l'utilisateur simple, qui ne voit que ses propres tâches. La liste de tâches d'un utilisateur « Contrôler » comprend, entre autres, toutes les tâches non exécutées. Workflow Task List appelle ces listes de tâches dans une application tierce.
Indiquez la liste de tâches avec le rôle « Conception » ou « Contrôler » pour l'utilisateur. Le « Workflow-ID » définit la configuration de workflow. Plus d'informations dans l'aide du Workflow Manager.
Index Dialog : avec ce type d'intégration, seule la boîte de dialogue d'indexation (boîte de dialogue d'informations) associée à un document s'affiche. C'est utile lorsque, par exemple, l'utilisateur d'un logiciel ERP souhaite seulement vérifier quelques informations d'index d'un document archivé, sans l'ouvrir.
Le GUID de l'armoire n'est pas obligatoire. Si vous laissez ce champ vide, la boîte de dialogue d'informations est recherchée dans toutes les armoires. Le chargement peut alors prendre plus de temps.
Ce type d'intégration affiche la boîte de dialogue d'indexation d'un seul document.Document Tray : une intégration de bac fournit à vos collègues toutes les fonctionnalités d'un bac.
Document Relation : créez une relation de documents (lien de documents) dans DocuWare Configurations.
Localisez la relation de documents dans le Platform Service. Dans le champ File Cabinet GUID, saisissez le GUID de l'armoire qui contient le document associé au lien (armoire source).
Send Request (Workflow Manager) : l'utilisateur reçoit un lien vers une demande de workflow qui lui est attribuée.
Sent Requests (Workflow Manager) : l'expéditeur reçoit un lien vers un aperçu des demandes de workflow envoyées.