Import utilaje
Importul utilajelor 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_utilaje_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_utilaje_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:
- Utilaje: utilaj.
- 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 utilajului existent 2 - Ignoră - se ignoră importul înregistrării curente, lăsând datele utilajului 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_utilaje 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. |
| den_utilaj | varchar(50) | Cod numeric sau alfanumeric care asigura identificarea unica a unui utilaj |
| id_marca | varchar(25) | ID unic pentru identificarea marcii unui utilaj (optional daca se specifica den_marca, id_model sau den_model) |
| den_marca | varchar(50) | Denumirea marcii utilajului (optional daca se specifica id_marca, id_model sau den_model) |
| id_model | varchar(25) | ID unic pentru identificarea modelului unui utilaj (optional) |
| den_model | varchar(50) | Denumirea modelului utilajului (optional daca se specifica id_model) |
| nr_inventar | varchar(20) | Numarul de inventar al utilajului |
| tip_proprietate | varchar(20) | Tipul de proprietate al utilajului (Proprietate, Leasing, Inchiriat, Client) |
| id_proprietar | varchar(25) | ID unic pentru identificarea proprietarului utilajului (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_tip | varchar(25) | ID unic pentru identificarea tipului/categoriei din care face parte utilajul (optional) |
| den_tip | varchar(50) | Denumirea tipului/categoriei din care face parte utilajul (optional daca se specifica id_tip) |
| 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) |
| tarif_pe_ora | money | Tariful pe ora al utilajului |
| an_fabricatie | int | Anul fabricarii utilajului |
| ore_initiale | int | Orele initiale ale utilajului |
| data_initiala | smalldatetime | Data initiala a utilajului |
| cilindree | int | Capacitatea cilindrica a utilajului |
| sarcina_utila | int | Sarcina utila a utilajului |
| sarcina_maxima | int | Sarcina maxima a utilajului |
| volum_maxim | int | Volumul maxim al rezervorului utilajului |
| consum_mediu | numeric(3,1) | Consumul mediu al utilajului |
| combustibil_initial | numeric(11,2) | Combustibilul initial al utilajului |
| validare | bit | Se va valida sau nu utilajul 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) |
| observatii | varchar(MAX) | Observatii |
ANEXA C. Tabel erori posibile la importul utilajelor:
| Coloana | Descriere |
|---|---|
| UTJ001 | Lipsa date |
| UTJ002 | Denumire utilaj nespecificata |
| UTJ003 | Urmatoarele denumiri nu identifica unic marca |
| UTJ004 | Lipsa marca in nomenclator |
| UTJ005 | Urmatoarele denumiri nu identifica unic modelul |
| UTJ006 | Lipsa model in nomenclator |
| UTJ007 | Lipsa model cu aceasta marca in nomenclator |
| UTJ008 | Urmatoarele denumiri nu identifica unic centrul de profit |
| UTJ009 | Lipsa centru de profit in nomenclator |
| UTJ010 | Urmatoarele denumiri nu identifica unic tipul(categoria) |
| UTJ011 | Lipsa tip(categorie) in nomenclator |
| UTJ012 | Urmatoarele id-uri externe nu identifica unic proprietarul |
| UTJ013 | Urmatoarele denumiri nu identifica unic proprietarul |
| UTJ014 | Lipsa proprietar in nomenclator |
| UTJ015 | Urmatoarele denumiri (numere de circulatie) exista deja in nomenclator |
| UTJ016 | Urmatoarele denumiri (numere de circulatie) nu identifica unic utilajul in nomenclator |
| UTJ017 | Lipsa model utilaj in nomenclator |
| UTJ018 | Urmatoarele id-uri externe nu identifica unic centrul de profit |
| UTJ019 | Urmatoarele coduri fiscale nu identifica unic partenerul |
| UTJ020 | Exista utilaje cu tip proprietate - Proprietate - pentru care s-a specificat proprietarul |