> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/acropolis/administration/generateur-detats-et-requetes/gestion-des-requetes.md).

# Gestion des requêtes

Accéder aux requêtes, lancer, créer, modifier, renommer, supprimer ou copier une requête, et détail des zones et opérateurs.

## Accès et actions disponibles

Les requêtes multicritères sont disponibles à partir du menu d'Administration/Générateur d'états/requêtes multicritères.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-226043345912bee9dd5bb9f54e24c4ac2b0418c0%2Fadmin-requetes-multicriteres-creation-et-gestion-des-requetes-01.webp?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
La gestion des requêtes est soumise à autorisation. En fonction des droits accordés par l'Administrateur Acropolis, l'utilisateur peut être limité à l'exécution de requêtes. Si l'utilisateur possède les droits suffisants, les outils de gestion de requêtes sont disponibles.
{% endhint %}

Dans nos exemples, l'utilisateur possède les droits de gestion de requêtes.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-62d0d362766d42a198f0379311d4adee522d1543%2Fadmin-requetes-multicriteres-creation-et-gestion-des-requetes-02.webp?alt=media" alt=""><figcaption></figcaption></figure>

Au niveau des boutons, il est possible de :

* Actualiser
* Créer une nouvelle requête
* Renommer la requête (code)
* Supprimer une requête
* Modifier une requête
* Traduire le libellé d'une requête
* Copier une requête
* Imprimer une requête
* Importer au format XML
* Exporter au format XML
* Exporter sous Excel
* Tester la requête

### Lancer une requête

Pour lancer une requête existante, vous devez la sélectionner et cliquer sur le bouton « **Exécuter** ». Après confirmation de votre choix, la requête est exécutée et le résultat de la requête s'affiche dans le navigateur.

{% hint style="info" %}
Si la requête comporte des paramètres variables, ils vous seront demandés lors de l’exécution.

Ex : Date de naissance
{% endhint %}

### Créer une requête

Vous pouvez créer une nouvelle requête à partir du bouton « **+** » La création d'une requête est détaillée dans le paragraphe0.

### Modifier une requête

{% hint style="info" %}
Seul le propriétaire de la requête peut la modifier
{% endhint %}

Pour modifier le contenu d'une requête, vous devez sélectionner la requête, puis cliquer sur le bouton « **Modifier »**.

Le code peut être modifié à partir de la fonction **« Renommer ».** En revanche, le choix de l'élément recherché lors de la création d'une nouvelle requête est irrévocable. Seule la création d'une nouvelle requête vous permet de sélectionner un autre type d'élément recherché.

### Renommer une requête

Pour renommer une requête, vous devez sélectionner la requête, puis cliquer sur le bouton « Renommer »

Cette fonction vous permet de changer le code de la requête ou d'en changer le propriétaire.

**Exemple 1**

Vous avez créé une requête mais son code ne correspond plus à la norme de codification que vous avez mise en place dans la société. Vous sélectionnez la requête et changez le code.

**Exemple 2**

Vous avez créé une requête que vous souhaitez attribuer à votre collaborateur. Vous sélectionnez la requête et conservez son code mais en sélectionnant votre collaborateur comme nouvel utilisateur. Il en devient le propriétaire.

Après avoir sélectionné une requête et lancé la fonction, une fenêtre s'ouvre.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-cb05f0b4b216b3d73089c05ff453506cfe7f20ab%2Fadmin-requetes-multicriteres-gestion-des-requetes-01.webp?alt=media" alt=""><figcaption></figcaption></figure>

A partir de celle-ci, des informations et menu déroulants sont disponibles :

* La 1ère ligne intitulée "Ancien utilisateur" indique l'identifiant dans l'annuaire Acropolis du propriétaire de la requête, ainsi que ses nom et prénom.
* La 2ème ligne intitulée "Ancien code" renseigne sur le code et le nom actuel de la requête sélectionnée.
* Le champ intitulé "Nouvel utilisateur" vous permet de sélectionner le nouveau propriétaire parmi la liste des utilisateurs actifs Acropolis.
* Le champ intitulé "Nouveau code" vous permet de modifier l'ancien code. Un code se définit sur un champ de quinze caractères alphanumériques maximum.

