Documentations Patas-monkey - Contributions [fr]

TimeKeepR

2026-05-01T08:52:07Z

Admiw :

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:TimeKeepR-250x250.jpg]]

|TimeKeepR est un module permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.

Ce module étend les capacités natives de gestion du temps sur les éléments suivant :
* Fiche d'intervention
* Ticket
* Ordre de Fabrication natif
* Factory
* Equipement

Le but est de permettre une saisie de temps planifiées et réalisées uniforme afin d'offrir une vision mensuelle consolidée des temps
|}

== Utilisation & Fonctionnalités ==

=== Onglet de saisie des temps ===

Sur chaque élément compatible, le module ajoute un onglet dédié permettant :

La saisie des temps planifiés
La saisie des temps réalisés
La consultation de l’historique des temps saisie

L’interface reprend la logique standard de Dolibarr pour une prise en main immédiate.

=== Menu de consolidation mensuelle ===
Dans chaque menu gauche associé à un élément, un nouveau menu "Rapport TimeKeepR" est ajouté permettant d’accéder à une vue globale des temps sur un mois

Affichage des temps planifiés
Affichage des temps réalisés
Filtrage par type d’élément (interventions, tickets, etc.)
Visualisation sur une période mensuelle

Cette vue facilite :

Le pilotage de l’activité
L’analyse des écarts
Le suivi de la charge de travail

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

Fichier:TimeKeepR-250x250.jpg

2026-05-01T08:51:46Z

Admiw :

TimeKeepR

2026-04-30T15:30:36Z

Admiw :

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:TimeKeepR-250x250.png]]

|TimeKeepR est un module permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.

Ce module étend les capacités natives de gestion du temps sur les éléments suivant :
* Fiche d'intervention
* Ticket
* Ordre de Fabrication natif
* Factory
* Equipement

Le but est de permettre une saisie de temps planifiées et réalisées uniforme afin d'offrir une vision mensuelle consolidée des temps
|}

== Utilisation & Fonctionnalités ==

=== Onglet de saisie des temps ===

Sur chaque élément compatible, le module ajoute un onglet dédié permettant :

La saisie des temps planifiés
La saisie des temps réalisés
La consultation de l’historique des temps saisie

L’interface reprend la logique standard de Dolibarr pour une prise en main immédiate.

=== Menu de consolidation mensuelle ===
Dans chaque menu gauche associé à un élément, un nouveau menu "Rapport TimeKeepR" est ajouté permettant d’accéder à une vue globale des temps sur un mois

Affichage des temps planifiés
Affichage des temps réalisés
Filtrage par type d’élément (interventions, tickets, etc.)
Visualisation sur une période mensuelle

Cette vue facilite :

Le pilotage de l’activité
L’analyse des écarts
Le suivi de la charge de travail

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

TimeKeepR

2026-04-30T15:14:09Z

Admiw :

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:TimeKeepR-250x250.png]]

|TimeKeepR est un module Dolibarr permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.

Ce module étend les capacités natives de gestion du temps sur les éléments suivant :
* Fiche d'intervention
* Ticket
* Ordre de Fabrication natif
* Factory
* Equipement

|}

== Configuration ==
Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement :

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
|
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement

|}

== Utilisation & Fonctionnalités ==
Lors de la création ou de l’édition d’une note de frais (via le formulaire de gestion des notes de frais), la '''gestion des taux de TVA''' est automatiquement prise en charge afin d’éviter toute erreur de calcul.

=== Fonctionnement de base ===
'''Gestion du taux de TVA''' :
Lorsque vous modifiez le taux de TVA d’une ligne, un mécanisme interne désactive les événements clavier sur les champs de prix afin '''d’empêcher la saisie simultanée''' des valeurs '''HT''' et '''TTC'''.

Cela garantit la cohérence des calculs et évite les erreurs de saisie.

'''Exemple concret :'''
Si vous modifiez le taux de TVA d’une ligne (par exemple de '''0 %''' à '''20 %''' ou autre), les champs '''Prix HT''' et '''Prix TTC''' seront automatiquement liés.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction basique
[[File:ExtraExpense_fonction_sans_extraexpense_001.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_001.png |300px]]
|
* Si '''TVA = 20 %''' et que le '''Prix HT = 100 €''', vous ne pourrez pas remplir la case '''TTC'''.
La case '''TTC''' sera automatiquement calculée lors de la '''validation de la ligne'''.
|}

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction avec ExtraExpense
[[File:ExtraExpense_fonction_avec_extraexpense.png |300px]]

[[File:ExtraExpense_fonction_avec_extraexpense_result.png |300px]]
|
Si '''TVA = 0 %''' et que le '''Prix HT = 50 €''', vous pouvez également saisir la case '''TTC''' avec un autre montant.

Le montant de la TVA est déterminé à partir de la différence des deux montants (ici 30€ soit un taux de 60% de TVA)
|}

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

TimeKeepR

2026-04-30T14:12:59Z

Admiw :

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:TimeKeepR-250x250.png]]
|TimeKeepR permet de saisir des temps planifiés et réalisés sur les éléments suivant :

* Fiche d'intervention
* Ticket
* Ordre de Fabrication natif
* Factory
* Equipement

|}

== Configuration ==
Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement :

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
|
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement

|}

== Utilisation & Fonctionnalités ==
Lors de la création ou de l’édition d’une note de frais (via le formulaire de gestion des notes de frais), la '''gestion des taux de TVA''' est automatiquement prise en charge afin d’éviter toute erreur de calcul.

=== Fonctionnement de base ===
'''Gestion du taux de TVA''' :
Lorsque vous modifiez le taux de TVA d’une ligne, un mécanisme interne désactive les événements clavier sur les champs de prix afin '''d’empêcher la saisie simultanée''' des valeurs '''HT''' et '''TTC'''.

Cela garantit la cohérence des calculs et évite les erreurs de saisie.

'''Exemple concret :'''
Si vous modifiez le taux de TVA d’une ligne (par exemple de '''0 %''' à '''20 %''' ou autre), les champs '''Prix HT''' et '''Prix TTC''' seront automatiquement liés.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction basique
[[File:ExtraExpense_fonction_sans_extraexpense_001.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_001.png |300px]]
|
* Si '''TVA = 20 %''' et que le '''Prix HT = 100 €''', vous ne pourrez pas remplir la case '''TTC'''.
La case '''TTC''' sera automatiquement calculée lors de la '''validation de la ligne'''.
|}

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction avec ExtraExpense
[[File:ExtraExpense_fonction_avec_extraexpense.png |300px]]

[[File:ExtraExpense_fonction_avec_extraexpense_result.png |300px]]
|
Si '''TVA = 0 %''' et que le '''Prix HT = 50 €''', vous pouvez également saisir la case '''TTC''' avec un autre montant.

Le montant de la TVA est déterminé à partir de la différence des deux montants (ici 30€ soit un taux de 60% de TVA)
|}

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

TimeKeepR

2026-04-30T13:47:32Z

Admiw : Page créée avec « {| class="wikitable" |- style="vertical-align:top;" | File:TimeKeepR-250x250.png |TimeKeepR permet de saisir des temps planifiés et réalisés sur les éléments suivant : - Fiche d'intervention - Ticket - Ordre de Fabrication natif - Factory - Equipement |} == Configuration == Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement : {| class="wikitable" |- style="vertical-align:top" | width="300px" | ... »

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:TimeKeepR-250x250.png]]
|TimeKeepR permet de saisir des temps planifiés et réalisés sur les éléments suivant :

- Fiche d'intervention
- Ticket
- Ordre de Fabrication natif
- Factory
- Equipement

|}

== Configuration ==
Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement :

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
|
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement

|}

== Utilisation & Fonctionnalités ==
Lors de la création ou de l’édition d’une note de frais (via le formulaire de gestion des notes de frais), la '''gestion des taux de TVA''' est automatiquement prise en charge afin d’éviter toute erreur de calcul.

=== Fonctionnement de base ===
'''Gestion du taux de TVA''' :
Lorsque vous modifiez le taux de TVA d’une ligne, un mécanisme interne désactive les événements clavier sur les champs de prix afin '''d’empêcher la saisie simultanée''' des valeurs '''HT''' et '''TTC'''.

Cela garantit la cohérence des calculs et évite les erreurs de saisie.

'''Exemple concret :'''
Si vous modifiez le taux de TVA d’une ligne (par exemple de '''0 %''' à '''20 %''' ou autre), les champs '''Prix HT''' et '''Prix TTC''' seront automatiquement liés.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction basique
[[File:ExtraExpense_fonction_sans_extraexpense_001.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_001.png |300px]]
|
* Si '''TVA = 20 %''' et que le '''Prix HT = 100 €''', vous ne pourrez pas remplir la case '''TTC'''.
La case '''TTC''' sera automatiquement calculée lors de la '''validation de la ligne'''.
|}

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction avec ExtraExpense
[[File:ExtraExpense_fonction_avec_extraexpense.png |300px]]

[[File:ExtraExpense_fonction_avec_extraexpense_result.png |300px]]
|
Si '''TVA = 0 %''' et que le '''Prix HT = 50 €''', vous pouvez également saisir la case '''TTC''' avec un autre montant.

Le montant de la TVA est déterminé à partir de la différence des deux montants (ici 30€ soit un taux de 60% de TVA)
|}

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

Fichier:Extralist showhideline.png

2026-04-10T18:06:30Z

Admiw :

ExtraList

2026-04-10T18:06:16Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_250x250.png]]
| Le module ExtraList permet de rajouter aux listes natives de dolibarr des champs, issus des attributs personnalisés ou d'autres champs non prévu initialement à la liste:
* sélection des attributs supplémentaires disponible pour la liste
* ajout de champs supplémentaires disponible dans les tables natives de la liste ou ajouté en table jointe pour le champ
* le surlignage de lignes selon un critère de sélection
* L'affichage des catégories associées à un élément


Les champs ainsi rajoutés sont alors affichés dans le sélecteur de champs de la liste et utilisable comme n'importe quel autre champs natif
|}


<youtube>9NqynenRUv4</youtube>
== Paramétrage ==
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou [[file:doli-setup-old.png]] en bout de ligne.

[[file:extralist-setup.png]]

==Page principale==
A partir du menu principal des outils patas-monkey, le menu gauche extralist présente la liste des listes personnalisables de l'outil
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_index.png|600px]]
| Chaque bloc représente une liste personnalisable contenant :
* La gestion des d'attributs supplémentaires disponible
* La gestion des champs supplémentaires déjà ajouté à la liste
* La gestion des critères de surlignage de la liste
Le nombre en bout de ligne indique si il y a déjà un paramétrage réalisé
|}


== Gestion des attributs personnalisés==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs disponibles
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extrafieldsfields.png|600px]]
| L'appuie sur le premier icone orange permet de sélectionner les attributs disponible pour la liste que l'on souhaite afficher
Il suffit de cliquer sur le sélecteur en bout de ligne pour activer ou non le champs dans la liste
|}


== Gestion des champs supplémentaires==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs déjà paramétrés et permet d'en ajouter de nouveau.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfields.png|600px]]
| L'appuie sur le second icone gris permet d'accéder à la liste des champs supplémentaires que l'on a déjà défini
A partir de la liste, il est possible de modifier un champ déjà existant (icone en début de ligne) ou de le supprimer (icone en bout de ligne)
|}


=== Ajout d'un nouveau champs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsadd.png|600px]]
| L'appuie sur l'icone (+) au bout du titre permet de créer un nouveau champ personnalisé, il sera possible de saisir alors
* Le libellé du champ que l'on souhaite ajouter
* Le nom du champ dans la base de donnée avec son préfix (comme par exemple s. pour société, p. pour projet, ...), il est possible d'employer un alias (si on utilise paramètre un champ calculé).
* Le type de champs afin de mieux en gérer le format de présentation sur la liste
|}


=== Edition d'un champ existant ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsedit.png|600px]]
| L'appuie sur l'icone en forme de style en début de ligne permet de afficher le paramétrage du champ personnalisé.


|}


=== Gestion de la jointure de table ===
Il est possible de rajouter une jointure SQL vers une ou plusieurs tables si le champ n'est pas présent dans les tables utilisés par la liste.


Attention cette fonctionnalité demande de connaitre à la fois le SQL et la structuration des tables de Dolibarr.


Nous proposons en support payant sur notre site https://www.patas-monkey.com/boutique de vous accompagner sur cette fonctionnalité


=== Fonctionnement des nouveaux champs ===
Une fois le paramétrage réalisé, il est possible d'accéder aux nouveaux champs à partir du sélecteur de champs natif de la liste.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_selected.png|400px]]
| Si il y a des champs ajoutés par ExtraList dans la liste, l'icone de sélection des champs change de couleur
* Les champs issus d'attributs supplémentaires présente l'élément dont ils proviennent
* Les champs ajoutés sont préfixé avec "EL"
|}


== Gestion des lignes surlignées ==
Extralist permet de surligner certaines lignes avec un code couleur associé à une règle de sélection.

Il est possible d'avoir plusieurs filtrage pour une même liste

[[File:extralist_extralistselligneresult.png|800px]]

L'appuie sur l'icone (+) au bout du titre permet de créer une nouvelle sélection de surlignage.

[[File:extralist_extralistsellignelist.png|800px]]

L'appuie sur l'icone en forme de stylo permet de modifier le surlignage.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistselligneedit.png|600px]]

|
L'écran d'édition permet de définir :

* le champ utilisé pour le filtrage (extrafields inclus)
* la couleur utilisée pour le surlignage
* le type de filtrage (égale, différent, inférieur, ...)
* la valeur associée au filtrage


Il est possible pour la valeur de filtrage d'utiliser des valeurs prédéfinies comme #NOW# pour la date du jour ou #USERID# pour l'utilisateur en cours

|}

== Gestion de l'affichage des catégories ==


{| class="wikitable"
|- style="vertical-align:top;"
| Il est possible d'afficher sur la liste les catégories des éléments en activant la coche au niveau du paramétrage de l'élément sur la page d'index du module.


|
[[File:extralist_selectcategory.png|300px]]


|}

Une colonne affichant la ou les catégories (dans un tooltip alors) associé à l'élément est sélectionnable.

[[File:extralist_displaycategorylist.png|800px]]

== Cacher / afficher les projets et les tickets cloturés ==

Sur la fiche des tiers, il y a un onglet pour les projets et les tickets qui affiche ceux associés au tiers.

En activant le paramètre de masquage correspondant, le module supprime de la liste les éléments terminés
Si nécessaire, il est possible de retrouver les éléments masqués en cliquant sur le titre du tableau. Il est naturellement possible de masquer à nouveau les éléments en cliquant au meme endroit

[[File:extralist_showhideline.png|800px]]

</translate>

ExtraList

2026-04-10T18:05:48Z

Admiw : /* Cacher / afficher les projets et les tickets cloturés */

ExtraList

2026-04-10T17:59:56Z

Admiw : /* Gestion de l'affichage des catégories */

Fichier:Extralist-setup.png

2026-04-10T17:58:59Z

Admiw :

ExtraList

2026-04-10T17:58:33Z

Admiw : /* Paramétrage */

MyList

2026-04-10T17:55:02Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:mylist_250x250.png]]
| Ce Module permet la création de listes personnalisées,
il est aussi possible :
* de créer des sommes, des cumuls et des moyennes des champs numériques présent dans la liste
* de créer une éditions au format PDF de la liste
* de générer des export au format CSV des listes
|}
<youtube>1ZKnTFTGxfM</youtube>
==Présentation==
Le Module myList permet de créer vos propres listes personnalisées à partir des informations contenues dans votre base de données et de les rendre accessibles depuis les menus de Dolibarr. La récupération des informations est effectué par requête SQL.


[[file:mylist_Liste_affichee.png|600px]]


Depuis les listes personnalisées, différentes actions peuvent être effectuées à partir de requêtes complémentaire de traitement (suppression, mise à jour …).


[[file:mylist_Liste_traitement.png|600px]]


MyList est livré avec trois fichiers d'import de listes desquels vous inspirer pour créer vos propres listes : contacts à rappeler, liste des factures impayées et chiffre d'affaires.


myList inclue aussi :
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:mylist_Champs-mylistmore-ecran.png|600px]]
|
Les sommes et moyennes des champs calculés des myList à l'écran et sur l'édition
|- style="vertical-align:top;"
| [[file:mylist_Champs-mylistmore-resultat.png|600px]]
|
Des éditions PDF
|}


myList inclue aussi deux nouveaux types de champs permettant l'affichage d'un tooltip des valeurs d'un champ supplémentaire issue d'une liste ou de dictionnaires.


==Configuration des fonctionnalités du module==


===Configuration===
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou [[file:doli-setup-old.png]] en bout de ligne.


{| class="wikitable"
| [[file:mylist_Configuration.png|600px]]
| style="vertical-align:top;" |


L'activation de l'export permettra l'extraction des données présentes dans les listes au format CSV pour un retraitement ultérieur.


Vous pourrez enfin activer les éditions et choisir celle utilisée par défaut dans le '''tableau de génération des éditions'''.
|}


https://www.youtube.com/watch?v=1ZKnTFTGxfM


===Permissions===
es accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module. Cliquez sur le – pour ajouter un permission. Une permission accordée est symbolisée par un coche verte ([[file:tick.png]] ).


*Permissions utilisateurs et groupes
{| class="wikitable"
| [[file:myliste_Permissions-utilisateurs.png|600px]]
| style="vertical-align:top;" | Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions
|}


*Permissions par défaut
{| class="wikitable"
| [[file:mylist_Permissions-defaut.png|600px]]
| style="vertical-align:top;" | Les permissions par défaut (Accueil > Configuration > Sécurité > Permissions par défaut), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}


==Démarrage==
Les fonctionnalités de myList sont accessibles depuis l'onglet de menu principal Outils Patas-M. Les fonctionnalités de MyListMore s'ajoute à celles de MyList lors de la création de nouvelles listes. Votre menu secondaire présente alors les entrées de menu suivantes :
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:mylist_Menusecondaire.png]]
|
*myList : l'entrée principale '''myList''' permet d’afficher toutes les listes définies dans votre environnement (même si celles-ci ne sont pas actives). En cliquant sur le titre de la liste, on peut visualiser la liste. Cet écran est très utile lors du développement d’une liste qui n’est pas encore active. Il est cependant préférable de tester ces listes sur un environnement de test puis d’utiliser la fonction d’import/export pour la mettre en place en production.
*Nouvelle liste : cette entrée vous affichera la page de création d'une nouvelle liste.
*Mes Listes : le lien '''Mes listes''' permet d’afficher la liste des listes présentes dans votre environnement. Le lien en début de ligne vous permet d’afficher le résultat de la requête de la liste en plus de ses résultats.
*Importer une liste : cette entré affichera une page permettant de copier un fichier d'import d'une liste au format XML. (Voir "Import d'une liste" plus bas).
|}


==Création d'une liste==
Ouvrez la page de création d'une liste depuis le lien de menu '''Outils Patas-M > Mylist > Nouvelle liste''' :


[[file:mylist_Page_nouvelle_liste.png|600px]]


{| class="wikitable"
| style="vertical-align:top;width:15%;" |
Libellé
| le libellé sera affiché en tant que titre de la page d'affichage de la liste.
|-
| Description
| un texte de présentation de la liste
|-
| Titre du menu
| le titre sera affiché dans les menus de Dolibarr en tant que lien d'accès à la liste
|-
| style="vertical-align:top;|
Menu principal et Menu secondaire
| pour déterminer l'emplacement de la liste dans les menus Dolibarr, Il est nécessaire de les indiquer en remplissant les champs avec leur nom exact.


Les valeurs à renseigner ici sont présentes dans les URL des menus :


Exemple du menu principal tiers :


<code>...htdocs/societe/index.php?mainmenu=companies&leftmenu=</code>


Exemple d'un menu secondaire :


<code>...htdocs/societe/index.php?leftmenu=thirdparties</code>


[[file:mylist_affectationmenu.png|600px]]
|-
| Onglet dans l'élément
| les résultats de la liste peuvent être affichés dans un onglet ajouté sur les fiches de l'élément sélectionné dans cette liste (tiers, produits, projets, catégories de tiers et de produits) et filtrés pour n'afficher que les résultats en lien avec lui-même.


Pour faire le lien entre le myList et l'element sélectionné, il faut utiliser la constante #ID# qui transmettra la valeur à la requete pour filter la donnée.
|-
| Habilitations
| Dolibarr possède nativement des fonctionnalités avancées pour gérer les droits d'accès à ses menus. Il est possible d'utiliser ce champ pour saisir une condition d'habilitation afin d'accéder au contenu de la page si la condition n'est pas respectée, le menu sera grisé.


Généralement les habilitations sont définies de la manière suivante :
<code>$user->rights->élément->droit</code> où élément correspond à un module de Dolibarr (devis, commande, projet, …) et droit à l’habilitation sur le module (lire, écrire, paramétrer...).


Par exemple pour autoriser l’accès uniquement aux utilisateurs ayant accès en lecture aux propositions commerciales il faut saisir <code>$user->rights->propale->lire</code>.


Pour repérer l’habilitation que l’on souhaite utiliser, une astuce consiste à aller dans le fichier de configuration du module gérant cette habilitation.
|-
| Fichier de langue
| afin de rendre plus explicite les noms de variable lors de leur saisie et les entêtes de colonnes sur les tableaux, il est possible d’utiliser les fichiers de traductions.


Il suffit d’ajouter un ou plusieurs noms de fichiers de langues séparé par un #


Si le fichier de langue n’est pas déposé dans le dossier du noyau de Dolibarr, il faut ajouter <code>@nomdumodule</code> à celui-ci.
|-
| Auteur
|-
| Export CSV
| conditionne l'affichage d'un bouton d'export CSV du résultat de la liste
|-
| Document imprimable
| sélectionnez ici l'orientation du PDF qui vous sera proposé par défaut pour générer les résultats de vos listes.
{{Note|Note : Pour pouvoir sélectionnez les documents, ils doivent avoir été activés dans la configuration du module}}
|-
| Requête du tableau
| requête SQL qui va définir l'affichage des données
|-
| Requête de traitement
| permettra de paramétrer un traitement sur les résultats de la liste comme <code>DELETE</code>, <code>UPDATE</code> …
|-
| Champs personnalisés par défaut
| les champs personnalisés saisis ici permettent de définir un ensemble de variables utilisées par la requête pour pré-filtrer des champs qui ne sont pas forcément affichés.
[[file:mylist_champs_personnalises.png|400px]] [[file:mylist_champs_personnalises_resultat.png|400px]]


Il est possible de créer plusieurs champs personnalisés en les séparant par ''':'''
|}


==Exemple de création d'une liste simple==
===Page de création===
Pour l'exemple, créons une liste des produits et services affichant leur prix de vente, de revient et PMP, accessible depuis le menu principal Produits/Services :
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:mylist_Page_nouvelle_liste.png|600px]]
| Ouvrez la page de création d'une nouvelle liste et saisissez les données ci-contre puis terminez la première étape de création de la liste en cliquant sur le bouton '''Créer'''
|- style="vertical-align:top;"
| [[file:mylist_Liste_cree.png|600px]]
| Une fois la liste créée, trois nouveaux champs sont affichés et peuvent être modifié en édition de la fiche :
*'''Export CSV autorisé''' : cette fonctionnalité permettra l'export CSV des résultats de la liste pour un retraitement ultérieur.
*'''Forcer l'affichage de tous les résultats''' : cette fonctionnalité forcera l'affichage de tous les résultat de la liste sans filtrage.
{{Note|Selon la complexité de votre requête et la quantité d'information à traiter, activer cette fonctionnalité peut ralentir le système}}
*'''Liste active''' : suite à sa création, une liste est par défaut, '''Inactive'''. Modifiez son état pour permettre son affichage depuis les liens de menus déclarés sur sa fiche.
|}
Trois boutons sont présent en bas de l'écran :
* '''Modifier''' vous permettra d'entrer en édition de la liste pour en modifier la requête ou tout autre élément (menus d'accès, onglets d'affichage …
* '''Importation / Exportation de la page''' générera le fichier XML que vous pourrez modifier avant de le copier pour l'exporter
* '''Supprimer''' effacera la liste de votre base de données. Désactivez toujours une liste avant de la supprimer. Si vous effectuez une suppression sans avoir désactivé la liste auparavant, elle restera présente dans votre base de donnée et sur votre interface, mais vidée de son contenu|warn


===Champs de la liste===
A partir de l'écran de la liste, il est possible de créer des champs, cliquez sur le bouton Nouveau champ ou le l'icone (+) en bout de titre:
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:new_mylist_field.png|600px]]
|
* Nom du champ : nom du champ tel qu'il est présent dans les tables de Dolibarr
* Alias : il s’agit de l’alias du champ dans le sens base de données. Cet alias n’est pas obligatoire
* Nom : titre de colonne affiché dans la liste
*Largeur : la largeur saisie ici s'appliquera au champ à l'écran
*Largeur sur l'édition : la largeur saisie ici s'appliquera à l'édition PDF
*Alignement
*Actif : le champ sera présent et affiché par défaut. Son affichage pourra être modifié depuis le bouton autres colonnes.
*Visible : le champ sera affiché dans la liste
*Filtre par défaut : ajouter un filtre par défaut permet l'enregistrement d'une valeur de filtrage active dès l'affichage de la liste.
* Type : ce paramètre suit généralement le fonctionnement des champs supplémentaires natifs de Dolibarr.
|}

====Liste des types possibles==== 


