Guide d'administration expert Partager l'accès à un rapport Création de liens de partage
28 mai 2024 à 05:35Création de liens de partage
Avertissement
Un lien de partage peut aujourd’hui seulement être créé via l’API.
Via l’API
- Aller sur la page Web de l’API
https://petit-rapporteur.mondomaine.example/api/docs/
- Cliquer sur le bouton en haut à droite
Authorize
et entrer les identifiantsroot
dans les champsusername
etpassword
puis cliquer sur le boutonAuthorize
en bas pour s’authentifier - Déplier la route
POST /v1/shares
(exemplehttps://petit-rapporteur.mondomaine.example/api/docs#/shares/shares_create_share_v1_shares__post
- Cliquer sur le bouton
Try it out
pour éditer les paramètres de la requête - Dans le champ
Request body
copier le contenu suivant en remplaçant[id-du-rapport]
par l’ID du rapport{ "comment": "Nom affiché en haut à droite", "policies": [ { "report_id": "[id-du-rapport-1]", "field_id": "*", "actions": [ "report:list", "report:read", "report:write", "report:create", "report:share", "report:edit", "report:delete" ], "filters": null, }, { "report_id": "[id-du-rapport-2]", "field_id": "*", "actions": [ "report:read", "report:write" ], "filters": [ { "field_name": "AT", "field_data": "01. PACA" } ], } ] },
- Cliquer sur le bouton
Execute
pour lancer la création du rapport - Utiliser la chaîne de caractère appelée TOKEN qui a été obtenue afin de former un lien de partage de la forme suivante (penser à bien ajouter le
/s/
après le nom de domaine et avant le TOKEN) :https://petit-rapporteur.mondomaine.example/s/TOKEN
Exemple de JSON pour simplement autoriser la modification d’un rapport :
{
"comment": "Nom qui sera affiché en haut à droite de l'interface",
"policies": [
{
"report_id": "[id-du-rapport]",
"field_id": "*",
"actions": [
"report:read",
"report:write"
]
}
]
}
Note
On peut supprimer ou rajouter des filtres en modifiant le JSON (supprimer les “,” finales si inutiles).
Note
Par défaut seuls les rapports qui ont la permission report:read
sont affichées dans la liste des rapports sur la page d’accueil.
Pour afficher la liste entière de tous les rapports, il faut ajouter la permission report:list
.
Cependant cette permission n’accorde pas le droit de lecture aux autres rapports lorsque l’on clique dessus dans la liste.