Actions à exécuter à l'aide d'URL

Vous pouvez effectuer diverses actions dans Therefore™ Web Client à l'aide d'URL. Elles peuvent également être déclenchées par une application tierce dotée de la fonctionnalité d'intégration requise.

Où rechercher les ID uniques

Pour que les actions à exécuter à l'aide d'URL fonctionnent, vous avez besoin d'ID uniques de catégories, de processus de workflow, de champs de données d'index, etc.

ID de catégorie et de processus de workflow

Les ID de catégorie et de processus de workflow sont affichés dans Therefore™ Solution Designer. Accédez au référentiel et cliquez sur le répertoire contenant la catégorie ou le processus de workflow pour identifier l'ID correspondant.

Image indiquant où trouver l'ID de catégorie dans Therefore™ Solution Designer

ID de champ

Vous accédez à l'ID unique d'un champ de données d'index dans Therefore™ Solution Designer. Cliquez avec le bouton droit de la souris sur la catégorie contenant le champ de données d'index et sélectionnez « Ouvrir catégorie » pour ouvrir la définition de la catégorie. Dans la définition de la catégorie, cliquez avec le bouton droit de la souris sur un champ de données d'index et sélectionnez « Propriétés » pour ouvrir la boîte de dialogue Propriétés du champ. Vous y trouverez l'ID du champ.

ID de tâche ad hoc, de document et d'instance de workflow

Recherchez la tâche ad hoc, le document ou l'instance de workflow dans n'importe client Therefore™ (Therefore™ Navigator, Therefore™ Web Client ou Therefore™ Go, par exemple) pour trouver son ID unique. Les ID uniques sont libellés respectivement « Nº de tâche », « ID document » et « Nº d'instance ».

Liste d'actions à exécuter à l'aide d'URL

Ouvrir un processus de workflow	Syntaxe de l'URL : Copier `https://tenantname.thereforeonline.com/tdwv/#/workflows/X` Remplacez « X » par l'ID du processus de workflow. Exemple : Copier `https://moyawarefinance.thereforeonline.com/tdwv/#/workflows/6`
Ouvrir une instance de workflow déterminée	Syntaxe de l'URL : Copier `https://tenantname.thereforeonline.com/tdwv/#/workflows/instance/X/1` Remplacez « X » par le numéro de l'instance de workflow. En option, ajoutez « ?v=Y » pour accéder à différents numéros de version en réglant Y sur la version à ouvrir. Exemple : Copier `https://moyawarefinance.thereforeonline.com/tdwv/#/workflows/instance/X/1`
Consulter un document spécifique	Syntaxe de l'URL : Copier `https://tenantname.thereforeonline.com/tdwv/#/document/X` Remplacez « X » par l'ID du document. En option, ajoutez « ?v=Y » pour accéder à différents numéros de version en réglant Y sur la version à ouvrir. Exemple : Copier `https://moyawarefinance.thereforeonline.com/tdwv/#/document/626?v=2`
Créer un document dans une catégorie déterminée	Syntaxe de l'URL : Copier `https://tenantname.thereforeonline.com/tdwv/#/document/new/X` Remplacez « X » par l'ID de la catégorie à laquelle doit appartenir le document. Exemple : Copier `https://moyawarefinance.thereforeonline.com/tdwv/#/document/new/67`
Afficher la rechercher avancée par défaut	Syntaxe de l'URL : Copier `https://tenantname.thereforeonline.com/tdwv/#/search/category/X?v=adv` Remplacez « X » par l'ID de la catégorie dans laquelle effectuer la recherche. Exemple : Copier `https://moyawarefinance.thereforeonline.com/tdwv/#/search/category/301?v=adv`

Personnalisation de la liste de résultats

Les actions exécutées à l'aide d'une URL permettent aux utilisateurs de personnaliser les recherches sans quitter la liste de résultats. Ces modifications ne sont pas mémorisées et ne modifient pas une recherche mémorisée. Vous pouvez mémoriser l'URL en tant que telle pour accéder à la requête de recherche modifiée.

Lorsque vous modifiez une requête de recherche, vous pouvez ajouter d'autres paramètres après le symbole « & » dans l'URL. Ces paramètres doivent comprendre un ID de champ, ainsi qu'un opérateur issu du tableau ci-dessous et une valeur de référence.

Opérateur	Notation symbolique	Exemple d'utilisation
Inférieur à (<)	lt	__<field_id>-lt=’valeur’
Inférieur ou égal à (<=)	lte	__<field_id>-lte=’valeur’
Supérieur à (>)	gt	__<field_id>-gt=’valeur’
Supérieur ou égal à (>=)	gte	__<field_id>-gte=’valeur’
Égal à (=)	eq	__<field_id>-eq=’valeur’
Différent de (!=)	ne	__<field_id>-ne=’valeur’
Plage	from, to	__<field_id>-r=’valeur1’::’valeur2’
Contient	c	__<field_id>-c=’valeur’
Ne contient pas	nc	__<field_id>-n=’valeur’
Commence par	sw	__<field_id>-sw=’valeur’
Se termine par	ew	__<field_id>-ew=’valeur’

Exemple

Liste de résultats filtrée pour n'afficher que les documents dans lesquels la valeur du champ « Employee Name » commence par « An ».

Copier

https://moyawarefinance.thereforeonline.com/tdwv/#/repository/search/hitlist/category/75?queryNo=119&__Employee_Name-sw=An

Listes de résultats associées aux tâches

Les clés et valeurs ci-dessous permettent de créer des paramètres de requête relatifs aux tâches afin de partager la requête avec d'autres utilisateurs ou de l'utiliser dans une intégration.

Clés	Valeurs	Exemple d'utilisation	Informations complémentaires
`created_by`	`current_user`; `all_users`	Récupérez toutes les tâches assignées à l'utilisateur en cours : `tasks?created_by=all_users&assigned_to=current_user`
`assigned_to`	`current_user`	Récupérez toutes les tâches traitées par l'utilisateur en cours : `tasks?assigned_to=current_user&status=completed`	La clé « assigned_to » est facultative. Si vous ne la spécifiez pas, toutes les tâches sont affichées.
`overdue`	`yes`	Récupérez toutes les tâches en retard créées par l'utilisateur en cours : `tasks?created_by=current_user&overdue=yes`	La clé « overdue » est facultative.
`status`	`in_progress`; `not_started`; `completed`	Récupérez toutes les tâches créées par l'utilisateur en cours qui n'ont pas commencé : `tasks?status=not_started&created_by=current_user`	La clé « status » est facultative.
`due`	`today`; `next_week`	Récupérez toutes les tâches créées par l'utilisateur en cours à terminer aujourd'hui : `tasks?created_by=current_user&due=today`

Exemple :

Récupérez toutes les tâches terminées créées par l'utilisateur en cours.

Copier

https://moyawarefinance.thereforeonline.com/tdwv/#/tasks?status=completed&created_by=current_user