ENVOYER DES BONS DE LIVRAISONS¶
3 Fonctions vous seront nécessaires pour réaliser la transaction :
EXIM_connect(“user”,”password”,”IDPeer”) : Connexion à l’API
DN_howManyToUpLoad() : Fonction à interroger régulièrement permettant savoir si BRG-LAB a effectué une demande de reseignement de bon de livraison.
DN_getListToUpload() : Fonction permettant de récupérer la liste des bons de livraisons à renseigner.
DN_uploadList(EXIM_concreteDN) : Fonction permetant d’envoyer à BRG-LAB les listes de bons de livraisons renseignés.
DN_updateConstructionSite(EXIM_concreteDNConstructionSite) : Fonction permettant de mettre à jour un chantier
Les bons de livraisons contiennent les informations chantiers, les informations de production, le bon des pesées.
Exemple d’utilisation¶
WINDEV / WEBDEV¶
SI EXIM_connect("user","password","IDPeer") = Faux ALORS
Info("Impossible de se connecter")
RETOUR
FIN
nNbrBL est un entier
listeBL est un EXIM_concreteDN
nNbrBL = DN_howManyToUpLoad()
SI nNbrBL <> 0 ALORS
listeBL <= DN_getListToUpload()
POUR i = 1 _À_ TableauOccurrence(listeBL.DNs)
// renseignement de l'ensemble des éléments du BL
// ...
FIN
DN_uploadList(listeBL)
FIN
Visual studio .net¶
Dim automapiClient As New automapiSOAPPortTypeClient
Dim EXIM_concreteDN As tEXIM_concreteDN
Dim nbBl As Integer
Dim SID As Byte()
ReDim SID(20)
automapiClient.Open()
If automapiClient.EXIM_connect(SID, "user", "password", "IDPeer") Then
nbBl = automapiClient.DN_howManyToUpLoad(SID)
If nbBl <> 0 Then
EXIM_concreteDN = automapiClient.DN_getListToUpload(SID)
If EXIM_concreteDN Is Nothing Then
Return
End If
...
End If
End If
Structure des données échangées¶
EXIM_concreteDN¶
DNs is array of EXIM_concreteDNDescription
batchLocation is array of strings <- Liste des emplacements de matériaux lors de la pesée
hopper_01 -> 20 Trémie 1 à 20
pump_01 -> 20 Pompe 1 à 20
silo_01 -> 20 Silo 1 à 20
EXIM_concreteDNDescription¶
Dans BRG-LAB, les chantiers peuvent être organisés de différentes manières :
Affaire -> Chantier -> Partie de chantier
Chantier -> Partie de chantier
Chantier
Il faut à minima que le chantier soit renseigné.
(Informations Transmise par BRG-LAB)
DNnumber is string -> N° du BL
manufactureDateHour is DateTime -> Date et heure de fabrication
attempt is int -> Nombre de tentative d'importation (si erreur lors de la précédente importation)
errorMessageFromLastAttempt is string -> Message d'erreur lors de la dernière tentative d'importation
automatom is string -> Automate
Tous les autres champs en dessous sont à renseigner
plantCode is string -> Code de la centrale
formulaCode is string -> Code de la formule
formulaRecipe is string -> Code recette
formulaNumber is string -> N° de formule (plantCode + séparateur + formulatCode + codeRecette) numéro tel qu'il est affiché dans l'automate
ConstructionSite is EXIM_concreteDNConstructionSite -> Chantier
// Production
formulaDesignation is strings -> Désignation commerciale de la formule
volumeProduced is real -> Volume fabriqué
// Transport
typeOfTransport is string -> (Optionnel) Type de véhicule
registrationOfTheCarrier is string -> (Optionnel) Immatriculation du véhicule
// Mixer informations (Partie optionnelle concernant la fabrication)
mixerStartOfEmptying is DateTime -> Date et heure de début de vidange du malaxeur
mixerSendOfEmptying is DateTime -> Date heure de fin de vidange du malaxeur
// delevery information (Partie optionelle concernant la livraison du béton)
deleveryStartOfEmptying is DateTime -> Date heure du début de vidange de la toupie
deleverySendOfEmptying is DateTime -> Date heure de fin de vidange de la toupie
deleveryAdditionOfWater is string -> Ajout d'eau sur chantier
deleveryManualAddition is array of EXIM_concreteDNDosage -> Produits ajoutés manuellement dans la toupie sur chantier
airTemperature is real -> Température de l'air (si renseigné)
airHygrometry is real -> Hygrométrie de l'air (si renseigné)
concreteTemperature is real -> Température du béton (si renseigné)
windSpeed is real -> vitesse de l'air (si renseigné)
cureProduct is string -> Produit de cure
// fields for specific automaton
automatonCode0 is string
automatonCode1 is string
automatonCode2 is string
automatonCode3 is string
automatonCode4 is string
automatonCode5 is string
automatonCode6 is string
automatonCode7 is string
automatonCode8 is string
automatonCode9 is string
// Weighing control (Partie optionelle pour le transfert du bon de pesée)
// Nominal dosage of formula
nominalFormulaEfficientWater is real -> Eau efficace
nominalFormulaTotalWater is real -> Eau totale (optionel)
nominalFormulaEquivalentBinder is real -> Liant équivalent
nominalFormulaTotalWeight is real -> Poids total de la formule (opionnel)
nominalFormula is array of EXIM_concreteDNDosage -> Formule nominale (au mètre cube)
batchs is array of EXIM_concreteDNBatch -> Pesées
// Réservé CBAO ne pas remplir
Automatom is string
waterMode is string
EXIM_concreteDNConstructionSite¶
// Construction informations -> Information sur le chantier
businessSite is string -> (Optionnel) Désignation de l'affaire
internal_ID_businessSite is int -> (Optionnel) ID de l'affaire de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)
constructionSite is string -> Chantier
internal_ID_constructionSite is string -> ID du chantier de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)
partOfConstruction is string -> (Optionnel) Désignation de la partie de chantier
internal_ID_partOfConstruction is string -> (Optionnel) ID de la partie de chantier de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)dans BRG-LAB)
projectManager is string -> (Optionnel) Maître d'oeuvre
internal_ID_projectManager is string -> (Optionnel) ID du maître d'oeuvre de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)
projectOwner is string -> (Optionnel) Maître d'ouvrage
internal_ID_projectOwner is string -> (Optionnel) ID du maître d'ouvrage de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)
customer is string -> Client
internal_ID_customer is string -> ID du client de votre base de données (permet de conserver la liaison et éventuellement modifier les désignations)
// Delivery informations (Partie optionnelle, concernant la livraison sur chantier)
Country -> Pays selon la codification Alpha3 ISO https://fr.wikipedia.org/wiki/ISO_3166-1
City is string -> Ville
ZipCode is string -> Code postal
Direction is string -> Adresse du chantier
GPS_lat is real -> Coordonnées GPS lattitude (degrés décimaux)
GPS_long is real -> Coordonnées GPS longitude (degrés décimaux)
// fields for specific automaton
automatonCode0 is string
automatonCode1 is string
automatonCode2 is string
automatonCode3 is string
automatonCode4 is string
automatonCode5 is string
automatonCode6 is string
automatonCode7 is string
automatonCode8 is string
EXIM_concreteDNDosage¶
productCode is string -> Code produit (code du produit devant être identique entre l'automate et BRG-LAB afin d'effectuer la liaison)
designation is string -> Désignation du produit
productType is string -> Type de matériau ["AGGREGATE","CEMENT","ADDITIVE","ADMIXTURE","SPECIAL","WATER"]
Dosage is real -> Dosage
dosageUnity is string -> Unité de dosage ["Kg","l","%","DOSE"]
aggregateAbsorption is real -> Coefficient d'absorption
admixtureDryExtract is real -> % d'extrait sec des adjuvants
density is real -> Densité (essentiellement pour l'eau)
additiveK is real -> Rapport K de l'addition
modificationDate is DateTime -> Date de modification par l'utilisateur (si connue)
// fields for specific automaton
automatonCode0 is string
automatonCode1 is string
automatonCode2 is string
automatonCode3 is string
automatonCode4 is string
EXIM_dosage¶
productCode is string -> Code produit (code du produit devant être identique entre l'automate et BRG-LAB afin d'effectuer la liaison)
Dosage is real -> Dosage
dosageUnity is string -> Unité de dosage ["Kg","l","%"]
EXIM_concreteDNBatch¶
batchNumber is real -> N° de la gachée
batchVolume is real -> Volume de la gâchée
mixerWattmeterBeforeEmptying is real -> Valeur du wattmère en fin de cylcle de malaxage (juste avant vidange)
mixerWaterContent is real -> Valeur de la sonde de teneur en eau du béton en fin de mixage
mixerManualAddition is array of EXIM_dosage -> Produits ajoutés manuellement dans le malaxeur
mixerManualWaterCorrection is real -> Correction d'eau apportée par le centraliste
mixingTime is real -> Durée de malaxage en secondes
mixingHour is hour -> Heure du malaxage
// fields for specific automaton
automatonCode0 is string
automatonCode1 is string
automatonCode2 is string
automatonCode3 is string
automatonCode4 is string
batchDetails is array of EXIM_concreteDNBatchDetail
EXIM_concreteDNBatchDetail¶
productCode is string -> Code produit (code du produit devant être identitique entre l'automate et BRG-LAB afin d'effectuer la liaison)
weighingOrderDry is real -> Ordre de pesage nominal (sans l'eau)
weighingOrderWet is real -> Ordre de pesage envoyé (eau comprise)
weighingExecuted is real -> Pesage exécuté (mesuré)
weighingError is real -> Erreur de pesée (en %)
waterContent is real -> Teneur en eau (%)
dosageUnity is string -> unité de dosage ["Kg","l","%"]
location is string -> (Voir batchLocation)
aggregateAbsorption is real -> Coefficient d'absorption (%) s'il n'a pas été renséigné au niveau de la formule nominale
admixtureDryExtract is real -> Extraits sec des adjuvants (%) s'il n'a pas été renseigné au niveau de la formule nominale
// fields for specific automaton
automatonCode0 is string
automatonCode1 is string
automatonCode2 is string
automatonCode3 is string
automatonCode4 is string>>>>>>> .r316