Overview
This node interacts with the "Mes-Démarches" API of French Polynesia to retrieve information about administrative procedures ("démarches") and their related dossiers (files). It supports three main operations:
- Lister Les Dossiers: Lists dossiers associated with a specific démarche, with options for filtering, sorting, and selective data inclusion. Useful for synchronizing or monitoring dossier statuses.
- Consulter Une Démarche: Retrieves detailed information about a single démarche, optionally including instructor groups, managing service info, and revision details. Ideal for getting metadata and structure of a démarche.
- Consulter Un Dossier: Fetches complete information about a specific dossier, including optional fields like annotations, treatments, messages, opinions, corrections, and geographic data.
Practical examples:
- Automatically syncing new or updated dossiers for a given démarche to an external database.
- Displaying detailed démarche metadata in a dashboard.
- Reviewing full dossier details for case management or auditing.
Properties
| Name | Meaning |
|---|---|
| Numéro De Démarche | Number identifying the démarche to consult (required for "listDossiers" and "getDemarche"). |
| Inclure Les Groupes Instructeurs | Whether to include instructor groups and their members (boolean, default true, for "getDemarche"). |
| Inclure Le Service | Whether to include managing service information (boolean, default true, for "getDemarche"). |
| Inclure La Révision | Whether to include revision details such as field structure (boolean, default false, for "getDemarche"). |
Note: The above properties are relevant for the "Consulter Une Démarche" operation under the "Default" resource.
Output
The output JSON structure for the "Consulter Une Démarche" operation is the raw démarche object returned by the API, containing all available details according to the requested inclusions. This includes:
- Basic démarche info: id, number, title, state.
- Optional groups of instructors and their members.
- Managing service information.
- Revision details describing the field structure if requested.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the "Mes-Démarches" API.
- The node makes POST requests to a GraphQL endpoint on the configured server URL.
- The API token must be provided via n8n credentials configuration.
- No other external dependencies are required.
Troubleshooting
Error: "Démarche [number] non trouvée ou non accessible"
This indicates that the specified démarche number does not exist or the API token lacks permission to access it. Verify the démarche number and ensure the API key has sufficient rights.GraphQL Errors
If the API returns errors, they will be reported with messages from the GraphQL response. Check the validity of parameters and API token.Network or Authentication Failures
Ensure the API token is correctly set and the server URL is reachable.Empty or Unexpected Data
Confirm that the requested inclusions (groups, service, revision) are supported for the démarche and that the démarche contains data.
Links and References
- Mes-Démarches API Documentation (French) (Replace with actual URL if available)
- n8n Documentation - Creating Custom Nodes
- GraphQL Basics