Documentation de la solution web de gestion OpenFlyers version 2 - Contributions de l’utilisateur [fr]

Structure de la base de données

2017-06-08T11:22:21Z

Jcheng : Page créée avec « =Structure= <sql>CREATE TABLE IF NOT EXISTS `account` ( `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT, `creation_date` date DEFAULT NULL, `name` text CHARACTER SET... »

=Structure=

<sql>CREATE TABLE IF NOT EXISTS `account` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`creation_date` date DEFAULT NULL,
`name` text CHARACTER SET latin1,
`export_account` text CHARACTER SET latin1,
`activated` int(1) DEFAULT '1',
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of account';

CREATE TABLE IF NOT EXISTS `account_aircraft` (
`account_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`aircraft_id` int(11) DEFAULT NULL,
`account_type` int(10) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`account_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of aircraft accounts';

CREATE TABLE IF NOT EXISTS `account_aircraft_type` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` text CHARACTER SET latin1,
`activated` tinyint(1) NOT NULL DEFAULT '1',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='account aircraft type description';

CREATE TABLE IF NOT EXISTS `account_club` (
`account_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`payment_allowed` tinyint(1) UNSIGNED DEFAULT '0',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`account_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of club accounts';

CREATE TABLE IF NOT EXISTS `account_entry` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`double_entry_id` int(11) DEFAULT NULL,
`account_date` datetime DEFAULT NULL,
`account_id` int(11) DEFAULT NULL,
`credit` decimal(15,2) DEFAULT '0.00',
`debit` decimal(15,2) DEFAULT '0.00',
`payment_type` int(10) UNSIGNED DEFAULT NULL,
`payment_description` text CHARACTER SET latin1,
`person_delivery_id` int(10) UNSIGNED DEFAULT NULL,
`comments` text CHARACTER SET latin1,
`validated` int(1) DEFAULT '0',
`exported` int(1) DEFAULT '0',
PRIMARY KEY (`id`),
KEY `idx_account_date` (`account_date`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of account entries';

CREATE TABLE IF NOT EXISTS `account_member` (
`account_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`member_id` int(11) DEFAULT NULL,
`account_type` int(10) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`account_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of member accounts';

CREATE TABLE IF NOT EXISTS `account_member_type` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` text CHARACTER SET latin1,
`activated` tinyint(1) NOT NULL DEFAULT '1',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of account member types';

CREATE TABLE IF NOT EXISTS `aircraft` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`callsign` varchar(255) DEFAULT NULL,
`type` int(10) UNSIGNED DEFAULT NULL,
`comments` varchar(255) DEFAULT NULL,
`non_bookable` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`ref_date` datetime DEFAULT NULL,
`ref_hours` int(11) DEFAULT NULL,
`inspection_date` datetime DEFAULT NULL,
`inspection_time` int(11) DEFAULT NULL,
`interval_visit` int(11) UNSIGNED DEFAULT '30000',
`tolerance_time` int(11) UNSIGNED DEFAULT '6000',
`last_counter` int(11) DEFAULT NULL,
`activated` tinyint(1) UNSIGNED DEFAULT '1',
`time_alert1` int(11) DEFAULT '6000',
`time_alert2` int(11) DEFAULT '0',
`time_alert3` int(11) DEFAULT '0',
`day_alert1` smallint(3) DEFAULT '15',
`day_alert2` smallint(3) DEFAULT '0',
`day_alert3` smallint(3) DEFAULT '8',
`non_flightable` tinyint(3) UNSIGNED NOT NULL DEFAULT '0',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `CALLSIGN` (`callsign`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='ALL AIRCRAFTS OF ALL AIRCLUBS';

CREATE TABLE IF NOT EXISTS `aircraft_type` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`admin_desc` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`name` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`seats_available` tinyint(3) UNSIGNED DEFAULT '1',
`comments` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`flight_time_formula` varchar(255) CHARACTER SET latin1 DEFAULT '%DURATION',
`counter_state` tinyint(2) NOT NULL DEFAULT '-1',
`tolerance` int(11) DEFAULT '0',
`autonomy` int(11) DEFAULT '5990',
`activated` tinyint(1) UNSIGNED NOT NULL DEFAULT '1',
`digit_counter_number` tinyint(1) UNSIGNED NOT NULL DEFAULT '4',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='Types of aircraft';

CREATE TABLE IF NOT EXISTS `aircraft_type_allowed_function` (
`aircraft_type_id` int(10) UNSIGNED DEFAULT NULL,
`place_num` int(10) UNSIGNED DEFAULT NULL,
`function_id` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of allowed functions for each aircraft type';

CREATE TABLE IF NOT EXISTS `aircraft_type_mandatory_flight_type` (
`aircraft_type_id` int(10) UNSIGNED DEFAULT NULL,
`flight_type_id` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of compulsory flight type for each aircraft type';

CREATE TABLE IF NOT EXISTS `aircraft_type_qualif` (
`aircraft_type_id` int(10) UNSIGNED DEFAULT NULL,
`check_num` int(10) UNSIGNED DEFAULT NULL,
`qualification_id` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='Types of qualif required for each aircraft type';

CREATE TABLE IF NOT EXISTS `aircraft_type_uncomp_flight_type` (
`aircraft_type_id` int(10) UNSIGNED DEFAULT NULL,
`flight_type_id` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of uncompatible flight type for each aircraft type';

CREATE TABLE IF NOT EXISTS `authentication` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` varchar(255) NOT NULL,
`password` varchar(255) NOT NULL,
`first_name` varchar(255) DEFAULT NULL,
`last_name` varchar(255) DEFAULT NULL,
`profile` mediumint(8) UNSIGNED DEFAULT NULL,
`view_type` int(10) UNSIGNED DEFAULT NULL,
`view_width` tinyint(3) UNSIGNED NOT NULL DEFAULT '12',
`view_height` tinyint(4) UNSIGNED NOT NULL DEFAULT '30',
`aircrafts_viewed` varchar(255) DEFAULT NULL,
`inst_viewed` varchar(255) DEFAULT NULL,
`email` varchar(255) DEFAULT NULL,
`timezone` varchar(255) DEFAULT NULL,
`address` varchar(255) DEFAULT NULL,
`zipcode` varchar(255) DEFAULT NULL,
`city` varchar(255) DEFAULT NULL,
`state` varchar(255) DEFAULT NULL,
`country` varchar(255) DEFAULT NULL,
`home_phone` varchar(255) DEFAULT NULL,
`work_phone` varchar(255) DEFAULT NULL,
`cell_phone` varchar(255) DEFAULT NULL,
`lang` varchar(255) DEFAULT NULL,
`notification` tinyint(3) UNSIGNED DEFAULT NULL,
`activated` tinyint(1) UNSIGNED DEFAULT '1',
`birthdate` datetime DEFAULT '0000-00-00 00:00:00',
`sex` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`nationality` char(2) DEFAULT NULL,
`total_flight_time` int(10) UNSIGNED DEFAULT '0',
`date_total_flight_time` datetime DEFAULT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `idx_name` (`name`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='used for authentication';

CREATE TABLE IF NOT EXISTS `balance` (
`account_id` int(10) UNSIGNED NOT NULL,
`balance_date_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`debit` decimal(15,2) DEFAULT '0.00',
`credit` decimal(15,2) DEFAULT '0.00',
PRIMARY KEY (`account_id`,`balance_date_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `balance_date` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`balance_date` datetime DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `booking` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`start_date` datetime DEFAULT NULL,
`end_date` datetime DEFAULT NULL,
`aircraft_id` int(10) UNSIGNED DEFAULT NULL,
`member_id` int(10) UNSIGNED DEFAULT NULL,
`slot_type` tinyint(3) UNSIGNED DEFAULT NULL,
`instructor_id` int(10) UNSIGNED DEFAULT NULL,
`free_seats` tinyint(3) UNSIGNED DEFAULT NULL,
`comments` varchar(255) DEFAULT NULL,
`airfield` varchar(6) DEFAULT NULL,
`estimated_duration` int(10) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='RECORDS ALL THE SLOTS OF ALL AIRCRAFTS OF ALL AIRCLUBS';

CREATE TABLE IF NOT EXISTS `club` (
`id` int(10) NOT NULL DEFAULT '0',
`name` varchar(255) DEFAULT NULL,
`info_cell` text,
`logo` longblob,
`logo_name` varchar(255) DEFAULT NULL,
`logo_ext` varchar(25) DEFAULT NULL,
`logo_size` int(11) DEFAULT NULL,
`first_hour_displayed` time DEFAULT NULL,
`last_hour_displayed` time DEFAULT NULL,
`usual_profiles` mediumint(8) UNSIGNED DEFAULT NULL,
`icao` varchar(6) DEFAULT NULL,
`default_slot_range` int(10) UNSIGNED DEFAULT NULL,
`min_slot_range` tinyint(3) UNSIGNED DEFAULT NULL,
`twilight_range` tinyint(3) UNSIGNED DEFAULT NULL,
`mailing_list_name` varchar(255) DEFAULT NULL,
`mailing_list_type` varchar(255) DEFAULT NULL,
`club_site_url` varchar(255) DEFAULT NULL,
`default_timezone` varchar(255) NOT NULL,
`lang` varchar(255) NOT NULL,
`admin_num` int(10) UNSIGNED NOT NULL,
`mail_from_address` varchar(255) DEFAULT NULL,
`default_view_type` int(10) UNSIGNED DEFAULT NULL,
`address` varchar(255) DEFAULT NULL,
`zipcode` varchar(255) DEFAULT NULL,
`city` varchar(255) DEFAULT NULL,
`state` varchar(255) DEFAULT NULL,
`country` varchar(255) DEFAULT NULL,
`phone` varchar(255) DEFAULT NULL,
`fax` varchar(255) DEFAULT NULL,
`email` varchar(255) DEFAULT NULL,
`default_notification` int(3) UNSIGNED DEFAULT NULL,
`welcome_cell` text,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='DESCRIPTION OF ALL AIRCLUBS';

CREATE TABLE IF NOT EXISTS `criteria` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`label` varchar(255) CHARACTER SET latin1 NOT NULL,
`predicate` text CHARACTER SET latin1 NOT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `default_display` (
`authentication_id` int(10) UNSIGNED NOT NULL,
`display_key` varchar(255) CHARACTER SET latin1 NOT NULL DEFAULT '',
`display_value` text CHARACTER SET latin1,
PRIMARY KEY (`authentication_id`,`display_key`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `exceptionnal_inst_date` (
`instructor_id` int(10) UNSIGNED NOT NULL,
`start_date` datetime DEFAULT NULL,
`end_date` datetime DEFAULT NULL,
`presence` tinyint(1) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `favorite_icao` (
`icao` varchar(6) NOT NULL,
PRIMARY KEY (`icao`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='favorite airfield list';

CREATE TABLE IF NOT EXISTS `fhp_aircraft_type` (
`fhp_id` int(10) DEFAULT NULL,
`aircraft_type_id` int(10) DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='flight hour pricing aircraft type list';

CREATE TABLE IF NOT EXISTS `fhp_flight_type` (
`fhp_id` int(10) DEFAULT NULL,
`flight_type_id` int(10) DEFAULT NULL,
`excluded` tinyint(1) UNSIGNED DEFAULT '0'
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='flight hour pricing flight type list';

CREATE TABLE IF NOT EXISTS `fhp_member_pool` (
`fhp_id` int(10) DEFAULT NULL,
`member_pool_id` int(10) DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='flight hour pricing flight type list';

CREATE TABLE IF NOT EXISTS `flight` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`aircraft_id` int(10) UNSIGNED DEFAULT NULL,
`start_date` datetime DEFAULT NULL,
`duration` int(10) UNSIGNED DEFAULT NULL,
`flight_type_id` int(10) UNSIGNED DEFAULT NULL,
`people_onboard` int(10) UNSIGNED DEFAULT NULL,
`airfield_departure` varchar(6) CHARACTER SET latin1 DEFAULT NULL,
`airfield_arrival` varchar(6) CHARACTER SET latin1 DEFAULT NULL,
`counter_departure` int(10) UNSIGNED DEFAULT NULL,
`counter_arrival` int(10) UNSIGNED DEFAULT NULL,
`landing_number` int(10) UNSIGNED DEFAULT NULL,
`comments` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`airborne` tinyint(1) UNSIGNED DEFAULT NULL,
`validated` tinyint(3) UNSIGNED DEFAULT '0',
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of flight';

CREATE TABLE IF NOT EXISTS `flight_account_entry` (
`flight_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`account_entry_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
PRIMARY KEY (`flight_id`,`account_entry_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='flight account entry join';

CREATE TABLE IF NOT EXISTS `flight_hours_pricing` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` text CHARACTER SET latin1,
`price_formula` text CHARACTER SET latin1,
`price_sentence` text CHARACTER SET latin1,
`left_account_id` int(10) UNSIGNED DEFAULT NULL,
`right_account_id` int(10) UNSIGNED DEFAULT NULL,
`left_account_type` tinyint(1) UNSIGNED DEFAULT '0',
`right_account_type` tinyint(1) UNSIGNED DEFAULT '0',
`member_debited` tinyint(1) UNSIGNED DEFAULT '1',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of flight hours pricing formula';

CREATE TABLE IF NOT EXISTS `flight_pilot` (
`flight_id` int(10) UNSIGNED NOT NULL,
`pilot_id` int(10) UNSIGNED NOT NULL,
`function_id` int(10) UNSIGNED DEFAULT NULL,
`num` int(10) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`flight_id`,`pilot_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of crew for each flight';

CREATE TABLE IF NOT EXISTS `flight_tank_qty` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`flight_id` int(10) UNSIGNED NOT NULL,
`tank_id` int(10) UNSIGNED NOT NULL,
`quantity` varchar(255) CHARACTER SET latin1 NOT NULL DEFAULT '0.00',
`after_flight` tinyint(1) NOT NULL DEFAULT '0',
`account_id` int(10) UNSIGNED DEFAULT NULL,
`pay_type` tinyint(1) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `flight_type` (
`id` int(10) UNSIGNED NOT NULL,
`name` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of flight type';

CREATE TABLE IF NOT EXISTS `flight_type_mandatory_qualification` (
`flight_type_id` int(10) UNSIGNED NOT NULL,
`qualification_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
PRIMARY KEY (`flight_type_id`,`qualification_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of mandatory qualification for each flight type';

CREATE TABLE IF NOT EXISTS `icao` (
`name` varchar(64) DEFAULT NULL,
`icao` varchar(6) NOT NULL,
`lat` float DEFAULT NULL,
`lon` float DEFAULT NULL,
`alt` smallint(6) DEFAULT NULL,
PRIMARY KEY (`icao`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='airfields coord';

CREATE TABLE IF NOT EXISTS `instructor` (
`id` int(10) UNSIGNED NOT NULL,
`sign` varchar(255) DEFAULT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='LIST INSTRUCTORS AND THEIR AUTORIZATIONS';

CREATE TABLE IF NOT EXISTS `ip_stopped` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`ip` varchar(255) NOT NULL,
`counter` tinyint(1) UNSIGNED NOT NULL,
`expire_date` datetime NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='BLACKLISTED IP';

CREATE TABLE IF NOT EXISTS `journal` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`login` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`date_log` datetime DEFAULT NULL,
`rights` text CHARACTER SET latin1,
`rights2` text CHARACTER SET latin1,
`is_member` tinyint(1) UNSIGNED DEFAULT NULL,
`is_instructor` tinyint(1) UNSIGNED DEFAULT NULL,
`action` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
PRIMARY KEY (`id`),
KEY `idx_date_log` (`date_log`),
KEY `idx_action` (`action`(8))
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='list of logs';

CREATE TABLE IF NOT EXISTS `key_assignment` (
`key_id` tinyint(2) UNSIGNED NOT NULL DEFAULT '0',
`key_name` tinytext CHARACTER SET latin1,
`aircraft_id` int(10) UNSIGNED DEFAULT '0',
`key_state` tinyint(1) UNSIGNED DEFAULT '0',
`key_word` bigint(20) UNSIGNED DEFAULT NULL,
PRIMARY KEY (`key_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='key assignment description';

CREATE TABLE IF NOT EXISTS `key_host` (
`id` tinyint(2) NOT NULL AUTO_INCREMENT,
`timeout` tinyint(2) UNSIGNED NOT NULL DEFAULT '10',
`num_key` tinyint(2) UNSIGNED NOT NULL DEFAULT '10',
`ipkey` varchar(50) CHARACTER SET latin1 NOT NULL,
`httpport` varchar(4) CHARACTER SET latin1 NOT NULL DEFAULT '4080',
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='key host configuration';

CREATE TABLE IF NOT EXISTS `log` (
`journal_id` int(10) UNSIGNED NOT NULL,
`action` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`table_name` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`field_name` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`field_value` text CHARACTER SET latin1,
KEY `journal_id` (`journal_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='part of logs';

CREATE TABLE IF NOT EXISTS `login_stopped` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`login` varchar(255) NOT NULL,
`counter` tinyint(3) UNSIGNED NOT NULL,
`expire_date` datetime NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='BLACKLISTED LOGIN';

CREATE TABLE IF NOT EXISTS `member` (
`id` int(10) UNSIGNED NOT NULL,
`member_num` int(11) DEFAULT NULL,
`subscription` date NOT NULL DEFAULT '2003-12-31',
`qualif_alert_delay` tinyint(3) UNSIGNED NOT NULL DEFAULT '8',
`inscription_date` date DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='ALL MEMBERS OF ALL AIRCLUBS';

CREATE TABLE IF NOT EXISTS `member_awaiting_activation` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`login` varchar(255) CHARACTER SET latin1 NOT NULL,
`ip` varchar(255) CHARACTER SET latin1 NOT NULL,
`code` varchar(255) CHARACTER SET latin1 NOT NULL,
`category` varchar(255) CHARACTER SET latin1 NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `member_pool` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` text CHARACTER SET latin1,
`required_account_type` int(10) UNSIGNED DEFAULT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of member pool';

CREATE TABLE IF NOT EXISTS `member_pool_join` (
`member_pool_id` int(10) UNSIGNED DEFAULT NULL,
`member_id` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='Correspondance between pools and members';

CREATE TABLE IF NOT EXISTS `member_qualif` (
`member_id` int(10) UNSIGNED NOT NULL,
`qualif_id` int(10) UNSIGNED NOT NULL,
`expire_date` date DEFAULT NULL,
`no_alert` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`ident_value` varchar(255) DEFAULT NULL,
`grant_date` date DEFAULT NULL,
PRIMARY KEY (`member_id`,`qualif_id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='QUALIFICATIONS OF EACH MEMBER';

CREATE TABLE IF NOT EXISTS `nationality` (
`code` char(2) NOT NULL DEFAULT '',
`label` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
PRIMARY KEY (`code`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `parameter` (
`code` varchar(255) NOT NULL,
`enabled` tinyint(1) UNSIGNED DEFAULT '0',
`int_value` int(10) UNSIGNED DEFAULT '0',
`char_value` varchar(255) DEFAULT NULL,
PRIMARY KEY (`code`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='APPLICATION PARAMETERS';

CREATE TABLE IF NOT EXISTS `payment_distribution` (
`payment_id` int(10) UNSIGNED DEFAULT NULL,
`account_club_id` int(10) UNSIGNED DEFAULT NULL,
`person_delivery` tinyint(1) UNSIGNED DEFAULT '0'
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='payment distribution description';

CREATE TABLE IF NOT EXISTS `payment_type` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` text CHARACTER SET latin1,
`text_field_label` text CHARACTER SET latin1,
`supplier` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`only_admin` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='type of payment description';

CREATE TABLE IF NOT EXISTS `pilot_function` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`abbrev` varchar(10) CHARACTER SET latin1 DEFAULT NULL,
`name` varchar(100) CHARACTER SET latin1 DEFAULT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of functions for pilot';

CREATE TABLE IF NOT EXISTS `pricing_value` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`variable_id` int(11) NOT NULL,
`assign_value` decimal(10,2) NOT NULL,
`start_date` datetime NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `pricing_variable` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`variable` varchar(255) CHARACTER SET latin1 NOT NULL,
`label` varchar(255) CHARACTER SET latin1 NOT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `profile` (
`id` int(10) UNSIGNED NOT NULL DEFAULT '0',
`name` varchar(255) DEFAULT NULL,
`permits` int(10) UNSIGNED DEFAULT NULL,
`permits2` int(10) UNSIGNED NOT NULL DEFAULT '0',
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `psp_transaction` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`credit_account_id` int(10) UNSIGNED NOT NULL,
`debit_account_id` int(10) UNSIGNED NOT NULL,
`transaction_date` datetime NOT NULL,
`amount` float NOT NULL,
`description` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`payment_type_id` int(10) UNSIGNED NOT NULL,
`state` int(10) UNSIGNED NOT NULL DEFAULT '0',
`bank_answer` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
`bank_misc` varchar(255) CHARACTER SET latin1 DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `qualification` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`name` varchar(255) NOT NULL,
`time_limitation` tinyint(1) NOT NULL DEFAULT '0',
`ident_value_enable` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`grant_date_enable` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`is_for_instructor` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`mandatory` tinyint(1) UNSIGNED NOT NULL DEFAULT '0',
`experience_formula` varchar(255) DEFAULT NULL,
`order_num` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='QUALIFICATIONS LIST';

CREATE TABLE IF NOT EXISTS `regular_presence_inst_date` (
`instructor_id` int(10) UNSIGNED DEFAULT NULL,
`start_day` tinyint(3) UNSIGNED DEFAULT NULL,
`end_day` tinyint(3) UNSIGNED DEFAULT NULL,
`start_hour` time DEFAULT NULL,
`end_hour` time DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `sale` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`entry_id` int(10) UNSIGNED DEFAULT NULL,
`unit_price` float DEFAULT NULL,
`quantity` float DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of sales';

CREATE TABLE IF NOT EXISTS `tank` (
`id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`aircraft_type_id` int(10) UNSIGNED NOT NULL,
`tank_type_id` int(10) UNSIGNED NOT NULL,
`unit_id` int(10) UNSIGNED NOT NULL,
`label` varchar(255) CHARACTER SET latin1 NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

CREATE TABLE IF NOT EXISTS `uncomp_flight_type` (
`id1` int(10) UNSIGNED DEFAULT NULL,
`id2` int(10) UNSIGNED DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='List of sales';</sql>

Accueil

2017-06-08T11:21:57Z

Jcheng : /* Documentation Webmasters et Développeurs */

[[File:2013-OF4-launch.gif|right|link=OF_doc4-fr:Montée-de-version]]

Bienvenue sur la documentation de la '''version 1''' d'OpenFlyers.

Cette version est obsolète. Les versions en vigueurs sont les versions 3 et 4.

Vous pouvez retrouver leur documentation sur les pages suivantes :
*[[OF_doc3-fr:Accueil|Documentation OpenFlyers version 3]]
*[[OF_doc4-fr:Accueil|Documentation OpenFlyers version 4]]

You can also access to our [[OF_doc-en:Main-Page2|english documentation]].

=FAQ=
*[[FAQ client|FAQ clients]]
*[[FAQ utilisateur|FAQ utilisateur]]
*[[FAQ administrateur 2.0|FAQ administrateur version 2.0]]
*[[FAQ administrateur|FAQ administrateur]]
*[[FAQ comptabilité|FAQ comptabilité]]
*[[FAQ export]]
*[[FAQ AeroBox]]

=Documentation Administrateurs=
*[[Documentation administrateur|Documentation administrateur]]
*[[Liste de diffusion|Gérer une liste de diffusion sur OpenFlyers]]
*[[Formules de calcul|Formules de calcul]]

==Comptabilité==
*[[Use-Accounting2.1|Utilisation de la comptabilité sur version 2.1]]

===Facturation client===
*[[Gestion des ventes|Gestion des ventes version]]

===FAQ comptabilité===
*[[FAQ comptabilité|FAQ comptabilité version]]

==Maintenance==
*[[Maintenance aéronautique|Maintenance aéronautique]]
*[[Suivi de navigabilité|Suivi de la navigabilité]]

===Requêtes permettant de générer des rapports===
*[[OF_doc-en::Export generator 2.0|Génération d'export version 2.0]]
*[[OF_doc-en::Export generator 2.1|Génération d'export version]]

=Documentation Utilisateurs=
*[[Documentation utilisateur 2.0|Documentation utilisateur version 2.0]]
*[[Documentation utilisateur|Documentation utilisateur]]

=[[OF_wiki:|Documentation Webmasters et Développeurs]]=
*[[Contrôle d'identification par OpenFlyers pour un logiciel tiers]]
*[[Structure de la base de données]]

=[[BTS|Rapporter des bugs]]=

=[[Trucs et astuces|Trucs et astuces]]=
==[[Kiosque PC|Mettre en place un PC kiosque]]==
==[[Réseau Internet hybride|Mettre en place un réseau internet hybride]]==

Fichier:Joomla_authentication_plugin.zip

2016-06-16T07:31:55Z

Jcheng :

WIKI

2016-03-07T12:03:31Z

Jcheng :

{| class="wikitable"
|-
!Inter-lien!!URL Wiki!!Exemple
|-
|OF_doc-de||https://doc-de.openflyers.com||[[OF_doc-de:Hauptseite]]
|-
|OF_doc-en||https://doc-en.openflyers.com||[[OF_doc-en:Main-Page]]
|-
|OF_doc-es||https://doc-es.openflyers.com||[[OF_doc-es:Página-principal]]
|-
|OF_doc1-fr||https://doc1-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc2-fr||https://doc2-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc3-fr||https://doc3-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc4-fr||https://doc4-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_wiki||https://wiki.openflyers.org||[[OF_wiki:Main-Page]]
|-
|Wikipedia-en||http://en.wikipedia.org||[[Wikipedia-en:Main_Page]]
|-
|Wikipedia-es||http://es.wikipedia.org||[[Wikipedia-es:Main_Page]]
|-
|Wikipedia-fr||http://fr.wikipedia.org||[[Wikipedia-fr:Main_Page]]
|-
|}

WIKI

2016-03-02T14:17:32Z

Jcheng :

{| class="wikitable"
|-
!Inter-lien!!URL Wiki!!Exemple
|-
|OF_doc-de||http://doc-de.openflyers.com||[[OF_doc-de:Hauptseite]]
|-
|OF_doc-en||http://doc-en.openflyers.com||[[OF_doc-en:Main-Page]]
|-
|OF_doc-es||http://doc-es.openflyers.com||[[OF_doc-es:Página-principal]]
|-
|OF_doc-fr||http://doc-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc1-fr||http://doc1-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc2-fr||http://doc2-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc3-fr||http://doc3-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_doc4-fr||http://doc4-fr.openflyers.com||[[OF_doc-fr:Accueil]]
|-
|OF_wiki||http://wiki.openflyers.org||[[OF_wiki:Main-Page]]
|-
|Wikipedia-en||http://en.wikipedia.org||[[Wikipedia-en:Main_Page]]
|-
|Wikipedia-es||http://es.wikipedia.org||[[Wikipedia-es:Main_Page]]
|-
|Wikipedia-fr||http://fr.wikipedia.org||[[Wikipedia-fr:Main_Page]]
|-
|}

Utilisateur:Jcheng

2016-03-02T10:27:40Z

Jcheng : Page créée avec « 2 »

WIKI

2016-02-15T14:26:41Z

Jcheng :

{| class="wikitable"
|-
!Inter-lien!!URL Wiki!!Exemple
|-
|OF_doc-de||http://doc-de.openflyers.com||[[OF_doc-de:Main_Page]]
|-
|OF_doc-en||http://doc-en.openflyers.com||[[OF_doc-en:Main_Page]]
|-
|OF_doc-es||http://doc-es.openflyers.com||[[OF_doc-es:P%C3%A1gina_principal]]
|-
|OF_doc-fr||http://doc-fr.openflyers.com||[[OF_doc-fr:Main_Page]]
|-
|OF_wiki||http://wiki.openflyers.org||[[OF_wiki:Main_Page]]
|-
|Wikipedia-en||http://en.wikipedia.org||[[Wikipedia-en:Main_Page]]
|-
|Wikipedia-es||http://es.wikipedia.org||[[Wikipedia-es:Main_Page]]
|-
|Wikipedia-fr||http://fr.wikipedia.org||[[Wikipedia-fr:Main_Page]]
|-
|}

Formules de calcul

2016-01-11T08:41:03Z

Jcheng : /* getSex('person id') */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getSex('person id')===

Retourne un nombre correspondant au sexe de la personne :
* 0 pour un homme
* 1 pour une femme
* 2 lorsque ce n'est pas défini

Exemple :
<pre>getSex(1)
getSex(%USER_ID)</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id', 'check only holding')===
'check only holding' est un paramètre optionnel. On ne prend en compte sa valeur que si elle est à 1. Dans les autres cas, on l'ignore.

*Si 'check only holding' n'est pas à 1 :
** Retourne '''1''' lorsque :
*** Si c'est une validité à formule d'expérience récente :
**** l'utilisateur a l'expérience requise
*** Si ce n'est pas une validité à formule d'expérience récente :
**** Si la validité n'est pas soumise à échéance alors l'utilisateur possède la validité
**** Si La validité est soumise à échéance alors l'utilisateur possède la validité et elle n'est pas encore expirée
** Retourne '''0''' dans les autres cas
*Si 'check only holding' est à 1 :
** Retourne '''1''' lorsque :
*** Si ce n'est pas une validité à formule d'expérience récente :
**** L'utilisateur possède la validité
** Retourne '''0''' dans les autres cas (y compris dans le cas d'une validité à formule d'expérience récente et que l'utilisateur possède l'expérience récente)

===max(X,Y)===
Retourne le maximum entre X et Y

===min(X,Y)===
Retourne le minimum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===<s>%TIME_DEPARTURE</s>===
<s>Heure de début saisie dans le formulaire</s>

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul du compte d'export==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]
*[[#.25USER_ID|%USER_ID]]

==Exemples de formules pour le calcul du compte d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+sprintf('%03s', %USER_ID)||Comptes utilisateurs||411001, 411002, etc.
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#min.28X.2CY.29|min]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2016-01-11T08:39:32Z

Jcheng : /* getValidityExpiredDate('person id', 'validity type id') */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getSex('person id')===

Retourne un nombre correspondant au sexe de la personne :
* 0 pour un homme
* 1 pour une femme
* 2 lorsque ce n'est pas défini

Exemple :
<pre>getSex(%USER_ID)</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id', 'check only holding')===
'check only holding' est un paramètre optionnel. On ne prend en compte sa valeur que si elle est à 1. Dans les autres cas, on l'ignore.

*Si 'check only holding' n'est pas à 1 :
** Retourne '''1''' lorsque :
*** Si c'est une validité à formule d'expérience récente :
**** l'utilisateur a l'expérience requise
*** Si ce n'est pas une validité à formule d'expérience récente :
**** Si la validité n'est pas soumise à échéance alors l'utilisateur possède la validité
**** Si La validité est soumise à échéance alors l'utilisateur possède la validité et elle n'est pas encore expirée
** Retourne '''0''' dans les autres cas
*Si 'check only holding' est à 1 :
** Retourne '''1''' lorsque :
*** Si ce n'est pas une validité à formule d'expérience récente :
**** L'utilisateur possède la validité
** Retourne '''0''' dans les autres cas (y compris dans le cas d'une validité à formule d'expérience récente et que l'utilisateur possède l'expérience récente)

===max(X,Y)===
Retourne le maximum entre X et Y

===min(X,Y)===
Retourne le minimum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===<s>%TIME_DEPARTURE</s>===
<s>Heure de début saisie dans le formulaire</s>

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul du compte d'export==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]
*[[#.25USER_ID|%USER_ID]]

==Exemples de formules pour le calcul du compte d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+sprintf('%03s', %USER_ID)||Comptes utilisateurs||411001, 411002, etc.
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#min.28X.2CY.29|min]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Accueil

2015-10-20T07:50:12Z

Jcheng : /* Découvrir le logiciel OpenFlyers */

[[File:2013-OF4-launch.gif|right|link=Upgrade4]]
[[Upgrade4|Découvrir OpenFlyers 4]]

Bienvenue sur la [[Accueil|documentation]] d''''OpenFlyers version 2'''.

You can also access to our [[OF_doc-en:Main_Page2|english documentation]].

__TOC__

=Présentation=
==[[Introduction|La suite logicielle OpenFlyers]]==
===[[Discover OpenFlyers software3|Découvrir le logiciel OpenFlyers]]===

==[[Geolocation technologies for aerospace|Les technologies de géolocalisation pour l'aéronautique]]==

=[[Getting started with OpenFlyers|Bien débuter avec OpenFlyers]]=

=[[Créer une plateforme OpenFlyers pour sa structure|Créer une plateforme OpenFlyers pour sa structure]]=

=[[OpenFlyers Trainings|Formations OpenFlyers]]=

=[[How to communicate with OpenFlyers|Bien communiquer avec OpenFlyers]]=

=[[OpenFlyers release history|Historique des versions]]=

=[[Browsers_compatibility|Compatibilité des navigateurs]]=

=[[Modèle commercial et compte client OpenFlyers]]=

=FAQ=
*[[FAQ client|FAQ clients]]
*[[FAQ user2.1|FAQ utilisateur version 2.1]]
*[[FAQ admin2.0|FAQ administrateur version 2.0]]
*[[FAQ admin2.1|FAQ administrateur version 2.1]]
*[[FAQ accounting2.1|FAQ comptabilité version 2.1]]
*[[FAQ export]]
*[[FAQ AeroBox]]

=Documentation Administrateurs=
*[[adminDoc2.1|Documentation administrateur version 2.1]]
*[[mailingList|Gérer une liste de diffusion sur OpenFlyers]]
*[[Formula_pool|Formules de calcul]]

==Comptabilité==
*[[account|Généralités sur la comptabilité]]
*[[Accounting_Specic_Advise|Conseils spécifiques]]
*[[accounting entries|Les écritures comptables]]
*[[Compte de résultats]]
*[[Use_Accounting2.1|Utilisation de la comptabilité sur version 2.1]]
*[[OF_doc-en::Accounting_export_template_list|Template de format d'export comptable]]
*[[ODT_bill_template|Template ODT pour les factures]]

===Facturation client===
*[[admin_sale_manager2.1|Gestionnaire des ventes version 2.1]]

===FAQ comptabilité===
*[[FAQ accounting2.1|FAQ comptabilité version 2.1]]

==Maintenance==
*[[MRO|Généralités sur la maintenance]]
*[[MRO2.1|Suivi de la navigabilité version 2.1]]

===Requêtes permettant de générer des rapports===
*[[OF_doc-en::Export generator 2.0|Génération d'export version 2.0]]
*[[OF_doc-en::Export generator 2.1|Génération d'export version 2.1]]

=Documentation Utilisateurs=
*[[userDoc2.0|Documentation utilisateur version 2.0]]
*[[userDoc2.1|Documentation utilisateur version 2.1]]
*[[user_sale_manager3|Gestionnaire des ventes]]

=[[OF_wiki:|Documentation Webmasters et Développeurs]]=

=[[BTS|Rapporter des bugs]]=

=[[Tips-and-tricks|Trucs et astuces]]=
==[[Kiosk|Mettre en place un PC kiosque]]==
==[[Hybrid internet network|Mettre en place un réseau internet hybride]]==

Formules de calcul

2015-08-26T12:01:11Z

Jcheng : /* Fonctions autorisées pour le calcul du temps d'activité */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===min(X,Y)===
Retourne le minimum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===<s>%TIME_DEPARTURE</s>===
<s>Heure de début saisie dans le formulaire</s>

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#min.28X.2CY.29|min]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-26T11:59:26Z

Jcheng : /* max(X,Y) */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===min(X,Y)===
Retourne le minimum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===<s>%TIME_DEPARTURE</s>===
<s>Heure de début saisie dans le formulaire</s>

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-04T08:10:37Z

Jcheng : /* %TIME_DEPARTURE */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===<s>%TIME_DEPARTURE</s>===
<s>Heure de début saisie dans le formulaire</s>

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-04T08:10:20Z

Jcheng : /* %TIME_ARRIVAL */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===<s>%TIME_ARRIVAL</s>===
<s>Heure de fin saisie dans le formulaire</s>

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-04T08:09:53Z

Jcheng : /* Variables autorisées pour le calcul de la tarification */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

* [[#.25START_DATE|%START_DATE]]

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-04T08:08:30Z

Jcheng : /* %START_DATE */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%START_DATE===

Date de début du vol ou date d'achat de produit au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-08-04T08:04:09Z

Jcheng : /* %USER_ID */

Cette page à pour objet de présenter l'ensemble des fonctions et variables utilisables dans des formules de calculs d'OpenFlyers ainsi que les différents types de formules de calculs.
__TOC__

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01') donne 2015</pre>
<pre>formatDate('MM', '2015-03-01') donne 03</pre>
<pre>formatDate('d', '2015-03-01') donne 1</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%START_DATE===

Date de début du vol au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes utilisateurs'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc. '''c'est le modèle recommandé par OpenFlyers et proposé par défaut pour les comptes ressources'''
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

===Fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<php>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</php>

===Type d'activité X dans les 12 derniers mois===
L'exemple suivant vérifie si un utilisateur a effectué une activité d'un type X donné dans les 365 derniers jours.

Remplacer dans l'exemple suivant XX par l'identifiant du type d'activité donné :

<php>sumFlightTime(%PILOT, formatDate('yyyy', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('M', changeTime( %NOW_DATE, '-1', '0', '0' )), formatDate('d', changeTime( %NOW_DATE, '-1', '0', '0' )), 00, 00, 0, XX ) > 0</php>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T12:04:32Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_format|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T12:04:08Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#sprintf_pattern|format de sprintf]].

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T12:00:30Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir ...

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière :
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant :
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T11:50:32Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir ...

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible devant
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 5 caractères en ajoutant autant de zéro que possible derrière
<php>sprintf('%-05d', %MEMBER_NUM) retourne 10000 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater le numéro de membre pour qu'il ait 6 caractères en ajoutant autant d'espace que possible devant
<php>sprintf('%6s', %MEMBER_NUM) retourne " 10" si %MEMBER_NUM vaut 10 par exemple</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T11:43:13Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern". Pour les motifs du patron, voir ...

Exemple :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater un nombre décimaux sur deux chiffres après la virgule
<php>sprintf('%0.2f', 0.5) retourne 0.50</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible devant
<php>sprintf('%05d', 9) retourne 00009</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible derrière
<php>sprintf('%-05d', 9) retourne 90000</php>

Exemple pour formater une chaîne afin qu'elle ait 6 caractères en ajoutant autant d'espace que possible devant
<php>sprintf('%6s', 'test') retourne " test"</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T11:40:18Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern".

Exemple :
<php>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</php>

Exemple pour formater un nombre décimaux sur deux chiffres après la virgule
<php>sprintf('%0.2f', 0.5) retourne 0.50</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible devant
<php>sprintf('%05d', 9) retourne 00009</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible derrière
<php>sprintf('%-05d', 9) retourne 90000</php>

Exemple pour formater une chaîne afin qu'elle ait 6 caractères en ajoutant autant d'espace que possible devant
<php>sprintf('%6s', 'test') retourne " test"</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-10T11:39:15Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec le patron "pattern".

Exemple :
<pre>sprintf('%05s', %MEMBER_NUM) retourne 00010 si %MEMBER_NUM vaut 10 par exemple</pre>

Exemple pour formater un nombre décimaux sur deux chiffres après la virgule
<php>sprintf('%0.2f', 0.5) retourne 0.50</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible devant
<php>sprintf('%05d', 9) retourne 00009</php>

Exemple pour formater un nombre pour qu'il ait 5 chiffres en ajoutant autant de zéro que possible derrière
<php>sprintf('%-05d', 9) retourne 90000</php>

Exemple pour formater une chaîne afin qu'elle ait 6 caractères en ajoutant autant d'espace que possible devant
<php>sprintf('%6s', 'test') retourne " test"</php>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|-
|7061+sprintf('%02s', %RESOURCE_ID)||Comptes ressources||706101, 706102, etc.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T14:40:19Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec un patron.

Exemple :
<pre>sprintf('%05s', %MEMBER_NUM') returns 00100</pre>

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T14:39:07Z

Jcheng : /* Fonctions autorisées pour le calcul du compte d'export */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec un patron.

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#sprintf.28.27pattern.27.2C_.27string.27.29|sprintf]]
*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T14:18:12Z

Jcheng : /* sprintf('pattern', 'string') */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate la chaîne "string" avec un patron.

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T14:17:45Z

Jcheng : /* substr(string,a,b) */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sprintf('pattern', 'string')===

Formate une chaîne avec un patron.

===substr(string,a,b)===
Retourne l'extrait de chaîne de caractères "string" à partir du caractère "a", 0 étant le 1er caractère et "b" la longueur à extraire. Lorsque b est une valeur négative, alors il détermine le nombre de caractères devant être enlevé depuis la fin de la chaîne.

Exemples :
<pre>substr('FIRST_NAME', 0, 5) returns FIRST
substr('FIRST_NAME', 0, -2) returns FIRST_NA</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===
Retourne le total des heures de vol faite par un pilote %PILOT pour le type de vol 'flight type' Depuis la date indiquée.

La position 0 correspond au 1er pilote, la position 1 au 2ème pilote.

Si le type de vol n'est pas spécifié, le total est déterminé pour tous les types de vols.

Exemple :
<pre>sumFlightTime(%PILOT, 2008, 01, 01, 00, 00, 0, 64 )</pre>
Retourne en [[#D.C3.A9finition_Unit.C3.A9_sexacentimal|Sexacentimal]] le total des heures de vol faites sur le type de vol 64 en tant que pilote en place gauche depuis le 2008-01-01 00:00:00.

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===strtolower(string)===
Retourne la chaine "string" en minuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "camelback"</pre>

===strtoupper(string)===
Retourne la chaine "string" en majuscule.

Exemple :
<pre>strtolower('CamelBack') retourne "CAMELBACK"</pre>

==Variables==
===%ACCOUNT_TYPE===
Type de compte

===%AUTHENTICATION_LOGIN===
Identifiant utilisateur

===%AUTO_INCREMENT===
Valeur auto-incrémentale

===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%FIRSTNAME===
Prénom de l'utilisateur

===%LASTNAME===
Nom de l'utilisateur

===%MEMBER_NUM===
Numéro de membre

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%RESOURCE_NAME===
Nom de la ressource

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Compte d'export=

==Fonctions autorisées pour le calcul du compte d'export==

*[[#substr.28string.2Ca.2Cb.29|substr]]
*[[#strtolower.28string.29|strtolower]]
*[[#strtoupper.28string.29|strtoupper]]

==Variables autorisées pour le calcul de la date d'expiration==
*[[#.25ACCOUNT_TYPE|%ACCOUNT_TYPE]]
*[[#.25AUTHENTICATION_LOGIN|%AUTHENTICATION_LOGIN]]
*[[#.25AUTO_INCREMENT|%AUTO_INCREMENT]]
*[[#.25FIRSTNAME|%FIRSTNAME]]
*[[#.25LASTNAME|%LASTNAME]]
*[[#.25MEMBER_NUM|%MEMBER_NUM]]
*[[#.25RESOURCE_NAME|%RESOURCE_NAME]]

==Exemples de patrons de comptes d'export==
{| class="wikitable sortable centre"
!Formule de calcul!!Usage!!Exemples de génération
|-
|411+%ACCOUNT_TYPE||Comptes ressources et utilisateurs||4110002, 4110005
|-
|411+%AUTHENTICATION_LOGIN||Comptes utilisateurs||411pdupont '''c'est le modèle recommandé par OpenFlyers et proposé par défaut'''
|-
|411+%AUTO_INCREMENT||Comptes ressources et utilisateurs||41100001, 41100002, ...., 4110000x
|-
|411+%LASTNAME||Comptes utilisateurs||411dupont, 411dupond
|-
|411+%LASTNAME+substr(%FIRSTNAME,0,1)||Comptes utilisateurs||411dupontp, 411dupontf
|-
|411+%MEMBER_NUM||Comptes utilisateurs||411XXXXX, l'intitulé XXXXXX est le champ Numéro de membre qui est inscrit sur la fiche personnelle de vos adhérents. Exemple : 411001. A vous de vérifier l'unicité de cette valeurs
|-
|411+substr(%AUTHENTICATION_LOGIN,0,3)||Comptes utilisateurs||411pdu 411 suivi de l'identifiant limité à 3 caractères. Cela permet d'être compatible avec les logiciels de comptabilités paramétrés pour n'accepter que 6 caractères. Dans ce cas, il est nécessaire de modifier les comptes d'exports en doublon.
|}

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant l'expérience récente en heures ou la détention d'une validité spécifique===
L'exemple suivant vérifie qu'un utilisateur a une expérience de 30 heures dans les 12 derniers mois ou qu'il possède une validité X lui permettant de s'affranchir du quota d'heures.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité spécifique :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:09:28Z

Jcheng : /* Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise===

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:08:05Z

Jcheng : /* Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise===

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX)</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:07:52Z

Jcheng : /* Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise===

Remplacer dans l'exemple suivant XX par l'identifiant du type de validité concerné :

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, XX)</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:07:29Z

Jcheng : /* Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, XX) ? getValidityExpiredDate(%USER_ID, 3XX3) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise===

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, 16) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:07:00Z

Jcheng : /* Formule calculant si le pilote a effectué le nombre de vol requis ou s'il a la validité requise */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, 33) ? getValidityExpiredDate(%USER_ID, 33) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule vérifiant que le pilote a effectué le nombre d'heures de vol requis ou qu'il possède la validité requise===

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, 16) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:01:50Z

Jcheng : /* Exemples de formules de calcul de l'expérience récente */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, 33) ? getValidityExpiredDate(%USER_ID, 33) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

===Formule calculant si le pilote a effectué le nombre de vol requis ou s'il a la validité requise===

<pre>( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, 16) )</pre>

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T09:00:05Z

Jcheng : /* Variables autorisées pour le calcul de l'expérience récente */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, 33) ? getValidityExpiredDate(%USER_ID, 33) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

* [[#.25NOW_DATE|%NOW_DATE]]

==Exemples de formules de calcul de l'expérience récente==

( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, 16) )

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T08:59:12Z

Jcheng : /* Exemples de formules de calcul de l'expérience récente */

=Présentation=

==Fonctions==

===abs(X)===
Retourne la valeur absolue de X

Exemple :
<pre>abs(-200) donne 200</pre>
<pre>abs(100) donne 100</pre>

===changeTime('date', 'année', 'mois', 'jour')===
Retourne la date en changeant l'année, le mois et/ou le jour

La date doit être au format '''AAAA-MM-JJ hh:mm:ss''' ou '''AAAA-MM-JJ'''

Les valeurs possibles pour l'année, le mois ou le jour sont :
* 0 = L'année, le mois ou le jour reste inchangé
* +X = L'année, le mois ou le jour est augmenté de X
* -X = L'année, le mois ou le jour est diminué de X
* X = L'année, le mois ou le jour est placé sur X

Exemple :
<pre>changeTime( '2011-05-15', '0', '0', '0' ) donne 2011-05-15</pre>
<pre>changeTime( '2011-05-15', '0', '-test', '0' ) donne 2011-05-15 car la valeur du mois n'est pas valide</pre>
<pre>changeTime( '2011-05-15', '0', '-2', '0' ) donne 2011-03-15</pre>
<pre>changeTime( '2011-05-15', '0', '+2', '0' ) donne 2011-07-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '0' ) donne 2011-02-15</pre>
<pre>changeTime( '2011-05-15', '0', '2', '-1' ) donne 2011-02-14</pre>
<pre>changeTime( %NOW_DATE, '2015', '1', '1' ) donne 2015-01-01</pre>

===formatDate('patron', 'date')===

Formate la date selon le patron. Pour les motifs du patron, voir [[OF_doc-en::CommonFormula#Date_and_time_format|format de date et d'heure]]

Exemple :
<pre>formatDate('yyyy', '2015-03-01) donne 2015</pre>
<pre>formatDate('MM', '2015-03-01) donne 3</pre>

===getValidityExpiredDate('person id', 'validity type id')===

* Retourne la date d'expiration de la validité de la personne si c'est une validité soumise à échéance et que la date d'expiration a été renseigné. La date est au format AAAA-MM-JJ.
* Retourne "0000-00-00" dans les autres cas

Exemple :
<pre>getValidityExpiredDate(%USER_ID, 1) donne 2014-12-31</pre>
<pre>getValidityExpiredDate(0, 20) donne 0000-00-00</pre>

===hasValidity('user id', 'validity type id')===

Vérifie si l'utilisateur possède la validité :
* Retourne '''1''' lorsque :
** C'est une validité à formule d'expérience récente et l'utilisateur a l'expérience requise
** La validité n'est pas soumise à échéance et que l'utilisateur possède la validité
** La validité est soumise à échéance et n'est pas encore expirée
* Retourne '''0''' dans les autres cas

===max(X,Y)===
Retourne le maximum entre X et Y

===roundCeil(X,Y)===
Arrondi la valeur X au nombre supérieur multiple de l'unité Y le plus proche

Exemple :
<pre>roundCeil(114,100) donne 200</pre>

<pre>roundCeil(114,10) donne 120</pre>

===sumFlightHour('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumFlightTime(%PILOT, 'year', 'month', 'day', 'hour', 'minute', 'position', 'flight type' )===

===sumLandingNumber('pilot id', 'position', 'day', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

===sumPreviousFlightTime('pilot id', 'position', 'day', 'endingDate', 'aircraft type 1' , 'aircraft type 2', 'aircraft type X')===

==Variables==
===%COUNTER_ARRIVAL===
Compteur arrivé saisi dans le formulaire

===%COUNTER_DEPARTURE===
Compteur départ saisi dans le formulaire

===%DURATION===
Durée du vol

===%NOW_DATE===
Date courante au format '''AAAA-MM-JJ hh:mm:ss'''

Par exemple : 2015-03-31 14:20:03

===%TIME_ARRIVAL===
Heure de fin saisie dans le formulaire

===%TIME_DEPARTURE===
Heure de début saisie dans le formulaire

===%USER_ID===

Id de l'utilisateur

=Date d'expiration=
==Fonctions autorisées pour le calcul de la date d'expiration==

* [[#changeTime.28.27date.27.2C_.27ann.C3.A9e.27.2C_.27mois.27.2C_.27jour.27.29|changeTime]]
* [[#formatDate.28.27patron.27.2C_.27date.27.29|formatDate]]
* [[#getValidityExpiredDate.28.27person_id.27.2C_.27validity_type_id.27.29|getValidityExpiredDate]]
* [[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]

==Variables autorisées pour le calcul de la date d'expiration==

* [[#.25NOW_DATE|%NOW_DATE]]
* [[#.25USER_ID|%USER_ID]]

==Exemples de formules de calcul de la date d'expiration==

===Date fixe===
<pre>2012-12-31</pre>

===Formule calculant la fin de l'année courante===
<pre>formatDate( 'yyyy-12-31', %NOW_DATE )</pre>

===Formule calculant la fin de l'année courante ou la fin de l'année suivante si la date courante est strictement supérieure au 30 septembre===
Cette formule permet de vendre une validité (par exemple cotisation) dont la prise est valable jusqu'au 31 décembre de l'année en cours ou de l'année suivante si elle est souscrite à partir du 1er octobre.

<pre>formatDate( 'yyyy-12-31', (formatDate('MM', %NOW_DATE)<10) ? %NOW_DATE : changeTime(%NOW_DATE, '+1', 0, 0) )</pre>

===Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue===
Cette formule permet de vendre une validité (par exemple une carte de réduction) valable 1 an.

Remplacer dans l'exemple suivant XX par le l'identifiant du type de validité concerné :
<pre>formatDate( 'yyyy-MM-dd', changeTime( ( hasValidity(%USER_ID, 33) ? getValidityExpiredDate(%USER_ID, 33) : %NOW_DATE ), '+1', '0', '0' ) )</pre>

=Expérience récente=
==Fonctions autorisées pour le calcul de l'expérience récente==
*[[#hasValidity.28.27user_id.27.2C_.27validity_type_id.27.29|hasValidity]]
*[[#sumFlightHour.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumFlightHour]]
*[[#sumFlightTime.28.25PILOT.2C_.27year.27.2C_.27month.27.2C_.27day.27.2C_.27hour.27.2C_.27minute.27.2C_.27position.27.2C_.27flight_type.27_.29|sumFlightTime]]
*[[#sumLandingNumber.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumLandingNumber]]
*[[#sumPreviousFlightTime.28.27pilot_id.27.2C_.27position.27.2C_.27day.27.2C_.27endingDate.27.2C_.27aircraft_type_1.27_.2C_.27aircraft_type_2.27.2C_.27aircraft_type_X.27.29|sumPreviousFlightTime]]

==Variables autorisées pour le calcul de l'expérience récente==

==Exemples de formules de calcul de l'expérience récente==

( (sumFlightHour(%PILOT, 0, 365)+sumFlightHour(%PILOT, 1, 365) > 17999) OR hasValidity(%PILOT, 16) )

=Tarification=
Outre les définitions toujours valides pour le calcul du temps d'activité, voici d'autres définitions :
''A rédiger''

Voir [http://doc-en.openflyers.com/index.php?title=AdminDoc2.1 Formules en anglais]

==Fonctions autorisées pour le calcul de la tarification==

==Variables autorisées pour le calcul de la tarification==

==Exemples de formules pour le calcul de la tarification==
===Motoplaneur : tarification à l'heure de vol ET à l'utilisation du moteur===
Pour cela, on suppose que les compteurs sont utilisés et qu'ils prennent en compte le temps d'utilisation du moteur :
%DURATION * $FLIGHT_HOUR_PRICE + (%COUNTER_ARRIVAL - %COUNTER_DEPARTURE) * $ENGINE_HOUR_PRICE

===Avion : réduction lorsque le compte pilote a un solde positif===
$C2 concerne le tarif horaire de l'avion 
$S le solde positif qui doit être atteint pour bénéficier de la réduction 
$R le montant horaire de la réduction obtenue dans ce cas 

roundCeil((((getBalance(%PILOT)>$S ? ($C2-$R) : $C2)*%DURATION/600)-0.5),1)

===Avion : réduction lorsque le vol se fait après une certaine heure===

$C2 concerne le tarif horaire de l'avion 
$C2R concerne le tarif horaire réduit de l'avion après une certaine heure 
659 correspond à 06:59 en temps UTC 
Dans ce cas la formule considère que dès 700, la réduction s'applique. 

roundCeil(((((formatDate('hmm',%START_DATE)>659)?$C2R:$C2)*%DURATION/600)-0.5),1)

=Temps d'activité=
Pour calculer le temps d'une activité (exemple : vol), les règles diffèrent selon les structures.

OpenFlyers permet d'attribuer des formules de calcul de temps d'activité par type de ressource. Cf. la gestion des types de ressource sur [[Resource-management3#Ajouter_un_type_de_ressource|version 3]] et [[Resource-management4#Ajouter_un_type_de_ressource|version 4]].

==Définition Unité sexacentimal==
En base de données, les temps et les compteurs sont stockés selon le plus petit multiple commun au système décimal (centième) et au système sexagésimale (hh min). Nous avons appelé cela le format ''sexacentimal''.

Cela permet de stocker les valeurs de temps sous la forme d'un entier. Cela supprime donc tout problème d'arrondi qui pourrait être problématique pour les additions.

*1 heure = 600 sexacentièmes
*1 minute = 10 sexacentièmes
*5 minutes = 50 sexacentièmes

*1 centième de minute = 6 sexacentièmes
*10 centième de minute (=1 dixième de minute) = 60 sexacentièmes

Exemples de formules :
*pour arrondir à 5 minutes : roundCeil(X,50)
*pour arrondir à 10 centièmes : roundCeil(X,60)

==Fonctions autorisées pour le calcul du temps d'activité==
*[[#abs.28X.29|abs]]
*[[#max.28X.2CY.29|max]]
*[[#roundCeil.28X.2CY.29|roundCeil]]

==Variables autorisées pour le calcul du temps d'activité==
*[[#.25COUNTER_ARRIVAL|%COUNTER_ARRIVAL]]
*[[#.25COUNTER_DEPARTURE|%COUNTER_DEPARTURE]]
*[[#.25DURATION|%DURATION]]
*[[#.25TIME_ARRIVAL|%TIME_ARRIVAL]]
*[[#.25TIME_DEPARTURE|%TIME_DEPARTURE]]

==Exemples de formules de calcul du temps d'activité==
===Durée saisie===
<pre>%DURATION</pre>

===Différence des compteurs saisis===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE</pre>

===Durée saisie arrondie à 5 minutes===
<pre>roundCeil(%DURATION, 50)</pre>

===Différence des compteurs plus 5 centièmes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 30</pre>

===Différence des compteurs plus 5 minutes ===
<pre>%COUNTER_ARRIVAL - %COUNTER_DEPARTURE + 50</pre>

===Différence des compteurs arrondie au 5 minutes les plus proches plus 5 minutes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE - 25, 50) + 50</pre>

===Différence des compteurs arrondie à 10 centièmes===
<pre>roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 60)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs===
<pre>max(%DURATION, %COUNTER_ARRIVAL - %COUNTER_DEPARTURE)</pre>

===Le plus grand entre la durée du vol et la différence des compteurs arrondie à 5 minutes===
<pre>max(%DURATION,roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote
Puis elle prend le plus grand des deux

===Le plus grand entre la durée saisie, arrondie à 5 minutes, et la différence des compteurs, arrondie à 5 minutes===
<pre>max(roundCeil(%DURATION,50),roundCeil(%COUNTER_ARRIVAL - %COUNTER_DEPARTURE, 50))</pre>
Cette formule calcule :
*la différence des compteurs et l'arrondi à 5 minutes
*la valeur de la durée de vol saisie par le pilote et l'arrondi à 5 minutes
Puis elle prend le plus grand des deux

Formules de calcul

2015-06-09T08:55:10Z

Jcheng : /* Fonctions autorisées pour le calcul de l'expérience récente */

FAQ utilisateur

2015-04-16T13:12:29Z

Jcheng : /* Navigation dans OpenFlyers */

=Connexion=
==Impossible de me connecter à la plateforme OpenFlyers de ma structure aéronautique==
Si vous n'arrivez pas à accéder une plateforme OpenFlyers il faut en rechercher la raison. Voici un certain nombre de questions qui peuvent vous permettre de solutionner votre problème :
*Accédez-vous à la page d'identification de la plateforme OpenFlyers ?
**Si non, alors il faut regarder la FAQ [[#Page_indisponible|Page indisponible]]
*Lorsque vous vous identifiez, avez-vous un message de rejet indiquant que votre identifiant et/ou votre mot de passe ne sont pas corrects ?
**Si oui, alors le problème peut venir du mot de passe qui a changé. Dans ce cas là, vous pouvez ré-initialiser votre mot de passe en suivant la procédure [[#J.27ai_oubli.C3.A9_mon_mot_de_passe.2C_comment_le_r.C3.A9cup.C3.A9rer_.3F|de réinitialisation de mot de passe]]. Cela peut également venir de votre identifiant qui n'est pas bon. Dans ce cas, il faut demander à la personne en charge de la gestion d'OpenFlyers au sein de votre structure aéronautique
*Une fois connecté, revenez-vous sur la page d'identification lorsque vous changez de page ?
**Si oui, alors il faut regarder la [[#A_chaque_fois_que_je_change_de_page.2C_je_reviens_sur_la_page_d.27identification_.3F|procédure de gestion des cookies du navigateur]].
Si vous n'êtes dans aucun des cas répertoriés ci-dessus, alors vous pouvez rapporter votre problème en nous envoyant un e-mail et en décrivant le plus précisément possible le problème que vous rencontrez :
*Navigateur utilisé
*Système d'exploitation
*type de PC, smartphone ou tablette
*Nom du fournisseur d'accès internet
*Actions effectuées
*Message d'erreur s'affichant

==Page indisponible==
Si vous n'arrivez pas à accéder à la plateforme OpenFlyers de votre structure aéronautique. Voici une liste d'actions à effectuer :
*Redémarrer votre ordinateur
*Redémarrer la "box" ADSL
*Si cela ne fonctionne toujours pas, il faut [[#Tester_les_r.C3.A9solutions_DNS|tester les résolutions DNS]].
===Tester les résolutions DNS===
Pour effectuer les tests suivants, il faut ouvrir une fenêtre "[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|en ligne de commandes]]". En cas de problème, il faut nous rapporter les résultats en ouvrant un rapport de bug sur le [http://bts.openflyers.ogr BTS]. Pour cela, il est pratique de procéder par [[#Copier.2FColler_dans_une_fen.C3.AAtre_en_ligne_de_commande|copier/coller]].
*Dans la fenêtre en ligne de commande taper ce qui suit (en remplaçant '''structure_aéro''' par le sous-domaine correspondant à votre structure aéronautique) :
<bash>ping structure_aéro.openflyers.fr</bash>
La réponse normale est pour OpenFlyers 3.0 :
Envoi d'une requête 'ping' sur serveur6-of3.openflyers.net [87.98.143.237] avec 32 octets de données :
Réponse de 87.98.143.237 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur6-of3.openflyers.net" ou "Réponse de 87.98.143.237" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 2.1 :
Envoi d'une requête 'ping' sur serveur6-of21.openflyers.net [91.121.47.179] avec 32 octets de données :
Réponse de 91.121.47.179 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur5-of21.openflyers.net" ou "Réponse de 91.121.47.179" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 1.3 :
Envoi d'une requête 'ping' sur serveur6-of1.openflyers.net [178.33.105.217] avec 32 octets de données :
Réponse de 178.33.105.217 : octets=32 temps=41 ms TTL=55
Si vous n'avez pas "serveur6-of1.openflyers.net" ou "Réponse de 178.33.105.217" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].
====Tests plus poussés====
*Faire un :
<bash>nslookup structure_aéro.openflyers.fr</bash>
*Et un :
<bash>tracert structure_aéro.openflyers.fr</bash>
*Faire le test avec '''dig +trace''' :
<bash>dig +trace structure_aéro.openflyers.fr</bash>
Sous Windows, il faudra au préalable récupérer l'utilitaire (par exemple dans un package [http://www.isc.org./downloads bind]). Une fois téléchargé le package, il faut copier/coller le programme dig ainsi que les fichiers .dll dans un répertoire commun et se positionner dans ce répertoire depuis la fenêtre en ligne de commandes avec la commande dir '''"nom du chemin du répertoire"'''.

====Tester les résolutions DNS sous Mac====
De plus, nous disposons de commandes plus puissantes qui permettent d'avoir d'avantage d'informations :
*cat /etc/resolv.conf

===Vérifier la configuration de résolution des DNS===
====Vérifier la configuration de résolution des DNS sous Windows====
Si vous avez un problème de résolution DNS sous windows, il peut être utile de vérifier que la résolution DNS est dynamique :
#Double-cliquer sur la connexion réseau concernée (par exemple le symbole "WIFI")
#Cliquer sur '''Propriétés''' dans l'onglet '''Général''' de l''''Etat de Connexion réseau sans fil''' (si WIFI))
#Sélectionner '''Protocole internet TCP/IP'''
#Cliquer sur '''Propriétés'''
#Vérifier qu'est sélectionné '''Obtenir les adresses des serveurs DNS automatiquement'''. (si ce n'est pas le cas, modifier).
#En dernier ressort, [[#Changer de serveur DNS|Changer de serveur DNS]] ou [[#Forcer_les_DNS|Forcer les DNS]].

===Nous communiquez les adresses IP des serveurs DNS===
====Nous communiquez les adresses IP des serveurs DNS sous Windows====
#[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|Ouvrir une fenêtre en ligne de commande]]
#Taper : '''ipconfig /all'''
Les adresses IP des serveurs DNS se trouvent au droit de '''Serveurs DNS'''

===Changer de serveur DNS===
Si vous rencontrez un problème de résolution de DNS avec votre fournisseur d'accès, vous pouvez changer les serveurs qui effectue la résolution des DNS pour votre accès.
====Changer de serveur DNS sous Mac====
*Dans '''Préférences Systèmes''', choisir '''Réseau''', puis une fois la bonne carte réseau sélectionnée, appuyer sur Avancé.
*Dans la fenêtre qui apparaît, aller sur l'onglet '''DNS''' et dans '''Serveurs DNS''' appuyer sur le + pour ajouter '''8.8.8.8''' et une autre fois pour ajouter '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Il ne reste plus qu'à '''Appliquer''' et à tester.

====Changer de serveur DNS sous Windows XP====
*'''Démarrer > Connexions''' puis cliquer sur la connexion réseau active (par exemple la connexion WIFI)
*Cliquer sur '''Propriétés'''
*Sélectionner '''Protocole Internet (TCP/IP)'''
*Cliquer sur '''Propriétés'''
*En général, en bas de la fenêtre '''Propriétés de Protocole Internet (TCP/IP)''' la configuration active est : '''Obtenir les adresses des serveurs DNS automatiquement'''
*Cocher '''Utiliser l'adresse de serveur DNS suivante :'''
*Pour '''Serveur DNS préféré''', saisir '''8.8.8.8'''
*Pour '''Serveur DNS auxiliaire''', saisir '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Cliquer sur '''OK'''
*Cliquer sur '''OK'''
*Cliquer sur '''Fermer'''

===Forcer les DNS===
====Forcer les DNS sous Windows====
Attention, avec Vista, il faut appliquer une [[#Particularit.C3.A9_avec_Windows_Vista|procédure préalable]].
*Il est possible de résoudre ce problème de DNS en éditant le fichier C:\WINDOWS\system32\drivers\etc\hosts (avec le bloc-notes) en rajoutant la ligne (il faut remplacer structure_aéro par le sous-domaine de l'espace OpenFlyers de votre structure aéronautique) :
**Pour OF 1.3 :
<pre>178.33.105.217 structure_aéro.openflyers.fr</pre>
**Pour OF 2.1 :
<pre>91.121.47.179 structure_aéro.openflyers.fr</pre>
**Pour OF 3.0alpha :
<pre>87.98.143.237 structure_aéro.openflyers.fr</pre>
*Ensuite, il faut relancer votre PC
*Une fois la connexion correctement effectuée, il est parfois possible de supprimer cette entrée dans le fichier hosts tout en gardant la connexion.

====Particularité avec Windows Vista====
*Il faut être administrateur pour pouvoir modifier le fichier hosts.
*Il faut également copier le fichier hosts sur le bureau pour le modifier puis ensuite le recopier dans le bon répertoire (si on édite directement le fichier hosts depuis (system32\drivers\etc\) on ne peut pas le ré-enregistrer).

====Forcer les DNS sous Mac====
*lancer Terminal (dans Applications/Utilitaires)
*taper "sudo nano /etc/hosts" (il demande le mot de passe de l'utilisateur qui a les droits admin sur la machine)
*Ajouter les entrées sur le modèle de la [[#Forcer_les_DNS_sous_Windows|procédure sous Windows]]
*Faire controle-o pour enregistrer puis controle-x pour quitter
*Eventuellement, faire "dscacheutil -flushcache" si le changement n'est pas encore pris en compte.

==A chaque fois que je change de page, je reviens sur la page d'identification ?==
Si le retour à la page d'identification est systématique, alors il doit s'agir d'un problème de '''cookies'''. Il faut modifier la configuration du navigateur de manière à [[#Autoriser_les_cookies|autoriser les cookies]].

===Variante du problème : la déconnexion n'est pas systématique mais aléatoire===
Dans ce cas, il peut s'agir aussi d'un problème de proxy (si vous êtes sur un réseau d'entreprise par exemple) ou de fournisseurs d'accès (accès depuis un mobile, depuis un hôtel, bref, tout type d'accès qui change régulièrement l'adresse IP et ainsi ne permet de maintenir un accès authentifié dans la durée. La solution est présentée dans la procédure [[#Utiliser_OpenFlyers_sur_un_smartphone|Utiliser OpenFlyers sur un smartPhone]].

==Plusieurs membres peuvent-ils ouvrir des sessions en même temps (sans le savoir) ?==
Oui, c'est même le but premier : permettre à plusieurs personnes de consulter en même temps le cahier de réservation.

Vous pouvez même avoir une personne qui ouvre plusieurs sessions avec son identifiant. Mais pour cela, elle doit utiliser des ordinateurs ou des navigateurs différents.
==Suite à une migration, impossible de naviguer dans la nouvelle version d'OpenFlyers==
Lorsque nous migrons d'une version vers une autre, bien souvent nous le faisons en changeant les "DNS". Cela peut occasionner des problèmes d'accès. Il peut également apparaitre des problèmes de "cache" qui se résolvent d'eux sous 24 à 48 heures. Ces problèmes peuvent survenir lorsque l'ordinateur concerné a été connecté à l'ancienne plateforme OpenFlyers juste avant la migration.

Voici différentes techniques qui permettent d'imposer à votre navigateur d'utiliser des DNS actualisées et d'utiliser un cache à jour :
#Penser à éteindre et rallumer complètement l'ordinateur
#Faites un CTRL+R (ou icône de "rafraichissement"). Bien souvent cela suffit au navigateur pour qu'il vide son cache et le ré-actualise
#Vider le cache dans le navigateur
#Supprimer les cookies dans le navigateur
Plus technique :
#Faites un ipconfig /flushdns en ligne de commande (menu démarrer, puis "Exécutez", taper "cmd")
#Forcer les nouvelles DNS dans le fichier C:\WINDOWS\system32\drivers\etc\hosts en ajoutant une ligne du genre : xxx.xxx.xxx.xxx xxx.openflyers.zz (nous demandez pour connaitre les valeurs à utiliser)

De plus, afin de permettre quand même d'accéder à la nouvelle plateforme, nous mettons en place une deuxième URL temporaire pendant 1 semaine. Ainsi pour l'URL plateforme.openflyers.fr nous mettrons en place une URL temporaire plateforme2.openflyers.fr

=Navigation dans OpenFlyers=
OpenFlyers est un logiciel qui s'utilise grâce à votre navigateur internet. Les plus connus sont Chrome, Firefox, Internet Explorer ou Safari.
Une certaine configuration est nécessaire afin de faire fonctionner OpenFlyers : la configuration des cookies.
Si vous rencontrez des problèmes d'utilisations tels que :

*Impossibilité de se connecter alors que votre identifiant et mot de passe est correct
*Impossibilité d'aller d'un page à l'autre une fois connecté (et retour sur la page de connexion)

Voila comment régler votre navigateur.

==[https://support.google.com/chrome/answer/95647?hl=fr Comment autoriser les cookies sous Chrome]==

==Autoriser les cookies sous Internet Explorer==
*'''Outils > Options internet'''
*Onglet '''Confidentialité'''
*Positionner le niveau de sécurité au maximum à '''Moyenne'''
*Bouton '''OK'''

==Autoriser les cookies sous iPhone / Safari==
*'''Réglages > Safari'''
*Régler '''Accepter les cookies'''
[[Fichier:Accepter-cookies-iPhone-Safari.png]]

==Autoriser les cookies sous Firefox==
*'''Outils > Options'''
*Onglet '''vie privée'''
*Cocher '''Accepter les cookies'''
*Bouton '''OK'''

==Problème de navigation sur un réseau GSM==
OpenFlyers est accessible sur les smartphones par le biais du navigateur embarqué. Cependant, des problèmes de session peuvent survenir du fait du changement dynamique de l'adresse IP du smartphone du fait du réseau GSM. Pour palier à ce problème et éviter des déconnexions intempestives, il faut se connecter en HTTPS.

De plus, et toujours en HTTPS, il est possible de [[#Transmettre_l.27identifiant_et_le_mot_de_passe_dans_l.27URL|rajouter le couple identifiant/mot de passe à la suite de l'URL sécurisée]] et d'enregistrer cette URL en favori. Ainsi, il n'est plus nécessaire de saisir systématiquement son identifiant et son mot de passe.

==Problèmes de navigation sous iPhone==
*Penser à mettre à jour le logiciel de l'iPhone. OpenFlyers fonctionne correctement pour une version au moins 4.02.
*Activer l'[[#Autoriser_les_cookies_sous_iPhone_.2F_Safari|acceptation des cookies]]
*Si la navigation était possible sur une version précédente d'OpenFlyers et qu'elle n'est plus possible sur une nouvelle version d'OpenFlyers, alors il peut être nécessaire de vider le cache du navigateur Safari de l'iPhone :
**'''Réglages > Safari'''
**'''Effacer cookies et données'''

=Transmettre l'identifiant et le mot de passe dans l'URL=
Si vous souhaitez transmettre le couple identifiant/mot de passe dans l'URL dans le but de pouvoir les sauver facilement, vous avez besoin d'un [http://www.openflyers.com/doc/catalogue-tarifaire.pdf abonnement HTTPS] et alors l'URL doit avoir la forme :
https://mySpaceName.openflyers.tld?login=myLogin&password=myPassword
où :
*mySpaceName doit être remplacé par le nom du compte openflyers
*tld doit être remplacé par l'extension (comme de, fr, us, etc.)
*myLogin doit être remplacé par votre identifiant
*myPassword doit être remplacé par votre mot de passe

=Cahier de réservation=
==Que se passe t-il en cas de conflit de réservation ?==
Il ne peut y avoir de conflit de réservation. C'est l'un des principes durs d'OpenFlyers : à chaque instant donné, il ne peut y avoir plus d'une réservation pour chaque pilote, chaque avion ou chaque instructeur.

Si vous arrivez à faire des réservations qui se chevauchent (pour un avion, un instructeur ou un pilote), alors vous avez mis en évidence un bug, et il faut nous le signaler pour que nous y remédions.

==Si je suis en train de consulter une page, et que quelqu'un fait une modif sur cette page, vais-je voir la modif sans lancer un rafraichissement ?==
Non vous ne verrez pas la modification. Cependant, ce n'est pas grave car au moment où vous essayerez de faire votre réservation, OpenFlyers vérifiera à ce moment-là que le créneau que vous souhaitez est toujours disponible (pour empêcher les conflits justement).

==Comment saisir une date rapidement dans la gestion des qualifications ?==
En cliquant sur l'icône "calendrier" placé par défaut au mois courant, vous pourrez vous déplacer mois par mois ou année par année en cliquant sur les flèches respectives. Pour des dates plus anciennes, passez le curseur de votre souris sur l'endroit où se trouve le texte correspondant à "Mois Année". Ce texte s'encadre alors d'une bordure. Faites un clic dessus et une nouvelle petite fenêtre va s'ouvrir. Là vous pourrez saisir l'année en tapant les chiffres avec votre clavier.

==A propos des horaires de la nuit aéronautique==

Nous calculons les éphémérides d'après les définitions officielles.

Ainsi, les heures de lever et de coucher du soleil correspondent au passage du centre du soleil sous l'horizon (donc 3 degrés sous l'horizon puisqu'il est considéré, en première approximation que le soleil a un diamètre apparent de 6 degrés).

Les heures du jour et de la nuit aéronautique correspondent au passage du soleil 6 degrés sous l'horizon. Il s'agit de la définition officielle, aussi bien française, qu'internationale (OACI). Le calcul est validé pour les latitudes inférieures à 65 degrés. Sa précision est de l'ordre de la minute sous des latitudes inférieures à 50 degrés. La précision diminue au fur et à mesure que la latitude augmente (c'est à dire que l'on se rapproche des pôles).

Conséquence du calcul : les résultats trouvés ne correspondent pas (forcément) à la simple addition de + ou - 30 minutes. Mais il n'a jamais été écrit dans un texte officiel que la journée aéronautique correspondait au lever du soleil moins trente minutes, et que la nuit aéronautique correspondait au coucher du soleil plus trente minutes. La seule chose que vous trouverez, si vous vous penchez sur les textes, c'est qu'il est admis d'utiliser + ou - 30 minutes pour faire les calculs sous des latitudes comprises entre 30 et 60 degrés et 15 minutes sous les latitudes inférieures à 30 degrés). Voir [http://www.anpi.asso.fr/Reglesair.pdf Règles de l'air - Chapitre 1er - Définitions]
Attention: certains pays n'utilisent pas la nuit aéronautique et ne permettent pas le vol en dehors du lever et du coucher du soleil

Le résultat proposé est donc le bon résultat. Si vous ne souhaitez pas utiliser ce résultat, il vous suffit de retrancher ou d'ajouter 30 minutes au calcul du lever et du coucher du soleil.

Cependant, nous attirons votre attention sur l'intérêt d'utiliser le bon calcul : il vous met du bon côté du point de vue de la sécurité. En effet, si en été vous y gagnez, c'est parce que le soleil met plus de temps à se coucher. Par contre en hiver, notre calcul fait "perdre" une dizaine de minutes : c'est parce que le soleil met moins de temps à se coucher. Calculer l'écart entre la nuit aéronautique et le coucher du soleil (et comparer avec les 30 minutes) vous permettra d'avoir une idée de la "vitesse" avec laquelle se couche le soleil, donc de vous méfier encore plus de l'arrivée de la nuit et de ne pas vous faire surprendre par le crépuscule.

Qui ne s'est jamais retrouvé au sol en ayant voulu "tangenter" avec la nuit et s'est surpris à constater qu'il faisait bien sombre, tout d'un coup ?

Le programme calcule les heures de coucher/lever du soleil à partir des coordonnées géographique du terrain de base. Si vous constatez que vos heures sont erronées, demander à votre administrateur qu'il vérifie le code OACI dans les paramètres de la structure aéronautique.

=Saisie des vols=
==Nos avions ont des compteurs en heures, centièmes, peut-on avoir un affichage en heures, minutes ?==
Chaque utilisateur paramètre son affichage comme il le souhaite dans Données/Affichage et fiche personnelle
[[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format Patron de date et heure]]

== Comment saisir plusieurs pilotes pour un vol ?==
Saisir les vols dans OF comme dans le carnet de route de l'avion
== Comment partager les coûts d'un vol ?==
Si un pilote veux partager les frais du vol (sans être pilote) il doit faire un transfert de son compte vers le compte du pilote
Menu Comtes/Transférer

=Divers=
==Peut-il y avoir des accès à plusieurs sur la base ?==
Oui, sinon deux membres ne pourraient pas consulter le cahier en même temps.

Par contre, lorsqu'un membre réserve un avion, au moment où OpenFlyers teste la disponibilité du créneau, il empêche toute autre écriture sur la base concernant les réservations. Le but est d'empécher justement les conflits de réservation.

=Actions dynamiques non prises en compte par OpenFlyers=
OpenFlyers met en oeuvre des actions dites "dynamiques" c'est à dire qui ne nécessite pas un rafraîchissement complet de la page pour être prises en comptes. Ces actions sont basées sur le principe "[http://fr.wikipedia.org/wiki/Asynchronous_JavaScript_and_XML AJAX]". Elles nécessitent l'activation du moteur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] du navigateur pour être opérationnelles.

De plus, certaines commandes [http://fr.wikipedia.org/wiki/JavaScript JavaScript] ne sont pas reconnues par tous les navigateurs.

Ainsi, lorsque vous lancez une action dynamique dans OpenFlyers qui reste sans résultat, avant de rapporter l'anomalie sur le [http://bts.openflyers.org BTS] il faut vérifier :
#L'activation de [http://fr.wikipedia.org/wiki/JavaScript JavaScript] dans le navigateur utilisé.
#Tester avec un autre navigateur
#Dans le cas où JavaScript est activé, il faut rapporter l'anomalie sur le [http://bts.openflyers.org BTS] en précisant le navigateur sur lequel l'action est inefficace et le navigateur sur lequel l'action est efficace.
Vous pouvez également nous facilitez la correction de l'anomalie en nous rapportant le message d'erreur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] s'il y a lieu.

=Comment exporter les données ?=
OF affiche une page XHTML ce qui signifie un texte correctement formaté qui peut être récupéré par un simple copier coller. Le tableur Calc de Open Office ou Libre Office interprète correctement ce HTML et le formate en colonne conformément à la présentation de votre page.

Il a cependant un paramétrage à faire pour que les textes soit correctement encodé (affichage des caractères accentués) et que les cellules numériques affichent le format correct

*Allez dans l'onglet Outils/Options/Chargement&Enegistrement/Compatibilité HTML (Tools/Options/Load&Save/HTML Compatibility)
*Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")
*Par la même occasion vous pouvez aussi changer le Jeu d'encodage (Character set) par Unicode (UTF-8)

Le programme interprète alors le point comme le séparateur décimal et vous avez directement le bon copier/coller Si vous avec choisi l'encodage UTF-8 les caractères accentués seront aussi correctement traduits (A rechanger si vous avez à faire des copier coller depuis des programmes à l'encodage CP1252 "Windows Microsoft")

Pour les exports au format csv voir [[FAQ csv reading with Oo]]

=Paramétrage et données personnelles=

==Peut-on être averti automatiquement des réservations annulées ?==
Dans la version 3 d'OpenFlyers, il est possible pour chaque utilisateur de paramétrer OpenFlyers de sort à être averti par e-mail lorsqu'un créneau se libère. Voici comment configurer cela :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''', sélectionner '''Notification des réservations annulées'''
*Cliquer sur le bouton '''Sauver'''

==Peut-on être averti des réservations sur plusieurs adresses e-mail ?==

Il est possible d'utiliser plusieurs adresses e-mails afin d'être averti des réservations.

Voici comment procéder :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''' puis au niveau du champ '''E-mail'''
*Rentrer chacune des adresses e-mails en les séparant d'une virgule
'''Attention : il ne faut jamais mettre d'espace : ni dans l'adresse e-mail elle même, ni avant ou après les virgules de séparation des adresses e-mails'''

Exemple valide :
<pre>jesuisuntest@test.fr,jesuisuntest@test.com</pre>

Exemples non valides :
<pre>jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr, jesuisuntest@test.com</pre>

Accéder à l'application et aller dans le menu Données > Affichage et fiche personnelle

==Comment changer mes options d'affichage ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Option d'affichage'''

Dans les champs choisissez les paramètres selon vos souhaits: langue, heure local ou UTC, format monétaire,...

Sélectionner les avions et instructeurs que sous voulez afficher

==Affichage des dates et des heures==
Chaque utilisateur paramètre son affichage des dates et des heures comme il le souhaite dans '''Données > Affichage et fiche personnelle'''

Ressources sur les [[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format patrons de date et heure]]

==Comment modifier mes paramétrages ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Fiche personnelle'''

Charger une photo pour le trombinoscope

La date de naissance, le sexe et la nationalité sont obligatoire pour que les statistiques DGAC puisse être calculés

Mettez votre email et vos numéros de téléphone pour qu'on puisse vous contacter. Vous pouvez choisir ceux qui sont public ou non.

Dans ce dernier cas seul les personnes avec des droits administrateur pourrons voir ces infos.

==J'ai oublié mon mot de passe, comment le récupérer ?==
Il n'est pas possible de "retrouver" son mot de passe perdu dans OpenFlyers. En effet, ces derniers sont cryptés dans la base de données pour des raisons de confidentialités.

Si vous avez oublié votre mot de passe, vous n'avez pas besoin de demander à votre administrateur une ré-initialisation, OpenFlyers dispose d'une procédure de ré-initialisation automatique :

*Sur la page de connexion d'une plateforme OpenFlyers, cliquer sur le lien "Mot de passe oublié"
*:[[Fichier:FAQ_user_forgottenPassword.png]]
*Sur la page qui s'affiche il y a deux zones de saisie. Saisissez l'email que vous avez indiqué dans votre page personnelle. Il vous sera envoyé un email vous donnant votre identifiant et un code d'activation
*Revenez sur la page de ré-initialisation et mettez ces informations. Un nouvel email vous sera envoyé avec votre mot de passe

Vous pouvez maintenant accéder à l'application. Pour mettre un mot de passe personnalisé voir [[#Comment_changer_de_mot_de_passe|Comment changer son mot de passe]]

==Comment changer de mot de passe==
*Dans '''Données > Affichage et fiche personnelle'''
*Aller en bas de la page, dans le formulaire '''Changer de mot de passe''' et saisissez votre nouveau mot de passe

Un indicateur vous indique le niveau de fiabilité. Mélanger les minuscules/majuscules/chiffres et sigles pour augmenter la difficulté pour des robots de trouver votre mot de passe. La sécurité de l'application de votre club sera ainsi accrue.

=Trucs et astuces=
==Fenêtre en ligne de commande==
===Ouvrir une fenêtre en ligne de commande===
====Ouvrir une fenêtre en ligne de commande sous Windows====
*Aller dans le menu "Démarrer"
*Puis Tous les programmes/Accessoires
*Lancer l'"invite de commandes"
====Ouvrir une fenêtre en ligne de commande sous Mac====
Sous OSX (mac) il faut lancer un Terminal. Pour cela 2 solutions :
*Taper "terminal" dans spotlight
ou
*lancer l'application qui est dans Applications > Utilitaires.

===Copier/Coller dans une fenêtre en ligne de commande===
====Copier/Coller dans une fenêtre en ligne de commande sous Windows====
Vous pouvez faire un copier/coller en utilisant le bouton droit de la souris dans la fenêtre de l'invite de commandes puis en choisissant '''sélectionner''' et ensuite en appuyant sur le bouton gauche et en le laissant appuyer tout en sélectionnant la zone souhaitée)

====Copier/Coller dans une fenêtre en ligne de commande sous Mac====
Pour faire un copier/coller de ces informations et nous les communiquer, il suffit d'utiliser commande-C dans le terminal.

=Comment imprimer la doc ?=
Si vous souhaitez imprimer la doc, il vous suffit de :
*cliquer sur le lien "version imprimable" de la "boîte à outils" présente sur le côté gauche des pages du wiki. Vous obtiendrez ainsi une version des pages destinée à être imprimer.
*ou bien, utiliser la fonction imprimer de votre navigateur. Une mise en page spécifique est générée pour obtenir un format papier

Si vous imprimer avec une Imprimante pdf ([http://www.pdfforge.org/pdfcreator pdfCreator] par exemple) vous générerez alors un format pdf pour archivage

=Problèmes=
==Signaler un problème==
Si vous rencontrer une anomalie ou un bug dans l'application OpenFlyers, il faut le rapporter sur le [http://bts.openflyers.org BTS] pour une prise en compte la plus rapide possible et pour permettre un meilleur traitement et suivi.

Pour rapporter une anomalie il faut :
*Aller sur la page http://bts.openflyers.org
*S'inscrire sur le BTS en cliquant sur '''Signup for a new account''' : il faut choisir un identifiant, une adresse e-mail puis cliquer sur '''Signup'''.
Un e-mail est envoyé par le BTS permettant de valider votre adresse e-mail. Cliquer sur le lien présent sur cet e-mail.
*Sur le formulaire qui apparait, Choisir :
**Un mot de passe dans les champs '''Password''' et '''Confirm Password'''
**Compléter éventuellement le champ '''Real Name'''
*Cliquer sur le bouton '''Update account'''
Votre compte pour rapporter un problème sur le BTS est ainsi créé. Un nouveau formulaire d'identification s'affiche automatiquement :
*Renseigner les champs '''Username''' et '''Password'''
*Sélectionner éventuellement sur '''Remember my login in this browser''' afin de ne plus avoir à s'identifier lors d'une nouvelle connexion depuis le même navigateur internet.
*Dé-sélectionner éventuellement le champ '''Only allow your session to be used from this IP address.''' qui limite les possibilités de connexion
*Cliquer sur '''Login'''
*Aller dans l'onglet '''Preferences'''
*En bas du formulaire, modifier le champ '''Language''' pour choisir '''french'''.
*Cliquer sur '''Update Prefs'''
Vous pouvez alors tranquillement rapporter un bug depuis le formulaire '''Rapporter un bogue'''

==Problème d'auto-complétion des terrains==
*Si les terrains d'arrivée et de départ ne s'affichent pas, vérifier la [[Browsers_compatibility#Versions_support.C3.A9es|compatibilité de votre navigateur]].
*La version 2.1 d'OpenFlyers n'est pas supportée par Internet Explorer 10.
*En revanche, la version 3.0.3 d'OpenFlyers est supportée par les versions d'Internet Explorer supérieures à 8.
Si vous êtes sous la version 2.1 d'OpenFlyers avec comme navigateur Internet Explorer alors vous avez 2 solutions :
*Changer de navigateur
*[[FAQ_client#Comment_se_fait_la_migration_vers_une_version_sup.C3.A9rieure_.3F|Demander à migrer]] sous la version 3.0.3 d'OpenFlyers.

FAQ utilisateur

2015-04-16T12:48:06Z

Jcheng : /* Navigation dans OpenFlyers */

=Connexion=
==Impossible de me connecter à la plateforme OpenFlyers de ma structure aéronautique==
Si vous n'arrivez pas à accéder une plateforme OpenFlyers il faut en rechercher la raison. Voici un certain nombre de questions qui peuvent vous permettre de solutionner votre problème :
*Accédez-vous à la page d'identification de la plateforme OpenFlyers ?
**Si non, alors il faut regarder la FAQ [[#Page_indisponible|Page indisponible]]
*Lorsque vous vous identifiez, avez-vous un message de rejet indiquant que votre identifiant et/ou votre mot de passe ne sont pas corrects ?
**Si oui, alors le problème peut venir du mot de passe qui a changé. Dans ce cas là, vous pouvez ré-initialiser votre mot de passe en suivant la procédure [[#J.27ai_oubli.C3.A9_mon_mot_de_passe.2C_comment_le_r.C3.A9cup.C3.A9rer_.3F|de réinitialisation de mot de passe]]. Cela peut également venir de votre identifiant qui n'est pas bon. Dans ce cas, il faut demander à la personne en charge de la gestion d'OpenFlyers au sein de votre structure aéronautique
*Une fois connecté, revenez-vous sur la page d'identification lorsque vous changez de page ?
**Si oui, alors il faut regarder la [[#A_chaque_fois_que_je_change_de_page.2C_je_reviens_sur_la_page_d.27identification_.3F|procédure de gestion des cookies du navigateur]].
Si vous n'êtes dans aucun des cas répertoriés ci-dessus, alors vous pouvez rapporter votre problème en nous envoyant un e-mail et en décrivant le plus précisément possible le problème que vous rencontrez :
*Navigateur utilisé
*Système d'exploitation
*type de PC, smartphone ou tablette
*Nom du fournisseur d'accès internet
*Actions effectuées
*Message d'erreur s'affichant

==Page indisponible==
Si vous n'arrivez pas à accéder à la plateforme OpenFlyers de votre structure aéronautique. Voici une liste d'actions à effectuer :
*Redémarrer votre ordinateur
*Redémarrer la "box" ADSL
*Si cela ne fonctionne toujours pas, il faut [[#Tester_les_r.C3.A9solutions_DNS|tester les résolutions DNS]].
===Tester les résolutions DNS===
Pour effectuer les tests suivants, il faut ouvrir une fenêtre "[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|en ligne de commandes]]". En cas de problème, il faut nous rapporter les résultats en ouvrant un rapport de bug sur le [http://bts.openflyers.ogr BTS]. Pour cela, il est pratique de procéder par [[#Copier.2FColler_dans_une_fen.C3.AAtre_en_ligne_de_commande|copier/coller]].
*Dans la fenêtre en ligne de commande taper ce qui suit (en remplaçant '''structure_aéro''' par le sous-domaine correspondant à votre structure aéronautique) :
<bash>ping structure_aéro.openflyers.fr</bash>
La réponse normale est pour OpenFlyers 3.0 :
Envoi d'une requête 'ping' sur serveur6-of3.openflyers.net [87.98.143.237] avec 32 octets de données :
Réponse de 87.98.143.237 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur6-of3.openflyers.net" ou "Réponse de 87.98.143.237" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 2.1 :
Envoi d'une requête 'ping' sur serveur6-of21.openflyers.net [91.121.47.179] avec 32 octets de données :
Réponse de 91.121.47.179 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur5-of21.openflyers.net" ou "Réponse de 91.121.47.179" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 1.3 :
Envoi d'une requête 'ping' sur serveur6-of1.openflyers.net [178.33.105.217] avec 32 octets de données :
Réponse de 178.33.105.217 : octets=32 temps=41 ms TTL=55
Si vous n'avez pas "serveur6-of1.openflyers.net" ou "Réponse de 178.33.105.217" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].
====Tests plus poussés====
*Faire un :
<bash>nslookup structure_aéro.openflyers.fr</bash>
*Et un :
<bash>tracert structure_aéro.openflyers.fr</bash>
*Faire le test avec '''dig +trace''' :
<bash>dig +trace structure_aéro.openflyers.fr</bash>
Sous Windows, il faudra au préalable récupérer l'utilitaire (par exemple dans un package [http://www.isc.org./downloads bind]). Une fois téléchargé le package, il faut copier/coller le programme dig ainsi que les fichiers .dll dans un répertoire commun et se positionner dans ce répertoire depuis la fenêtre en ligne de commandes avec la commande dir '''"nom du chemin du répertoire"'''.

====Tester les résolutions DNS sous Mac====
De plus, nous disposons de commandes plus puissantes qui permettent d'avoir d'avantage d'informations :
*cat /etc/resolv.conf

===Vérifier la configuration de résolution des DNS===
====Vérifier la configuration de résolution des DNS sous Windows====
Si vous avez un problème de résolution DNS sous windows, il peut être utile de vérifier que la résolution DNS est dynamique :
#Double-cliquer sur la connexion réseau concernée (par exemple le symbole "WIFI")
#Cliquer sur '''Propriétés''' dans l'onglet '''Général''' de l''''Etat de Connexion réseau sans fil''' (si WIFI))
#Sélectionner '''Protocole internet TCP/IP'''
#Cliquer sur '''Propriétés'''
#Vérifier qu'est sélectionné '''Obtenir les adresses des serveurs DNS automatiquement'''. (si ce n'est pas le cas, modifier).
#En dernier ressort, [[#Changer de serveur DNS|Changer de serveur DNS]] ou [[#Forcer_les_DNS|Forcer les DNS]].

===Nous communiquez les adresses IP des serveurs DNS===
====Nous communiquez les adresses IP des serveurs DNS sous Windows====
#[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|Ouvrir une fenêtre en ligne de commande]]
#Taper : '''ipconfig /all'''
Les adresses IP des serveurs DNS se trouvent au droit de '''Serveurs DNS'''

===Changer de serveur DNS===
Si vous rencontrez un problème de résolution de DNS avec votre fournisseur d'accès, vous pouvez changer les serveurs qui effectue la résolution des DNS pour votre accès.
====Changer de serveur DNS sous Mac====
*Dans '''Préférences Systèmes''', choisir '''Réseau''', puis une fois la bonne carte réseau sélectionnée, appuyer sur Avancé.
*Dans la fenêtre qui apparaît, aller sur l'onglet '''DNS''' et dans '''Serveurs DNS''' appuyer sur le + pour ajouter '''8.8.8.8''' et une autre fois pour ajouter '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Il ne reste plus qu'à '''Appliquer''' et à tester.

====Changer de serveur DNS sous Windows XP====
*'''Démarrer > Connexions''' puis cliquer sur la connexion réseau active (par exemple la connexion WIFI)
*Cliquer sur '''Propriétés'''
*Sélectionner '''Protocole Internet (TCP/IP)'''
*Cliquer sur '''Propriétés'''
*En général, en bas de la fenêtre '''Propriétés de Protocole Internet (TCP/IP)''' la configuration active est : '''Obtenir les adresses des serveurs DNS automatiquement'''
*Cocher '''Utiliser l'adresse de serveur DNS suivante :'''
*Pour '''Serveur DNS préféré''', saisir '''8.8.8.8'''
*Pour '''Serveur DNS auxiliaire''', saisir '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Cliquer sur '''OK'''
*Cliquer sur '''OK'''
*Cliquer sur '''Fermer'''

===Forcer les DNS===
====Forcer les DNS sous Windows====
Attention, avec Vista, il faut appliquer une [[#Particularit.C3.A9_avec_Windows_Vista|procédure préalable]].
*Il est possible de résoudre ce problème de DNS en éditant le fichier C:\WINDOWS\system32\drivers\etc\hosts (avec le bloc-notes) en rajoutant la ligne (il faut remplacer structure_aéro par le sous-domaine de l'espace OpenFlyers de votre structure aéronautique) :
**Pour OF 1.3 :
<pre>178.33.105.217 structure_aéro.openflyers.fr</pre>
**Pour OF 2.1 :
<pre>91.121.47.179 structure_aéro.openflyers.fr</pre>
**Pour OF 3.0alpha :
<pre>87.98.143.237 structure_aéro.openflyers.fr</pre>
*Ensuite, il faut relancer votre PC
*Une fois la connexion correctement effectuée, il est parfois possible de supprimer cette entrée dans le fichier hosts tout en gardant la connexion.

====Particularité avec Windows Vista====
*Il faut être administrateur pour pouvoir modifier le fichier hosts.
*Il faut également copier le fichier hosts sur le bureau pour le modifier puis ensuite le recopier dans le bon répertoire (si on édite directement le fichier hosts depuis (system32\drivers\etc\) on ne peut pas le ré-enregistrer).

====Forcer les DNS sous Mac====
*lancer Terminal (dans Applications/Utilitaires)
*taper "sudo nano /etc/hosts" (il demande le mot de passe de l'utilisateur qui a les droits admin sur la machine)
*Ajouter les entrées sur le modèle de la [[#Forcer_les_DNS_sous_Windows|procédure sous Windows]]
*Faire controle-o pour enregistrer puis controle-x pour quitter
*Eventuellement, faire "dscacheutil -flushcache" si le changement n'est pas encore pris en compte.

==A chaque fois que je change de page, je reviens sur la page d'identification ?==
Si le retour à la page d'identification est systématique, alors il doit s'agir d'un problème de '''cookies'''. Il faut modifier la configuration du navigateur de manière à [[#Autoriser_les_cookies|autoriser les cookies]].

===Variante du problème : la déconnexion n'est pas systématique mais aléatoire===
Dans ce cas, il peut s'agir aussi d'un problème de proxy (si vous êtes sur un réseau d'entreprise par exemple) ou de fournisseurs d'accès (accès depuis un mobile, depuis un hôtel, bref, tout type d'accès qui change régulièrement l'adresse IP et ainsi ne permet de maintenir un accès authentifié dans la durée. La solution est présentée dans la procédure [[#Utiliser_OpenFlyers_sur_un_smartphone|Utiliser OpenFlyers sur un smartPhone]].

==Plusieurs membres peuvent-ils ouvrir des sessions en même temps (sans le savoir) ?==
Oui, c'est même le but premier : permettre à plusieurs personnes de consulter en même temps le cahier de réservation.

Vous pouvez même avoir une personne qui ouvre plusieurs sessions avec son identifiant. Mais pour cela, elle doit utiliser des ordinateurs ou des navigateurs différents.
==Suite à une migration, impossible de naviguer dans la nouvelle version d'OpenFlyers==
Lorsque nous migrons d'une version vers une autre, bien souvent nous le faisons en changeant les "DNS". Cela peut occasionner des problèmes d'accès. Il peut également apparaitre des problèmes de "cache" qui se résolvent d'eux sous 24 à 48 heures. Ces problèmes peuvent survenir lorsque l'ordinateur concerné a été connecté à l'ancienne plateforme OpenFlyers juste avant la migration.

Voici différentes techniques qui permettent d'imposer à votre navigateur d'utiliser des DNS actualisées et d'utiliser un cache à jour :
#Penser à éteindre et rallumer complètement l'ordinateur
#Faites un CTRL+R (ou icône de "rafraichissement"). Bien souvent cela suffit au navigateur pour qu'il vide son cache et le ré-actualise
#Vider le cache dans le navigateur
#Supprimer les cookies dans le navigateur
Plus technique :
#Faites un ipconfig /flushdns en ligne de commande (menu démarrer, puis "Exécutez", taper "cmd")
#Forcer les nouvelles DNS dans le fichier C:\WINDOWS\system32\drivers\etc\hosts en ajoutant une ligne du genre : xxx.xxx.xxx.xxx xxx.openflyers.zz (nous demandez pour connaitre les valeurs à utiliser)

De plus, afin de permettre quand même d'accéder à la nouvelle plateforme, nous mettons en place une deuxième URL temporaire pendant 1 semaine. Ainsi pour l'URL plateforme.openflyers.fr nous mettrons en place une URL temporaire plateforme2.openflyers.fr

=Navigation dans OpenFlyers=
OpenFlyers est un logiciel qui s'utilise grâce à votre navigateur internet. Les plus connus sont Chrome, Firefox, Internet Explorer ou Safari.
Une certaine configuration est nécessaire afin de faire fonctionner OpenFlyers : la configuration des cookies.
Si vous rencontrez des problèmes d'utilisations tels que :

*Impossibilité de se connecter alors que votre identifiant et mot de passe est correct
*Impossibilité d'aller d'un page à l'autre une fois connecté (et retour sur la page de connexion)

Voila comment régler votre navigateur.

==Autoriser les cookies sous Firefox==
*'''Outils > Options'''
*Onglet '''vie privée'''
*Cocher '''Accepter les cookies'''
*Bouton '''OK'''

==Autoriser les cookies sous Internet Explorer==
*'''Outils > Options internet'''
*Onglet '''Confidentialité'''
*Positionner le niveau de sécurité au maximum à '''Moyenne'''
*Bouton '''OK'''

==Autoriser les cookies sous iPhone / Safari==
*'''Réglages > Safari'''
*Régler '''Accepter les cookies'''
[[Fichier:Accepter-cookies-iPhone-Safari.png]]

==Problème de navigation sur un réseau GSM==
OpenFlyers est accessible sur les smartphones par le biais du navigateur embarqué. Cependant, des problèmes de session peuvent survenir du fait du changement dynamique de l'adresse IP du smartphone du fait du réseau GSM. Pour palier à ce problème et éviter des déconnexions intempestives, il faut se connecter en HTTPS.

De plus, et toujours en HTTPS, il est possible de [[#Transmettre_l.27identifiant_et_le_mot_de_passe_dans_l.27URL|rajouter le couple identifiant/mot de passe à la suite de l'URL sécurisée]] et d'enregistrer cette URL en favori. Ainsi, il n'est plus nécessaire de saisir systématiquement son identifiant et son mot de passe.

==Problèmes de navigation sous iPhone==
*Penser à mettre à jour le logiciel de l'iPhone. OpenFlyers fonctionne correctement pour une version au moins 4.02.
*Activer l'[[#Autoriser_les_cookies_sous_iPhone_.2F_Safari|acceptation des cookies]]
*Si la navigation était possible sur une version précédente d'OpenFlyers et qu'elle n'est plus possible sur une nouvelle version d'OpenFlyers, alors il peut être nécessaire de vider le cache du navigateur Safari de l'iPhone :
**'''Réglages > Safari'''
**'''Effacer cookies et données'''

=Transmettre l'identifiant et le mot de passe dans l'URL=
Si vous souhaitez transmettre le couple identifiant/mot de passe dans l'URL dans le but de pouvoir les sauver facilement, vous avez besoin d'un [http://www.openflyers.com/doc/catalogue-tarifaire.pdf abonnement HTTPS] et alors l'URL doit avoir la forme :
https://mySpaceName.openflyers.tld?login=myLogin&password=myPassword
où :
*mySpaceName doit être remplacé par le nom du compte openflyers
*tld doit être remplacé par l'extension (comme de, fr, us, etc.)
*myLogin doit être remplacé par votre identifiant
*myPassword doit être remplacé par votre mot de passe

=Cahier de réservation=
==Que se passe t-il en cas de conflit de réservation ?==
Il ne peut y avoir de conflit de réservation. C'est l'un des principes durs d'OpenFlyers : à chaque instant donné, il ne peut y avoir plus d'une réservation pour chaque pilote, chaque avion ou chaque instructeur.

Si vous arrivez à faire des réservations qui se chevauchent (pour un avion, un instructeur ou un pilote), alors vous avez mis en évidence un bug, et il faut nous le signaler pour que nous y remédions.

==Si je suis en train de consulter une page, et que quelqu'un fait une modif sur cette page, vais-je voir la modif sans lancer un rafraichissement ?==
Non vous ne verrez pas la modification. Cependant, ce n'est pas grave car au moment où vous essayerez de faire votre réservation, OpenFlyers vérifiera à ce moment-là que le créneau que vous souhaitez est toujours disponible (pour empêcher les conflits justement).

==Comment saisir une date rapidement dans la gestion des qualifications ?==
En cliquant sur l'icône "calendrier" placé par défaut au mois courant, vous pourrez vous déplacer mois par mois ou année par année en cliquant sur les flèches respectives. Pour des dates plus anciennes, passez le curseur de votre souris sur l'endroit où se trouve le texte correspondant à "Mois Année". Ce texte s'encadre alors d'une bordure. Faites un clic dessus et une nouvelle petite fenêtre va s'ouvrir. Là vous pourrez saisir l'année en tapant les chiffres avec votre clavier.

==A propos des horaires de la nuit aéronautique==

Nous calculons les éphémérides d'après les définitions officielles.

Ainsi, les heures de lever et de coucher du soleil correspondent au passage du centre du soleil sous l'horizon (donc 3 degrés sous l'horizon puisqu'il est considéré, en première approximation que le soleil a un diamètre apparent de 6 degrés).

Les heures du jour et de la nuit aéronautique correspondent au passage du soleil 6 degrés sous l'horizon. Il s'agit de la définition officielle, aussi bien française, qu'internationale (OACI). Le calcul est validé pour les latitudes inférieures à 65 degrés. Sa précision est de l'ordre de la minute sous des latitudes inférieures à 50 degrés. La précision diminue au fur et à mesure que la latitude augmente (c'est à dire que l'on se rapproche des pôles).

Conséquence du calcul : les résultats trouvés ne correspondent pas (forcément) à la simple addition de + ou - 30 minutes. Mais il n'a jamais été écrit dans un texte officiel que la journée aéronautique correspondait au lever du soleil moins trente minutes, et que la nuit aéronautique correspondait au coucher du soleil plus trente minutes. La seule chose que vous trouverez, si vous vous penchez sur les textes, c'est qu'il est admis d'utiliser + ou - 30 minutes pour faire les calculs sous des latitudes comprises entre 30 et 60 degrés et 15 minutes sous les latitudes inférieures à 30 degrés). Voir [http://www.anpi.asso.fr/Reglesair.pdf Règles de l'air - Chapitre 1er - Définitions]
Attention: certains pays n'utilisent pas la nuit aéronautique et ne permettent pas le vol en dehors du lever et du coucher du soleil

Le résultat proposé est donc le bon résultat. Si vous ne souhaitez pas utiliser ce résultat, il vous suffit de retrancher ou d'ajouter 30 minutes au calcul du lever et du coucher du soleil.

Cependant, nous attirons votre attention sur l'intérêt d'utiliser le bon calcul : il vous met du bon côté du point de vue de la sécurité. En effet, si en été vous y gagnez, c'est parce que le soleil met plus de temps à se coucher. Par contre en hiver, notre calcul fait "perdre" une dizaine de minutes : c'est parce que le soleil met moins de temps à se coucher. Calculer l'écart entre la nuit aéronautique et le coucher du soleil (et comparer avec les 30 minutes) vous permettra d'avoir une idée de la "vitesse" avec laquelle se couche le soleil, donc de vous méfier encore plus de l'arrivée de la nuit et de ne pas vous faire surprendre par le crépuscule.

Qui ne s'est jamais retrouvé au sol en ayant voulu "tangenter" avec la nuit et s'est surpris à constater qu'il faisait bien sombre, tout d'un coup ?

Le programme calcule les heures de coucher/lever du soleil à partir des coordonnées géographique du terrain de base. Si vous constatez que vos heures sont erronées, demander à votre administrateur qu'il vérifie le code OACI dans les paramètres de la structure aéronautique.

=Saisie des vols=
==Nos avions ont des compteurs en heures, centièmes, peut-on avoir un affichage en heures, minutes ?==
Chaque utilisateur paramètre son affichage comme il le souhaite dans Données/Affichage et fiche personnelle
[[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format Patron de date et heure]]

== Comment saisir plusieurs pilotes pour un vol ?==
Saisir les vols dans OF comme dans le carnet de route de l'avion
== Comment partager les coûts d'un vol ?==
Si un pilote veux partager les frais du vol (sans être pilote) il doit faire un transfert de son compte vers le compte du pilote
Menu Comtes/Transférer

=Divers=
==Peut-il y avoir des accès à plusieurs sur la base ?==
Oui, sinon deux membres ne pourraient pas consulter le cahier en même temps.

Par contre, lorsqu'un membre réserve un avion, au moment où OpenFlyers teste la disponibilité du créneau, il empêche toute autre écriture sur la base concernant les réservations. Le but est d'empécher justement les conflits de réservation.

=Actions dynamiques non prises en compte par OpenFlyers=
OpenFlyers met en oeuvre des actions dites "dynamiques" c'est à dire qui ne nécessite pas un rafraîchissement complet de la page pour être prises en comptes. Ces actions sont basées sur le principe "[http://fr.wikipedia.org/wiki/Asynchronous_JavaScript_and_XML AJAX]". Elles nécessitent l'activation du moteur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] du navigateur pour être opérationnelles.

De plus, certaines commandes [http://fr.wikipedia.org/wiki/JavaScript JavaScript] ne sont pas reconnues par tous les navigateurs.

Ainsi, lorsque vous lancez une action dynamique dans OpenFlyers qui reste sans résultat, avant de rapporter l'anomalie sur le [http://bts.openflyers.org BTS] il faut vérifier :
#L'activation de [http://fr.wikipedia.org/wiki/JavaScript JavaScript] dans le navigateur utilisé.
#Tester avec un autre navigateur
#Dans le cas où JavaScript est activé, il faut rapporter l'anomalie sur le [http://bts.openflyers.org BTS] en précisant le navigateur sur lequel l'action est inefficace et le navigateur sur lequel l'action est efficace.
Vous pouvez également nous facilitez la correction de l'anomalie en nous rapportant le message d'erreur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] s'il y a lieu.

=Comment exporter les données ?=
OF affiche une page XHTML ce qui signifie un texte correctement formaté qui peut être récupéré par un simple copier coller. Le tableur Calc de Open Office ou Libre Office interprète correctement ce HTML et le formate en colonne conformément à la présentation de votre page.

Il a cependant un paramétrage à faire pour que les textes soit correctement encodé (affichage des caractères accentués) et que les cellules numériques affichent le format correct

*Allez dans l'onglet Outils/Options/Chargement&Enegistrement/Compatibilité HTML (Tools/Options/Load&Save/HTML Compatibility)
*Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")
*Par la même occasion vous pouvez aussi changer le Jeu d'encodage (Character set) par Unicode (UTF-8)

Le programme interprète alors le point comme le séparateur décimal et vous avez directement le bon copier/coller Si vous avec choisi l'encodage UTF-8 les caractères accentués seront aussi correctement traduits (A rechanger si vous avez à faire des copier coller depuis des programmes à l'encodage CP1252 "Windows Microsoft")

Pour les exports au format csv voir [[FAQ csv reading with Oo]]

=Paramétrage et données personnelles=

==Peut-on être averti automatiquement des réservations annulées ?==
Dans la version 3 d'OpenFlyers, il est possible pour chaque utilisateur de paramétrer OpenFlyers de sort à être averti par e-mail lorsqu'un créneau se libère. Voici comment configurer cela :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''', sélectionner '''Notification des réservations annulées'''
*Cliquer sur le bouton '''Sauver'''

==Peut-on être averti des réservations sur plusieurs adresses e-mail ?==

Il est possible d'utiliser plusieurs adresses e-mails afin d'être averti des réservations.

Voici comment procéder :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''' puis au niveau du champ '''E-mail'''
*Rentrer chacune des adresses e-mails en les séparant d'une virgule
'''Attention : il ne faut jamais mettre d'espace : ni dans l'adresse e-mail elle même, ni avant ou après les virgules de séparation des adresses e-mails'''

Exemple valide :
<pre>jesuisuntest@test.fr,jesuisuntest@test.com</pre>

Exemples non valides :
<pre>jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr, jesuisuntest@test.com</pre>

Accéder à l'application et aller dans le menu Données > Affichage et fiche personnelle

==Comment changer mes options d'affichage ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Option d'affichage'''

Dans les champs choisissez les paramètres selon vos souhaits: langue, heure local ou UTC, format monétaire,...

Sélectionner les avions et instructeurs que sous voulez afficher

==Affichage des dates et des heures==
Chaque utilisateur paramètre son affichage des dates et des heures comme il le souhaite dans '''Données > Affichage et fiche personnelle'''

Ressources sur les [[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format patrons de date et heure]]

==Comment modifier mes paramétrages ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Fiche personnelle'''

Charger une photo pour le trombinoscope

La date de naissance, le sexe et la nationalité sont obligatoire pour que les statistiques DGAC puisse être calculés

Mettez votre email et vos numéros de téléphone pour qu'on puisse vous contacter. Vous pouvez choisir ceux qui sont public ou non.

Dans ce dernier cas seul les personnes avec des droits administrateur pourrons voir ces infos.

==J'ai oublié mon mot de passe, comment le récupérer ?==
Il n'est pas possible de "retrouver" son mot de passe perdu dans OpenFlyers. En effet, ces derniers sont cryptés dans la base de données pour des raisons de confidentialités.

Si vous avez oublié votre mot de passe, vous n'avez pas besoin de demander à votre administrateur une ré-initialisation, OpenFlyers dispose d'une procédure de ré-initialisation automatique :

*Sur la page de connexion d'une plateforme OpenFlyers, cliquer sur le lien "Mot de passe oublié"
*:[[Fichier:FAQ_user_forgottenPassword.png]]
*Sur la page qui s'affiche il y a deux zones de saisie. Saisissez l'email que vous avez indiqué dans votre page personnelle. Il vous sera envoyé un email vous donnant votre identifiant et un code d'activation
*Revenez sur la page de ré-initialisation et mettez ces informations. Un nouvel email vous sera envoyé avec votre mot de passe

Vous pouvez maintenant accéder à l'application. Pour mettre un mot de passe personnalisé voir [[#Comment_changer_de_mot_de_passe|Comment changer son mot de passe]]

==Comment changer de mot de passe==
*Dans '''Données > Affichage et fiche personnelle'''
*Aller en bas de la page, dans le formulaire '''Changer de mot de passe''' et saisissez votre nouveau mot de passe

Un indicateur vous indique le niveau de fiabilité. Mélanger les minuscules/majuscules/chiffres et sigles pour augmenter la difficulté pour des robots de trouver votre mot de passe. La sécurité de l'application de votre club sera ainsi accrue.

=Trucs et astuces=
==Fenêtre en ligne de commande==
===Ouvrir une fenêtre en ligne de commande===
====Ouvrir une fenêtre en ligne de commande sous Windows====
*Aller dans le menu "Démarrer"
*Puis Tous les programmes/Accessoires
*Lancer l'"invite de commandes"
====Ouvrir une fenêtre en ligne de commande sous Mac====
Sous OSX (mac) il faut lancer un Terminal. Pour cela 2 solutions :
*Taper "terminal" dans spotlight
ou
*lancer l'application qui est dans Applications > Utilitaires.

===Copier/Coller dans une fenêtre en ligne de commande===
====Copier/Coller dans une fenêtre en ligne de commande sous Windows====
Vous pouvez faire un copier/coller en utilisant le bouton droit de la souris dans la fenêtre de l'invite de commandes puis en choisissant '''sélectionner''' et ensuite en appuyant sur le bouton gauche et en le laissant appuyer tout en sélectionnant la zone souhaitée)

====Copier/Coller dans une fenêtre en ligne de commande sous Mac====
Pour faire un copier/coller de ces informations et nous les communiquer, il suffit d'utiliser commande-C dans le terminal.

=Comment imprimer la doc ?=
Si vous souhaitez imprimer la doc, il vous suffit de :
*cliquer sur le lien "version imprimable" de la "boîte à outils" présente sur le côté gauche des pages du wiki. Vous obtiendrez ainsi une version des pages destinée à être imprimer.
*ou bien, utiliser la fonction imprimer de votre navigateur. Une mise en page spécifique est générée pour obtenir un format papier

Si vous imprimer avec une Imprimante pdf ([http://www.pdfforge.org/pdfcreator pdfCreator] par exemple) vous générerez alors un format pdf pour archivage

=Problèmes=
==Signaler un problème==
Si vous rencontrer une anomalie ou un bug dans l'application OpenFlyers, il faut le rapporter sur le [http://bts.openflyers.org BTS] pour une prise en compte la plus rapide possible et pour permettre un meilleur traitement et suivi.

Pour rapporter une anomalie il faut :
*Aller sur la page http://bts.openflyers.org
*S'inscrire sur le BTS en cliquant sur '''Signup for a new account''' : il faut choisir un identifiant, une adresse e-mail puis cliquer sur '''Signup'''.
Un e-mail est envoyé par le BTS permettant de valider votre adresse e-mail. Cliquer sur le lien présent sur cet e-mail.
*Sur le formulaire qui apparait, Choisir :
**Un mot de passe dans les champs '''Password''' et '''Confirm Password'''
**Compléter éventuellement le champ '''Real Name'''
*Cliquer sur le bouton '''Update account'''
Votre compte pour rapporter un problème sur le BTS est ainsi créé. Un nouveau formulaire d'identification s'affiche automatiquement :
*Renseigner les champs '''Username''' et '''Password'''
*Sélectionner éventuellement sur '''Remember my login in this browser''' afin de ne plus avoir à s'identifier lors d'une nouvelle connexion depuis le même navigateur internet.
*Dé-sélectionner éventuellement le champ '''Only allow your session to be used from this IP address.''' qui limite les possibilités de connexion
*Cliquer sur '''Login'''
*Aller dans l'onglet '''Preferences'''
*En bas du formulaire, modifier le champ '''Language''' pour choisir '''french'''.
*Cliquer sur '''Update Prefs'''
Vous pouvez alors tranquillement rapporter un bug depuis le formulaire '''Rapporter un bogue'''

==Problème d'auto-complétion des terrains==
*Si les terrains d'arrivée et de départ ne s'affichent pas, vérifier la [[Browsers_compatibility#Versions_support.C3.A9es|compatibilité de votre navigateur]].
*La version 2.1 d'OpenFlyers n'est pas supportée par Internet Explorer 10.
*En revanche, la version 3.0.3 d'OpenFlyers est supportée par les versions d'Internet Explorer supérieures à 8.
Si vous êtes sous la version 2.1 d'OpenFlyers avec comme navigateur Internet Explorer alors vous avez 2 solutions :
*Changer de navigateur
*[[FAQ_client#Comment_se_fait_la_migration_vers_une_version_sup.C3.A9rieure_.3F|Demander à migrer]] sous la version 3.0.3 d'OpenFlyers.

FAQ utilisateur

2015-04-16T12:47:18Z

Jcheng : /* Autoriser les cookies */

=Connexion=
==Impossible de me connecter à la plateforme OpenFlyers de ma structure aéronautique==
Si vous n'arrivez pas à accéder une plateforme OpenFlyers il faut en rechercher la raison. Voici un certain nombre de questions qui peuvent vous permettre de solutionner votre problème :
*Accédez-vous à la page d'identification de la plateforme OpenFlyers ?
**Si non, alors il faut regarder la FAQ [[#Page_indisponible|Page indisponible]]
*Lorsque vous vous identifiez, avez-vous un message de rejet indiquant que votre identifiant et/ou votre mot de passe ne sont pas corrects ?
**Si oui, alors le problème peut venir du mot de passe qui a changé. Dans ce cas là, vous pouvez ré-initialiser votre mot de passe en suivant la procédure [[#J.27ai_oubli.C3.A9_mon_mot_de_passe.2C_comment_le_r.C3.A9cup.C3.A9rer_.3F|de réinitialisation de mot de passe]]. Cela peut également venir de votre identifiant qui n'est pas bon. Dans ce cas, il faut demander à la personne en charge de la gestion d'OpenFlyers au sein de votre structure aéronautique
*Une fois connecté, revenez-vous sur la page d'identification lorsque vous changez de page ?
**Si oui, alors il faut regarder la [[#A_chaque_fois_que_je_change_de_page.2C_je_reviens_sur_la_page_d.27identification_.3F|procédure de gestion des cookies du navigateur]].
Si vous n'êtes dans aucun des cas répertoriés ci-dessus, alors vous pouvez rapporter votre problème en nous envoyant un e-mail et en décrivant le plus précisément possible le problème que vous rencontrez :
*Navigateur utilisé
*Système d'exploitation
*type de PC, smartphone ou tablette
*Nom du fournisseur d'accès internet
*Actions effectuées
*Message d'erreur s'affichant

==Page indisponible==
Si vous n'arrivez pas à accéder à la plateforme OpenFlyers de votre structure aéronautique. Voici une liste d'actions à effectuer :
*Redémarrer votre ordinateur
*Redémarrer la "box" ADSL
*Si cela ne fonctionne toujours pas, il faut [[#Tester_les_r.C3.A9solutions_DNS|tester les résolutions DNS]].
===Tester les résolutions DNS===
Pour effectuer les tests suivants, il faut ouvrir une fenêtre "[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|en ligne de commandes]]". En cas de problème, il faut nous rapporter les résultats en ouvrant un rapport de bug sur le [http://bts.openflyers.ogr BTS]. Pour cela, il est pratique de procéder par [[#Copier.2FColler_dans_une_fen.C3.AAtre_en_ligne_de_commande|copier/coller]].
*Dans la fenêtre en ligne de commande taper ce qui suit (en remplaçant '''structure_aéro''' par le sous-domaine correspondant à votre structure aéronautique) :
<bash>ping structure_aéro.openflyers.fr</bash>
La réponse normale est pour OpenFlyers 3.0 :
Envoi d'une requête 'ping' sur serveur6-of3.openflyers.net [87.98.143.237] avec 32 octets de données :
Réponse de 87.98.143.237 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur6-of3.openflyers.net" ou "Réponse de 87.98.143.237" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 2.1 :
Envoi d'une requête 'ping' sur serveur6-of21.openflyers.net [91.121.47.179] avec 32 octets de données :
Réponse de 91.121.47.179 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur5-of21.openflyers.net" ou "Réponse de 91.121.47.179" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 1.3 :
Envoi d'une requête 'ping' sur serveur6-of1.openflyers.net [178.33.105.217] avec 32 octets de données :
Réponse de 178.33.105.217 : octets=32 temps=41 ms TTL=55
Si vous n'avez pas "serveur6-of1.openflyers.net" ou "Réponse de 178.33.105.217" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].
====Tests plus poussés====
*Faire un :
<bash>nslookup structure_aéro.openflyers.fr</bash>
*Et un :
<bash>tracert structure_aéro.openflyers.fr</bash>
*Faire le test avec '''dig +trace''' :
<bash>dig +trace structure_aéro.openflyers.fr</bash>
Sous Windows, il faudra au préalable récupérer l'utilitaire (par exemple dans un package [http://www.isc.org./downloads bind]). Une fois téléchargé le package, il faut copier/coller le programme dig ainsi que les fichiers .dll dans un répertoire commun et se positionner dans ce répertoire depuis la fenêtre en ligne de commandes avec la commande dir '''"nom du chemin du répertoire"'''.

====Tester les résolutions DNS sous Mac====
De plus, nous disposons de commandes plus puissantes qui permettent d'avoir d'avantage d'informations :
*cat /etc/resolv.conf

===Vérifier la configuration de résolution des DNS===
====Vérifier la configuration de résolution des DNS sous Windows====
Si vous avez un problème de résolution DNS sous windows, il peut être utile de vérifier que la résolution DNS est dynamique :
#Double-cliquer sur la connexion réseau concernée (par exemple le symbole "WIFI")
#Cliquer sur '''Propriétés''' dans l'onglet '''Général''' de l''''Etat de Connexion réseau sans fil''' (si WIFI))
#Sélectionner '''Protocole internet TCP/IP'''
#Cliquer sur '''Propriétés'''
#Vérifier qu'est sélectionné '''Obtenir les adresses des serveurs DNS automatiquement'''. (si ce n'est pas le cas, modifier).
#En dernier ressort, [[#Changer de serveur DNS|Changer de serveur DNS]] ou [[#Forcer_les_DNS|Forcer les DNS]].

===Nous communiquez les adresses IP des serveurs DNS===
====Nous communiquez les adresses IP des serveurs DNS sous Windows====
#[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|Ouvrir une fenêtre en ligne de commande]]
#Taper : '''ipconfig /all'''
Les adresses IP des serveurs DNS se trouvent au droit de '''Serveurs DNS'''

===Changer de serveur DNS===
Si vous rencontrez un problème de résolution de DNS avec votre fournisseur d'accès, vous pouvez changer les serveurs qui effectue la résolution des DNS pour votre accès.
====Changer de serveur DNS sous Mac====
*Dans '''Préférences Systèmes''', choisir '''Réseau''', puis une fois la bonne carte réseau sélectionnée, appuyer sur Avancé.
*Dans la fenêtre qui apparaît, aller sur l'onglet '''DNS''' et dans '''Serveurs DNS''' appuyer sur le + pour ajouter '''8.8.8.8''' et une autre fois pour ajouter '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Il ne reste plus qu'à '''Appliquer''' et à tester.

====Changer de serveur DNS sous Windows XP====
*'''Démarrer > Connexions''' puis cliquer sur la connexion réseau active (par exemple la connexion WIFI)
*Cliquer sur '''Propriétés'''
*Sélectionner '''Protocole Internet (TCP/IP)'''
*Cliquer sur '''Propriétés'''
*En général, en bas de la fenêtre '''Propriétés de Protocole Internet (TCP/IP)''' la configuration active est : '''Obtenir les adresses des serveurs DNS automatiquement'''
*Cocher '''Utiliser l'adresse de serveur DNS suivante :'''
*Pour '''Serveur DNS préféré''', saisir '''8.8.8.8'''
*Pour '''Serveur DNS auxiliaire''', saisir '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Cliquer sur '''OK'''
*Cliquer sur '''OK'''
*Cliquer sur '''Fermer'''

===Forcer les DNS===
====Forcer les DNS sous Windows====
Attention, avec Vista, il faut appliquer une [[#Particularit.C3.A9_avec_Windows_Vista|procédure préalable]].
*Il est possible de résoudre ce problème de DNS en éditant le fichier C:\WINDOWS\system32\drivers\etc\hosts (avec le bloc-notes) en rajoutant la ligne (il faut remplacer structure_aéro par le sous-domaine de l'espace OpenFlyers de votre structure aéronautique) :
**Pour OF 1.3 :
<pre>178.33.105.217 structure_aéro.openflyers.fr</pre>
**Pour OF 2.1 :
<pre>91.121.47.179 structure_aéro.openflyers.fr</pre>
**Pour OF 3.0alpha :
<pre>87.98.143.237 structure_aéro.openflyers.fr</pre>
*Ensuite, il faut relancer votre PC
*Une fois la connexion correctement effectuée, il est parfois possible de supprimer cette entrée dans le fichier hosts tout en gardant la connexion.

====Particularité avec Windows Vista====
*Il faut être administrateur pour pouvoir modifier le fichier hosts.
*Il faut également copier le fichier hosts sur le bureau pour le modifier puis ensuite le recopier dans le bon répertoire (si on édite directement le fichier hosts depuis (system32\drivers\etc\) on ne peut pas le ré-enregistrer).

====Forcer les DNS sous Mac====
*lancer Terminal (dans Applications/Utilitaires)
*taper "sudo nano /etc/hosts" (il demande le mot de passe de l'utilisateur qui a les droits admin sur la machine)
*Ajouter les entrées sur le modèle de la [[#Forcer_les_DNS_sous_Windows|procédure sous Windows]]
*Faire controle-o pour enregistrer puis controle-x pour quitter
*Eventuellement, faire "dscacheutil -flushcache" si le changement n'est pas encore pris en compte.

==A chaque fois que je change de page, je reviens sur la page d'identification ?==
Si le retour à la page d'identification est systématique, alors il doit s'agir d'un problème de '''cookies'''. Il faut modifier la configuration du navigateur de manière à [[#Autoriser_les_cookies|autoriser les cookies]].

===Variante du problème : la déconnexion n'est pas systématique mais aléatoire===
Dans ce cas, il peut s'agir aussi d'un problème de proxy (si vous êtes sur un réseau d'entreprise par exemple) ou de fournisseurs d'accès (accès depuis un mobile, depuis un hôtel, bref, tout type d'accès qui change régulièrement l'adresse IP et ainsi ne permet de maintenir un accès authentifié dans la durée. La solution est présentée dans la procédure [[#Utiliser_OpenFlyers_sur_un_smartphone|Utiliser OpenFlyers sur un smartPhone]].

==Plusieurs membres peuvent-ils ouvrir des sessions en même temps (sans le savoir) ?==
Oui, c'est même le but premier : permettre à plusieurs personnes de consulter en même temps le cahier de réservation.

Vous pouvez même avoir une personne qui ouvre plusieurs sessions avec son identifiant. Mais pour cela, elle doit utiliser des ordinateurs ou des navigateurs différents.
==Suite à une migration, impossible de naviguer dans la nouvelle version d'OpenFlyers==
Lorsque nous migrons d'une version vers une autre, bien souvent nous le faisons en changeant les "DNS". Cela peut occasionner des problèmes d'accès. Il peut également apparaitre des problèmes de "cache" qui se résolvent d'eux sous 24 à 48 heures. Ces problèmes peuvent survenir lorsque l'ordinateur concerné a été connecté à l'ancienne plateforme OpenFlyers juste avant la migration.

Voici différentes techniques qui permettent d'imposer à votre navigateur d'utiliser des DNS actualisées et d'utiliser un cache à jour :
#Penser à éteindre et rallumer complètement l'ordinateur
#Faites un CTRL+R (ou icône de "rafraichissement"). Bien souvent cela suffit au navigateur pour qu'il vide son cache et le ré-actualise
#Vider le cache dans le navigateur
#Supprimer les cookies dans le navigateur
Plus technique :
#Faites un ipconfig /flushdns en ligne de commande (menu démarrer, puis "Exécutez", taper "cmd")
#Forcer les nouvelles DNS dans le fichier C:\WINDOWS\system32\drivers\etc\hosts en ajoutant une ligne du genre : xxx.xxx.xxx.xxx xxx.openflyers.zz (nous demandez pour connaitre les valeurs à utiliser)

De plus, afin de permettre quand même d'accéder à la nouvelle plateforme, nous mettons en place une deuxième URL temporaire pendant 1 semaine. Ainsi pour l'URL plateforme.openflyers.fr nous mettrons en place une URL temporaire plateforme2.openflyers.fr

=Navigation dans OpenFlyers=
OpenFlyers est un logiciel qui s'utilise grâce à votre navigateur internet. Les plus connus sont Chrome, Firefox, Internet Explorer ou Safari.
Une certaine configuration est nécessaire afin de faire fonctionner OpenFlyers : la configuration des cookies.
Si vous rencontrez des problèmes d'utilisations tels que :

*Impossibilité de se connecter alors que votre identifiant et mot de passe est correct
*Impossibilité d'aller d'un page à l'autre une fois connecté (et retour sur la page de connexion)

Voila comment régler votre navigateur.
==Comment autoriser les cookies avec Firefox==
Allez dans le menu Outils puis choisissez Option
[[Image:Ff-1.jpg]]

Dans la rubrique '''Vie privée''', cochez '''Accepter les cookies'''.
[[Image:Ff-2.jpg]]

==Comment autoriser les cookies avec Internet Explorer==
Double cliquez sur la mappemonde situé dans la barre de tache (en bas).

[[Image:Ie-1.jpg]]
Sélectionnez les '''Sites de confiances'''. Sélectionnez le niveau bas. Cliquez ensuite sur le bouton '''Sites'''.

[[Image:Ie-2.jpg]]
Rajoutez l'adresse du site de la réservation en décochant Â« Exigez un serveur sécurisé â€¦ Â».

[[Image:Ie-3.jpg]]

'''Fermez puis redémarrez Internet Explorer.'''

==Problème de navigation sur un réseau GSM==
OpenFlyers est accessible sur les smartphones par le biais du navigateur embarqué. Cependant, des problèmes de session peuvent survenir du fait du changement dynamique de l'adresse IP du smartphone du fait du réseau GSM. Pour palier à ce problème et éviter des déconnexions intempestives, il faut se connecter en HTTPS.

De plus, et toujours en HTTPS, il est possible de [[#Transmettre_l.27identifiant_et_le_mot_de_passe_dans_l.27URL|rajouter le couple identifiant/mot de passe à la suite de l'URL sécurisée]] et d'enregistrer cette URL en favori. Ainsi, il n'est plus nécessaire de saisir systématiquement son identifiant et son mot de passe.

==Problèmes de navigation sous iPhone==
*Penser à mettre à jour le logiciel de l'iPhone. OpenFlyers fonctionne correctement pour une version au moins 4.02.
*Activer l'[[#Autoriser_les_cookies_sous_iPhone_.2F_Safari|acceptation des cookies]]
*Si la navigation était possible sur une version précédente d'OpenFlyers et qu'elle n'est plus possible sur une nouvelle version d'OpenFlyers, alors il peut être nécessaire de vider le cache du navigateur Safari de l'iPhone :
**'''Réglages > Safari'''
**'''Effacer cookies et données'''

=Transmettre l'identifiant et le mot de passe dans l'URL=
Si vous souhaitez transmettre le couple identifiant/mot de passe dans l'URL dans le but de pouvoir les sauver facilement, vous avez besoin d'un [http://www.openflyers.com/doc/catalogue-tarifaire.pdf abonnement HTTPS] et alors l'URL doit avoir la forme :
https://mySpaceName.openflyers.tld?login=myLogin&password=myPassword
où :
*mySpaceName doit être remplacé par le nom du compte openflyers
*tld doit être remplacé par l'extension (comme de, fr, us, etc.)
*myLogin doit être remplacé par votre identifiant
*myPassword doit être remplacé par votre mot de passe

=Cahier de réservation=
==Que se passe t-il en cas de conflit de réservation ?==
Il ne peut y avoir de conflit de réservation. C'est l'un des principes durs d'OpenFlyers : à chaque instant donné, il ne peut y avoir plus d'une réservation pour chaque pilote, chaque avion ou chaque instructeur.

Si vous arrivez à faire des réservations qui se chevauchent (pour un avion, un instructeur ou un pilote), alors vous avez mis en évidence un bug, et il faut nous le signaler pour que nous y remédions.

==Si je suis en train de consulter une page, et que quelqu'un fait une modif sur cette page, vais-je voir la modif sans lancer un rafraichissement ?==
Non vous ne verrez pas la modification. Cependant, ce n'est pas grave car au moment où vous essayerez de faire votre réservation, OpenFlyers vérifiera à ce moment-là que le créneau que vous souhaitez est toujours disponible (pour empêcher les conflits justement).

==Comment saisir une date rapidement dans la gestion des qualifications ?==
En cliquant sur l'icône "calendrier" placé par défaut au mois courant, vous pourrez vous déplacer mois par mois ou année par année en cliquant sur les flèches respectives. Pour des dates plus anciennes, passez le curseur de votre souris sur l'endroit où se trouve le texte correspondant à "Mois Année". Ce texte s'encadre alors d'une bordure. Faites un clic dessus et une nouvelle petite fenêtre va s'ouvrir. Là vous pourrez saisir l'année en tapant les chiffres avec votre clavier.

==A propos des horaires de la nuit aéronautique==

Nous calculons les éphémérides d'après les définitions officielles.

Ainsi, les heures de lever et de coucher du soleil correspondent au passage du centre du soleil sous l'horizon (donc 3 degrés sous l'horizon puisqu'il est considéré, en première approximation que le soleil a un diamètre apparent de 6 degrés).

Les heures du jour et de la nuit aéronautique correspondent au passage du soleil 6 degrés sous l'horizon. Il s'agit de la définition officielle, aussi bien française, qu'internationale (OACI). Le calcul est validé pour les latitudes inférieures à 65 degrés. Sa précision est de l'ordre de la minute sous des latitudes inférieures à 50 degrés. La précision diminue au fur et à mesure que la latitude augmente (c'est à dire que l'on se rapproche des pôles).

Conséquence du calcul : les résultats trouvés ne correspondent pas (forcément) à la simple addition de + ou - 30 minutes. Mais il n'a jamais été écrit dans un texte officiel que la journée aéronautique correspondait au lever du soleil moins trente minutes, et que la nuit aéronautique correspondait au coucher du soleil plus trente minutes. La seule chose que vous trouverez, si vous vous penchez sur les textes, c'est qu'il est admis d'utiliser + ou - 30 minutes pour faire les calculs sous des latitudes comprises entre 30 et 60 degrés et 15 minutes sous les latitudes inférieures à 30 degrés). Voir [http://www.anpi.asso.fr/Reglesair.pdf Règles de l'air - Chapitre 1er - Définitions]
Attention: certains pays n'utilisent pas la nuit aéronautique et ne permettent pas le vol en dehors du lever et du coucher du soleil

Le résultat proposé est donc le bon résultat. Si vous ne souhaitez pas utiliser ce résultat, il vous suffit de retrancher ou d'ajouter 30 minutes au calcul du lever et du coucher du soleil.

Cependant, nous attirons votre attention sur l'intérêt d'utiliser le bon calcul : il vous met du bon côté du point de vue de la sécurité. En effet, si en été vous y gagnez, c'est parce que le soleil met plus de temps à se coucher. Par contre en hiver, notre calcul fait "perdre" une dizaine de minutes : c'est parce que le soleil met moins de temps à se coucher. Calculer l'écart entre la nuit aéronautique et le coucher du soleil (et comparer avec les 30 minutes) vous permettra d'avoir une idée de la "vitesse" avec laquelle se couche le soleil, donc de vous méfier encore plus de l'arrivée de la nuit et de ne pas vous faire surprendre par le crépuscule.

Qui ne s'est jamais retrouvé au sol en ayant voulu "tangenter" avec la nuit et s'est surpris à constater qu'il faisait bien sombre, tout d'un coup ?

Le programme calcule les heures de coucher/lever du soleil à partir des coordonnées géographique du terrain de base. Si vous constatez que vos heures sont erronées, demander à votre administrateur qu'il vérifie le code OACI dans les paramètres de la structure aéronautique.

=Saisie des vols=
==Nos avions ont des compteurs en heures, centièmes, peut-on avoir un affichage en heures, minutes ?==
Chaque utilisateur paramètre son affichage comme il le souhaite dans Données/Affichage et fiche personnelle
[[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format Patron de date et heure]]

== Comment saisir plusieurs pilotes pour un vol ?==
Saisir les vols dans OF comme dans le carnet de route de l'avion
== Comment partager les coûts d'un vol ?==
Si un pilote veux partager les frais du vol (sans être pilote) il doit faire un transfert de son compte vers le compte du pilote
Menu Comtes/Transférer

=Divers=
==Peut-il y avoir des accès à plusieurs sur la base ?==
Oui, sinon deux membres ne pourraient pas consulter le cahier en même temps.

Par contre, lorsqu'un membre réserve un avion, au moment où OpenFlyers teste la disponibilité du créneau, il empêche toute autre écriture sur la base concernant les réservations. Le but est d'empécher justement les conflits de réservation.

=Actions dynamiques non prises en compte par OpenFlyers=
OpenFlyers met en oeuvre des actions dites "dynamiques" c'est à dire qui ne nécessite pas un rafraîchissement complet de la page pour être prises en comptes. Ces actions sont basées sur le principe "[http://fr.wikipedia.org/wiki/Asynchronous_JavaScript_and_XML AJAX]". Elles nécessitent l'activation du moteur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] du navigateur pour être opérationnelles.

De plus, certaines commandes [http://fr.wikipedia.org/wiki/JavaScript JavaScript] ne sont pas reconnues par tous les navigateurs.

Ainsi, lorsque vous lancez une action dynamique dans OpenFlyers qui reste sans résultat, avant de rapporter l'anomalie sur le [http://bts.openflyers.org BTS] il faut vérifier :
#L'activation de [http://fr.wikipedia.org/wiki/JavaScript JavaScript] dans le navigateur utilisé.
#Tester avec un autre navigateur
#Dans le cas où JavaScript est activé, il faut rapporter l'anomalie sur le [http://bts.openflyers.org BTS] en précisant le navigateur sur lequel l'action est inefficace et le navigateur sur lequel l'action est efficace.
Vous pouvez également nous facilitez la correction de l'anomalie en nous rapportant le message d'erreur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] s'il y a lieu.

=Comment exporter les données ?=
OF affiche une page XHTML ce qui signifie un texte correctement formaté qui peut être récupéré par un simple copier coller. Le tableur Calc de Open Office ou Libre Office interprète correctement ce HTML et le formate en colonne conformément à la présentation de votre page.

Il a cependant un paramétrage à faire pour que les textes soit correctement encodé (affichage des caractères accentués) et que les cellules numériques affichent le format correct

*Allez dans l'onglet Outils/Options/Chargement&Enegistrement/Compatibilité HTML (Tools/Options/Load&Save/HTML Compatibility)
*Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")
*Par la même occasion vous pouvez aussi changer le Jeu d'encodage (Character set) par Unicode (UTF-8)

Le programme interprète alors le point comme le séparateur décimal et vous avez directement le bon copier/coller Si vous avec choisi l'encodage UTF-8 les caractères accentués seront aussi correctement traduits (A rechanger si vous avez à faire des copier coller depuis des programmes à l'encodage CP1252 "Windows Microsoft")

Pour les exports au format csv voir [[FAQ csv reading with Oo]]

=Paramétrage et données personnelles=

==Peut-on être averti automatiquement des réservations annulées ?==
Dans la version 3 d'OpenFlyers, il est possible pour chaque utilisateur de paramétrer OpenFlyers de sort à être averti par e-mail lorsqu'un créneau se libère. Voici comment configurer cela :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''', sélectionner '''Notification des réservations annulées'''
*Cliquer sur le bouton '''Sauver'''

==Peut-on être averti des réservations sur plusieurs adresses e-mail ?==

Il est possible d'utiliser plusieurs adresses e-mails afin d'être averti des réservations.

Voici comment procéder :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''' puis au niveau du champ '''E-mail'''
*Rentrer chacune des adresses e-mails en les séparant d'une virgule
'''Attention : il ne faut jamais mettre d'espace : ni dans l'adresse e-mail elle même, ni avant ou après les virgules de séparation des adresses e-mails'''

Exemple valide :
<pre>jesuisuntest@test.fr,jesuisuntest@test.com</pre>

Exemples non valides :
<pre>jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr, jesuisuntest@test.com</pre>

Accéder à l'application et aller dans le menu Données > Affichage et fiche personnelle

==Comment changer mes options d'affichage ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Option d'affichage'''

Dans les champs choisissez les paramètres selon vos souhaits: langue, heure local ou UTC, format monétaire,...

Sélectionner les avions et instructeurs que sous voulez afficher

==Affichage des dates et des heures==
Chaque utilisateur paramètre son affichage des dates et des heures comme il le souhaite dans '''Données > Affichage et fiche personnelle'''

Ressources sur les [[http://doc-en.openflyers.com/index.php?title=UserDoc2.0#Date_and_time_format patrons de date et heure]]

==Comment modifier mes paramétrages ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Fiche personnelle'''

Charger une photo pour le trombinoscope

La date de naissance, le sexe et la nationalité sont obligatoire pour que les statistiques DGAC puisse être calculés

Mettez votre email et vos numéros de téléphone pour qu'on puisse vous contacter. Vous pouvez choisir ceux qui sont public ou non.

Dans ce dernier cas seul les personnes avec des droits administrateur pourrons voir ces infos.

==J'ai oublié mon mot de passe, comment le récupérer ?==
Il n'est pas possible de "retrouver" son mot de passe perdu dans OpenFlyers. En effet, ces derniers sont cryptés dans la base de données pour des raisons de confidentialités.

Si vous avez oublié votre mot de passe, vous n'avez pas besoin de demander à votre administrateur une ré-initialisation, OpenFlyers dispose d'une procédure de ré-initialisation automatique :

*Sur la page de connexion d'une plateforme OpenFlyers, cliquer sur le lien "Mot de passe oublié"
*:[[Fichier:FAQ_user_forgottenPassword.png]]
*Sur la page qui s'affiche il y a deux zones de saisie. Saisissez l'email que vous avez indiqué dans votre page personnelle. Il vous sera envoyé un email vous donnant votre identifiant et un code d'activation
*Revenez sur la page de ré-initialisation et mettez ces informations. Un nouvel email vous sera envoyé avec votre mot de passe

Vous pouvez maintenant accéder à l'application. Pour mettre un mot de passe personnalisé voir [[#Comment_changer_de_mot_de_passe|Comment changer son mot de passe]]

==Comment changer de mot de passe==
*Dans '''Données > Affichage et fiche personnelle'''
*Aller en bas de la page, dans le formulaire '''Changer de mot de passe''' et saisissez votre nouveau mot de passe

Un indicateur vous indique le niveau de fiabilité. Mélanger les minuscules/majuscules/chiffres et sigles pour augmenter la difficulté pour des robots de trouver votre mot de passe. La sécurité de l'application de votre club sera ainsi accrue.

=Trucs et astuces=
==Fenêtre en ligne de commande==
===Ouvrir une fenêtre en ligne de commande===
====Ouvrir une fenêtre en ligne de commande sous Windows====
*Aller dans le menu "Démarrer"
*Puis Tous les programmes/Accessoires
*Lancer l'"invite de commandes"
====Ouvrir une fenêtre en ligne de commande sous Mac====
Sous OSX (mac) il faut lancer un Terminal. Pour cela 2 solutions :
*Taper "terminal" dans spotlight
ou
*lancer l'application qui est dans Applications > Utilitaires.

===Copier/Coller dans une fenêtre en ligne de commande===
====Copier/Coller dans une fenêtre en ligne de commande sous Windows====
Vous pouvez faire un copier/coller en utilisant le bouton droit de la souris dans la fenêtre de l'invite de commandes puis en choisissant '''sélectionner''' et ensuite en appuyant sur le bouton gauche et en le laissant appuyer tout en sélectionnant la zone souhaitée)

====Copier/Coller dans une fenêtre en ligne de commande sous Mac====
Pour faire un copier/coller de ces informations et nous les communiquer, il suffit d'utiliser commande-C dans le terminal.

=Comment imprimer la doc ?=
Si vous souhaitez imprimer la doc, il vous suffit de :
*cliquer sur le lien "version imprimable" de la "boîte à outils" présente sur le côté gauche des pages du wiki. Vous obtiendrez ainsi une version des pages destinée à être imprimer.
*ou bien, utiliser la fonction imprimer de votre navigateur. Une mise en page spécifique est générée pour obtenir un format papier

Si vous imprimer avec une Imprimante pdf ([http://www.pdfforge.org/pdfcreator pdfCreator] par exemple) vous générerez alors un format pdf pour archivage

=Problèmes=
==Signaler un problème==
Si vous rencontrer une anomalie ou un bug dans l'application OpenFlyers, il faut le rapporter sur le [http://bts.openflyers.org BTS] pour une prise en compte la plus rapide possible et pour permettre un meilleur traitement et suivi.

Pour rapporter une anomalie il faut :
*Aller sur la page http://bts.openflyers.org
*S'inscrire sur le BTS en cliquant sur '''Signup for a new account''' : il faut choisir un identifiant, une adresse e-mail puis cliquer sur '''Signup'''.
Un e-mail est envoyé par le BTS permettant de valider votre adresse e-mail. Cliquer sur le lien présent sur cet e-mail.
*Sur le formulaire qui apparait, Choisir :
**Un mot de passe dans les champs '''Password''' et '''Confirm Password'''
**Compléter éventuellement le champ '''Real Name'''
*Cliquer sur le bouton '''Update account'''
Votre compte pour rapporter un problème sur le BTS est ainsi créé. Un nouveau formulaire d'identification s'affiche automatiquement :
*Renseigner les champs '''Username''' et '''Password'''
*Sélectionner éventuellement sur '''Remember my login in this browser''' afin de ne plus avoir à s'identifier lors d'une nouvelle connexion depuis le même navigateur internet.
*Dé-sélectionner éventuellement le champ '''Only allow your session to be used from this IP address.''' qui limite les possibilités de connexion
*Cliquer sur '''Login'''
*Aller dans l'onglet '''Preferences'''
*En bas du formulaire, modifier le champ '''Language''' pour choisir '''french'''.
*Cliquer sur '''Update Prefs'''
Vous pouvez alors tranquillement rapporter un bug depuis le formulaire '''Rapporter un bogue'''

==Problème d'auto-complétion des terrains==
*Si les terrains d'arrivée et de départ ne s'affichent pas, vérifier la [[Browsers_compatibility#Versions_support.C3.A9es|compatibilité de votre navigateur]].
*La version 2.1 d'OpenFlyers n'est pas supportée par Internet Explorer 10.
*En revanche, la version 3.0.3 d'OpenFlyers est supportée par les versions d'Internet Explorer supérieures à 8.
Si vous êtes sous la version 2.1 d'OpenFlyers avec comme navigateur Internet Explorer alors vous avez 2 solutions :
*Changer de navigateur
*[[FAQ_client#Comment_se_fait_la_migration_vers_une_version_sup.C3.A9rieure_.3F|Demander à migrer]] sous la version 3.0.3 d'OpenFlyers.

Modèle commercial et compte client OpenFlyers

2015-04-03T14:07:10Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Le paramétrage lié aux [[OF_Configuration_Accounting3#Param.C3.A9trage_g.C3.A9n.C3.A9ral_des_comptabilit.C3.A9s|alertes de solde]] ou au [[UserDoc3#Rappel_des_r.C3.A9servations_par_e-mail|rappel des réservations]] par e-mail n'est pas effective sur la plateforme de test.

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** Si vous êtes sous la version 3.5 :
*** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
*** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
** Si vous êtes sous la version 3.5 ou supérieure :
*** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Modèle commercial et compte client OpenFlyers

2015-03-26T11:43:34Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** Si vous êtes sous la version 3.5 :
*** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
*** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
** Si vous êtes sous la version 3.5 ou supérieure :
*** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Modèle commercial et compte client OpenFlyers

2015-03-26T11:20:12Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Pour les clients sous la version 3.5, plusieurs choix sont proposés :
** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
* Pour les clients sous la version 4, seulement ce choix est proposé :
** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Modèle commercial et compte client OpenFlyers

2015-03-26T10:53:02Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Modèle commercial et compte client OpenFlyers

2015-03-26T08:29:34Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
" est supprimé lors de la recopie.
** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Fichier:Refresh.png

2015-03-25T14:52:33Z

Jcheng : Jcheng uploaded a new version of Fichier:Refresh.png

Formules de calcul

2015-03-25T13:52:38Z

Jcheng : /* changeTime('date', 'année', 'mois', 'jour') */

Formules de calcul

2015-03-25T13:46:42Z

Jcheng : /* Formule calculant la date dans un an ou dans un an après la date d'expiration d'une validité déjà détenue */

Modèle commercial et compte client OpenFlyers

2015-03-25T12:47:04Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** '''De demo.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo
** '''De acbd.openflyers.fr vers acbd.test.openflyers.fr''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
** '''De acbd.openflyers.fr vers acbd.of4.openflyers.fr''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>

Modèle commercial et compte client OpenFlyers

2015-03-25T12:46:47Z

Jcheng : /* Plateforme supplémentaire de test */

__TOC__
=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur le [https://client.openflyers.com compte client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au sous-domaine de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://mermoz.openflyers.fr

Alors le sous-domaine est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 2 changements suivants :
*Mettre à jour le [[AdminDoc3#Champ_Responsable_OpenFlyers|champ du responsable OpenFlyers au niveau de la plateforme]]
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Certaines migrations peuvent induire des opérations de nettoyage à effectuer manuellement. Ces opérations sont prises en charge dans le cas des abonnements Business, Première et Corporate. Elles sont facturées dans le cas de l'abonnement First Price. La structure peut également effectuer elle-même les opérations de nettoyage dans le cas d'un abonnement First Price en suivant la [[Accueil#Proc.C3.A9dures_de_mont.C3.A9e_de_version|procédure de montée de version]] publiée par OpenFlyers. Exemple de procédure de nettoyage : [[Upgrade3|nettoyage suite à migration vers une version 3]].

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.
*Après une migration, il peut être nécessaire de forcer le rafraichissement du "cache" du navigateur en appuyant sur CTRL+R (ou icône "Actualiser" ou "Rafraichir" suivant les navigateurs) afin d'obliger le navigateur à charger en mémoire les scripts qui correspondent à la nouvelle version.
*De même, l'accès à la plateforme via son URL peut ne pas fonctionner pendant 1 ou 2 jours du fait des serveurs disposant de "caches DNS". Afin de palier à ce défaut, nous fournissons une URL de substitution pendant une semaine qui permet quand même d'accéder à la plateforme.
*Le temps d'indisponibilité d'accès à la plateforme est de l'ordre de quelques minutes en général. Il est donc transparent pour la plupart des utilisateurs. Par contre, s'il y a un travail de nettoyage post-migration à effectuer par OpenFlyers, ce nettoyage peut durer plusieurs heures. Il n'empêche pas l'utilisation de la plateforme.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[AdminDoc2.1#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource : il suffit de [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver l'ancienne ressource]] avant d'[[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|activer la nouvelle]].

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez nous demander de [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité disponible que pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** De demo.openflyers.fr vers acbd.test.openflyers.fr : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo
** De acbd.openflyers.fr vers acbd.test.openflyers.fr : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
** De acbd.openflyers.fr vers acbd.of4.openflyers.fr : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://acbd.openflyers.fr</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://acbd.test.openflyers.fr</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://acbd.of4.openflyers.fr</pre>