* Texte : affiche le champs au format texte
* Prix : affiche un nombre en utilisant le format de précision défini dans Dolibarr
* Pourcentage : affiche un nombre en pourcentage
* Date : affiche une date au format « jour »
* Durée : affiche la valeur numérique au format heure (ex: la valeur 7200 s'affichera 2:00)
* Boolean : affiche un oui ou un non dans la cellule de la ligne
* Statut/Etat : correspond au format des statuts des éléments (attention ce type nécessite un paramétrage supplémentaire
* Liste : Affiche le contenu du champs mais aussi une liste de filtrage
* Extrafield de type liste : pour faire ressortir sur une myList la valeur d'un champ supplémentaire sur les fiches, sélectionnez ce type de champ. Son paramètre sera alors <code>NomDeLElement:NomDuCHamp</code>. Par exemple, pour affiche le contenu de l'extrafield <code>extrafield</code> enregistré sur la fiche d'un produit, saisissez <code>product:extrafield</code>.
* Eval : permet de saisir dans les paramètres un code php qui utilise la fonction dol_eval des champs supplémentaires calculés
* myList : permet de lier la liste à un autre myList


selon le type de champs crée il d'autres champs peuvent apparaitre en modification.


{{Note|Les champs ci-dessous ne s'appliquent qu'aux champs de type prix ou nombre.|warn}}


* Totalisation du champ : affichera un tableau avec les totaux des champs pour lesquels la fonctionnalité aura été activée.
* Moyenne du champ : affichera un tableau avec les moyennes des champs pour lesquels

====Paramètres du champ====
Cette fonctionnalité est liée au paramétrage des champs de type clé (<code>rowid</code> et <code>fk_xxx</code>) pour les champs de liste de type texte, liste et statut.


Elle permet de rendre cliquable et/ou filtrable par liste déroulante.


L'alimentation de ce champ nécessite une connaissance des tables et de l'organisation des classes des différents éléments de Dolibarr.
Quelques exemples de formation du paramètre :
* 1er cas : liste issue d'une table
Table : <code>c_typent</code> (sans le préfixe)
Clé : <code>id</code>
Libellé : <code>libelle</code>
Paramètre à indiquer dans le paramétrage du champ de myList : <code>c_typent:id:libelle</code>
* 2ème cas : rendre cliquables les résultats de liste


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:new_mylist_field_param_conctact.png|600px]]
Exemple de saisie d'un champ cliquable pour les contacts
|
::Nom de la classe de l'élément à rendre cliquable : <code>Facture:</code>
::Chemin du fichier définissant la classe : <code>/compta/facture/class/facture.class.php</code>
::Nom de la table : <code>:facture</code>
::Champ à afficher : <code>nom_du_champ</code>
::Paramètre à indiquer dans le paramétrage du champ de myList : <code>Facture:/compta/facture/class/facture.class.php:facture:nom_du_champ</code>


[[file:new_mylist_field_display_contact.png|300px]]
Résultat affiché pour l'exemple ci-contre pour les contacts
|}


* Paramètres les plus fréquemment utilisés :
::Tiers : <code>Societe:/societe/class/societe.class.php</code>
::Contact : <code>Contact:/contact/class/contact.class.php</code>
::Utilisateurs : <code>User:/user/class/user.class.php:user:lastname </code>
::Produit : <code>Product:/product/class/product.class.php</code>
::proposition commerciale : <code>Propal:/comm/propal/class/propal.class.php</code>
::Commande client :<code>Commande:/commande/class/commande.class.php:commande:ref</code>
::Facture client : <code>Facture:/compta/facture/class/facture.class.php</code>
::Projet : <code>Project:/projet/class/project.class.php</code>
::Taches : <code>Task:/projet/class/task.class.php</code>
::Contrat : <code>Contrat:/contrat/class/contrat.class.php</code>
::Intervention : <code>Fichinter:/fichinter/class/fichinter.class.php</code>
::Expédition : <code>Expedition:/expedition/class/expedition.class.php</code>
::Commande fournisseur : <code>CommandeFournisseur:/fourn/class/fournisseur.commande.class.php</code>
::Facture fournisseur : <code>FactureFournisseur:/fourn/class/fournisseur.facture.class.php</code>
::Entrepôt : <code>Entrepot:/product/stock/class/entrepot.class.php</code>
::Événement : <code>ActionComm:/comm/action/class/actioncomm.class.php</code>
::Banque : <code>Account:/compta/bank/class/account.class.php</code>
::Catégorie : <code>Categorie:/categories/class/categorie.class.php</code>


* pour les champs de type texte contenant une url, il est possible de les rendre cliquable en ajoutant le paramètre "url"

==== Champ Catégorie ====


pour les champs de type catégorie il convient de réaliser le paramétrage suivant :


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:mylist_categorie_field_contact.png|600px]]
|
* nom de champ : le champs qui fait le lien entre la liste et la catégorie
* Paramètre de champ : la valeur avant la séparation correspond au nom de la table catégorie (dans l'exemple llx_categorie_member) la seconde valeur correspond au lien vers le champs saisie dans le nom du champ (ici fk_element)


Voici d'autres exemples de paramètre de catégorie :
* supplier:fk_soc
* customer:fk_soc
* contact:fk_socpeople
* project:fk_project
* product:fk_product


|- style="vertical-align:top;"
| [[file:mylist_categorie_result.png|600px]]
| Il est alors possible de sélectionner plusieurs catégories pour le filtrage.
Si l'on utilise la coche, le filtrage de plusieurs catégories se fera par OU au lieur de ET


|}


==== Champ Numérique ====

Il est possible pour les champs numériques (nombre et prix) d'avoir une totalisation, moyenne et cumul en bas de page.
pour cela une fois le champs créer, il suffit d'activer le type de calcul que vous souhaitez.

[[file:mylist_fields_totalisation.png|400px]]

====Filtrage sur les champs ====
:Options de filtrage sur les valeurs du champ.
:{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Durée, Nombre, Somme, Prix
| Résultat
|-
| < 20000
| nombres < et = à 200000
|-
| 200000-300000
| nombres de 200000 à 300000 inclus
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2008
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
| 2006-2009
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20060401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}
::Boolean, Liste, Statut : dans le cas d’un filtre booléen, trois valeurs sont sélectionnables dans la liste :
:::vide : le champ n’est pas filtré
:::<code>vrai</code> : sélectionne les valeurs saisies à « vrai »
:::<code>faux</code> : sélection des valeurs saisies à « faux »
:::Dans les autres cas, cela dépend du paramétrage additionnel du champ.
====Remarques sur le filtrage====
* Une zone au format Check n’est pas filtrable


* Dans le cas d'un filtrage par la société d'un utilisateur (par exemple pour filtrer une liste sur les facture) il faut utiliser la valeur #SOCID# comme valeur par défaut sur un champ contenant la clé de la société
* Dans le cas d'un filtrage par l'utilisateur par défaut, il faut utiliser la valeur #USERID# comme valeur par défaut sur un champ contenant la clé l'utilisateur


====Champs Calculés====
Il est possible d'afficher un champ calculé dans la liste depuis du code php saisie dans les paramètres additionnels.


[[file:mylist_Exemple_doleval.png|700px]]

Ce type de champs reprend le fonctionnement natif des attributs supplémentaires (extrafields) et la fonction dol_eval().

====Champs myList====

Ce type de champs permet de lier une liste principale à une liste secondaire en ajoutant une icone sur la liste ouvrant une fenêtre contenant la liste liée.

