> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-process/administration/parametrage-front-office.md).

# Paramétrage du Front Office

## Préambule

Le but de ce document est de détailler la configuration du Front Office Efalia Process. Elle peut être séparée en deux parties, une avec l'utilisation d'un fichier de paramètres JSON à définir dans l'interface de l'application et une autre, avec [des paramètres back office](#parametres-back-office), à définir dans le fichier de configuration du serveur *catalina.properties* ou dans l'administration intégrée.

La première partie, plus cossue, permet de définir la structure / l'agencement / la représentation de l'application.

Elle se décompose en deux parties :

* Une partie générique qui est le panorama d'Efalia Process transverse à tous les processus
* Une autre partie qui représente les processus métier sous formes d'applications verticales.

Les deux parties peuvent être utilisées simultanément. La partie Panorama n'est rien d'autre qu'une application verticale prédéfinie.

L'application se décompose donc en applications qui elles-mêmes se décomposent en pages qui contiennent des onglets.

Décomposition de l'écran

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-4606507e0004a28c7b4bd9a3f9ba2b20aeb875f5%2Fprocess-front-office-image5.webp?alt=media" alt=""><figcaption></figcaption></figure>

## Emplacement du fichier de configuration

Le fichier se nomme settings.json et se situe sur le serveur là où est installé Efalia Process, c'est-à-dire dans le répertoire des données d'Efalia Process. Le répertoire est le suivant ***$WORKEY\_DATA/settings***, *$WORKEY\_DATA* étant la plupart du temps Workey\_Data.

## Edition du fichier

Un fichier JSON est tout simplement un fichier texte. Il est accessible en ligne au sein de l'application. Pour y accéder vous devez être connecté en tant qu'administrateur (Workflow Manager) et vous rendre dans l'espace d'administration, rubrique Panorama et Verticaux.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-2180155554f276d5b4cd1ce478befd64f09ecdb2%2Fprocess-front-office-image6.webp?alt=media" alt=""><figcaption></figcaption></figure>

Pour l'éditer localement, vous pouvez aussi utiliser votre éditeur de texte préféré hormis les traitements de texte (Word, Libre Office etc). Il est doit être encodé au format UTF-8.

Il est recommandé d'utiliser l'édition en ligne qui offre un correcteur syntaxique, un correcteur grammatical, un backup à chaque modification et le retour à une configuration antérieure.

## Prise en compte des modifications

Il vous suffit de remplacer l'ancien fichier settings.json par le nouveau. Il est fortement recommandé de garder l'ancien au cas où... L'édition en ligne exécute et gère ces recommandations.

## Structure du fichier

Le contenu du fichier contient du JSON, un language descriptif (cf. [Syntaxe du JSON](https://documentation.efalia.com/produit/efalia-process/developpeurs/syntaxes-json-jsonpath.md)). Définissant les paramètres d'Efalia Process, il est composé d'un objet JSON qui contiendra toutes les données de configuration, par exemple :

```json
{
    "verticalApps": [
        {
            "id": "CONTRACT",
            "route": "contract",
            "label": "Contrats Fournisseurs",
            "spriteCssClass": "wky-g-contract",
            "availableDocuments": [],
            "descendingDocuments": [],
            "pages": []
        },
        {
            "id": "TICKETS",
            "route": "ticket",
            "label": {
                "fr": "Gestion des tickets",
                "en": "Ticket Management"
            },
            "spriteCssClass": "wky-g-ticket",
            "availableDocuments": [],
            "descendingDocuments": [],
            "pages": [],
            "tables": []
        }
    ],
    "uiOptions": {
        "toDoCounterIcon": false,
        "readingPaneOfDocuments": true,
        "delegationAndSubstitution": false
    },
    "extraPermissions": {
        "listsManagement": [
            "jrobert",
            "dmorgane"
        ]
    },
    "panoramaApp": {}
}
```

Cet objet contient trois propriétés, une pour les applications verticales, une pour l'application générique Panorama et une autre pour les extra-permissions.

***verticalApps*** : elle permet de spécifier les applications verticales accessibles sous forme d'un tableau JSON (Cf [Définition des applications verticales](#def-des-apps-verticales))

***panoramaApp*** : cette propriété permet de spécifier la configuration propre à l'espace par défaut Panorama. Il se compose d'un objet JSON (Cf [Définition du Panorama](#def-pano-workey))

***extraPermissions*** : cette propriété permet de spécifier des permissions exceptionnelles à des groupes d'individus (Cf [Définition des permissions exceptionnelles](#def-perm-excep))

***uiOptions*** : cette propriété permet de paramètrer l'interface utilisateur (cf [Définition des paramètres de l'interface utilisateur](#definition-de-l-interface-utilisateur))

## Définition des applications verticales

Ce tableau contient deux objets correspondant à deux applications, une qui gère les contrats et l'autre les tickets. Pour spécifier vos applications, consulter la [Définition d'une application](#definition-dune-application).

Résultat à l'écran :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-90d73c2b96d86f5a209a9d2b3243c24f1819e9d6%2Fprocess-front-office-image7.webp?alt=media" alt=""><figcaption></figcaption></figure>

### Définition d'une application

Une application est un objet JSON qui contient diverses propriétés :

***id*** : sert à identifier l'application, il doit être unique au sein du fichier.

***route*** : sert à définir le morceau d'url qui permettra d'y accéder. Par exemple si vous lui donnez comme valeur 'contract', l'url `http://localhost/workey/store/#/contract` rend l'accès possible à l'application Contrats. Elle est par conséquent unique au sein de l'application.

***label*** : présente le nom de l'application dans Efalia Process.

Cette propriété peut être sous forme d'une chaîne de caractères.

Exemple :

```json
"label":"Gestion des contrats"
```

Si votre application est multi-langue, vous pouvez spécifier un objet JSON à la place de la chaîne de caractères cela permettra de définir les différentes langues. Par exemple pour le français et l'anglais:

```json
"label" :{
    "fr":"Gestion des contrats",
    "en":"Contracts management"
}
```

Aujourd'hui Efalia Process ne supporte que le français (fr), l'anglais (en) et l'allemand (de).

***spriteCssClass*** : détermine l'icône à utiliser pour représenter l'application dans le menu de navigation en haut à gauche du front. Il existe une liste d'icônes prêtes à l'emploi (cf [Icônes de l'application](#icones-de-lapplication)).

***todoToUse*** : permet de spécifier une vue *A faire* à afficher à la place de celle par défaut. Sa valeur est le nom interne de la vue désirée, elle est affichée lors du click sur le titre de l'application dans la barre de gauche.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-f4321ed60f01a82ae124070f678e225fd6e3ccac%2Fprocess-front-office-image8.webp?alt=media" alt=""><figcaption></figcaption></figure>

***enable*** : sert à activer ou désactiver l'application. Cette propriété peut prendre *true* ou *false* comme valeur. La valeur *true* pour activer et *false* pour la cacher.

***availableDocuments*** : spécifie les documents qui peuvent être créés dans l'application. Sa valeur est un tableau contenant des objets qui représentent les documents candidats à la création. Si l'utilisateur connecté peut créer au moins un document, l'icône de création apparait en regard du titre de l'application dans la barre de gauche pour qu'il puisse créer un nouveau document. Chaque objet a une propriété ***names*** qui contient la concaténation des ids du document (*Process\_Type\_Name/Document\_Type\_Name/Role\_Name*). La valeur de *names* est composée des id suivants :

* ***Process\_Type\_Name*** est le nom interne du processus dans le modélisateur
* ***Document\_Type\_Name*** est le nom interne du document dans le modélisateur
* ***Role\_Name*** est le nom interne du rôle qui crée le document dans le processus au sein du modélisateur.

Par exemple :

```json
"availableDocuments": [
    {
        "names": "Gestion_des_contrats/Contrat/Gestionnaire_de_contrat"
    },
    {
        "names": "Gestion_des_contrats/Avenant/Controleur"
    }
]
```

Cette propriété permet d'exposer les documents à la création en adéquation avec l'application en cours.

***descendingDocuments*** : cet attribut spécifie les documents fils qui peuvent être créés dans l'application. Ils sont issus des dérivations et leur représentation est identique à celle de l'attribut \*availableDocuments (voir ci dessus). On notera que *Role\_Name* n'est pas spécifié.

Exemple :

```json
"descendingDocuments": [
    {
        "names": "Gestion_des_contrats/Facture"
    },
    {
        "names": "Gestion_des_contrats/Engagement"
    }
]
```

***pages*** : cette propriété va vous permettre d'agencer/de décomposer l'application en pages. Chaque page spécifiée se retrouve dans la barre de gauche d'Efalia Process. Cette propriété est donc un tableau de page. L'ordre d'apparition dans le fichier est répercuté à l'écran.

Exemple :

```json
"pages": [
    {
        // definition de la page ici
    },
    {
        // definition de la page ici        
    },
    {
        // definition de la page ici
    }
]
```

***tables*** : Cette propriété permet de définir les domaines de valeur qui vont être gérés dans Efalia Process. Les domaines sont regroupés par application, c'est pour cela qu'ils sont définis en sein de chaque application. Chaque domaine est spécifié dans un objet JSON contenu lui-même dans un tableau JSON.

Exemple :

```json
"tables": [
    {
        // définition de la table ici
    },
    {
        // définition de la table ici
    }
]
```

Le détail du contenu se trouve à la [Gestion des domaines de valeurs](#gestion-des-domaines-de-valeurs).

***tablesManagers*** : cette propriété permet de lister les utilisateurs qui peuvent modifier les listes de domaines de valeurs dans l'application sans qu'ils soient administrateurs. C'est un tableau contenant les DNs des utilisateurs.

Exemple :

```json
"tablesManagers": [
    "jdupont",
    "eleblanc",
    "pmartin"
],
```

Les DNs des utilisateurs sont présents dans la liste des utilisateurs, qui elle-même est présente dans la gestion des utilisateurs issue de l'administration.

**Attention : Pour un utilisateur connecté, une application est visible si et seulement ce dernier peut créer au moins un document ou accéder au moins à une vue.**

### Définition d'une page

Sur le même principe que l'application la page est un objet constitué de propriétés.

***Id*** : sert à identifier la page, il doit être unique au sein d'une application.

***label*** : présente le nom de la page dans l'application, on le retrouve comme entrée dans la barre de gauche d'Efalia Process. Pour le spécifier, il faut faire la même chose que pour le label de l'application (cf [label d'une application](#definition-dune-application)).

***spriteCssClass*** : l'attribut spriteCssClass détermine l'icône de l'entrée dans la colonne de gauche. Pour le spécifier (cf [Icône de l'application](#icones-de-lapplication)).

***tabs*** : cette propriété regroupe les onglets qui seront affichés en haut dans la page. C'est un tableau de tab. L'ordre d'apparition dans le fichier est répercuté à l'écran.

Exemple d'une page

```json
"pages": [
    {
        "id": "PAGE01",
        "label": {
            "fr": "Contrats",
            "en": "Contracts"
        },
        "spriteCssClass": "wky-g-view2",
        "tabs": [
            // vos onglets ici
        ]
    },
    {
        "id": "PAGE02",
        // Définition de la page PAGE02 ici
    }
]
```

### Définition d'un onglet

Pour un onglet, vous allez afficher une vue ou un graphe (view, pie chart ou line chart).

#### Définition d'un onglet de type vue

Comme son nom l'indique un onglet de type vue affiche une vue Efalia Process créée avec le modéliser Designer.

Exemple du vue :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-8e54c46e4656ae8b53ce140d07040a6b900099a9%2Fprocess-front-office-image10.webp?alt=media" alt=""><figcaption></figcaption></figure>

Pour un onglet de type vue comme pour l'application ou la page, vous allez spécifier un objet avec des propriétés.

***type*** : il doit être valorisé à 'VIEW', attention vous devez respecter la casse.

***label*** : présente le nom de l'onglet dans la page, on le retrouve comme entrée dans la barre d'onglets en haut de la page. Pour le spécifier, il faut faire la même chose que pour le label de l'application (cf [label d'une application](#définition-dune-application)).

***name***: est le nom interne de la vue à afficher.

***agreggates*** : permet de grouper les données d'une colonne pour effectuer une action dessus. Vous pouvez déterminer seulement un aggregate par colonne. Sa valeur est un tableau d'aggregate. Un aggregate se décompose en 4 propriétés :

* ***field*** : spécifie la colonne sur laquelle les données sont groupées
* ***aggregate***: cet attribut réalise l'action souhaité et peut prendre comme valeur sum, count ou average (somme, comptage ou moyenne).
* ***format*** : cette propriété formate le résultat de l'action cf [Définition d'un format](#definition-dun-format)
* ***label***: labellise le résultat de l'aggregate.

Vous obtenez la définition d'un aggregate suivant :

```json
"aggregates": [
    {
        "field": "Montant_echeance",
        "aggregate": "sum",
        "format": "{0:c}",
        "label": {
            "fr": "Total: ",
            "en": "Total: "
        }
    }
]
```

L'aggregate ci-dessus affichera le total des échéances en bas de la colonne 'Montant\_echeance' de la vue.

***customActions*** : cet attribut permet de rajouter des actions personnalisées sur les lignes des vues. Sa valeur est un objet JSON contenant différents attributs :

* ***title*** : texte affiché en tooltip sur l'icône en passant la souris dessus.***spriteCssClass***: permet de spécifier une icône qui représente l'action à effectuer.
* ***action***: cette propriété a comme valeur le nom d'une fonction prédéfinie [cf Liste des actions prédéfinies](#liste-des-actions-predefinies).
* ***params*** : est un objet JSON qui spécifie les paramètres passés à la fonction (*action*). Ils sont issus de la ligne affichée dans la vue (le paramètre passé correspond au nom interne d'une colonne). Chaque clé/valeur correspond au nom du paramètre attendu (clé) et la valeur de la colonne (valeur).

Finalement le JSON correspondant aux customActions est le suivant

```json
[
    {
        "title": "Visualiser le document dans un popup",
        "spriteCssClass": "wky-g-eye",
        "action": "open-attachment-in-popup",
        "params": {
            "uuid": "piece_jointe",
            "title": {
                "fr": "Titre de la fenêtre",
                "en": "Window title: "
            }
        }
    },
    {
        "title": "Visualiser le document dans un nouvel onglet",
        "spriteCssClass": "wky-g-folder",
        "action": "open-attachment-in-window",
        "params": {
            "uuid": "annexe"
        }
    }
]
```

Exemple d'implémentation de l'aggregate et de customs actions :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-0d3d919618173257b4c19ed7acfca2b4020c49c0%2Fprocess-front-office-image11.webp?alt=media" alt=""><figcaption></figcaption></figure>

***colors*** : cet attribut permet de spécifier la couleur des lignes en fonction de la valeur d'un des champs qui constituent les colonnes. Sa valeur est un objet JSON contenant différents attributs :

* ***field*** : permet de spécifier le nom interne de la colonne qui sera utilisée pour les conditions de colorisation.
* ***conditions*** : permet de spécifier les différentes conditions de colorisation. Sa valeur est un tableau JSON contenant les conditions sous forme d'objet JSON. Caque objet JSOn se compose de différents attributs.
* ***operator*** : permet de spécifier l'opérateur a utiliser dans la condition. Les opérateurs diffèrent en fonction du type de la colonne.

```
  Si la colonne est de type **nombre** les opérateurs peuvent prendre comme valeur :
```

```
  -   ***EQ*** : Egal
  -   ***LT*** : Moins grand que
  -   ***LTE*** : Moins grand ou égal à
  -   ***GT*** : Plus grand que
  -   ***GTE*** : Plus grand ou égal
  

  
  Si la colonne est de type **chaine de caractères** les opérateurs peuvent prendre comme valeur :
  
  -   ***EQ*** : Egal
  -   ***STARTSWITH*** : Commence par
  -   ***ENDSWITH*** : Finit par
  -   ***CONTAINS*** : Contient
  -   ***REGEXP*** : vérifie une expression régulière
  
  
  Si la colonne est de type **date** les opérateurs peuvent prendre comme valeur :
  
  -   ***EQ*** : Egal
  -   ***LT*** : Est avant
  -   ***LTE*** : Est avant ou égal à
  -   ***GT*** : Est après
  -   ***GTE*** : Est après ou égal
  
```

* ***valueOrColName*** : permet de spécifier la valeur qui sera testée avec l'opérateur ou le nom interne d'une des colonnes de la vue qui contiendra la valeur. La valeur sera différente en fonctions du type de la colonne.

  Si la colonne est de type **nombre**, elle prendra donc un nombre comme valeur.

  Si la colonne est de type **chaine de caractères**, elle prendra donc une chaine de caractère entre guillemets. Par contre si l'opérateur est REGEXP, elle prendra comme valeur une expression régulière entre guillemets (par ex **"^Jean"**) (cf [Syntaxe des expressions régulières](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/RegExp#syntaxe)).

  Si la colonne est de type **date**, elle prendra donc une chaine de caractère représentant une date sous la forme "AAAA-MM-JJ" (par ex **"2021-06-15"**).
* ***colorOrCssClassName*** : permet de spécifier le code couleur hexa ou le nom d'une classe CSS à utilisé si la condition est vérifiée (par ex **"#CC0000"** ou **"wky-ma-couleur-de-ligne"**).

Exemple de déclaration

```json
"colors": {
    "field": "Montant",
    "conditions": [
        {
            "operator": "LTE",
            "valueOrColName": -50,
            "colorOrCssClassName": "#f7ab2d"
        },
        {
            "operator": "LTE",
            "valueOrColName": -100,
            "colorOrCssClassName": "#CCC000"
        },
        {
            "operator": "LTE",
            "valueOrColName": -200,
            "colorOrCssClassName": "wky-zz-line-color-danger"
        },
        {
            "operator": "GT",
            "valueOrColName": 200,
            "colorOrCssClassName": "#0ec115"
        }
    ]
}
```

L'ordre d'évaluation des conditions est le même que celui dans le fichier des paramètres. La couleur retenue sera celle correspondant à la dernière condition vérifiée. C'est pour cela que l'on pourra définir différentes couleurs pour un champ de colonne.

Exemple d'implémentation de colors reflétant l'exemple JSON ci-desus :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-03150916dc9c233a4ca4549fcf6c30fb816ce2cb%2Fprocess-front-office-view.line.colors.webp?alt=media" alt=""><figcaption></figcaption></figure>

#### Définition d'un onglet de type diagramme circulaire

Pour un onglet de type graphe, c'est presque la même chose que pour les vues ci-dessus. Vous allez afficher une vue mais changer sa représentation graphique.

Représentation en diagramme circulaire :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-a22b76a09722881958190f9247ecb2b39db092f2%2Fprocess-front-office-image12.webp?alt=media" alt=""><figcaption></figcaption></figure>

Pour déclarer ce graphe vous allez devoir spécifier ses attributs.

***type*** : il doit être valorisé à 'PIE\_CHART', attention vous devez respecter la casse.

***label*** : cf [Définition d'un onglet View](#definition-dun-onglet-de-type-vue)

***name*** : cf [Définition d'un onglet View](#definition-dun-onglet-de-type-vue)

***groupBy*** : cette propriété permet de former des groupes de données selon sa valeur. C'est un tableau de colonnes issues de la vue spécifiée par l'attribut name ci-dessus. Vous devez donc spécifier un tableau de noms internes déterminés dans le modélisateur. Cette attribut fonction comme le GROUP BY des requêtes SQL.

Exempe :

```json
"groupBy": [
    "Categorie"
]
```

L'attribut ***groupBy*** doit être combiné avec la propriété *aggregate* qui va réaliser l'action souhaitée.

* ***aggregate*** : cette propriété réalise l'action souhaitée sur les groupes de données (*\[groupBy]*). Elle est représentée par un object JSON qui est composé de différents membres :
  * ***action*** : cet attribut réalise l'action souhaité et peut prendre comme valeur sum, count ou average (somme, comptage ou moyenne).
  * ***format*** : cette propriété formate le résultat de l'action cf [Définition d'un format](#definition-dun-format)
  * ***field*** : ce membre spécifie le nom de la colonne sur laquelle l'action se déroule

Exemple :

```json
"aggregate": {
    "action": "sum",
    "format": "{0:c}",
    "field": "Total_annuel"
}
```

***labelTemplate*** : cette propriété format le libellé affiché en regard du quartier.

Exemple :

```json
"labelTemplate" : "#= category #n#=dataItem.formattedValue# /an"
```

Finalement, pour la définition d'un Pie Chart , vous obtenez le JSON suivant :

```json
{
    "type": "PIE_CHART",
    "name": "Repartition_Montants_annuels_par_categorie",
    "label": "Contrats par catégorie",
    "groupBy": [
        "Categorie"
    ],
    "aggregate": {
        "action": "sum",
        "format": "{0:c}",
        "field": "Total_annuel"
    },
    "labelTemplate":"#= category #n#=dataItem.formattedValue# / an"
}
```

#### Définition d'un onglet de type graphique en ligne

*Le graphique en ligne permet de représenter une vue en l'agençant différemment.*

*Exemple de graphe :*

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-68cd38a26c35e655daea77dec28653b83f02b8fd%2Fprocess-front-office-image13.webp?alt=media" alt=""><figcaption></figcaption></figure>

*Comme pour le graphe PIE CHART, vous allez devoir déclarer différents attributs :*

***id*** : cf [Définition d'un onglet View](#definition-dun-onglet-de-type-vue)

***type*** : il doit être valorisé à 'LINE\_CHART', attention vous devez respecter la casse.

***label*** : cf [Définition d'un onglet View](#definition-dun-onglet-de-type-vue)

***name*** : cf [Définition d'un onglet View](#definition-dun-onglet-de-type-vue)

***lines*** : cette propriété va vous permettre de déclarer les lignes souhaitées dans le graphe. Chaque ligne est composée de points qui vont concerner 0 ou n lignes de la vue, c'est sur ce groupement que vous allez effectuer une action. Cette propriété est représentée sous forme d'un tableau de lignes, qui elles-mêmes sont déclarées sous forme d'objet JSON composés de propriétés :

* ***field*** : spécifie le champ d'une colonne utilisé pour le regroupement
* ***label*** : détermine un libellé affiché sur les points de la ligne lorsque la souris passe dessus.

Exemple :

```json
"lines": [
    {
        "field": "Date_de_creation",
        "label": "Tickets créés"
    },
    {
        "field": "Date_de_cloture",
        "label": "Tickets clôturés"
    }
]
```

***aggregate*** : Cette propriété va effectuer une action sur les groupes déterminés par l'attribut *lignes* ci-dessus. L'action est un objet JSON composé de propriétés :

* ***action*** : cet attribut réalise l'action souhaité et peut prendre comme valeur sum, count ou average (somme, comptage ou moyenne).
* ***field*** : contient le nom du champ des lignes sur lesquelles l'action est réalisée.

### Définition du Panorama

Cette espace est prédéfini par défaut dans le front, il ne nécessite pas de configuration par défaut, par contre Il est customisable et peut être enrichi avec de nouvelles pages. Il se compose d'un object JSON, en regard de la propriété ***panoramaApp***, contenant différentes propriétés :

* ***label*** : cette propriété définit le libellé du Panorama. Par défaut sa valeur est donc *Panorama*, pour la modifier, consultez la propriété label d'une application (Cf [Définition d'une application](#definition-dune-application)).
* ***spriteCssClass***\* : Cette propriété modifie l'icône utilisée pour le panorama ([Définition d'une application](#definition-dune-application)).
* ***pages*** : Cette propriété permet d'ajouter des pages au panorama qui s'ajoutent en dessous de la page Panorama. Elle se compose d'un tableau JSON qui contient les différentes pages (Cf [Définition d'une page](#definition-dune-page)).
* ***tables*** : Cette propriété permet de définir les domaines de valeur qui vont être gérés dans le panorama. Chaque domaine est spécifié dans un objet JSON contenu lui-même dans un tableau JSON.

Le détail du contenu se trouve à la [Gestion des domaines de valeurs](#gestion-des-domaines-de-valeurs).

### Définition des permissions exceptionnelles

Il se compose d'un objet JSON, en regard de la propriété *extraPermissions,* contenant différentes propriétés définissants des permissions. Chaque permission définit un tableau JSON contenant les DNs des utilisateurs concernés.

#### Liste des permissions

***listsManagment*** : Cette propriété contient les utilisateurs non administrateur qui peuvent gérer les domaines de valeurs dans l'application Efalia Process.

### Définition des paramètres de l'interface utilisateur

Il se compose d'un objet JSON, en regard de la propriété *uiOptions*, contenant différentes propriétés définissants des réglages de l'UI.

#### Liste des paramètres

***toDoCounterIcon*** : Cette propriété permet de masquer ou d'afficher l'icône avec le compteur des différents documents à traiter. Elle prend comme valeur un booléen (true ou false).

***readingPaneOfDocuments*** : Cette propriété permet de forcer l'activation ou la désactivation du volée de visualisation des documents dans les vues pour tous les utilisateurs. Elle prend comme valeur un booléen (true ou false).

***delegationAndSubstitution*** : Cette propriété permet de masquer ou d'afficher les fonctionnalités concernant les délégations et les suppléances (hors administration).

## Gestion des domaines de valeurs

Les domaines de valeurs peuvent être gérés au sein de l'administration d'Efalia Process, dans la rubrique Listes. Chaque Liste / Domaine de valeur est le reflet d'une table en base de données sur laquelle vous allez pouvoir ajouter ou supprimer des valeurs.

Il faut bien-sûr créer au préalable la table dans la data source adéquate.

Les domaines de valeurs sont représentés sous forme de tableaux JSON contenus dans la propriété *tables* d'une application (cf [Définition d'une application](#definition-dune-application)).

L'objet JSON de déclaration est formé de plusieurs propriétés :

***name*** : Nom de la table dans la data source

***label***: Libellé localisé de la table plus descriptif que le nom de la table

***fields*** : Liste des champs liés à la gestion, sa valeur est un tableau JSON contenant n champs, chaque champ est objet JSON composé d'attributs :

* ***name*** : Nom de la colonne dans la table
* \***label** \*: Libellé localisé de la colonne plus descriptif que le nom de la colonne
* ***type*** : Type de donnée de la colonne. Pour le moment cette propriété peut prendre comme valeur : *string*, *integer* ou *float*.

Exemple :

```json
"tables": [
    {
        "name": "contrat",
        "label": {
            "fr": "Liste des catégories",
            "en": "List of categories"
        },
        "fields": [
            {
                "name": "Categorie",
                "type": "string"
            },
            {
                "name": "Nature",
                "type": "string"
            }
        ]
    },
    {
        "name": "liste_societe",
        "label": "Sociétés",
        "fields": [
            {
                "name": "societe",
                "type": "string"
            }
        ]
    }
]
```

## Liste des actions prédéfinies

Les "custom actions" sont des actions effectuées sur les documents présents dans une vue. Elles sont déclarées dans la définition d'une vue ([cf l'attribut customActions](#custom-action-detail)). Vous trouvez ci-dessous la liste des actions prédéfinies.

### open-attachment-in-window

Cette action affiche une pièce jointe dans une nouvelle fenêtre ou onglet du navigateur. Il faut lui passer en paramètre la valeur suivante (via la propriété *params*) :

* ***uuid*** : c'est l'identifiant d'une pièce jointe

### open-attachment-in-popup

Cette action affiche une pièce jointe dans une boîte de dialogue modale (l'utilisateur doit la fermer avant de pouvoir continuer dans Efalia Process). Il faut lui passer en paramètre les paramètres suivants (via la propriété *params*) :

* ***uuid*** : c'est l'identifiant d'une pièce jointe
* ***title*** : titre localisé du popup

### mg-open-viewer

Cette action ouvre un popup de visualisation d'un document Multigest. Vous devez lui passer le paramètre suivant nécessaires au bon fonctionnement (via la propriété *params*) :

* ***uuid*** : l'id du dossier MG

### mg-open-dossier

Cette action ouvre un popup de visualisation d'un dossier Multigest. Vous devez lui passer le paramètre suivant nécessaires au bon fonctionnement (via la propriété *params*) :

* ***uuid*** : id du dossier MG

## Icônes de l'application

Efalia Process embarque une font d'icônes, elle est constituée de différents glyphes prédéfinis. Pour visualiser son contenu il faut accéder au système de fichiers du serveur Efalia Process. Sa localisation est la suivante :

***Workey\_Engine/webapps/workey/css/fonts/workey-glyphicons.html***

Pour utiliser une icône, il faut utiliser son nom qui est sous la forme wky-g-xxx.

Ainsi pour :

***wky-g-pencil*** vous obtenez l'icône

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-39b06c8e142ab89d5bf1497c0f7ba042c8443e9f%2Fprocess-front-office-image14.png?alt=media" alt=""><figcaption></figcaption></figure>

***wky-g-mail*** vous obtenez l'icône

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-f59fe5bc11713ec4a94b1931e0acf767f6103760%2Fprocess-front-office-image15.png?alt=media" alt=""><figcaption></figcaption></figure>

Aperçu de la font d'icônes dans un navigateur:

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-3288c4c5be2b34cca0bfffd16bdc0fd4ed35ea90%2Fprocess-front-office-image16.webp?alt=media" alt=""><figcaption></figcaption></figure>

## Définition d'un format

Il est possible de formater une valeur (nombre) issue d'une action sur un groupe de données lors de son affichage. Il est souvent contenu dans la propriété *format*.

Exemple

```json
"format":"{0:c}"
```

Voici quelques exemples.

| Formatage            | Valeur  | Résultat               |
| -------------------- | ------- | ---------------------- |
| {0:n}                | 1234    | 1 234,00               |
| {0:n1}               | 123     | 123,0                  |
| {0:n1}               | 123,55  | 123,6                  |
| {0:n0}               | 123.55  | 124                    |
| {0:c}                | 1234    | 1 234,00 €             |
| {0:c0}               | -123,55 | -124 €                 |
| {0:c0}               | 123,55  | 124 €                  |
| {0:p}                | 0,1     | 10,00 %                |
| {0:p0}               | 0,1     | 10 %                   |
| {0:p3}               | 200     | 20 000,000 %           |
| Le prix est de {0:c} | 23,6    | Le prix est de 23,60 € |

## Paramètres Back Office

Les paramètres suivants se définissent à deux endroits:

1. Dans le fichier de configuration *catalina.properties* situé dans le répertoire *conf* du serveur Tomcat. Pour qu'ils soient pris en compte, il faut que le serveur soit redémarré.<br>
2. Dans l'administration simplifiée qui prend en compte à chaud les valeurs des paramètres (pas besoin de redémarrer le serveur).\ <br>

   <figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-6be8e9ccbee4b252731d78603e8f26749d3a182e%2Fprocess-front-office-simplified_admin.webp?alt=media" alt=""><figcaption></figcaption></figure>

   \
   \
   Ils sont marqués de l'image suivante 🔥. Pour information, ils sont stockés dans un fichier de configuration qui se nomme **workey.properties** et se situe sur le serveur là où est installé Efalia Process, c'est-à-dire dans le répertoire des données d'Efalia Process. Le répertoire est le suivant ***$WORKEY\_DATA/config***, *$WORKEY\_DATA* étant la plupart du temps *Workey\_Data*. Bien-sûr il n'est pas nécessaire de modifier ce fichier, tout s'effectue depuis l'administration simplifiée.

### com.clog.workey.app.running.mode 🔥

*description* : ce paramètre permet de spécifier le mode de fonctionnement du Front Office (mode SAAS ou On Premise)

*valeur(s) possible(s)* : SAAS ou ON\_PREMISE

*valeur par défaut* : SAAS

### com.clog.workey.app.enable

*description* : ce paramètre active le Front Office pour qu'il soit accessible

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

### com.clog.workey.app.panorama.enable 🔥

*description* : ce paramètre active l'affichage de la partie Panorama d'Efalia Process

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### com.clog.workey.app.vertical.apps.enable 🔥

*description* : ce paramètre active l'affichage de la partie Application verticales d'Efalia Process

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### com.clog.workey.app.custom.app.name 🔥

*description* : ce paramètre permet de spécifier un nom pour l'application, il permet d'effacer l'identité du produit Efalia Process au profit d'un nom choisi par le client.

*valeur(s) possible(s)* : Chaine de caractères

### com.clog.workey.skin.custom.enabled 🔥

*description* : ce paramètre permet d'activer la fonctionnalité des thèmes personnalisés.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### com.clog.workey.skin.folder.name 🔥

*description* : ce paramètre permet de spécifier le thème utilisé par Efalia Process.

*valeur(s) possible(s)* : Chaine de caractères

*valeur par défaut* : default

### com.clog.workey.app.manage.users.enable 🔥

*description* : ce paramètre permet d'activer la gestion des utilisateurs dans la partie administration. Ce paramètre ne sera pas pris en compte si la propriété *com.clog.workey.app.running.mode* possède la valeur 'SAAS' (valeur forcée : 'true').

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

### com.clog.workey.app.manage.users.crud.enable 🔥

*description* : ce paramètre permet d'activer la mise à jour des comptes LDAP via la gestion des utilisateurs dans la partie administration. Ce paramètre ne sera pas pris en compte si le serveur d'identité est Keycloak (valeur forcée : 'false'), puis si la propriété *com.clog.workey.app.running.mode* possède la valeur 'SAAS' (valeur forcée : 'true').

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### com.clog.workey.app.no.js.error.notification

*description* : ce paramètre permet de désactiver l'affichage des erreurs Javascript issues de l'utilisation de la librairie WKYJS.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### com.clog.workey.app.mg.folder.deletion.enable

*description* : ce paramètre permet d'activer ou de désactiver la suppression des documents dans le composant *Dossier MG*.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

### com.clog.workey.default.language 🔥

*description* : ce paramètre permet de définir la langue par défaut d'Efalia Process.

*valeur(s) possible(s)* : une des valeurs de *com.clog.workey.supported.languages*

*valeur par défaut* : fr

### com.clog.workey.supported.languages 🔥

*description* : ce paramètre permet de définir les langues supportées par Efalia Process.

*valeur(s) possible(s)* : locales sur deux minuscules séparées par ","

*valeur par défaut* : fr,en,de

### com.clog.workey.mg.api.soap.server.url 🔥

*description* : ce paramètre permet de définir l'adresse du serveur de l'API Soap.

*valeur(s) possible(s)* : une URL (e.g. <https://www.my.company.com/Interconnexion/SoapServer.php?className=APIMultigest\\&style=rpc\\&styletype=encoded>)

*valeur par défaut* : <https://my.not.defined.mg.soap.api.url>

### com.clog.workey.mg.connected.user 🔥

*description* : ce paramètre permet de définir le type d'utilisateur à utiliser lors des opérations dans Multigest.

*valeur(s) possible(s)* : CURRENT\_USER ou SERVICE\_ACCOUNT

* CURRENT\_USER : l'identifiant de l'utilisateur connecté
* SERVICE\_ACCOUNT : le compte de service spécifié par `com.clog.workey.mg.service.account`

*valeur par défaut* : CURRENT\_USER

### com.clog.workey.mg.service.account 🔥

*description* : ce paramètre permet de définir le compte de service à utiliser lors des opérations dans Multigest.

*valeur(s) possible(s)* : Chaine de caractères

*valeur par défaut* :

### com.clog.workey.mg.readonly.user 🔥

*description* : ce paramètre permet de définir l'utilisateur à utiliser lors des opérations en mode lecture seule (par ex: ouverture d'un dossier Multigest).

*valeur(s) possible(s)* : Chaine de caractères

*valeur par défaut* :

### com.clog.workey.mg.agent.user 🔥

*description* : ce paramètre permet de définir l'utilisateur à utiliser lors des opérations effectuées par des agents.

*valeur(s) possible(s)* : Chaine de caractères

*valeur par défaut* :

### Edition des documents PDF

Dans les composants pièces jointes, il est possible d'éditer les documents PDF l'aide de PDFTron. Pour ce faire, il faut activer et configurer ce service à l'aide des paramètres ci-dessous.

#### com.clog.workey.mg.server.url

*description* : ce paramètre permet de spécifier l'url de l'API du server MultiGest.

*valeur(s) possible(s)* : une URL (e.g. <https://www.my.company.com:1203/api/server>)

*valeur par défaut* : <http://acme.com>

#### com.clog.workey.pdftron.enable 🔥

*description* : ce paramètre permet d'activer l'édition des documents contenus dans les pièces jointes à l'aide de PDFTron.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

#### com.clog.workey.pdftron.candidate.docs

*description* : ce paramètre permet de spécifier les types de document candidats à l'édition dans PDFTron.

*valeur(s) possible(s)* : liste des extensions de fichier séparées par le caractère | de format *.ext1|.ext2|.ext3* par exemple .pdf|.pdfa

*valeur par défaut* : .pdf

#### com.clog.workey.pdftron.available.creation

*description* : ce paramètre permet la création de document PDF depuis le composant pièce jointe.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

### Exemple de configuration minimale pour mettre en place PDFTron

```properties
com.clog.workey.pdftron.enable=true
```

### Edition des documents Office

Dans les composants pièces jointes, il est possible d'éditer les documents bureautiques de type Office l'aide d'OnlyOffice. Pour ce faire, il faut :

* Un serveur OnlyOffice accessible par le serveur Efalia Process (Tomcat). Rapprochez-vous de votre administrateur le cas échéant.
* Activer et configurer ce service à l'aide des paramètres ci-dessous.

#### com.clog.workey.onlyoffice.enable 🔥

*description* : ce paramètre permet d'activer l'édition des documents contenus dans les pièces jointes à l'aide d'OnlyOffice.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

#### com.clog.workey.onlyoffice.filesize.max

*description* : ce paramètre permet de spécifier la taille maximale des documents Office pouvant être édités.

*valeur(s) possible(s)* : Nombre représentant le nombre d'octets maximal

*valeur par défaut* : 5242880 ce qui correspond à 5Mo

#### com.clog.workey.onlyoffice.docservice.viewed.docs

*description* : ce paramètre permet de spécifier les types de documents qui seront ouverts en lecture seule.

*valeur(s) possible(s)* : liste des extensions de fichier séparées par le caractère | de format *.ext1|.ext2|.ext3* par exemple .pdf|.pdfa

*valeur par défaut* : .pdf|.djvu|.xps

#### com.clog.workey.onlyoffice.docservice.edited.docs

*description* : ce paramètre permet de spécifier les types de documents qui seront ouverts en écriture.

*valeur(s) possible(s)* : liste des extensions de fichier séparées par le caractère | de format *.ext1|.ext2|.ext3* par exemple .pdf|.pdfa

*valeur par défaut* : .docx|.xlsx|.csv|.pptx|.txt

#### com.clog.workey.onlyoffice.docservice.convert.docs

*description* : ce paramètre permet de spécifier les types de documents qui seront convertis avant édition.

*valeur(s) possible(s)* : liste des extensions de fichier séparées par le caractère | de format *.ext1|.ext2|.ext3* par exemple .pdf|.pdfa

*valeur par défaut* : .docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xltx|.xltm|.xlt|.xls|.#ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.epub

#### com.clog.workey.onlyoffice.docservice.url.base 🔥

*description* : ce paramètre permet de spécifier le serveur qui héberge OnlyOffice, toutes les urls du service *docService* sont préfixées par cette url.

*valeur(s) possible(s)* : une url de *type <http://server:port>*

*valeur par défaut* : à définir obligatoirement

#### com.clog.workey.onlyoffice.docservice.url.converter

*description* : ce paramètre permet de spécifier l'url du convertisseur de document.

*valeur(s) possible(s)* : un chemin d'url complétant *com.clog.workey.onlyoffice.docservice.url.base*

*valeur par défaut* : /ConvertService.ashx

#### com.clog.workey.onlyoffice.docservice.url.tempstorage

*description* : ce paramètre permet de spécifier l'url du stockage temporaire.

*valeur(s) possible(s)* : un chemin d'url complétant *com.clog.workey.onlyoffice.docservice.url.base*

*valeur par défaut* : /ResourceService.ashx

#### com.clog.workey.onlyoffice.docservice.url.api

*description* : ce paramètre permet de spécifier l'url de l'API JS d'OnlyOffice.

*valeur(s) possible(s)* : un chemin d'url complétant *com.clog.workey.onlyoffice.docservice.url.base*

*valeur par défaut* : /web-apps/apps/api/documents/api.js

#### com.clog.workey.onlyoffice.docservice.url.preloader

*description* : ce paramètre permet de spécifier l'url du preloader.

*valeur(s) possible(s)* : un chemin d'url complétant *com.clog.workey.onlyoffice.docservice.url.base*

*valeur par défaut* : /web-apps/apps/api/documents/cache-scripts.html

#### com.clog.workey.onlyoffice.docservice.timeout

*description* : ce paramètre permet de spécifier le timeout des appels aux services

*valeur(s) possible(s)* : Un nombre de millisesondes

*valeur par défaut* : 120000

#### com.clog.workey.onlyoffice.docservice.secret 🔥

*description* : ce paramètre permet de spécifier la clé nécessaire à la création et à l'utilisation de jetons. Le fait de la spécifier permet d'active la fonctionnalité.

*valeur par défaut* :

#### com.clog.workey.onlyoffice.docservice.header

*description* : ce paramètre permet de spécifier des entêtes HTTP.

*valeur par défaut* : Authorization

#### com.clog.workey.onlyoffice.available.creations

*description* : ce paramètre permet la création de document Office depuis le composant pièce jointe.

*valeur(s) possible(s)* : énumération avec comme caractère séparateur |, par exemple word|excel|powerpoint

*valeur par défaut* : word

#### com.clog.workey.onlyoffice.forced.callback.url

*description* : ce paramètre permet de forcer une url de callback vers Process (par ex: <http://10.225.7.21:8081>).

*valeur par défaut* :

### Menu de navigation entre applications / espaces d'Efalia Process

Le menu ci-dessous permet de naviguer entre les différentes applications / espaces. Il est paramétrable avec les 5 variables suivantes.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-03a68fe7a2537d795add373a0eb04ccef66d39c8%2Fprocess-front-office-transversal-menu.webp?alt=media" alt=""><figcaption></figcaption></figure>

#### com.clog.workey.spaces.nav.menu.enable 🔥

*description* : ce paramètre permet d'activer ou de désactiver le menu de navigation. Cette variable est ignorée en mode [SAAS](#var_running_mode). Si le mode SAAS est activée, le menu n'est pas affiché.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

#### com.clog.workey.spaces.nav.designer.enable 🔥

*description* : ce paramètre permet d'afficher ou de masquer l'icône du 'Designer' dans le menu.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

#### com.clog.workey.spaces.nav.admin.enable 🔥

*description* : ce paramètre permet d'afficher ou de masquer l'icône 'Administration avancée' dans le menu.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

#### com.clog.workey.spaces.nav.documentation.enable 🔥

*description* : ce paramètre permet d'afficher ou de masquer l'icône 'Documentation' dans le menu.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

#### com.clog.workey.spaces.nav.archives.enable 🔥

*description* : ce paramètre permet d'afficher ou de masquer l'icône 'Serveur d'archives' dans le menu.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : true

### Interopérabilité entre Process et Doc

#### com.clog.workey.doc.process.enable

*description* : ce paramètre permet d'activer les interactions avec Efalia Doc.

*valeur(s) possible(s)* : true ou false

*valeur par défaut* : false

#### com.clog.workey.mgx.api.server 🔥

*description* : ce paramètre permet de spécifier l'URL du serveur Doc (par ex: <https://sandbox.efalia.cloud:1202>)

*valeur par défaut* :

#### com.clog.workey.mgx.api.login 🔥

*description* : ce paramètre permet de spécifier le login du compte de service de Doc.

*valeur(s) possible(s)* : chaine de caractères

*valeur par défaut* :

#### com.clog.workey.mgx.api.password 🔥

*description* : ce paramètre permet de spécifier le mot de passe du compte de service de Doc.

*valeur(s) possible(s)* : chaine de caractères

*valeur par défaut* :

#### com.clog.workey.mgx.pdc.cache.cron

*description* : ce paramètre permet de programmer la fabrication du cache du plan de classement de Doc. La syntaxe est celle de Spring avec 6 colonnes.

*valeur(s) possible(s)* : \* \* \* \* \* \* (voir la documentation [ici](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/scheduling/support/CronExpression.html))

*valeur par défaut* : 0 0 1 \* \* \* (tous les jours à 1h00 AM)

### com.clog.workey.idp.apiKeys

*description* : en mode idp `keycloak`, ce paramètre permet d'ajouter des clés d'api (si plusieurs le séparateur est le caractère `,`). Une clé api couplé au DN d'un acteur permettra de s'authentifier à l'application Process via une impersonnification de cet acteur. Lors des requêtes HTTP, il faudra utiliser deux headers :

* X-API-KEY : une des clé api paramétré
* X-IMPERSONATE : le DN d'un acteur connu

*valeur(s) possible(s)* : vide ou `cléApi1` ou `cléApi1,cléApi2...`

*valeur par défaut* :

## Customisation

Le customisation du Front Office s'effectue à l'aide de skins. Pour plus d'informations, veuillez consulter la documentation sur la [Gestion des thèmes](https://documentation.efalia.com/produit/efalia-process/administration/gestion-themes.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-process/administration/parametrage-front-office.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
