API RF DONNE

Version ACE : 5.0-00

Package : Standard

Sous-programme Basic : Donne_O

Fonctionnalité :Préparation

Schémas d’entrée et de sortie :

voir en fin de document.

Cette API permet d’affecter un Ordre de Préparation (OP) à un opérateur et de créer la mission associée.

API imbriquées : aucune.

Contraintes et limites de fonctionnement (hors périmètre)

RAS.

Paramétrage (PPE)

LRFOPR – LRFLOP -

Prototype de la fonction Basic

Donne_OP (numero_module, profil_choisi, age, idop, zonprp, typop, nbre_mvt, nbre_colis_detail, cnttyp_sup, cntcod_sup, idmission, typact_choisi, libzonprp, sigliv, datexp, heuexp, lirtrn, nb_colis, idobjcol, mode_op_suiv, mode_op_prec, Idop_suiv, Idop_prec, mode_prepa, idact, libact, flag_mono_trn, flag_mono_cli, idtrn, typmvt, idvac, nbre_mvt_g, nbre_mvt_3)

Messages en entrée

DONNE_OP~profil_choisi~age~typact_choisi~idop

Messages en sortie

Retour~Idop~zonprp~typop~nbre_mvt~nbre_colis_detail~cnttyp_sup~cntcod_sup~idmission~libzonprp~

Sigliv~datexp~heuexp~lirtrn~nb_colis~idobjcol~mode_op_suiv+mode_op_prec~Idop_suiv~

Idop_prec~mode_prepa~idact~libact~flag_mono_trn~flag_mono_cli~idtrn~

Complement_lirtrn~Idol~Flg_com~typmvt~idvac~Nbre_mvt_g~nbre_mvt_3~

Valeurs restituées par l’API

Valeur	Remarque
1	Ok, un OP a été affecté à l’opérateur.
2	L’OP demandé n’existe pas.
3	L’OP demandé est bloqué par un autre processus.
73	L’opérateur n’a pas le profil d’activité « Préparation ».
99	Il n’y a plus d’OP à affecter.

Processus, contrôles et règles de gestion

Etape	Description du Processus
1	Si un identifiant OP est demandé en entrée, recherche de cet OP. Sinon, recherche d’un OP pré-affecté à l’opérateur.
2	Si un identifiant OP est demandé en entrée et qu’il est déjà effectué, recherche d’un OP lié correspondant au solde de l’OP demandé.
3	Si aucun identifiant OP n’est demandé en entrée, et qu’il n’y a pas d’OP pré-affecté à l’opérateur, constitution d’une liste d’OP candidats d‘après les profils de l’opérateur.
4	Tri de la liste d’OP : Règle 1 : si l’urgence de l’OP est supérieure à l’urgence maximum de l’opérateur, le tri est le suivant : [ Urgence OP Décroissant – Urgence Profil Décroissant – Date de fin préparation - Heure de fin préparation – identifiant OP ] Règle 2 : si l’urgence de l’OP est comprise entre l’urgence minimum et l’urgence maximum de l’opérateur, le tri est le suivant : [ Urgence Profil Décroissant - Urgence OP Décroissant – Date de fin préparation - Heure de fin préparation – identifiant OP ] Règle 3 : si l’urgence de l’OP est inférieure à l’urgence minimum de l’opérateur, le tri est le même que pour la règle 1.
5	Prise en charge du premier OP de la liste non bloqué par un autre processus. Si un identifiant OP double fourche est passé en entrée, on prend le premier OP de la liste correspondant à la même tournée et pour le même client.
6	Affectation de l’OP trouvé à l’opérateur.
7	Création d’une mission correspondant à l’OP.
8	Mise à jour du contexte de l’opérateur.
	Lorsque la mission trouvée est de type 14 (polyvalente), alors les champs « flgdepose » et « idmission » sont alimentés en sortie.

Erreurs possibles