{| class="wikitable"
|- style="vertical-align:top;"
| [[file:mylist_definition_champs_mylist.png|600px]]

Le paramétrage du champs est le suivant :
* l'id du mylist à lier
* le lien sql entre le champ et la liste (#ID# prenant alors la valeur du champ)
* la classe permettant de définir l'icone de liaison
| [[file:mylist_exemple_champs_mylist.png|400px]]
|}

===Gestion des clés spécifiques (<code>rowid</code>, <code>fk_statut</code>)===
* Champs rowid : les champs rowid ont un fonctionnement particulier dans myList, associés à des paramètres, ils permettent de créer un lien vers l’élément dont ils sont la clé.
:Rendre un champ cliquable est sans doute la problématique la plus complexe de myList car elle implique de comprendre un peu l’architecture de Dolibarr.
:Tout d’abord il est nécessaire de repérer dans les répertoires de Dolibarr où se trouve la classe de l’élément que l’on souhaite appeler et comment celle-ci se nomme dans le fichier
:Si l’on souhaite par exemple rendre cliquable une commande fournisseur, il faut trouver le fichier de la classe associée à cet élément (<code>/fourn/class/fournisseur.commande.class.php</code>) puis regarder le nom de la classe objet (CommandeFournisseur).
* Champs fk_statut : les champs fk_statut servent à connaître l'état d'un élément. Cependant, le nombre et le type d'état est propre à chaque élément. Les choix sélectionnables sont donc à ajouter aux paramètres supplémentaires des champs. Comme pour le <code>rowid</code>, il convient donc de repérer la classe utilisée pour définir l'élément mis ajouter les états que l'on souhaite utiliser en les séparant par des #.
** exemple pour les tickets : Ticket:/ticket/class/ticket.class.php:0#1#2#3#5#7#8#9 )
** pour les factures, il y a une valeur spécifique "P" pour le statut "payé" de la facture ( Facture:/compta/facture/class/facture.class.php:0#1#2#P )


{| class="wikitable"
| [[file:mylist_Exemple_champs.png|600px]]
| style="vertical-align:top;" | Terminez la création des champs sur le modèle ci-contre
|}


Pour que la liste soit accessible depuis les menus de Dolibarr, il vous suffit de modifier la liste pour la rendre active.
{{Note|Avant de rendre la liste active, vous pouvez l'afficher avec sa requête en utilisant le lien de menu '''Outils Patas-M > MyList'''.
Cette astuce ne fonctionne que sur les liste non encore activées.}}


[[file:mylist_Liste_test.png|600px]]


{| class="wikitable"
| [[file:mylist_Liste_affichee.png|600px]]
| style="vertical-align:top;" | Une fois la liste activée, elle apparaîtra depuis les liens définis sur sa page de création.
Le bouton '''Export en CSV''' permet d'effectuer un export des résultats de la liste au format CSV pour un traitement externe. Il est nécessaire d'avoir activé la fonctionnalité d'export dans la "Configuration" et dans le paramétrage enregistré lors de la "Champs de la page de création d'une liste".
|}


{| class="wikitable"
| [[file:mylist_Liste_test.png|600px]]
| style="vertical-align:top;" | Si vous avez paramétré la liste pour l'afficher dans l'onglet d'une fiche, les résultats seront filtrés selon l'élément.
{{Note|Le filtrage de l'affichage des résultats de la liste nécessite la présence d'une condition dans sa requête SQL. Si aucune n'est présente, ajoutez par exemple WHERE <nowiki>1 = 1</nowiki> }}
|}

==Autres fonctionnalités== 


=== Onglet dans l'élément ===
Il est possible d'afficher un myList comme un onglet d'un élément
pour cela il faut utiliser dans la requete SQL un alias particulier pour la table associé à l'élément
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| prefix
| Element
|-
| s
| Tiers (société)
|-
| p
| Produit
|-
| e
| Stock (entrepot)
|-
| p
| Projet
|-
|p
| Propal
|-
|c
| commande
|-
| f
| Facture
|-
| t
| ticket
|-
|pf
| Demande de prix
|-
| cf
| commande fournisseur
|-
| ff
| Facture Fournisseur
|}

===Import d'une liste=== 


Il est possible d'enregistrer une liste et le paramétrage de ses champs en important un fichier '''XML'''.
{{Note|Des exemples de liste sont livrés avec le module MyList dans le dossier XMLsample}}


{| class="wikitable"
| [[file:mylist_Import.png|600px]]
| style="vertical-align:top;" | Depuis la page '''Outils Patas-M > MyList > Importer une liste''', collez le fichier XML dans la zone de saisie et cliquez sur le bouton '''Lancer l'importation'''.
Activez la liste depuis sa fiche et elle sera accessible depuis vos menus de Dolibarr
|}


Activez la liste depuis sa fiche et elle sera accessible depuis vos menus de Dolibarr.


===Requêtes de traitement===
En complément de la requête d'affichage de la liste, une requête de traitement peut donner la possibilité d'effectuer de nouvelles actions, toujours à partir de requêtes SQL.


{| class="wikitable"
| [[file:mylist_Fiche_liste_traitement.png|600px]]
| style="vertical-align:top;" | Partons d'une liste de contacts et ajoutons dans le champ '''Requête de traitement'' la ligne <code>DELETE FROM 'llx_socpeople' WHERE rowid=#ROWID#</code> permettant leur suppression.
|}


{| class="wikitable"
| [[file:mylist_Liste_traitement.png|600px]]
| style="vertical-align:top;" | Modifiez l'un des champs pour l'enregistrer au type checkable. La liste devient alors tel que ci-contre.
Les cases à cocher serviront à sélectionner les résultats de la liste auxquels appliquer le traitement indiqué dans la requête. Dans notre exemple, les contacts sélectionnés seront supprimés de la base de données.
|}


===Sélection des champs à l'affichage des listes===
{| class="wikitable"
| [[file:mylist_Datatables.png|600px]]
| style="vertical-align:top;" | De la même manière que les listes native de Dolibarr, il est possible de sélectionner ou non les champs que l'on souhaites afficher au niveau de myList.
|}


==Questions fréquentes==
===soucis généraux===
Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.
Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :
#Désactivez et réactivez le module,
#Vérifier sur le ChangeLog si une nouvelle version a été publiée,
#Ré-installez/mettez à jour le module,
#Vérifiez que le remplacement de fichiers natifs de Dolibarr ne soit pas nécessaire au bon fonctionnement du module.
#Vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations.


Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant le formulaire dédié (http://docs.patas-monkey.com/support/).


===Les résultats de la liste ne sont pas ceux attendus===
:Le meilleur moyen de s'assurer de la qualité de votre requête SQL est d'interroger directement votre base de données via phpmyadmin ou logiciel équivalent. Adapter la requête de la liste pour la coller dans la zone SQL de phpmyadmin. Si les résultats sont les mêmes que la liste, revoyez votre requête.
Dans le cas contraire, myList peut présenter un bug. Contactez-nous ! (docs.patas-monkey.com/support).
===Vos listes n'apparaissent pas/plus dans vos menus===


Suite à une mise à jour du module ou des listes elles-mêmes, même si vos listes indiquent qu'elles sont activées, vous devrez les réactivez en entrant en édition du champ Active et en enregistrant à nouveau.
{| class="wikitable"
| [[file:Mylist-reload-list.png|400px]]
| style="vertical-align:top;" |
Il est aussi possible de recharger l'ensemble des listes depuis la liste des listes avec le bouton suivant
|}


===Message d'erreur au lancement du myList ===
{| class="wikitable"
| Message d'erreur '''DB_ERROR_NOSUCHFIELD ou DB_ERROR_NOSUCHTABLE'''
[[file:Mylist-erreur.png|600px]]
| style="vertical-align:top;" |
Vous avez indiqué dans votre requête un champ ou une table qui n'existent pas dans votre base de donnée ou qui n'est pas identifiable.


Revoyez votre requête SQL. Il s'agit souvent d'une faute de frappe ou d'une mauvaise liaison dans votre requête.


Le contenu du message vous aidera à identifier l'erreur avec les lignes '''Code retour dernier accès en base en erreur et Information sur le dernier accès en base en erreur'''.
|}


===Liste supprimée toujours présente===
Vous avez supprimé la liste sans la désactiver d'abord. Mylist ne peut plus supprimer la liste : vous devrez nettoyer votre base de données en supprimant la liste de la table llx_mylist depuis phpmyadmin.
===Message d'erreur à la création de la liste===
Si vous avez effectué une mise à jour de MyList depuis une ancienne version, il est possible que vous rencontriez un message d'erreur à la création d'une liste.
Pour le corriger, vous devrez effectuer la requête suivante sur votre base de données : <code>ALTER TABLE `llx_mylist` CHANGE `model_pdf` `model_pdf` VARCHAR(255) NULL DEFAULT NULL;</code>
</translate>

ExtraList

2026-04-10T17:52:32Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_250x250.png]]
| Le module ExtraList permet de rajouter aux listes natives de dolibarr des champs, issus des attributs personnalisés ou d'autres champs non prévu initialement à la liste:
* sélection des attributs supplémentaires disponible pour la liste
* ajout de champs supplémentaires disponible dans les tables natives de la liste ou ajouté en table jointe pour le champ
* le surlignage de lignes selon un critère de sélection
* L'affichage des catégories associées à un élément


Les champs ainsi rajoutés sont alors affichés dans le sélecteur de champs de la liste et utilisable comme n'importe quel autre champs natif
|}


<youtube>9NqynenRUv4</youtube>
== Paramétrage ==
Afin de paramétrer le module il est nécessaire d'avoir au minimum un entrepôt ouvert et un autre fermé.

==Page principale==
A partir du menu principal des outils patas-monkey, le menu gauche extralist présente la liste des listes personnalisables de l'outil
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_index.png|600px]]
| Chaque bloc représente une liste personnalisable contenant :
* La gestion des d'attributs supplémentaires disponible
* La gestion des champs supplémentaires déjà ajouté à la liste
* La gestion des critères de surlignage de la liste
Le nombre en bout de ligne indique si il y a déjà un paramétrage réalisé
|}


== Gestion des attributs personnalisés==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs disponibles
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extrafieldsfields.png|600px]]
| L'appuie sur le premier icone orange permet de sélectionner les attributs disponible pour la liste que l'on souhaite afficher
Il suffit de cliquer sur le sélecteur en bout de ligne pour activer ou non le champs dans la liste
|}


== Gestion des champs supplémentaires==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs déjà paramétrés et permet d'en ajouter de nouveau.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfields.png|600px]]
| L'appuie sur le second icone gris permet d'accéder à la liste des champs supplémentaires que l'on a déjà défini
A partir de la liste, il est possible de modifier un champ déjà existant (icone en début de ligne) ou de le supprimer (icone en bout de ligne)
|}


=== Ajout d'un nouveau champs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsadd.png|600px]]
| L'appuie sur l'icone (+) au bout du titre permet de créer un nouveau champ personnalisé, il sera possible de saisir alors
* Le libellé du champ que l'on souhaite ajouter
* Le nom du champ dans la base de donnée avec son préfix (comme par exemple s. pour société, p. pour projet, ...), il est possible d'employer un alias (si on utilise paramètre un champ calculé).
* Le type de champs afin de mieux en gérer le format de présentation sur la liste
|}


=== Edition d'un champ existant ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsedit.png|600px]]
| L'appuie sur l'icone en forme de style en début de ligne permet de afficher le paramétrage du champ personnalisé.


|}


=== Gestion de la jointure de table ===
Il est possible de rajouter une jointure SQL vers une ou plusieurs tables si le champ n'est pas présent dans les tables utilisés par la liste.


Attention cette fonctionnalité demande de connaitre à la fois le SQL et la structuration des tables de Dolibarr.


Nous proposons en support payant sur notre site https://www.patas-monkey.com/boutique de vous accompagner sur cette fonctionnalité


=== Fonctionnement des nouveaux champs ===
Une fois le paramétrage réalisé, il est possible d'accéder aux nouveaux champs à partir du sélecteur de champs natif de la liste.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_selected.png|400px]]
| Si il y a des champs ajoutés par ExtraList dans la liste, l'icone de sélection des champs change de couleur
* Les champs issus d'attributs supplémentaires présente l'élément dont ils proviennent
* Les champs ajoutés sont préfixé avec "EL"
|}


== Gestion des lignes surlignées ==
Extralist permet de surligner certaines lignes avec un code couleur associé à une règle de sélection.

Il est possible d'avoir plusieurs filtrage pour une même liste

[[File:extralist_extralistselligneresult.png|800px]]

L'appuie sur l'icone (+) au bout du titre permet de créer une nouvelle sélection de surlignage.

[[File:extralist_extralistsellignelist.png|800px]]

L'appuie sur l'icone en forme de stylo permet de modifier le surlignage.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistselligneedit.png|600px]]

|
L'écran d'édition permet de définir :

* le champ utilisé pour le filtrage (extrafields inclus)
* la couleur utilisée pour le surlignage
* le type de filtrage (égale, différent, inférieur, ...)
* la valeur associée au filtrage


Il est possible pour la valeur de filtrage d'utiliser des valeurs prédéfinies comme #NOW# pour la date du jour ou #USERID# pour l'utilisateur en cours

|}

== Gestion de l'affichage des catégories ==


{| class="wikitable"
|- style="vertical-align:top;"
| Il est possible d'afficher sur la liste les catégories des éléments en activant la coche au niveau du paramétrage de l'élément sur la page d'index du module.


|
[[File:extralist_selectcategory.png|300px]]


|}

Une colonne affichant la ou les catégories (dans un tooltip alors) associé à l'élément est sélectionnable.

[[File:extralist_displaycategorylist.png|800px]]

</translate>

Fichier:Dolitweak deroulementmodule.png

2026-03-23T13:57:01Z

Admiw :

Dolitweak

2026-03-23T13:56:49Z

Admiw : /* FastModule : Optimisation de l'interface pour activer les modules */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:dolitweak_250x250.png]]
| DoliTweak est un module regroupant un ensemble de fonctionnalité d'optimisations et de personnalisations de Dolibarr.
il reprend d'anciens modules et de nouveaux développé au fil des demandes
|}


== Vadrouille : Optimisation de l'interface natif et en mobilité ==
=== Présentation ===
Cette fonctionnalité permet de simplifier l'utilisation de dolibarr sur une tablette voir un smartphone en :
* permettant de spécifier un thème spécifique (propre à la mobilité) au lancement de dolibarr
* de limiter l'expansion des onglets en nombre
* de passer les onglets en mode icone


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:dolitweak_onglet.png|800px]]
|
* "Activer les icones pour les onglets" ajoute une icone sur les onglets avec 5 modes :
** la fonction est désactivé
** les icones s'affichent seulement quand on est en mode vadrouille
** les icones s'affichent en permanence (un tooltip reste disponible pour afficher le nom de l'onglet)
** les icones s'affichent mais le titre l'onglet apparait quand on le survol
** on affiche une icone en plus sur l'onglet


* "Nombre d'onglets à afficher" limite le nombre d'onglet présenté, les autres onglets sont regroupées dans une liste déroulante
* "Skin par défaut pour Vadruouille" permet de sélectionner le thème adapté au mode mobile de dolibarr
* "Indique le menu sélectionné" affiche une icone sur le menu gauche que l'on a sélectionné
[[file:dolitweak_menusel.png|200px]]
|}


== ExtraTotal : Affichage d'un pourcentage du total sur les documents clients ==
Le but de cet outil est d'ajouter sur les pièces clients une information basée sur pourcentage du prix total

=== Configuration === 


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extratotal_configuration.png|600px]]
| pour chaque documents natifs, il est possible de définir:
* le texte de la ligne à ajouter
* la position (X et Y ) où positionner le texte sur le document pdf
* le pourcentage à appliquer sur le montant TTC
|}


=== Utilisation ===
Une fois le pourcentage et le texte validé, une nouvelle ligne apparait sur l'écran ainsi que sur le document pdf


[[File:extratotal_resultat.png|800px]]

== CustomerStock : Conservation des stocks expédiés dans un entrepot client == 


== ExtraHoney : Bannière de publicité dans Dolibarr ==
Ce module permet d'afficher des bannières de pub google addsense sur dans dolibarr
une manière comme une autre de financer un environnement de démonstration de dolibarr
[[file:extra_honey_publi.png|800px]]


== FastPayement : régler rapidement les factures clients et fournisseurs ==
=== Présentation ===
Ce module ajoute un bouton de règlement rapide sur les factures clients et fournisseurs mais aussi un règlement en masse sur leur liste respectives
Il est possible de définir un mode de paiement et une banque par défaut, ceux prédéfinis au niveau de la facture seront utilisés en priorité


=== Configuration de la fonctionnalité ===
La configuration du module se fait à partir de l'onglet dédié dans le paramétrage du module


Elle permet de définir une valeur par défaut pour le mode de règlement et la banque.


[[file:fastpayement_setting.png|800px]]

=== Paramétres par défaut de la facture === 


[[file:fastpayement_billinfos.png]]


=== Paiement rapide d'une facture ===
Un nouveau bouton apparait sur les factures impayées, il suffit de cliquer dessus pour que la facture soit directement payées, et son règlement effectués.
Si le mode de paiement et la banque ont été définis sur la facture, ils sont pris en compte pour le règlement de règlement. Dans le cas contraire ce sont ceux saisis dans le paramétrage du module qui le sont.


[[file:fastpayement_billfacture.png]]

=== Paiement rapide d'une liste de facture === 


Il est possible de sélectionner plusieurs factures (case à cocher) sur la liste des factures.
Une liste déroulante apparait alors permettant de lancer un traitement de masse des règlements des factures impayés.


Les factures qui ne sont pas à l'état impayés, même si elles sont sélectionnées ne sont pas traitées par le traitement en masse


[[file:fastpayement_billfacturelist.png]]


== FastModule : Optimisation de l'interface pour activer les modules ==
=== Présentation ===


Sélectionner les modules que vous souhaitez afficher plus facilement en cochant la case "requis" pour le module souhaité et ensuite le bouton "Enregistrer".


[[file:fastmodule_selection1.png|800px]]

== Déroulement de la liste les modules ==
En activant la fonction dans le paramétrage du module, il est alors de possible d'enrouler et de dérouler la liste des modules par familles.

[[file:dolitweak_deroulementmodule.png|800px]]

</translate>

MySchedule

2026-03-19T15:48:45Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-250x250.png]]
| Ce module Améliore la gestion les fiches d'interventions natives de Dolibarr en y ajoutant :
* une vue calendrier (en mode semaine et mois)
* des fonctions de drag & drop et agrandissement des lignes
* l'affectation d'utilisateur
* l'affectation de contact/adresse
* la création rapide d'une intervention (et d'une ou plusieurs lignes d'interventions)
* la modification rapide d'une intervention, la ligne de détail d'intervention
* le changement d'états et autre élément en masse
|}


== Présentation ==
Le module MySchedule permet de gérer les interventions et plus précisément les temps planifiés et réalisés sur celle-ci par les collaborateurs


Les interventions ont 4 étapes propres à mySchedule :
* Sans affectation : il n'y a pas d'utilisateurs associés à l'intervention
* Pas encore planifié : il y a un utilisateur (au moins) d'associé à l'intervention mais il n'est pas encore affecté à une ligne de détail d'intervention
* Pas encore réalisée : les lignes d'interventions sont toute affecté à un (ou plusieurs) utilisateur
* Terminées : les temps réalisées par les utilisateurs ont été saisies sur l'intervention
Chacune de ces étapes est associé à un code couleur qui est utilisé pour l'affichage des intervention sur la vue agenda


Et deux étapes intermédiaires :
* A finir : Le temps réalisé par les intervenant mais il est inférieur au temps planifié
* Dépassé : Le temps réalisé est supérieur au temps planifié


{{Note|Il est possible de filtrer selon une semaine, un mois, un intervenant, un tiers, une étape et un statut d'intervention}}


== Paramétrage ==
La configuration du module se fait via la page d'administration des modules, que l'on atteint en suivant les menus Accueil > Configuration > Modules et en cliquant sur l'icône en fin de ligne.


{| class="wikitable" |-
| [[File:Myschedule-setting.png|600px]]
| style="vertical-align:top;" | A partir de cet écran il est possible de paramétrer :
* l'accès par défaut de la vue agenda sur une semaine ou un mois
* les 4 couleurs correspondantes aux différents états de l'intervention
* les plages horaires (début et fin de journée, début et fin d'activité) de la vue hebdomadaire
* le nombre de ligne(s) d'intervention (de 1 à 4) saisissable à la création de l'intervention depuis l'agenda
* le nombre de contact/utilisateurs affichable sur les listes avant de les concaténer en tooltip
* les extrafields disponible sur le tiers pour alimenter les notes publiques et privés de l'intervention (utile pour des codes d'accès, des consignes propres à chaque interventions pour ce tiers)
* définir si on souhaite ouvrir l'intervention sur le même onglet ou un autre à partir du popIn de modification
|}


== Ecran principal ==
Accessible à partir du menu commercial/Intervention/mySchedule, c'est l'écran principal de mySchedule.


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule.png|600px]]
|
Il est découpé en quatre parties :
* Filtrage et sélection des évènements
* Navigation entre les semaines et les mois
* Action de masse sur les évènements
* La vue agenda soit pour une semaine soit le mois entier


Il est possible au niveau de la vue agenda de réaliser les actions suivantes :
* création d'une nouvelle intervention
* modification d'une nouvelle intervention (avec un lien vers l'interface classique des interventions)
* déplacement d'une intervention (drag & drop)
* redimensionnement d'une intervention (resize)
|}


=== Filtrages et sélection ===
[[File:Myschedule-filter.png|900px]]


L'interface de filtrage se décompose en trois parties :


{| class="wikitable"
! style="vertical-align:top;width: 300px" |sur la période et l'état à afficher
! style="vertical-align:top;width: 300px" |sur les éléments natifs des interventions
! style="vertical-align:top;width: 300px" |sur les états associés géré par mySchedule
|-
| style="vertical-align:top" |
* la semaine et l'année en cours
* le mois et l'année en cours
* le statut de l'intervention (brouillon, validé, facturé, terminé)
| style="vertical-align:top" |
* Le tiers de l'intervention
* Un utilisateur associé à l'intervention
* Un contact externe ou une adresse associé à l'intervention


| style="vertical-align:top" |
il est possible d'en sélectionner plusieurs à la fois, si aucun n'est sélectionné on les prends tous
|}


Ces filtres se retrouvent au niveau des listes des interventions pour les tiers et les utilisateurs
{{Note|Pour la suite du document, nous utiliseront le terme état ou statut pour la notion de statut propre à l'intervention et d'étape pour la notion d'étape d'avancement de mySchédule}}


=== Navigation et raccourcis ===
=== Actions en masse ===
MySchedule permet de réaliser des actions sur les lignes d'interventions en masse.


{| class="wikitable"
|- style="vertical-align:bottom;"
| [[File:Myschedule-massbutton.png|600px]]
| Les actions de masse sont accessible à partir de l'écran principal grace aux boutons présent sur l'écran
|}
Le premier groupe d'action correspond aux modifications en masse propre à mySchedule, la couleur de police correspond à l'étape où cette action se réalise.
* [[#Affectation_des_utilisateurs|Affectation]] : permet de gérer les intervenants associé à l'intervention
* Planification : Permet d'affecter les temps à réaliser au niveau de l'évènement à un ou plusieurs collaborateurs
* Réalisation: Permet d'affecter les temps effectués au niveau de l'évènement à un ou plusieurs collaborateurs
Le second groupe correspond aux actions propres à Dolibarr:
* Changement de statut de l'intervention
* Décalage dans le temps des lignes d'interventions
* Clonage d'une intervention et de ses lignes d'interventions (en deux étapes)
La suppression en masse de ligne d'intervention fait partie de ce second groupe mais est mis de coté pour des raisons de sécurité...


=== Évènements sur la vue Agenda ===
La vue agenda présente les lignes de détails des interventions. Chaque ligne de détail d'intervention se définie par une date et heure de début, qu'une durée et une description et l'intervention à laquelle elle est rattachée.


{{Note| dans le reste du document le terme "évènement" sera employé pour désigner une ligne d'intervention native de Dolibarr.}}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event-detail-new.png]]
| Chaque évènement est découpé en trois parties :
* Le bloc gris reprenant les informations de la ligne d'intervention
** La référence de l'intervention et son statut (première ligne)
** l'heure de début et de fin de la ligne d'intervention et sa durée (seconde ligne)
** la description principale de l'intervention est en "tooltip" de l'icone
* les informations complémentaires de l'intervention
** le tiers associé à l'intervention
** la description de la ligne d'intervention
** le contrat ou le projet si celui-ci a été saisie
* La zone des intervenants (utilisateur seulement)
** les durées planifiées et réalisées si elles ont déjà été saisie


{{Note| en affichage semaine, l'affichage d'évènement peut-être tronqué car la hauteur de celui-ci correspond à sa durée}}


|}


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event.png|500px]]
| L'agenda affiche les évènements présents sur la période.
* En vue semaine, elles sont positionnées selon l'heure de début et de fin. Il est possible de modifier directement la date, l'heure de début et la durée/fin de l'évènement par drag&drop et agrandissement de celui-ci. Attention, certaines infos peuvent être tronquées dans cette vue de part la taille de l'événement lié à sa durée.
* En vue mensuelle, elles sont positionnées à la suite des unes et des autres. Il est possible de modifier directement la date de début l'évènement par drag&drop.
|}


== Création d'une intervention ==
Lors d'un clique sur un bouton au niveau de la journée une fenêtre popIn de création d'intervention apparait. Celle-ci permet de saisir les éléments suivants :
* Tiers associé à l'intervention (si la vue Fullcalendar est filtré sur un tiers, celui-ci est affecté par défaut)
* Description de l'intervention (zone texte simple)
* Note publique et privée (zone de texte simple)
* une ou plusieurs lignes d'interventions (nombre paramétrable) avec les colonnes suivantes :
** L'intervenant/utilisateur associé à la ligne d'intervention (saisie optionnel, par défaut l'utilisateur saisissant ou celui qui est filtré dans l'affichage )
** Description de la ligne d'intervention
** La date et l'heure de début de la ligne d'intervention (la date est reprise de la journée qui a été cliqué)
** La durée de l'intervention


{{Note|L'heure de début de la ligne d'intervention est reprise de la plage horaire cliquée sur la vue hebdomadaire, pour la vue mensuelle, elle correspond au début de l'heure travaillé paramétrée}}


=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-main.png|500px]]
| Le premier onglet permet de saisir les éléments propres à l'intervention:
* Le tiers associé à l'intervention
* La description de l'intervention
* La selection des catégories d'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet


Par défaut l'intervention est toujours au statut brouillon
|}

=== Onglet des lignes d'interventions / évènements ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-detail.png|500px]]
| Le deuxième onglet permet à la fois de saisir une ou plusieurs ligne d'intervention (selon le paramétrage effectué)
Sélection multiples des contacts clients et des utilisateurs associés à l'intervention

Les données saisissable pour chaque ligne sont :
* La description, saisissable en wysiwyg
* la date et heure de début d'intervention
* la durée de la ligne d'intervention

{{Note| il est possible de cocher une case pour affecter les contacts à la ligne d'intervention lui sont affectés comme "planifié"}}
|}
Une fois la saisie validée les lignes d'interventions apparaissent sur l'agenda, il y a autant d'évènement que de lignes d'intervention.
[[File:Myschedule-newinter-event.png]]

== Modification d'une intervention == 


Au clique sur un évènement, une fenêtre popIn de modification de l'intervention apparait.
Le bandeau de la fenêtre reprend la référence de l'intervention et la couleur de l'étape de l'événement
Le popIn possède 3 onglets :
* un onglet pour les données propres à l'intervention (tiers, statut, contrat et projet si actif)
* un onglet lié à la ligne d'intervention et la saisie des temps planifiés et réalisés des collaborateurs
* un onglet de gestion des contact et des utilisateurs associé à l'intervention
* un onglet pour les notes publiques et privées
Un badge apparait sur les onglets des utilisateurs et des notes si ceux-ci sont renseignés
{{Note|Il est aussi possible d'ouvrir l'intervention en mode « classique » (que ce soit sur le même onglet ou un autre est paramétrable) }}
=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-update-main.png|500px]]
| Le premier onglet permet de modifier les éléments suivants :
* Le tiers associé à l'intervention
* La description de l'intervention
* Le statut de l'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet.


Si il y a des informations saisies au niveau des onglets annexes, un badge apparait indiquant le nombre d'information présente sur celui-ci


Il est possible de supprimer directement la ligne d'intervention (voir l'intervention si celle-ci n'a plus de ligne) à partir de cet écran (bouton supprimer)
|}


=== Onglet de la ligne d'intervention ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit.png|500px]]
| Le deuxième onglet permet à la fois de modifier la ligne d'intervention (description, durée et la date et heure de début d'intervention) et de saisir les temps planifiés et/ou réalisés par les intervenants de l'intervention.


Les saisies réalisées sur cet écran permet de modifier l'étape de l'évènements
|}

=== Onglet des contacts/adresses ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit-contact.png|500px]]
| Le troisième onglet permet de gérer la sélection des contacts/utilisateurs associé à l'intervention.
Sur les intervenant il est possible de:
* Les deux zones de saisies permettent de saisir de nouveau contact et/ou utilisateur à la ligne d'intervention
* Le tableau référence la liste des utilisateurs et contact associé à l'intervention.
* L'icone de suppression en fin de ligne permet de supprimer le contact ou l'utilisateur (nécessite de valider la ligne)
|}

== Gestion des actions en masse ==
Sur la vue mySchedule il sera possible de réaliser des actions en masse :
* La suppression des lignes d'interventions et de l'intervention si celle-ci n'as plus de l'intervention associé
* Le déplacement sur une autre semaine des lignes d'interventions
* Le clonage des lignes d'interventions et de l'intervention associé
* Le changement du (ou des) intervenant sur la ligne d'intervention
* Le changement du statut de l'intervention (brouillon, validé, facturé, terminé)


Cette mise à jour en masse se fera ainsi :
* On filtre sur la vue fullCalendar la semaine qui contient les éléments à modifier
* On appuie sur l'un des boutons en haut à droite de l'écran
* Une fenêtre affichant les évènements apparait (il n'est pas possible de déplacer les éléments), chaque évènement est sélectionnable par un simple click sur celui-ci,
* Il est possible de cocher/décocher en masse une ligne (journée) ou toute la semaine pour séléctionner les éléments à traiter
* Pour la modification des utilisateurs une listes déroulantes d'utilisateur présaisie que l'on peu changer
* Pour le clonage et le déplacement il faudra saisir le numéro de semaine et l'année sur laquel sera déplacé ou clonée les évènements
* Une fois l'écran validé, on revient sur la plage de départ


=== Modification de statut ===
=== Décalage d'un évènement ===
=== Clonage d'intervention ===

=== Suppression d'évènements === 


== Gestion des temps collaborateurs ==
=== Affectation des utilisateurs ===
[[File:Myschedule-mass-user.png|600px]]
=== Planification des collaborateurs ===
[[File:Myschedule-affectation-main.png|600px]]


[[File:Myschedule-affectation-popup.png|600px]]

=== Saisie des temps réalisées === 


== Onglets d'interventions ==
Sur les tiers et les utilisateurs un onglet myShedule affiche la liste des interventions du tiers/utilisateur.
Il sera possible de filtrer cette liste


=== Liste des interventions d'un tiers ===
[[File:Myschedule-societe-list.png|600px]]
=== Liste des interventions d'un utilisateur ===
</translate>

Fichier:Myschedule-update-main.png

2026-03-19T15:46:40Z

Admiw : Admiw a téléversé une nouvelle version de Fichier:Myschedule-update-main.png

MySchedule

2026-03-19T15:44:47Z

Admiw : /* Onglet des contacts/adresses */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-250x250.png]]
| Ce module Améliore la gestion les fiches d'interventions natives de Dolibarr en y ajoutant :
* une vue calendrier (en mode semaine et mois)
* des fonctions de drag & drop et agrandissement des lignes
* l'affectation d'utilisateur
* l'affectation de contact/adresse
* la création rapide d'une intervention (et d'une ou plusieurs lignes d'interventions)
* la modification rapide d'une intervention, la ligne de détail d'intervention
* le changement d'états et autre élément en masse
|}


== Présentation ==
Le module MySchedule permet de gérer les interventions et plus précisément les temps planifiés et réalisés sur celle-ci par les collaborateurs


Les interventions ont 4 étapes propres à mySchedule :
* Sans affectation : il n'y a pas d'utilisateurs associés à l'intervention
* Pas encore planifié : il y a un utilisateur (au moins) d'associé à l'intervention mais il n'est pas encore affecté à une ligne de détail d'intervention
* Pas encore réalisée : les lignes d'interventions sont toute affecté à un (ou plusieurs) utilisateur
* Terminées : les temps réalisées par les utilisateurs ont été saisies sur l'intervention
Chacune de ces étapes est associé à un code couleur qui est utilisé pour l'affichage des intervention sur la vue agenda


Et deux étapes intermédiaires :
* A finir : Le temps réalisé par les intervenant mais il est inférieur au temps planifié
* Dépassé : Le temps réalisé est supérieur au temps planifié


{{Note|Il est possible de filtrer selon une semaine, un mois, un intervenant, un tiers, une étape et un statut d'intervention}}


== Paramétrage ==
La configuration du module se fait via la page d'administration des modules, que l'on atteint en suivant les menus Accueil > Configuration > Modules et en cliquant sur l'icône en fin de ligne.


{| class="wikitable" |-
| [[File:Myschedule-setting.png|600px]]
| style="vertical-align:top;" | A partir de cet écran il est possible de paramétrer :
* l'accès par défaut de la vue agenda sur une semaine ou un mois
* les 4 couleurs correspondantes aux différents états de l'intervention
* les plages horaires (début et fin de journée, début et fin d'activité) de la vue hebdomadaire
* le nombre de ligne(s) d'intervention (de 1 à 4) saisissable à la création de l'intervention depuis l'agenda
* le nombre de contact/utilisateurs affichable sur les listes avant de les concaténer en tooltip
* les extrafields disponible sur le tiers pour alimenter les notes publiques et privés de l'intervention (utile pour des codes d'accès, des consignes propres à chaque interventions pour ce tiers)
* définir si on souhaite ouvrir l'intervention sur le même onglet ou un autre à partir du popIn de modification
|}


== Ecran principal ==
Accessible à partir du menu commercial/Intervention/mySchedule, c'est l'écran principal de mySchedule.


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule.png|600px]]
|
Il est découpé en quatre parties :
* Filtrage et sélection des évènements
* Navigation entre les semaines et les mois
* Action de masse sur les évènements
* La vue agenda soit pour une semaine soit le mois entier


Il est possible au niveau de la vue agenda de réaliser les actions suivantes :
* création d'une nouvelle intervention
* modification d'une nouvelle intervention (avec un lien vers l'interface classique des interventions)
* déplacement d'une intervention (drag & drop)
* redimensionnement d'une intervention (resize)
|}


=== Filtrages et sélection ===
[[File:Myschedule-filter.png|900px]]


L'interface de filtrage se décompose en trois parties :


{| class="wikitable"
! style="vertical-align:top;width: 300px" |sur la période et l'état à afficher
! style="vertical-align:top;width: 300px" |sur les éléments natifs des interventions
! style="vertical-align:top;width: 300px" |sur les états associés géré par mySchedule
|-
| style="vertical-align:top" |
* la semaine et l'année en cours
* le mois et l'année en cours
* le statut de l'intervention (brouillon, validé, facturé, terminé)
| style="vertical-align:top" |
* Le tiers de l'intervention
* Un utilisateur associé à l'intervention
* Un contact externe ou une adresse associé à l'intervention


| style="vertical-align:top" |
il est possible d'en sélectionner plusieurs à la fois, si aucun n'est sélectionné on les prends tous
|}


Ces filtres se retrouvent au niveau des listes des interventions pour les tiers et les utilisateurs
{{Note|Pour la suite du document, nous utiliseront le terme état ou statut pour la notion de statut propre à l'intervention et d'étape pour la notion d'étape d'avancement de mySchédule}}


=== Navigation et raccourcis ===
=== Actions en masse ===
MySchedule permet de réaliser des actions sur les lignes d'interventions en masse.


{| class="wikitable"
|- style="vertical-align:bottom;"
| [[File:Myschedule-massbutton.png|600px]]
| Les actions de masse sont accessible à partir de l'écran principal grace aux boutons présent sur l'écran
|}
Le premier groupe d'action correspond aux modifications en masse propre à mySchedule, la couleur de police correspond à l'étape où cette action se réalise.
* [[#Affectation_des_utilisateurs|Affectation]] : permet de gérer les intervenants associé à l'intervention
* Planification : Permet d'affecter les temps à réaliser au niveau de l'évènement à un ou plusieurs collaborateurs
* Réalisation: Permet d'affecter les temps effectués au niveau de l'évènement à un ou plusieurs collaborateurs
Le second groupe correspond aux actions propres à Dolibarr:
* Changement de statut de l'intervention
* Décalage dans le temps des lignes d'interventions
* Clonage d'une intervention et de ses lignes d'interventions (en deux étapes)
La suppression en masse de ligne d'intervention fait partie de ce second groupe mais est mis de coté pour des raisons de sécurité...


=== Évènements sur la vue Agenda ===
La vue agenda présente les lignes de détails des interventions. Chaque ligne de détail d'intervention se définie par une date et heure de début, qu'une durée et une description et l'intervention à laquelle elle est rattachée.


{{Note| dans le reste du document le terme "évènement" sera employé pour désigner une ligne d'intervention native de Dolibarr.}}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event-detail-new.png]]
| Chaque évènement est découpé en trois parties :
* Le bloc gris reprenant les informations de la ligne d'intervention
** La référence de l'intervention et son statut (première ligne)
** l'heure de début et de fin de la ligne d'intervention et sa durée (seconde ligne)
** la description principale de l'intervention est en "tooltip" de l'icone
* les informations complémentaires de l'intervention
** le tiers associé à l'intervention
** la description de la ligne d'intervention
** le contrat ou le projet si celui-ci a été saisie
* La zone des intervenants (utilisateur seulement)
** les durées planifiées et réalisées si elles ont déjà été saisie


{{Note| en affichage semaine, l'affichage d'évènement peut-être tronqué car la hauteur de celui-ci correspond à sa durée}}


|}


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event.png|500px]]
| L'agenda affiche les évènements présents sur la période.
* En vue semaine, elles sont positionnées selon l'heure de début et de fin. Il est possible de modifier directement la date, l'heure de début et la durée/fin de l'évènement par drag&drop et agrandissement de celui-ci. Attention, certaines infos peuvent être tronquées dans cette vue de part la taille de l'événement lié à sa durée.
* En vue mensuelle, elles sont positionnées à la suite des unes et des autres. Il est possible de modifier directement la date de début l'évènement par drag&drop.
|}


== Création d'une intervention ==
Lors d'un clique sur un bouton au niveau de la journée une fenêtre popIn de création d'intervention apparait. Celle-ci permet de saisir les éléments suivants :
* Tiers associé à l'intervention (si la vue Fullcalendar est filtré sur un tiers, celui-ci est affecté par défaut)
* Description de l'intervention (zone texte simple)
* Note publique et privée (zone de texte simple)
* une ou plusieurs lignes d'interventions (nombre paramétrable) avec les colonnes suivantes :
** L'intervenant/utilisateur associé à la ligne d'intervention (saisie optionnel, par défaut l'utilisateur saisissant ou celui qui est filtré dans l'affichage )
** Description de la ligne d'intervention
** La date et l'heure de début de la ligne d'intervention (la date est reprise de la journée qui a été cliqué)
** La durée de l'intervention


{{Note|L'heure de début de la ligne d'intervention est reprise de la plage horaire cliquée sur la vue hebdomadaire, pour la vue mensuelle, elle correspond au début de l'heure travaillé paramétrée}}


=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-main.png|500px]]
| Le premier onglet permet de saisir les éléments propres à l'intervention:
* Le tiers associé à l'intervention
* La description de l'intervention
* La selection des catégories d'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet


Par défaut l'intervention est toujours au statut brouillon
|}

=== Onglet des lignes d'interventions / évènements ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-detail.png|500px]]
| Le deuxième onglet permet à la fois de saisir une ou plusieurs ligne d'intervention (selon le paramétrage effectué)
Sélection multiples des contacts clients et des utilisateurs associés à l'intervention

Les données saisissable pour chaque ligne sont :
* La description, saisissable en wysiwyg
* la date et heure de début d'intervention
* la durée de la ligne d'intervention

{{Note| il est possible de cocher une case pour affecter les contacts à la ligne d'intervention lui sont affectés comme "planifié"}}
|}
Une fois la saisie validée les lignes d'interventions apparaissent sur l'agenda, il y a autant d'évènement que de lignes d'intervention.
[[File:Myschedule-newinter-event.png]]

== Modification d'une intervention == 


Au clique sur un évènement, une fenêtre popIn de modification de l'intervention apparait.
Le bandeau de la fenêtre reprend la référence de l'intervention et la couleur de l'étape de l'événement
Le popIn possède 3 onglets :
* un onglet pour les données propres à l'intervention (tiers, statut, contrat et projet si actif)
* on onglet de gestion des utilisateurs associé à l'intervention et à la ligne d'intervention
* on onglet pour les notes publiques et privées
Un badge apparait sur les onglets des utilisateurs et des notes si ceux-ci sont renseignés
{{Note|Il est aussi possible d'ouvrir l'intervention en mode « classique » (que ce soit sur le même onglet ou un autre est paramétrable) }}
=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-update-main.png|500px]]
| Le premier onglet permet de modifier les éléments suivants :
* Le tiers associé à l'intervention
* La description de l'intervention
* Le statut de l'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet.


Si il y a des informations saisies au niveau des onglets annexes, un badge apparait indiquant le nombre d'information présente sur celui-ci


Il est possible de supprimer directement la ligne d'intervention (voir l'intervention si celle-ci n'a plus de ligne) à partir de cet écran (bouton supprimer)
|}


=== Onglet de la ligne d'intervention ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit.png|500px]]
| Le deuxième onglet permet à la fois de modifier la ligne d'intervention (description, durée et la date et heure de début d'intervention) et de saisir les temps planifiés et/ou réalisés par les intervenants de l'intervention.


Les saisies réalisées sur cet écran permet de modifier l'étape de l'évènements
|}

=== Onglet des contacts/adresses ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit-contact.png|500px]]
| Le troisième onglet permet de gérer la sélection des contacts/utilisateurs associé à l'intervention.
Sur les intervenant il est possible de:
* Les deux zones de saisies permettent de saisir de nouveau contact et/ou utilisateur à la ligne d'intervention
* Le tableau référence la liste des utilisateurs et contact associé à l'intervention.
* L'icone de suppression en fin de ligne permet de supprimer le contact ou l'utilisateur (nécessite de valider la ligne)
|}

== Gestion des actions en masse ==
Sur la vue mySchedule il sera possible de réaliser des actions en masse :
* La suppression des lignes d'interventions et de l'intervention si celle-ci n'as plus de l'intervention associé
* Le déplacement sur une autre semaine des lignes d'interventions
* Le clonage des lignes d'interventions et de l'intervention associé
* Le changement du (ou des) intervenant sur la ligne d'intervention
* Le changement du statut de l'intervention (brouillon, validé, facturé, terminé)


Cette mise à jour en masse se fera ainsi :
* On filtre sur la vue fullCalendar la semaine qui contient les éléments à modifier
* On appuie sur l'un des boutons en haut à droite de l'écran
* Une fenêtre affichant les évènements apparait (il n'est pas possible de déplacer les éléments), chaque évènement est sélectionnable par un simple click sur celui-ci,
* Il est possible de cocher/décocher en masse une ligne (journée) ou toute la semaine pour séléctionner les éléments à traiter
* Pour la modification des utilisateurs une listes déroulantes d'utilisateur présaisie que l'on peu changer
* Pour le clonage et le déplacement il faudra saisir le numéro de semaine et l'année sur laquel sera déplacé ou clonée les évènements
* Une fois l'écran validé, on revient sur la plage de départ


=== Modification de statut ===
=== Décalage d'un évènement ===
=== Clonage d'intervention ===

=== Suppression d'évènements === 


== Gestion des temps collaborateurs ==
=== Affectation des utilisateurs ===
[[File:Myschedule-mass-user.png|600px]]
=== Planification des collaborateurs ===
[[File:Myschedule-affectation-main.png|600px]]


[[File:Myschedule-affectation-popup.png|600px]]

=== Saisie des temps réalisées === 


== Onglets d'interventions ==
Sur les tiers et les utilisateurs un onglet myShedule affiche la liste des interventions du tiers/utilisateur.
Il sera possible de filtrer cette liste


=== Liste des interventions d'un tiers ===
[[File:Myschedule-societe-list.png|600px]]
=== Liste des interventions d'un utilisateur ===
</translate>

Fichier:Myschedule-edit-contact.png

2026-03-19T15:41:57Z

Admiw : Admiw a téléversé une nouvelle version de Fichier:Myschedule-edit-contact.png

Fichier:Myschedule-edit.png

2026-03-19T15:40:19Z

Admiw : Admiw a téléversé une nouvelle version de Fichier:Myschedule-edit.png

MySchedule

2026-03-19T15:39:12Z

Admiw : /* Onglet des collaborateurs */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-250x250.png]]
| Ce module Améliore la gestion les fiches d'interventions natives de Dolibarr en y ajoutant :
* une vue calendrier (en mode semaine et mois)
* des fonctions de drag & drop et agrandissement des lignes
* l'affectation d'utilisateur
* l'affectation de contact/adresse
* la création rapide d'une intervention (et d'une ou plusieurs lignes d'interventions)
* la modification rapide d'une intervention, la ligne de détail d'intervention
* le changement d'états et autre élément en masse
|}


== Présentation ==
Le module MySchedule permet de gérer les interventions et plus précisément les temps planifiés et réalisés sur celle-ci par les collaborateurs


Les interventions ont 4 étapes propres à mySchedule :
* Sans affectation : il n'y a pas d'utilisateurs associés à l'intervention
* Pas encore planifié : il y a un utilisateur (au moins) d'associé à l'intervention mais il n'est pas encore affecté à une ligne de détail d'intervention
* Pas encore réalisée : les lignes d'interventions sont toute affecté à un (ou plusieurs) utilisateur
* Terminées : les temps réalisées par les utilisateurs ont été saisies sur l'intervention
Chacune de ces étapes est associé à un code couleur qui est utilisé pour l'affichage des intervention sur la vue agenda


Et deux étapes intermédiaires :
* A finir : Le temps réalisé par les intervenant mais il est inférieur au temps planifié
* Dépassé : Le temps réalisé est supérieur au temps planifié


{{Note|Il est possible de filtrer selon une semaine, un mois, un intervenant, un tiers, une étape et un statut d'intervention}}


== Paramétrage ==
La configuration du module se fait via la page d'administration des modules, que l'on atteint en suivant les menus Accueil > Configuration > Modules et en cliquant sur l'icône en fin de ligne.


{| class="wikitable" |-
| [[File:Myschedule-setting.png|600px]]
| style="vertical-align:top;" | A partir de cet écran il est possible de paramétrer :
* l'accès par défaut de la vue agenda sur une semaine ou un mois
* les 4 couleurs correspondantes aux différents états de l'intervention
* les plages horaires (début et fin de journée, début et fin d'activité) de la vue hebdomadaire
* le nombre de ligne(s) d'intervention (de 1 à 4) saisissable à la création de l'intervention depuis l'agenda
* le nombre de contact/utilisateurs affichable sur les listes avant de les concaténer en tooltip
* les extrafields disponible sur le tiers pour alimenter les notes publiques et privés de l'intervention (utile pour des codes d'accès, des consignes propres à chaque interventions pour ce tiers)
* définir si on souhaite ouvrir l'intervention sur le même onglet ou un autre à partir du popIn de modification
|}


== Ecran principal ==
Accessible à partir du menu commercial/Intervention/mySchedule, c'est l'écran principal de mySchedule.


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule.png|600px]]
|
Il est découpé en quatre parties :
* Filtrage et sélection des évènements
* Navigation entre les semaines et les mois
* Action de masse sur les évènements
* La vue agenda soit pour une semaine soit le mois entier


Il est possible au niveau de la vue agenda de réaliser les actions suivantes :
* création d'une nouvelle intervention
* modification d'une nouvelle intervention (avec un lien vers l'interface classique des interventions)
* déplacement d'une intervention (drag & drop)
* redimensionnement d'une intervention (resize)
|}


=== Filtrages et sélection ===
[[File:Myschedule-filter.png|900px]]


L'interface de filtrage se décompose en trois parties :


{| class="wikitable"
! style="vertical-align:top;width: 300px" |sur la période et l'état à afficher
! style="vertical-align:top;width: 300px" |sur les éléments natifs des interventions
! style="vertical-align:top;width: 300px" |sur les états associés géré par mySchedule
|-
| style="vertical-align:top" |
* la semaine et l'année en cours
* le mois et l'année en cours
* le statut de l'intervention (brouillon, validé, facturé, terminé)
| style="vertical-align:top" |
* Le tiers de l'intervention
* Un utilisateur associé à l'intervention
* Un contact externe ou une adresse associé à l'intervention


| style="vertical-align:top" |
il est possible d'en sélectionner plusieurs à la fois, si aucun n'est sélectionné on les prends tous
|}


Ces filtres se retrouvent au niveau des listes des interventions pour les tiers et les utilisateurs
{{Note|Pour la suite du document, nous utiliseront le terme état ou statut pour la notion de statut propre à l'intervention et d'étape pour la notion d'étape d'avancement de mySchédule}}


=== Navigation et raccourcis ===
=== Actions en masse ===
MySchedule permet de réaliser des actions sur les lignes d'interventions en masse.


{| class="wikitable"
|- style="vertical-align:bottom;"
| [[File:Myschedule-massbutton.png|600px]]
| Les actions de masse sont accessible à partir de l'écran principal grace aux boutons présent sur l'écran
|}
Le premier groupe d'action correspond aux modifications en masse propre à mySchedule, la couleur de police correspond à l'étape où cette action se réalise.
* [[#Affectation_des_utilisateurs|Affectation]] : permet de gérer les intervenants associé à l'intervention
* Planification : Permet d'affecter les temps à réaliser au niveau de l'évènement à un ou plusieurs collaborateurs
* Réalisation: Permet d'affecter les temps effectués au niveau de l'évènement à un ou plusieurs collaborateurs
Le second groupe correspond aux actions propres à Dolibarr:
* Changement de statut de l'intervention
* Décalage dans le temps des lignes d'interventions
* Clonage d'une intervention et de ses lignes d'interventions (en deux étapes)
La suppression en masse de ligne d'intervention fait partie de ce second groupe mais est mis de coté pour des raisons de sécurité...


=== Évènements sur la vue Agenda ===
La vue agenda présente les lignes de détails des interventions. Chaque ligne de détail d'intervention se définie par une date et heure de début, qu'une durée et une description et l'intervention à laquelle elle est rattachée.


{{Note| dans le reste du document le terme "évènement" sera employé pour désigner une ligne d'intervention native de Dolibarr.}}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event-detail-new.png]]
| Chaque évènement est découpé en trois parties :
* Le bloc gris reprenant les informations de la ligne d'intervention
** La référence de l'intervention et son statut (première ligne)
** l'heure de début et de fin de la ligne d'intervention et sa durée (seconde ligne)
** la description principale de l'intervention est en "tooltip" de l'icone
* les informations complémentaires de l'intervention
** le tiers associé à l'intervention
** la description de la ligne d'intervention
** le contrat ou le projet si celui-ci a été saisie
* La zone des intervenants (utilisateur seulement)
** les durées planifiées et réalisées si elles ont déjà été saisie


{{Note| en affichage semaine, l'affichage d'évènement peut-être tronqué car la hauteur de celui-ci correspond à sa durée}}


|}


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event.png|500px]]
| L'agenda affiche les évènements présents sur la période.
* En vue semaine, elles sont positionnées selon l'heure de début et de fin. Il est possible de modifier directement la date, l'heure de début et la durée/fin de l'évènement par drag&drop et agrandissement de celui-ci. Attention, certaines infos peuvent être tronquées dans cette vue de part la taille de l'événement lié à sa durée.
* En vue mensuelle, elles sont positionnées à la suite des unes et des autres. Il est possible de modifier directement la date de début l'évènement par drag&drop.
|}


== Création d'une intervention ==
Lors d'un clique sur un bouton au niveau de la journée une fenêtre popIn de création d'intervention apparait. Celle-ci permet de saisir les éléments suivants :
* Tiers associé à l'intervention (si la vue Fullcalendar est filtré sur un tiers, celui-ci est affecté par défaut)
* Description de l'intervention (zone texte simple)
* Note publique et privée (zone de texte simple)
* une ou plusieurs lignes d'interventions (nombre paramétrable) avec les colonnes suivantes :
** L'intervenant/utilisateur associé à la ligne d'intervention (saisie optionnel, par défaut l'utilisateur saisissant ou celui qui est filtré dans l'affichage )
** Description de la ligne d'intervention
** La date et l'heure de début de la ligne d'intervention (la date est reprise de la journée qui a été cliqué)
** La durée de l'intervention


{{Note|L'heure de début de la ligne d'intervention est reprise de la plage horaire cliquée sur la vue hebdomadaire, pour la vue mensuelle, elle correspond au début de l'heure travaillé paramétrée}}


=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-main.png|500px]]
| Le premier onglet permet de saisir les éléments propres à l'intervention:
* Le tiers associé à l'intervention
* La description de l'intervention
* La selection des catégories d'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet


Par défaut l'intervention est toujours au statut brouillon
|}

=== Onglet des lignes d'interventions / évènements ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-detail.png|500px]]
| Le deuxième onglet permet à la fois de saisir une ou plusieurs ligne d'intervention (selon le paramétrage effectué)
Sélection multiples des contacts clients et des utilisateurs associés à l'intervention

Les données saisissable pour chaque ligne sont :
* La description, saisissable en wysiwyg
* la date et heure de début d'intervention
* la durée de la ligne d'intervention

{{Note| il est possible de cocher une case pour affecter les contacts à la ligne d'intervention lui sont affectés comme "planifié"}}
|}
Une fois la saisie validée les lignes d'interventions apparaissent sur l'agenda, il y a autant d'évènement que de lignes d'intervention.
[[File:Myschedule-newinter-event.png]]

== Modification d'une intervention == 


Au clique sur un évènement, une fenêtre popIn de modification de l'intervention apparait.
Le bandeau de la fenêtre reprend la référence de l'intervention et la couleur de l'étape de l'événement
Le popIn possède 3 onglets :
* un onglet pour les données propres à l'intervention (tiers, statut, contrat et projet si actif)
* on onglet de gestion des utilisateurs associé à l'intervention et à la ligne d'intervention
* on onglet pour les notes publiques et privées
Un badge apparait sur les onglets des utilisateurs et des notes si ceux-ci sont renseignés
{{Note|Il est aussi possible d'ouvrir l'intervention en mode « classique » (que ce soit sur le même onglet ou un autre est paramétrable) }}
=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-update-main.png|500px]]
| Le premier onglet permet de modifier les éléments suivants :
* Le tiers associé à l'intervention
* La description de l'intervention
* Le statut de l'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet.


Si il y a des informations saisies au niveau des onglets annexes, un badge apparait indiquant le nombre d'information présente sur celui-ci


Il est possible de supprimer directement la ligne d'intervention (voir l'intervention si celle-ci n'a plus de ligne) à partir de cet écran (bouton supprimer)
|}


=== Onglet de la ligne d'intervention ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit.png|500px]]
| Le deuxième onglet permet à la fois de modifier la ligne d'intervention (description, durée et la date et heure de début d'intervention) et de saisir les temps planifiés et/ou réalisés par les intervenants de l'intervention.


Les saisies réalisées sur cet écran permet de modifier l'étape de l'évènements
|}

=== Onglet des contacts/adresses ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit-contact.png|500px]]
| Le troisième onglet permet de gérer la sélection des contacts/adresses associé à l'intervention.
Sur les intervenant il est possible de:
* Ajouter une ou plusieurs adresse
* Supprimer une ou plusieurs adresse
|}


== Gestion des actions en masse ==
Sur la vue mySchedule il sera possible de réaliser des actions en masse :
* La suppression des lignes d'interventions et de l'intervention si celle-ci n'as plus de l'intervention associé
* Le déplacement sur une autre semaine des lignes d'interventions
* Le clonage des lignes d'interventions et de l'intervention associé
* Le changement du (ou des) intervenant sur la ligne d'intervention
* Le changement du statut de l'intervention (brouillon, validé, facturé, terminé)


Cette mise à jour en masse se fera ainsi :
* On filtre sur la vue fullCalendar la semaine qui contient les éléments à modifier
* On appuie sur l'un des boutons en haut à droite de l'écran
* Une fenêtre affichant les évènements apparait (il n'est pas possible de déplacer les éléments), chaque évènement est sélectionnable par un simple click sur celui-ci,
* Il est possible de cocher/décocher en masse une ligne (journée) ou toute la semaine pour séléctionner les éléments à traiter
* Pour la modification des utilisateurs une listes déroulantes d'utilisateur présaisie que l'on peu changer
* Pour le clonage et le déplacement il faudra saisir le numéro de semaine et l'année sur laquel sera déplacé ou clonée les évènements
* Une fois l'écran validé, on revient sur la plage de départ


=== Modification de statut ===
=== Décalage d'un évènement ===
=== Clonage d'intervention ===

=== Suppression d'évènements === 


== Gestion des temps collaborateurs ==
=== Affectation des utilisateurs ===
[[File:Myschedule-mass-user.png|600px]]
=== Planification des collaborateurs ===
[[File:Myschedule-affectation-main.png|600px]]


[[File:Myschedule-affectation-popup.png|600px]]

=== Saisie des temps réalisées === 


== Onglets d'interventions ==
Sur les tiers et les utilisateurs un onglet myShedule affiche la liste des interventions du tiers/utilisateur.
Il sera possible de filtrer cette liste


=== Liste des interventions d'un tiers ===
[[File:Myschedule-societe-list.png|600px]]
=== Liste des interventions d'un utilisateur ===
</translate>

MySchedule

2026-03-19T15:35:14Z

Admiw : /* Onglet des lignes d'interventions / évènements */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-250x250.png]]
| Ce module Améliore la gestion les fiches d'interventions natives de Dolibarr en y ajoutant :
* une vue calendrier (en mode semaine et mois)
* des fonctions de drag & drop et agrandissement des lignes
* l'affectation d'utilisateur
* l'affectation de contact/adresse
* la création rapide d'une intervention (et d'une ou plusieurs lignes d'interventions)
* la modification rapide d'une intervention, la ligne de détail d'intervention
* le changement d'états et autre élément en masse
|}


== Présentation ==
Le module MySchedule permet de gérer les interventions et plus précisément les temps planifiés et réalisés sur celle-ci par les collaborateurs


Les interventions ont 4 étapes propres à mySchedule :
* Sans affectation : il n'y a pas d'utilisateurs associés à l'intervention
* Pas encore planifié : il y a un utilisateur (au moins) d'associé à l'intervention mais il n'est pas encore affecté à une ligne de détail d'intervention
* Pas encore réalisée : les lignes d'interventions sont toute affecté à un (ou plusieurs) utilisateur
* Terminées : les temps réalisées par les utilisateurs ont été saisies sur l'intervention
Chacune de ces étapes est associé à un code couleur qui est utilisé pour l'affichage des intervention sur la vue agenda


Et deux étapes intermédiaires :
* A finir : Le temps réalisé par les intervenant mais il est inférieur au temps planifié
* Dépassé : Le temps réalisé est supérieur au temps planifié


{{Note|Il est possible de filtrer selon une semaine, un mois, un intervenant, un tiers, une étape et un statut d'intervention}}


== Paramétrage ==
La configuration du module se fait via la page d'administration des modules, que l'on atteint en suivant les menus Accueil > Configuration > Modules et en cliquant sur l'icône en fin de ligne.


{| class="wikitable" |-
| [[File:Myschedule-setting.png|600px]]
| style="vertical-align:top;" | A partir de cet écran il est possible de paramétrer :
* l'accès par défaut de la vue agenda sur une semaine ou un mois
* les 4 couleurs correspondantes aux différents états de l'intervention
* les plages horaires (début et fin de journée, début et fin d'activité) de la vue hebdomadaire
* le nombre de ligne(s) d'intervention (de 1 à 4) saisissable à la création de l'intervention depuis l'agenda
* le nombre de contact/utilisateurs affichable sur les listes avant de les concaténer en tooltip
* les extrafields disponible sur le tiers pour alimenter les notes publiques et privés de l'intervention (utile pour des codes d'accès, des consignes propres à chaque interventions pour ce tiers)
* définir si on souhaite ouvrir l'intervention sur le même onglet ou un autre à partir du popIn de modification
|}


== Ecran principal ==
Accessible à partir du menu commercial/Intervention/mySchedule, c'est l'écran principal de mySchedule.


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule.png|600px]]
|
Il est découpé en quatre parties :
* Filtrage et sélection des évènements
* Navigation entre les semaines et les mois
* Action de masse sur les évènements
* La vue agenda soit pour une semaine soit le mois entier


Il est possible au niveau de la vue agenda de réaliser les actions suivantes :
* création d'une nouvelle intervention
* modification d'une nouvelle intervention (avec un lien vers l'interface classique des interventions)
* déplacement d'une intervention (drag & drop)
* redimensionnement d'une intervention (resize)
|}


=== Filtrages et sélection ===
[[File:Myschedule-filter.png|900px]]


L'interface de filtrage se décompose en trois parties :


{| class="wikitable"
! style="vertical-align:top;width: 300px" |sur la période et l'état à afficher
! style="vertical-align:top;width: 300px" |sur les éléments natifs des interventions
! style="vertical-align:top;width: 300px" |sur les états associés géré par mySchedule
|-
| style="vertical-align:top" |
* la semaine et l'année en cours
* le mois et l'année en cours
* le statut de l'intervention (brouillon, validé, facturé, terminé)
| style="vertical-align:top" |
* Le tiers de l'intervention
* Un utilisateur associé à l'intervention
* Un contact externe ou une adresse associé à l'intervention


| style="vertical-align:top" |
il est possible d'en sélectionner plusieurs à la fois, si aucun n'est sélectionné on les prends tous
|}


Ces filtres se retrouvent au niveau des listes des interventions pour les tiers et les utilisateurs
{{Note|Pour la suite du document, nous utiliseront le terme état ou statut pour la notion de statut propre à l'intervention et d'étape pour la notion d'étape d'avancement de mySchédule}}


=== Navigation et raccourcis ===
=== Actions en masse ===
MySchedule permet de réaliser des actions sur les lignes d'interventions en masse.


{| class="wikitable"
|- style="vertical-align:bottom;"
| [[File:Myschedule-massbutton.png|600px]]
| Les actions de masse sont accessible à partir de l'écran principal grace aux boutons présent sur l'écran
|}
Le premier groupe d'action correspond aux modifications en masse propre à mySchedule, la couleur de police correspond à l'étape où cette action se réalise.
* [[#Affectation_des_utilisateurs|Affectation]] : permet de gérer les intervenants associé à l'intervention
* Planification : Permet d'affecter les temps à réaliser au niveau de l'évènement à un ou plusieurs collaborateurs
* Réalisation: Permet d'affecter les temps effectués au niveau de l'évènement à un ou plusieurs collaborateurs
Le second groupe correspond aux actions propres à Dolibarr:
* Changement de statut de l'intervention
* Décalage dans le temps des lignes d'interventions
* Clonage d'une intervention et de ses lignes d'interventions (en deux étapes)
La suppression en masse de ligne d'intervention fait partie de ce second groupe mais est mis de coté pour des raisons de sécurité...


=== Évènements sur la vue Agenda ===
La vue agenda présente les lignes de détails des interventions. Chaque ligne de détail d'intervention se définie par une date et heure de début, qu'une durée et une description et l'intervention à laquelle elle est rattachée.


{{Note| dans le reste du document le terme "évènement" sera employé pour désigner une ligne d'intervention native de Dolibarr.}}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event-detail-new.png]]
| Chaque évènement est découpé en trois parties :
* Le bloc gris reprenant les informations de la ligne d'intervention
** La référence de l'intervention et son statut (première ligne)
** l'heure de début et de fin de la ligne d'intervention et sa durée (seconde ligne)
** la description principale de l'intervention est en "tooltip" de l'icone
* les informations complémentaires de l'intervention
** le tiers associé à l'intervention
** la description de la ligne d'intervention
** le contrat ou le projet si celui-ci a été saisie
* La zone des intervenants (utilisateur seulement)
** les durées planifiées et réalisées si elles ont déjà été saisie


{{Note| en affichage semaine, l'affichage d'évènement peut-être tronqué car la hauteur de celui-ci correspond à sa durée}}


|}


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event.png|500px]]
| L'agenda affiche les évènements présents sur la période.
* En vue semaine, elles sont positionnées selon l'heure de début et de fin. Il est possible de modifier directement la date, l'heure de début et la durée/fin de l'évènement par drag&drop et agrandissement de celui-ci. Attention, certaines infos peuvent être tronquées dans cette vue de part la taille de l'événement lié à sa durée.
* En vue mensuelle, elles sont positionnées à la suite des unes et des autres. Il est possible de modifier directement la date de début l'évènement par drag&drop.
|}


== Création d'une intervention ==
Lors d'un clique sur un bouton au niveau de la journée une fenêtre popIn de création d'intervention apparait. Celle-ci permet de saisir les éléments suivants :
* Tiers associé à l'intervention (si la vue Fullcalendar est filtré sur un tiers, celui-ci est affecté par défaut)
* Description de l'intervention (zone texte simple)
* Note publique et privée (zone de texte simple)
* une ou plusieurs lignes d'interventions (nombre paramétrable) avec les colonnes suivantes :
** L'intervenant/utilisateur associé à la ligne d'intervention (saisie optionnel, par défaut l'utilisateur saisissant ou celui qui est filtré dans l'affichage )
** Description de la ligne d'intervention
** La date et l'heure de début de la ligne d'intervention (la date est reprise de la journée qui a été cliqué)
** La durée de l'intervention


{{Note|L'heure de début de la ligne d'intervention est reprise de la plage horaire cliquée sur la vue hebdomadaire, pour la vue mensuelle, elle correspond au début de l'heure travaillé paramétrée}}


=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-main.png|500px]]
| Le premier onglet permet de saisir les éléments propres à l'intervention:
* Le tiers associé à l'intervention
* La description de l'intervention
* La selection des catégories d'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet


Par défaut l'intervention est toujours au statut brouillon
|}

=== Onglet des lignes d'interventions / évènements ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-detail.png|500px]]
| Le deuxième onglet permet à la fois de saisir une ou plusieurs ligne d'intervention (selon le paramétrage effectué)
Sélection multiples des contacts clients et des utilisateurs associés à l'intervention

Les données saisissable pour chaque ligne sont :
* La description, saisissable en wysiwyg
* la date et heure de début d'intervention
* la durée de la ligne d'intervention

{{Note| il est possible de cocher une case pour affecter les contacts à la ligne d'intervention lui sont affectés comme "planifié"}}
|}
Une fois la saisie validée les lignes d'interventions apparaissent sur l'agenda, il y a autant d'évènement que de lignes d'intervention.
[[File:Myschedule-newinter-event.png]]

== Modification d'une intervention == 


Au clique sur un évènement, une fenêtre popIn de modification de l'intervention apparait.
Le bandeau de la fenêtre reprend la référence de l'intervention et la couleur de l'étape de l'événement
Le popIn possède 3 onglets :
* un onglet pour les données propres à l'intervention (tiers, statut, contrat et projet si actif)
* on onglet de gestion des utilisateurs associé à l'intervention et à la ligne d'intervention
* on onglet pour les notes publiques et privées
Un badge apparait sur les onglets des utilisateurs et des notes si ceux-ci sont renseignés
{{Note|Il est aussi possible d'ouvrir l'intervention en mode « classique » (que ce soit sur le même onglet ou un autre est paramétrable) }}
=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-update-main.png|500px]]
| Le premier onglet permet de modifier les éléments suivants :
* Le tiers associé à l'intervention
* La description de l'intervention
* Le statut de l'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet.


Si il y a des informations saisies au niveau des onglets annexes, un badge apparait indiquant le nombre d'information présente sur celui-ci


Il est possible de supprimer directement la ligne d'intervention (voir l'intervention si celle-ci n'a plus de ligne) à partir de cet écran (bouton supprimer)
|}


=== Onglet des collaborateurs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit.png|500px]]
| Le deuxième onglet permet à la fois de modifier la ligne d'intervention (description, durée et la date et heure de début d'intervention) et sur les intervenants de l'intervention.
Sur les intervenant il est possible de:
* Ajouter un intervenant
* Supprimer un intervenant
* Saisir la durée affecté à un intervenant
* Saisir la durée réalisé par un intervenant


Les saisies réalisées sur cet écran permet de modifier l'étape de l'évènements
|}


=== Onglet des contacts/adresses ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit-contact.png|500px]]
| Le troisième onglet permet de gérer la sélection des contacts/adresses associé à l'intervention.
Sur les intervenant il est possible de:
* Ajouter une ou plusieurs adresse
* Supprimer une ou plusieurs adresse
|}


== Gestion des actions en masse ==
Sur la vue mySchedule il sera possible de réaliser des actions en masse :
* La suppression des lignes d'interventions et de l'intervention si celle-ci n'as plus de l'intervention associé
* Le déplacement sur une autre semaine des lignes d'interventions
* Le clonage des lignes d'interventions et de l'intervention associé
* Le changement du (ou des) intervenant sur la ligne d'intervention
* Le changement du statut de l'intervention (brouillon, validé, facturé, terminé)


Cette mise à jour en masse se fera ainsi :
* On filtre sur la vue fullCalendar la semaine qui contient les éléments à modifier
* On appuie sur l'un des boutons en haut à droite de l'écran
* Une fenêtre affichant les évènements apparait (il n'est pas possible de déplacer les éléments), chaque évènement est sélectionnable par un simple click sur celui-ci,
* Il est possible de cocher/décocher en masse une ligne (journée) ou toute la semaine pour séléctionner les éléments à traiter
* Pour la modification des utilisateurs une listes déroulantes d'utilisateur présaisie que l'on peu changer
* Pour le clonage et le déplacement il faudra saisir le numéro de semaine et l'année sur laquel sera déplacé ou clonée les évènements
* Une fois l'écran validé, on revient sur la plage de départ


=== Modification de statut ===
=== Décalage d'un évènement ===
=== Clonage d'intervention ===

=== Suppression d'évènements === 


== Gestion des temps collaborateurs ==
=== Affectation des utilisateurs ===
[[File:Myschedule-mass-user.png|600px]]
=== Planification des collaborateurs ===
[[File:Myschedule-affectation-main.png|600px]]


[[File:Myschedule-affectation-popup.png|600px]]

=== Saisie des temps réalisées === 


== Onglets d'interventions ==
Sur les tiers et les utilisateurs un onglet myShedule affiche la liste des interventions du tiers/utilisateur.
Il sera possible de filtrer cette liste


=== Liste des interventions d'un tiers ===
[[File:Myschedule-societe-list.png|600px]]
=== Liste des interventions d'un utilisateur ===
</translate>

Fichier:Myschedule-newinter-detail.png

2026-03-19T15:31:11Z

Admiw : Admiw a téléversé une nouvelle version de Fichier:Myschedule-newinter-detail.png

=={{int:filedesc}}==
{{Information
|description={{en|1=Myschedule-newinter-detail}}
|date=2020-10-10
|source={{own}}
|author=[[User:Admiw|Admiw]]
|permission=
|other versions=
}}

=={{int:license-header}}==
{{self|cc-by-sa-4.0}}

[[Catégorie:MySchedule]]

Fichier:Myschedule-newinter-main.png

2026-03-19T15:29:09Z

Admiw : Admiw a téléversé une nouvelle version de Fichier:Myschedule-newinter-main.png

=={{int:filedesc}}==
{{Information
|description={{en|1=Myschedule-newinter-main}}
|date=2020-10-10
|source={{own}}
|author=[[User:Admiw|Admiw]]
|permission=
|other versions=
}}

=={{int:license-header}}==
{{self|cc-by-sa-4.0}}

[[Catégorie:MySchedule]]

MySchedule

2026-03-19T15:28:25Z

Admiw : /* Onglet principal */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-250x250.png]]
| Ce module Améliore la gestion les fiches d'interventions natives de Dolibarr en y ajoutant :
* une vue calendrier (en mode semaine et mois)
* des fonctions de drag & drop et agrandissement des lignes
* l'affectation d'utilisateur
* l'affectation de contact/adresse
* la création rapide d'une intervention (et d'une ou plusieurs lignes d'interventions)
* la modification rapide d'une intervention, la ligne de détail d'intervention
* le changement d'états et autre élément en masse
|}


== Présentation ==
Le module MySchedule permet de gérer les interventions et plus précisément les temps planifiés et réalisés sur celle-ci par les collaborateurs


Les interventions ont 4 étapes propres à mySchedule :
* Sans affectation : il n'y a pas d'utilisateurs associés à l'intervention
* Pas encore planifié : il y a un utilisateur (au moins) d'associé à l'intervention mais il n'est pas encore affecté à une ligne de détail d'intervention
* Pas encore réalisée : les lignes d'interventions sont toute affecté à un (ou plusieurs) utilisateur
* Terminées : les temps réalisées par les utilisateurs ont été saisies sur l'intervention
Chacune de ces étapes est associé à un code couleur qui est utilisé pour l'affichage des intervention sur la vue agenda


Et deux étapes intermédiaires :
* A finir : Le temps réalisé par les intervenant mais il est inférieur au temps planifié
* Dépassé : Le temps réalisé est supérieur au temps planifié


{{Note|Il est possible de filtrer selon une semaine, un mois, un intervenant, un tiers, une étape et un statut d'intervention}}


== Paramétrage ==
La configuration du module se fait via la page d'administration des modules, que l'on atteint en suivant les menus Accueil > Configuration > Modules et en cliquant sur l'icône en fin de ligne.


{| class="wikitable" |-
| [[File:Myschedule-setting.png|600px]]
| style="vertical-align:top;" | A partir de cet écran il est possible de paramétrer :
* l'accès par défaut de la vue agenda sur une semaine ou un mois
* les 4 couleurs correspondantes aux différents états de l'intervention
* les plages horaires (début et fin de journée, début et fin d'activité) de la vue hebdomadaire
* le nombre de ligne(s) d'intervention (de 1 à 4) saisissable à la création de l'intervention depuis l'agenda
* le nombre de contact/utilisateurs affichable sur les listes avant de les concaténer en tooltip
* les extrafields disponible sur le tiers pour alimenter les notes publiques et privés de l'intervention (utile pour des codes d'accès, des consignes propres à chaque interventions pour ce tiers)
* définir si on souhaite ouvrir l'intervention sur le même onglet ou un autre à partir du popIn de modification
|}


== Ecran principal ==
Accessible à partir du menu commercial/Intervention/mySchedule, c'est l'écran principal de mySchedule.


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule.png|600px]]
|
Il est découpé en quatre parties :
* Filtrage et sélection des évènements
* Navigation entre les semaines et les mois
* Action de masse sur les évènements
* La vue agenda soit pour une semaine soit le mois entier


Il est possible au niveau de la vue agenda de réaliser les actions suivantes :
* création d'une nouvelle intervention
* modification d'une nouvelle intervention (avec un lien vers l'interface classique des interventions)
* déplacement d'une intervention (drag & drop)
* redimensionnement d'une intervention (resize)
|}


=== Filtrages et sélection ===
[[File:Myschedule-filter.png|900px]]


L'interface de filtrage se décompose en trois parties :


{| class="wikitable"
! style="vertical-align:top;width: 300px" |sur la période et l'état à afficher
! style="vertical-align:top;width: 300px" |sur les éléments natifs des interventions
! style="vertical-align:top;width: 300px" |sur les états associés géré par mySchedule
|-
| style="vertical-align:top" |
* la semaine et l'année en cours
* le mois et l'année en cours
* le statut de l'intervention (brouillon, validé, facturé, terminé)
| style="vertical-align:top" |
* Le tiers de l'intervention
* Un utilisateur associé à l'intervention
* Un contact externe ou une adresse associé à l'intervention


| style="vertical-align:top" |
il est possible d'en sélectionner plusieurs à la fois, si aucun n'est sélectionné on les prends tous
|}


Ces filtres se retrouvent au niveau des listes des interventions pour les tiers et les utilisateurs
{{Note|Pour la suite du document, nous utiliseront le terme état ou statut pour la notion de statut propre à l'intervention et d'étape pour la notion d'étape d'avancement de mySchédule}}


=== Navigation et raccourcis ===
=== Actions en masse ===
MySchedule permet de réaliser des actions sur les lignes d'interventions en masse.


{| class="wikitable"
|- style="vertical-align:bottom;"
| [[File:Myschedule-massbutton.png|600px]]
| Les actions de masse sont accessible à partir de l'écran principal grace aux boutons présent sur l'écran
|}
Le premier groupe d'action correspond aux modifications en masse propre à mySchedule, la couleur de police correspond à l'étape où cette action se réalise.
* [[#Affectation_des_utilisateurs|Affectation]] : permet de gérer les intervenants associé à l'intervention
* Planification : Permet d'affecter les temps à réaliser au niveau de l'évènement à un ou plusieurs collaborateurs
* Réalisation: Permet d'affecter les temps effectués au niveau de l'évènement à un ou plusieurs collaborateurs
Le second groupe correspond aux actions propres à Dolibarr:
* Changement de statut de l'intervention
* Décalage dans le temps des lignes d'interventions
* Clonage d'une intervention et de ses lignes d'interventions (en deux étapes)
La suppression en masse de ligne d'intervention fait partie de ce second groupe mais est mis de coté pour des raisons de sécurité...


=== Évènements sur la vue Agenda ===
La vue agenda présente les lignes de détails des interventions. Chaque ligne de détail d'intervention se définie par une date et heure de début, qu'une durée et une description et l'intervention à laquelle elle est rattachée.


{{Note| dans le reste du document le terme "évènement" sera employé pour désigner une ligne d'intervention native de Dolibarr.}}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event-detail-new.png]]
| Chaque évènement est découpé en trois parties :
* Le bloc gris reprenant les informations de la ligne d'intervention
** La référence de l'intervention et son statut (première ligne)
** l'heure de début et de fin de la ligne d'intervention et sa durée (seconde ligne)
** la description principale de l'intervention est en "tooltip" de l'icone
* les informations complémentaires de l'intervention
** le tiers associé à l'intervention
** la description de la ligne d'intervention
** le contrat ou le projet si celui-ci a été saisie
* La zone des intervenants (utilisateur seulement)
** les durées planifiées et réalisées si elles ont déjà été saisie


{{Note| en affichage semaine, l'affichage d'évènement peut-être tronqué car la hauteur de celui-ci correspond à sa durée}}


|}


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-detail-event.png|500px]]
| L'agenda affiche les évènements présents sur la période.
* En vue semaine, elles sont positionnées selon l'heure de début et de fin. Il est possible de modifier directement la date, l'heure de début et la durée/fin de l'évènement par drag&drop et agrandissement de celui-ci. Attention, certaines infos peuvent être tronquées dans cette vue de part la taille de l'événement lié à sa durée.
* En vue mensuelle, elles sont positionnées à la suite des unes et des autres. Il est possible de modifier directement la date de début l'évènement par drag&drop.
|}


== Création d'une intervention ==
Lors d'un clique sur un bouton au niveau de la journée une fenêtre popIn de création d'intervention apparait. Celle-ci permet de saisir les éléments suivants :
* Tiers associé à l'intervention (si la vue Fullcalendar est filtré sur un tiers, celui-ci est affecté par défaut)
* Description de l'intervention (zone texte simple)
* Note publique et privée (zone de texte simple)
* une ou plusieurs lignes d'interventions (nombre paramétrable) avec les colonnes suivantes :
** L'intervenant/utilisateur associé à la ligne d'intervention (saisie optionnel, par défaut l'utilisateur saisissant ou celui qui est filtré dans l'affichage )
** Description de la ligne d'intervention
** La date et l'heure de début de la ligne d'intervention (la date est reprise de la journée qui a été cliqué)
** La durée de l'intervention


{{Note|L'heure de début de la ligne d'intervention est reprise de la plage horaire cliquée sur la vue hebdomadaire, pour la vue mensuelle, elle correspond au début de l'heure travaillé paramétrée}}


=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-main.png|500px]]
| Le premier onglet permet de saisir les éléments propres à l'intervention:
* Le tiers associé à l'intervention
* La description de l'intervention
* La selection des catégories d'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet


Par défaut l'intervention est toujours au statut brouillon
|}

=== Onglet des lignes d'interventions / évènements ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-newinter-detail.png|500px]]
| Le deuxième onglet permet à la fois de saisir une ou plusieurs ligne d'intervention (selon le paramétrage effectué)
Les données saisissable pour chaque ligne sont :
* UN intervenant associé à la ligne d'intervention
* La description, saisissable en wysiwyg
* la date et heure de début d'intervention
* la durée de la ligne d'intervention
{{Note| si on saisie un intervenant, il est automatiquement associé à la fiche d'intervention et les temps saisies pour la ligne lui sont affectés comme "plannifié"}}
|}
Une fois la saisie validée les lignes d'interventions apparaissent sur l'agenda, il y a autant d'évènement que de lignes d'intervention.
[[File:Myschedule-newinter-event.png]]

== Modification d'une intervention == 


Au clique sur un évènement, une fenêtre popIn de modification de l'intervention apparait.
Le bandeau de la fenêtre reprend la référence de l'intervention et la couleur de l'étape de l'événement
Le popIn possède 3 onglets :
* un onglet pour les données propres à l'intervention (tiers, statut, contrat et projet si actif)
* on onglet de gestion des utilisateurs associé à l'intervention et à la ligne d'intervention
* on onglet pour les notes publiques et privées
Un badge apparait sur les onglets des utilisateurs et des notes si ceux-ci sont renseignés
{{Note|Il est aussi possible d'ouvrir l'intervention en mode « classique » (que ce soit sur le même onglet ou un autre est paramétrable) }}
=== Onglet principal ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-update-main.png|500px]]
| Le premier onglet permet de modifier les éléments suivants :
* Le tiers associé à l'intervention
* La description de l'intervention
* Le statut de l'intervention
Si ils sont actifs au niveau de Dolibarr, Les contrats et les projets apparaissent aussi au niveau de cet onglet.


Si il y a des informations saisies au niveau des onglets annexes, un badge apparait indiquant le nombre d'information présente sur celui-ci


Il est possible de supprimer directement la ligne d'intervention (voir l'intervention si celle-ci n'a plus de ligne) à partir de cet écran (bouton supprimer)
|}


=== Onglet des collaborateurs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit.png|500px]]
| Le deuxième onglet permet à la fois de modifier la ligne d'intervention (description, durée et la date et heure de début d'intervention) et sur les intervenants de l'intervention.
Sur les intervenant il est possible de:
* Ajouter un intervenant
* Supprimer un intervenant
* Saisir la durée affecté à un intervenant
* Saisir la durée réalisé par un intervenant


Les saisies réalisées sur cet écran permet de modifier l'étape de l'évènements
|}


=== Onglet des contacts/adresses ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myschedule-edit-contact.png|500px]]
| Le troisième onglet permet de gérer la sélection des contacts/adresses associé à l'intervention.
Sur les intervenant il est possible de:
* Ajouter une ou plusieurs adresse
* Supprimer une ou plusieurs adresse
|}


== Gestion des actions en masse ==
Sur la vue mySchedule il sera possible de réaliser des actions en masse :
* La suppression des lignes d'interventions et de l'intervention si celle-ci n'as plus de l'intervention associé
* Le déplacement sur une autre semaine des lignes d'interventions
* Le clonage des lignes d'interventions et de l'intervention associé
* Le changement du (ou des) intervenant sur la ligne d'intervention
* Le changement du statut de l'intervention (brouillon, validé, facturé, terminé)


Cette mise à jour en masse se fera ainsi :
* On filtre sur la vue fullCalendar la semaine qui contient les éléments à modifier
* On appuie sur l'un des boutons en haut à droite de l'écran
* Une fenêtre affichant les évènements apparait (il n'est pas possible de déplacer les éléments), chaque évènement est sélectionnable par un simple click sur celui-ci,
* Il est possible de cocher/décocher en masse une ligne (journée) ou toute la semaine pour séléctionner les éléments à traiter
* Pour la modification des utilisateurs une listes déroulantes d'utilisateur présaisie que l'on peu changer
* Pour le clonage et le déplacement il faudra saisir le numéro de semaine et l'année sur laquel sera déplacé ou clonée les évènements
* Une fois l'écran validé, on revient sur la plage de départ


=== Modification de statut ===
=== Décalage d'un évènement ===
=== Clonage d'intervention ===

=== Suppression d'évènements === 


== Gestion des temps collaborateurs ==
=== Affectation des utilisateurs ===
[[File:Myschedule-mass-user.png|600px]]
=== Planification des collaborateurs ===
[[File:Myschedule-affectation-main.png|600px]]


[[File:Myschedule-affectation-popup.png|600px]]

=== Saisie des temps réalisées === 


== Onglets d'interventions ==
Sur les tiers et les utilisateurs un onglet myShedule affiche la liste des interventions du tiers/utilisateur.
Il sera possible de filtrer cette liste


=== Liste des interventions d'un tiers ===
[[File:Myschedule-societe-list.png|600px]]
=== Liste des interventions d'un utilisateur ===
</translate>

MoreWebportal

2026-03-18T15:57:58Z

Admiw : /* Exemple d'écran d'élément */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Liste des accès == 

Une fois les accès définis, la page d'accueil du portail web fera apparaitre à la fois dans les menus les éléments mais aussi sur la page d'accueil

[[File:morewebportal_MainPage.png |750px]]

Voici la liste des éléments dont le module morewebportal ajoute :
* Fiches d'interventions
* Ticket
* Expéditions
* Entrepôt client

Le module Factory ainsi que le module Equipement possède leur propre accès au portail web

== Fonctions accessibles depuis les éléments == 

{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Eléments
| Documents
| Signatures
| Suivit
|-
| Interventions
| X
| X
|
|-
| Tickets
|
|
|
|-
| Expéditions
| X
| X
| X
|-
| Entrepôts
|
|
|}

== Exemple d'écran d'élément ==

[[File:morewebportal_expedition.png |750px]]

Cet écran affiche la liste expéditions associé au client et présente 3 liens :
* accès au tracking de l'expédition si elle est référencé
* accès la la fiche d'expédition
* accès à la signature si elle est demandée
</translate>

Fichier:Morewebportal expedition.png

2026-03-18T15:55:13Z

Admiw :

MoreWebportal

2026-03-18T15:54:59Z

Admiw :

Accueil

2026-03-18T15:52:58Z

Admiw :

<languages/>
<translate>

[[File:patas-monkey-logo.png]]


Bonjour et Bienvenue sur notre wiki, vous trouverez ce site les documentations des modules que nous développons et maintenons.


Le but étant de rendre accessible la documentation directement à partir des pages du module


{{Note| L'ensemble des modules s'installent et se mettent à jour de manière standard à Dolibarr.


Vous trouverez dans notre '''[[Guide d'installation]]''' les informations nécessaires pour les installer sur votre environnement.


Et ici le '''[[Guide de mise à jour]]'''.
}}

= Liste des documentations = 


{| class="wikitable"
|-
! scope="col"| GPAO
! scope="col"| Gestion de Stock
! scope="col" colspan="2"| RH
! scope="col"| Interface


! scope="col" colspan="4"| Améliorations
! scope="col" colspan="3"| Reporting
|-
| style="background: lightyellow;" | [[Equipement]]
| style="background: lightyellow;" | [[reStock]]
| style="background: lightblue;" | [[mySchedule]]
| style="background: lightblue;" | [[moreHoliday]]
| style="background: lightblue;" | [[doliSmart]]
| style="background: lightblue;" | [[customLine]]
| style="background: lightblue;" | [[myField]]
| style="background: lightblue;" | [[coefPricR]]
| style="background: lightblue;" | [[SupplierPricR]]
| style="background: lightblue;" | [[myList]]
| style="background: lightblue;" | [[Forecast]]
| style="background: lightblue;" | [[Activity]]
|-
| style="background: lightblue;" | [[Factory]]
| style="background: lightblue;" | [[Transporteur]]
| style="background: lightgreen;" | [[Management]]
| style="background: lightblue;" | [[Portofolio]]
| style="background: lightgreen;" | [[moreWebportal]]
| style="background: lightblue;" | [[customTabs]]
| style="background: lightblue;" | [[myClock]]
| style="background: lightgreen;" | [[DoliTweak]]
| style="background: lightblue;" | [[moreFlow]]
| style="background: lightgreen;" | [[listGPT]]
| style="background: lightgreen;" | [[ProjectBudget]]
| style="background: lightgreen;" | [[moreField]]
|-
| style="background: lightblue;" | [[customProduct]]
| style="background: lightblue;" | [[myBooking]]
| style="background: lightgreen;" | [[MatchR]]
| style="background: lightpink;" | [[Process]]
| style="background: lightwhite;" |
| style="background: lightblue;" | [[customTooltip]]
| style="background: lightblue;" | [[ExtraList]]
| style="background: lightblue;" | [[Extraprice]]
| style="background: lightgreen;" | [[PrestHarvest]]
| style="background: lightyellow;" | [[myDoliboard]]
| style="background: lightgreen;" | [[extraOdt]]
| style="background: lightblue;" | [[moreActionList]]
|-
| style="background: lightblue;" | [[BOMGenerator]]
| style="background: lightpink;" | [[Localise]]
| style="background: lightblue;" | [[extraexpense]]
| style="background: lightwhite;" | [[moreExpense]]
| style="background: lightwhite;" |
| style="background: lightyellow;" | [[customLink]]
| style="background: lightblue;" | [[MyDiscount]]
| style="background: lightyellow;" | [[Periodic]]
| style="background: lightwhite;" |
| style="background: lightyellow;" | [[MyDolidash]]
| style="background: lightwhite;" | [[myListAPI]]
| style="background: lightpink;" | [[myPrint]]
|-
|
| style="background: lightyellow;" | [[StockMovR]]
| style="background: lightwhite;" | [[TimeKeepR]]
| style="background: lightwhite;" |
| style="background: lightwhite;" |
| style="background: lightgreen;" | [[RmindR]]
| style="background: lightblue;" | [[myBroadcast ]]
| style="background: lightblue;" | [[extraECM]]
| style="background: lightwhite;" |
|}


{| class="wikitable"
|-
! scope="col" colspan="5"| Légende Documentation
|-
| style="background: lightwhite;" | pas encore en ligne
| style="background: pink;" | format pdf à convertir
| style="background: lightyellow;" | en cours de réécriture
| style="background: lightgreen;" | documentation à jour
| style="background: lightblue;" | avec une version Anglaise
|}

= Vidéos de présentation de modules = 


<youtube>75ECrxNu_3Y</youtube> <youtube>LQbQntImSwA</youtube> <youtube>WBFS9Yfdli4</youtube>


<youtube>PNrEo9Dj_Go</youtube> <youtube>d1a5NRrfsj8</youtube> <youtube>OxQN9bD52HA</youtube>


<youtube>1ZKnTFTGxfM</youtube> <youtube>86pxkdQfsr4</youtube> <youtube>OPJvDERkcfc</youtube>


<youtube>ofFsoci9jls</youtube> <youtube>KTRH4wE5rpU</youtube> <youtube>9NqynenRUv4</youtube>


Vous trouverez aussi bientôt quelques tutoriaux et autres réponses à des questions fréquemment posées.

</translate>

MoreWebportal

2026-03-16T15:33:20Z

Admiw :

MoreWebportal

2026-03-16T15:30:07Z

Admiw :

MoreWebportal

2026-03-16T15:22:36Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Liste des accès == 

Une fois les accès définis, la page d'accueil du portail web fera apparaitre à la fois dans les menus les éléments mais aussi sur la page d'accueil

[[File:morewebportal_MainPage.png |750px]]

Voici la liste des éléments dont le module morewebportal ajoute :
* Fiches d'interventions
* Ticket
* Expéditions
* Entrepôt client

Le module Factory ainsi que le module Equipement possède leur propre accès au portail web

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

MoreWebportal

2026-03-16T15:22:06Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Liste des accès == 

Une fois les accès définis, la page d'accueil du portail web fera apparaitre à la fois dans les menus les éléments mais aussi sur la page d'accueil

[[File:morewebportal_MainPage.png |750px]]

Voici la liste des éléments dont le module morewebportal ajoute :
- Fiches d'interventions
- Ticket
- Expéditions
- Entrepôt client

Le module Factory ainsi que le module Equipement possède leur propre accès au portail web

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

MoreWebportal

2026-03-16T15:21:49Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Liste des accès == 

Une fois les accès définis, la page d'accueil du portail web fera apparaitre à la fois dans les menus les éléments mais aussi sur la page d'accueil

[[File:morewebportal_MainPage.png |750px]]

Voici la liste des éléments dont le module morewebportal ajoute :
- Fiches d'interventions
- Ticket
- Expéditions
- Entrepôt client

Le module Factory ainsi que le module Equipement possède leur propre accès au portail web

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

Fichier:Morewebportal MainPage.png

2026-03-16T15:18:40Z

Admiw :

MoreWebportal

2026-03-16T15:18:13Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Liste des accès == 

Une fois les accès définis, la page d'accueil du portail web fera apparaitre à la fois dans les menus les éléments mais aussi sur la page d'accueil

[[File:morewebportal_MainPage.png |750px]]

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

Fichier:Morewebportal settingPage.png

2026-03-16T15:16:28Z

Admiw :

MoreWebportal

2026-03-16T15:15:35Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.

[[File:morewebportal_settingPage.png |800px]]

Pour les entrepôts clients il convient d'avoir associé un entrepot au client connecté. une fois l'accès à l'entrepôt activé, deux autres paramètres apparaissent permettant de définir si l'on souhaite afficher la valorisation des produits présents ainsi que les numéros de lots et autres dlc (si le module batch/lot est naturellement activé)

== Accès au module == 


Le module ajoute un onglet supplémentaire à la GED native qui reprend le fonctionnement de l'onglet de gestion native des documents


[[File:ExtraEcm_MainPage.png |750px]]

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

MoreWebportal

2026-03-16T15:12:09Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}

== Configuration ==
Une fois le module activé, on défini les éléments auxquels on souhaite accéder depuis la panneau de configuration.
[[File:morewebportal_settingPage.png |800px]]

Pour

== Accès au module == 


Le module ajoute un onglet supplémentaire à la GED native qui reprend le fonctionnement de l'onglet de gestion native des documents


[[File:ExtraEcm_MainPage.png |750px]]

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

MoreWebportal

2026-03-16T15:09:20Z

Admiw :

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.jpg]]
|MoreWebportal ajoute des accès à des éléments supplémentaires depuis le portail web natif de Dolibarr.

|}
<youtube>Edh4mDY8j9k</youtube>

== Configuration ==
Le module n'a pas de configuration, il suffit juste de l'installer et de l'activer pour qu'il soit opérationnel

== Accès au module == 


Le module ajoute un onglet supplémentaire à la GED native qui reprend le fonctionnement de l'onglet de gestion native des documents


[[File:ExtraEcm_MainPage.png |750px]]

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

Fichier:Morewebportal-250x250.jpg

2026-03-16T15:07:11Z

Admiw :

MoreWebportal

2026-03-16T15:05:45Z

Admiw : Page créée avec « <languages/> <translate>  {| class="wikitable" |- style="vertical-align:top;" | File:morewebportal-250x250.png |ExtraEcm enrichie la gestion des documents native (GED) en ajoutant la sélection et l'export de fichiers dans un fichier zip et le filtrage des documents selon leur tiers et la date de création. |} <youtube>Edh4mDY8j9k</youtube> == Configuration == Le module n'a pas de configuration, il suffit juste de l'installer et de l'activer po... »

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:morewebportal-250x250.png]]
|ExtraEcm enrichie la gestion des documents native (GED) en ajoutant la sélection et l'export de fichiers dans un fichier zip et le filtrage des documents selon leur tiers et la date de création.
|}
<youtube>Edh4mDY8j9k</youtube>

