Besoin d'aide ?
Introduction
Damaris RM web service est un ensemble d’API qui vous permettent d’exploiter des fonctions à partir de vos autres outils informatiques.
Cette documentation concerne Damaris RM v11.
Le principe des méthodes Damaris RM
Pour pouvoir utiliser les Web Services, il convient de suivre les séquences des appels qui vous permettent d’obtenir les informations nécessaires pour l’appel suivant.
Voici un exemple de séquence d’appels :
- /rest/services/auth/login : Authentifie l’utilisateur
- Génère une clé unique : uniqueKey
- … Lancement des autres méthodes en utilisant la valeur uniqueKey
- /rest/services/auth/logout : Fin de session
L’accès à la liste des méthodes
Pour accéder à la liste des méthodes, et même pour pouvoir les tester, la solution Damaris RM intègre une page swagger.
Cette interface liste les différents contrôleurs et méthodes.
Vous pouvez ensuite tester directement chaque appel API à partir de la page web.
De plus, vous trouverez des exemples de codes JSON et curl pour vous guider dans le codage des appels.
Pour accéder à la page swagger, lancez l’URL de votre serveur Damaris RM, suivi de /swagger-ui/
Voici un exemple de lien URL : https://demo.damaris.pro/DamarisRM4/swagger-ui/
La recherche de documents électroniques
Voici la séquence d’appels pour déclencher une recherche de documents dans Damaris RM :
- /rest/services/auth/login
- Soumettre le login et le mot de passe crypté
- Récupérer uniqueKey
- /rest/services/search/searchArchivesAdvanced
- Soumettre uniqueKey, l’ID typologie document et les critères de recherches
- ATTENTION : La variable JSON “indexes” attend une chaîne de caractères au format Base64 créée à partir de la chaîne composée des critères. Par exemple, vous allez composer un JSON de type {“123″:”ABCDEF”} pour rechercher la valeur ABCDEF dans le critère 123. Convertissez cette chaîne qui va donner en Base 64 “eyIxMjMiOiJBQkNERUYifQ==”
- Les valeurs vides doivent être représentées comme suit {“123″:””}
- Récupérer les résultats dont ArchivedID
- Soumettre uniqueKey, l’ID typologie document et les critères de recherches
- /rest/services/archiving/getElectronicDocument
- Soumettre uniqueKet et l’ID du document
- Récupérer le fichier numérique
- /rest/services/auth/logout
- Soumettre uniqueKey
Vous disposez également de la méthode /rest/services/archiving/getDocumentTypeIndexes qui vous délivre la liste des critères d’indexation pour une typologie donnée.
Les éléments retournés comprennent entre-autres le type d’index.
Voici le tableau qui indique le code retourné par rapport au type d’index configuré dans Damaris RM :
Code index | Type d’index | Commentaires |
1 | Numérique | |
2 | Alphanumérique | |
3 | Monétaire | |
4 | Date | |
5 | Horodatage | |
6 | Liste fermée | Utilisez la méthode getIndexListValues pour obtenir les valeurs de la liste |
7 | Liste ouverte | Utilisez la méthode getIndexListValues pour obtenir les valeurs de la liste |
9 | ||
10 | Virtual Folder | |
11 | Dictionnaire | |
12 | Simple Closed List | Utilisez la méthode getIndexListValues pour obtenir les valeurs de la liste |
13 | URL | |
14 | Lien Table | |
15 | Champ chiffré | |
16 | Icône |
Pour effectuer une recherche bornée pour les champs de type Date, monétaire et numérique, vous pouvez utiliser la syntaxe suivante dans le JSON du champ “indexes”. Pour rappel, ce champ devra ensuite être codé en Base64 avant son intégration dans le JSON global de l’appel.
- La recherche commence par : {“IdxID”:”Valeur”}
- La recherche pour une valeur exacte : {“IdxID”:”Valeur”, “IdxID_to”:”Valeur”}
- La recherche jusqu’à : {“IdxID_to”:”Valeur”}
- La recherche bornée : {“IdxID”:”ValeurDébut”, “IdxID_to”:”ValeurFin”}
Par exemple, La valeur IdxID numérique serait 1012, cela donnerait : {“1012″:”01/01/2022”, “1012_to”:”30/06/2022″}
L’archivage de documents électroniques
Voici la séquence d’appels pour déclencher l’archivage d’un document dans Damaris RM :
- /rest/services/auth/login
- Soumettre le login et le mot de passe crypté
- Récupérer uniqueKey
- /rest/services/archiving/getDocumentTypes
- Soumettre uniqueKey
- Récupérer les docTypeID
- /rest/services/archiving/getDocumentTypeIndexes
- Soumettre uniqueKey, docTypeID
- Récupérer les résultats dont indexID
- /rest/services/archiving/archiveElectronicDocument
- Soumettre uniqueKey docTypeID et les indexID
- Soumettre également le PDF à archiver
- Récupérer le statut et le numéro unique de dépôt archiveID
- /rest/services/auth/logout
- Soumettre uniqueKey
La modification des index
- /rest/services/auth/login
- Soumettre le login et le mot de passe crypté
- Récupérer uniqueKey
- /rest/services/archiving/getDocumentTypes
- Soumettre uniqueKey
- Récupérer les docTypeID
- /rest/services/search/updateArchiveIndex
- Soumettre uniqueKey, archiveID, indexID et la nouvelle valeur d’index
- /rest/services/auth/logout
- Soumettre uniqueKey
Les méthodes concernant la gestion des archives physiques
Pour rappel, la solution Damaris RM propose en standard la gestion des archives physiques.
Pour cela, un ensemble de méthodes API web services est disponible pour vous permettre d’interagir avec la solution de Records Management et intégrer les différentes fonctions depuis vos propres outils.
Voici la liste de ces appels :
Méthode | Description |
/rest/services/archiving/getBoxTypes | Retrouve la liste des types de boites déclarés dans le système |
/rest/services/archiving/getStorages | Retrouve la liste des sites de stockage |
/rest/services/archiving/localize | Localisation d’article ou de boite |
/rest/services/archiving/packaging | Conditionnement d’articles dans une boite |
/rest/services/archiving/receive | Réception des articles ou des boites |
/rest/services/archiving/relocalize | Relocalisation |
/rest/services/declaration/doDeclaration | Permet de déclarer un nouvel article ou boite |
/rest/services/declaration/getBatches | Retrouve la liste des lots de versements |
/rest/services/declaration/getDocumentStorageYears | Retrouve la durée utile de conservation pour une typologie |
/rest/services/declaration/getFinalStates | Retrouve le sort final pour une typologie |
/rest/services/declaration/getParentBoxCodes | Retrouve la boite parent pour un article ou une boite |
/rest/services/prediction/predict | Propose des actions pour un code boite |
/rest/services/prediction/storageInfo | Liste les actions à effectuer sur un site donné |
/rest/services/requests/changeRequestStatus | Fait évoluer le statut d’une demande de sortie |
/rest/services/requests/doRequest | Effectue une demande de sortie |
/rest/services/requests/getRequestReasons | Retrouve la liste des motifs de demandes |
/rest/services/requests/getRequestTypes | Retrouve la liste des types de demandes |
Les Contrôleurs disponibles
Ici, il convient de citer les différents “Contrôleurs” qui sont un regroupement de méthodes par grande fonction de Damaris RM.
Voici la liste des contrôleurs et des méthodes pour chaque.
NB : Vous trouverez tous ces éléments depuis votre interface Swagger de Damaris RM.
Contrôleur | Courte description |
archiving-controller | Regroupe toutes les fonctions nécessaires pour archiver de nouveaux documents. Vous y trouverez les méthodes vous permettant d’obtenir les différentes informations pour composer vos flux JSON à soumettre à Damaris RM. |
authentication-controller | Concerne essentiellement les méthodes pour connecter un utilisateur ou pour gérer les jetons de connexion. |
bookmarks-controller (Damaris RM v10) | Permet d’accéder aux marques pages créées par l’utilisateur connecté ou de les mettre à jour. |
contract-controller | Accédez aux conventions de dématérialisation destinées à l’utilisateur connecté. Il est également possible de gérer sa décision, l’acceptation ou le refus de la convention. |
declaration-controller | Sert pour la gestion des archives physiques et particulièrement, la gestion des lots de versements. |
documentsignature-controller (Damaris RM v10) | Permet à un utilisateur invité de signer numériquement un document qui lui est présenté. |
documentuploaderportal-controller (Damaris RM v10) | Le portail de téléversement de fichiers en vue de leur traitement dans les projets configurés. |
messages-controller | Regroupe les méthodes de la messagerie interne à Damaris RM, l’envoi des notifications vers Damaris Mobile ou la possibilité de créer un nouveau ticket Hotline dans Damaris Extranet. |
my-basket-controller (Damaris RM v10) | Tous les appels API pour la gestion de la fonction “Mon Panier”. |
mydashboard-controller (Damaris RM v10) | Gère le Tableau de bord utilisateur en lui permettant de mettre à jour et d’accéder aux objets qui y sont positionnés. |
prediction-controller | Utilisez la fonction de prédiction pour obtenir des informations pertinentes concernant les archives physiques. Cette fonction aide les archivistes à mieux gérer leurs fonds. |
projects-controller | Transmet des données statistiques et quantitatives vers Damaris Extranet pour alimenter la gestion centralisée des projets. |
requests-controller | Regroupe les méthodes pour la gestion des demandes de sorties et la gestion des sorties et des retours des boites d’archives physiques. |
scanning-controller | Retrouvez ici toutes les méthodes vous permettant de gérer les projets de numérisation massive de documents. Cela correspond aux fonctions de Scanning Centers multi-scanners et multi-sites. |
search-controller | Regroupe toutes les fonctions de recherches de documents et l’obtention des résultats de recherches. |
stamps-controller | Ajoutez et vérifiez la présence des Tampons électroniques sur les documents. Faites évoluer l’état d’avancement de vos documents dans vos Workflows. |
statisticsws-controller (Damaris RM v10) | Accédez aux informations statistiques sur le fonds d’archives. |
supplier-portal-controller | Ce sont les API de dépôt et de suivi des factures fournisseurs. Vos fournisseurs peuvent exploiter ces API REST pour déposer leurs factures à votre destination. |
tasks-controller | Gérez vos tâches automatisées ou manuelles. Vous pouvez les déclencher à distance depuis vos autres processus. |