Cause	EFFET
L’OP demandé n’existe pas	Code retour 2 message « OP demande inexistant »
L’OP demandé est bloqué par un autre processus	Code retour 3 message « OP demande bloque »
L’opérateur n’a pas de profil d’activité préparation	Code retour 73 message « Le profil choisi est vide de lignes acceptables »
Il n’y a plus d’OP à affecter	Code retour 99 message « Plus de missions pour cette activité »

Exemple(s) d’utilisation

ret = Donne_OP (numero_module, profil_choisi, age, idop, zonprp, typop, nbre_mvt, nbre_colis_detail, cnttyp_sup, cntcod_sup, idmission,typact_choisi, libzonprp, sigliv, datexp, heuexp, lirtrn, nb_colis, idobjcol_op, mode_suivant, mode_precedent, idop_suivant, idop_precedent, mode_prepa, idact, libact, flag_mono_trn, flag_mono_cli, idtrn, typmvt, idvac, nbre_mvt_g, nbre_mvt_3)

Paramètres en entrée

Nom du paramètre	type	format	taille	obl O/N	Remarque
profil_choisi	LONG			N	Identifiant du profil d'activité
Age	CHAR		8	O	Identifiant de l’opérateur
typact_choisi	LONG			O	Type d’activité
Idop	LONG			N	Identifiant de l’OP demandé
Idop_double	LONG			N	Identifiant de l’OP dans le mode double fourche
Vocal	CHAR		1	N	Indicateur mode vocal

Paramètres en sortie

Nom du paramètre	type	format	taille	Remarque
Idop	LONG			Identifiant de l’OP
Zonprp	CHAR		4	Zone de préparation
Typop	CHAR		4	Type Ordre de Préparation
Nbre_mvt	LONG			Nombre de mouvements de l’OP
Nbre_colis_detail	LONG			Nombre de colis détail de l’OP
Cnttyp_sup	CHAR		2	Code contenant du support de préparation
Cntcod_sup	CHAR		2	Type contenant du support de préparation
Idmission	LONG			Identifiant de la mission de préparation
Libzonprp	CHAR		30	Nom zone de préparation
Sigliv	CHAR		12	Sigle du tiers associé à la livraison
Datexp	DATE		8	Date départ prévue de la tournée
Heuexp	DBLE		6	Heure départ prévue de la tournée
Lirtrn	CHAR		10	Libelle réduit de la tournée
Nb_colis	LONG			Nombre de prises de la préparation
Idobjcol	CHAR		18	Identifiant du colis de préparation
Mode_op_suiv + Mode_op_prec	CHAR		1+1	Type mission OP suivant + Type mission ou OP précédent
Idop_suiv	LONG			Identifiant OP suivant
Idop_prec	LONG			Identifiant OP précédent
Mode_prepa	CHAR		1	1 : MONO COLIS DETAIL 2 : MULTI COLIS EN L'ETAT 3 : MULTI COLIS DETAIL
Idact	LONG			Identifiant activité
Libact	CHAR		30	Libellé de l'activité
flag_mono_trn	CHAR		1	Flag mono tournée
flag_mono_cli	CHAR		1	Flag mono client
Idtrn	LONG			Identifiant de la tournée
Complement_lirtrn	CHAR		80	Complément au libellé de la tournée : position chargement + position livraison Spécifique OVD
Idol	LONG			Identifiant Ordre de Livraison Spécifique BACCARAT
Flg_com	CHAR		1	Flag commentaire sur entête OL Spécifique BACCARAT
Typmvt	CHAR		1	Type de mouvement de l’OP
Idvac	LONG			Identifiant vacation de l’OP
Nbre_mvt_g	LONG			Nombre de mouvements gelés de l’OP
nbre_mvt_3	LONG			Nombre de mouvements à valider de l’OP (En statut 3)
Typliv	CHAR		3	Type du tiers associé à la livraison

API RF DONNE_OP

Paramètres en entrée

Paramètres en sortie