Code source wiki de Serveur de documents Google Drive
Modifié par jhurst le 2022/04/28 16:42
Afficher les derniers auteurs
author | version | line-number | content |
---|---|---|---|
1 | {{ddtoc/}} | ||
2 | |||
3 | Annexe | ||
4 | |||
5 | {{ddchildren/}} | ||
6 | |||
7 | ---- | ||
8 | |||
9 | = Prérequis = | ||
10 | |||
11 | * Un compte de service pour stocker les documents et un fichier .p12 (voir point suivant) | ||
12 | * Avoir suivi les instructions du document [[Google Drive - Configuration>>doc:.google_drive_config.WebHome]] pour la récupération des données de configuration (compte de service et fichier .p12). | ||
13 | |||
14 | = Création d’un nouveau serveur de documents Google Drive = | ||
15 | |||
16 | Vous pouvez récupérer des fichiers stockés sur un compte Google Drive (un compte de service, voir le fichier configuration). | ||
17 | |||
18 | * Via le Studio | ||
19 | |||
20 | Pour créer un nouveau serveur de documents Google Drive dans le Studio : | ||
21 | |||
22 | Ouvrir le studio > Menu **Outils** > **Gestionnaire des serveurs de documents… Ctrl+U **>** Nouveau** | ||
23 | |||
24 | (% style="text-align:center" %) | ||
25 | [[image:1599033571167-541.png||height="391" width="442"]] | ||
26 | |||
27 | |||
28 | (% style="text-align: center;" %) | ||
29 | [[image:1599033634184-215.png||height="345" width="720"]] | ||
30 | |||
31 | (% style="text-align: center;" %) | ||
32 | //__Capture : Création d’un nouveau serveur de documents Google Drive__// | ||
33 | |||
34 | * Via le navigateur | ||
35 | |||
36 | (% style="text-align:center" %) | ||
37 | [[image:1599033789668-439.png||height="483" width="470"]] | ||
38 | |||
39 | (% style="text-align: center;" %) | ||
40 | [[image:1599033876251-910.png||height="360" width="419"]] | ||
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:1599034105448-344.png||height="396" width="498"]] | ||
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:1599034178861-334.png||height="250" width="564"]] | ||
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:1599034268355-477.png||height="310" width="686"]] | ||
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:1599034330410-829.png||height="279" width="621"]] | ||
116 | |||
117 | (% style="text-align: center;" %) | ||
118 | [[image:1599034368159-192.png||height="352" width="545"]] | ||
119 | |||
120 | (% style="text-align: center;" %) | ||
121 | //__Capture : Dépôt de document dans le serveur de documents Google Drive__// | ||
122 | |||
123 | (% class="box infomessage" %) | ||
124 | ((( | ||
125 | **NB** : Dans Digdash, il est vivement conseillé de déposer des documents avec une extension explicite. | ||
126 | ))) | ||
127 | |||
128 | Trois options sont disponibles : | ||
129 | |||
130 | * **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.** **La boîte **Ouvrir **s'affiche | ||
131 | * **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...). | ||
132 | * **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 ». | ||
133 | |||
134 | == Édition de documents == | ||
135 | |||
136 | |||
137 | (% style="text-align: center;" %) | ||
138 | [[image:1599034632548-462.png||height="317" width="703"]] | ||
139 | |||
140 | (% style="text-align: center;" %) | ||
141 | //__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__// | ||
142 | |||
143 | L’action est possible via l’icône [[image:google_drive_fr_html_5bf0156c61aee07c.png]] . | ||
144 | |||
145 | Il peut s’agir des actions suivantes. | ||
146 | |||
147 | === Mise à jour du contenu === | ||
148 | |||
149 | Vous avez la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis votre système. | ||
150 | |||
151 | (% class="box warningmessage" %) | ||
152 | ((( | ||
153 | Seulement avec cette action, le nom du document sur lequel l’opération s’effectue gardera son nom. | ||
154 | ))) | ||
155 | |||
156 | === Renommage === | ||
157 | |||
158 | 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. | ||
159 | |||
160 | == Suppression == | ||
161 | |||
162 | Vous avez la possibilité de supprimer un (ou des) document(s) existant(s) dans le Google Drive du compte de service. | ||
163 | |||
164 | Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux cases à cocher. | ||
165 | |||
166 | L’action est possible via l’icône [[image:google_drive_fr_html_3f54b9224a4c4ef3.png]] . | ||
167 | |||
168 | = Conversions possibles = | ||
169 | |||
170 | |**Type de fichier**|**Format Google** | ||
171 | |doc|(% rowspan="11" %)**Google Docs** | ||
172 | |docx | ||
173 | |odt | ||
174 | |html | ||
175 | |rtf | ||
176 | |txt | ||
177 | |jpg | ||
178 | |png | ||
179 | |gif | ||
180 | |bmp | ||
181 | |||
182 | |xls|(% rowspan="5" %)**Google Sheets** | ||
183 | |xlsx | ||
184 | |ods | ||
185 | |csv | ||
186 | |tsv | ||
187 | |ppt|(% rowspan="3" %)**Google Slides** | ||
188 | |pptx | ||
189 | |odp |