Une fois les informations choisies, vous devez valider par le bouton **« Renommer ».**

La requête est renommée et éventuellement attribuée à un nouveau propriétaire. Le nouveau propriétaire hérite de tous les droits sur la requête.

{% hint style="info" %}
Lors de la création d'une requête, le propriétaire l’autorise à un ou plusieurs domaines. Si vous attribuez à un utilisateur une requête qui n’est autorisée à aucun de ces domaines, il ne la verra pas.
{% endhint %}

### Supprimer une requête

Pour supprimer une requête, vous devez sélectionner la requête désirée, puis cliquer sur le bouton **« supprimer »** o

Une fenêtre de confirmation de suppression apparaît afin d'éviter toute erreur de manipulation. Après confirmation, la requête est supprimée définitivement.

{% hint style="info" %}
Vous ne pouvez supprimer que les requêtes dont vous êtes propriétaire.
{% endhint %}

### Copier une requête

Pour copier une requête, vous devez sélectionner la requête, puis cliquer sur le bouton **« Copier »**

**Exemples :**

Vous travaillez sur des données issues d'une requête. Vous avez un collaborateur qui vous a rejoint. Vous copiez la requête à votre collaborateur afin qu'il puisse travailler sur les mêmes données que vous. De même, vous avez créé une requête type que vous souhaitez conserver. Vous pouvez la copier et ainsi modifier uniquement la copie.

Une fenêtre de sélection de critères pour la copie de la requête s'ouvre.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-4f5177fa771eef2fa3299933051a97afeddb5e55%2Fadmin-requetes-multicriteres-gestion-des-requetes-02.webp?alt=media" alt=""><figcaption></figcaption></figure>

* La ligne intitulée "Ancien utilisateur" renseigne sur le nom actuel, inscrit dans l'annuaire Acropolis, du propriétaire de la requête. A ligne suivante, on peut visualiser le code et le nom actuel de la requête.
* Le menu déroulant "Nouvel utilisateur" vous permet de sélectionner un utilisateur parmi la liste des utilisateurs actifs Acropolis à qui vous souhaitez copier la requête. Vous pouvez sélectionner un de vos collaborateurs ou vous-même.
* Le champ "Nouveau code" vous permet de saisir le code de la requête.

{% hint style="info" %}
Lorsque vous copiez 'une requête, le code doit être différent de la requête source. Dans le cas contraire, ACROPOLIS vous signale l'existence d'une requête possédant déjà ce code. Vous ne pouvez pas continuer.
{% endhint %}

* Le champ "Nouveau libellé" vous permet de saisir le libellé de la requête.

Une fois les informations saisies, vous devez valider par le bouton **« ok »**. L'utilisateur sélectionné est propriétaire d'une requête dont les critères sont identiques à la requête source.

### Création d’une requête

Après avoir sélectionné le bouton **« Ajouter »** ou « **Modifier »**, la fenêtre de détails de la requête s'ouvre.

Une requête se définie en deux parties. La première partie constitue les zones générales et la seconde les onglets d'information. Lors de la création d'une requête vous devez compléter les zones générales et les enregistrer avant de définir les informations suivantes.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-5c6d58bce32c71737b938b9aa2f4fb9d8e7d5ae3%2Fadmin-requetes-multicriteres-gestion-des-requetes-03.webp?alt=media" alt=""><figcaption></figcaption></figure>

### Zones Générales

Les zones générales sont constituées de l'ensemble des informations ci-dessous. A l'issue de la saisie des informations vous devez les enregistrer obligatoirement.

* **Un code et un libellé** : vous devez saisir un code sur quinze caractères alphanumériques maximum. Le code est à la libre saisie de l'utilisateur ; et doit être unique. Le libellé permet d'expliciter le contenu de la requête sur une zone de quarante caractères alphanumériques.
* **L'élément recherché** : vous devez définir le type d'entité recherchée par la requête. Vous avez la possibilité de sélectionner les entités suivantes :
* Entreprise
* Contact
* Action
* Dossier
* Document

{% hint style="info" %}
Il est important de préciser que la sélection de l’élément recherché est un choix irrévocable. Vous ne pourrez pas revenir sur l'élément recherché par la suite après enregistrement.
{% endhint %}

