WinArhi > Fereastra principala > Oferte si Comenzi deschise > Meniu > Optiuni > Editare Feronerie > Import feronerie din XML – ghid pentru producători

Formatul XML al articolelor de feronerie

Acest subiect descrie fișierul XML cu articolele de feronerie în formatul 2: elementele lui, fiecare atribut al unui articol, cine îl completează și cum îl folosește WinArhi. Se adresează producătorilor de feronerie care generează fișierul din propriile sisteme și utilizatorilor WinArhi care îl importă din Editare Feronerie, fila Articole, meniul Articole > Importă din format XML. Pașii de lucru, regulile comune pentru valori și verificarea fișierului sunt în Import feronerie din XML – ghid pentru producători; seturile de feronerie au un fișier separat, descris în Formatul XML al seturilor de feronerie.

Fișierele în formatul 2 se importă corect numai cu WinArhi 2026.0.81 sau mai nou; versiunile mai vechi nu le pot importa corect (vezi Versiuni).

Schema XML (XSD) a fișierului și un exemplu complet: WinArhi-HardwareArticles-v2.xsd și WinArhi-HardwareArticles-example.xml (de descărcat din arhiva WinArhi-HardwareXML-v2.zip, cu toate schemele și exemplele). Un fișier valid pentru schemă se importă fără erori, cu excepția verificărilor pe care o schemă nu le poate face: coloanele mai înguste ale bazei de date a utilizatorului (un cod sau o valoare enumerată prea lungă refuză articolul, o denumire prea lungă este scurtată), coloanele vechi ANSI (un text pe mai multe rânduri cu caractere din afara codificării Windows este refuzat), perechile de vârfuri ale diagramei de greutate, o declarație DOCTYPE și o secțiune CDATA într-un Record. Codurile de referință (valute, unități de măsură, categorii de consum, culori, coduri de manoperă, membrii grupelor) sunt căutate în baza de date a utilizatorului și dau numai avertismente. Lista completă: ghid, la Validare.

Structura fișierului

Fișierul are elementul rădăcină Base, cu câte un element Record pentru fiecare articol. Un articol poate avea cel mult un element copil WeightChart (diagrama de greutate), cu una sau mai multe curbe WeightChartRecord. Toate valorile se scriu ca atribute; numele elementelor și ale atributelor sunt sensibile la majuscule și se scriu fără prefix de spațiu de nume. Singura excepție este atributul xsi:noNamespaceSchemaLocation al lui Base (cu declarația lui xmlns:xsi), folosit la validare: este permis și ignorat, fără avertisment. Fișierul se scrie în UTF-8, începe cu declarația XML și nu are DOCTYPE.

<?xml version="1.0" encoding="UTF-8"?>

</WeightChart>

</Record>

</Base>

Atributele elementului Base

Atribut	Valoare	Rol
FormatVersion	2 (obligatoriu)	Versiunea formatului. Un fișier fără FormatVersion este citit ca format 1 (exporturile versiunilor vechi ale WinArhi), cu reguli mai tolerante; un număr mai mare decât 2 cere o versiune mai nouă a WinArhi.
Content	HardwareArticles (obligatoriu)	Tipul fișierului. Un fișier de seturi (HardwareSets) dat la importul de articole este refuzat întreg.
Generator	text liber (opțional)	Programul sau firma care a generat fișierul; apare în antetul raportului de import.
Series	text liber (opțional)	Informativ; articolele sunt comune tuturor seriilor de profile, iar exportul articolelor nu îl scrie.
ClientColumns	nume de atribute separate prin spațiu	Scris de exportul WinArhi: coloanele proprii ale bazei de date sursă (coloane adăugate de un client). Un fișier de producător nu îl folosește.

Declarațiile xmlns și atributele xsi: (de ex. xsi:noNamespaceSchemaLocation="WinArhi-HardwareArticles-v2.xsd") sunt ignorate fără mesaj; orice alt atribut al lui Base este semnalat și ignorat.

Cum se importă un articol

- Un element Record = un articol. Articolul este identificat prin Code: dacă în baza de date există un articol cu exact același cod, el este actualizat; altfel se adaugă un articol nou. Importul nu șterge și nu redenumește articole: cele care lipsesc din fișier rămân neschimbate.

- Atribut absent = valoarea salvată rămâne (la un articol nou coloana rămâne goală). Atribut gol (Atribut="") = coloana se golește. Scrieți deci numai atributele pe care le administrați și nu trimiteți atribute goale pentru date pe care nu le aveți: ar șterge datele utilizatorului.

- Același Code nu poate apărea de două ori în fișier: toate aparițiile lui sunt refuzate. Ordinea elementelor Record și a atributelor nu contează.

- Înainte de a schimba ceva, WinArhi verifică tot fișierul, afișează raportul (erori și avertismente) și cere confirmarea, cu numărul de articole noi, modificate, neschimbate și refuzate.

- Unitatea de refuz este articolul: o valoare pe care WinArhi nu o poate folosi refuză articolul întreg, împreună cu diagrama lui, iar celelalte articole se importă. Avertismentele nu opresc importul; toate apar în raportul de import, cu numărul rândului din fișier.

- Un atribut necunoscut (scris greșit, cu alte majuscule sau pus pe alt element) refuză articolul; raportul propune numele corect, de ex. Poate "Colour"?. Numele românești ale coloanelor, scrise de exporturile vechi (de ex. Pret, LungimeMin, DiagramaGreutate), sunt acceptate și citite ca numele din format, cu un avertisment; un fișier nou folosește numele din tabelele de mai jos. Un nume românesc dat împreună cu numele din format, cu altă valoare, refuză articolul. Un atribut care numește o coloană proprie a bazei de date a utilizatorului (o coloană adăugată de el) este acceptat.

- Un atribut din format pe care baza de date a utilizatorului nu îl are (o bază mai veche, de ex. fără RotunjesteLaImpachetare, ImageFile sau UnghiManualCaAcc) este semnalat, iar valoarea lui se pierde; la fel elementul WeightChart într-o bază de date fără diagrame de greutate.

- Exporturile vechi (formatul 1) numeau elementele Record1, Record2...; în formatul 2 numele este exact Record, iar al curbelor exact WeightChartRecord.

- Orice alt element direct în Base este refuzat ca unitate separată; un alt element sau un text în interiorul unui Record refuză articolul. Comentariile XML sunt ignorate peste tot.

Formatul valorilor

Regulile complete sunt în ghid, la Valori; pe scurt:

- Numere: punct zecimal, fără separator de mii, fără unitate de măsură: 12, -3, 12.5, 1.5E3. Coloanele de tip întreg nu acceptă zecimale (12.0 este refuzat). Unitățile sunt cele din tabele (mm, grame, zile).

- Bife: X = da, "" = nu. WinArhi citește orice valoare negoală ca DA, de aceea 0, N, F, -, ? sau un text de mai multe caractere sunt refuzate.

- Texte pe mai multe rânduri (funcții, desen, liste de coduri): rândul nou se scrie 
, tabul 	. Un rând nou scris direct în atribut devine spațiu la citire (regula XML).

- Caractere speciale: & se scrie &, < se scrie <, " se scrie ".

- Coduri și alte texte de identitate (Code, Mark, Colour, MU, Currency, categorii): se păstrează exact, cu majuscule și spații; spațiile de la capete sunt semnalate, iar o valoare formată numai din spații este refuzată la Code (la celelalte este păstrată, cu avertisment). Nu conțin tab sau rând nou.

- Lungimi: maximele codurilor și ale textelor de identitate din tabele sunt cele ale bazei de date standard (le folosește și schema XSD). Denumirile (Description, SupplierDescription) nu au maxim în schemă. Baza de date a utilizatorului poate avea coloane mai înguste: un cod sau alt text de identitate mai lung decât coloana refuză articolul, iar o denumire mai lungă este scurtată, cu avertisment.

- Valori enumerate: codurile englezești din tabele, scrise exact. Un cod din listă este acceptat oricare i-ar fi lungimea: lățimea coloanei se aplică valorii pe care o salvează WinArhi (de ex. OppositeHinge se salvează OpusBalamale, 12 caractere). De aceea, în bazele de date vechi cu coloana Latura de 10 caractere, OppositeHinge este refuzat (vezi Latura).

