API RF RECHMISS

  Version ACE : 1.3

Package : Standard

Nom de la gnc : gnc_rf_recherche_mission

Fonctionnalité : Préparation RF
Schémas d’entrée et de sortie : voir en fin de document.

Cette API permet non seulement d’obtenir les informations d’une mission et de son paramétrage de départ, mais aussi d'affecter cette mission à l'opérateur identifié.

API imbriquées : LECT_GEN - PRISE_MISS -

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

RAS.

Paramétrage (PPE)

RAS.

Processus, contrôles et règles de gestion

ETAPE DESCRIPTION DU PROCESSUS
 

Cette API regroupe les appels aux apis LECT_GEN et, suivant les cas, à PRISE_MISS.

  • Appel systématique de LECT_GEN
  • Si aucune mission n’est en cours pour l’opérateur, et que l’on se trouve en mode déclaratif (choix de la mission par l’opérateur, alors fin d’API.
  • Si une mission est en cours, appel à PRISE_MISS, qui ne récupérera que le contexte de la mission.
  • Si aucune mission n’est en cours pour l’opérateur, et que l’on se trouve en mode imposé, alors appel à PRISE_MISS, qui affectera la mission et récupérera le contexte.

- Si une mission est imposée en entrée, comportement identique à la reprise d’une mission encours. Si la mission saisie est erronée, message d’erreur.

Détail

Call the function gnc_rf_lect_gen as so to collects information for the given activity profile.

If the ‘idmission’ input parameter is equal to ‘AUTO’ and the ‘affected flag’ (information received from the function gnc_rf_lect_gen) is equal to ‘2’.

Change the mode of affectation to ‘imposed’. (‘idmission’ input parameter is set to an empty string and the ‘affected flag’ is set to ‘1’).

IF the execution of the function gnc_rf_lect_gen is successful

AND

(the affectation mode is ‘imposed’ (‘affected flag’ is equal to ‘1’ AND the ‘Mission in progress ID’ (information received from the function gnc_rf_lect_gen) is equal to ‘0’)

OR the affectation mode is ‘declarative’ (‘affected flag’ is equal to ‘0’ AND the ‘Mission in progress ID’ (information received from the function gnc_rf_lect_gen) is equal to ‘0’ and the ‘idmission’ input parameter is not empty).

OR the ‘Mission in progress ID’ is not empty

)

If the ‘Mission in progress ID’ is not empty.

Read the mission data (LMIS table) with the input parameters (typdep, sigdep) and with the ‘Mission in progress ID’.

Set value ‘1’ for the input parameter ‘In progress flag’ for the function gnc_rf_prise_mission.

Set value ‘lmis.identite’ for the input parameter ‘Mission ID’ for the function gnc_rf_prise_mission.

Otherwise.

Set value ‘0’ for the input parameter ‘In progress flag’ for the function gnc_rf_prise_mission.

Call the function gnc_rf_prise_mission, as so to give the mission to the user.

If the execution of the function is successful.

If the ‘Mission in progress ID’ is not empty.

Start a new database transaction (gnc_deb_trans).

If there is a problem with the start of the transaction, the API returns an error code 0.

Read the mission data (LMIS table) with the input parameters (typdep, sigdep) and with the ‘Mission in progress ID’.

The output parameters are filled.

Otherwise.

The ouput parameter is filled with the error message of gnc_rf_prise_mission.

Otherwise.

The output parameters are filled.

Return the code ‘1’.

Exemple(s) d’utilisation

A~RECHMISS~8556~BUN~DEP~CESBUN~20~

Recherche de la mission 8556, pour l’opérateur BUN sur le dépôt DEP/CESBUN pour un profil 20.

Réponse :

1~CESBUN cestas bun~0~262144~0~|~5~1937~8556~S~F3 : Ret~OP / Lot : 8556 / 18~St : 1~Mvts : 0 / 1~Qté : 0 / 1~0~Ch :~~V_RF_PPACK_CHAR2~V_RF_PPACK_COL2~4~2~3~~~ ~~~ ~0~~V_RF_PPACK_MVT2~~~0~1~~~ ~~~ ~Zone prp : ZP1~OP : Zone de prépar~~~~|QE1|~QE1~v_rf_ppack_depmis2~1~QE1~0~GNC~~~~~~~0~~~~~~~

Résultat OK, remontée des informations nécessaires à la mission.

Cas d'erreur

CODE PARAMÈTRES DESCRIPTION
0   Database transaction could not be started.
0/ELT_PASTRO codtbl, cletbl The generalized information is not found. (error returned from the function gnc_rf_lect_gen)
0/ RFPIK02002 ‘LPRELV’ PPE non-existent or not well parameterized. (error returned from the function gnc_rf_lect_gen)
ELT_PASTRO ‘view name’ (tbl.lib1) The information from the view is not found. (error returned from the function gnc_rf_lect_gen)
0/RFPIK02003 ltypact The execution of the function gnc_rf_donneop is not successful. (error returned from the function gnc_rf_prise_mission)
0/RFPIK02003 ltypact The execution of the function gnc_rf_donnemis is not successful. (error returned from the function gnc_rf_prise_mission)
0   Database transaction could not be started. (error returned from the function gnc_rf_prise_mission)

Paramètres en entrée

NOM DESCRIPTION FORMAT OBLIGATOIRE/FACULTATIF
idmission RF mission ID. Char(9) O
sigage User ID. Char(12) O
typdep Depot type. Char(3) O
sigdep Depot ID. Char(18) O
idprfact Profile ID of the activity in progress. Number N

Paramètres en sortie

NOM DESCRIPTION FORMAT
ParamOut1 Depot information. Char(20)
ParamOut2 Affected flag. Char(1)
ParamOut3 Mission in progress ID. Number
ParamOut4 Mission view name. Char(20)
ParamOut5 Order. Char(1)
ParamOut6 Activity type. Number
ParamOut7 Gnc_rf_prise_mission ParamOut1  
ParamOut8 Gnc_rf_prise_mission ParamOut2  
ParamOut9 Gnc_rf_prise_mission ParamOut3  
ParamOut10 Gnc_rf_prise_mission ParamOut4