== Configuration ==
Le module n'a pas de configuration, il suffit juste de l'installer et de l'activer pour qu'il soit opérationnel

== Accès au module == 


Le module ajoute un onglet supplémentaire à la GED native qui reprend le fonctionnement de l'onglet de gestion native des documents


[[File:ExtraEcm_MainPage.png |750px]]

== Filtrage sur la date du document == 


Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.


{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents == 


L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.


Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé
</translate>

Accueil

2026-03-10T07:26:57Z

Admiw :

<languages/>
<translate>

[[File:patas-monkey-logo.png]]


Bonjour et Bienvenue sur notre wiki, vous trouverez ce site les documentations des modules que nous développons et maintenons.


Le but étant de rendre accessible la documentation directement à partir des pages du module


{{Note| L'ensemble des modules s'installent et se mettent à jour de manière standard à Dolibarr.


Vous trouverez dans notre '''[[Guide d'installation]]''' les informations nécessaires pour les installer sur votre environnement.


Et ici le '''[[Guide de mise à jour]]'''.
}}

= Liste des documentations = 


{| class="wikitable"
|-
! scope="col"| GPAO
! scope="col"| Gestion de Stock
! scope="col" colspan="2"| RH
! scope="col"| Interface


! scope="col" colspan="4"| Améliorations
! scope="col" colspan="3"| Reporting
|-
| style="background: lightyellow;" | [[Equipement]]
| style="background: lightyellow;" | [[reStock]]
| style="background: lightblue;" | [[mySchedule]]
| style="background: lightblue;" | [[moreHoliday]]
| style="background: lightblue;" | [[doliSmart]]
| style="background: lightblue;" | [[customLine]]
| style="background: lightblue;" | [[myField]]
| style="background: lightblue;" | [[coefPricR]]
| style="background: lightblue;" | [[SupplierPricR]]
| style="background: lightblue;" | [[myList]]
| style="background: lightblue;" | [[Forecast]]
| style="background: lightblue;" | [[Activity]]
|-
| style="background: lightblue;" | [[Factory]]
| style="background: lightblue;" | [[Transporteur]]
| style="background: lightgreen;" | [[Management]]
| style="background: lightblue;" | [[Portofolio]]
| style="background: lightwhite;" | [[moreWebportal]]
| style="background: lightblue;" | [[customTabs]]
| style="background: lightblue;" | [[myClock]]
| style="background: lightgreen;" | [[DoliTweak]]
| style="background: lightblue;" | [[moreFlow]]
| style="background: lightgreen;" | [[listGPT]]
| style="background: lightgreen;" | [[ProjectBudget]]
| style="background: lightgreen;" | [[moreField]]
|-
| style="background: lightblue;" | [[customProduct]]
| style="background: lightblue;" | [[myBooking]]
| style="background: lightgreen;" | [[MatchR]]
| style="background: lightpink;" | [[Process]]
| style="background: lightwhite;" |
| style="background: lightblue;" | [[customTooltip]]
| style="background: lightblue;" | [[ExtraList]]
| style="background: lightblue;" | [[Extraprice]]
| style="background: lightgreen;" | [[PrestHarvest]]
| style="background: lightyellow;" | [[myDoliboard]]
| style="background: lightgreen;" | [[extraOdt]]
| style="background: lightblue;" | [[moreActionList]]
|-
| style="background: lightblue;" | [[BOMGenerator]]
| style="background: lightpink;" | [[Localise]]
| style="background: lightblue;" | [[extraexpense]]
| style="background: lightwhite;" | [[moreExpense]]
| style="background: lightwhite;" |
| style="background: lightyellow;" | [[customLink]]
| style="background: lightblue;" | [[MyDiscount]]
| style="background: lightyellow;" | [[Periodic]]
| style="background: lightwhite;" |
| style="background: lightyellow;" | [[MyDolidash]]
| style="background: lightwhite;" | [[myListAPI]]
| style="background: lightpink;" | [[myPrint]]
|-
|
| style="background: lightyellow;" | [[StockMovR]]
| style="background: lightwhite;" | [[TimeKeepR]]
| style="background: lightwhite;" |
| style="background: lightwhite;" |
| style="background: lightgreen;" | [[RmindR]]
| style="background: lightblue;" | [[myBroadcast ]]
| style="background: lightblue;" | [[extraECM]]
| style="background: lightwhite;" |
|}


{| class="wikitable"
|-
! scope="col" colspan="5"| Légende Documentation
|-
| style="background: lightwhite;" | pas encore en ligne
| style="background: pink;" | format pdf à convertir
| style="background: lightyellow;" | en cours de réécriture
| style="background: lightgreen;" | documentation à jour
| style="background: lightblue;" | avec une version Anglaise
|}

= Vidéos de présentation de modules = 


<youtube>75ECrxNu_3Y</youtube> <youtube>LQbQntImSwA</youtube> <youtube>WBFS9Yfdli4</youtube>


<youtube>PNrEo9Dj_Go</youtube> <youtube>d1a5NRrfsj8</youtube> <youtube>OxQN9bD52HA</youtube>


<youtube>1ZKnTFTGxfM</youtube> <youtube>86pxkdQfsr4</youtube> <youtube>OPJvDERkcfc</youtube>


<youtube>ofFsoci9jls</youtube> <youtube>KTRH4wE5rpU</youtube> <youtube>9NqynenRUv4</youtube>


Vous trouverez aussi bientôt quelques tutoriaux et autres réponses à des questions fréquemment posées.

</translate>

ExtraList

2026-02-13T16:08:59Z

Admiw : /* Gestion de l'affichage des catégories */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_250x250.png]]
| Le module ExtraList permet de rajouter aux listes natives de dolibarr des champs, issus des attributs personnalisés ou d'autres champs non prévu initialement à la liste:
* sélection des attributs supplémentaires disponible pour la liste
* ajout de champs supplémentaires disponible dans les tables natives de la liste ou ajouté en table jointe pour le champ
* le surlignage de lignes selon un critère de sélection
* L'affichage des catégories associées à un élément


