Professional Documents
Culture Documents
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 1/53
1 ABOUT ALFRESCO...........................................................................................................................3
1.1 ALFRESCO................................................................................................................................................3
1.2 MAIN VOCABULARY..................................................................................................................................3
2 USING ALFRESCO............................................................................................................................5
2.1 THE DIFFERENT AVAILABLE ACCESS WAYS TO ALFRESCO REPOSITORY............................................................5
2.2 THE WEB INTERFACE.................................................................................................................................5
2.2.1 LOGGING IN...........................................................................................................................................5
2.2.2 FIRST CONNECTION.................................................................................................................................6
2.2.3 WORKSPACES.........................................................................................................................................7
2.2.4 CONTENT ITEMS.....................................................................................................................................9
2.2.5 ROLES.................................................................................................................................................10
2.2.6 THE TRASH..........................................................................................................................................11
2.3 CREATING A SPACE.................................................................................................................................11
2.4 CREATE A CONTENT ITEM........................................................................................................................13
2.5 MODIFY SPACE OR CONTENT PROPERTIES..................................................................................................15
2.6 GET THE LINK OF A CONTENT OR A SPACE.................................................................................................16
2.7 CLASSIFY A CONTENT..............................................................................................................................16
2.8 START AND PARTICIPATE TO A DISCUSSION.................................................................................................18
2.9 THE PERSONAL SPACE..............................................................................................................................20
2.9.1 QUOTAS..............................................................................................................................................20
2.9.2 STATISTICS...........................................................................................................................................20
2.9.3 THE SPACE/CONTENT EFFECTIVENESS........................................................................................................22
2.9.4 EXTERNAL ACCOUNTS............................................................................................................................24
2.9.5 SHARING DOCUMENTS............................................................................................................................24
2.9.6 MANAGE MULTILINGUAL CONTENT...........................................................................................................28
3 THE LEFT COLUMN.......................................................................................................................30
3.1 THE NAVIGATION BAR..............................................................................................................................30
3.2 CLIPBOARD............................................................................................................................................31
3.3 RECENT SPACES......................................................................................................................................31
3.4 SHORTCUTS............................................................................................................................................32
4 WEBDAV...........................................................................................................................................33
4.1 WEBDAV ACCESS....................................................................................................................................33
4.2 WEBDAV CLIENTS...................................................................................................................................33
5 IMPORT / EXPORT .........................................................................................................................34
5.1 EXPORT.................................................................................................................................................34
5.2 IMPORT..................................................................................................................................................35
6 CONTENT RULES............................................................................................................................36
Alfresco User guide Date: 20/03/2008
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 2/53
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 3/53
ABOUT ALFRESCO
1.1 Alfresco
Alfresco is an Enterprise scale Content Management system (ECM), designed
to users who require a high degree of modularity and scalable performance.
Alfresco includes a content repository, an out-of-the-box web portal framework
for managing and using standard portal content.
It allows document management, document sharing, repository-level
versioning, publishing, mail notification, workflow, effectiveness duration,
multiple accesses, advanced search, desktops.
Usable from a Web browser by all INRIA agents, it is also opened to non-INRIA
partners thanks to a mechanism for creating external user accounts.
1.2 Main Vocabulary
-
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 4/53
events. Those events are: the creation of a new space / content, the
update of an existing space, or the moving of en existing space / content.
-
Webdav: Webdav enables use alfresco without the web interface. With
webdav, Alfresco can be seen as a network disk alfresco. It enables drag
and drop in example from the desktop to alfresco.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 5/53
USING ALFRESCO
The web interface is the richest in terms of possibilities: you can upload files,
create spaces, share documents, interact with other users, etc... Accessing
through CIFS and Webdav is more limited since the interface is the one of a File
Explorer. Although they allow making mass imports using the Copy-Paste tool,
they cannot let you interact with other users workspaces of contents.
Note: a CIFS interface also exists but this one is not usable outside the Alfresco
server network.
2.2 The web interface
2.2.1 Logging in
To get identified in Alfresco and access to the web interface, you just have to
open a web browser (Internet Explorer, Firefox) and go to the address that your
administrator should give you.
You get to this page, where you have to provide your connection id (User Name,
password):
Your username and password are the same as defined in the INRIA LDAP
directory (these are those used to connect to your computer).
Alfresco User guide Date: 20/03/2008
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 6/53
Search bar
Title bar
Main Area
Navigation bar
The navigation bars (on the left side and on the top of the screen), will lead you
to the same areas:
: Hide the left shelf in order to sets the main area in a wider view
: go to this guide
: log out.
The search toolbar allows you to ask for a simple term in the whole Alfrescos
database.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 7/53
2.2.3 Workspaces
The interface of a workspace is as follows:
Number of content rules managing
the space
Subspaces
Contents
The left navigation column is deployed, in order to let you see this spaces sub
tree (the subspaces). Then, you can easily browse the different spaces of
Alfresco. Clicking on an arrow
deploys the subspaces sub tree for the
selected Area.
On the main screen of the current space, you will find:
-
The list of the subspaces of the current space, in the Browse spaces
bloc.
The content items belonging to the current space, in the content items
bloc.
Clicking on the title of some space or some content will lead you to its browsing
page (for a space) or to the download interface (for a document).
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 8/53
This icon
displays pieces of information about
the selected item.
For instance, if you selected a PDF file, it will show
you the first words of it:
The available actions concerning the content items (and spaces) depend on the
role you have (see below). These actions can be seen:
- Under each content item or space:
View details is the most important: it gets you into the details view of the item
(space or document), that provides much useful information. As for a space, you
will see:
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 9/53
Meta-datas
concerning
effectiveness
duration
Meta-data displayed
Available actions,
depending on the
role you have on the
space
If the statistics have been defined for the current space, you can see statistics in the
details view (and also in the navigation view):
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 10/53
Displayed information and actions here are pretty similar as for spaces.
2.2.5 Roles
Update / Edit
X
X
Add contents
Edit properties/metadatas
Coordinator
Collaborator
Contributor
Editor
Consumer
Roles provide users rights for a given space /content. Alfresco distinguishes 5
roles as follows:
Manage rights
Take ownership
Roles are given to one or more users on spaces or contents. Coordinator role has
all rights and is usually assigned to the space manager. The coordinator then
provides roles to other users depending on the rights he wants to give them to
the space or contents.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 11/53
User option
Then click on Manage deleted items , at the bottom of the page:
You can search for a document by entering his title, or by filtering by date:
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 12/53
A form opens:
You have to fill in three text fields. Name and title may be the same. Validate by
clicking on create space. Space is created then.
You might want to choose another method, if you need to build a space
corresponding to a specific model. Then, click on create / advanced space
wizard:
Using a template is identical to the previous one, except the fact that
you will have to choose among the space models your administrators
have designed.
Alfresco User guide Date: 20/03/2008
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 13/53
, on this screen:
Then click on upload, this will copy the file from your computer to the current
space.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 14/53
The add content dialog now tells you that the file was successfully uploaded.
You can still cancel the upload, clicking on cancel or on the icon
uploaded content bloc.
in the
Most of the fields are already filled in, since Alfresco knows how to read
standard formats (PDF, Excel, Word ).
Click on OK to end the Upload operation.
Alfresco will display the current spaces browse page. You can view the uploaded
document:
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 15/53
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 16/53
View in browser : give the link to view the document in the web browser
Details page URL : give the link to access to the content detail page (this
page)
Alfresco Node Reference: give the unique node reference. When an error
occurs, your administrator may want you to give this link.
To get these links, right click on the wanted label, and Copy link address on
Firefox, or Copy shortcut on Internet Explorer.
2.7 Classify a content
You must have the role of editor, collaborator, or coordinator to classify content.
In order to easily find a document, it can be useful to give it a keyword.
Keywords are then used in the advanced search to get all documents with a
particular keyword. We both can say keyword or category.
To affect a keyword to a document, you must go on the details view, then click
on , in the Category panel.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 17/53
2. Click here
category tree.
to
display
the
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 18/53
, in the content
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 19/53
You have to fill the mandatory field ( * ), then click on Create topic :
Discussion icon
Each discussion is displayed here as a unique topic. You can click on a title to
display messages:
Click here to reply to this
message.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 20/53
Action displayed depends on the role you have. A consumer is allowed to browse
messages. An editor is allowed to edit existing post, but cant reply, and a
contributor can only reply. A collaborator also has the right to edit previous
post, and a coordinator has all rights on the discussion.
The coordinator can manage the discussion rights, on the discussion details
view:
Discussion details
2.9.2 Statistics
In order to let you know the disk space you are filling in your home space, you
can apply a
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 21/53
To do so, go on the detail view of your home space, and click on the arrow near
Custom view. Then click on Apply a custom view and choose the view
stats_view_EN.ftl.
=>
Statistics are not up to date: you have to click on Refresh , and you will also
have to click on Refresh after each modification.
Once statistics are calculated we get the following information:
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 22/53
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 23/53
Click here to
modify metadatas
Effectiveness dates.
Empty after creation
(edit meta-
Free-text field
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 24/53
Basic information is needed to create this account. Once created the concerned
user will receive a mail with his login data. In this mail the user is asked to
change the generated password the first time he will log on Alfresco. Each
external account has a validity date: when this date is outdated, account is
automatically deleted. 30 days before that, an email is sent to you and to this
person to remember you that is will be deleted.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 25/53
instead.
Rights meanly work with inheritance. The checkbox Inherit parent space
permissions allows you to accept or not this inheritance. Warning, you cannot
see directly which are parent permissions: you have to go on the parent space
for that. Inheritance means that when a user will have a right on a parent
space, he will have the same right on the current space.
In order to add or remove permissions, click on Invite:
Then, enter the name of a group in the second field, and choose the
corresponding value in the first field (groups / user).
Be careful:
- to search for a user, you will have to enter his lastname or his firstname.
It wont search by the login or the email.
-the use of iLDAP groups must be done with great caution. In case of doubt
about the iLAP group members contact your local support.
Then you have to choose a role for the user:
INRIA Alfresco
GUIDE
Update / Edit
X
X
Add contents
Edit properties/metadatas
Collaborator
Page n 26/53
Contributor
Editor
Consumer
Coordinator
ALFRESCO - END-USER
Manage rights
Take ownership
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 27/53
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 28/53
Then click on Make multilingual . The next screen brings you to enter the
primary author of the document, the primary language, and the first translation
of the content:
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 29/53
In the next screen, you have to fill the properties of the translated document:
You can add as many translations as you want for a document. But the
properties displayed in the multilingual panel will always be those of the
primary document.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
THE
LEFT
GUIDE
Page n 30/53
COLUMN
The left column of the web interface contains two objects: the navigation bar
(grey-blue-colored) and the toolbox (white-colored).
It displays the root spaces. The root space you are currently browsing is
highlighted (enforced orange), and its subspaces are displayed, you can deploy
them clicking on
The toolbox offers 3 areas: clipboard, recent spaces, and shortcuts.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 31/53
3.2 Clipboard
The clipboard is the interface you will use to make copy/cut paste actions,
thanks to the icons
(that you can find under every item: space or
document). Clicking on one of these will load the clipboard with the selected
item:
Clipboard buttons:
: The trashcan button allows you to suppress the item from the clipboard
(NOT from Alfresco).
: This button allows you to paste the clipboards content in the current
space.
: This button allows you to create a link (shortcut) to the clipboards content
in the current space.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 32/53
The recent spaces bloc is automatically filled in when youre browsing alfresco.
It just displays the spaces you were recently browsing. Users cannot delete
spaces from this box.
3.4 Shortcuts
This functionality is devoted to providing users a list of links to their favorite
spaces or documents. To create a shortcut to an item, go to the details view of
this item (icon
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 33/53
WEBDAV
4.1 Webdav access
Alfresco can be used by the webdav protocol. That means with the file browser
on Windows, Mac OS, and Linux. It may be possible to use an external
application to use Alfresco through webdav.
The webdav URL of the alfresco root is:
https://partage.inria.fr/alfresco/webdav.
To go directly to a specific space it can be accessed by its Webdav link. To get
the Webdav link just go on the details view, right-click on the link "View in
WebDAV" then "Copy Link" in Firefox, or "Copy Shortcut" under Internet
Explorer.
Disclaimer: by accessing to spaces with Webdav, it is not possible to use in a
reliable ways Alfresco features such as version management and document
locking. That is why we do not recommend Webdav access except for the initial
space creation and feeding. For any other action please use only the web
interface.
4.2 Webdav clients
The most important thing to remember is that if required, you have to
use webdav with UTF-8 client (otherwise some special characters such
as accentuated ones, will not be dealt properly).
-
Linux and Mac: the file browser allows Webdav link access, if it is using
utf-8.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 34/53
IMPORT / EXPORT
5.1 Export
The export feature can be used to backup or move big space, through the web
interface. The export generates an .acp file.
Alfresco will export :
-
arborescence
rules
role
Enter a title for your export package, and choose a destination to save your
export. The include sub-spaces option is almost mandatory if you want to save
all the arborescence. The include this space option allows you to export or not
the root space. If you choose this option, the root space of your export will be
this space. If not, the root spaces will be the all subspaces of the space.
To get your export, just go to the destination you have chosen, and download
the .acp file:
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 35/53
5.2 Import
It is possible to import .acp files and zip files, if you are coordinator of a space.
To import, just go under the details view of the space you want to import
something and click on Import:
For a zip file, Alfresco will import all arborescence and documents. But if
folders are empty, they will not be created.
For a .acp, alfresco will import:
-
arborescence
rules
role
In the both case, the imported package will remain in the location you have
chosen for import, even after the import. You have to remove it manually.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
CONTENT
Page n 36/53
RULES
The next screen will show you the existing content rules:
Local column indicates whether the rule was created on this space, or that it
is just inherited from a parent one. If it is inherited, you will not be able to
disable it (from here).
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 37/53
The first step consists in choosing the condition that shall trigger the rule. Here
are the most useful ones:
-
Items of a specified type or its sub-types: will apply the rule on items
that are either folders or documents.
Items with the specified mime type: will apply the rule on documents
that have the specified mime type (PDF, Word, Excel).
Items which contain a specified value in its name: will apply the rule on
items whose name contains the entered string.
Then, you need to click on set values and add to define the parameters of the
condition you chose. For instance, if you chose items with the specified mime
type, a set condition values scrollbar will be displayed, for you to select
among Adobe PDF document, AIFF audio, etc
Once this value has been selected, you will be redirected on the create rule
wizard, step one. You can see the condition you just defined in the summary
bloc. Consequently, you can create several conditions.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 38/53
Go to next step clicking on Next. Step 2 consists in choosing the action that
will be applied when the rule is called (when the conditions previously defined
are true). Choose your action in the scrollbar:
Select the parameters of the action clicking on Set values and add.
For example, if you chose Copy the item to a specific space, you need to select
which is the target space:
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 39/53
Here, you can save and activate the rule. First, provide the rule a type:
-
inbound : the rule will apply on items coming into the current space
outbound : the rule will apply on items going out the current space
Apply rule to sub spaces: the subspaces will inherit the rule.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 40/53
CHECK-IN / CHECK-OUT
, on the
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 41/53
This will:
Create the working copy : title is the same as the original with suffix Working
Copy
The icon
near the original file means that this file is locked. It not possible to edit
Note: Only the coordinator can work on working copy created by other users.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 42/53
In order to edit the working copy, click on near the working copy icon
prompt for the file download:
. Alfresco will
The working copy is now on your desktop, you can modify what is needed. Once this
is done, you have to update the working copy.
Just click on Update on the details view of the document:
Note: This link is also available on the navigation view, under the document icon :
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 43/53
Click on update to finish the document upload. Alfresco goes back on the detail
view of the working copy.
Warning: it may be possible that Alfresco doesnt properly extract new metadata from
the updated working copy.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 44/53
To avoid this problem, you can manually extract metadata by running a specific
action. Click on Run action and select Extract metadata
If you think you have finished working on the working copy, you have to bring these
modifications into the original file. Go on the details view of the working copy and
click on
The first option will have effect only if versionning is activated on the document.
The second choice will allow you to keep the working copy after the update.
Otherwise, it will be erased.
By clicking on Check-in , the original file is updated with modifications done in the
working copy. It is also unlocked and the working copy is erased.
You can also cancel the working copy and all modifications: click on
. It will remove the working copy and unlock the original file too.
Alfresco User guide Date: 20/03/2008
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 45/53
VERSIONING
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 46/53
Note: Versionning could be automatically applied with a content rule. This rule
should add aspect Versionnable on every object of type content, incoming in the
space.
Now that versionning is activated, each update will create a new version:
You can get an old version by clicking on View . You can also put this old
version as the current version by downloading the old one, click on update, and
upload this old version.
Warning: As for the check-in/check-out, it may be possible that alfresco doesnt
extract new metadata.
To avoid this problem, you can manually extract metadata by running a specific
action. Click on Run action and select Extract metadata
When used with check-in, you can choose for a minor version change.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 47/53
You can also put a comment at the check-in. This will be displayed like that:
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 48/53
SEARCH
spaces that have the specified search value in their name or title
documents that have the specified search value either in their name, or
in their content (PDF, Word ).
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 49/53
Search settings
among the metadatas
Deploy
the
advanced settings
clicking on the
arrows
The input text field Look for is the main area. There, enter the value you want
to look for. More search options will let you select some advanced settings, like
restricting some meta-data values, or choosing the type of item you want to find.
Please notice that, for scrollbar options, you need first to click on the associated
checkbox, in order for this parameter to be taken into account:
Clicking on search will throw the search and display the results.
INRIA Alfresco
ALFRESCO - END-USER
GUIDE
Page n 50/53
The results of an advanced search are displayed the same way that those of a
standard search.
However, you will notice that a new action is available: More actions / Save
new Search.
How can you find and use later this saved search ? Just go to the advanced
search screen, and the saved search will be available in the top right scrollbar:
If you select it, Alfresco will fill in the advanced search form as you just did
when you created this search.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 51/53
Consequently, you saved the search parameters, but not the results of it,
i.e. results may vary, if documents in the repository were added, updated or
deleted.
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 52/53
10 WORKFLOW
In order to use workflow, you have to first create a space with the INRIA
workflow template. Your space will automatically have the 3 sub-spaces that
enable workflow process. Click on Create > Advanced space wizard:
If you want to send and receive mail within the workflow process, go under the
space production and click on manage content rules. You have to set up the
Alfresco User guide Date: 20/03/2008
INRIA Alfresco
ALFRESCO - END-USER
Author : Romain Delalande, Brice Chaffangeon
GUIDE
Page n 53/53
following rule: condition: all items / action: send an email / type: incoming
(be careful to uncheck apply to sub-spaces)
You can also to the same on the drafts space to be warned when documents
are rejected.
At least you have to configure rights on space Pending validation, Drafts, and
Production
Note: Smile gave the space template Simple workflow with a content rule to
automatically move document when there are accepted or rejected. For you
information, this rule is: condition: all item / action: add a basic workflow /
type: incoming.
Then when content is created under Pending validation , a workflow is
started. When document is approved, it is moved to Production. When it is
rejected, it is moved to Drafts.