- O valoare enumerată din afara listei refuză articolul (Side, Reference, OptiPtConsum, IntExt de mai multe caractere), cu excepția atributelor la care tabelul spune că valoarea este păstrată (Use, FittingType, MountingLocation, IntExt de o literă). Numai importul, nu și schema, citește și valorile românești pe care WinArhi le salvează în baza de date (de ex. Cremon, Maner, C, T) și codurile scrise cu alte majuscule (nu și la Use; la Side și Reference și fără spațiile din interior), acestea din urmă cu avertisment. Toleranța servește la citirea exporturilor vechi: un fișier de producător folosește codurile din schemă (vezi Validare).

Atributele unui articol (Record)

Tabelele de mai jos conțin toate atributele elementului Record, grupate după rol. Pentru fiecare: numele din XML, coloana din tabelul Articole al WinArhi, tipul și formatul (cu lungimea maximă standard), semnificația, regulile și cine completează valoarea: producătorul (obligatoriu, recomandat sau opțional) sau utilizatorul WinArhi. Coloanele utilizatorului au un tabel separat: Coloanele utilizatorului WinArhi.

1. Identitate și date comerciale

Atribut XML / coloana WinArhi	Tip și format	Semnificație și reguli	Cine completează
Code Cod Magazie	Text, 1–20 caractere. Obligatoriu. Fără apostrof, tab sau rând nou; nu poate fi gol sau numai spații. XY (în orice scriere) este rezervat.	Codul articolului (de regulă codul de catalog al producătorului) și cheia importului: cod existent = actualizare, cod nou = articol nou. Seturile de feronerie, funcțiile altor articole (BucPerBuc(Cod, 2)), membrii grupelor !GROUP și listele de coduri (CompatibleHandles, ColourVariantCodes) folosesc articolul prin acest cod. Comparația este exactă: ABC, abc și ABC urmat de un spațiu sunt coduri diferite. Folosiți cel mult 20 de caractere chiar dacă baza utilizatorului are o coloană mai lată: rândurile seturilor păstrează codul în 20 de caractere (un cod mai lung este semnalat). Un cod nou care diferă de unul existent doar prin majuscule sau spații este semnalat. XY este rezervat rândurilor de domeniu ale seturilor. Nu refolosiți un cod pentru alt produs; pentru un cod schimbat trimiteți articolul cu codul nou și codul vechi în OldCode, iar seturile, funcțiile altor articole și listele grupelor cu codul nou (ele nu folosesc Cod vechi). Virgula este permisă, dar în funcții cere o scriere specială (vezi Funcții).	Producător – obligatoriu
Mark Marcă	Text, max. 30. Fără apostrof.	Marca (producătorul sau sistemul de feronerie), de ex. Roto NT. Trece în consum și în raportul Comandă feronerie, unde utilizatorul alege mărcile pentru care emite comanda, și grupează articolele în tabel. Este text liber: nu trebuie să existe în Furnizori (acolo trebuie să existe marca seturilor, atributul Mark al elementului Set); se recomandă însă același text. Folosiți aceeași scriere la toate articolele mărcii. Un articol existent care are altă marcă este semnalat.	Producător – recomandat
Use Utilizare	Window, Door, !GROUP sau gol. Se scrie exact (fără alte majuscule).	Destinația articolului. Window și Door sunt informative (gruparea în editor). !GROUP face din articol o grupă (kit): într-un set grupa nu intră în consum, ci în locul ei intră membrii din Functions și, după sensul de deschidere al cercevelei, cei din GroupInwardOpening sau GroupOutwardOpening. Numai !GROUP exact face o grupă: !group sau GROUP nu. O altă valoare este păstrată, cu avertisment, și nu are niciun efect. La o grupă lăsați Price gol sau 0.	Producător – recomandat
Colour Culoare	Text, max. 25. Fără apostrof și fără virgulă.	Culoarea de feronerie a articolului, exact ca în coloana Culoare Feronerie (sau Culoare fixă feronerie) a culorilor utilizatorului. Gol = piesă neutră, introdusă indiferent de culoarea ferestrei. La introducerea unui set, WinArhi alege culoarea de feronerie a ferestrei dintre culorile rândurilor setului și păstrează numai rândurile al căror articol are culoarea goală, egală cu culoarea aleasă sau egală cu Culoare fixă feronerie a culorii profilului. De aceea fiecare variantă colorată a unei piese vizibile (mâner, capace) este un articol separat, cu culoarea lui, iar piesele ascunse au culoarea goală. Comparația este exactă, cu majuscule: cereți utilizatorului lista lui de culori. O culoare care nu este culoare de feronerie în nicio serie este semnalată. Rândurile seturilor au propria copie a culorii, iar culoarea feroneriei ferestrei se alege dintre aceste copii. Importul articolelor nu actualizează rândurile seturilor: după o schimbare de culoare la articole existente, utilizatorul trebuie să ruleze Articole > Copiază denumirile și culorile în seturi (sau să reimporte seturile); altfel piesa nu mai intră în seturi, fără niciun mesaj.	Producător – obligatoriu la piesele colorate
Description Denumire	Text descriptiv, 50 de caractere în baza standard (60–100 în unele baze).	Denumirea articolului în consum, în comanda de feronerie, pe ofertă și în rapoarte. Un text mai lung decât coloana este scurtat, cu avertisment. Rândurile seturilor au propria copie a denumirii: importul seturilor o completează din articol când rândul nu are denumire, deci importați articolele înaintea seturilor. După o schimbare de denumire, utilizatorul rulează Articole > Copiază denumirile și culorile în seturi.	Producător – obligatoriu (practic; importul acceptă articolul și fără)
SupplierDescription Denumire Furnizor	Text descriptiv, 50.	Furnizorul de la care utilizatorul cumpără articolul; apare în consum și în comanda de feronerie. Trimiteți-l numai dacă utilizatorul cumpără direct de la dvs.; altfel omiteți-l, ca să nu înlocuiți distribuitorul completat de utilizator.	Producător – opțional
MU UM	Text, max. 10. Codul românesc, cu litere mici: buc (bucată), per (pereche), set, ml (metru liniar), m (metru), mp (m²), mc (m³), km, kg, g.	Unitatea de măsură a prețului, a cantității din set, a împachetării și a gramajului. Cu ml sau m, pe un rând de set care are o latură (inclusiv None), cantitatea din set se înmulțește cu lungimea piesei din desen, în metri, deci prețul este pe metru. Lungimea din desen este rezultatul funcției SetLength() din Drawing sau, fără ea, C1 = min(spațiul liber, Length). Dacă piesa nu are o poziție validă (Side="None", Reference lipsă sau nepotrivită) sau Length lipsește și desenul nu are SetLength(), lungimea din desen este 0, iar cantitatea consumată și prețul devin 0, fără mesaj de eroare. Fără latură (Side gol și în articol, și în rândul de set), cantitatea din set se ia direct în metri. Pentru piese scrieți buc (nu pcs sau Buc): o parte din program compară exact. Un cod din afara listei WinArhi este semnalat, la fel un articol nou fără MU. Unitățile ex, tabel, functii, script sunt rezervate accesoriilor WinArhi.	Producător – obligatoriu (practic; importul acceptă articolul și fără)
Price Preț	Număr zecimal (se acceptă și valori negative).	Prețul de listă pe UM, fără TVA, în valuta din Currency, înainte de rabat. WinArhi calculează costul: Preț × (1 − Rabat %/100) × (1 + Vamă %/100) × (1 + Alte Taxe %/100) × (1 + Alte Taxe2..4 %/100) + Adaos fix, îl convertește în valuta ofertei și îl adaugă la categoria de consum a articolului. Când prețul se schimbă (și la un articol nou cu preț), importul pune data curentă în Dată modificare preț. Prețul este o dată a producătorului: se înlocuiește fără întrebare.	Producător – recomandat
Currency Valută	Text, max. 3. Un cod din cursurile valutare ale utilizatorului (de regulă ISO: EUR, RON, USD) sau 0.	Valuta prețului; trebuie să existe exact (cu majuscule) în tabelul de valute al utilizatorului. 0 = articol fără preț, intenționat. Obligatorie când Price este diferit de 0: un articol nou cu preț și fără valută este semnalat, la fel o valută necunoscută.	Producător – recomandat
DiscountGroup Grupă Rabat	Text, max. 10.	Grupa de rabat din lista de prețuri a producătorului. Nu intră în calcul: utilizatorul o folosește ca să stabilească Rabat % pe grupe. Folosiți exact același text la toate articolele grupei.	Producător – opțional
ConsumptionCategory Categorie consum	Text, max. 30. Codul unei categorii din Categorii adaosuri consum ale utilizatorului (vezi Formare preț), de regulă Feronerie.	Categoria de consum în care intră costul articolului la formarea prețului și în rapoarte. Fără o categorie existentă, costul articolului nu intră în prețul ofertei. Stabiliți codul împreună cu utilizatorul: un cod necunoscut este semnalat, la fel un articol nou fără categorie. La articolele existente valoarea din fișier o înlocuiește pe a utilizatorului; dacă el folosește alte coduri, omiteți atributul.	Producător – recomandat
Packing Împachetare	Număr zecimal ≥ 0, în UM.	Cantitatea dintr-un ambalaj (de ex. 100 de bucăți). Comanda de feronerie poate rotunji cantitățile la ambalaje întregi. Gol sau 0 = fără ambalaj.	Producător – opțional
SupplyTerm Termen aprovizionare	Număr întreg ≥ 0, zile.	Termenul de aprovizionare. Termenul unei poziții este cel mai mare termen din consumul ei și poate apărea în comanda de feronerie, în consum sau pe ofertă.	Producător – opțional
OldCode Cod vechi	Text, max. 20. Un singur cod.	Codul anterior al aceluiași articol: când un cod (din seturile salvate în ofertele existente sau din accesorii) nu mai există ca Code, WinArhi folosește la calculul consumului articolul care îl are în Cod vechi. Importul nu șterge articolul cu codul vechi. Rândurile seturilor (la introducerea setului pe o fereastră), funcțiile altor articole (BucPerBuc, BucPerArt...) și listele de membri ale grupelor nu folosesc Cod vechi: trimiteți-le cu codul nou (fișierul de seturi, respectiv articolele care le conțin). Altfel ele folosesc în continuare articolul vechi, iar după ștergerea lui dau la fiecare calcul mesajul că articolul nu există. OldCode egal cu Code este semnalat (nu are efect).	Producător – opțional
Category1 Category2 Category3 Category4 Category5 Categorie 1 … Categorie 5	Text, max. 30. Fără apostrof.	Categorii libere de filtrare (de ex. o familie de produse) în ferestrele de schimbare a mânerului, a balamalei de ușă, a broaștei și a butucului; nu au altă logică. Completați-le numai de acord cu utilizatorul (la articolele existente le înlocuiesc pe ale lui), cu aceeași scriere la toată familia și fără spații la capete.	Producător – opțional
ImageFile Imagine	Text, max. 80: cale relativă, de ex. Feronerie\ABUS.png.	Imaginea articolului, din folderul Images al bazei de date a utilizatorului; apare în editorul de articole și pe rapoartele ofertei când articolul este accesoriu. Fișierul imagine nu este transportat de XML: trimiteți calea numai dacă livrați și imaginile.	Producător – opțional
ColourVariantCodes Coduri la schimbare culoare	Listă de coduri, câte unul pe rând ( între ele).	Codurile aceluiași produs în alte culori. Când o balama de ușă, un butuc sau o broască aleasă manual pe fereastră trebuie păstrată la reintroducerea setului și culoarea ei nu se potrivește cu noua culoare de feronerie, WinArhi folosește primul cod din listă care are culoarea potrivită. Are efect la FittingType DoorHinge, KeyCylinder și Lock-bolt.	Producător – opțional

