Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
fr:guides:first-run [2016/03/11 19:37]
brice créée
fr:guides:first-run [2016/03/17 16:07]
Ligne 1: Ligne 1:
-====== First-run ====== 
-{{tag>​guide erp administration first-run}} 
- 
-Le **First-Run** est la première marche à gravir pour utiliser Ekylibre. Il permet de configurer rapidement toute l'​application pour les besoins de la structure tout en reprenant tout l'​historique disponible. Ce concept a été mis en place pour palier à la complexité connue des [[http://​fr.wikipedia.org/​wiki/​Progiciel_de_gestion_intégré|ERP]] qui d'​habitude,​ nécessitent de longues journées de paramétrage et de saisie avant de pouvoir s'en servir. 
- 
-Aujourd'​hui cette étape passe par la création d'un dossier rassemblant l'​ensemble des fichiers de l'​exploitation. Ce dossier est ensuite utilisé par Ekylibre pour tout importer. 
- 
-<WRAP center round info 60%> 
-**Objectifs** : 
- 
-  * Être capable de récupérer ses données provenant de diverses sources et via divers moyens 
-  * Comprendre l'​arborescence des dossiers et le nommage des fichiers du dossier de //​first-run//​ 
-  * Lancer le //​first-run//​ et retrouver ses données dans l'​application 
-</​WRAP>​ 
- 
- 
- 
-===== Création du dossier de First-Run ===== 
- 
- 
-==== Pré-requis ==== 
- 
-  - une adresse e-mail valide, 
-  - une suite bureautique classique comme [[https://​fr.libreoffice.org|LibreOffice]],​ 
-  - les informations de sa société (N° de SIREN, SIRET, PACAGE...), ses identifiants métiers (noms d'​utilisateur et mots de passe) ainsi qu'un inventaire récent des équipements,​ stocks et autres bâtiments de son exploitation. 
-  - la maîtrise basique d'un outil de cartographie comme [[http://​www.qgis.org/​fr/​site/​index.html|QGIS]] 
- 
-<WRAP center round tip 60%> 
-Ressources utiles QGIS 
-  - [[http://​docs.qgis.org/​2.6/​fr/​docs/​gentle_gis_introduction/​|Introduction au SIG]] 
-  - [[http://​www.qgis.org/​fr/​site/​forusers/​download.html|Téléchargement]] 
-  - [[http://​www.qgis.org/​fr/​docs/​index.html|Documentation]] 
-  - [[http://​docs.qgis.org/​2.6/​fr/​docs/​user_manual/​|Manuel d'​utilisation 2.6]] 
-  - [[http://​sigea.educagri.fr/​tutoriels-de-logiciels-sig/​tutoriels-qgis.html|Tutoriels proposés par le SIGEA]] 
-</​WRAP>​ 
- 
-==== Données ==== 
-Le //​first-run//​ est une méthode qui est appelée pour charger des données existantes et les transcoder avant de les enregistrer dans la base de données. 
- 
-2 cas peuvent se présenter : 
- 
-  * La source de vos données est connue (coopérative,​ téléPAC...),​ les données seront récupérées puis déposées dans un dossier au nom de la source. ​ 
-  * La source de vos données est inconnue ou non normalisée,​ les données seront saisies dans un tableur puis déposées dans un dossier du répertoire ''​alamano''​. 
- 
-Le but est de construire une arborescence de fichiers qui seront ensuite importés dans **Ekylibre**. 
- 
-=== Préparer son dossier === 
- 
-Pour commencer voici les premières actions à entreprendre : 
- 
-  - Créer un dossier du nom de votre structure ou équivalent (ex : gaecjoulin) 
-  - Créer un sous-dossier "​alamano"​ (ex : gaecjoulin/​alamano) 
- 
-Ce dossier va servir à stocker toutes vos données personnalisées (tableurs...). 
- 
-=== Renseignements de base === 
- 
-Avant toute chose, **Ekylibre** doit connaître certaines informations de base. 
-Ces informations sont stockées dans un fichier au format [[http://​fr.wikipedia.org/​wiki/​YAML|YAML]]. 
- 
-  - à la racine de votre dossier, créez un fichier `manifest.yml` ou bien récupérez celui qui est sur le [[https://​raw.github.com/​ekylibre/​first_run-demo/​master/​manifest.yml|dépôt de démonstration]]. 
-  - ouvrez ce fichier et personnalisez-le selon votre cas. 
- 
-<WRAP center round important 60%> 
-Attention à bien respecter les indentations 
-</​WRAP>​ 
- 
-La liste des codes ou des références sont visibles sur le projet http://​open-nomenclature.org. 
- 
-<code yaml> 
-currency: EUR                                    # Code monnaie 
-country: fr                                      # Code pays 
-language: fra                                    # Code langue 
-map_measure_srid:​ 2154                           # Code référentiel spatial 
-demo: true                                       # Mode démo (oui/non) 
-create_activities_from_telepac:​ false  ​        # Création des activités uniquement à partir des fichiers TELEPAC 
-company: 
-  last_name: GAEC DUPONT ​                        # Nom 
-  addresses: 
-    email: gaec.dupont@truc.com ​                 # Adresse e-mail de votre société 
-    mail: 
-      line_4: 8 rue du bouil bleu                # Adresse de votre société ​ 
-      line_6: 17250 SAINT-PORCHAIRE ​             # Code postal et ville de votre société 
-users: 
-  admin@ekylibre.org: ​                           # Adresse e-mail de l'​utilisateur 1 qui sert d'​identifiant 
-    first_name: Christian ​                       # Prénom 
-    last_name: DUPONT ​                           # Nom de famille 
-    password: 12345678 ​                          # Mot de passe 
-chart_of_account:​ fr_pcga ​                       # Code plan comptable 
-financial_years:​ 
-  EX2010: ​                                       # Code d'un exercice comptable 
-    started_at: 2010-01-01 ​                      # Début d'un exercice comptable (format AAAA-MM-JJ) 
-    stopped_at: 2010-12-31 ​                      # Fin d'un exercice comptable (format AAAA-MM-JJ) 
-catalogs: 
-  VENTE: ​                                        # Code d'un catalogue de prix 
-    name: Prix de vente                          # Nom d'un catalogue de prix 
-    usage: sale                                  # Usage d'un catalogue de prix 
-  COUT: 
-    name: "Prix d'​usage"​ 
-    usage: cost 
-  ACHAT: 
-    name: "Prix d'​achat"​ 
-    usage: purchase 
-journals: 
-  BANQUE: 
-    name: Crédit Agricole 
-    nature: bank 
-    currency: EUR 
-  CAISSE: 
-    name: Caisse 
-    nature: cash 
-    currency: EUR 
-accounts: ​                                       # Description de compte comptables 
-  banque: ​                                       # Code d'un compte comptable de banque 
-    name: Banque CRCA                            # Nom d'un compte de banque 
-    number: 51210000 ​                            # Numéro d'un compte de banque 
-  caisse: ​                                       # Code d'un compte comptable de caisse 
-    name: Caisse ​                                # Nom d'un compte comptable de caisse 
-    number: 531101 ​                              # Numéro d'un compte de caisse 
-cashes: 
-  caisse: ​                                       # Code d'une trésorerie 
-    name: Caisse ​                                # Nom d'une trésorerie 
-    nature: cash_box ​                            # Type d'une trésorerie (compte bancaire ou caisse) 
-    journal: CAISSE ​                               # Code journal d'une trésorerie 
-    account: caisse ​                             # Code comptable d'une trésorerie (décrit au dessus) 
-  banque: 
-    name: Compte courant CA                          
-    journal: BANQUE ​ 
-    account: banque ​ 
-    mode: iban                                   # Mode de saisie IBAN ou BBAN (RIB) 
-    country: fr                                  # Code pays de la banque 
-    iban: "​FR7611111222223333333333391" ​         # Numéro IBAN du compte 
-net_services: ​                                   # Services en ligne 
-  telepac: ​                                      # Nom d'un service web (ex: TELEPAC) 
-    pacage_number:​ 852364554 ​                    # Nom et valeur du premier identifiant pour ce service 
-    password: 12345                              # Nom et valeur du second identifiant pour ce service 
-  synel: 
-    synel_username:​ 17387001 
-    password: 12345 
-  lilco: 
-    lilco_labratory_code:​ toto 
-    password: 12345 
-  msa: 
-    msa_username:​ toto 
-    password: 12345 
-  charentes_alliance_extranet:​ 
-    charentes_alliance_extranet_username:​ toto 
-    password: 12345 
-identifiers: ​                                    # Identifiants 
-  pacage_number:​ 12346578 ​                       # Nom et valeur d'un identifiant 
-  husbandry_owner_number:​ FR01700006989 
-  cattling_root_number:​ 173513 
-  cattling_number:​ FR17387001 
-</​code>​ 
- 
- 
-==== Gestion parcellaire ==== 
- 
-=== Contours des parcelles === 
- 
-== Avec TéléPAC == 
- 
-Si vous avez déjà télédéclaré vos productions,​ il vous suffit de vous connecter à [[https://​www3.telepac.agriculture.gouv.fr|TéléPAC]] et récupérer vos îlots et/ou parcelles dans la partie "​Exports Données"​ puis "​Export îlots et parcelles (shape)"​. 
- 
-  - Créer un dossier ''​telepac''​ à la racine de votre dossier. ​ 
-  - Récupérez vos fichiers parcelles et/ou ilôts au format zippé depuis le site de [[https://​www3.telepac.agriculture.gouv.fr|TéléPAC]]. 
-  - Dézipper vos fichiers dans le répertoire ''​telepac''​. 
-  - Renommer vos fichiers en parcelle.* et/ou ilot.* 
- 
-== Sans TéléPAC == 
- 
-Si vous souhaitez importer votre parcellaire automatiquement,​il faut disposer du ou des fichiers //shape// correspondants ou les faire vous-même. 
-Si vous souhaitez les faire, vous pouvez utiliser [[http://​www.qgis.org/​fr/​site/​|QGIS]]. 
- 
-  - Dessinez vos parcelles avec QGIS en prenant soin de créer un attribut '​number'​ qui représentera votre clef d'​identification avec votre fichier de correspondance. 
-  - Sauvegardez vos fichiers dans le répertoire ''​alamano/​zones''​. 
- 
-> Le SRID de votre couche doit être en 4326 ([[http://​fr.wikipedia.org/​wiki/​WGS_84|WGS 84]]) et votre fichier doit s'​appeler ''​cultivable_zones.shp''​. 
-> Nous vous conseillons d'​ajouter un fond de carte de type "​satellite"​ pour vous aider. 
- 
-Vous pouvez vous aider de les [[https://​github.com/​ekylibre/​first_run-demo/​tree/​master/​alamano/​zones|exemples]] de la démonstration. 
- 
-=== Parcelles === 
- 
-Il faut ensuite créer un fichier de correspondance entre vos formes de parcelles et leur informations. 
- 
-La colonne ''​Shape Number''​ permet de mentionner la //shape// qui correspond à la parcelle concernée. 
- 
-^ Nom              ^ Définition ^ 
-| **Name** ​        | Nom de la parcelle | 
-| **Nature** ​      | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] (laisser ''​land_parcel''​ par défaut) | 
-| **Code** ​        | Numéro de travail (de la forme LP01 ou LP1-1 si TelePAC) | 
-| **Shape Number** | Code d'​identification de la forme dans le fichier ''​cultivable_zones.shp''​ | 
-| **Ilot code** ​   | Code de l’îlot (numéro de 1 à 100 en général) | 
-| Code Place       | Numéro de travail de l'​objet dans lequel se trouve l'​objet courant (LP01 = Ma Zone cultivable est dans la parcelle LP01,LP1-1) | 
-| soil_nature ​     | Code du type de sol dans la [[http://​open-nomenclature.org/​nomenclatures/​soil_natures|nomenclature]] | 
-| soil_depth (cm)  | Valeur de la profondeur du sol en cm | 
-| available_water_capacity_per_area (l/m²) | Valeur de la réserve utile du sol en litre par m² | 
- 
-  - Récupérez le fichier [[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​land_parcels.csv|exemple]] et adaptez-le à votre cas. 
-  - Sauvegardez vos fichiers dans le répertoire ''​alamano''​. 
- 
-Votre fichier doit s’appeler ''​land_parcels.csv''​ et doit garder ses colonnes de bases. 
- 
-=== Zones cultivables === 
- 
-Facultatif si vous utilisez TelePAC. 
- 
-Il faut ensuite créer un fichier de correspondance entre vos zones cultivables et leur informations. 
- 
-La colonne ''​Shape Number''​ permet de mentionner la _shape_ qui correspond à la parcelle concernée. 
- 
-^ Nom          ^ Définition ​        ^ 
-| Name         | Nom de la parcelle | 
-| Nature ​      | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]]) (par défaut ''​cultivable_zone''​) | 
-| Code         | Numéro de travail (ZC1, ZC1-1...) | 
-| Shape Number | Code d'​identification de la forme dans le fichier ''​cultivable_zones.shp''​ | 
-| Codes parcelles membres | Liste des codes de parcelles membres de la zone séparée par une ","​ (LP1-1,​LP1-2) | 
- 
-  - Récupérez le fichier [[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​cultivable_zones.csv|exemple]] et adaptez-le à votre cas. 
-  - Sauvegardez vos fichiers dans le répertoire ''​alamano''​. 
- 
-Votre fichier doit s’appeler ''​cultivable_zones.csv''​ et doit garder ses colonnes de bases. 
- 
-=== Données cartographiques === 
- 
-Si vous souhaitez importer vos zones automatiquement,​ il faut disposer du ou des fichiers //​shapefile//​ correspondant ou les faire vous-même. 
-Si vous souhaitez les faire, vous pouvez utiliser [[http://​www.qgis.org/​fr/​site/​|QGIS]]. 
- 
-  - Dessinez vos zones avec QGIS en prenant soin de créer un attribut "​number"​ qui représentera votre clef d'​identification avec votre fichier de correspondance. 
-  - Sauvegarder vos fichiers dans le répertoire ''​alamano/​georeadings''​. 
- 
-Le SRID de votre couche doit être en 4326 (WGS84). Nous vous conseillons d'​ajouter un fond de carte de type "​satellite"​ pour vous aider. 
- 
-Pour bien faire, vous devez créer dans votre projet QGIS, une couche //​shapefile//​ par type de zones. Chaque type est facultatif. Retrouvez ci-après la liste actuelle des types : 
-  * ''​equipments''​ Équipements (polygones) 
-  * ''​cultivable_zones''​ Zones cultivables (polygones) 
-  * ''​geolocations''​ Géolocalisations (points) 
-  * ''​building_divisions''​ Pièces ou zone de bâtiments (polygones) 
-  * ''​buildings''​ Bâtiments (polygones) 
-  * ''​roads''​ Routes (lignes) 
-  * ''​hedges''​ Haies (lignes) 
-  * ''​water''​ Zones d'eau (polygones) 
- 
-Chaque couche disposera ainsi des fichiers classiques. Exemple pour ''​equipments''​ : ''​equipments.shp'',​ ''​equipments.shx'',​ ''​equipments.dbf''​. 
- 
-Vous pouvez vous aider de l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​georeadings|exemple]] de la démonstration. 
- 
-=== Correspondance des zones === 
- 
-Il faut ensuite créer un fichier de correspondance entre vos contours de zones et leur informations. 
- 
-La colonne ''​Shape Number''​ permet de mentionner la shape qui correspond à la parcelle concernée. 
- 
-^ Nom         ^ Définition ^ 
-| Nom         | Nom de la zone | 
-| Nature ​     | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] (Parcelle, Installation...) | 
-| Code        | Code d'​identification de la forme dans le fichier ''​zones.shp''​ | 
-| Code Place  | Numéro de travail de l'​objet dans lequel se trouve l'​objet courant (LP00 = Mon bâtiment est dans la parcelle LP00) | 
-| Description | Zone libre | 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​zones.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-Votre fichier doit s’appeler ''​zones.csv''​ et doit garder ses colonnes de bases. 
-Vous devez commencer votre liste par les zones de bas niveau et terminer par les zones de haut niveau. 
- 
-==== Gestion des tiers ==== 
- 
-=== Clients / Fournisseurs === 
- 
-Afin de pouvoir utiliser vos tiers, il faut les enregistrer dans **Ekylibre** via un tableur. 
- 
-le renseignement des colonnes **obligatoires** est en gras 
- 
-<WRAP center round info 60%> 
- 
-  * Pour un contact (person) : renseigner **prénom et nom** 
-  * Pour une entreprise (legal_entity) : renseigner **nom** uniquement 
- 
-</​WRAP>​ 
- 
-^ Nom ^ Définition ^ 
-| **Prénom** |  | 
-| **Nom** |  | 
-| **Type** | Type d'​entité [person,​legal_entity] | 
-| Client CC | Code comptable si client (411) | 
-| Fournisseur CC | Code comptable si fournisseur (401) | 
-| **Adresse** | Adresse de l'​entité | 
-| **Code postal** | Code postal de l'​entité | 
-| **Ville** | Ville de l'​entité | 
-| Téléphone |  | 
-| Fax |  | 
-| Portable |  | 
-| Lien | Lien entre entité [management,​work,​collaboration...] (les valeurs disponibles sont visibles dans la [[http://​open-nomenclature.org/​nomenclatures/​entity_link_natures|nomenclature]])| 
-| Cible du lien | Nom complet de l'​entité ciblée par le lien | 
-| Pays | code du pays [fr,​en,​nl...] (les valeurs disponibles sont visibles dans la [[http://​open-nomenclature.org/​nomenclatures/​countries|nomenclature]])| 
-| Email |  | 
-| Actif | mettre 1 si actif autrement passif| 
-| Prospect | mettre 1 si prospect| 
-| Transporteur | mettre 1 si transporteur| 
-| SIREN | N° de SIREN| 
-| TVA | N° de TVA| 
-| APE | N° APE| 
- 
-Votre fichier doit s’appeler ''​entities.csv''​ et doit garder ses colonnes de bases. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​entities.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Main d'​oeuvre === 
- 
-^ Nom ^ Définition ^ 
-| **Nom complet** |  | 
-| **Prénom** |  | 
-| **Nom** |  | 
-| **Type** ​     | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] (manager,​employee,​technician) | 
-| **Code** ​        | Numéro de travail (DJ,BT...) | 
-| **Né le**           | Date de naissance au format AAAA-MM-JJ | 
-| Notes           | Description | 
-| Prix unitaire ​      | Prix unitaire | 
-| Indicateur de prix     | '​usage_duration'​ (pour un taux horaire) | 
-| Email | Email du travailleur (permet de faire le lien avec un tiers)| 
- 
-Votre fichier doit s’appeler ''​workers.csv''​ et doit garder ses colonnes de bases. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​workers.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-==== Gestion des stocks ==== 
- 
-=== Stocks de matières === 
- 
-Afin de pouvoir utiliser vos produits, il faut les enregistrer dans **Ekylibre** via un tableur. 
- 
-Les colonnes à renseigner **obligatoirement** sont en gras. 
- 
- 
-^ Nom                 ^ Définition ^ 
-| **Nom** ​            | Nom de votre produit | 
-| **Variant** ​        | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] (Blé, Paille, Vin...) | 
-| Code emplacement ​   | Numéro de travail de l'​objet dans lequel se trouve l'​objet courant (LP00 = Mon objet est dans l'​objet qui porte le code LP00) | 
-| **Né le**           | Date de naissance/​production au format AAAA-MM-JJ | 
-| Variété ​            | Code de la variété dans la nomenclature. | 
-| Dérivé de           | Code de la variété de **dérivation** dans la nomenclature. Exemple : Pour le **lait de vache**, la variété de dérivation est **vache**. | 
-| Propriétaire ​       | Nom du propriétaire | 
-| **Indicateurs** ​    | Couple clef/valeur séparés par des point-virgules ";"​ (les indicateurs disponibles sont visibles dans la nomenclature) il faut au moins la présence de l'​indicateur //​population//​ | 
-| Notes               | Description | 
-| Prix unitaire ​      | Prix pour une unité de population | 
- 
-Cotre fichier doit s’appeler ''​matters.csv''​ et doit garder ses colonnes de bases. 
- 
-Vous pouvez sauter des lignes pour plus de clarté, les lignes qui possèdent leur première cellule vide ne sont pas prise en compte dans le processus d'​import. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​matters.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-==== Gestion de production ==== 
- 
-=== Équipements === 
- 
-Afin de pouvoir utiliser vos outils, il faut les enregistrer dans **Ekylibre** via un tableur. 
- 
-le renseignement des colonnes **obligatoires** est en gras 
- 
-^ Nom ^ Définition ^ 
-| **nom** | Nom de votre outil | 
-| **variant_nomen** | Code du type d'​objet dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] (Tracteur, Charrue...) | 
-| code | Numéro de travail | 
-| code place | Numéro de travail de l'​objet dans lequel se trouve l'​objet courant (LP00 = Mon objet est dans l'​objet qui porte le code LP00) | 
-| **date naissance** | Date de naissance | 
-| marque | Marque de l'​équipement | 
-| modèle | Modèle de l'​équipement | 
-| nom du propriétaire | Propriétaire | 
-| indicateurs | Couple clef/valeur séparés par ";"​ (les indicateurs disponibles sont visibles dans la [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature]] ) | 
-| prix unitaire | Prix pour une unité d'​indicateur de prix | 
-| indicateur de prix | indicateur d'​unité de prix (les indicateurs disponibles sont visibles dans la [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature]] ) | 
- 
-Votre fichier doit s’appeler ''​equipments.csv''​ et doit garder ses colonnes de bases. 
- 
-Vous pouvez sauter des lignes pour plus de clarté, les lignes qui possède leur première colonne vide ne sont pas prise en compte dans le processus d'​import. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​equipments.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Activités === 
- 
-Étape facultative si vous avez utilisé les fichiers ''​parcelle''​ de TéléPAC et si vous avez renseigné l'​option ''​create_activities_from_telepac:​ true''​ 
- 
-Afin de pouvoir utiliser les interventions correctement,​ il faut paramétrer dans **Ekylibre** vos activités, campagnes et assolements via un tableur. 
- 
-> Productions végétales : une activité comporte une ou plusieurs productions par campagne avec un ou plusieurs supports (parcelles) : Activité = Blé > Production 1 = Blé tendre (Campagne 2014) > Support 1 = Zone Champ Bousseau ZC01 
- 
-> Productions animales : une activité comporte une ou plusieurs productions avec un ou plusieurs supports (zones de bâtiment) : Activité = Vache Laitière > Production 1 = Vache Laitière (Campagne 2014) > Support 1 = Stabulation S05_D05 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **Code activité** ​       | Code du type d'​activité dans la [[http://​open-nomenclature.org/​nomenclatures/​production_natures|nomenclature]] | 
-| Nom activité ​            | Nom personnalisé de votre activité (prend celui de la nomenclature autrement) | 
-| **code variant support** | Code du type de produit dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| Type activité ​           | Type d'​activité (taper auxiliary pour une activité secondaire) | 
-| **Campagne** ​            | Campagne de production (année de récolte pour les productions végétales) | 
-| Code support ​            | Code du produit support de la production (code de la parcelle si production végétale, code d'une zone de bâtiment si production animale) | 
-| **Date de début** ​       | Date de début de la période de production au format AAAA-MM-JJ | 
-| **Date de fin**          | Date de fin de la période de production au format AAAA-MM-JJ | 
-| Irrigué ​                 | Indiquer **1** si le support est irrigué | 
-| Nature de la culture ​    | Indiquer **secondary** pour une culture '​secondaire'​ ou **nitrate_trap** pour une culture '​piège à nitrate'​. La valeur par défaut est **main** pour une culture '​principale'​ | 
-| Usage                    | Indiquer **fodder** pour une production de fourrage, **seed** pour une production de semence. La valeur par défaut est **grain** pour une production de grain | 
-| Indicateurs de rendement pour une production végétale ​    | Couple clef/valeur séparés par des point-virgules ";"​ voir [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature des indicateurs]] et [[http://​open-nomenclature.org/​nomenclatures/​units|nomenclature des unités de mesure]] | 
-| Indicateurs d'une production ​                    | Couple clef/valeur séparés par des point-virgules ";"​ voir [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature des indicateurs]] et [[http://​open-nomenclature.org/​nomenclatures/​units|nomenclature des unités de mesure]] | 
- 
-> Votre fichier doit s’appeler ''​activities.csv''​ et doit garder ces colonnes dans l'​ordre. Les lignes dont la première cellule est vide ne seront pas prisent en compte. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​activities.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
- 
-=== Cultures === 
- 
-Étape facultative si vous voulez saisir des interventions de plantations et/ou de semis dans le logiciel. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **Nom de la culture** ​   | Nom personnalisé de votre culture | 
-| **Code culture** ​        | Code personnalisé de votre culture | 
-| **Code variant culture** | Code du type de culture dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **Code support** ​        | Code du produit support de la culture (code de la zone cultivable, parcelle) | 
-| **Date d'​implantation** ​ | Date de début de la période de production au format AAAA-MM-JJ | 
-| **Espèce/​Variété** ​      | Code de la variété de la culture dans la [[http://​open-nomenclature.org/​nomenclatures/​varieties|nomenclature]] | 
-| **Indicateurs** ​         | Couple clef/valeur séparés par des point-virgules ";"​ voir [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature des indicateurs]] et [[http://​open-nomenclature.org/​nomenclatures/​units|nomenclature des unités de mesure]] | 
- 
-Votre fichier doit s’appeler ''​cultivations.csv''​ et doit garder ces colonnes dans l'​ordre. Les lignes dont la première cellule est vide ne seront pas prisent en compte. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​cultivations.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
- 
-=== Groupe d'​animaux === 
- 
-Étape facultative si vous voulez intégrer vos groupes d'​animaux dans le logiciel. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **Nom** ​   | Nom personnalisé de votre groupe d'​animaux | 
-| **Code nature du groupe** | Code du type de groupe d'​animaux dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **Code nature des membres du groupe** | Code du type d'​animal dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **Numéro de travail** ​        | Code personnalisé de votre groupe | 
-| **Age minimum** ​        | Age minimum en jours pour faire partie du groupe | 
-| **Age maximum** ​        | Age maximum en jours pour faire partie du groupe | 
-| **Sexe** ​        | Code du sexe des membres du groupe d'​animaux dans la [[http://​open-nomenclature.org/​nomenclatures/​sexes|nomenclature]] | 
-| **Code emplacement** ​        | Code du produit dans lequel le groupe réside (code de la zone cultivable, parcelle, division de zone) | 
-| **Date des indicateurs** ​ | Date  au format JJ/MM/AAAA | 
-| **Indicateurs** ​         | Couple clef/valeur séparés par des point-virgules ";"​ voir [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature des indicateurs]] et [[http://​open-nomenclature.org/​nomenclatures/​units|nomenclature des unités de mesure]] | 
- 
-Votre fichier doit s’appeler ''​animal_groups.csv''​ et doit garder ces colonnes dans l'​ordre. Les lignes dont la première cellule est vide ne seront pas prisent en compte. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​animal_groups.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Animaux === 
- 
-Étape facultative si vous voulez intégrer vos animaux dans le logiciel. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **Nom** ​   | Nom personnalisé de votre groupe d'​animaux | 
-| **Code nature de l'​animal** | Code du type de groupe d'​animaux dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **Numéro de travail** ​        | Code personnalisé de votre groupe | 
-| **Code emplacement** ​        | Code du produit dans lequel le groupe réside (code de la zone cultivable, parcelle, division de zone) | 
-| **Code du groupe** ​        | Code du groupe de l'​animal | 
-| **Date de naissance** ​ | Date  au format JJ/MM/AAAA | 
-| Race | Code de la race de l'​animal dans la [[http://​open-nomenclature.org/​nomenclatures/​varieties|nomenclature]] | 
-| Code du propriétaire ​        | Code du propriétaire de l'​animal (si différent de l'​entreprise par défaut)| 
-| **Indicateurs** ​         | Couple clef/valeur séparés par des point-virgules ";"​ voir [[http://​open-nomenclature.org/​nomenclatures/​indicators|nomenclature des indicateurs]] et [[http://​open-nomenclature.org/​nomenclatures/​units|nomenclature des unités de mesure]] | 
- 
-Votre fichier doit s’appeler ''​animals.csv''​ et doit garder ces colonnes dans l'​ordre. Les lignes dont la première cellule est vide ne seront pas prisent en compte. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​animals.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Interventions === 
- 
-Étape facultative si vous voulez importer votre historique d'​interventions en cours sous forme de tableur. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **intervention_id** ​   | identifiant interne | 
-| **campagne** ​   | nom de la campagne | 
-| **Date début** ​   | Date début sous la forme JJ/MM/AAAA | 
-| **Heure début** ​   | Heure début sous la forme HH:MM | 
-| **Durée** ​   | Durée au format décimal | 
-| **Procédure** ​   | Code de la procédure dans la liste des [[https://​github.com/​ekylibre/​ekylibre/​tree/​master/​config/​procedures|procedures]] | 
-| Description ​ | Description de l'​intervention | 
-| **Supports** ​ | Codes des supports séparés par des virgules ou code famile de l'​activité pour les interventions sans support | 
-| cible variant ​ |  | 
-| cible variété ​ |  | 
-| **Code personnes** ​ | Codes des personnes intervenantes séparés par des virgules | 
-| **Code équipements** ​ | Codes des équipements intervenants séparés par des virgules | 
-| code intrant 1  | Code de l'​intrant | 
-| quantité intrant 1  | Quantité de l'​intrant (population) | 
-| unité intrant 1   | Unité de l'​intrant [kilogram,​liter,​meter,​ton,​quintal,​cubic_meter] | 
-| unité de surface de l'​intrant 1   | Unité de surface de l'​intrant 1 [hectare,​square_meter] | 
-| code intrant 2  | Code de l'​intrant | 
-| quantité intrant 2  | Quantité de l'​intrant (population) | 
-| unité intrant 2   | Unité de l'​intrant [kilogram,​liter,​meter,​ton,​quintal,​cubic_meter] | 
-| unité de surface de l'​intrant 2   | Unité de surface de l'​intrant 2 [hectare,​square_meter] | 
-| code intrant 3  | Code de l'​intrant | 
-| quantité intrant 3  | Quantité de l'​intrant (population) | 
-| unité intrant 3   | Unité de l'​intrant [kilogram,​liter,​meter,​ton,​quintal,​cubic_meter] | 
-| unité de surface de l'​intrant 3   | Unité de surface de l'​intrant 3 [hectare,​square_meter] | 
- 
-Il est possible de positionner jusqu'​à trois intrants si la procédure selectionnée le supporte. 
-Les codes correspondent aux '​work_number'​ ou numéro de travail des produits. 
- 
-Votre fichier doit s’appeler ''​interventions.csv''​ et doit garder ces colonnes dans l'​ordre. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​interventions.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-==== Gestion commerciale ==== 
- 
-=== Achats === 
- 
-Étape facultative si vous voulez importer votre historique de factures d'​achat en cours. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **reference_number** ​   | Code de reference | 
-| **Code variant** | Code du type de variant dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **quantité** ​   | Quantité | 
-| **prix_unitaire** ​   | Prix unitaire HT | 
-| **taux_tva** ​   | Taux de tva (ex: 20.0) | 
- 
-Votre fichier doit s’appeler ''​purchases.csv''​ et doit garder ces colonnes dans l'​ordre. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​purchases.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
- 
-=== Ventes === 
- 
-Étape facultative si vous voulez importer votre historique de factures de ventes en cours. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **reference_number** ​   | Code de reference | 
-| **Code variant** | Code du type de variant dans la [[http://​open-nomenclature.org/​nomenclatures/​product_nature_variants|nomenclature]] | 
-| **quantité** ​   | Quantité | 
-| **prix_unitaire** ​   | Prix unitaire HT | 
-| **taux_tva** ​   | Taux de tva (ex: 20.0) | 
- 
-Votre fichier doit s’appeler ''​sales.csv''​ et doit garder ces colonnes dans l'​ordre. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​sales.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Décaissements === 
- 
-Étape facultative si vous voulez importer votre historique de réglements liés aux factures d'​achat en cours. 
- 
-Le renseignement des colonnes **obligatoires** est en gras. 
- 
-^ Nom                      ^ Définition ^ 
-| **reference_number** ​   | Code de reference | 
-| **nom mode de paiement** ​   | nom du mode de paiement (doit déjà être paramétré dans Ekylibre) | 
-| **prix réglé** ​   | Prix total TTC | 
-| Date paiement | Si différente de la date du reference number | 
- 
-Votre fichier doit s’appeler ''​outgoing_payments.csv''​ et doit garder ces colonnes dans l'​ordre. 
- 
-  - Récupérez l'​[[https://​github.com/​ekylibre/​first_run-demo/​blob/​master/​alamano/​outgoing_payments.csv|exemple]] et modifiez-le à votre guise. 
-  - Sauvegardez votre fichier dans le répertoire ''​alamano''​. 
- 
-=== Import des pièces originales d'​achat === 
- 
-Étape facultative si vous voulez importer et lier automatiquement les pièces originales d'​achats à vos factures d'​achats. 
-Cela necessite bien sur d'​avoir au préalable numérisé vos pièces au format JPG ou PDF. 
- 
-- Il suffit ensuite de les nommer avec **code de reference** et des les compresser dans une archives portant le nom de ''​purchases.zip''​ 
- 
-Ex : 2014-11-01_OVH_FR10787401.pdf et 2014-11-01_EDF_FR102563.pdf zippés dans ''​purchases.zip''​ 
- 
-- Sauvegardez votre fichier dans le répertoire ''​alamano/​documents''​. 
- 
-<WRAP center round important 60%> 
-A propos du **code de reference**,​ c'est une convention qui permet de connaître la piece à laquelle nous allons rattacher une facture d'​achat ou un décaissement. 
-Il est composé de 3 parties, la façon suivante : 
- 
-  * partie 1 : la date sous la forme AAAA-MM-JJ 
-  * partie 2 : le nom du tiers en majuscule et séparé par des tirets(-) si besoin 
-  * partie 3 : le numéro de la pièce (la reference externe d'une facture le plus souvent) 
- 
-Pour une facture d'​achat émise le 01/11/2014 par la société Ovh avec la référence FR10787401, on aura le **code de reference** suivant : **2014-11-01_OVH_FR10787401** 
-</​WRAP>​ 
- 
-===== Lancement ===== 
- 
-==== En mode local ==== 
- 
-Le //​first-run//​ est une méthode qui est appelée pour charger les données de votre dossier et les transcoder avant de les enregistrer dans la base de données. 
- 
-La commande de base pour lancer un //​first-run//​ est : 
-<code bash> 
-bundle exec rake first_run 
-</​code>​ 
- 
-Par défaut, si une erreur est rencontrée durant l’exécution du //​first-run//,​ tout est annulé. 
- 
-Plusieurs options sont disponibles : 
-  * ''​name''​ pour spécifier le nom de l'​instance Ekylibre 
-  * ''​folder''​ pour le nom du dossier se trouvant dans ''​RAILS_ROOT/​db/​first_runs''​ 
-  * ''​path''​ (à la place de ''​folder''​) pour indiquer le chemin au dossier de //​first-run//​ 
-  * ''​max''​ pour limiter le nombre d'​éléments importés par fichier. Ne jamais utiliser en production. 
-  * ''​mode''​ pour autoriser une exécution sans reprise sur panne 
- 
-Exemple : 
-<code bash> 
-bundle exec rake first_run folder=gaecjoulin name=gaec-joulin 
-</​code>​ 
- 
-À la fin de la commande, vous devrez lancer votre serveur puis accéder à l'URL http://​gaec-joulin.ekylibre.lan:​3000 dans le cas de l'​exemple ci-dessus. ​ 
- 
-=== Configuration du domaine === 
- 
-Pour que l'​exemple fonctionne, vous devez mettre à jour le fichier ''/​etc/​hosts''​ en ajoutant la ligne ci-après : 
-<​code>​ 
-127.0.0.1 ​     gaec-joulin.ekylibre.lan 
-</​code>​ 
- 
-=== Mode rapide === 
- 
-Si vous souhaitez utiliser Ekylibre directement sans passer par cette étape, vous devez à minima exécuter le first-run par défaut. 
- 
-<code bash> 
-bundle exec rake first_run:​default 
-</​code>​ 
- 
-Les options sont les mêmes que pour la commande classique. 
- 
-==== En mode SaaS ==== 
- 
-Vous devez compresser votre dossier avec un outil comme [[http://​www.7-zip.org/​|7-zip]] par exemple et le transmettre par mail à l'​adresse suivante: [[first-run@ekylibre.com]]. 
- 
-Vos données seront vérifiées en vue de l'​import. Un fois importées, nous vous enverrons un lien pour accéder à votre application avec vos données. 
- 
-==== Lancer le serveur sur une seule instance ==== 
- 
-  TENANT=<​instance>​ rails s 
  
  • fr/guides/first-run.txt
  • Dernière modification: 2016/03/17 16:07
  • (modification externe)