Les champs ainsi rajoutés sont alors affichés dans le sélecteur de champs de la liste et utilisable comme n'importe quel autre champs natif
|}


<youtube>9NqynenRUv4</youtube>
==Page principale==
A partir du menu principal des outils patas-monkey, le menu gauche extralist présente la liste des listes personnalisables de l'outil
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_index.png|600px]]
| Chaque bloc représente une liste personnalisable contenant :
* La gestion des d'attributs supplémentaires disponible
* La gestion des champs supplémentaires déjà ajouté à la liste
* La gestion des critères de surlignage de la liste
Le nombre en bout de ligne indique si il y a déjà un paramétrage réalisé
|}


== Gestion des attributs personnalisés==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs disponibles
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extrafieldsfields.png|600px]]
| L'appuie sur le premier icone orange permet de sélectionner les attributs disponible pour la liste que l'on souhaite afficher
Il suffit de cliquer sur le sélecteur en bout de ligne pour activer ou non le champs dans la liste
|}


== Gestion des champs supplémentaires==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs déjà paramétrés et permet d'en ajouter de nouveau.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfields.png|600px]]
| L'appuie sur le second icone gris permet d'accéder à la liste des champs supplémentaires que l'on a déjà défini
A partir de la liste, il est possible de modifier un champ déjà existant (icone en début de ligne) ou de le supprimer (icone en bout de ligne)
|}


