Code source wiki de Alfresco

Modifié par jhurst le 2023/05/10 14:45
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 = Prérequis =
6
7 * Un serveur Alfresco (les développements et tests ont été effectués avec la version Community) (gratuite) d’Alfresco
8 * Les identifiants de l’administrateur Alfresco (pour la configuration serveur)
9 * La connaissance (non poussée) de l’arborescence Alfresco (pour la configuration serveur)
10 * La création d’un ou de plusieurs utilisateurs Alfresco avec les mêmes noms utilisateurs définis dans Digdash
11
12 = Utilisateur Digdash / utilisateur Alfresco =
13
14 Nous supposons dans ce document que l’utilisateur connecté Digdash existe également dans Alfresco avec le même nom d’utilisateur (login).
15
16 = Création d’un nouveau serveur de documents Alfresco =
17
18 DigDash Enterprise vous permet de récupérer des fichiers stockés sur un compte Alfresco.
19
20
21 * Via le Studio Digdash
22
23 Pour créer un nouveau serveur de documents Alfresco dans le Studio Digdash :
24
25 (% class="box infomessage" %)
26 (((
27 Ouvrir l’Enterprise Studio de Digdash > **Gestionnaires (Ctrl + G)** > **Serveurs**
28 )))
29
30 (% style="text-align:center" %)
31 [[image:Capture d’écran 2022-09-14 à 14.52.21.png||height="360" width="569"]]
32
33 Cliquez sur le signe **+** :
34
35 (% style="text-align:center" %)
36 [[image:Capture d’écran 2022-09-14 à 14.55.01.png||height="276" width="693"]]
37
38 (% style="text-align: center;" %)
39 __//Capture : Création d’un nouveau serveur de documents Alfresco//__
40
41 * Via l'administration du serveur
42
43 (% style="text-align:center" %)
44 [[image:Capture d’écran 2022-09-14 à 14.56.48.png]]
45
46 (% style="text-align:center" %)
47 [[image:Capture d’écran 2022-09-14 à 14.57.43.png||height="520" width="1106"]]
48
49 (% style="text-align: center;" %)
50 //Capture : Accès au gestionnaire de documents via l'adminconsole//
51
52 = Configuration serveur =
53
54 * Via le Studio Digdash
55
56 (% style="text-align:center" %)
57 [[image:Capture d’écran 2022-09-14 à 14.59.14.png]]
58
59 (% style="text-align: center;" %)
60 __//Capture écran : Configuration serveur pour Alfresco via le Studio//__
61
62
63 * Via l'adminconsole
64
65 (% style="text-align:center" %)
66 [[image:Capture d’écran 2022-09-14 à 15.00.28.png]]
67
68 (% style="text-align:center" %)
69 [[image:Capture d’écran 2022-09-14 à 15.01.40.png||height="351" width="1060"]]
70
71 (% style="text-align: center;" %)
72 (% dir="ltr" lang="fr" %)//__Capture écran : Configuration serveur pour Alfresco via l'adminconsole__//
73
74
75 == Identifiants (Nom / Mot de passe) ==
76
77 L’utilisateur connecté Digdash (quel qu’il soit) sera //toujours// connecté au serveur Alfresco selon les identifiants admin.
78
79 == URL ==
80
81 Préciser l’adresse du serveur Alfresco et le numéro du port si besoin.
82
83 == Chemin (Chemin des documents de l'utilisateur) ==
84
85 Le chemin pour effectuer les actions (définies dans la suite) est à préciser de la manière suivante :
86
87
88 (% style="color:#c0392b" %)Site(%%)/(% style="color:#c0392b" %)Container(%%)/(% style="color:#27ae60" %)Uploaddirectory
89
90
91 (% style="color:#c0392b" %)Site (%%)et (% style="color:#c0392b" %)Container (%%)sont (% style="color:#c0392b" %)obligatoires
92
93 (% style="color:#27ae60" %)Uploaddirectory (%%)est (% style="color:#27ae60" %)optionnel
94
95
96 |= |= |=
97 |Site/ |Container/ |Uploaddirectory
98 |Nom du site |Espace de partage de documents qui apparaitront sur le site (« Document Library » la plupart du temps) http://docs.alfresco.com/5.1/concepts/library-intro.html////[[http://docs.alfresco.com/5.1/concepts/library-intro.html]] |le chemin d’accès
99
100 (% style="text-align: center;" %)
101 __Tableau : modèle du chemin Alfresco pour effectuer les actions__
102
103
104 Exemple :
105
106 (% style="text-align:center" %)
107 [[image:1588078362097-699.png||queryString="width=491&height=707" height="707" width="491"]]
108
109 (% style="text-align: center;" %)
110 //__Capture : Exemple d’arborescence Alfresco pour un site exemple (site nommé “swsdp”)__//
111
112
113 Soit le chemin suivant : (% style="color:#c0392b" %)swsdp(%%)/(% style="color:#c0392b" %)documentLibrary(%%)/(% style="color:#27ae60" %)test(%%)/(% style="color:#27ae60" %)retest
114
115 |= |= |=
116 |Site/ |Container/ |Uploaddirectory
117 |Nom du site |Espace de partage de documents qui apparaitront sur le site (« Document Library » la plupart du temps) http://docs.alfresco.com/5.1/concepts/library-intro.html////[[http://docs.alfresco.com/5.1/concepts/library-intro.html]] |le chemin d’accès
118 |(% style="background-color:#c0392b" %)swsdp/ |(% style="color:#c0392b" %)documentLibrary/ |(% style="color:#27ae60" %)test/retest
119
120 (% style="text-align: center;" %)
121 __//Tableau : Chemin vers un site Alfresco par exemple//__
122
123 == Exploration des sous-dossiers ==
124
125 Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents.
126
127 Par défaut, la recherche de documents s’effectue de manière récursive et va explorer tous les sous-dossiers.
128
129 (% style="text-align:center" %)
130 [[image:1588079186851-894.png||queryString="width=955&height=240" height="240" width="955"]]
131
132 (% style="text-align: center;" %)
133 __Tableau pour l’exploration des documents pour le connecteur Alfresco__
134
135 == Droits d'accès (limités) ==
136
137 Bien qu’en permanence connecté en tant qu’Admin sur le serveur Alfresco, nous avons décidé de restreindre les droits de l’utilisateur (autre qu’Admin) jusqu’à un certain point en suivant les exigences d’Alfresco.
138
139
140 (% style="text-align:center" %)
141 [[image:10000000000002A0000000A6CBC2D1E9DE87383C.png]]
142
143 (% style="text-align: center;" %)
144 __Tableau : Rôle et permissions pour les documents côté Alfresco__
145
146
147 Ainsi, un visiteur (utilisateur non invité sur le site, Consumer dans Alfresco) ne se verra octroyer seulement des droits de lecture et téléchargement.
148
149 Nous avons arbitrairement choisi de ne pas restreindre les droits (côté Alfresco) quant aux actions qui ne seraient possibles que si l’utilisateur connecté Digdash était créateur du document (Cases oranges).
150
151 = Actions possibles =
152
153 *Selon les règles et dans le répertoire indiqué dans la configuration serveur Alfresco
154
155 == Recherche par mots-clés ==
156
157
158 (% style="text-align:center" %)
159 [[image:1588080269602-554.png||queryString="width=774&height=286" height="286" width="774"]]
160
161 (% style="text-align: center;" %)
162 //__Capture : Barre de recherche de documents par mots-clés__//
163
164
165 L’utilisateur connecté Digdash pourra rechercher des documents dans le répertoire indiqué dans le serveur ET les répertoires enfants en indiquant des mots clés dans la barre de recherche de manière récursive.
166
167 Si le champ de recherche est vide alors « * » est appliqué (tous les documents du répertoire ET des répertoires enfants seront affichés de façon récursive).
168
169 == Téléchargement ==
170
171 (% style="text-align:center" %)
172 [[image:1588080373562-382.png||queryString="width=716&height=310" height="310" width="716"]]
173
174 (% style="text-align: center;" %)
175 __//Capture : Icône de téléchargement//__
176
177
178 C’est une action de base. Chaque utilisateur connecté Digdash est autorisé au minimum au droit de lecture sur n’importe quel site dans Alfresco, notamment celui indiqué dans la configuration serveur.
179
180 Le téléchargement est possible via l’icône.
181
182 == Dépôt de documents ==
183
184 (% style="text-align:center" %)
185 [[image:Capture d’écran 2022-09-14 à 15.07.55.png||height="405" width="1072"]]
186
187 (% style="text-align: center;" %)
188 //__Capture : Dépôt de document dans le serveur de documents Alfresco__//
189
190
191 Selon le rôle de l’utilisateur courant Digdash dans Alfresco, il lui est permis de déposer des documents dans le répertoire indiqué dans la configuration serveur Alfresco (Voir Tableau : //Rôle et permissions pour les documents côté Alfresco//).
192
193 (% class="box infomessage" %)
194 (((
195 **NB** : Dans Digdash, il est préférable de déposer des documents avec une extension explicite.
196 )))
197
198 Trois options sont disponibles :
199
200 * **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.** **La boîte **Ouvrir **s'affiche
201 * **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...).
202 * **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 ».
203
204 __Pour aller encore plus loin : (version v1 de cette fonctionnalité) :__
205
206 (% class="box infomessage" %)
207 (((
208 Les champs « auteur » et « propriétaire » du document sont mis à jour avec le nom de l’utilisateur connecté Digdash lors du dépôt du nouveau document. S’il n’a pas le droit, un message indiquera que le dépôt n’aura pu être effectué.
209 )))
210
211 == Édition de documents ==
212
213 (% style="text-align:center" %)
214 [[image:1588080761937-671.png||queryString="width=942&height=246" height="246" width="942"]]
215
216 (% style="text-align: center;" %)
217 //__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__//
218
219 L’action est possible via l’icône .[[image:1588080812551-865.png||queryString="width=20&height=21" height="21" width="20"]]
220
221 Selon le rôle de l’utilisateur courant Digdash dans Alfresco, il lui est permis de modifier les documents sur lesquels il a un droit d’édition (voir tableau). Il peut s’agir des actions suivantes.
222
223 === Mise à jour du contenu ===
224
225 L’utilisateur ayant les droits a la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis son système.
226
227 (% class="box warningmessage" %)
228 (((
229 Avec seule cette action, le nom du document sur lequel l’opération s’effectue gardera son nom.
230 )))
231
232 S’il n’a pas le droit, un message indiquera que la mise à jour n’aura pu être effectuée.
233
234
235 === Renommage ===
236
237 L’utilisateur ayant les droits a la possibilité de renommer un document. Il précisera dans le champ prévu à cet effet le nouveau nom à donner au document sans extension.
238
239 S’il n’a pas le droit, un message indiquera que la mise à jour n’aura pu être effectuée.
240
241 (% class="box infomessage" %)
242 (((
243 **A savoir** : La mise à jour du contenu d’un document et le renommage sont deux actions possibles simultanément.
244 )))
245
246 == Suppression ==
247
248 L’utilisateur ayant les droits a la possibilité de supprimer un (ou des) document(s) existant(s) dans le chemin de la configuration serveur Alfresco.
249
250 Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux check box.
251
252 L’action est possible via l’icône [[image:1588080932094-115.png||queryString="width=19&height=22" height="22" width="19"]] .
253
254 S’il n’a pas le droit, un message indiquera que la suppression n’aura pu être effectuée.
255
256
257