View source for Module Ressources

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Resources -->
[[en:Module_Resources]]
[[es:Módulo_de_recursos]]
<!-- END interlang links -->
[[Category:Ressources]]
[[Category:Liste_des_Modules]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Ressources|
num=0|
devdoc=[[Module Ressources (développeur)]]|
userdoc=Cette page|}}
= Introduction =
Le module de ressources est un module principal de Dolibarr. Il est facultatif et fait partie du groupe de travail Projets / Collaboratif dans la liste des modules.

L'objectif principal du module est d'enregistrer les ressources de l'organisation telles que les salles, les matériaux, les clés, ... et de pouvoir les affecter à des événements dans l'agenda (principe de réservation)



== Que fait ce module? ==

* Gérer une liste de ressources.
* Type de ressource de support.
* Prise en charge de l'ajout de notes à la ressource (public, privé)
* Ressources de support avec des contacts / utilisateurs
* Supporter des liens vers des documents et / ou des URL. 
* Si le module d'événement est activé, vous pouvez lier des ressources à un événement.

= Installation =
{{NoInstallModuleFr}}

= Configuration =
Below are the options available to configure this module.
== Set-up options ==
There is currently no set-up options for the module.
== Dictionaries ==
The module comes with the the "Type of resources" dictionary.

By default this dictionary is empty. 

Go to the '''Setup''' menu and select '''Dictionaries''' to enter a list of values to categorize your resources.

The module also use the "Contact/Address types" dictionary, and populate it by default to associate a contact or a user responsible for the resource.

== Permissions ==

# Read resources	 	
# Create/modify resources	 	
# Delete resources	 	
# Link resources to agenda events

By default there is no default permission.

Go to the '''Setup''' menu and select '''Security''' to define some ( 1 and 4 is a good choice).

= Usage =
The module is available from the '''Agenda''' icon available in Dolibarr top menu.

= Entities and Business rules =
== Resource ==
This is the main and unique object added by this module.

=== Resource properties ===

;Name:Name of the resource. Mandatory. Does not need to be unique.
;Type:Value from "Type of Resource" dictionary. To categorize your resources, could be used to sort the resources list.
;Description:A text to describe your resource.
;Public Notes:A text area (html) to store public notes on the resource.
;Private Notes:A text area (html) to store private notes on the resource.

=== Resource links ===
;Users:You could allocate multiple users to a resource, specifying a role. Actually the only role defined by default is 'In charge of resource', but you could extend it if needed. Note there is no limitation to number of users linked, even with the same role.
;Contacts:You could allocate multiple contacts - from different third parties - to a resource, specifying a role. Actually the only role defined by default is 'In charge of resource', but you could extend it if needed. Note there is no limitation to number of contacts linked, even with the same role. Contact and User roles could be different if needed. 
;Documents:You could upload multiple document files and link them to the Resource.
;URL:You could attach multiple URL link to a resource.
;Event:When the Agenda module is activated, it is possible to select resources needed on any event. You could define if the resource is mandatory or not for the event and is free or not. This means the system is not checking the actual resource availability you need to check it manually.

= Examples of use cases =
{{ExamplesCaseEn
|name=List Resources: 
|situation=You want to get the full list of resources
|actions= Go to Tools -> Resources. The resources list opens. You could sort the list by Reference or Type.
 Selection will be available on Dolibarr 5.0
}}&nbsp;
{{ExamplesCaseEn
|name=Create Resource: 
|situation=You get a new resource
|actions= Go to Tools -> New Resource. The resource card opens. Fill-it and save. It should now be available in list.
}}&nbsp;
{{ExamplesCaseEn
|name=Modify Resource: 
|situation=You need to update a resource property
|actions= Go to Tools -> List Resources. The resource list displays. Select the resource. The resource card opens. Click Modify. You could modify properties. Save. The card reflects the changes.
}}&nbsp;
{{ExamplesCaseEn
|name=Delete Resource: 
|situation=You need to remove a resource
|actions= Go to Tools -> List Resources. The resource list displays. Select the resource. The resource card opens. Click Delete. The resource will be deleted and confirmation message will shows up.
 If you delete a resource allocated to an event, you will end up with a blank resource for this event. Delete is not checking if the resource is used or not.
}}&nbsp;
{{ExamplesCaseEn
|name=Inactivate Resource: 
|situation=You need to remove a resource that could not be used any more but keep it's history.
|actions= None
 Not available yet will require an active or inactive status
}}&nbsp;
{{ToComplete}}