Champs-métiers

Présentation

L'objet de cette page est de présenter les champs métiers de la version 4 d'OpenFlyers.

Introduction

Les champs métiers ont pour vocation de remplacer les champs définis en dur dans les différents modules du logiciel OpenFlyers :

• Imports et synchronisations
• Gestion des ressources
• Gestion des utilisateurs
• Saisie des réservations
• Saisie des activités (saisie des vols par exemple)
• Edition des rapports
• Rapport des mouvements comptables (ou flux) d'un compte et factures

On retrouve ces modules dans la colonne Catégorie :

• Comptabilité : Cela rajoutera une colonne dans les rapports et les factures
• Import : Cela rajoutera un champ dans le module d'import
• Rapport : Cela rajoutera un champ dans le formulaire d'édition des rapports
• Ressource : Cela rajoutera un champ dans le formulaire de gestion de ressource
• Réservation : Cela rajoutera un champ dans le formulaire de réservation
• Utilisateur : Cela rajoutera une champ dans les fiches utilisateurs
• Vol : Cela rajoutera un champ dans le formulaire de saisie des vols

Ils permettent ainsi une plus grande flexibilité dans la configuration d'OpenFlyers en permettant de créer librement des champs et en permettant de définir qui peut y avoir accès, qui peut en voir le contenu et quelles règles de saisies peuvent être imposées pour chaque champ.

Certains champs additionnels restent néanmoins liés à des comportements spécifiques du logiciel. Leur absence entraine alors une régression des fonctionnalités propres à OpenFlyers.

L'accès à la gestion des champs additionnels se fait depuis Admin > Configuration > Champ(s) additionnel(s) : Fichier:Extrafield4.png

Pour chaque champ, il est possible de définir le type de valeur. En fonction du type sélectionné, le champ prendra une forme différente (zone de saisie libre, "combo", etc.)

Champs spécifiques

activityComment

Le champ métier activityComment remplace le champ en dur qui permettait de laisser un commentaire sur l'activité.

aerogligliPilotId

Le champ métier aerogligliPilotId permet de coupler les utilisateurs avec Aérogligli. Ce champ est de type Chaîne textuelle et appartient à la catégorie Utilisateur.

Ainsi, lorsqu'il est activé, chaque utilisateur verra apparaître dans sa fiche personnelle un champ Numéro d'utilisateur Aérogligli. Une fois le numéro d'utilisateur aérogligli renseigné, l'utilisateur verra ses statistiques Aérogligli apparaître dans le tableau de bord.

billingAddress

Le champ métier billingAddress est utilisé dans la facturation pour modifier l'adresse de l'utilisateur facturé par l'adresse d'un autre utilisateur.

Pour autoriser cette fonctionnalité, créer le champ métier avec :

• Nom : billingAddress
• Intitulé : Adresse de facturation
• Type de valeur : dbObject::Person
• Catégorie : Utilisateur

Ensuite, procéder à la liaison des utilisateurs :

• Depuis l'ancienne interface :
  • Aller Admin > Utilisateurs > Utilisateurs
  • Aller sur la ligne d'un utilisateur et cliquer sur l'icône "Crayon"
  • Dans le champ Adresse de facturation, sélectionner un utilisateur dont son adresse sera utilisé pour la facturation
  • Cliquer sur le bouton Enregistrer
• Depuis la nouvelle interface :
  • Aller dans l'interface de gestion des utilisateurs
  • Aller dans l'onglet Données personnelles
  • Aller sur la ligne d'un utilisateur
  • Dans la colonne Adresse de facturation, sélectionner un utilisateur dont son adresse sera utilisé pour la facturation

bookingArrivalLocation

Le champ métier bookingArrivalLocation de catégorie Réservation remplace le champ en dur qui permettait de choisir le lieu d'arrivée.

bookingComment

Le champ métier bookingComment remplace le champ en dur qui permettait de laisser un commentaire sur la réservation.

bookingDeparture

Le champ métier bookingDeparture de catégorie Réservation remplace le champ en dur qui permettait de choisir le lieu de départ.

