Modifié par jhurst le 2024/04/02 14:25
Afficher les derniers auteurs
1 **Documentation**
2
3 {{ddtoc/}}
4
5 ----
6
7 (% class="wikigeneratedid" %)
8 = Prérequis =
9
10 * Un compte de service pour stocker les documents et un fichier .p12 (voir point suivant)
11 * Avoir suivi les instructions du tutoriel « google_drive_config_fr.pdf » pour la récupération des données de configuration (compte de service et fichier .p12).
12
13 = Création d’un nouveau serveur de documents Google Drive =
14
15 Vous pouvez récupérer des fichiers stockés sur un compte Google Drive (un compte de service, voir le fichier configuration).
16
17 * Via le Studio
18
19 Pour créer un nouveau serveur de documents Google Drive dans le Studio :
20
21 Ouvrir le studio > Menu **Outils** > **Gestionnaire des serveurs de documents… Ctrl+U **>** Nouveau**
22
23 (% style="text-align:center" %)
24 [[image:google_drive_fr_html_f2443f74ab7ce8f1.gif||height="150" width="488"]]
25
26
27 (% style="text-align:center" %)
28 [[image:google_drive_fr_html_24c0b9ada443daae.gif||height="131" width="501"]]
29
30 (% style="text-align: center;" %)
31 //__Capture : Création d’un nouveau serveur de documents Google Drive__//
32
33 * Via le navigateur
34
35 (% style="text-align:center" %)
36 [[image:google_drive_fr_html_d057beaef5d1f988.png||height="253" width="472"]]
37
38
39 (% style="text-align:center" %)
40 [[image:google_drive_fr_html_50b6c75132116e78.png||height="291" width="486"]]
41
42 (% style="text-align: center;" %)
43 //__Capture : Accès au gestionnaire de documents via le navigateur__//
44
45 = Configuration serveur =
46
47 * Via le Studio Digdash
48
49 (% style="text-align:center" %)
50 [[image:google_drive_fr_html_4edc275e460fdc64.png||height="267" width="376"]]
51
52 (% style="text-align: center;" %)
53 //__Capture écran : Configuration serveur pour Google Drive via le Studio__//
54
55
56 * Via le navigateur
57
58 (% style="text-align:center" %)
59 [[image:google_drive_fr_html_be5239c10f297d3c.png||height="347" width="380"]]
60
61 (% style="text-align: center;" %)
62 //__Capture écran : Configuration serveur pour Google Drive via le navigateur__//
63
64 == Nom du serveur ==
65
66 Donnez un nom à votre nouveau serveur de documents Google Drive.
67
68 == Configuration des paramètres Google Drive ==
69
70 |**Compte de service** :|Il s’agit de l’identifiant sous forme d’adresse e-mail récupéré lors de la création du compte dans la console Google developers.
71 |**Fichier .p12 **:|(((
72 Il s’agit de la clé secrète sous forme de fichier .p12 généré et que vous aurez téléchargée lors de la création du compte dans la console Google developers.
73
74 Via le navigateur, vous devez dans un premier temps choisir dans la première liste déroulante le serveur de documents sur lequel votre fichier .p12 est stocké et dans la deuxième liste choisir ce dernier.
75 )))
76 |**Partagé avec** :|(((
77 Dans ce champ, nous attendons les adresses e-mail des personnes avec lesquelles les documents de ce serveur Google Drive seront partagés. Ces utilisateurs recevront alors une notification (par e-mail) dès lors qu’un nouveau document sera disponible sur ce serveur. Ces nouveaux documents seront notamment visibles sur leur compte Google Drive dans la section « «Partagés avec moi ».
78
79 Vous devrez **séparer par une virgule ou un point-virgule** chaque adresse e-mail dans le cas de multiples utilisateurs.
80 )))
81 |**Convertir au format Google :**|Si cette option est sélectionnée, les dépôts des documents s’effectueront toujours dans le format Google correspondant si cela est possible (Voir annexe 1). Si le dépôt en format Google n’est pas possible, le document sera déposé dans son format original.
82
83 __**Rappel :**__
84
85 Un compte de service, même si vous l’avez créé, n’est lié en aucune manière au compte Google Drive du compte Google par lequel vous êtes passé pour le créer.
86
87 Ce compte de service est un compte Google à part entière et possède son propre Google Drive, Google Calendar, etc.
88
89 Lorsque vous opérez un dépôt de document sur un compte de service, celui-ci atterrira sur le Google Drive de ce compte de service et non sur le Google Drive du compte qui a servi à le créer.
90
91 (% class="box infomessage" %)
92 (((
93 **NB** : Il n’y a pas d’interface Web pour un compte de service, ce qui signifie que vous ne pourrez pas vous identifier et consulter ce qui aura été déposé. Ceci peut être réalisé uniquement via un client qui est capable d’exploiter ce compte de service, comme le propose Digdash.
94 )))
95
96 = Actions possibles =
97
98 Via la version web du gestionnaire des serveurs de documents, vous avez la possibilité d’agir sur les fichiers sur le Google Drive du compte de service.
99
100 == Téléchargement ==
101
102 (% style="text-align:center" %)
103 [[image:google_drive_fr_html_67e705157290917c.png||height="251" width="396"]]
104
105 (% style="text-align: center;" %)
106 //__Capture : Icône de téléchargement__//
107
108 C’est une action de base. Chaque utilisateur connecté à DigDash est autorisé au minimum au droit de lecture.
109
110 Le téléchargement est possible via l’icône [[image:google_drive_fr_html_fb114753cc5d7478.png]] .
111
112 == Dépôt de documents ==
113
114 (% style="text-align:center" %)
115 [[image:google_drive_fr_html_66947601b357b42f.png||height="309" width="672"]]
116
117 (% style="text-align: center;" %)
118 //__Capture : Dépôt de document dans le serveur de documents Google Drive__//
119
120
121 (% class="box infomessage" %)
122 (((
123 **NB** : Dans Digdash, il est vivement conseillé de déposer des documents avec une extension explicite.
124 )))
125
126 Trois options sont disponibles :
127
128 * **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.**  **La boîte **Ouvrir  **s'affiche
129 * **Entrer une URL** : Entrez l'URL de votre document. Si la case **Ajouter uniquement le lien URL au serveur de documents **est décochée, le contenu pointé par l'URL est téléchargé une seule fois vers le serveur de documents. Si la case **Ajouter uniquement le lien URL au serveur de documents **est cochée, le contenu pointé par l'URL est téléchargé par le serveur à chaque fois qu'il en a besoin (pour une source de données ou sur demande d'un utilisateur). Dans ce dernier cas, l'URL doit être accessible par le serveur. Vous pouvez aussi insérer des variables utilisateur dans l'URL (${user.uid}... voir documentation). Vous pouvez utiliser une URL "file:~/~/", mais dans ce cas le mode **Ajouter uniquement le lien URL au serveur de documents **est forcé. L'URL "file:~/~/" doit être un fichier sur un disque du serveur. Le nom du lien doit se terminer par l'extension propre au type de fichier ajouté (.csv, .html...).
130 * **Créez un nouveau lien **: Créez un nouveau lien vers un document sur le serveur : Le fichier pointé est le dernier document (dans l'ordre alphabétique) correspondant au lien. Par exemple, un lien « document*.csv » pointera vers le dernier fichier CSV commençant par « document ».
131
132 == Édition de documents ==
133
134 (% style="text-align:center" %)
135 [[image:google_drive_fr_html_189827ef3162082f.png||height="170" width="554"]]
136
137 (% style="text-align: center;" %)
138 //__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__//
139
140 L’action est possible via l’icône [[image:google_drive_fr_html_5bf0156c61aee07c.png]] .
141
142 Il peut s’agir des actions suivantes.
143
144 === Mise à jour du contenu ===
145
146 Vous avez la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis votre système.
147
148 (% class="box warningmessage" %)
149 (((
150 Seulement avec cette action, le nom du document sur lequel l’opération s’effectue gardera son nom.
151 )))
152
153 === Renommage ===
154
155 Vous avez la possibilité de renommer un document. Vous préciserez dans le champ prévu à cet effet le nouveau nom à donner au document sans extension.
156
157 == Suppression ==
158
159 Vous avez la possibilité de supprimer un (ou des) document(s) existant(s) dans le Google Drive du compte de service.
160
161 Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux cases à cocher.
162
163 L’action est possible via l’icône [[image:google_drive_fr_html_3f54b9224a4c4ef3.png]] .
164
165 = Annexes =
166
167 == **Annexe 1 : Conversions possible** ==
168
169 |**Type de fichier**|**Format Google**
170 |doc|(% rowspan="11" %)**Google Docs**
171 |docx
172 |odt
173 |html
174 |rtf
175 |txt
176 |jpg
177 |png
178 |gif
179 |bmp
180 |pdf
181 |xls|(% rowspan="5" %)**Google Sheets**
182 |xlsx
183 |ods
184 |csv
185 |tsv
186 |ppt|(% rowspan="3" %)**Google Slides**
187 |pptx
188 |odp