Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Cas d'usage

Revue de Presse

Cas d'usage : créer un type de document Revue de presse, puis un rapport de requête qui liste les revues et leurs pièces jointes.

Cas d'usage : Revue de presse

Une revue de presse est un genre journalistique et entrepreneurial qui consiste en une compilation d'articles de presse généraliste ou spécialisée, à une échelle géographique et temporelle choisie. Cette synthèse peut relever juridiquement du panorama de presse si elle ne répond pas à certains critères, dont la gratuité.

Pour la création d'un espace lié à la création d'une Revue de presse il faut :

    1. Créer un endroit dans le Dokos qui permet de stocker les informations.
    1. Pouvoir générer des rapports, qui contiennent des informations sur les revues de presse et le chemin de visualisation des fichiers associés.

Solution

Comment créer un espace dédié à la création de Revues de presse ?

  • Il faut créer un nouveau type de document qui correspondra au dossier des revues de presse.

Dans Dokos, vous pouvez retrouver tous les types de document dans la liste Type de document : cliquez sur l'icône loupe de la barre latérale gauche (ou Ctrl+K) et recherchez Type de document.

1. Créer un nouveau modèle de Type de document

  1. Allez sur la liste de tous les types de document
  2. Cliquez sur + Créer un·e Type de document

  1. La fenêtre Créer un nouveau type de document s'ouvre.
  2. Nommer le document dans le champ Nom
  3. Sélectionnez le Module qui sera associé au document.
  4. Cliquez sur Créer & Continuer.

Dans l'onglet Formulaire, vous pouvez définir tous les champs du document. Il s'agit des champs que les utilisateurs devront remplir pour valider une Revue de presse.

Exemple fictif. Ajoutez les champs suivants. Le rapport de la partie 2 utilise ces noms de champ.

ÉtiquetteNom du champType
ContactcontactLien vers Contact
ClientclientLien vers Client
Date de publicationdateDate
SujetsujetDonnées
DescriptiondescriptionÉditeur de texte

Les informations de la table

Cliquez sur Ajouter un champ dans une colonne pour ajouter un champ, puis sélectionnez-le pour renseigner ses propriétés dans le panneau de droite :

  1. Étiquette : Nom du champ créé.
  2. Le Type permet de définir le type de ces données, il existe plusieurs choix possible. Les plus utilisés sont :
    • Type Données : Vous pouvez renseigner du texte personnalisé.
    • Type Lien : Vous pouvez choisir les données d'un autre document et il vous permet de rediriger et lier le document à un autre.
    • Type Date : le champ est mis sous le format d'une date.
    • Type Sélectionner : Vous pouvez donner des choix en Options …
  3. Obligatoire : si la case est cochée, le champ doit être rempli pour enregistrer le document.
  4. Options : Quand le Type de donnée est Sélectionner ou Lien, vous devez saisir les choix ou le nom de type de document pour rediriger la page...

Pour segmenter votre document en plusieurs parties (par exemple, Détails généraux, Table des articles, Termes et conditions), ajoutez des sections et des colonnes depuis le menu ⋯ d'une section (Ajouter une section en dessous, Ajouter une colonne). Faites glisser les champs pour les réorganiser.

  1. Dans l'onglet Nom, définissez le nom qui sera généré à la création d'un document. Vous pouvez définir la façon de nommer les différents documents en ce type avec la Règle de nommage. Ici on choisit Expression et on remplit "REVUE.#####" dans le champ Nom auto.
  2. Enregistrer le nouveau document.
  3. Créez votre premier document pour votre revue de presse en recherchant Revue de presse avec l'icône loupe de la barre latérale gauche (ou Ctrl+K).

2. Créer un Rapport : Revue de Presse

Deux autres cas d'usage décrivent la création de rapports :

  1. Rapport de requête
  2. Rapport de script.

Ici, créez un Rapport de requête.

Seul un utilisateur qui a le rôle Gestionnaire de script peut enregistrer un rapport de requête qui n'est pas standard. La requête doit commencer par SELECT ou EXPLAIN : Dokos refuse les autres instructions SQL.