=== Ajout d'un nouveau champs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsadd.png|600px]]
| L'appuie sur l'icone (+) au bout du titre permet de créer un nouveau champ personnalisé, il sera possible de saisir alors
* Le libellé du champ que l'on souhaite ajouter
* Le nom du champ dans la base de donnée avec son préfix (comme par exemple s. pour société, p. pour projet, ...), il est possible d'employer un alias (si on utilise paramètre un champ calculé).
* Le type de champs afin de mieux en gérer le format de présentation sur la liste
|}


=== Edition d'un champ existant ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsedit.png|600px]]
| L'appuie sur l'icone en forme de style en début de ligne permet de afficher le paramétrage du champ personnalisé.


|}


=== Gestion de la jointure de table ===
Il est possible de rajouter une jointure SQL vers une ou plusieurs tables si le champ n'est pas présent dans les tables utilisés par la liste.


Attention cette fonctionnalité demande de connaitre à la fois le SQL et la structuration des tables de Dolibarr.


Nous proposons en support payant sur notre site https://www.patas-monkey.com/boutique de vous accompagner sur cette fonctionnalité


=== Fonctionnement des nouveaux champs ===
Une fois le paramétrage réalisé, il est possible d'accéder aux nouveaux champs à partir du sélecteur de champs natif de la liste.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_selected.png|400px]]
| Si il y a des champs ajoutés par ExtraList dans la liste, l'icone de sélection des champs change de couleur
* Les champs issus d'attributs supplémentaires présente l'élément dont ils proviennent
* Les champs ajoutés sont préfixé avec "EL"
|}


== Gestion des lignes surlignées ==
Extralist permet de surligner certaines lignes avec un code couleur associé à une règle de sélection.

Il est possible d'avoir plusieurs filtrage pour une même liste

[[File:extralist_extralistselligneresult.png|800px]]

L'appuie sur l'icone (+) au bout du titre permet de créer une nouvelle sélection de surlignage.

[[File:extralist_extralistsellignelist.png|800px]]

L'appuie sur l'icone en forme de stylo permet de modifier le surlignage.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistselligneedit.png|600px]]

|
L'écran d'édition permet de définir :

* le champ utilisé pour le filtrage (extrafields inclus)
* la couleur utilisée pour le surlignage
* le type de filtrage (égale, différent, inférieur, ...)
* la valeur associée au filtrage


Il est possible pour la valeur de filtrage d'utiliser des valeurs prédéfinies comme #NOW# pour la date du jour ou #USERID# pour l'utilisateur en cours

|}

== Gestion de l'affichage des catégories ==


{| class="wikitable"
|- style="vertical-align:top;"
| Il est possible d'afficher sur la liste les catégories des éléments en activant la coche au niveau du paramétrage de l'élément sur la page d'index du module.


|
[[File:extralist_selectcategory.png|300px]]


|}

Une colonne affichant la ou les catégories (dans un tooltip alors) associé à l'élément est sélectionnable.

[[File:extralist_displaycategorylist.png|800px]]

</translate>

ExtraList

2026-02-13T16:04:37Z

Admiw : /* Gestion des lignes surlignées */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_250x250.png]]
| Le module ExtraList permet de rajouter aux listes natives de dolibarr des champs, issus des attributs personnalisés ou d'autres champs non prévu initialement à la liste:
* sélection des attributs supplémentaires disponible pour la liste
* ajout de champs supplémentaires disponible dans les tables natives de la liste ou ajouté en table jointe pour le champ
* le surlignage de lignes selon un critère de sélection
* L'affichage des catégories associées à un élément


Les champs ainsi rajoutés sont alors affichés dans le sélecteur de champs de la liste et utilisable comme n'importe quel autre champs natif
|}


<youtube>9NqynenRUv4</youtube>
==Page principale==
A partir du menu principal des outils patas-monkey, le menu gauche extralist présente la liste des listes personnalisables de l'outil
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_index.png|600px]]
| Chaque bloc représente une liste personnalisable contenant :
* La gestion des d'attributs supplémentaires disponible
* La gestion des champs supplémentaires déjà ajouté à la liste
* La gestion des critères de surlignage de la liste
Le nombre en bout de ligne indique si il y a déjà un paramétrage réalisé
|}


== Gestion des attributs personnalisés==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs disponibles
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extrafieldsfields.png|600px]]
| L'appuie sur le premier icone orange permet de sélectionner les attributs disponible pour la liste que l'on souhaite afficher
Il suffit de cliquer sur le sélecteur en bout de ligne pour activer ou non le champs dans la liste
|}


== Gestion des champs supplémentaires==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs déjà paramétrés et permet d'en ajouter de nouveau.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfields.png|600px]]
| L'appuie sur le second icone gris permet d'accéder à la liste des champs supplémentaires que l'on a déjà défini
A partir de la liste, il est possible de modifier un champ déjà existant (icone en début de ligne) ou de le supprimer (icone en bout de ligne)
|}


=== Ajout d'un nouveau champs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsadd.png|600px]]
| L'appuie sur l'icone (+) au bout du titre permet de créer un nouveau champ personnalisé, il sera possible de saisir alors
* Le libellé du champ que l'on souhaite ajouter
* Le nom du champ dans la base de donnée avec son préfix (comme par exemple s. pour société, p. pour projet, ...), il est possible d'employer un alias (si on utilise paramètre un champ calculé).
* Le type de champs afin de mieux en gérer le format de présentation sur la liste
|}


=== Edition d'un champ existant ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsedit.png|600px]]
| L'appuie sur l'icone en forme de style en début de ligne permet de afficher le paramétrage du champ personnalisé.


|}


=== Gestion de la jointure de table ===
Il est possible de rajouter une jointure SQL vers une ou plusieurs tables si le champ n'est pas présent dans les tables utilisés par la liste.


Attention cette fonctionnalité demande de connaitre à la fois le SQL et la structuration des tables de Dolibarr.


Nous proposons en support payant sur notre site https://www.patas-monkey.com/boutique de vous accompagner sur cette fonctionnalité


=== Fonctionnement des nouveaux champs ===
Une fois le paramétrage réalisé, il est possible d'accéder aux nouveaux champs à partir du sélecteur de champs natif de la liste.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_selected.png|400px]]
| Si il y a des champs ajoutés par ExtraList dans la liste, l'icone de sélection des champs change de couleur
* Les champs issus d'attributs supplémentaires présente l'élément dont ils proviennent
* Les champs ajoutés sont préfixé avec "EL"
|}


== Gestion des lignes surlignées ==
Extralist permet de surligner certaines lignes avec un code couleur associé à une règle de sélection.

Il est possible d'avoir plusieurs filtrage pour une même liste

[[File:extralist_extralistselligneresult.png|800px]]

L'appuie sur l'icone (+) au bout du titre permet de créer une nouvelle sélection de surlignage.

[[File:extralist_extralistsellignelist.png|800px]]

L'appuie sur l'icone en forme de stylo permet de modifier le surlignage.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistselligneedit.png|600px]]

|
L'écran d'édition permet de définir :

* le champ utilisé pour le filtrage (extrafields inclus)
* la couleur utilisée pour le surlignage
* le type de filtrage (égale, différent, inférieur, ...)
* la valeur associée au filtrage


Il est possible pour la valeur de filtrage d'utiliser des valeurs prédéfinies comme #NOW# pour la date du jour ou #USERID# pour l'utilisateur en cours

|}

== Gestion de l'affichage des catégories ==


{| class="wikitable"
|- style="vertical-align:top;"
|Il est possible d'afficher sur la liste les catégories des éléments en activant la coche au niveau du paramétrage de l'élément sur la page d'index du module.


[[File:extralist_selectcategory.png|300px]]
| Une colonne affichant la ou les catégories (dans un tooltip alors) associé à l'élément est sélectionnable.


[[File:extralist_displaycategorylist.png|800px]]
|}
</translate>

ExtraList

2026-02-13T16:02:34Z

Admiw : /* Gestion des lignes surlignées */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_250x250.png]]
| Le module ExtraList permet de rajouter aux listes natives de dolibarr des champs, issus des attributs personnalisés ou d'autres champs non prévu initialement à la liste:
* sélection des attributs supplémentaires disponible pour la liste
* ajout de champs supplémentaires disponible dans les tables natives de la liste ou ajouté en table jointe pour le champ
* le surlignage de lignes selon un critère de sélection
* L'affichage des catégories associées à un élément


Les champs ainsi rajoutés sont alors affichés dans le sélecteur de champs de la liste et utilisable comme n'importe quel autre champs natif
|}


<youtube>9NqynenRUv4</youtube>
==Page principale==
A partir du menu principal des outils patas-monkey, le menu gauche extralist présente la liste des listes personnalisables de l'outil
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_index.png|600px]]
| Chaque bloc représente une liste personnalisable contenant :
* La gestion des d'attributs supplémentaires disponible
* La gestion des champs supplémentaires déjà ajouté à la liste
* La gestion des critères de surlignage de la liste
Le nombre en bout de ligne indique si il y a déjà un paramétrage réalisé
|}


== Gestion des attributs personnalisés==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs disponibles
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extrafieldsfields.png|600px]]
| L'appuie sur le premier icone orange permet de sélectionner les attributs disponible pour la liste que l'on souhaite afficher
Il suffit de cliquer sur le sélecteur en bout de ligne pour activer ou non le champs dans la liste
|}


== Gestion des champs supplémentaires==
Après avoir appuyé sur l'icone de sélection des attributs supplémentaires, un écran présente les champs déjà paramétrés et permet d'en ajouter de nouveau.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfields.png|600px]]
| L'appuie sur le second icone gris permet d'accéder à la liste des champs supplémentaires que l'on a déjà défini
A partir de la liste, il est possible de modifier un champ déjà existant (icone en début de ligne) ou de le supprimer (icone en bout de ligne)
|}


=== Ajout d'un nouveau champs ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsadd.png|600px]]
| L'appuie sur l'icone (+) au bout du titre permet de créer un nouveau champ personnalisé, il sera possible de saisir alors
* Le libellé du champ que l'on souhaite ajouter
* Le nom du champ dans la base de donnée avec son préfix (comme par exemple s. pour société, p. pour projet, ...), il est possible d'employer un alias (si on utilise paramètre un champ calculé).
* Le type de champs afin de mieux en gérer le format de présentation sur la liste
|}


=== Edition d'un champ existant ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistfieldsedit.png|600px]]
| L'appuie sur l'icone en forme de style en début de ligne permet de afficher le paramétrage du champ personnalisé.


|}


=== Gestion de la jointure de table ===
Il est possible de rajouter une jointure SQL vers une ou plusieurs tables si le champ n'est pas présent dans les tables utilisés par la liste.


Attention cette fonctionnalité demande de connaitre à la fois le SQL et la structuration des tables de Dolibarr.


Nous proposons en support payant sur notre site https://www.patas-monkey.com/boutique de vous accompagner sur cette fonctionnalité


=== Fonctionnement des nouveaux champs ===
Une fois le paramétrage réalisé, il est possible d'accéder aux nouveaux champs à partir du sélecteur de champs natif de la liste.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_selected.png|400px]]
| Si il y a des champs ajoutés par ExtraList dans la liste, l'icone de sélection des champs change de couleur
* Les champs issus d'attributs supplémentaires présente l'élément dont ils proviennent
* Les champs ajoutés sont préfixé avec "EL"
|}


== Gestion des lignes surlignées ==
Extralist permet de surligner certaines lignes avec un code couleur associé à une règle de sélection.

Il est possible d'avoir plusieurs filtrage pour une même liste

[[File:extralist_extralistselligneresult.png|800px]]

L'appuie sur l'icone (+) au bout du titre permet de créer une nouvelle sélection de surlignage.

L'appuie sur l'icone en forme de stylo permet de modifier le surlignage.

[[File:extralist_extralistsellignelist.png|800px]]

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:extralist_extralistselligneedit.png|600px]]

|
* sélection des champs qui peuvent être utilisé pour le filtrage
* la couleur utilisée pour le surlignage
* le type de filtrage (égale, différent, inférieur, ...)
* la valeur associé au filtrage


Il est possible pour la valeur de filtrage d'utiliser des valeurs prédéfinies comme #NOW# pour la date du jour ou #USERID# pour l'utilisateur en cours

|}

== Gestion de l'affichage des catégories ==


{| class="wikitable"
|- style="vertical-align:top;"
|Il est possible d'afficher sur la liste les catégories des éléments en activant la coche au niveau du paramétrage de l'élément sur la page d'index du module.


[[File:extralist_selectcategory.png|300px]]
| Une colonne affichant la ou les catégories (dans un tooltip alors) associé à l'élément est sélectionnable.


[[File:extralist_displaycategorylist.png|800px]]
|}
</translate>

MyField

2026-02-03T10:48:37Z

Admiw : /* Création du myField */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myfield-250x250.png]]
| Le module myField permet de personnaliser les libellés des menus, onglets, bouton, champs des fiches et listes de Dolibarr.
Vous pouvez choisir vous-même le libellé, la couleur et l'accès de vos menus, des boutons, des onglets et champs des fiches et listes
|}


