Import vehicule
Importul vehiculelor se realizeaza in doua etape:
- Inserarea in tabelul buffer a informatiilor corecte si complete. Structura tabelului este prezentata in anexa B.
- Apelarea procedurii stocate importex_vehicule_exec care valideaza, importa datele si goleste tabelul-buffer. In cazul in care datele nu sunt corecte procedura intoarce o exceptie si intregul proces de import este abandonat, restabilindu-se starea dinaintea importului. Lista erorilor posibile este prezentata in anexa C
Anularea unui import se face prin apelarea procedurii stocate importex_vehicule_anulare cu parametrul id_importex (id lot articole importate). Procedura stocata verifica consistenta efectului de anulare a datelor deja importate si dupa caz realizeaza stergerea efectiva a datelor sau intoarce un mesaj de eroare.
Puteti consulta urmatoarele tabele pentru a verifica in prealabil sau ulterior importului datele existente:
- Vehicule: vehicul.
- Tabela documentelor: m_transport
- Cheia primara a tabelului: pct_lcr + id
ANEXA A. Parametri import:
| Câmp | Tip | Descriere |
|---|---|---|
| id_importex | varchar(25) | ID pentru identificarea unui lot de documente importate (util, de ex., pentru ștergerea în bloc a unui lot de documente importate), valoare implicită NULL |
| keep_data_on_err | bit | 0 - nu se vor păstra datele în tabelele buffer (valoare implicită) 1 - se vor păstra datele în tabelele buffer, în caz de eroare |
| manage_existing | tinyint | 0 - Blochează - procedura se oprește, returnând o eroare (valoare implicită) 1 - Suprascrie - se actualizează datele retetei existente 2 - Ignoră - se ignoră importul înregistrării curente, lăsând datele retetei neschimbate |
| single_tran | bit | Se specifică dacă se va deschide o singură tranzacție pentru întregul import sau se va utiliza o tranzacție per document. 1 - în cazul apariției unei erori la importul unui document, sistemul va reveni complet la starea dinaintea importului (valoare implicită). 0 - documentele importate până la apariția erorii rămân în baza de date |
| updated_columns | varchar(max) | Se va trimite lista de câmpuri ce se doresc a fi suprascrise, separate prin virgulă (fără spațiu între câmpuri și virgulă), implicit NULL |
| exec_type | tinyint | 0 - Validare și import, cu oprire în cazul erorilor (valoare implicită) 1 - Validare și import, sărind peste înregistrările cu erori 2 - Validare date, fără a realiza importul |
| return_errorlist | tinyint | 0 - Fără listă erori (valoare implicită) 1 - Returnează lista înregistrărilor cu erori 2 - Returnează lista tuturor înregistrărilor |
ANEXA B. Tabel nomenclator: importex_vehicule avand structura:
| Coloana | Tip | Descriere |
|---|---|---|
| id_importex | varchar(25) | ID pentru identificarea unui lot de documente importate (util, de ex., pentru stergerea in bloc a unui lot de documente importate) Atentie! Gestionarea, verificarea si validarea acestui camp este in sarcina dezvoltatorului utilitarului de export-import. |
| nr_inmatriculare | varchar(25) | Cod numeric sau alfanumeric care asigura identificarea unica a unui vehicul |
| id_marca | varchar(25) | ID unic pentru identificarea marcii unui vehicul (optional daca se specifica den_marca, id_model sau den_model) |
| den_marca | varchar(50) | Denumirea marcii vehiculului (optional daca se specifica id_marca, id_model sau den_model) |
| id_model | varchar(25) | ID unic pentru identificarea modelului unui vehicul (optional) |
| den_model | varchar(50) | Denumirea modelului vehiculului (optional daca se specifica id_model) |
| tip_proprietate | varchar(20) | Tipul de proprietate al vehiculului (Proprietate, Leasing, Inchiriat, Client) |
| id_proprietar | varchar(25) | ID unic pentru identificarea proprietarului vehiculului (optional) |
| id_extern_proprietar | varchar(50) | Id-ul extern al proprietarului (optional daca se specifica id_proprietar, cod_proprietar sau den_proprietar) |
| cod_proprietar | varchar(20) | Codul fiscal al proprietarului (optional daca se specifica id_proprietar, den_proprietar sau id_extern_proprietar) |
| den_proprietar | varchar(20) | Denumirea proprietarului (optional daca se specifica id_proprietar, cod_proprietar sau id_extern_proprietar), ales din nomenclatorul de Parteneri |
| id_categorie | varchar(25) | ID unic pentru identificarea categoriei din care face parte vehiculul (optional) |
| den_categorie | varchar(50) | Denumirea categoriei din care face parte vehiculul (optional daca se specifica id_categorie) |
| id_centru_profit | varchar(25) | Codul intern al centrului de profit in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_centru_profit) |
| den_centru_profit | nvarchar(100) | Denumirea centrului de profit (optional daca se specifica id_centru_profit) |
| nr_inventar | varchar(20) | Numarul de inventar al vehiculului |
| data_inmatriculare | date | Data inmatricularii vehiculului |
| an_fabricatie | int | Anul fabricarii vehiculului |
| serie_motor | varchar(50) | Seria de identificare a motorului vehiculului |
| serie_caroserie | varchar(50) | Seria de identificare a caroseriei vehiculului |
| cod_vin | varchar(50) | Numarul de identificare al vehiculului |
| km_initiali | int | Numarul de km initiali ai vehiculului |
| cilindree | int | Capacitatea cilindrica a vehiculului |
| putere_cp | int | Puterea motorului vehiculului exprimata in "cai putere" |
| anvelope | varchar(30) | Tipul de anvelope ale vehiculului |
| consum_mediu | numeric(3,1) | Consumul mediu al vehiculului |
| validare | bit | Se va valida sau nu vehiculul dupa salvare |
| id_extern_centru_profit | varchar(25) | Id-ul extern al centrului de profit (optional daca se specifica id_centru_profit sau den_centru_profit) |
| culoare | varchar(30) | Culoarea autovehiculului |
| tip_auto | char(1) | Tipul auto poate fi V (autovehicul) sau R (remorca) |
| sarcina_utila | int | Sarcina utila |
| sarcina_maxima | int | Sarcina maxima |
| capacitate_rezervor | int | Capacitate rezervor |
| observatii | varchar(max) | Observatii |
| id_carburant | varchar(25) | Codul intern al carburantului in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica id_extern_carburant, cod_carburant, den_carburant) |
| id_extern_carburant | varchar(25) | Id-ul extern al carburantului (optional daca se specifica id_carburant, cod_carburant sau den_carburant) |
| cod_carburant | varchar(20) | Codul de bare al carburantului (optional daca se specifica id_carburant, id_extern_carburant sau den_carburant) |
| den_carburant | varchar(110) | Denumirea carburantului (optional daca se specifica id_carburant, cod_carburant sau id_extern_carburant) |
ANEXA C. Tabel erori posibile la importul vehiculelor:
| Coloana | Descriere |
|---|---|
| VEH001 | Lipsa date |
| VEH002 | Numar de circulatie nespecificat |
| VEH003 | Urmatoarele denumiri nu identifica unic marca |
| VEH004 | Lipsa marca in nomenclator |
| VEH005 | Urmatoarele denumiri nu identifica unic modelul |
| VEH006 | Lipsa model in nomenclator |
| VEH007 | Lipsa model cu aceasta marca in nomenclator |
| VEH008 | Urmatoarele denumiri nu identifica unic centrul de profit |
| VEH009 | Lipsa centru de profit in nomenclator |
| VEH010 | Urmatoarele denumiri nu identifica unic categoria |
| VEH011 | Lipsa categorie in nomenclator |
| VEH012 | Urmatoarele id-uri externe nu identifica unic proprietarul |
| VEH013 | Urmatoarele denumiri nu identifica unic proprietarul |
| VEH014 | Lipsa proprietar in nomenclator |
| VEH015 | Urmatoarele numere de circulatie exista deja in nomenclator |
| VEH016 | Urmatoarele numere de circulatie nu identifica unic vehiculul in nomenclator |
| VEH017 | Lipsa model vehicul in nomenclator |
| VEH018 | Urmatoarele id-uri externe nu identifica unic centrul de profit |
| VEH019 | Tipul auto nu este corect. Acesta trebuie sa fie V - pentru autovicul sau R - pentru remorca |
| VEH020 | Urmatoarele coduri fiscale nu identifica unic partenerul |
| VEH021 | Exista vehicule cu tip proprietate - Proprietate - pentru care s-a specificat proprietarul |
| VEH022 | Urmatoarele coduri nu identifica unic carburantul |
| VEH023 | Urmatoarele id-uri externe nu identifica unic carburantul |
| VEH024 | Urmatoarele denumiri nu identifica unic carburantul |
| VEH025 | Lipsa carburant in nomenclator |