| API / APIs Radiofréquence | |
| 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.
- 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) |
| 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 |
| 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 |