2. Tip și comportament

Atribut XML / coloana WinArhi	Tip și format	Semnificație și reguli	Cine completează
FittingType Tip articol	Handle, Espagnolete, HandleBox, RebateReverserEspagnolete, Lock-bolt, DoorHinge, CamLock, KeyCylinder, HandleRod, PinOnRod sau gol.	Rolul funcțional al articolului în logica de feronerie a WinArhi (cota mânerului, prelungirile, schimbarea mânerului, a broaștei, a balamalei de ușă sau a butucului din fereastră, lista de blocatori). Gol = articol obișnuit (șurub, capac, foarfecă, balama de fereastră, colțar). Semnificația fiecărei valori: Valorile FittingType. Scrieți exact Espagnolete (un singur t) și Lock-bolt (cu cratimă). O altă valoare este păstrată, cu avertisment, și nu are niciun rol standard (o pot citi doar scripturile proprii ale utilizatorului).	Producător – recomandat
Functions Funcții	Text pe mai multe rânduri ( între rânduri).	La un articol obișnuit: funcțiile de legătură, câte una pe rând, executate când articolul intră în consum (de ex. BucPerBuc(SC-4X25, 2) adaugă două șuruburi). La un articol !GROUP: codurile membrilor grupei, câte unul pe rând. Detalii în secțiunea Funcții de mai jos.	Producător – recomandat
AccessoryFunctions Funcții când este accesoriu (coloana FunctiiCaAcc)	Text pe mai multe rânduri.	Funcțiile folosite în locul Functions când articolul este adăugat în ofertă ca accesoriu separat; la un !GROUP, membrii vânduți împreună cu grupa. Au efect numai după ce utilizatorul face articolul accesoriu (CatConsumCaAcc și CodFormarePret). Nu există revenire la Functions: dacă trebuie aduse aceleași piese, scrieți funcțiile în ambele atribute.	Producător – opțional
GroupInwardOpening Grupă pt. cercevea interior (coloana GrupaCcvInt)	Listă de coduri de articole, câte unul pe rând.	Numai la Use="!GROUP": membrii care intră în consum, pe lângă cei din Functions, când cerceveaua se deschide spre interior. Fiecare cod intră cu cantitatea rândului din set; pentru două bucăți scrieți codul de două ori. Fără funcții și fără comentarii. Un cod care nu există printre articole este semnalat. Importul nu semnalează rândurile care încep cu // sau conțin paranteze, dar în lista unei grupe și ele dau, la fiecare calcul, mesajul că articolul nu există.	Producător – opțional
GroupOutwardOpening Grupă pt. cercevea exterior (coloana GrupaCcvExt)	Listă de coduri de articole, câte unul pe rând.	Ca GroupInwardOpening, pentru cercevelele care se deschid spre exterior.	Producător – opțional
AcceptedSashes Cercevele acceptate	Listă de coduri de profil, câte unul pe rând.	Codurile profilelor de cercevea pe care se poate monta articolul, așa cum sunt în tabelul de profile al utilizatorului. Gol = orice cercevea. Lista filtrează și mânerele propuse la schimbarea mânerului. Dacă profilul cercevelei nu este în listă, la introducerea setului apare mesajul „Articolul de Feronerie '...' nu este definit pentru cerceveaua '...'”, setul este golit și cerceveaua nu se creează, cu excepția cazului în care utilizatorul a bifat Permite folosirea feroneriei și dacă cercevelele sau tocurile acceptate nu corespund. Comparația este exactă; completați lista numai în acord cu utilizatorul. Un rând cu spații la capete este semnalat.	Producător – opțional
AcceptedThresholdsFrames Tocuri acceptate (în fereastra articolului: Tocuri sau bandouri acceptate)	Listă de coduri de profil, câte unul pe rând.	Codurile profilelor fixe (toc, bandou, prag) de pe latura pe care stă articolul. Gol = orice profil. Aceleași reguli ca la AcceptedSashes, cu mesajul „... nu este definit pentru tocul sau bandoul '...'”.	Producător – opțional
CompatibleHandles Mânere compatibile	Listă de coduri de articole mâner, câte unul pe rând.	Pe un cremon sau pe o broască: mânerele care se pot monta pe el; pe un mâner: mânerele cu care poate fi înlocuit. Gol = orice mâner. La schimbarea mânerului unei ferestre sunt propuse numai mânerele permise de toate listele implicate, iar la reintroducerea setului un mâner ales manual se păstrează numai dacă este compatibil. Codurile sunt articole cu FittingType="Handle".	Producător – recomandat la cremoane, broaște și mânere
MountingLocation Loc montaj	Sash (pe cercevea), Frame (pe toc) sau gol.	Locul de montaj al piesei: Frame la piesele de pe toc (de ex. blocatorii), Sash la cele de pe cercevea. Manopera articolului se atribuie tocului la Frame, altfel cercevelei; în WAEagle (aplicația WinArhi pentru asistarea prelucrării manuale și urmărirea producției) articolul apare la posturile de feronerie ale cercevelei sau ale tocului (numai cu bifa WAEagle a utilizatorului); cota pe profil din raportul de debitare apare pe toc sau pe cercevea. Gol = tratat ca cercevea, dar articolul nu apare în niciun tabel WAEagle. O altă valoare este păstrată, cu avertisment, fără efect standard.	Producător – recomandat