Pour ouvrir la liste des rapports, cliquez sur l'icône loupe de la barre latérale gauche (ou Ctrl+K) et saisissez ‘Rapport’.

  1. Cliquez sur + Créer un·e Rapport en haut à droite.
  2. Le Nom du Rapport : 'Revue de Presse'
  3. Le Type de Rapport : sélectionnez « Rapport de Requête ».
  4. Le Doctype de Réf. : sélectionnez « Revue de Presse », le type de document que vous venez de créer. Les autorisations de ce type de document s'appliquent au rapport.
  5. Cliquez sur Enregistrer.

  1. Ajoutez des colonnes de rapport dans Colonnes et écrivez la requête dans la section Requête / Script.

2.1 Écrire la requête

  1. Ajoutez une ligne par colonne dans le tableau Colonnes.
  2. Saisissez le nom du champ dans Nom du champ.
  3. Saisissez le titre de la colonne dans Étiquette.
  4. Sélectionnez le Type de champ qui correspond aux données.

Les colonnes de la table suivent l'ordre des colonnes du SELECT.

Écrivez le code suivant :

SELECT contact, client, date, sujet, description
FROM `tabRevue de Presse`

Pour afficher le résultat de rapport, cliquez sur le bouton Afficher le rapport en haut à droite après avoir enregistré :

Pour obtenir un PDF, ouvrez le menu ⋯ en haut à droite et cliquez sur Imprimer. Une page d'aperçu s'ouvre. Cliquez sur PDF.

2.2 Ajouter le lien de fichier associé dans le rapport

Les pièces jointes d'une revue de presse ne sont pas stockées dans la table tabRevue de Presse. Dokos crée un document Fichier pour chaque pièce jointe. Ce document garde le type de document et le nom du document auquel il est lié.

  1. Allez dans le fichier associé

Pour ouvrir la liste des fichiers, cliquez sur l'icône loupe de la barre latérale gauche (ou Ctrl+K), saisissez ‘Fichier’ et choisissez Liste : Fichier.

  1. Cliquez sur le fichier "YUKI SCRIPT RAPPORTc94640" que nous avons ajouté dans le Pièces jointes. Nous pouvons observer les données de ce fichier comme Nom du fichier, URL du fichier, Lié au type de document, Lié au document...

  1. Pour connaître les noms de ces champs, cliquez sur les trois points en haut à droite et cliquez sur Personnaliser. Dans l'onglet Formulaire, sélectionnez un champ pour voir son Nom et son Type de données dans le panneau de droite.

  1. Retournez dans le rapport Revue de Presse
  2. Ajoutez une colonne file_url dans Colonnes. Puis modifiez la requête :
SELECT r.contact, r.client, r.date, r.sujet, r.description,
(SELECT GROUP_CONCAT(file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r

Voici le résultat que vous allez avoir :

2.3 Afficher des URL complètes

Pour obtenir une URL complète, ajoutez l'adresse de votre site avant l'URL du fichier. Les captures ci-dessous utilisent le site https://tierslieux.dokos.io. Remplacez cette adresse par celle de votre site.

Un fichier privé a une URL qui commence par /private/files/. Seul un utilisateur connecté qui a accès au document peut l'ouvrir.
SELECT r.contact, r.client, r.date, r.sujet, r.description,
(SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r

Voici le résultat donné :

Vous pouvez tester le rapport avec plusieurs revues de presse et ajouter plus de fichiers associés dans chaque document.

Exécutez à nouveau le code :

SELECT r.contact, r.client, r.date, r.sujet, r.description,
(SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r

Le rapport affiche une ligne par revue de presse, quel que soit leur nombre.

Quand une revue a plusieurs fichiers, la fonction GROUP_CONCAT() sépare les liens par des virgules.

Pour afficher un lien par ligne, remplacez les virgules par des retours à la ligne (<br>) :

SELECT r.contact, r.client, r.date, r.sujet, r.description,
REPLACE((SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse"),",","<br>")
FROM `tabRevue de Presse` AS r