== Présentation ==
Selon le type de myfield (champs d'une fiche, liste, onglet,...), plusieurs autres options peuvent être appliquées aux champs des fiches telles qu'une couleur de fond, les afficher/ cacher, ajouter un masque de saisie, saisie en majuscule ...


Le jeu combiné des permissions utilisateurs et des droits d'accès aux myFields permet de paramétrer les accès des utilisateurs à la vue des champs, leur contenu et leur modification.


MyField permet encore de cacher des menus à des groupes d'utilisateurs et d'en modifier l'URL de destination.


== Paramétrage ==
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou l'icône [[file:doli-setup-old.png]] en bout de ligne.


[[file:myfield_Configuration.png|800px]]

=== Page de configuration du module === 


==== Activation du contexte pour le développement====
MyField permet d'afficher sur certaines pages de Dolibarr les contextes utilisables pour limiter les actions de personnalisations des myFields.
Ces contextes seront utiles lors de la création de myFields pour limiter l'action du module aux seules pages possédant dans leur code le contexte indiqué sur la fiche du myField.
Paramétrer l'affichage des contexte sur vos pages vous permettra de les identifier pour paramétrer au mieux vos myfields.


{| class="wikitable"
| [[file:myfield-Message-contexte.png]]
| style="vertical-align:top;" |
L'activation de l'affichage des contextes se traduit par des messages comme ci-contre
|}


==== L'administrateurs est au dessus des règles d'accès ====
Vous pouvez aussi choisir de désactiver l'utilisation des droits d'accès pour l'utilisateur administrateur.


Si ce paramètre est activé, l'administrateur verra, hors de tout groupe, les myfields en fonctionnement.


==== Couleur de fond des zones de saisie====
Par défaut les zones de saisies dans dolibarr sont transparentes, ce qui n'aide pas à la lisibilité
Il est possible de changer la couleur de fond des zones de saisies


==== Couleur des boutons par défaut====
Il y a trois types de boutons dans Dolibarr:
* Les boutons associés à une action
* Les boutons désactivés
* Les boutons effectuant une suppression
myField permet de changer la couleur de ceux-ci


==== Remplacement des boutons natifs====
MyField permet le remplacement des boutons standards de Dolibarr par des icônes.
{| class="wikitable"
| [[file:myfield_Button-replace.png|300px]]
| au lieu de
| [[file:myfield_Button-standard.png|500px]]
|}


==== Information de support ====
Vous trouverez en bas de la page de configuration les informations techniques liées à votre installation. Ces informations techniques seront utiles et pourront vous être demandées si vous rencontrez un bug dans l'utilisation du module :
[[file:Myfield_Technical-information.png||800px]]


===Permissions===
Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module.


Cliquez sur le – pour ajouter un permission.


Une permission accordée est symbolisée par un coche verte ([[file:tick.png]]).


{{Note|Attention : il y a d'autres paramètres qui peuvent impacter l'accès aux champs, notamment quand on utilise un compte administrateur}}


====Permissions utilisateurs et groupes====
{| class="wikitable"
| [[file:myfield-Permissions-utilisateur.png|600px]]
| style="vertical-align:top;" |
Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions ci-contre
|}


====Permissions par défaut====
{| class="wikitable"
| [[file:myfield-Permissions-defaut.png|600px]]
| style="vertical-align:top;" |
Les permissions par défaut ('''Accueil > Utilisateurs et groupe > Choisir entre utilisateurs ou groupe > Sélectionner les autorisations'''), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}

== Démarrage == 


Les fonctionnalités de MyField sont accessibles depuis l'onglet de menu principal Patastools.
Votre menu secondaire présente alors les entrées de menu suivantes :


{| class="wikitable"
|- style="vertical-align:top;"
| style='border-style: none;' | '''MyField'''
| L'entrée principale affiche la liste de tous les myFields de votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' |
'''Nouveau mf Field''' 
'''Nouveau mf Tab''' 
'''Nouveau mf Onglet''' 
'''Nouveau mf de liste''' 
'''Nouveau mf Menu''' 
'''Nouveau mf Bouton'''


| Ces entrées afficheront la page de création d'un nouveau myField selon son type :
* champ de fiche
* onglet
* bouton
* champs de liste
* menu
|- style="vertical-align:top;"
| style='border-style: none;' | '''Liste des éléments'''
| Cette entrée affichera également la liste des myFields enregistrés sur votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' | '''Droits d'accès aux éléments'''
| Cette page vous permettra de paramétrer les habilitations des groupes d'utilisateurs aux fonctionnalités de MyFields, tabs et menus.
|- style="vertical-align:top;"
| style='border-style: none;' | '''Import XML'''
| Cette entré affichera une page permettant de copier un fichier d'import d'un myfield au format XML.
|}


== Personnalisations ==
=== Menus ===
==== Création du myField ====
La page de création d'un myField de type menu est accessible depuis le lien de menu secondaire '''Patas-tools > MyField > Nouveau myMenu.'''


[[File:Myfield-Page-creation-menu.png|800px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué pour afficher cette page de création (menu).
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché sur votre interface.
|-
| style="vertical-align:top;" |
Type de menu
| style="vertical-align:top;" |
sélectionnez dans la liste déroulante le type de menu que vous souhaitez personnaliser selon qu'il s'agit d'un menu principal, d'un menu secondaire ou d'une entrée de menu secondaire.
|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du champ.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


Suite à la création d'un myField, il sera nécessaire d'en définir les droits d'accès par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir plus loin)


====Exemple de personnalisation d'un menu principal====
Personnalisons le menu ''Accueil''.


[[file:myfield-Param-menu-accueil.png|600px]]


[[file:Myfield-menu-resultat.png|600px]]


====Exemple de personnalisation d'un menu et d'une entrée de menu secondaire====
Personnalisons le menu secondaire Propositions commerciales et l'entrée de menu secondaire Nouvelle proposition.


[[file:myfield-Param-menu-secondaire.png|600px]]


[[file:myfield-Param-entree-menu-secondaire.png|600px]]


{{Note|L'entrée de menu secondaire sera déplacée d'un rang vers le bas avec le code -1 dans le champ Déplacement de sa fiche}}
Suite à l'application de ces deux personnalisations, le menu secondaire devient :


{| class="wikitable"
| [[file:Myfield-entree-menu-secondaire.png]]
| style="vertical-align:top;" |
plutôt que
| [[file:Myfield-menu-secondaire.png]]
|}


====Cas particulier de entrées de menu secondaire "Liste"====
Pour différencier les entrées de menu secondaire du même nom, saisissez le menu de niveau supérieur auquel elles sont rattachées séparées par un dièse ('''#''') :


{| class="wikitable"
| style="vertical-align:top;" |
''Ajoutez au libellé le menu secondaire : Propositions commerciales#Liste''


[[file:myfield_Liste-param.png|600px]]


| style="vertical-align:top;" |
Pour obtenir


[[file:myfield_Liste-param-menu.png]]
|}


===Onglets===
====Création du myField d'onglet====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyTab'''.


[[file:myfield-Page-creation-onglet.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
Le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
{{Note|Attention, pour les onglets, le contexte correspond au tabTitleText (le nom du premier onglet) (ex: "Tiers" pour l'élément Tiers, "Produit" pour l'élément Produit) }}


Si aucun context n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField


|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).


|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


{{Note|N'indiquez ici que la partie de l'URL suivant ''/htdocs/''}}
Requête d'affichage : voir section Fonctionnement, ci-dessous


Suite à la création d'un myField, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).


====Exemple de personnalisation d'un onglet====
Personnalisons l'onglet fiche des fiches des éléments.


[[file:myfield-Param-onglet-fiche.png|800px]]


La fiche devient alors


[[file:myfield-Natif-fiche.png|800px]]
{{Note|Si l'onglet est actif, la couleur sera affichée sur ses bords}}


===Champs===
====Création du myField====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyField'''.


[[file:myfield-Page-creation.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du champ tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
Si aucun contexte n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


[[#Contexte d'activation|Liste des principaux contexte ]]


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|-
| style="vertical-align:top;" |
Masque de saisie
| style="vertical-align:top;" |
le masque de saisie est paramétrable avec les caractères suivants :
*a pour une lettre (A-Z,a-z)
*9 pour un chiffre (0-9)
*pour un caractère alphanumérique (A-Z,a-z,0-9)
:Vous pouvez ajouter dans le champ les caractères que vous souhaitez pour constituer votre masque. Par exemple, si vous souhaitez ajouter un indicatif international au champ téléphone, le masque sera : +0099-(9)999999999
*UPPERCASE pour forcer la saisie en majuscule.
*LOWERCASE pour forcer la saisie en minuscule.
|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché il faut cliquer sur le numéro de version de Dolibarr (en haut à droite).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez 1 pour remonter d'un champ, -1 pour descendre.
|-
| style="vertical-align:top;" |
Valeur par défaut
| style="vertical-align:top;" |
Correspond à une saisie par défaut dans le champ à la création.

Cette zone peut aussi être utilisé dans le cas d'un champs obligatoire que l'on souhaite cacher.
|-
| style="vertical-align:top;" |
Taille du champ de saisie
| style="vertical-align:top;" |
à définir selon vos besoins. Si laissé vide, la valeur native du champ est conservée.
|-
| style="vertical-align:top;" |
Obligatoire :
| style="vertical-align:top;" |
Cochez cette case pour rendre la saisie de valeurs dans le champ obligatoire pour enregistrer la création ou les modifications de la page.

Le libellé du texte associé aux champs sera mis en gras pour respecter la charte graphique de dolibarr sur les champs obligatoire.

Sur les champs de type texte, il y a un tooltip précisant qu'il est obligatoire qui n'est pas présent au niveau des listes déroulantes.

|-
| style="vertical-align:top;" |
Requête d'affichage
| style="vertical-align:top;" |
Voir section Fonctionnement
|}


|}


{{Note|Le déplacement d'un champ d'une fiche n'est effectué qu'au sein de son tableau. Il est donc possible de remonter ou descendre un champ, mais pas de le changer de colonne}}


Suite à la création d'un myField de type champ, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).

====Exemple de personnalisation d'un champ====
Personnalisons le champ ''Id. prof. 2 (SIRET)'' des fiches de tiers.


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield_Param-champ.png|600px]]
| Le champ a été paramétré en tant qu'invisible avec un masque de saisie de chiffres (999 999 999 99999)


|- style="vertical-align:top;"
| [[file:Myfield-champ.png|600px]]


[[file:myfield-Masque.png]]


|
En cliquant sur le lien Show/Hide au-dessus du tableau, le champ sera affiché selon les paramètres enregistrés sur la fiche du myField


Lors de l'édition du champ, le masque sera activé et ne permettra que la saisie prédéfinie et sa complétion vérifiée (rendu obligatoire) pour empêcher l'enregistrement de la page sans qu'il ne soit rempli.
|}


===Listes===
Il est possible de modifier les champs des listes natives de dolibarr (celle avec une icone de sélection de champs en bout de liste)


====Création du myField====
Les myfields de liste permettent de limiter l'affichage de champs.
il est nécessaire d'ouvrir la page de liste pour récupérer des informations propre à ce type de myField
* le contexte d'activation
* le libellé non traduit du champs


====Exemple de paramétrage====
Nous allons modifier la colonne "Tiers" sur la liste des interventions


[[file:Myfield-masque-tiers.png|600px]]


Selon les habilitations, le champs sera aussi inaccessible dans le sélecteur de champs.


[[file:myfield_Liste-contrats.png|600px]]


{{Note|Si vous rendez un myField de liste invisible, il sera invisible de tous les utilisateur. Pour le cacher seulement à un ou des groupes d'utilisateurs, laissez le visible et jouter ensuite avec les droits d'accès !}}


=== Boutons ===
Il est possible de modifier les boutons présent sur les fiches de dolibarr


====Création du myField====
Les myfield de boutons permettent de rendre invisible bouton, remplacer le libellé, l'url associé au bouton et de rendre son accès visible selon le résultat d'une requete SQL


[[file:myfield-creation-bouton.png|600px]]


{{Note|Avec le thème natif de Dolibarr, le libellé du bouton est mis en majuscule, il faut donc utiliser le texte d'origine que l'on récupère avec le click droit et le menu inspecter.}}


=Requête SQL d'affichage conditionnel=
La requête de traitement va conditionner l'affichage des champs selon la correspondance de l'objet à la requête. Il est alors possible, par exemple, d'afficher des champs différents selon que l'objet est un produits ou un service.
Il est possible de transmettre en paramètre deux valeurs :
* #ID# : l'id de l'objet principale de la page
* #USERID# : l'id de l'utilisateur actif

==Fonctionnement== 


Saisissez ici la requête d'affichage applicable au champs sur l'exemple suivant :


#SEL# permet de remplacer le SELECT de la requête SQL qui sera bloqué par la sécurité native de Dolibarr (SQL Injection)


''#SEL# IF(fk_product_type=1, 1, 0) AS `read`, IF(fk_product_type=1, 1, 0) AS `write` FROM llx_product WHERE rowid=#ID#; ''


read permet d'autoriser ou non l'affichage globale du champ
write permet d'autoriser ou non sa modification (pas nécessaire dans le cas d'un bouton un un onglet...)


Si la valeur est à 0, le champs est caché, dans le cas contraire il est affiché
Attention, si on laisse le paramètre du champs à caché, il n'apparaitra pas quel que soit la valeur


==Exemple==
Avec le myfield suivant


[[file:myfield_Creation_requete.png|800px]]


{| class="wikitable"
|- style="vertical-align:top;"
| On obtient la fiche suivante sur un '''produit'''
[[file:myfield_Creation_requete_result.png|400px]]
| Tandis que sur la fiche d'un '''service'''
[[file:myfield_Creation_requete-fiche.png|400px]]

|}


=Paramétrage des droits d'accès aux myFields, tabs et menus=
==Configuration des droits d'accès==
En tant qu'utilisateur administrateur, tous les myFields vous sont visibles.
{{Note|Sur la page d'accueil du module MyField, l'application des personnalisations est désactivée}}


Si vous n'avez pas défini de groupes utilisateurs, les myfields sont affichés sur les interfaces de tous les utilsiateurs.


Depuis l'entrée de menu secondaire '''Patas-Tools > MyField > droits d'accès aux onglets''', paramétrez les accès des groupes d'utilisateurs :


[[file:myfield-Droits-d-acces.png|600px]]


Il existe quatre droits d'accès :


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:lecture-off.png]] Bloqué en accès
[[file:lecture-on.png]] Accès en lecture
| [[file:modif-of.png]] Bloqué en modification
[[file:modif-on.png]] Accès en modification
|}


==Comportement selon les droits d'accès==
===Bloqué en accès ([[file:lecture-off.png]]) ===


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Le champ sera caché aux utilisateurs du groupe. Ils ne pourront pas l'afficher


le lien ''Show/Hide'' ne sera pas actif
|}
===Accès en lecture mais bloqué en modification ([[file:lecture-on.png]][[file:modif-of.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Les utilisateurs du groupe pourront afficher le champ, mais ne pourront pas en modifier le contenu.
|}
===Accès en lecture et Accès en modification ([[file:lecture-on.png]][[file:modif-on.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture+-modif+.png|600px]]
|
Les utilisateurs du groupe pourront afficher le champ et le modifier si leurs permissions de groupe ou d'utilisateur le leur permettent. Les paramètres du champ s'appliquent alors (obligatoire, masque de saisie,...)
|}


=Autres fonctionnalités=
==Import des myField==
Il est possible d'enregistrer une liste de myfields et leurs paramétrages en important un fichier XML.
Depuis la page '''Outils Patas-M > MyField > Importer un onglet''', collez le fichier XML dans la zone de saisie et cliquez sur le bouton '''Lancer l'importation'''.
{{Note|Si vous cochez la case Écraser les données précédentes, votre liste de myfields se résumera à ceux présent dans le ficher que vous importez|warn}}
Paramétrer ensuite les droits d'accès des utilisateurs au myField.


==Contexte d'activation==
Une liste de tous les contextes disponible est présent sur le wiki de dolibarr:
https://wiki.dolibarr.org/index.php?title=Syst%C3%A8me_de_Hooks#Liste_des_Contexts_disponibles_dans_Dolibarr


quelque uns des plus courants
{|
|
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Adhérent
| membertypecard
|-
| Catégories
| categorycard
|-
| Commandes
| ordercard
|-
| Commande fournisseur
| ordersuppliercard
|-
| Contact
| contactcard
|-
| Contrat
| contractcard
|-
| Don
| doncard
|-
| Entrepôt
| warehousecard
|-
| Expédition
| expeditioncard
|-
| Facture client
| invoicecard
|-
| Facture fournisseur
| suppliercard
|}


| style="vertical-align:top;" |
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Intervention
| interventioncard
|-
| Livraison
| deliverycard
|-
| Note de frais
| tripandexpensecard
|-
| Produit
| productcard
|-
| Projet
| projectcard
|-
| Proposition commerciale
| propalcard
|-
| Règlement client
| paiementcard
|-
| Règlement fournisseur
| paymentsupplier
|-
| Salaire
| salarycard
|-
| Tache
| projecttaskcard
|-
| Tiers
| thirdpartycard
|-
| Utilisateur
| usercard


|}


|}


=Questions fréquentes=
== Général ==
Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.
Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :
#Désactivez et réactivez le module,
#Vérifier sur le ChangeLog si une nouvelle version a été publiée,
#Ré-installez/mettez à jour le module,
#Vérifiez que le remplacement de fichiers natifs de Dolibarr ne soit pas nécessaire au bon fonctionnement du module.
#Vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations.


Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant le formulaire dédié (http://docs.patas-monkey.com/support/).
Ce formulaire est le mode de contact à privilégier pour toute difficulté d'utilisation ou remontée de bug. Aussi, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet.


== Affichage d'un message en haut des pages de Dolibarr==
Si vos pages de Dolibarr affichent un message semblable à l'image suivante, il ne s'agit pas d'un message d'erreur, mais de l'affichage des contextes de la page courante. Pour ne plus voir ces lignes affichées, désactivez l'affichage du contexte
(voir Configuration).


[[file:Myfield-Message-contexte.png]]


==Message erreur d'ordonnancement==
Certaines pages de certaines versions de Dolibarr présentent un erreur dans leur code empêchant la bonne application de la personnalisation des champs. MyField permet de les identifier pour les corriger.


Le message d'erreur s'affiche en bas de page et est le suivant


[[file:myfield_Erreur-dbclose-message.png]]


En vous aidant de l'URL de la page, ouvrez le fichier du noyau de Dolibarr pour le modifier. Par exemple, si la page qui comporte le message est ''http://.../htdocs/custom/myField/admin/extrafields.php'', ouvrez successivement les dossiers ''htdocs'', ''custom'', ''myField'', ''admin'' et ouvrez le fichier ''extrafields.php''.


L'erreur vient de l'inversion des lignes ''llxFooter();'' et ''$db->close();'' en fin de fichier.


{| class="wikitable" style="width:60%;"
|- style="vertical-align:top;"
| Modifiez le code de la page pour obtenir
[[file:Erreur-dbclose-correction.png]]
| au lieu de


[[file:Erreur-dbclose.png]]
|}
==Multicompany==
Avec le module multicompany, il convient d'activer le module sur chaque entité
</translate>

MyField

2026-02-03T10:48:08Z

Admiw : /* Création du myField */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myfield-250x250.png]]
| Le module myField permet de personnaliser les libellés des menus, onglets, bouton, champs des fiches et listes de Dolibarr.
Vous pouvez choisir vous-même le libellé, la couleur et l'accès de vos menus, des boutons, des onglets et champs des fiches et listes
|}


== Présentation ==
Selon le type de myfield (champs d'une fiche, liste, onglet,...), plusieurs autres options peuvent être appliquées aux champs des fiches telles qu'une couleur de fond, les afficher/ cacher, ajouter un masque de saisie, saisie en majuscule ...


Le jeu combiné des permissions utilisateurs et des droits d'accès aux myFields permet de paramétrer les accès des utilisateurs à la vue des champs, leur contenu et leur modification.


MyField permet encore de cacher des menus à des groupes d'utilisateurs et d'en modifier l'URL de destination.


== Paramétrage ==
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou l'icône [[file:doli-setup-old.png]] en bout de ligne.


[[file:myfield_Configuration.png|800px]]

=== Page de configuration du module === 


==== Activation du contexte pour le développement====
MyField permet d'afficher sur certaines pages de Dolibarr les contextes utilisables pour limiter les actions de personnalisations des myFields.
Ces contextes seront utiles lors de la création de myFields pour limiter l'action du module aux seules pages possédant dans leur code le contexte indiqué sur la fiche du myField.
Paramétrer l'affichage des contexte sur vos pages vous permettra de les identifier pour paramétrer au mieux vos myfields.


{| class="wikitable"
| [[file:myfield-Message-contexte.png]]
| style="vertical-align:top;" |
L'activation de l'affichage des contextes se traduit par des messages comme ci-contre
|}


==== L'administrateurs est au dessus des règles d'accès ====
Vous pouvez aussi choisir de désactiver l'utilisation des droits d'accès pour l'utilisateur administrateur.


Si ce paramètre est activé, l'administrateur verra, hors de tout groupe, les myfields en fonctionnement.


==== Couleur de fond des zones de saisie====
Par défaut les zones de saisies dans dolibarr sont transparentes, ce qui n'aide pas à la lisibilité
Il est possible de changer la couleur de fond des zones de saisies


==== Couleur des boutons par défaut====
Il y a trois types de boutons dans Dolibarr:
* Les boutons associés à une action
* Les boutons désactivés
* Les boutons effectuant une suppression
myField permet de changer la couleur de ceux-ci


==== Remplacement des boutons natifs====
MyField permet le remplacement des boutons standards de Dolibarr par des icônes.
{| class="wikitable"
| [[file:myfield_Button-replace.png|300px]]
| au lieu de
| [[file:myfield_Button-standard.png|500px]]
|}


==== Information de support ====
Vous trouverez en bas de la page de configuration les informations techniques liées à votre installation. Ces informations techniques seront utiles et pourront vous être demandées si vous rencontrez un bug dans l'utilisation du module :
[[file:Myfield_Technical-information.png||800px]]


===Permissions===
Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module.


Cliquez sur le – pour ajouter un permission.


Une permission accordée est symbolisée par un coche verte ([[file:tick.png]]).


{{Note|Attention : il y a d'autres paramètres qui peuvent impacter l'accès aux champs, notamment quand on utilise un compte administrateur}}


====Permissions utilisateurs et groupes====
{| class="wikitable"
| [[file:myfield-Permissions-utilisateur.png|600px]]
| style="vertical-align:top;" |
Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions ci-contre
|}


====Permissions par défaut====
{| class="wikitable"
| [[file:myfield-Permissions-defaut.png|600px]]
| style="vertical-align:top;" |
Les permissions par défaut ('''Accueil > Utilisateurs et groupe > Choisir entre utilisateurs ou groupe > Sélectionner les autorisations'''), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}

== Démarrage == 


Les fonctionnalités de MyField sont accessibles depuis l'onglet de menu principal Patastools.
Votre menu secondaire présente alors les entrées de menu suivantes :


{| class="wikitable"
|- style="vertical-align:top;"
| style='border-style: none;' | '''MyField'''
| L'entrée principale affiche la liste de tous les myFields de votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' |
'''Nouveau mf Field''' 
'''Nouveau mf Tab''' 
'''Nouveau mf Onglet''' 
'''Nouveau mf de liste''' 
'''Nouveau mf Menu''' 
'''Nouveau mf Bouton'''


| Ces entrées afficheront la page de création d'un nouveau myField selon son type :
* champ de fiche
* onglet
* bouton
* champs de liste
* menu
|- style="vertical-align:top;"
| style='border-style: none;' | '''Liste des éléments'''
| Cette entrée affichera également la liste des myFields enregistrés sur votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' | '''Droits d'accès aux éléments'''
| Cette page vous permettra de paramétrer les habilitations des groupes d'utilisateurs aux fonctionnalités de MyFields, tabs et menus.
|- style="vertical-align:top;"
| style='border-style: none;' | '''Import XML'''
| Cette entré affichera une page permettant de copier un fichier d'import d'un myfield au format XML.
|}


== Personnalisations ==
=== Menus ===
==== Création du myField ====
La page de création d'un myField de type menu est accessible depuis le lien de menu secondaire '''Patas-tools > MyField > Nouveau myMenu.'''


[[File:Myfield-Page-creation-menu.png|800px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué pour afficher cette page de création (menu).
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché sur votre interface.
|-
| style="vertical-align:top;" |
Type de menu
| style="vertical-align:top;" |
sélectionnez dans la liste déroulante le type de menu que vous souhaitez personnaliser selon qu'il s'agit d'un menu principal, d'un menu secondaire ou d'une entrée de menu secondaire.
|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du champ.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


Suite à la création d'un myField, il sera nécessaire d'en définir les droits d'accès par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir plus loin)


====Exemple de personnalisation d'un menu principal====
Personnalisons le menu ''Accueil''.


[[file:myfield-Param-menu-accueil.png|600px]]


[[file:Myfield-menu-resultat.png|600px]]


====Exemple de personnalisation d'un menu et d'une entrée de menu secondaire====
Personnalisons le menu secondaire Propositions commerciales et l'entrée de menu secondaire Nouvelle proposition.


[[file:myfield-Param-menu-secondaire.png|600px]]


[[file:myfield-Param-entree-menu-secondaire.png|600px]]


{{Note|L'entrée de menu secondaire sera déplacée d'un rang vers le bas avec le code -1 dans le champ Déplacement de sa fiche}}
Suite à l'application de ces deux personnalisations, le menu secondaire devient :


{| class="wikitable"
| [[file:Myfield-entree-menu-secondaire.png]]
| style="vertical-align:top;" |
plutôt que
| [[file:Myfield-menu-secondaire.png]]
|}


====Cas particulier de entrées de menu secondaire "Liste"====
Pour différencier les entrées de menu secondaire du même nom, saisissez le menu de niveau supérieur auquel elles sont rattachées séparées par un dièse ('''#''') :


{| class="wikitable"
| style="vertical-align:top;" |
''Ajoutez au libellé le menu secondaire : Propositions commerciales#Liste''


[[file:myfield_Liste-param.png|600px]]


| style="vertical-align:top;" |
Pour obtenir


[[file:myfield_Liste-param-menu.png]]
|}


===Onglets===
====Création du myField d'onglet====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyTab'''.


[[file:myfield-Page-creation-onglet.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
Le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
{{Note|Attention, pour les onglets, le contexte correspond au tabTitleText (le nom du premier onglet) (ex: "Tiers" pour l'élément Tiers, "Produit" pour l'élément Produit) }}


Si aucun context n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField


|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).


|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


{{Note|N'indiquez ici que la partie de l'URL suivant ''/htdocs/''}}
Requête d'affichage : voir section Fonctionnement, ci-dessous


Suite à la création d'un myField, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).


====Exemple de personnalisation d'un onglet====
Personnalisons l'onglet fiche des fiches des éléments.


[[file:myfield-Param-onglet-fiche.png|800px]]


La fiche devient alors


[[file:myfield-Natif-fiche.png|800px]]
{{Note|Si l'onglet est actif, la couleur sera affichée sur ses bords}}


===Champs===
====Création du myField====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyField'''.


[[file:myfield-Page-creation.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du champ tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
Si aucun contexte n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


[[#Contexte d'activation|Liste des principaux contexte ]]


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|-
| style="vertical-align:top;" |
Masque de saisie
| style="vertical-align:top;" |
le masque de saisie est paramétrable avec les caractères suivants :
*a pour une lettre (A-Z,a-z)
*9 pour un chiffre (0-9)
*pour un caractère alphanumérique (A-Z,a-z,0-9)
:Vous pouvez ajouter dans le champ les caractères que vous souhaitez pour constituer votre masque. Par exemple, si vous souhaitez ajouter un indicatif international au champ téléphone, le masque sera : +0099-(9)999999999
*UPPERCASE pour forcer la saisie en majuscule.
*LOWERCASE pour forcer la saisie en minuscule.
|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché il faut cliquer sur le numéro de version de Dolibarr (en haut à droite).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez 1 pour remonter d'un champ, -1 pour descendre.
|-
| style="vertical-align:top;" |
Valeur par défaut
| style="vertical-align:top;" |
Correspond à une saisie par défaut dans le champ à la création.
Cette zone peut aussi être utilisé dans le cas d'un champs obligatoire que l'on souhaite cacher.
|-
| style="vertical-align:top;" |
Taille du champ de saisie
| style="vertical-align:top;" |
à définir selon vos besoins. Si laissé vide, la valeur native du champ est conservée.
|-
| style="vertical-align:top;" |
Obligatoire :
| style="vertical-align:top;" |
Cochez cette case pour rendre la saisie de valeurs dans le champ obligatoire pour enregistrer la création ou les modifications de la page.

Le libellé du texte associé aux champs sera mis en gras pour respecter la charte graphique de dolibarr sur les champs obligatoire.

Sur les champs de type texte, il y a un tooltip précisant qu'il est obligatoire qui n'est pas présent au niveau des listes déroulantes.

|-
| style="vertical-align:top;" |
Requête d'affichage
| style="vertical-align:top;" |
Voir section Fonctionnement
|}


|}


{{Note|Le déplacement d'un champ d'une fiche n'est effectué qu'au sein de son tableau. Il est donc possible de remonter ou descendre un champ, mais pas de le changer de colonne}}


Suite à la création d'un myField de type champ, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).

====Exemple de personnalisation d'un champ====
Personnalisons le champ ''Id. prof. 2 (SIRET)'' des fiches de tiers.


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield_Param-champ.png|600px]]
| Le champ a été paramétré en tant qu'invisible avec un masque de saisie de chiffres (999 999 999 99999)


|- style="vertical-align:top;"
| [[file:Myfield-champ.png|600px]]


[[file:myfield-Masque.png]]


|
En cliquant sur le lien Show/Hide au-dessus du tableau, le champ sera affiché selon les paramètres enregistrés sur la fiche du myField


Lors de l'édition du champ, le masque sera activé et ne permettra que la saisie prédéfinie et sa complétion vérifiée (rendu obligatoire) pour empêcher l'enregistrement de la page sans qu'il ne soit rempli.
|}


===Listes===
Il est possible de modifier les champs des listes natives de dolibarr (celle avec une icone de sélection de champs en bout de liste)


====Création du myField====
Les myfields de liste permettent de limiter l'affichage de champs.
il est nécessaire d'ouvrir la page de liste pour récupérer des informations propre à ce type de myField
* le contexte d'activation
* le libellé non traduit du champs


====Exemple de paramétrage====
Nous allons modifier la colonne "Tiers" sur la liste des interventions


[[file:Myfield-masque-tiers.png|600px]]


Selon les habilitations, le champs sera aussi inaccessible dans le sélecteur de champs.


[[file:myfield_Liste-contrats.png|600px]]


{{Note|Si vous rendez un myField de liste invisible, il sera invisible de tous les utilisateur. Pour le cacher seulement à un ou des groupes d'utilisateurs, laissez le visible et jouter ensuite avec les droits d'accès !}}


=== Boutons ===
Il est possible de modifier les boutons présent sur les fiches de dolibarr


====Création du myField====
Les myfield de boutons permettent de rendre invisible bouton, remplacer le libellé, l'url associé au bouton et de rendre son accès visible selon le résultat d'une requete SQL


[[file:myfield-creation-bouton.png|600px]]


{{Note|Avec le thème natif de Dolibarr, le libellé du bouton est mis en majuscule, il faut donc utiliser le texte d'origine que l'on récupère avec le click droit et le menu inspecter.}}


=Requête SQL d'affichage conditionnel=
La requête de traitement va conditionner l'affichage des champs selon la correspondance de l'objet à la requête. Il est alors possible, par exemple, d'afficher des champs différents selon que l'objet est un produits ou un service.
Il est possible de transmettre en paramètre deux valeurs :
* #ID# : l'id de l'objet principale de la page
* #USERID# : l'id de l'utilisateur actif

==Fonctionnement== 


Saisissez ici la requête d'affichage applicable au champs sur l'exemple suivant :


#SEL# permet de remplacer le SELECT de la requête SQL qui sera bloqué par la sécurité native de Dolibarr (SQL Injection)


''#SEL# IF(fk_product_type=1, 1, 0) AS `read`, IF(fk_product_type=1, 1, 0) AS `write` FROM llx_product WHERE rowid=#ID#; ''


read permet d'autoriser ou non l'affichage globale du champ
write permet d'autoriser ou non sa modification (pas nécessaire dans le cas d'un bouton un un onglet...)


Si la valeur est à 0, le champs est caché, dans le cas contraire il est affiché
Attention, si on laisse le paramètre du champs à caché, il n'apparaitra pas quel que soit la valeur


==Exemple==
Avec le myfield suivant


[[file:myfield_Creation_requete.png|800px]]


{| class="wikitable"
|- style="vertical-align:top;"
| On obtient la fiche suivante sur un '''produit'''
[[file:myfield_Creation_requete_result.png|400px]]
| Tandis que sur la fiche d'un '''service'''
[[file:myfield_Creation_requete-fiche.png|400px]]

|}


=Paramétrage des droits d'accès aux myFields, tabs et menus=
==Configuration des droits d'accès==
En tant qu'utilisateur administrateur, tous les myFields vous sont visibles.
{{Note|Sur la page d'accueil du module MyField, l'application des personnalisations est désactivée}}


Si vous n'avez pas défini de groupes utilisateurs, les myfields sont affichés sur les interfaces de tous les utilsiateurs.


Depuis l'entrée de menu secondaire '''Patas-Tools > MyField > droits d'accès aux onglets''', paramétrez les accès des groupes d'utilisateurs :


[[file:myfield-Droits-d-acces.png|600px]]


Il existe quatre droits d'accès :


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:lecture-off.png]] Bloqué en accès
[[file:lecture-on.png]] Accès en lecture
| [[file:modif-of.png]] Bloqué en modification
[[file:modif-on.png]] Accès en modification
|}


==Comportement selon les droits d'accès==
===Bloqué en accès ([[file:lecture-off.png]]) ===


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Le champ sera caché aux utilisateurs du groupe. Ils ne pourront pas l'afficher


le lien ''Show/Hide'' ne sera pas actif
|}
===Accès en lecture mais bloqué en modification ([[file:lecture-on.png]][[file:modif-of.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Les utilisateurs du groupe pourront afficher le champ, mais ne pourront pas en modifier le contenu.
|}
===Accès en lecture et Accès en modification ([[file:lecture-on.png]][[file:modif-on.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture+-modif+.png|600px]]
|
Les utilisateurs du groupe pourront afficher le champ et le modifier si leurs permissions de groupe ou d'utilisateur le leur permettent. Les paramètres du champ s'appliquent alors (obligatoire, masque de saisie,...)
|}


=Autres fonctionnalités=
==Import des myField==
Il est possible d'enregistrer une liste de myfields et leurs paramétrages en important un fichier XML.
Depuis la page '''Outils Patas-M > MyField > Importer un onglet''', collez le fichier XML dans la zone de saisie et cliquez sur le bouton '''Lancer l'importation'''.
{{Note|Si vous cochez la case Écraser les données précédentes, votre liste de myfields se résumera à ceux présent dans le ficher que vous importez|warn}}
Paramétrer ensuite les droits d'accès des utilisateurs au myField.


==Contexte d'activation==
Une liste de tous les contextes disponible est présent sur le wiki de dolibarr:
https://wiki.dolibarr.org/index.php?title=Syst%C3%A8me_de_Hooks#Liste_des_Contexts_disponibles_dans_Dolibarr


quelque uns des plus courants
{|
|
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Adhérent
| membertypecard
|-
| Catégories
| categorycard
|-
| Commandes
| ordercard
|-
| Commande fournisseur
| ordersuppliercard
|-
| Contact
| contactcard
|-
| Contrat
| contractcard
|-
| Don
| doncard
|-
| Entrepôt
| warehousecard
|-
| Expédition
| expeditioncard
|-
| Facture client
| invoicecard
|-
| Facture fournisseur
| suppliercard
|}


| style="vertical-align:top;" |
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Intervention
| interventioncard
|-
| Livraison
| deliverycard
|-
| Note de frais
| tripandexpensecard
|-
| Produit
| productcard
|-
| Projet
| projectcard
|-
| Proposition commerciale
| propalcard
|-
| Règlement client
| paiementcard
|-
| Règlement fournisseur
| paymentsupplier
|-
| Salaire
| salarycard
|-
| Tache
| projecttaskcard
|-
| Tiers
| thirdpartycard
|-
| Utilisateur
| usercard


|}


|}