3. Parametri de montaj (mâner, falț, prelungiri)

Atribut XML / coloana WinArhi	Tip și format	Semnificație și reguli	Cine completează
HandleHeight Înălțime mâner (în fereastra articolului: Cotă mâner)	Număr întreg ≥ 0, mm.	Cota mânerului, măsurată pe falțul laturii mânerului. Se folosește numai la FittingType Espagnolete și Lock-bolt: la un mecanism cu cotă fixă (FixedHandleHeight=X) este poziția reală a mânerului, la unul variabil este cota implicită. Gol sau 0 = mânerul la mijlocul laturii. Originea cotei depinde de referința (Reference) a cremonului sau a broaștei: cu HandleDownRight, DownRight sau DownRightJoined, axul mânerului se așază la această cotă măsurată de la capătul de jos/dreapta al falțului; cu orice altă referință, de la capătul de sus/stânga (vezi Referința). Folosiți o referință DownRight, ca să puteți copia cotele din catalog (date de regulă de la falțul de jos) fără să le recalculați. Dintre mai multe cremoane cu cotă fixă ale setului, WinArhi îl alege pe cel cu cota cea mai apropiată de cea cerută, deci fiecare variantă trebuie să aibă cota ei reală. Cota se transmite și centrelor de prelucrare.	Producător – recomandat la cremoane și broaște
FixedHandleHeight Înălțime mâner fixă (în fereastra articolului: Cotă mâner fixă)	Bifă: X sau gol.	X = mecanismul are mânerul la cota fixă din HandleHeight: utilizatorul nu o mai poate muta de pe desen, iar prelungirile se calculează pentru o cotă fixă (și la mecanismul de ștulp). Gol = cotă variabilă. Când este X, completați și HandleHeight.	Producător – recomandat la cremoane și broaște
MinRabbet Min falț	Număr întreg ≥ 0, mm.	Limita inferioară a dimensiunii de falț a cercevelei acoperite real de cremon, broască sau mecanismul de ștulp. Înlocuiește MinY din rândul setului la calculul prelungirilor (pe laturile verticale) și la alegerea cremonului variabil. Gol = se folosește MinY din set; preferați gol în locul lui 0.	Producător – recomandat
MaxRabbet Max falț	Număr întreg ≥ 0, mm.	Limita superioară a dimensiunii de falț acoperite real de mecanism; înlocuiește MaxY din set la calculul prelungirilor (pe laturile verticale). Gol sau 0 = MaxY din set. MinRabbet mai mare decât MaxRabbet (ambele completate) este semnalat.	Producător – recomandat
MullionAvoidance1 Evitare 1 bandou	Număr întreg, mm, cu semn.	Împreună cu MullionAvoidance2: zona, în mm față de cota mânerului, pe care un bandou (montant sau traversă) nu trebuie să o întâlnească pe latura mânerului – spațiul ocupat de cutia cremonului sau de broască. Contează intervalul dintre cele două valori, nu ordinea lor. Dați o valoare negativă și una pozitivă, astfel încât zona să acopere ambele părți ale mânerului (de ex. -150 și 150); pe o latură verticală, valoarea negativă este deasupra cotei mânerului, iar cea pozitivă dedesubt; pe o latură orizontală, la o cutie asimetrică, folosiți pe ambele părți distanța mai mare. Dacă un bandou cade în zonă, pe desen apare o bulină roșie la mâner (avertizare, nu blocare). Are efect la primul cremon sau prima broască din set.	Producător – recomandat la cremoane și broaște
MullionAvoidance2 Evitare 2 bandou	Număr întreg, mm, cu semn.	Celălalt capăt al zonei de evitare; vezi MullionAvoidance1.	Producător – recomandat la cremoane și broaște
Dornmass Dornmass	Număr zecimal, mm.	Distanța de la fața mecanismului (linia de falț a cercevelei) până la axul pătratului mânerului (backset). Are efect numai la Espagnolete, Lock-bolt și HandleBox: devine dornmass-ul cercevelei, folosit ca variabila DM în desenele pieselor (mânerul se desenează la X = DM), la alegerea prelucrărilor pe profil ale centrelor de prelucrare și în raportul de debitare. Gol sau 0 la cremon sau broască: se ia dornmass-ul casetei mânerului din set.	Producător – recomandat la cremoane, broaște și casete de mâner
C_MinRequestedClearance C_LuftMinCerut	Număr zecimal, mm.	Luftul minim (jocul dintre cercevea și toc) cerut de articol pe latura pe care este montat, de ex. 13.5 la balamalele ascunse. Dacă luftul rezultat din profile este mai mic, WinArhi mărește luftul cercevelei pe acea latură. Pe o latură contează valoarea cea mai mare. Includerea articolului în set nu trebuie să depindă de dimensiunea falțului pe direcția pe care cere luftul. Gol sau 0 = fără cerință.	Producător – opțional

4. Desen și CNC

Aceste atribute așază piesa pe cercevea: desenul feroneriei din set, centrele de montaj feronerie și prelucrările pe profil, posturile WAEagle și raportul de debitare. Ele nu schimbă prețul, cu o excepție: la articolele cu UM ml sau m cantitatea consumată rezultă din lungimea din desen. Un rând de set își poate da propriile valori de Side, Reference, Dimension, DimensionPercent, Length, DrawingOrder, PositioningOrder și IntExt; valorile articolului se folosesc când rândul de set le are goale. Detalii despre desen: Desen din Set.

Ramurile piesei. Poziția piesei este originea desenului ei, dată de Side, Reference, Dimension și DimensionPercent. Prima ramură este partea care pornește din origine în sensul piesei (sensul +Y al desenului); ei îi corespund variabila C1, Length, MinLength și cotele pozitive din CamLockDimensions1/2. A doua ramură este, la piesele de colț, partea de pe latura vecină; la celelalte piese, partea din origine înapoi spre referință, iar la piesele raportate la axul mânerului (HandleUpLeft, HandleDownRight), partea de cealaltă parte a axului. Ei îi corespund variabila C2, Length2, MinLength2 și cotele negative sau 0 din CamLockDimensions1/2. Exemplu: un cremon cu Side="Handle" și Reference="HandleDownRight", pe o latură verticală, pornește din axul mânerului spre capătul de jos; cu CamLockDimensions1="150
-400" are un slot de blocator la 150 mm sub mâner și unul la 400 mm deasupra lui.