{% hint style="info" %}
En fonction de l'élément recherché, les critères de recherche sont différents.
{% endhint %}

* **La clé de parcours** : la clé de parcours détermine l'ordre d'affichage des données, issues de la requête, dans le navigateur. Vous pouvez sélectionner quatre critères : la clé, le Nom, le Type ou la Date. Il est à noter que pour une même clé de parcours, les critères d'affichage diffèrent selon le type d'éléments.

{% hint style="info" %}
Après avoir saisi les informations énoncées ci-dessus, vous devez obligatoirement valider la création de la requête. La requête est créée mais ne possède pas encore de critères.
{% endhint %}

### Onglet Description

A partir de l'onglet description, vous pouvez saisir des commentaires à propos de la requête.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-47ca2319dabc847a0f26ecd08fd137bd0c4a4404%2Fadmin-requetes-multicriteres-gestion-des-requetes-04.webp?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez saisir un commentaire sur dix lignes alphanumériques. Cette zone de saisie libre est d'autant plus intéressante qu'elle permet, dans le cadre d'une requête de droit "publique" ou "utilisateur", d'offrir aux autres utilisateurs une explication sur son but.

### Onglet domaines

L'onglet Domaines vous permet d'autoriser la requête à un ou plusieurs domaines. Seules les personnes autorisées à l'un de ces domaines verront la requête.

{% hint style="info" %}
Vous devez obligatoirement cocher au moins un domaine.
{% endhint %}

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-07f7a8071187f9c4557a4c8b17e9acdddc21a5c8%2Fadmin-requetes-multicriteres-gestion-des-requetes-05.webp?alt=media" alt=""><figcaption></figcaption></figure>

**Rappe**l : La liste des domaines disponibles varie selon les droits accordés à l'utilisateur. Chaque utilisateur Acropolis est affecté à un domaine principal et se voit accorder ou non des droits sur d'autres domaines.

En fonction des droits de l'utilisateur connecté à Acropolis, l'onglet "Domaine" comporte un ou plusieurs domaines. Ce rattachement à un domaine, permet de limiter la requête au(x) domaine(s) qui la concernent et par conséquent aux utilisateurs autorisés.

{% hint style="info" %}
Le propriétaire de la requête peut revenir sur ses choix.
{% endhint %}

### Onglet états

Cet onglet indique tous les états paramétrés pour utiliser le jeu de données issu de la requête.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-8a2ee511e10f483081aa686b85eabc7f9c1f8cb8%2Fadmin-requetes-multicriteres-gestion-des-requetes-06.webp?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Il n’est pas possible de supprimer une requête utilisée comme source d’un état.
{% endhint %}

### Onglet système

Cet onglet contient l'horodate de la requête : le créateur et la date de création ; ainsi que le dernier utilisateur à avoir modifié la requête et la date de cette modification.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-1639e62e17b6b796be297e9325a517a5718b7548%2Fadmin-requetes-multicriteres-gestion-des-requetes-07.webp?alt=media" alt=""><figcaption></figcaption></figure>

### Onglet critères

Cet onglet est le cœur de la requête. C'est à partir de cet onglet que les différents critères de la requête peuvent être ajoutées, modifiés et supprimés.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-856626648817cfc16ba60ecca0b0e85ad6dfddc0%2Fadmin-requetes-multicriteres-gestion-des-requetes-08.webp?alt=media" alt=""><figcaption></figcaption></figure>

### Opérateurs

Le tableau ci-dessous énumère la liste des opérateurs logiques disponibles :

| Opérateur | Libellé             |
| --------- | ------------------- |
|           |                     |
| =         | Egal à              |
| \`<       | Inférieur à         |
| >\`       | Supérieur à         |
| \`<=      | Inférieur ou égal à |
| >\`=      | Supérieur ou égal à |
| <>        | Différent de        |
| Entre     | Entre               |
| Contient  | Contient            |

La troisième ligne reprend l'intitulé de la zone sélectionnée. Cette ligne permet de sélectionner ou saisir une valeur de comparaison.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/acropolis/administration/generateur-detats-et-requetes/gestion-des-requetes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
