Difference between revisions of "Interfaces Exterieur vers Dolibarr"
| Line 1: | Line 1: | ||
| − | Il | + | Il y 2 méthodes pour permettre à une application extérieure d'insérer des données dans Dolibarr. Les 2 techniques possibles sont les suivantes: |
== Insertion des données directement en base == | == Insertion des données directement en base == | ||
Cette solution requiert de connaître le modèle physique et les valeurs autorisées des champs. Elle est risquée et devra être réécrite en cas de modification du format de base de Dolibarr. | Cette solution requiert de connaître le modèle physique et les valeurs autorisées des champs. Elle est risquée et devra être réécrite en cas de modification du format de base de Dolibarr. | ||
| − | Cette technique n'est | + | Avantages: Peut être réalisé dans n'importe quel langage. |
| + | Inconvénient: Cette technique n'est très fortement déconseillée. A la première montée de version de Dolibarr, cette méthode risque de ne plus fonctionner et devoir être réécrite. | ||
| + | De plus, en utilisant cette méthode, vous passer outre les règles de validation métier, ce qui crée un risque de corrompre les données. Cette méthode nécessite aussi de connaitre la base Dolibarr. | ||
| + | |||
== Utilisation des classes PHP == | == Utilisation des classes PHP == | ||
Il est possible d'utiliser les objets métiers de dolibarr (Les fichiers xxx.class.php). | Il est possible d'utiliser les objets métiers de dolibarr (Les fichiers xxx.class.php). | ||
| − | Chacun de ces fichiers offre un classe munie de methodes pour | + | Chacun de ces fichiers offre un classe munie de methodes pour: |
| − | * la récupération (la méthode fetch) | + | * la récupération d'une entité (la méthode fetch) |
| − | * l'insertion (la méthode create ou insert) | + | * l'insertion en base d'un entité (la méthode create ou insert) |
| − | * la mise à jour (la méthode update) | + | * la mise à jour d'une entité (la méthode update) |
| − | * la suppression (la méthode delete) si applicable à l'objet | + | * la suppression d'une entité (la méthode delete) si applicable à l'objet |
| + | * d'autres méthodes diverses propre à l'entité manipulée. | ||
Cette technique est préférable à la précédente. | Cette technique est préférable à la précédente. | ||
Avantages: Elle offre l'avantage de passer à travers les couches de validations métiers des données. | Avantages: Elle offre l'avantage de passer à travers les couches de validations métiers des données. | ||
Inconvénients: Elle n'est exploitable qu'en langage PHP. Elle requiert de consulter le code de l'objet pour connaître les propriétés obligatoires à la création. | Inconvénients: Elle n'est exploitable qu'en langage PHP. Elle requiert de consulter le code de l'objet pour connaître les propriétés obligatoires à la création. | ||
| + | Inconvénient: Ne peut être utilisé qu'en langage PHP. | ||
Revision as of 11:47, 13 May 2006
Il y 2 méthodes pour permettre à une application extérieure d'insérer des données dans Dolibarr. Les 2 techniques possibles sont les suivantes:
Insertion des données directement en base
Cette solution requiert de connaître le modèle physique et les valeurs autorisées des champs. Elle est risquée et devra être réécrite en cas de modification du format de base de Dolibarr. Avantages: Peut être réalisé dans n'importe quel langage. Inconvénient: Cette technique n'est très fortement déconseillée. A la première montée de version de Dolibarr, cette méthode risque de ne plus fonctionner et devoir être réécrite. De plus, en utilisant cette méthode, vous passer outre les règles de validation métier, ce qui crée un risque de corrompre les données. Cette méthode nécessite aussi de connaitre la base Dolibarr.
Utilisation des classes PHP
Il est possible d'utiliser les objets métiers de dolibarr (Les fichiers xxx.class.php). Chacun de ces fichiers offre un classe munie de methodes pour:
- la récupération d'une entité (la méthode fetch)
- l'insertion en base d'un entité (la méthode create ou insert)
- la mise à jour d'une entité (la méthode update)
- la suppression d'une entité (la méthode delete) si applicable à l'objet
- d'autres méthodes diverses propre à l'entité manipulée.
Cette technique est préférable à la précédente. Avantages: Elle offre l'avantage de passer à travers les couches de validations métiers des données. Inconvénients: Elle n'est exploitable qu'en langage PHP. Elle requiert de consulter le code de l'objet pour connaître les propriétés obligatoires à la création. Inconvénient: Ne peut être utilisé qu'en langage PHP.