Atribut XML / coloana WinArhi	Tip și format	Semnificație și reguli	Cine completează
Side Latură	Handle, OppositeHandle, Hinge, OppositeHinge, UpLeft, DownRight, Left, Right, Up, Down, None sau gol.	Latura cercevelei pe care se montează piesa: relativ la deschidere (latura mânerului, a balamalelor și opusele lor; UpLeft și DownRight = laturile perpendiculare pe balamale, de ex. sus și jos la o cercevea cu balamale laterale) sau absolut (Left, Right, Up, Down, privind din interior). Semnificația fiecărei valori: Latura. Se completează împreună cu Reference. La cremoane și broaște, Left, Right, Up, Down, Hinge și OppositeHinge mută latura mânerului ferestrei. La deschiderile fără latură de balamale (fix, ghilotină, paralel-culisant) folosiți laturi absolute. None sau gol = piesa nu se poziționează și nu se desenează; ea rămâne în consum, dar la articolele cu UM ml sau m cantitatea devine 0 cu None, iar fără latură cantitatea din set se ia direct în metri (vezi MU).	Producător – recomandat
Reference Referință	UpLeft, DownRight, UpLeftJoined, DownRightJoined, HandleUpLeft, HandleDownRight, HandleSide, OppositeHandleSide, HingeSide, OppositeHingeSide, HandleSideJoined, OppositeHandleSideJoined, HingeSideJoined, OppositeHingeSideJoined sau gol.	Punctul de pe latură față de care se măsoară poziția piesei (Dimension, DimensionPercent) și sensul în care se întinde ea: un capăt al laturii (UpLeft, DownRight; HandleSide … OppositeHingeSide = capătul dinspre latura numită, pe o latură perpendiculară pe ea), capătul zonei ocupate deja de piesele din același colț (variantele Joined) sau axul mânerului (HandleUpLeft, HandleDownRight). Semnificația fiecărei valori: Referința. Gol = piesa nu se poziționează. Valorile vechi 1/2, 1/3, 2/3, 1/4, 3/4 sunt păstrate cu avertisment și nu au efect; Echidistant este refuzat (folosiți DimensionPercent).	Producător – recomandat
Dimension Cotă	Număr zecimal, mm, cu semn.	Distanța de la punctul de referință până la originea desenului piesei, de-a lungul laturii, pe linia de falț, în sensul piesei. Poziția = lungimea falțului × DimensionPercent / 100 + Dimension. Cu o referință de capăt, poziția 0 face din articol o piesă de colț (a doua ramură stă pe latura vecină). La un mâner (Handle) cu referință HandleUpLeft/HandleDownRight este ignorată. La un cremon sau o broască cu Side="Handle", Reference="DownRight" sau "DownRightJoined" și Dimension mai mare decât 0.5, valoarea rotunjită la mm devine cota mânerului (vezi avertismentul din Poziționarea pieselor obișnuite, după acest tabel).	Producător – recomandat
DimensionPercent Cotă procent	Număr zecimal, procente.	Partea poziției exprimată în procente din lungimea falțului laturii (de ex. 50 = la mijloc, oricare ar fi dimensiunea ferestrei), adunată la Dimension.	Producător – opțional
Length Lungime	Număr zecimal ≥ 0, mm.	Lungimea nominală (maximă) a piesei pe prima ramură. Limitează variabila C1 a desenului (C1 = spațiul liber, dar cel mult Length) și ocupă zona din capăt pentru piesele poziționate după ea; dacă spațiul este mai mic, piesa se taie. Necesară la prelungitoare (codurile din EspagnoleteExtensions ale setului) și la orice articol al cărui desen folosește C1. La articolele cu UM ml sau m este lungimea maximă a piesei (de regulă lungimea barei livrate), iar cantitatea consumată = cantitatea din set × lungimea din desen / 1000, unde lungimea din desen este rezultatul funcției SetLength() din Drawing sau, fără ea, C1. Length gol și fără SetLength() dă cantitatea 0.	Producător – recomandat
Length2 Lungime 2	Număr zecimal ≥ 0, mm.	Lungimea piesei pe a doua ramură (variabila C2; vezi Ramurile piesei, mai sus): la piesele de colț, ramura de pe latura vecină; la piesele raportate la axul mânerului, partea de cealaltă parte a axului.	Producător – opțional
MinLength Lungime minimă (coloana LungimeMin)	Număr zecimal ≥ 0, mm.	Lungimea minimă la care poate fi tăiată piesa pe latura principală; sub ea, verificarea ofertei afișează un mesaj. La prelungitoare: lungimea până la care poate fi scurtat prelungitorul. Gol sau 0 = fără verificare (la prelungitoare: lungime fixă).	Producător – opțional
MinLength2 Lungime 2 minimă (coloana Lungime2Min)	Număr zecimal ≥ 0, mm.	Lungimea minimă la care poate fi tăiată a doua ramură (la piesele de colț; vezi Ramurile piesei, mai sus).	Producător – opțional
Drawing Desen	Text pe mai multe rânduri: o instrucțiune pe rând, între rânduri.	Desenul vectorial al piesei, în mm, desenat ca pentru latura stângă cu referința sus, privind din interior; WinArhi îl rotește, îl oglindește și îl așază după Side, Reference și Dimension. Limbajul (Rectangle, Line, Circle, Polygon, TextOut, variabilele C1, C2, DM, prefixele 1: … 4:, S1:, S2:) este descris în Desen din Set. Gol = fără desen (poziția pentru CNC și debitare se calculează oricum). O virgulă dintr-un text de TextOut se scrie &#44;.	Producător – opțional
DrawingType1 Tip desen 1	Bifă: X sau gol.	X = piesa apare în desenul general al ferestrei: pe ecran, în WAEagle și în rapoartele care cer tipul 1 (de regulă oferta). O altă literă decât X este păstrată, cu avertisment.	Producător – opțional
DrawingType2 Tip desen 2	Bifă: X sau gol.	X = piesa apare în desenul pieselor de pe toc (montajul feroneriei pe toc).	Producător – opțional
DrawingType3 Tip desen 3	Bifă: X sau gol.	X = piesa apare în desenul pieselor de pe cercevea (montajul feroneriei pe cercevea).	Producător – opțional
CamLockDimensions1 Cote 1 blocatori	Listă de numere zecimale, câte unul pe rând ( între ele), mm.	Pozițiile (sloturile) în care se pot pune blocatori – piesele de închidere de pe toc, în dreptul bumbilor piesei –, măsurate de la originea piesei de-a lungul laturii. Valoare pozitivă = pe prima ramură, în sensul piesei; negativă sau 0 = pe a doua ramură, la distanța fără semn (la piesele de colț pe latura vecină, la piesele raportate la axul mânerului de cealaltă parte a axului; vezi Ramurile piesei, mai sus). Fiecare rând este un slot numerotat de la 0; setul alege în elementul CamLocks ce blocator intră în fiecare slot (vezi CamLocks). Ordinea rândurilor contează: nu o schimbați după ce seturile au fost definite. Fără rânduri goale; un rând care nu este număr este semnalat.	Producător – recomandat la piesele cu bumbi de închidere
CamLockDimensions2 Cote 2 blocatori	Listă de numere zecimale, câte unul pe rând, mm.	A doua listă de sloturi, cu același format și măsurată la fel (aceleași reguli, același sistem de măsurare), folosită când rândul de set o cere (atributul UseCamLocksDimensions2 al rândului de set).	Producător – opțional
DrawingOrder Ordine desenare	Număr întreg, cu semn.	Ordinea de desenare a pieselor cercevelei, crescător: o piesă desenată mai târziu o acoperă pe cea de dinainte. Nu schimbă poziția pieselor.	Producător – opțional
PositioningOrder Ordine poziționare	Număr întreg, cu semn.	Ordinea în care piesele sunt așezate pe falț pentru calculul lungimilor de cuplare (C1, C2), al pieselor legate (Joined) și al lungimilor de tăiere: întâi piesele cu valoare, crescător, apoi cele fără valoare. Completați-o la piesele de care se cuplează alte piese care se taie (colțare, cremoane).	Producător – opțional
IntExt Interior-Exterior	I, E, IE, EI sau gol.	Condiție de vizibilitate în desenele de tip 1 și 4, după partea din care este privită fereastra: I = numai din interior, E = numai din exterior, IE = numai din partea deschiderii, EI = numai din partea opusă deschiderii; gol = întotdeauna. La mânere: I = mânerul de interior, E = de exterior, gol = ambele. Literele mici sunt citite ca majuscule. O altă literă este păstrată, cu avertisment, dar piesa, împreună cu blocatorii ei, nu mai apare în desenele de tip 1 și 4, iar un mâner nu mai este găsit ca mâner de interior sau de exterior; nu o folosiți. O valoare de mai multe caractere refuză articolul.	Producător – opțional (recomandat la mânere)

Poziționarea pieselor obișnuite

Valorile de poziționare se pot da în articol (valabile în toate seturile) sau pe rândurile de set, care le înlocuiesc (vezi Latura și Referința). Modelarea obișnuită:

Piesa	Side	Reference	Dimension și lungimi
Mâner (FittingType="Handle")	Handle	HandleDownRight (sau HandleUpLeft)	Originea desenului este axul mânerului, la cota mânerului dată de cremon sau de broască. Dimension este ignorată.
Cremon sau broască (Espagnolete, Lock-bolt)	Handle	HandleDownRight (sau HandleUpLeft)	Piesa pornește din axul mânerului. Length = partea de pe prima ramură (cu HandleDownRight, spre capătul de jos/dreapta), Length2 = partea de cealaltă parte a axului. Dimension gol (sau deplasarea originii față de ax). La un mecanism cu cotă fixă completați și HandleHeight și FixedHandleHeight.
Colțar, transmisie de colț	latura ramurii principale	UpLeft sau DownRight (capătul laturii)	Dimension gol sau 0: piesă de colț, cu Length pe latura ei și Length2 pe latura vecină.
Balama de cercevea	Hinge	UpLeft (balamaua de sus) sau DownRight (de jos)	Dimension = distanța de la capătul falțului (de ex. 150). Aceeași balama se folosește la ambele capete, deci Reference și Dimension se dau de regulă pe rândurile de set, ca în exemplu.
Piesă așezată în continuarea altora pe aceeași latură	latura piesei	UpLeftJoined sau DownRightJoined	Pornește de la capătul zonei ocupate deja de piesele așezate la acel capăt (vezi PositioningOrder); Dimension = distanța suplimentară.

Atenție: la un cremon sau o broască cu Side="Handle" și Reference="DownRight" sau "DownRightJoined", Dimension nu mai este o simplă deplasare: o valoare mai mare decât 0.5, rotunjită la mm, devine cota mânerului ferestrei, ca la un mecanism cu cotă fixă. Un cremon așezat astfel la 150 mm de capătul de jos mută mânerul la 150 mm. Poziționați cremoanele și broaștele față de axul mânerului (HandleDownRight, HandleUpLeft).

5. Greutate

Atribut XML / coloana WinArhi	Tip și format	Semnificație și reguli	Cine completează
Weight Gramaj	Număr întreg ≥ 0, grame pe UM.	Greutatea articolului pe bucată (buc) sau pe metru (ml); se folosește la greutatea ferestrei și a comenzii. Gol = greutate necunoscută. Nu are legătură cu verificarea de portanță a balamalelor (MaxWeight al setului și diagrama de greutate).	Producător – recomandat
WeightChart (atribut) Diagramă greutate	Numai valoarea goală: WeightChart="".	Șterge diagrama de greutate salvată a articolului. Se scrie numai fără elementul WeightChart; o valoare negoală refuză articolul. Fără atribut și fără element, diagrama salvată rămâne neschimbată.	Producător – opțional
<WeightChart> (element) Diagramă greutate	Element copil al lui Record, cu curbe WeightChartRecord.	Diagrama de portanță a unei balamale sau a altei piese portante: Diagrama de greutate.	Producător – recomandat la piesele verificate cu VerifyWeightChart

6. Atribute ignorate sau învechite

Atribut XML / coloana WinArhi

Tip și format

Semnificație și reguli

Cine completează

DataModifPret

Dată modificare preț

Ignorat la import.

Data ultimei modificări a prețului. O completează WinArhi, cu data curentă, la articolele al căror preț se schimbă și la articolele noi cu preț. Nu se trimite.

WinArhi

CatConsumCaMaterialAcc

CatConsumCaMaterialAcc

Text, max. 30.

Coloană învechită: WinArhi o transportă între bazele de date care o au, dar nu o folosește nicăieri. Un fișier de producător nu o conține.

–

Coloanele utilizatorului WinArhi

Coloanele de mai jos descriu setările proprii ale firmei care folosește WinArhi: manopera, rabaturile și taxele, rapoartele, vizibilitatea în liste, WAEagle și accesoriile. Nu sunt date despre produs, de aceea producătorul de feronerie le lasă afară din fișier. Atributele lor păstrează numele românești ale coloanelor (excepții moștenite: DiscountPercent, OtherTaxesPercent și DrawingType4). Exportul WinArhi le scrie, pentru că un export servește și la mutarea articolelor între bazele de date ale aceleiași firme.

De ce le omite producătorul. Un atribut absent păstrează valoarea utilizatorului, iar un atribut gol o șterge. Un fișier construit pornind de la un export WinArhi conține toate aceste atribute, adesea goale: importat așa, ar șterge minutele de manoperă, codurile de formare a prețului, rabaturile și setările de rapoarte ale utilizatorului. Eliminați-le din șablon. Un articol nou importat fără ele pornește cu aceste coloane goale, iar utilizatorul le completează după import.

Întrebarea „Păstrați valorile dvs. în aceste coloane?”. Dacă fișierul ar schimba, la articole existente, o valoare negoală a utilizatorului într-una dintre aceste coloane, WinArhi întreabă o singură dată, după confirmarea importului: „Fișierul schimbă, la N articole existente, coloane pe care de obicei le completați dvs. în WinArhi: ... Păstrați valorile dvs. în aceste coloane?”. Da = importul nu atinge aceste coloane la articolele existente (restul valorilor se importă); Nu = se iau valorile din fișier; Anulează = importul se oprește fără nicio modificare. Articolele noi primesc întotdeauna valorile din fișier, iar o coloană goală a utilizatorului se completează fără întrebare. Prețul (Price) nu face parte din aceste coloane: este o dată a producătorului și se înlocuiește fără întrebare.

Atribut XML / coloana WinArhi	Tip	Ce reglează
MinuteManopera Minute Manoperă	Număr zecimal	Minutele de manoperă pentru montarea piesei, pe UM; intră în costul manoperei ofertei, pe codul din CodManoperaFer sau CodManoperaUsa (implicit M18).
MinuteNormare Minute normare	Număr zecimal	Timp normat pentru urmărirea producției (WAEagle); nu schimbă prețul.
CodManoperaUsa Cod manoperă ușă	Text, max. 10	Codul de manoperă (Editare Manoperă) folosit în seturile de ușă; gol = M18.
CodManoperaFer Cod manoperă fereastră	Text, max. 10	Codul de manoperă folosit în seturile de fereastră; gol = M18.
DiscountPercent Rabat %	Număr zecimal	Rabatul obținut de utilizator de la furnizor (25 = 25%).
ProcentVama Vamă %	Număr zecimal	Taxa vamală adăugată la cost.
OtherTaxesPercent Alte Taxe %	Număr zecimal	Alte taxe adăugate la cost (transport, comisioane).
ProcentAlteTaxe2 ProcentAlteTaxe3 ProcentAlteTaxe4 Alte Taxe2 % … Alte Taxe4 %	Număr zecimal	Taxe suplimentare adăugate la cost, una după alta.
AdaosFix Adaos fix	Număr zecimal	Sumă fixă adăugată la costul unitar, în valuta articolului, după procente.
ProcentPierdere Procent pierdere	Număr zecimal (întreg în unele baze de date)	Pierderea aplicată când articolul este adăugat de funcția altui articol (BucPerBuc) sau de un script.
RotunjesteLaImpachetare RotunjesteLaImpachetare	Bifă	Consumul pe comandă se rotunjește la ambalaje întregi (Packing).
LivrarePeFer Livrare pe fereastră	Bifă	Piesa se livrează montată pe fereastră (marcaj în consum, folosit de centralizatorul de montaj).
ZoneOf Zone ofertare	Text, max. 20	Zonele de ofertare în care articolul poate fi ales (fiecare caracter este o zonă).
Variabil Variabil	Bifă	Articolul apare în raportul Dimensiuni debitare detaliate.
FisaMontaj Fișă montaj	Bifă	Articolul apare pe fișa de montaj.
MaterialeMontaj Materiale montaj	Bifă	Articolul apare pe lista materialelor de montaj.
CatCentralizMontaj Categorie 0 centralizator montaj	Text, max. 70	Categoria articolului în raportul Centralizator montaj (X = denumirea articolului).
Cat1Centralizator Cat2Centralizator Cat3Centralizator Categorie 1 … 3 centralizator montaj	Text, max. 70	Categoria în celelalte variante de grupare ale aceluiași raport.
GrupaCentraliz0 GrupaCentraliz1 GrupaCentraliz2 GrupaCentraliz3 Grupă centralizator 0 … 3	Text, max. 20	Grupa pentru fiecare categorie a raportului Centralizator montaj.
WAEagle WAEagle	Bifă	Articolul este trimis la posturile de feronerie WAEagle (împreună cu Loc montaj).
ExVizualizare Exclus din Vizualizare	Bifă	Articolul nu mai poate fi ales în listele de selecție (schimbare mâner, balama, broască, butuc, accesorii); rămâne în seturi și în consum.
ExVizualizareFer Exclus la vizualizare la ferestre	Bifă	La fel, numai la ferestre.
ExVizualizareUsa Exclus la vizualizare la uși	Bifă	La fel, numai la uși.
ExVizualizareUsaBalcon Exclus la vizualizare la uși balcon	Bifă	La fel, numai la ușile de balcon.
AfisatPeOferta Afișat pe ofertă	Bifă	Denumirea articolului intră în câmpul ArticoleFeronerie al ofertei, pentru rapoartele care îl folosesc.
CatConsumCaAcc Categorie consum ca accesoriu	Text, max. 30	Categoria de consum a articolului vândut ca accesoriu; împreună cu CodFormarePret face articolul disponibil ca accesoriu.
CodFormarePret Cod formare preț	Text, max. 30	Regula de formare a prețului pentru accesorii (Formare preț accesorii).
UnghiManualCaAcc UnghiManualCaAcc	Bifă	Ca accesoriu, unghiurile de debitare se pot modifica manual.
UnghiDeLaTocCaAcc UnghiDeLaTocCaAcc	Bifă	Ca accesoriu, unghiurile se preiau de la latura tocului.
ExConsum Exclus din consum	Bifă	Articolul însuși nu intră în consum, preț și greutate când vine dintr-un set sau dintr-o funcție; funcțiile lui se execută totuși.
OptiPtConsum Optimizare pentru consum	X, B, M sau gol	La articolele vândute la metru, cu lungime desenată: X = optimizare din bare, B = rotunjire la bară întreagă, M = debitare manuală.
AfisCotaInDeb AfisCotaInDeb (în fereastra articolului: Afișează cotă pe profil în raportul de debitare)	Bifă	Poziția piesei apare ca cotă pe profil în raportul de debitare.
DrawingType4 Tip desen 4	Bifă	Tip de desen liber, folosit numai de rapoartele proprii ale utilizatorului care îl cer.

