Champs métiers
Présentation
L'objet de cette page est de présenter les champs métiers de la version 4 d'OpenFlyers.
Le droit Gestion du paramétrage est nécessaire pour accéder à cette page.
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.
bookingDepartureLocation
Le champ métier bookingDepartureLocation de catégorie Réservation remplace le champ en dur qui permettait de choisir le lieu de départ.
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
bookingFreeSeats
Le champ métier bookingFreeSeats remplace le champ en dur Places à disposition qui permettait de saisir le nombre de places à disposition.
Valeur par défaut : 0
charterwareUserId
Le champ métier charterwareUserId permet de spécifier pour chaque utilisateur son identifiant Charterware cela est utilisé pour l'interfaçage Charterware
charterwareResourceId
Le champ métier charterwareResourceId permet de spécifier pour chaque ressource son identifiant Charterware cela est utilisé pour l'interfaçage Charterware
onBlockDate
Le champ métier onBlockDate permet de spécifier pour chaque vol une heure on block cela est utilisé pour l'interfaçage Charterware .
city
Le champ métier city de catégorie Ayant comme activité permet de définir la ville de de l'utilisateur lors de la création automatique à la réservation.
Le champ métier email de catégorie Ayant comme activité permet de définir l'email de l'utilisateur lors de la création automatique à la réservation.
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.
firstName
Le champ métier firstName de catégorie Ayant comme activité permet de définir le nom de de l'utilisateur lors de la création automatique à la réservation.
lastName
Le champ métier lastName de catégorie Ayant comme activité permet de définir le prénom de de l'utilisateur lors de la création automatique à la réservation.
phone
Le champ métier phone de catégorie Ayant comme activité permet de définir le téléphone de de l'utilisateur lors de la création automatique à la réservation.
keyAuthorization
Le champ métier keyAuthorization de catégorié Utilisateur est utilisé par le contrôle d'accès pour mettre à jour la clé d'accès de l'utilisateur.
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
Chaque type dbOject représentent une table de la base de donnée et retournent les entrées de la table sous forme d'une liste déroulante. Exemple : dbObject::Account retourne la liste des comptes. Chaque liste déroulante a pour première entrée la valeur Pas de filtre. Il n'est possible de ne sélectionner qu'un élément.
Cas particulier pour le type dbObject::Person, il est possible de filtrer la liste des personnes avec l'identifiant d'un profil. Le logiciel va proposer pour chaque profil un type dbObject::Person, par exemple : dbObject::Person::1024 et qui sera affiché dans le logiciel sous cette forme : dbObject::Person (Instructeur).
dbObjectMulti::XXX
Chaque type dbObjectMulti représentent une table de la base de donnée et retournent les entrées de la table sous forme d'une liste de cases à cocher. Exemple : dbObjectMulti::Profile retourne la liste des profils. Il est possible de sélectionner plusieurs éléments.
Liste des valeurs possibles pour dbObject et dbObjectMulti
- Account
- AccountEntry
- Accounting
- AccountType
- ActivityType
- BalanceDate
- Booking
- Budget
- BudgetGroup
- BusinessField
- Structure
- Criteria
- ExceptionnalInstDate
- Flight
- FlightHoursPricing
- Location
- Logger
- Nationality
- Parameter
- PaymentDistribution
- PaymentType
- Person
- Profile
- Product
- RegularPresenceInstDate
- Resource
- ResourceType
- SalePricing
- Status
- Stock
- StockLevel
- StockType
- StockVariation
- SupplierBill
- SupplierBillType
- ValidityType
- Variable
- WebFeed
- WebFeedChannel
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 métiers.
- Dans Structure > Champs métiers :
- Créer un nouveau champ métier 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 métier précédemment créé.
- Valider.
Ainsi, une nouvelle colonne du nom du champ métier 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.
Ordonner les champs métiers
Pour ordonner les champs métiers il faut utiliser les flèches haut/bas dans la colonne Ordonner.
A cause de champs cachés, il se peut que vous ne voyez pas de changement lorsque vous cliquez sur une flèche car le changement s'est fait avec l'un de ces champs. Il faut donc recommencer l'opération.
Récupérer la valeur d'un champ métier dans les règles de tarification des activités
Il est possible de récupérer la valeur d'un champ métier 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 métier ou d'indiquer une quantité qui influe sur le prix.
Pour cela il faut utiliser la variable %EXTRAFIELDxx.