En général, lors de la recherche de documents à exporter avec docXporter, il suffit de définir des critères de recherche simples avec des valeurs fixes. Vous trouverez des informations détaillées sur ce cas d'utilisation dans l'article Configurer docXporter.
Cet article présente des options plus sophistiquées pour rechercher des documents. Si vous ne connaissez pas docXporter ou si vous n'avez pas encore effectué la configuration de base, nous vous recommandons de lire d'abord l'article sur la configuration.
Opérations de recherche de base
Syntaxe pour travailler avec des opérateurs tels que supérieur à ou inférieur à : Value="~~[OPT]~~SEARCHFORVALUE"
Exemple d'une recherche dans le champ COMPANY pour tous les documents commençant par Peters :
<Object Name="DWArchivFilter" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
<Item Name="COMPANY" Value="Peters*" />
</Object>Exemple de caractères spéciaux, qui nécessitent un échappement :
<Object Name="DWArchivFilter" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
<Item Name="DOCUMENTTYPE" Value="Invoice\(incoming\)"/>
</Object>Dans l'exemple ci-dessus, les parenthèses ( ) sont échappées avec une barre oblique inverse \ ; cela s'applique à d'autres caractères spéciaux.
Exemple d'une recherche dans le champ COUNTER pour des documents dont la valeur est supérieure à 1 000 et inférieure à 2 000 :
<Object Name="DWArchivFilter" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
<Item Name="COUNTER" Value="~~[gt]1000~~[lt]2000" />
</Object>Exemple d'une recherche dans le champ interne DWSTOREDATETIME pour des documents archivés au cours des 3 derniers jours (y compris le jour en cours) :
<Object Name="DWArchivFilter" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
<Item Name="DWSTOREDATETIME" Value="~~[gte]~~DATE(-3D)~~[lte]~~DATE()" />
</Object>Autres options et leur description :
[ne]différent de (correspond à<>dans DocuWare)[lt]inférieur à (correspond à<dans DocuWare)[gt]supérieur à (correspond à>dans DocuWare)[lte]inférieur ou égal à (correspond à<=dans DocuWare)[gte]supérieur ou égal à (correspond à>=dans DocuWare)
Des valeurs fixes peuvent également être utilisées à la place d'une variable.
<Object Name="DWArchivFilter" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
<Item Name="DWSTOREDATETIME" Value="~~[gte]~~01.01.2021~~[lte]~~31.12.2021" />
</Object>Périodes de recherche prédéfinies
Utilisez ces fonctions pour générer directement une chaîne de recherche.
Par exemple, la fonction SEARCH_YEAR() est remplacée par ~~[gte]01.01.2021~~[lte]~~31.12.2021.
Ces fonctions ne peuvent être utilisées que de manière exclusive, car elles génèrent un filtre de recherche complet.
SEARCH_YEAR()
Renvoie une période de recherche du 01.01 au 31.12 de l'année en cours.
SEARCH_MONTH()
Renvoie une période de recherche du premier au dernier jour du mois en cours.
SEARCH_QUARTER()
Renvoie une période de recherche du premier au dernier jour du trimestre en cours.
En spécifiant un paramètre tel que -1 ou +1, la valeur de retour est ajustée en conséquence. N'importe quelle valeur peut être spécifiée. L'opérateur -/+ doit toujours être indiqué.
Les fonctions traitent le paramètre en fonction du contexte. Par exemple, YEAR(-1) renvoie l'année précédente, tandis que MONTH(-1) renvoie le numéro du mois précédent.
Périodes de recherche flexibles
Ici, la chaîne de recherche n'est pas compilée automatiquement, mais vous permet de définir des périodes plus flexibles. La fonction DATE() est disponible à cet effet.
En spécifiant un paramètre tel que -1D ou +1D, la valeur de retour est ajustée en conséquence. N'importe quelle valeur peut être spécifiée. Le caractère -/+ doit toujours être indiqué ; il est également nécessaire de préciser quelle partie de la date doit être modifiée.
Utilisez la lettre D pour les jours, M pour les mois et Y pour les années. Cela permet d'indiquer à la fonction DATE() quelle partie de la date doit être modifiée.
Exemples
DATE() | 24.06.2024 |
DATE(+10D) | 04.07.2024 |
DATE(-1M) | 23.05.2024 |
« Rechercher au cours des 2 dernières semaines »
~~[gte]DATE(-14D)~~[lte]~~DATE(-1D), ce qui donne ~~[gte]10.06.2021~~[lte]~~23.06.2021
Paramètres
Dans les exemples ci-dessus, aucune valeur n'a été utilisée entre les parenthèses des fonctions. Cela signifie que la date actuelle est toujours utilisée comme point de départ pour le résultat.
En spécifiant un paramètre tel que -1 ou +1, la valeur de retour est ajustée en conséquence. N'importe quelle valeur peut être spécifiée. Le caractère -/+ doit toujours être indiqué.
Les fonctions traitent le paramètre en fonction du contexte. Par exemple, YEAR(-1) renvoie l'année précédente, tandis que MONTH(-1) renvoie le numéro du mois précédent.
Avec les fonctions du groupe 1, le paramètre de la fonction a également un effet contextuel. Il renvoie ainsi des périodes correspondant à l'année précédente ou aux mois précédents.