Valorile FittingType (Tip articol)

FittingType spune ce rol are articolul în logica de feronerie. Nu este o clasificare comercială: fiecare valoare pornește un comportament anume. Se scrie codul englezesc din prima coloană. Numai importul, nu și schema, citește și valoarea românească salvată de WinArhi (în paranteză) și codul scris cu alte majuscule (acesta cu avertisment), ca să poată citi exporturile vechi.

Cod XML	Tip articol în WinArhi (valoarea salvată)	Ce face WinArhi cu articolul
(gol)	–	Articol obișnuit: șurub, capac, foarfecă, balama de fereastră, colțar etc. Intră normal în seturi și în consum, fără rol special.
Handle	Mâner (Maner)	Mânerul. Numai aceste articole sunt propuse la schimbarea mânerului unei ferestre (lista este filtrată după AcceptedSashes și CompatibleHandles); IntExt spune dacă este mânerul de interior sau de exterior.
Espagnolete	Cremon (Cremon)	Mecanismul de închidere de pe cercevea, cu cutia în care intră mânerul. Primul cremon sau prima broască din set (cu cantitate mai mare decât 0) dă cota mânerului (HandleHeight, FixedHandleHeight), dornmass-ul și zona de evitare a bandoului; WinArhi îi calculează prelungirile (MinRabbet, MaxRabbet).
HandleBox	Casetă mâner (CasetaManer)	Caseta (cutia) mânerului: dă dornmass-ul când cremonul sau broasca din set are Dornmass gol sau 0.
RebateReverserEspagnolete	Mecanism ștulp (MecanismStulp)	Mecanismul canatului inactiv al unei ferestre cu două canate fără montant între ele (cu ștulp). Se introduce după cremon; prelungirile i se calculează ca unui cremon; nu stabilește cota mânerului.
Lock-bolt	Broască (Broasca)	Broasca de ușă. Are același rol ca cremonul pentru cota mânerului, dornmass, evitarea bandoului și prelungiri; se desenează cu șild și butuc. Poate fi schimbată din fereastră, iar o broască aleasă manual se păstrează la reintroducerea setului dacă noul set are tot o broască.
DoorHinge	Balama Ușă (BalamaUsa)	Balamaua de ușă: apare în lista balamalelor de ușă, poate fi schimbată din fereastră și se păstrează la reintroducerea setului.
CamLock	Blocator (Blocator)	Piesa de închidere de pe toc, în care intră bumbul sau rola cremonului. Numai aceste articole sunt propuse în lista de blocatori (CamLocks) din editorul de seturi.
KeyCylinder	Butuc (Butuc)	Cilindrul cu cheie. Poate fi schimbat din fereastră și se păstrează la reintroducerea setului dacă noul set are tot un butuc.
HandleRod	Tijă cremon (TijaCremon)	Tija de acționare a cremonului: la dimensiunile de debitare ale unei tije desenate apar pozițiile pinilor și ale cremoanelor de pe aceeași latură.
PinOnRod	Pin pe tijă (PinPeTija)	Bumb de închidere montat pe tija cremonului; poziția lui apare în cotele de debitare ale tijei.

O altă valoare este păstrată, cu avertisment, dar nu pornește niciun comportament standard; o pot citi doar scripturile proprii ale utilizatorului. Nu inventați tipuri noi.

Funcții (Functions, AccessoryFunctions)

Functions conține funcțiile de legătură ale articolului, câte una pe rând. Ele se execută când articolul intră în consumul unei ferestre (dintr-un set sau adus de funcția altui articol) și adaugă alte articole: de exemplu, o balama își aduce șuruburile. În valoarea atributului rândurile se despart cu 
:

Functions="BucPerBuc(SC-4X25, 2)
BucPerArt(CAP-01, 1)"

- BucPerBuc(Cod, NrBuc) adaugă articolul Cod cu cantitatea NrBuc × cantitatea articolului curent (bucăți, sau metri la articolele ml) și aplică pierderea articolului adăugat; BucPerArt(Cod, NrBuc) face la fel, fără pierdere (vezi BucPerBuc, BucPerArt). Cod se caută întâi printre profile, apoi printre articolele de feronerie, după Code (nu după Cod vechi), și trebuie să existe în același fișier sau în baza de date.

- IfCcv / IfNotCcv execută o funcție numai pe anumite cercevele (ifCcv). Funcțiile al căror nume începe cu + (+ifSerie, +ifCCV...) se evaluează la introducerea setului și decid dacă articolul intră în set (Funcții pentru feronerie). Lista completă: Funcții de legătură și Funcții generale.

- Parametrii se despart prin virgulă, iar numerele au punct zecimal (0.5). Un rând care începe cu // este comentariu. O virgulă care trebuie să rămână în interiorul unui parametru (de exemplu un cod care conține virgulă) se scrie ca textul ,, iar în fișierul XML acest text se scrie &#44; (altfel parserul XML îl transformă înapoi în virgulă).

- La un articol !GROUP (Use="!GROUP"), Functions nu conține funcții, ci codurile membrilor grupei, câte unul pe rând. Fiecare membru intră cu cantitatea rândului din set; pentru două bucăți scrieți codul de două ori. Membrii care depind de sensul de deschidere se scriu în GroupInwardOpening și GroupOutwardOpening. Fiecare rând negol al listei este căutat ca un cod (după Code, nu după Cod vechi). Importul semnalează codurile de membri care nu există, dar nu și rândurile care încep cu // sau conțin paranteze: în lista unei grupe, și acestea dau la fiecare calcul mesajul „Articolul de Feronerie cu codul '...' nu există în tabelul de articole feronerie”.

- AccessoryFunctions are aceeași sintaxă și se folosește în locul lui Functions când articolul este adăugat în ofertă ca accesoriu (din lista de accesorii), nu printr-un set. Funcționează numai după ce utilizatorul a făcut articolul disponibil ca accesoriu (CatConsumCaAcc și CodFormarePret) și nu revine la Functions: dacă aceleași piese trebuie aduse în ambele cazuri, scrieți funcțiile în ambele atribute. La un !GROUP vândut ca accesoriu, AccessoryFunctions este lista membrilor.