endDate

Le champ métier endDate de catégorie Réservation permet de définir la date de fin des réservations sur la nouvelle interface.

bookingEstimatedFlightTime

Le champ métier bookingEstimatedFlightTime remplace le champ en dur qui permettait de connaitre la durée du temps de vol prévu. S'il est présent, alors OpenFlyers le renseigne automatiquement lorsqu'il est laissé vide en prenant la moitié de la durée de la réservation.

Ce champ métier permet aussi le calcul du temps prévisionnel qui va s'afficher au niveau du planning, en dessous de chaque réservation.

Il est également possible d'obliger les utilisateurs à renseigner la valeur du champ en cochant la check-box de la colonne Remplissage obligatoire.

Pour que la valeur contenue dans ce champ soit utilisée pour remplir par défaut le champ Durée du vol lors de la saisie d'un vol associé à une réservation, il faut :

• Dans la cellule de la colonne Catégorie liée, sélectionner Vol
• Dans la cellule de la colonne Champ à lier, sélectionner Temps de vol

spreadsheetResourceCell

Le champ métier spreadsheetResourceCell remplace le champ en dur qui permettait de définir, pour une feuille de calcul, la cellule liée à la ressource.

startDate

Le champ métier startDate de catégorie Réservation permet de définir la date de début des réservations sur la nouvelle interface.

Type de valeur

Les types de valeurs proposées sont :

• currency pour les nombres décimaux positifs (utilisé principalement pour du monétaire)
• date pour les dates
• datetime pour les dates avec les heures
• decimal pour les nombres décimaux
• integer pour les entiers
• formula pour les formules
• mois pour les mois. Seul le module Edition des rapports peut exploiter ce type de valeur.
• multiline_string pour les chaînes textuelles multi-ligne
• sexacentimal pour les Sexacentimal
• time pour les heures
• unique_integer pour les entiers dont les valeurs doivent être uniques
• unique_string pour les chaînes textuelles dont les valeurs doivent être uniques
• string pour les chaînes textuelles
• year pour les années
• dbObject::XXX pour un élément de la base de données
• dbObjectMulti::XXX pour plusieurs éléments de la base de données. Seul le module Edition des rapports peut exploiter ce type de valeur.

dbObject::XXX

Dans le formulaire, le champs de type "dbObject" est représenté sous forme de liste déroulante où est proposé comme choix :

• "Pas de filtre" comme premier choix
• La liste des différents "objets" comme autre choix. Par exemple, un type "dbObject::Person" va donner la liste des utilisateurs

dbObjectMulti::XXX

Dans le formulaire, le champ de type "dbObjectMulti" est représenté sous forme de liste de cases à cocher où est proposé comme choix :

• La liste des différents "objets" comme autre choix. Par exemple, un type "dbObjectMulti::Profile" va donner la liste des profils

Utilisations

Créer une colonne supplémentaire dans les factures des heures de vols

Il est possible de créer des colonnes supplémentaires dans les factures des heures de vols grâce aux champs additionnels.

• Dans Configuration > Champs additionnels :
  • Créer une nouveau champ additionnel de catégorie Entrée comptable
• Dans Ventes > Tarification des heures > Règles de tarification :
  • Modifier une règle de tarification ou en créer une nouvelle (s'il faut créer une règle de tarification spécifique pour obtenir l'information à insérer dans le champ additionnel) et renseigner le champ Champ additionnel à lier avec le nom du champ additionnel précédemment créé.
  • Valider.

Ainsi, une nouvelle colonne du nom du champ additionnel créé sera systématiquement rajoutée dans la facture et contiendra la valeur issue de la règle de tarification qui lui est liée.

Récupérer la valeur d'un champ additionnel dans les règles de tarification des activités

Il est possible de récupérer la valeur d'un champ additionnel dans les règles de tarification des activités. Cela permet de modifier par exemple un tarif en fonction de la valeur indiquée dans le champ additionnel ou d'indiquer une quantité qui influe sur le prix.

Pour cela il faut utiliser la variable %EXTRAFIELDxx.