=Questions fréquentes=
== Général ==
Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.
Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :
#Désactivez et réactivez le module,
#Vérifier sur le ChangeLog si une nouvelle version a été publiée,
#Ré-installez/mettez à jour le module,
#Vérifiez que le remplacement de fichiers natifs de Dolibarr ne soit pas nécessaire au bon fonctionnement du module.
#Vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations.


Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant le formulaire dédié (http://docs.patas-monkey.com/support/).
Ce formulaire est le mode de contact à privilégier pour toute difficulté d'utilisation ou remontée de bug. Aussi, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet.


== Affichage d'un message en haut des pages de Dolibarr==
Si vos pages de Dolibarr affichent un message semblable à l'image suivante, il ne s'agit pas d'un message d'erreur, mais de l'affichage des contextes de la page courante. Pour ne plus voir ces lignes affichées, désactivez l'affichage du contexte
(voir Configuration).


[[file:Myfield-Message-contexte.png]]


==Message erreur d'ordonnancement==
Certaines pages de certaines versions de Dolibarr présentent un erreur dans leur code empêchant la bonne application de la personnalisation des champs. MyField permet de les identifier pour les corriger.


Le message d'erreur s'affiche en bas de page et est le suivant


[[file:myfield_Erreur-dbclose-message.png]]


En vous aidant de l'URL de la page, ouvrez le fichier du noyau de Dolibarr pour le modifier. Par exemple, si la page qui comporte le message est ''http://.../htdocs/custom/myField/admin/extrafields.php'', ouvrez successivement les dossiers ''htdocs'', ''custom'', ''myField'', ''admin'' et ouvrez le fichier ''extrafields.php''.


L'erreur vient de l'inversion des lignes ''llxFooter();'' et ''$db->close();'' en fin de fichier.


{| class="wikitable" style="width:60%;"
|- style="vertical-align:top;"
| Modifiez le code de la page pour obtenir
[[file:Erreur-dbclose-correction.png]]
| au lieu de


[[file:Erreur-dbclose.png]]
|}
==Multicompany==
Avec le module multicompany, il convient d'activer le module sur chaque entité
</translate>

MyField

2026-02-03T10:43:08Z

Admiw : /* Création du myField */

<languages/>
<translate>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myfield-250x250.png]]
| Le module myField permet de personnaliser les libellés des menus, onglets, bouton, champs des fiches et listes de Dolibarr.
Vous pouvez choisir vous-même le libellé, la couleur et l'accès de vos menus, des boutons, des onglets et champs des fiches et listes
|}


== Présentation ==
Selon le type de myfield (champs d'une fiche, liste, onglet,...), plusieurs autres options peuvent être appliquées aux champs des fiches telles qu'une couleur de fond, les afficher/ cacher, ajouter un masque de saisie, saisie en majuscule ...


Le jeu combiné des permissions utilisateurs et des droits d'accès aux myFields permet de paramétrer les accès des utilisateurs à la vue des champs, leur contenu et leur modification.


MyField permet encore de cacher des menus à des groupes d'utilisateurs et d'en modifier l'URL de destination.


== Paramétrage ==
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou l'icône [[file:doli-setup-old.png]] en bout de ligne.


[[file:myfield_Configuration.png|800px]]

=== Page de configuration du module === 


==== Activation du contexte pour le développement====
MyField permet d'afficher sur certaines pages de Dolibarr les contextes utilisables pour limiter les actions de personnalisations des myFields.
Ces contextes seront utiles lors de la création de myFields pour limiter l'action du module aux seules pages possédant dans leur code le contexte indiqué sur la fiche du myField.
Paramétrer l'affichage des contexte sur vos pages vous permettra de les identifier pour paramétrer au mieux vos myfields.


{| class="wikitable"
| [[file:myfield-Message-contexte.png]]
| style="vertical-align:top;" |
L'activation de l'affichage des contextes se traduit par des messages comme ci-contre
|}


==== L'administrateurs est au dessus des règles d'accès ====
Vous pouvez aussi choisir de désactiver l'utilisation des droits d'accès pour l'utilisateur administrateur.


Si ce paramètre est activé, l'administrateur verra, hors de tout groupe, les myfields en fonctionnement.


==== Couleur de fond des zones de saisie====
Par défaut les zones de saisies dans dolibarr sont transparentes, ce qui n'aide pas à la lisibilité
Il est possible de changer la couleur de fond des zones de saisies


==== Couleur des boutons par défaut====
Il y a trois types de boutons dans Dolibarr:
* Les boutons associés à une action
* Les boutons désactivés
* Les boutons effectuant une suppression
myField permet de changer la couleur de ceux-ci


==== Remplacement des boutons natifs====
MyField permet le remplacement des boutons standards de Dolibarr par des icônes.
{| class="wikitable"
| [[file:myfield_Button-replace.png|300px]]
| au lieu de
| [[file:myfield_Button-standard.png|500px]]
|}


==== Information de support ====
Vous trouverez en bas de la page de configuration les informations techniques liées à votre installation. Ces informations techniques seront utiles et pourront vous être demandées si vous rencontrez un bug dans l'utilisation du module :
[[file:Myfield_Technical-information.png||800px]]


===Permissions===
Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module.


Cliquez sur le – pour ajouter un permission.


Une permission accordée est symbolisée par un coche verte ([[file:tick.png]]).


{{Note|Attention : il y a d'autres paramètres qui peuvent impacter l'accès aux champs, notamment quand on utilise un compte administrateur}}


====Permissions utilisateurs et groupes====
{| class="wikitable"
| [[file:myfield-Permissions-utilisateur.png|600px]]
| style="vertical-align:top;" |
Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions ci-contre
|}


====Permissions par défaut====
{| class="wikitable"
| [[file:myfield-Permissions-defaut.png|600px]]
| style="vertical-align:top;" |
Les permissions par défaut ('''Accueil > Utilisateurs et groupe > Choisir entre utilisateurs ou groupe > Sélectionner les autorisations'''), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}

== Démarrage == 


Les fonctionnalités de MyField sont accessibles depuis l'onglet de menu principal Patastools.
Votre menu secondaire présente alors les entrées de menu suivantes :


{| class="wikitable"
|- style="vertical-align:top;"
| style='border-style: none;' | '''MyField'''
| L'entrée principale affiche la liste de tous les myFields de votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' |
'''Nouveau mf Field''' 
'''Nouveau mf Tab''' 
'''Nouveau mf Onglet''' 
'''Nouveau mf de liste''' 
'''Nouveau mf Menu''' 
'''Nouveau mf Bouton'''


| Ces entrées afficheront la page de création d'un nouveau myField selon son type :
* champ de fiche
* onglet
* bouton
* champs de liste
* menu
|- style="vertical-align:top;"
| style='border-style: none;' | '''Liste des éléments'''
| Cette entrée affichera également la liste des myFields enregistrés sur votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' | '''Droits d'accès aux éléments'''
| Cette page vous permettra de paramétrer les habilitations des groupes d'utilisateurs aux fonctionnalités de MyFields, tabs et menus.
|- style="vertical-align:top;"
| style='border-style: none;' | '''Import XML'''
| Cette entré affichera une page permettant de copier un fichier d'import d'un myfield au format XML.
|}


== Personnalisations ==
=== Menus ===
==== Création du myField ====
La page de création d'un myField de type menu est accessible depuis le lien de menu secondaire '''Patas-tools > MyField > Nouveau myMenu.'''


[[File:Myfield-Page-creation-menu.png|800px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué pour afficher cette page de création (menu).
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché sur votre interface.
|-
| style="vertical-align:top;" |
Type de menu
| style="vertical-align:top;" |
sélectionnez dans la liste déroulante le type de menu que vous souhaitez personnaliser selon qu'il s'agit d'un menu principal, d'un menu secondaire ou d'une entrée de menu secondaire.
|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du champ.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


Suite à la création d'un myField, il sera nécessaire d'en définir les droits d'accès par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir plus loin)


====Exemple de personnalisation d'un menu principal====
Personnalisons le menu ''Accueil''.


[[file:myfield-Param-menu-accueil.png|600px]]


[[file:Myfield-menu-resultat.png|600px]]


====Exemple de personnalisation d'un menu et d'une entrée de menu secondaire====
Personnalisons le menu secondaire Propositions commerciales et l'entrée de menu secondaire Nouvelle proposition.


[[file:myfield-Param-menu-secondaire.png|600px]]


[[file:myfield-Param-entree-menu-secondaire.png|600px]]


{{Note|L'entrée de menu secondaire sera déplacée d'un rang vers le bas avec le code -1 dans le champ Déplacement de sa fiche}}
Suite à l'application de ces deux personnalisations, le menu secondaire devient :


{| class="wikitable"
| [[file:Myfield-entree-menu-secondaire.png]]
| style="vertical-align:top;" |
plutôt que
| [[file:Myfield-menu-secondaire.png]]
|}


====Cas particulier de entrées de menu secondaire "Liste"====
Pour différencier les entrées de menu secondaire du même nom, saisissez le menu de niveau supérieur auquel elles sont rattachées séparées par un dièse ('''#''') :


{| class="wikitable"
| style="vertical-align:top;" |
''Ajoutez au libellé le menu secondaire : Propositions commerciales#Liste''


[[file:myfield_Liste-param.png|600px]]


| style="vertical-align:top;" |
Pour obtenir


[[file:myfield_Liste-param-menu.png]]
|}


===Onglets===
====Création du myField d'onglet====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyTab'''.


[[file:myfield-Page-creation-onglet.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
Le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
{{Note|Attention, pour les onglets, le contexte correspond au tabTitleText (le nom du premier onglet) (ex: "Tiers" pour l'élément Tiers, "Produit" pour l'élément Produit) }}


Si aucun context n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField


|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).


|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}


|}


{{Note|N'indiquez ici que la partie de l'URL suivant ''/htdocs/''}}
Requête d'affichage : voir section Fonctionnement, ci-dessous


Suite à la création d'un myField, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).


====Exemple de personnalisation d'un onglet====
Personnalisons l'onglet fiche des fiches des éléments.


[[file:myfield-Param-onglet-fiche.png|800px]]


La fiche devient alors


[[file:myfield-Natif-fiche.png|800px]]
{{Note|Si l'onglet est actif, la couleur sera affichée sur ses bords}}


===Champs===
====Création du myField====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyField'''.


[[file:myfield-Page-creation.png|600px]]


{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du champ tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
Si aucun contexte n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.


[[#Contexte d'activation|Liste des principaux contexte ]]


|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField


|}


| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché il faut cliquer sur le numéro de version de Dolibarr (en haut à droite).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez 1 pour remonter d'un champ, -1 pour descendre.
|-
| style="vertical-align:top;" |
Valeur par défaut
| style="vertical-align:top;" |


|-
| style="vertical-align:top;" |
Taille du champ de saisie
| style="vertical-align:top;" |
à définir selon vos besoins. Si laissé vide, la valeur native du champ est conservée.
|-
| style="vertical-align:top;" |
Obligatoire :
| style="vertical-align:top;" |
Cochez cette case pour rendre la saisie de valeurs dans le champ obligatoire pour enregistrer la création ou les modifications de la page.

Le libellé du texte associé aux champs sera mis en gras pour respecter la charte graphique de dolibarr sur les champs obligatoire.

Sur les champs de type texte, il y a un tooltip précisant qu'il est obligatoire qui n'est pas présent au niveau des listes déroulantes.
|-
| style="vertical-align:top;" |
Masque de saisie
| style="vertical-align:top;" |
le masque de saisie est paramétrable avec les caractères suivants :
*a pour une lettre (A-Z,a-z)
*9 pour un chiffre (0-9)
*pour un caractère alphanumérique (A-Z,a-z,0-9)
:Vous pouvez ajouter dans le champ les caractères que vous souhaitez pour constituer votre masque. Par exemple, si vous souhaitez ajouter un indicatif international au champ téléphone, le masque sera : +0099-(9)999999999
*UPPERCASE pour forcer la saisie en majuscule.
*LOWERCASE pour forcer la saisie en minuscule.
|-
| style="vertical-align:top;" |
Requête d'affichage
| style="vertical-align:top;" |
Voir section Fonctionnement
|}


|}


{{Note|Le déplacement d'un champ d'une fiche n'est effectué qu'au sein de son tableau. Il est donc possible de remonter ou descendre un champ, mais pas de le changer de colonne}}


Suite à la création d'un myField de type champ, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).

====Exemple de personnalisation d'un champ====
Personnalisons le champ ''Id. prof. 2 (SIRET)'' des fiches de tiers.


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield_Param-champ.png|600px]]
| Le champ a été paramétré en tant qu'invisible avec un masque de saisie de chiffres (999 999 999 99999)


|- style="vertical-align:top;"
| [[file:Myfield-champ.png|600px]]


[[file:myfield-Masque.png]]


|
En cliquant sur le lien Show/Hide au-dessus du tableau, le champ sera affiché selon les paramètres enregistrés sur la fiche du myField


Lors de l'édition du champ, le masque sera activé et ne permettra que la saisie prédéfinie et sa complétion vérifiée (rendu obligatoire) pour empêcher l'enregistrement de la page sans qu'il ne soit rempli.
|}


===Listes===
Il est possible de modifier les champs des listes natives de dolibarr (celle avec une icone de sélection de champs en bout de liste)


====Création du myField====
Les myfields de liste permettent de limiter l'affichage de champs.
il est nécessaire d'ouvrir la page de liste pour récupérer des informations propre à ce type de myField
* le contexte d'activation
* le libellé non traduit du champs


====Exemple de paramétrage====
Nous allons modifier la colonne "Tiers" sur la liste des interventions


[[file:Myfield-masque-tiers.png|600px]]


Selon les habilitations, le champs sera aussi inaccessible dans le sélecteur de champs.


[[file:myfield_Liste-contrats.png|600px]]


{{Note|Si vous rendez un myField de liste invisible, il sera invisible de tous les utilisateur. Pour le cacher seulement à un ou des groupes d'utilisateurs, laissez le visible et jouter ensuite avec les droits d'accès !}}


=== Boutons ===
Il est possible de modifier les boutons présent sur les fiches de dolibarr


====Création du myField====
Les myfield de boutons permettent de rendre invisible bouton, remplacer le libellé, l'url associé au bouton et de rendre son accès visible selon le résultat d'une requete SQL


[[file:myfield-creation-bouton.png|600px]]


{{Note|Avec le thème natif de Dolibarr, le libellé du bouton est mis en majuscule, il faut donc utiliser le texte d'origine que l'on récupère avec le click droit et le menu inspecter.}}


=Requête SQL d'affichage conditionnel=
La requête de traitement va conditionner l'affichage des champs selon la correspondance de l'objet à la requête. Il est alors possible, par exemple, d'afficher des champs différents selon que l'objet est un produits ou un service.
Il est possible de transmettre en paramètre deux valeurs :
* #ID# : l'id de l'objet principale de la page
* #USERID# : l'id de l'utilisateur actif

==Fonctionnement== 


Saisissez ici la requête d'affichage applicable au champs sur l'exemple suivant :


#SEL# permet de remplacer le SELECT de la requête SQL qui sera bloqué par la sécurité native de Dolibarr (SQL Injection)


''#SEL# IF(fk_product_type=1, 1, 0) AS `read`, IF(fk_product_type=1, 1, 0) AS `write` FROM llx_product WHERE rowid=#ID#; ''


read permet d'autoriser ou non l'affichage globale du champ
write permet d'autoriser ou non sa modification (pas nécessaire dans le cas d'un bouton un un onglet...)


Si la valeur est à 0, le champs est caché, dans le cas contraire il est affiché
Attention, si on laisse le paramètre du champs à caché, il n'apparaitra pas quel que soit la valeur


==Exemple==
Avec le myfield suivant


[[file:myfield_Creation_requete.png|800px]]


{| class="wikitable"
|- style="vertical-align:top;"
| On obtient la fiche suivante sur un '''produit'''
[[file:myfield_Creation_requete_result.png|400px]]
| Tandis que sur la fiche d'un '''service'''
[[file:myfield_Creation_requete-fiche.png|400px]]

|}


=Paramétrage des droits d'accès aux myFields, tabs et menus=
==Configuration des droits d'accès==
En tant qu'utilisateur administrateur, tous les myFields vous sont visibles.
{{Note|Sur la page d'accueil du module MyField, l'application des personnalisations est désactivée}}


Si vous n'avez pas défini de groupes utilisateurs, les myfields sont affichés sur les interfaces de tous les utilsiateurs.


Depuis l'entrée de menu secondaire '''Patas-Tools > MyField > droits d'accès aux onglets''', paramétrez les accès des groupes d'utilisateurs :


[[file:myfield-Droits-d-acces.png|600px]]


Il existe quatre droits d'accès :


{| class="wikitable"
|- style="vertical-align:top;"
| [[File:lecture-off.png]] Bloqué en accès
[[file:lecture-on.png]] Accès en lecture
| [[file:modif-of.png]] Bloqué en modification
[[file:modif-on.png]] Accès en modification
|}


==Comportement selon les droits d'accès==
===Bloqué en accès ([[file:lecture-off.png]]) ===


{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Le champ sera caché aux utilisateurs du groupe. Ils ne pourront pas l'afficher


le lien ''Show/Hide'' ne sera pas actif
|}
===Accès en lecture mais bloqué en modification ([[file:lecture-on.png]][[file:modif-of.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Les utilisateurs du groupe pourront afficher le champ, mais ne pourront pas en modifier le contenu.
|}
===Accès en lecture et Accès en modification ([[file:lecture-on.png]][[file:modif-on.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture+-modif+.png|600px]]
|
Les utilisateurs du groupe pourront afficher le champ et le modifier si leurs permissions de groupe ou d'utilisateur le leur permettent. Les paramètres du champ s'appliquent alors (obligatoire, masque de saisie,...)
|}


=Autres fonctionnalités=
==Import des myField==
Il est possible d'enregistrer une liste de myfields et leurs paramétrages en important un fichier XML.
Depuis la page '''Outils Patas-M > MyField > Importer un onglet''', collez le fichier XML dans la zone de saisie et cliquez sur le bouton '''Lancer l'importation'''.
{{Note|Si vous cochez la case Écraser les données précédentes, votre liste de myfields se résumera à ceux présent dans le ficher que vous importez|warn}}
Paramétrer ensuite les droits d'accès des utilisateurs au myField.


==Contexte d'activation==
Une liste de tous les contextes disponible est présent sur le wiki de dolibarr:
https://wiki.dolibarr.org/index.php?title=Syst%C3%A8me_de_Hooks#Liste_des_Contexts_disponibles_dans_Dolibarr


quelque uns des plus courants
{|
|
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Adhérent
| membertypecard
|-
| Catégories
| categorycard
|-
| Commandes
| ordercard
|-
| Commande fournisseur
| ordersuppliercard
|-
| Contact
| contactcard
|-
| Contrat
| contractcard
|-
| Don
| doncard
|-
| Entrepôt
| warehousecard
|-
| Expédition
| expeditioncard
|-
| Facture client
| invoicecard
|-
| Facture fournisseur
| suppliercard
|}


| style="vertical-align:top;" |
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Intervention
| interventioncard
|-
| Livraison
| deliverycard
|-
| Note de frais
| tripandexpensecard
|-
| Produit
| productcard
|-
| Projet
| projectcard
|-
| Proposition commerciale
| propalcard
|-
| Règlement client
| paiementcard
|-
| Règlement fournisseur
| paymentsupplier
|-
| Salaire
| salarycard
|-
| Tache
| projecttaskcard
|-
| Tiers
| thirdpartycard
|-
| Utilisateur
| usercard


|}


|}


=Questions fréquentes=
== Général ==
Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.
Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :
#Désactivez et réactivez le module,
#Vérifier sur le ChangeLog si une nouvelle version a été publiée,
#Ré-installez/mettez à jour le module,
#Vérifiez que le remplacement de fichiers natifs de Dolibarr ne soit pas nécessaire au bon fonctionnement du module.
#Vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations.


Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant le formulaire dédié (http://docs.patas-monkey.com/support/).
Ce formulaire est le mode de contact à privilégier pour toute difficulté d'utilisation ou remontée de bug. Aussi, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet.


== Affichage d'un message en haut des pages de Dolibarr==
Si vos pages de Dolibarr affichent un message semblable à l'image suivante, il ne s'agit pas d'un message d'erreur, mais de l'affichage des contextes de la page courante. Pour ne plus voir ces lignes affichées, désactivez l'affichage du contexte
(voir Configuration).


[[file:Myfield-Message-contexte.png]]


==Message erreur d'ordonnancement==
Certaines pages de certaines versions de Dolibarr présentent un erreur dans leur code empêchant la bonne application de la personnalisation des champs. MyField permet de les identifier pour les corriger.


Le message d'erreur s'affiche en bas de page et est le suivant


[[file:myfield_Erreur-dbclose-message.png]]


En vous aidant de l'URL de la page, ouvrez le fichier du noyau de Dolibarr pour le modifier. Par exemple, si la page qui comporte le message est ''http://.../htdocs/custom/myField/admin/extrafields.php'', ouvrez successivement les dossiers ''htdocs'', ''custom'', ''myField'', ''admin'' et ouvrez le fichier ''extrafields.php''.


L'erreur vient de l'inversion des lignes ''llxFooter();'' et ''$db->close();'' en fin de fichier.


{| class="wikitable" style="width:60%;"
|- style="vertical-align:top;"
| Modifiez le code de la page pour obtenir
[[file:Erreur-dbclose-correction.png]]
| au lieu de


[[file:Erreur-dbclose.png]]
|}
==Multicompany==
Avec le module multicompany, il convient d'activer le module sur chaque entité
</translate>