- Importul nu verifică sintaxa funcțiilor. După import, utilizatorul salvează articolele și rulează Articole > Verifică funcții de legătură și Articole > Verifică articolele din grupe.

Diagrama de greutate (WeightChart)

Diagrama de greutate descrie portanța unei balamale (sau a altei piese portante), ca diagramele din cataloagele de feronerie: pentru fiecare greutate a umpluturii pe metru pătrat, poligonul dimensiunilor de falț ale cercevelei în care piesa poate fi folosită. În fișier, diagrama este elementul WeightChart al lui Record, cu câte un element WeightChartRecord pentru fiecare curbă:

</WeightChart>

Atribut	Tip și format	Semnificație
KgPerMP	Număr întreg ≥ 1, kg/m². Obligatoriu; unic în diagramă.	Greutatea umpluturii pe metru pătrat până la care este valabilă curba: eticheta „≤ 30 kg/m²” din catalog devine KgPerMP="30". O valoare fracționară din catalog se rotunjește în jos.
X0 X1 … X9	Numere întregi ≥ 0, mm.	Lățimea de falț a cercevelei (FFB, de la Flügelfalzbreite din cataloagele germane) în vârfurile poligonului.
Y0 Y1 … Y9	Numere întregi ≥ 0, mm.	Înălțimea de falț a cercevelei (FFH, de la Flügelfalzhöhe) în vârfurile poligonului; Yn împreună cu Xn formează vârful n.

Poligonul unei curbe

- Vârfurile se dau în perechi Xn/Yn, consecutiv de la X0/Y0, fără goluri: cel puțin 3 și cel mult 10 vârfuri (X10 și următoarele nu există). Poligonul se închide singur: nu repetați primul vârf, ar ocupa unul dintre cele 10 locuri.

- Se recomandă ordinea inversă acelor de ceasornic, cu X spre dreapta și Y în sus, cum cere și fereastra Diagramă greutate a articolului; testul WinArhi dă însă același rezultat în ambele sensuri. Contururile concave sunt permise, dar conturul nu se poate intersecta cu el însuși. Un punct aflat exact pe contur este considerat în interior.

- Fiecare curbă descrie întreaga zonă admisă pentru greutatea ei, nu doar banda dintre două curbe hașurată în unele cataloage. Cataloagele dau adesea axele în metri: înmulțiți cu 1000.

- O diagramă descrie o singură clasă de sarcină: pentru balamale de 100 kg și de 130 kg, creați articole separate, fiecare cu diagrama lui.

Cum folosește WinArhi diagrama

Diagrama este verificată numai pentru rândurile de set care au acest articol în Code, MaxWeight mai mare decât 0 și VerifyWeightChart="X" (vezi Greutate: MaxWeight și VerifyWeightChart). La introducerea setului pe o cercevea:

- WinArhi calculează greutatea umpluturii cercevelei, G (kg, din gramajul termopanelor, al geamurilor sau al panourilor; fără profile și fără feronerie), și greutatea ei medie pe metru pătrat, q.

- Un rând cu MaxWeight intră în set numai dacă G ≤ MaxWeight și, când are VerifyWeightChart="X", dacă punctul (FFB, FFH) al cercevelei se află în poligonul curbei cu cel mai mic KgPerMP ≥ q. Dacă umplutura este mai grea pe m² decât cea mai mare valoare KgPerMP, verificarea eșuează: includeți o curbă pentru cea mai grea umplutură admisă de piesă.

- Când rândul nu trece, WinArhi încearcă grupa de greutate următoare a setului (următoarea valoare MaxWeight). Dacă nicio grupă nu trece, piesele portante lipsesc și, de regulă, cerceveaua nu se creează, cu excepția cazului în care utilizatorul a bifat Permite folosirea feroneriei în afara diagramei de greutate (detalii în Greutate: MaxWeight și VerifyWeightChart).

- Un rând marcat VerifyWeightChart="X" al cărui articol nu are diagramă dă mesajul „Diagrama de greutate la articolul de feronerie ... nu este definită!”, iar acel rând nu intră în set. Dacă umplutura nu are greutate, diagramele nu se verifică: apare mesajul „Termopanul nu are greutate. Va fi selectată feroneria pentru cele mai ușoare cercevele!”.

Diagrama la import

- Un element WeightChart înlocuiește în întregime diagrama salvată; ordinea curbelor nu contează, iar o diagramă identică nu schimbă articolul. Atributul WeightChart="", fără element, șterge diagrama. Fără element și fără atribut, diagrama rămâne neschimbată.

- Refuză articolul: un element WeightChart fără curbe, două elemente WeightChart, o curbă cu vârfuri dar fără KgPerMP, două curbe cu același KgPerMP, o pereche Xn/Yn incompletă sau un gol între vârfuri, o valoare cu zecimale sau negativă, o valoare negoală a atributului WeightChart.

- Sunt semnalate: o curbă cu mai puțin de 3 vârfuri distincte și o curbă fără nicio valoare (păstrată, dar nefolosită). Când un Record are și atributul, și elementul, contează elementul.

Exemplu comentat

Fișierul WinArhi-HardwareArticles-example.xml (fără comentariile lui) conține patru articole; codurile, marca și prețurile sunt inventate:

<?xml version="1.0" encoding="UTF-8"?>

</WeightChart>

</Record>

</Base>

- Base: formatul 2, fișier de articole; Generator apare în antetul raportului de import.

- EXA-H-100 este un mâner (FittingType="Handle") montat pe cercevea (MountingLocation="Sash"). Are culoarea Alb, deci un set îl introduce numai la ferestrele cu feroneria albă; Packing="1" = un ambalaj conține o bucată.

- EXA-E-800 este un cremon de 800 mm (FittingType="Espagnolete", Length="800"), fără culoare (piesă neutră). CamLockDimensions1="150
650" definește două sloturi pentru blocatori, la 150 și la 650 mm de originea piesei; setul alege în CamLocks blocatorul pentru fiecare slot.

- EXA-CL-01 este blocatorul (FittingType="CamLock"), montat pe toc (MountingLocation="Frame": manopera lui se atribuie tocului); în fișierul de seturi al exemplului, setul îl pune în sloturile 0 și 1 ale cremonului (DimensionIndex="0" și "1").

- Exemplul nu dă mânerului și cremonului atributele de poziționare și desen (Side, Reference, Dimension, Drawing, DrawingType1..3), nici în articole, nici în rândurile setului: mânerul, cremonul și blocatorii lui intră în consum și în preț, dar nu se poziționează și nu se desenează. Sloturile de la 150 și 650 mm capătă o poziție numai după ce cremonul are Side și Reference (vezi Poziționarea pieselor obișnuite, la Atributele unui articol).

- EXA-HG-01 este balamaua cercevelei (Side="Hinge"), cu o diagramă de greutate de trei curbe: până la 20, 30 și 40 kg/m². Fiecare curbă este un poligon cu 5 vârfuri, iar zona admisă se micșorează când umplutura devine mai grea. Referința și cota balamalei vin din rândurile setului: cea de sus cu Reference="UpLeft", cea de jos cu Reference="DownRight", amândouă cu Dimension="150".

- În fișierul de seturi al exemplului, rândurile balamalei au MaxWeight="130" și VerifyWeightChart="X", deci diagrama se verifică la fiecare introducere a setului. Ambele rânduri sunt marcate; fiind același articol, pe aceeași latură, verificarea dă același rezultat și marcajul dublu nu schimbă nimic. În seturile proprii marcați un singur rând pe grupă de greutate, culoare și canat (vezi Greutate: MaxWeight și VerifyWeightChart).

- Valorile buc, EUR, Feronerie și Alb trebuie să existe în baza de date a utilizatorului (unitățile de măsură, valutele, categoriile de consum și culorile de feronerie); altfel importul le semnalează.

- Fișierul nu conține nicio coloană a utilizatorului, deci setările lui rămân neatinse. Importați întâi acest fișier, apoi fișierul de seturi WinArhi-HardwareSets-example.xml: rândurile seturilor își iau denumirea și culoarea din articole.

Pentru importul propriu-zis, raportul și confirmarea vezi Importul în WinArhi și Articole > Importă din format XML.