O configurație simplă pentru înregistrarea mișcării cartușelor pentru echipamentele laser într-o organizație a fost construită folosind platforma 1C Enterprise 8.3 și interfața Taxi. Se ia in considerare miscarea fiecarui cartus (achizitionare, reumplere, restaurare, reparare, instalare intr-o imprimanta etc.) si cheltuiala fondurilor pentru fiecare cartus. Scopul principal este de a stăpâni dezvoltarea aplicațiilor bazate pe platforma 1C Enterprise 8.3 folosind exemplul de construire a unei aplicații funcționale și utile.
Sunt un programator cu experiență, dar nu am studiat serios 1C până acum. Pentru a combina afaceri (cunoașterea cu 1C Enterprise 8.3) cu afaceri (nimeni nu a anulat munca), să încercăm să construim o configurație de lucru folosind capacitățile noua versiune. Poate că procesul de dezvoltare a configurației va fi util pentru cineva și îi va ajuta pe începători să stăpânească 1C.
Lucrez in departamentul IT organizație mare cu un număr mare de imprimante laser și MFP. Pentru ei, contabilizarea mișcării cartușelor este o sarcină urgentă și o cerință de management.
Enunțarea problemei.
Reumplerea, restaurarea și repararea cartușelor cu toner sunt efectuate de o terță parte. Este necesar să se țină cont de mișcarea fiecărui cartuș, adică de achiziție, reumplere cu toner, restaurare, reparare, instalare într-o anumită imprimantă (MFP), locație curentă, ștergere etc. În plus, este necesar sa se tina cont de costurile pentru fiecare cartus (costuri de achizitie, reumplere cu toner etc. dupa furnizor).
Este clar că sunt necesare niște rapoarte. Desigur, totul ar trebui să fie cât mai simplu și clar posibil pentru utilizatori.
Plan de implementare.
Folosim platforma 1C Enterprise 8.3 ca fiind cea mai modernă în acest moment.
Pentru a stăpâni platforma, vom încerca să folosim cât mai multe obiecte de configurare diferite și, firește, noua interfață Taxi. Vom încerca să dăm obiectelor nume care să fie înțelese și apropiate de scopul lor funcțional. Deocamdată, nu vom atinge aspectele „subtile” ale funcționării 1C, precum optimizarea interacțiunii client-server, distribuția rolurilor etc.
Să presupunem mai întâi că configurația noastră va avea următoarele obiecte:
Directoare:
Nomenclatura cartuşelor
Cartușe
Nomenclatorul Cartușelor Prețuri
Imprimante
Gama de imprimante
Furnizori
Documente:
Cartușe de sosire
Înlocuirea cartuşului
Ştergerea cartuşelor
Transferuri:
Nu chiar
Starea cartuşelor
Motive pentru înlocuirea cartuşelor
Registre de informații:
Înlocuirea cartuşelor
Registre de acumulare:
CartușePlată
Algoritm de lucru.
„Actorul” principal este lista de cartușe disponibile (Directory Cartușe). Inițial, lista este completată cu documentul Cartușe de sosire Nomenclatura cartuşelor. La achiziționarea unui cartus, valoarea detaliilor Statîn document este selectat ca Nou. Pretul de achizitie se stabileste conform directorului Nomenclatorul Cartușelor Prețuri data curentă Număr de serie). Recuzită Locaţie definit ca „C comoară".
Contabilitatea reumplerilor, restaurarea, repararea etc. a cartuşelor existente se realizează şi prin document Cartușe de sosire. Tipul cartuşelor este determinat de cartea de referinţă Nomenclatura cartuşelor. Starea cartuşului se determină din enumerare Starea cartuşelor. Prețul lucrării (alimentare, restaurare) se stabilește conform cărții de referință Nomenclatorul Cartușelor Prețuri. Unicitatea unui cartuş este determinată de numărul său de serie (condiţie Număr de serie).
La postarea unui document Cartușe de sosire la secțiunea tabelară Înlocuirea cartuşelor director Cartușe se adaugă o linie cu detaliile documentului curent și cartușele corespunzătoare (cu numărul de serie din document) în director Cartușe valoarea detaliilor se schimbă StatŞi Locaţie.
În plus, în registrul de acumulare CartușePlată
Contabilizarea înlocuirii cartuşelor într-o anumită imprimantă (carte de referinţă) Imprimante) se realizează prin document Înlocuirea cartuşului. Documentul indică imprimanta curentă. Unicitatea imprimantei este determinată de detalii Număr de serie. Este indicat cartuşul care trebuie instalat şi înlocuit (numerele de serie ale cartuşului).
La postarea unui document Înlocuirea cartuşuluiîn partea tabelară a directorului Imprimante Pentru imprimanta curentă, este adăugată o linie cu detaliile documentului și detaliile sunt modificate Cartuş. În director Cartușe pentru cartușele actuale valoarea detaliilor se modifică StatŞi Locaţie. Pentru cartușul instalat în recuzită Locaţie imprimanta curentă este înregistrată, iar pentru cartuşul scos - „ Depozit".
În plus, în registru Înlocuirea cartuşelor se înregistrează mișcarea pe acest document.
Ştergerea cartuşelor se realizează într-un document separat Ştergerea cartuşelor.
Astfel, la momentul actual în timp în director Cartușe Fiecare cartus are o stare foarte specifica (nou, reumplut, gol etc.) si o locatie specifica ( "Depozit" sau o imprimantă specifică), care, prin rapoarte simple, vă permite să evaluați disponibilitatea cartușelor cu o anumită stare și să trageți o concluzie despre necesitatea achiziționării, reumplerii etc. Și, desigur, luați în considerare costurile.
Implementarea.
Să începem cu configurația reală.
Să creăm o bază de date goală în configurator, să o numim cu mândrie „specialist IT” și să organizăm un subsistem Contabilitatea cartuşelor. Nu voi descrie pas cu pas cum se face acest lucru, deoarece există suficiente cărți despre această problemă.
Mai întâi să adăugăm enumerațiile: Nu chiar, Starea cartuşelorŞi Motive pentru înlocuirea cartuşelor, de care vom avea nevoie mai târziu. Compoziția transferurilor este vizibilă în Fig. 2
Să configuram directoare simple Nomenclatura cartuşelorŞi Nomenclatorul imprimantelor.
Recuzită Tipul cartuşuluiîn director Nomenclatorul imprimantelor atribuiți referința de tip unui director Nomenclatura cartuşelor(Fig.3). Nu uitați că toate obiectele de configurare pe care le-am creat trebuie să fie incluse în subsistem Contabilitatea cartuşelor.
În director Imprimante Mai multe detalii au un tip de link:
Pentru testarea ulterioară a programului, vom completa mai multe rânduri în directoarele pe care le-am deschis în modul Enterprise. Desigur, mai întâi completăm directoare simple, apoi - directoare cu detalii cu link-uri. În viitor, încărcarea datelor complete ale întreprinderii reale este de așteptat să fie efectuată folosind procesarea din tabelele Excel.
Acum este timpul să adăugați documente la configurație. Să configuram obiectul document în arborele de obiecte de configurare Cartușe de sosire cu detalii si parte tabulara Nomenclatorul documentului. Nu avem încă registre de acumulare în configurație - marcaj Circulaţie rămâne gol pentru document. Deoarece va trebui să scriem propria noastră procesare a documentului, iar codul programului este scris în modulul formular document, vom crea chiar acest formular (Fig. 9). Facem totul în mod implicit, așa cum este scris în cărți (Form - Add - Document Form).
Vom folosi acest document atunci când primim în depozit atât cartușe noi, cât și reumplute (remanufacturate, reparate).
În final, pentru a înregistra primirea cartuşelor, creăm un registru de acumulare CartușePlată cu măsurători, resurse și detalii (Fig. 10) .
Marcat grefierii indicați documentul nostru Cartușe de sosire. Salvați configurația.
Revenirea de-a lungul arborelui de obiecte la document Cartușe de sosire. Pe marcaj Circulaţie selectați înregistrarea CartușePlată, lansați Motion Designer și completați câmpul Expresie cu valorile detaliilor documentului (Fig. 11).
Faceți clic pe OK și veți fi direcționat la Modul obiect codul programului (Fig. 12).
Acum, cel mai interesant lucru este că trebuie să adăugați cod de program la modulul obiect pentru a oferi următoarea funcționalitate atunci când postați un document Cartușe de sosire.
Când un cartuş nou ajunge (cumpărare) în director Cartușe trebuie adăugată o linie cu numărul unic al cartuşului şi detaliile corespunzătoare (din document). În acest caz, recuzita Starea cartusului va insemna " Nou", și recuzita Locaţie- adică " Depozit" Parte tabelară a directorului Cartușe nu este completat.
Conform algoritmului programului, trebuie să introduceți inițial fiecare cartuş cu numărul său unic în director Cartușe document Sosirea cartuşelor.
Cand soseste un cartus reumplut cu toner (remanufacturat, reparat etc.), se considera ca un cartus cu acelasi numar este deja in director Cartușe, iar în acest caz, la postarea documentului Sosirea cartușelor, se adaugă un rând la secțiunea tabelului Benzinării iar valorile detaliilor se schimbă LocaţieŞi Stat pentru cartuşul actual. Codul adăugat la modulul obiect este prezentat în Fig. 13.
Acum puteți efectua primul test al performanței programului. În Enterprise creăm un document Cartușe de sosire(Fig.14). Apăsați butonul Glisați și închideți. Accesați directorul Cartușe si vedem ca in el apare o linie cu detaliile cartusului achizitionat cu o parte tabulara goala (Fig. 15).
Să deschidem registrul CartușePlată(articol de meniu Registrul de plată a cartuşului) și vom vedea o linie similară acolo.
Creăm și postăm al doilea document Cartușe de sosire cu același cartuș, dar reumplut (Fig. 16).
Accesați directorul Cartușeși vedem că cartușul pe care l-am instalat are o linie adăugată în secțiunea tabelară Benzinării iar recuzita s-a schimbat Stat(Fig. 17).
Ura! Programul funcționează!
Desigur, funcționalitatea documentului Cartușe de sosire trebuie îmbunătățit, de exemplu, aș dori ca cel mai recent preț al serviciului să fie introdus automat în câmp Preţ document din director Nomenclatorul Cartușelor Prețuri la alegerea unui furnizor şi pentru un anumit tip de cartuş.
Acest lucru se va întâmpla mai târziu, dar acum să începem să înlocuim cartușele - creați un document Înlocuirea cartuşuluiși registrul de informații corespunzător Înlocuirea cartuşelor.
Detalii și partea tabelară a documentului Nomenclatorul documentului sunt prezentate în Fig. 18. Nu avem încă registre de acumulare adecvate și informații în configurație, marcaj Circulaţie Nu vom marca nimic pentru document. Deoarece va trebui să scriem propria procesare a documentelor, creăm un DocumentForm implicit.
Pentru a ține cont de înlocuirea cartușelor, pentru o modificare creăm un registru de informații (nu un registru de acumulare) Înlocuirea cartuşelor cu măsurători și detalii (Fig. 19) . S-a dovedit până acum fără resurse cumva .
Marcat grefierii indicați documentul nostru Înlocuirea cartuşului.
Salvați configurația. Revenirea de-a lungul arborelui de obiecte la document Înlocuirea cartuşului. Pe marcaj Circulaţie selectați înregistrarea Înlocuirea cartuşelor, lansați Motion Designer și completați câmpul Expresie cu valorile detaliilor documentului. Faceți clic pe OK și veți fi direcționat la Modul obiect document, unde vedem deja creat Înregistrați constructorul de mișcare codul programului (Fig. 20).
Acum adăugăm la Modul obiect cod de program pentru a oferi următoarele funcționalități atunci când procesați un document Înlocuirea cartuşului. În director Imprimante pentru o imprimantă al cărei cartuş este înlocuit, trebuie adăugată o linie în secţiunea tabelară Înlocuirea cartuşelor cu valorile detaliilor din document și valoarea atributului se va schimba Număr cartuş Acum.În director Cartușe pentru cartușele scoase și instalate, valorile detaliilor se vor modifica LocaţieŞi Stat. Procedura de procesare a documentelor îmbunătățită Înlocuirea cartuşului prezentat mai jos.
Procedura de procesare (Eșec, Mod)
// directoare utilizate
Imprimante = Directoare.Imprimante;
Cartuşe = Directories.Cartridges;
// sfârşitul inserării cărţi de referinţă folosite
// înregistrați CartridgesReplacement
Movements.CartridgesReplacement.Write = True ;
Pentru fiecare TechLineNomenclatureDocument din NomenclatureDocument Cycle
Mișcare = Movements.CartridgesReplacement.Add();
Movement.Cartridge Nomenclature = Cartridge Nomenclature;
Movement.RemovedCartridgeNumber = TechStringDocumentNomenclature.RemovedCartridgeNumber;
Movement.InstalledCartridgeNumber=
Motion.PrinterModel = PrinterModel;
Movement.PrinterSerialNumber = TechStringDocumentNomenclature.PrinterSerialNumber;
Motion.PrinterInventoryNumber =
Movement.CartridgeType = TechStringDocumentNomenclature.CartridgeType;
Movement.ReplacementWhoDid = ReplacementWhoDid;
Movement.ReasonReplacement = TechStringDocumentNomenclature.ReasonReplacement;
// schimba directorul Imprimante
NameString = TextStringDocumentNomenclature.PrinterSerialNumber;
Apoi CurrentObject =
Printers.FindByAttributes("SerialNumber",NameString).GetObject();
CurrentObject.CartridgeNumberNow =
TechStringDocumentNomenclature.InstalledCartridgeNumber;
NewRow = CurrentObject.ReplaceCartridges.Add();
NewRow.ReplacementDate = Data;
NewString.CartridgeType = TechStringDocumentNomenclature.CartridgeType;
NewLine.InstalledCartridgeNumber =
TechStringDocumentNomenclature.InstalledCartridgeNumber;
NewLine.RemovedCartridgeNumber =
TechStringDocument Nomenclature.RemovedCartridgeNumber;
NewLine.WhoReplaced = ReplacementWhoDid;
NewString.ReasonReplacement = TechStringDocumentNomenclature.ReasonReplacement;
CurrentObject.Write();
endIf;
// schimbați directorul Cartușe - cartușul instalat
NameString = DocumentStringNomenclature.InstalledCartridgeNumber;
apoi CurrentObject =
String = " ";
String = String + PrinterModel + " " +
TechStringDocument Nomenclature.PrinterSerialNumber + " " +
TechStringDocumentNomenclature.PrinterInventoryNumber;
CurrentObject.Location = String;
CurrentObject.Write();
endIf;
// a scos cartuşul
NameString = TextStringDocumentNomenclature.RemovedCartridgeNumber;
Apoi CurrentObject =
Cartridges.FindByAttributes(„Număr”,NameString).GetObject();
CurrentObject.Location = "Depozit";
CurrentObject.State = Enums.CartridgeState.Empty;
CurrentObject.Write();
endIf;
// sfârșitul schimbării directoarelor
EndCycle;
EndProcedure;
Pentru verificare, completați și trimiteți documentul Înlocuirea cartuşului(Fig.21) . Accesați directorul Imprimanteși vedem că imprimanta selectată are un rând adăugat la secțiunea tabelară Benzinării cu detalii ale documentului procesat și detalii Număr cartuş Acum a acceptat valoarea numărului cartuşului instalat (Fig. 22).
În director Cartușe la cartusul instalat in imprimanta, in recuzita Locaţie au fost înregistrate datele imprimantei curente (Fig. 23). Și pe lângă registrul de informații Înlocuirea cartuşelor a fost înregistrată mișcarea pe document (Fig. 24)
Astfel, momentan avem o configurație pentru înregistrarea mișcării cartuşelor pentru tehnologia laser, care, în principiu, poate fi deja folosită în muncă.
Din punctul de vedere al „ideologiei” lui 1C, este probabil greșit să schimbați detaliile directoarelor prin postarea de documente, să folosiți un director pentru a stoca prețurile curente - aici este experiența anterioară de lucru cu tabele autorului de articolul intră în joc și de ce un director nu este un tabel?
Desigur, funcționalitatea trebuie îmbunătățită, rapoarte adăugate, erori remediate și depanate. Mai multe despre asta în următoarea parte a articolului.
Versiunea completă a articolului este dată în fișierul Part1.doc
Cartea electronică este distribuită ca o arhivă care conține:
- un fișier exe executabil care include atât cartea în sine, cât și programul SunRav BookReader conceput pentru a vizualiza această carte
- catalog cu materiale suplimentare pentru carte.
- Cartea este destinată să fie citită sub sistemul de operare Windows
Cartea 1C: Enterprise 8.1. Exemple simple de dezvoltare este un ghid de referință care ilustrează exemple simple de dezvoltare a algoritmilor pe platforma 1C:Enterprise 8.1.
Publicația va fi utilă dezvoltatorilor începători, administratorilor care implementează un sistem în întreprinderea lor și utilizatorilor avansați care doresc să dezvolte independent soluții de aplicații.
Carte 1C: Întreprindere 8.1. Exemple simple de dezvoltare conţine număr mare exemple practice, grupate pe subiecte de utilizare.
Pentru a ajuta dezvoltatorii de soluții de aplicații, cartea conține coduri pentru exemplele descrise. Exemplul de cod este prezentat sub forma unui fișier șablon text 1C:Enterprise 8. Acest fișier poate fi conectat la orice configurație și puteți trage exemplele cu mouse-ul sau le puteți lipi în modul folosind autocorrecția.
După confirmarea plății pentru carte veți primi:
* Se recomandă să citiți fișierele .epub pe computer folosind cititorul Adobe Digital Editions. Când citiți folosind alte programe, nu este recomandat să utilizați un mod de vizualizare care afișează două pagini în același timp - din cauza numărului mare de imagini, poate apărea afișare incorectă.
De ce sunt mai bune produsele descărcabile?
Nu este nevoie să plătiți livrarea, primiți revista în câteva clicuri în orice moment al zilei;
Viteza de descărcare depinde numai de capacitățile conexiunii dvs. sunt acceptate;
Dacă aveți probleme la primirea achiziției, puteți contacta consultanții noștri online;
A.P. Gabets, D.I. Goncharov 1C:Enterprise 8.0 Exemple simple de dezvoltare Moscova 1C-Publishing LLC 2005 UDC 658.012.011.56:004.42 BBK 65.29 G12 Andrey Petrovich Gabets, Dmitri Igorevich Goncharov G12 1C.:004.42 Exemple simple M.: 1C-Publishing LLC, 2005. - 420 p.: ill. dezvoltare, ISBN 5-9677-0056-0 Cartea este un ghid de referință care ilustrează exemple simple de dezvoltare a algoritmilor pe platforma 1C:Enterprise 8.0. Publicația va fi utilă dezvoltatorilor începători, administratorilor care implementează un sistem în întreprinderea lor și utilizatorilor avansați care doresc să dezvolte independent soluții de aplicații. Cartea conține un număr mare de exemple practice, grupate pe subiecte de utilizare. În plus, cartea conține un index detaliat al proprietăților, metodelor și evenimentelor limbajului încorporat folosit în exemple. Această carte completează, dar nu înlocuiește, documentația standard pentru produsul software inclus în pachetul de livrare și vă permite să utilizați mai eficient capacitățile programului. Editat de M.G. Radcenko. 4601546 025616 ISBN 5-9677-0056-0 Dreptul de a reproduce și de a distribui cartea aparține 1C-Publishing. Copierea integrală sau parțială a materialelor cărții fără permisiunea scrisă a 1C-Publishing este interzisă. LLC „1C-Pa6lishingm, 2005 CUPRINS Introducere 16 Cum se lucrează cu publicația? Tipuri primitive, funcții de sistem 17 18 (D Cum se specifică în mod explicit data dorită? Cum se verifică o dată pentru o valoare goală? Cum se compară două date ( zile)? Cum se adaugă o zi la o dată, o lună Cum pot verifica tipul unei variabile cu cea dorită Tip „Valoare de stocare” Cum se comprimă datele plasate în magazinul de valori Cum să ofere utilizatorului posibilitatea de a selecta o valoare de tip complex? Afișează un avertisment cu mai multe rânduri când se efectuează procesarea Cum se afișează un număr în limba rusă, dar fără o parte fracțională? cuvinte, indicând partea fracțională în grame? Cum să afișați o sumă de dolari în cuvinte în engleză? Cum se încarcă o componentă externă? Cum se execută o comandă de sistem de operare? Cum se implementează codul de procedură în funcție de modul de execuție (pe client, pe server, într-o conexiune externă)? Cum se implementează strategia „totul sau nimic” atunci când procesăm obiecte în grupuri? Cum se calculează suma folosind formula dobânzii compuse? Universal Collections Array (D În ce situații sunt utilizate de obicei matrice? ® Cum se creează o matrice? Cum se creează o matrice multidimensională? Cum se adaugă elemente la o matrice? 18 18 19 19 20 21 21 21 22 23 24 24 25 25 26 27 27 27 28 29 30 31 32 32 32 33 34 Cuprins Cum se determină dimensiunea unui element de matrice Cum se șterge un element de matrice? că două matrice sunt identice. Datele care conțin numele contrapartidelor sunt încărcate în matrice matricele din „Nomenclatură” și „Container” ale facturii Există două tabele de valori. atribut? Cum pot obține din registrul de informații „Plătitori de salarii ale organizației” sub forma unei serii de toți plătitorii de salarii dintr-o anumită divizie a organizației? Structura F În ce situații sunt utilizate în mod obișnuit obiectele de tip „Structură”? f Cum se creează o structură? f Cum se adaugă elemente la o structură? F Cum se accesează un element de structură? f Cum se repetă asupra elementelor unei structuri? f Cum se șterge un element de structură? Cum să setați o valoare pentru un element cu o cheie specifică într-o structură? Cum să introduceți date multidimensionale într-o structură? Cum se colectează informații despre selecțiile stabilite în formularul jurnalului? Cum să determinați dacă există un element în structură cu cheia „Cont”, iar dacă există, dar conține o valoare de director goală sau Nedefinit, ștergeți acest element? Cum să obțineți din partea tabulară „Bunuri” a unui document toate rândurile în care valoarea atributului „Preț” este egală cu zero, iar valoarea atributului „Cota TVA” este egală cu valoarea „TVA 18” a transferului „Cota TVA”? Cum se obțin date despre politica contabilă actuală a unei organizații dintr-un registru periodic de informații pentru o dată dată? Cum se formează o structură pentru numele detaliilor din partea tabelară a unui document arbitrar? Cum se obține date din partea tabelară a unui document folosind o interogare, având o structură pentru numele detaliilor părții tabulare? Conformitate 34 34 35 36 37 37 38 39 40 41 42 43 44 45 47 47 47 48 48 49 50 50 51 52 53 53 55 55 57 Conţinuturi În ce situaţii sunt tipice obiectele de conformitate? f Cum se creează o potrivire? f Cum se adaugă elemente la o potrivire? f Cum se accesează elementul de potrivire? F Cum se repetă prin elementele de potrivire? f Cum să eliminați un element potrivit? Cum să obțineți date dintr-un meci? Cum să obțineți corespondență pe mai multe niveluri între tipuri de calcule care au tipuri de calcule de bază? 57 57 57 58 58 59 59 60 Listă de valori, tabel de valori, arbore de valori 63 f În ce situații sunt utilizate de obicei listele de valori, tabele de valori, arborele de valori? f Cum se creează o listă de valori? f Cum se adaugă elemente la o listă de valori? f Cum să găsiți un element dintr-o listă de valori? f Cum se accesează un element dintr-o listă de valori? f Cum se repetă peste elementele unei liste de valori? f Cum se elimină un element dintr-o listă de valori? f Cum să creați un tabel de valori și să completați câmpurile acestuia? f Cum să găsiți o valoare într-un tabel de valori? ® Cum se repetă printre rândurile unui tabel de valori? f Cum se șterge rândurile (coloanele) unui tabel de valori? Cum se completează un tabel de valori dacă numele coloanelor sunt conținute în variabile? Cum să umpleți întreaga coloană a tabelului de valori cu valoarea dorită? Cum pot completa tabelul de valori „RecipientTable” cu date din tabelul de valori „SourceTable”? Cum să adăugați coloane la tabelul de valori „ValueTable” cu restricții de tip? Cum se schimbă tipul de valoare al unei coloane de tabel de valori obținute prin descărcarea dintr-o interogare? Cum să umpleți singur arborele valorii? Obiecte aplicație Directoare F Cum se creează un element de director (grup)? f Cum să găsiți un element de director? f Cum se șterge un element de director? f Cum se itera prin elementele unui director? f Cum se selectează toate elementele dintr-un anumit grup? F Cum să parcurg elementele unui director subordonat folosind o interogare? F Cum să parcurgeți elementele unui director subordonat folosind o selecție de director? f Cum se deschide forma de listă (articol) a unui director? 63 64 64 65 65 66 66 67 68 69 69 71 71 72 74 75 76 78 78 78 80 81 82 83 85 86 86 Cuprins f Cum se adaugă o intrare la partea tabulară a unui director? f Cum se șterge rânduri din partea tabelară a directorului? F Cum să parcurg rândurile părții tabulare a directorului? F Cum se creează un element în grupul dorit? Cum să afli dacă elementul curent are subordonate? Cum pot afla numărul de elemente subordonate ale unui element de director selectat? Cum să aflați numărul de elemente subordonate ale unui element de director selectat dacă numărul de directoare subordonate este mai mult de unul? Cum să obțineți toți părinții unui element de director selectat? Cum pot obține codul „complet” al elementelor de director folosind o interogare dacă tipul de cod este String? Cum să obțineți toate elementele de director care conțin un anumit subșir în numele lor, cu întreaga ierarhie căreia îi aparțin? Cum să găsiți toate elementele de director în care atributul șir nu este completat? Cum se transferă toate elementele directorului „Contrapărți” de la un grup la altul? Cum se selectează programatic un element de director? Cum să salvezi fotografia unui angajat în directorul „Angajați”? Documente ® Cum se creează un document nou? f Cum să găsiți un document? F Cum se deschide un formular de document? f Cum se schimbă valoarea atributului și cum se scrie un document? F Cum se adaugă o linie la partea tabulară a unui document, având un link către document? f Cum se șterge rânduri din partea tabelară a unui document? f Cum se repetă printre rândurile unui document? f Cum se descarcă partea tabelară a unui document? f Cum se calculează totalul în partea tabelară a documentului? f Cum se publică un document? f Cum se sortează documentele? f Cum se marchează toate facturile pentru ștergere? f Cum, având un link către un document, creați o copie a acestuia în baza de date? f Cum, având un link către un document, citiți mișcările acestuia prin registru? Cum se determină în ce registre documentul a efectuat mișcări? Cum să ștergeți rândurile cu o valoare zero pentru atributul „Cantitate” din partea tabelară a unui document? Cum se șterge coloana „Cota TVA” din câmpul tabelului „Marfuri” a unui document deja completat? Cum să completați valorile proprietăților unui document nou bazat pe unul existent? Cuprins pentru a obține o listă de facturi în care articolele nu sunt completate? Cum se determină cursul valutar al contabilității de gestiune la data facturii? Moneda contabilității de gestiune este stocată într-un registru periodic de informații. Cum să obțineți solduri relevante pentru o poziție de document în procesarea înregistrării? Cum se determină numărul de documente și numărul de valori diferite ale atributelor din tabelul de înregistrări ale documentelor? Dimensiunea „Organizare” a fost adăugată la secvența „Contabilitatea părților”. Cum putem obține acum date de graniță a secvenței pentru fiecare valoare a acestei dimensiuni? Stocarea informațiilor ® Cum se adaugă o intrare într-un registru de informații independent neperiodic? f Cum se citește conținutul unui registru independent de informații neperiodice? „Propriile contrapărți”? F Cum se șterg toate înregistrările din registrul independent de informații? f Cum se șterg înregistrările dintr-un registru independent de informații cu selecție pentru o anumită organizație? f Cum se adaugă o intrare într-un registru periodic independent de informații? f Cum se citesc (schimba) intrările în registrul periodic de informații independente? f Cum se șterg înregistrările din registrul periodic de informații independente? Cum pot șterge toate înregistrările pentru monedele cu denumirea „EUR” și „USD”, a căror perioadă este mai mică de 1 ianuarie 2005, în registrul periodic independent de informații „Rate valutare”? Cum se citesc datele actuale la o anumită dată din registrul de informații „Rate valutare” cu selecție după mai multe valute (selectare după dimensiuni)? Cum se modifică perioada de înscrieri într-un registru periodic independent care îndeplinește o serie de condiții? Cum să „facem periodic” detaliile unui director deja completat? f Cum se adaugă înregistrări în registrul de informații subordonat registratorului? f Cum se citesc (modifică) înregistrările din registrul de informații din subordinea registratorului? f Cum se șterg înregistrările din registrul de informații subordonat registratorului? Contabilitate F Cum se creează înregistrări în registrul contabil? f Cum se obține soldul contului? f Cum să obțineți cifra de afaceri într-un cont? f Cum să obțineți soldurile contului? 118 119 120 121 122 123 124 124 125 126 126 127 128 128 129 131 132 134 137 138 139 140 140 125 126 126 127 128 128 129 131 132 134 137 138 139 140 140 140 140 140 140 3 140 140 140 140 140 140 140 140 Cum să găsiți primul document care a dus la apariția unui sold creditor în cont? Cum se selectează toate conturile ale căror analize conțin fie tipul de subcont „Contraparte”, fie tipul de subcont „Contract”? Cum se selectează toate conturile ale căror analize conțin atât tipul de subcont „Contraparte”, cât și tipul de subcont „Articol”? Cum se adaugă aspect nou subconto la cont? Cum pot obține cifră de afaceri numai pentru conturile în valută din registrul contabil „Contabilitatea costurilor”? Cum se selectează cifra de afaceri pentru conturile „60” din registrul contabil „Contabilitatea costurilor”, excluzând cifra de afaceri internă dintre acestea? Cum se implementează metoda „reversării roșii” pentru registrul contabil? Calcule periodice complexe (D Cum să obțineți suma acumulată pentru un anumit tip de calcul pentru un anumit angajat într-o perioadă specificată? (D Cum să obțineți suma tuturor angajărilor pentru un angajat specificat într-o anumită perioadă? Cum să obțineți un tabel de recalculare pentru recalcularea mai multor registre Cum se determină numerele de rând pentru înregistrările din documentul „Acumularea salariilor pentru angajați” pentru tipurile de calcul complet înlocuite. Cum se organizează anularea calculelor deja efectuate? perioade? Procese de afaceri Cum se definește un proces de afaceri în care numărul de etape succesive este determinat în mod individual la începutul unei instanțe de proces obiecte f Cum, fără a deschide formularul? prelucrare externă , își execută procedura pentru un anumit obiect? (D Cum să obțineți rapid informații despre toate obiectele care sunt de competența unui anumit manager (elementul directorului „Utilizatori”) pentru vânzări? Formulare și controale Lucrul cu formulare (D Cum se deschide un formular de document? F Cum se deschide un formular formular de procesare externă? (D Cum se deschide formularul de raport, astfel încât să nu se suprapună cu formularul din care a fost deschis? 173 Cuprins ® Cum se deschide formularul de raport pe întreg ecranul? Cum se deschide formularul de listă al acestui document din formularul de document, poziționarea pe acesta ® Documentul conține atributul „Contraparte” Cum se deschid formularul „Acorduri de contraparte” Cum pot selecta imaginea salvată în formular? doar documentele „Recepție pentru muncă” din jurnalul de documente „Contabilitatea resurselor umane”? Cum să vă asigurați că, pentru a selecta valoarea clientului în factură, directorul contrapărților se deschide imediat cu grupul „Cumpărători” deschis? Câmp de tabel f Cum să împiedici utilizatorul să schimbe ordinea coloanelor dintr-un câmp de tabel? F Cum să împiedici utilizatorul să modifice orice setări pentru coloanele unui câmp de tabel? f Cum se afișează informații despre selecția setată în jurnalul de documente? f Cum se plasează cursorul pe un element cu un nume cunoscut în formularul de director? f Cum se face o selecție după valoarea atributului în formularul de listă? Cum pot preveni mesajul: „Datele introduse nu sunt afișate în listă deoarece nu se potrivesc cu selecția” atunci când adaug elemente noi în director? f Cum se umple o celulă de câmp de tabel cu date? Cum se schimbă culoarea de fundal a unei celule de câmp de tabel în funcție de valoarea afișată în ea? Cum pot adăuga o nouă coloană „Acord principal” în câmpul tabelului „Contrapărți selectate”, să completez valorile acesteia și să fac posibilă deschiderea acestor valori? Cum să setați o listă de selecție pentru coloana „Tip de document” a unui câmp de tabel? Cum se oferă posibilitatea de a selecta și sorta datele după detalii care nu sunt afișate în câmpul tabelului din formularul de listă de directoare? Cum se implementează drag and drop între comenzi? Cum să afișați soldurile depozitului în lista de articole? Alte controale ® Formularul are un panou cu pagini. Cum să plasezi o imagine pe un marcaj? F Cum să vă asigurați că, atunci când deschideți o formă a unui element de director deja înregistrat „Contrapărți”, fila „Conturi și acorduri” din panoul „Panou” este activă? Cum se organizează selecția din mai multe liste de documente de deschis? Cum poți organiza înlocuirea unei adrese către o persoană? 173 174 175 176 176 177 177 178 181 181 181 182 182 183 184 185 186 187 189 190 190 193 194 194 194 194 191 panou? Cum se atribuie „taste rapide” unui buton creat? Cum se implementează completarea valorilor posibile ale câmpului de selecție „ProcessedTabularPart” la completarea câmpului de intrare „ProcessedDocument”? f Dacă utilizatorul a specificat mai multe date în câmpul calendarului, cum să le parcurgă? f Cum se organizează munca cu indicatorul? Cum se schimbă sursa de date a unui control? Cum pot seta reprezentarea implicită a datei să fie afișată într-un câmp de introducere? F Cum se afișează text în câmpul de imagine dacă imaginea nu este selectată? F Cum se deschide un dialog standard de selecție a culorii pentru utilizator? Cum se completează o listă într-un formular cu datele de solicitare? f Cum se afișează un fișier diagramă grafic într-un formular? Interfețe, stiluri f Cum se setează diverse stiluri 1C: Întreprinderi pentru diferite categorii de utilizatori? Există o listă de nume de interfețe cu semne. Cum să faci vizibile interfețele etichetate? Cum se dezactivează handlerul global de așteptare din formularul de procesare? Interogări, rapoarte Interogări Cum se obțin date din partea tabelară a documentelor? Cum să obțineți date din partea tabelară a documentelor și să le prezentați într-o formă ierarhică? Cum se numără numărul de elemente identice din datele selectate? Cum se aplică condiții de filtrare pe baza valorilor câmpului calculate ca rezultat al unei funcții agregate? Cum se limitează o selecție dintr-un tabel virtual? Cum să însumăm datele pe baza acelorași valori ale unuia dintre câmpurile de selecție? Cum să obțineți numai acele înregistrări în care valoarea unui anumit câmp este mai mare decât o valoare specificată? Cum se accesează subcâmpurile dintr-o interogare? Cum să combinați rezultatele mai multor interogări? Cum se selectează datele din două tabele care îndeplinesc o anumită condiție? Cum se completează datele unui tabel cu date selectate dintr-un alt tabel conform unei anumite condiții? Cum să combinați datele din două tabele pe baza unei anumite condiții? Cum să scoți o valoare în loc de NULL într-o interogare? 10 198 200 201 202 203 205 206 209 211 212 212 213 213 214 215 216 216 216 217 218 219 220 221 22 2 2 2 2 2 2 2 2 2 2 2 Cuprins Cum să obțineți totaluri din același tabel împreună cu datele dintr-un tabel? Cum să obțineți totaluri ierarhice pentru un grup de directoare? Cum, de la o dată dată, folosind registrul „Rămas în depozit”, pot găsi ultimul document „Recepție bunuri și servicii”, conform căruia a fost primit articolul? Cum se numără numărul de înregistrări cu aceeași valoare a unui anumit câmp? Cum pot afișa numărul de înregistrări diferite în înregistrările rezumate? Cum să aflați numărul de înregistrări ca rezultat al unei interogări? Cum se verifică suficiența soldurilor de mărfuri în depozitele specificate în document? Cum se filtrează după valoarea de enumerare într-o interogare? Cum să obții cursuri de schimb pentru două date de dobândă? Cum pot obține un tabel cu discrepanțe între ratele de decontare reciprocă a tuturor documentelor „Comanda cumpărătorului” emise și rata oficială într-o singură interogare? Cum se scrie o interogare în așa fel încât la un anumit nivel al ierarhiei interogărilor să se calculeze unele funcții finale, iar la un alt nivel altele? Cum se obține o listă de documente care au adus datele registrului periodic subordonat de informații într-o anumită stare? Cum să setați parametrii de solicitare dacă textul solicitării nu este cunoscut în prealabil? Analiza datelor f Cum să obțineți date despre produsele vândute împreună? (D Cum să recomandăm produse similare? (D Cum să vedeți ce va fi achiziționat în viitor? Prezentarea rezultatelor raportului Document tabelar, document text Cum să afișați rezultatul unei interogări într-un document tabelar? Cum să afișați datele într-un tabel document cu capacitatea de a restrânge și de a extinde datele prin grupare încărcați rezultatul unei interogări care arată ierarhia? (D Unde și cum pot vedea aspectul generat automat de generatorul de rapoarte? F Cum se transferă datele din generatorul de rapoarte în tabelul rezumat? Raportul este generat de generatorul de rapoarte. Cum pot elimina una dintre coloane plasând datele acesteia în transcrierea altei coloane 7 260 260 261 261 262 263 264 11 Cuprins Cum pot salva setările generatorului de rapoarte până la următoarea deschidere a formularului de raport? Cum se organizează afișarea notelor în documentul tabel generat? Cum să vă asigurați că, atunci când imprimați, prima coloană și primul rând din foaia de calcul „DocumentResult” nu sunt tipărite? F Cum să vă asigurați că partea superioară a unui document de foaie de calcul generată de generatorul de rapoarte este fixată la porțiunea antetului tabelului? f Documentul tabelar este generat de generatorul de rapoarte. Cum mă pot asigura că antetul tabelului apare pe fiecare pagină la imprimarea unui document de foaie de calcul? Cum pot indica numărul documentului, data și numărul paginii în subsolurile paginii atunci când imprimez un document „lung”? ® Un document foaie de calcul este generat folosind un aspect generat automat de generatorul de rapoarte. Cum setez orientarea paginii la imprimare? Documentul tabelar este generat de generatorul de rapoarte. Cum pot seta ieșirea fără o parte fracțională pentru toți indicatorii numerici afișați? Cum poate un generator de rapoarte să combine scopul aspectului său și utilizarea uneia dintre machetele standard de design? Cum să ocoliți numai înregistrările rezumative atunci când preluați date dintr-o interogare? Cum să ocoliți numai înregistrările rezumative ierarhice atunci când preluați date dintr-o interogare? f Cum să afișați o imagine într-un document de foaie de calcul? Cum să afișați o imagine într-un document de foaie de calcul fără a schimba aspectul? Cum se lucrează cu un tabel pivot? Cum să plasați în mod programatic datele într-un tabel pivot și să le formatați? Cum se creează formă tipărită printr-un șablon text? Diagrame Cum se completează o diagramă cu date? Cum se completează o diagramă de măsurare cu date? f Cum se afișează rezultatul unei interogări într-o diagramă pivot? f Cum se completează o diagramă Gantt cu date? Cum să legați intervalele diagramei Gantt? Cum să gestionați modificările interactive ale intervalelor diagramelor Gantt? Cum să plasați semne non-periodice într-o diagramă Gantt? Cum să evidențiezi unele intervale din fundalul diagramei Gantt? Schema geografică Cum se afișează un fișier cu schemă geografică într-un formular? Cum pot afișa un aspect geografic pe un formular? f Cum pot schimba scara unei diagrame geografice? Conținut orașul selectat pe o hartă geografică? Cum să utilizați un tabel de valori ca sursă de date pentru schema geografică? Administrare Lansarea 1C:Enterprise din linia de comandă © Cum se lansează 1C:Enterprise din linia de comandă? Cum pot forța 1C:Enterprise să încarce o bază de date din linia de comandă? Cum pot actualiza modificările configurației curente ale configurației bazei de date din linia de comandă? Cum se testează și corectează o bază de informații fără a verifica automat integritatea referențială? Cum se efectuează automat o verificare a configurației și se scot rezultatele verificării într-un fișier? Cum să scurtați jurnalul în mod programatic? Cum să descărcați modulele unei soluții de aplicație ca fișiere text din linia de comandă? Cum pot încărca fișierele de ajutor salvate în format htm într-o soluție de aplicație? Diverse f Cum se modifică valoarea datei de lucru? F Cum se instalează/elimină modul exclusiv? f Cum se face o înregistrare în jurnalul de bord? f Cum se obțin date despre utilizatorii înregistrați ai bazei de informații? f Cum se determină informațiile generale ale sistemului? Cum se adaugă programatic un utilizator la o bază de informații? Cum să vă creați propriul fișier jurnal pentru a înregistra rezultatele prelucrării externe? Cum să afișați o listă de utilizatori care lucrează cu această bază de informații într-un formular? Cum se descarcă jurnalul de bord în format XML? Cum să închizi forțat toți utilizatorii unei baze de informații într-un mod client-server? Integrare 302 303 305 305 305 306 306 307 307 309 309 310 311 311 311 312 313 314 315 317 318 318 317 318 318 320 318 318 320 318 318 320 318 320 318 320 f Cum se încarcă date dintr-un fișier text? Lucrul cu textul. Model de acces secvenţial Cum se transferă un document dintr-o bază de date în altă bază de date? 321 322 322 324 13 Cuprins Cum poți genera un document XML cu structură arbitrară? Cum se formează un document XML într-un șir? Cum puteți face schimb de date folosind serializarea XML prin alte formate de fișiere? Cum pot încărca un document XML de orice structură? 326 327 328 329 Fișiere DBF 331 Lucrul cu documente HTML 332 f Cum puteți construi încărcare și descărcare folosind fișiere DBF? F Completarea formularelor HTML Lucrul cu fișiere F Cum se organizează un dialog pentru selectarea unui fișier text? F Cum se citesc informații despre fișier? f Cum să obțineți o listă de fișiere dintr-un director specificat? Cum să muți un fișier încărcat pe ftp pe computerul tău local? Cum să împărțiți un fișier mare în mai multe fișiere de o anumită dimensiune? Cum se arhivează fișierele? Cum se compară două fișiere text? Cum se organizează controlul asupra formării fișierelor de către o aplicație externă? ActiveX Cum se utilizează controalele ActiveX? 331 332 335 335 336 336 337 337 338 338 340 341 341 Aspecte de documente active 343 Lucrul cu Internetul 345 Lucrul cu obiecte COM 351 Cum se creează nou acord bazat pe un fișier Microsoft Word? 343 Lucrul cu prin email 345 Cum se organizează munca cu e-mail printr-un client de e-mail instalat? 345 Cum se organizează lucrul cu e-mail fără un client de e-mail instalat pe computerul utilizatorului? 346 Lucrul cu fișiere 349 Încărcarea fișierelor prin FTP 349 Executarea unei solicitări HTTP 350 f Cum se transferă soldurile produselor dintr-o bază de date 1C:Enterprise 8.0 într-o altă bază de date utilizând o conexiune COM Exemplu de accesare a programului 1C:Enterprise 8.0 din modulul MS Excel prin o conexiune COM f Cum se organizează citirea datelor din fișierele *.xls? Cum să rulați o macrocomandă înregistrată într-un registru de lucru Microsoft Excel? Cum se creează un document Microsoft Excel cu același design ca în alt document? f Cum se încarcă o listă de prețuri într-un document Microsoft Word? 14 351 353 355 356 357 359 Cuprins f Cum se interoghează o bază de date SQL personalizată? Automation Client/Server (OLE) Cum se completează interactiv un document într-o altă bază de date dintr-o bază de date 1C:Enterprise 8.0 utilizând Automation Client/Server (OLE)? Cum să încărcați o listă de articole dintr-un tabel Excel în 1C:Enterprise cu posibilitatea de a edita? Schimb de date<Э Как организовать работу удаленных складов? Как при создании начального образа управлять тем, какие виды объектов перегружаются, а какие нет? Как просмотреть объекты, для которых зарегистрированы изменения? Как организовать обмен данными между произвольными конфигурациями 1С:Предприятие 8.0? Как принудительно зарегистрировать изменения объектов? WEB-расширение ф Как в форме списка номенклатуры отменить все установленные отборы? Как запретить перенос содержимого ячеек в форме списка расходных накладных? Как открыть список расходных накладных с отбором, установленным по определенному складу? Как добавить кнопку для ввода документа на основании? Указатель 362 363 363 364 366 366 369 371 372 379 380 380 382 384 388 389 15 Введение Идея написать эту книгу возникла у нас не случайно. Платформа системы «1С: Предприятие 8.0» специально ориентирована на то, что ее будут использовать не только как средство разработки, но и как инструмент быстрой доработки «на месте». В таких случаях специалисту важно в сжатые сроки решить конкретную задачу без долгого изучения всех возможностей системы. Как преподаватели учебного центра - мы, разумеется, только за то, чтобы специалист был изначально методологически и всесторонне «подкован». Но как практикующие разработчики, кроме всего прочего, зачастую и сами с большей радостью используем описанные примеры решения тех или иных задач, нежели пытаемся воссоздать их по памяти или по методическим материалам. Собственно говоря, именно с целью помочь в подобных ситуациях, и была написана эта книга. Основой ее создания послужил опыт преподавания «программистских курсов» по системе, работа на конкретных внедрениях и активное общение в форумах, посвященных данному кругу проблем. Фактически книга составлена в результате анализа того, какие задачи приходится решать чаще всего как начинающим, так и продвинутым разработчикам. При подборе примеров мы исходили из того, что спектр навыков и знаний специалистов, которые будут работать с данным изданием, может быть очень широк. Поэтому пусть Вас не смущают некоторые особо «бородатые» советы или, наоборот, - отсутствие подробного описания тех или иных технологий. А для тех, кто практически не знаком с системой «1С:Предприятие 8.0», материал самых простых примеров, объясняющих азы использования объектов и механизмов системы, помечен специальным значком ф. Кроме этого, поскольку работа с настоящим изданием не требует досконального чтения всего материала, по тексту намеренно вставлены повторы некоторых приемов или предостережений в тех случаях, когда это имеет смысл. Также следует заметить, что мы стремились сделать именно сборник простых примеров, поэтому некоторые материалы вошли в издание в «разрезанном» виде. То есть вместо сложных и громоздких «сквозных» примеров, мы старались представить отдельные части, «кирпичики», из которых впоследствии можно собрать желаемое. 16 Введение Стиль изложения соответствует цели издания, поэтому материал предоставляется в форме вопросов и ответов, как, например, в следующем разделе: Как работать с изданием? Решение данного вопроса - многовариантно. Можно читать классическим способом. От начала до конца, помечая или закладывая понравившиеся места. Впоследствии, при возникновении конкретных вопросов, зрительная память или закладки помогут найти нужное решение. Можно читать выборочно. Любимая поговорка крутых программистов: «Мануал открывать надо уже в последний момент». То есть, проблема возникла - нашли раздел и попытались найти решение, или идею решения по аналогии. Но поговорку, на самом деле, мы совсем не одобряем! Можно вообще не читать. Не читать комментарии. А рассматривать издание как сборник «шпаргалок» кода, решающего те или иные вопросы. Остальные варианты использования издания или не очень нравятся авторам, или достаточно опасны. Например, не надо рассматривать эту книжку как замену полноценного обучения или работы с методическими материалами. 17 Примитивные типы, системные функции Как явно указать нужную дату? Для указания нужной даты можно пользоваться: литералом вида ТГГГММДДччммсс" встроенного языка; встроенной функцией преобразования значений Дата(); литералом типа Дата языка запросов. В таблице ниже приводится ряд возможностей явного указания даты при помощи встроенного языка: Выражение "20050308" Дата(2005, 1,1) Дата(1, 1, 1) Дата(2005, 1, 1, 10, 29, 50) Значение результата (тип) 08.03.2005 0:00:00 (Дата) 01.01.2005 0:00:00 (Дата) 01.01.0001 0:00:00 (Дата) 01.01.2005 10:29:50 (Дата) В случае же, если в тексте запроса необходимо жестко указать некую дату - используется литерал ДАТАВРЕМЯ(). Например, поле со значением "01.01.2005 0:00:00" можно получить так: Как проверить дату на пустое значение? Значение типа Дата не бывает «пустым». Если в явном виде значение переменной типа Дата не задано, она будет иметь значение по умолчанию: начало первого дня первого месяца первого года (00 часов 00 минут 00 секунд). Поэтому проверку проще сделать так: 18 Примитивные типы, системные функции Как сравнить две даты (дни)? Точность данных типа Дата - до секунды. А сравнивать нужно именно дни. Тогда проще предварительно для сравниваемых дат воспользоваться функцией, которая возвращает, например, дату начала дня. А потом уже сравнивать полученные значения. Как прибавить к дате день, месяц? Так как тип Дата содержит дату и время с точностью до секунды, то для того чтобы к некоторой дате прибавить один день, нужно увеличить ее значение на количество секунд, содержащихся в одном дне: Для увеличения или уменьшения даты на некоторое количество месяцев, можно использовать: функции работы со значением типа Дата во встроенном языке; функции работы со значением типа Дата в запросах. В таблице ниже приводится ряд возможностей использования функций встроенного языка: Выражение ДобавитьМесяц(Дата(2005, 1, 31), 1) ДобавитьМесяц(Дата(2005, 2, 28), -1) КонецМесяца(ДобавитьМесяц(Дата(2005, 2, 28), -1)) Значение результата (тип) 28.02.2005 0:00:00 (Дата) 28.01.2005 0:00:00 (Дата) 31.01.2005 23:59:59 (Дата) 19 Примитивные типы, системные функции А вот пример функции, добавляющей количество дней к исходной дате при помощи запроса: В тексте запроса используем функцию ДОБАВИТЬКДАТЕ(). В качестве параметров ей необходимо передать исходную дату, тип добавляемых периодов (в нашем случае жестко прописали «День») и количество добавляемых периодов. Первый и последний параметры передали запросу, считав их из параметров (заголовка) нашей функции. Далее запрос выполняется, и из него получаем значение выходного поля по первой (и единственной) строке. Результаты выполнения вышеприведенной функции будут такими: ПолучитьДень("20052802", 10) = 10.03.2005 0:00:00 ПолучитьДень("20042802", 10) - 09.03.2004 0:00:00, поскольку 2004 год был високосным! Как можно проверить тип значения переменной на равенство нужному? 20 Примитивные типы, системные функции ТипЗнч() - функция языка, возвращающая по значению его тип. Тип () - функция языка, возвращающая значение типа Тип по строковому имени типа. Как очистить реквизит формы, имеющий ссылочный тип? К примеру, реквизит (имя «Товар») имеет тип СправочникСсылка.Номенклатура. Для очистки значения в связанном с ним элементе управления на форме, необходимо выполнить строку кода: То есть необходимо установить значение по умолчанию. А им, в данном случае, будет пустая ссылка на элемент справочника «Номенклатура». Как очистить значение, имеющее тип «Хранилище значения»? Очистить значение, записанное в реквизит или ресурс «РеквизитХранилище») можно следующим образом: (имя Как проверить тип значения, помещенного в реквизит имеющий тип «Хранилище значения»? По причинам не связанным с возможностями системы 1С:Предприятие 8.0, в реквизит «Фотография» (тип ХранилищеЗначения) справочника «Сотрудники» помещалась либо Строка (преобразованная к типу ХранилищеЗначения), либо Картинка (преобразованная к типу ХранилищеЗначения). Как проверить, что было записано? 21 Примитивные типы, системные функции Проверку можно осуществить, используя следующие строки кода: Следует отметить, что в реквизит имеющий тип ХранилищеЗначения можно поместить только значение, имеющее тип ХранилищеЗначения. Работа со значением, помещенным в хранилище значения, может начаться только после его получения (метод Получить()). После получения значение «восстанавливает свой прежний тип». Если полученное значение равно Неопределено, то это означает, что никакое значение в реквизит не записывалось. Как сжать данные, помещаемые в хранилище значения? Допустим, в реквизит «СопроводительнаяИнформация» (тип значения - Хранилище значения) помещается значение переменной «ПомещаемоеЗначение». Нужно обеспечить максимальное сжатие данных закладываемого значения. Вторым параметром конструктора хранилища значения передается объект СжатиеДанных. Он тоже получен соответствующим конструктором, с указанием максимального уровня сжатия. 22 Примитивные типы, системные функции Как предоставить пользователю возможность выбора значения составного типа? Для реализации этой задачи необходимо воспользоваться конструктором объекта ОписаниеТипов. А для него необходимо передавать в качестве параметра массив разрешенных для вводимого значения типов значения. Когда конструктором «ОписаниеВозможныхТипов» собрано применяем функцию для вызова диалога ввода данных ВвестиЗначение(). Первым параметром функции необходимо указать доступную в данном модуле переменную для принятия введенного значения. Вторым - заголовок открываемого окна. Третьим - объект ОписаниеТипов. После ввода значения пользователем можно считать значение с переменной, переданной первым параметром. 23 Примитивные типы, системные функции Как применить округление при работе с вычисляемыми числовыми полями в запросе? Например, составляется запрос для оценок средней цены продажи по данным регистра «Продажи». Для получения данных с точностью до двух знаков после запятой текст запроса может выглядеть следующим образом: Источником для запроса является виртуальная таблица «РегистрНакопления.Продажи.Обороты», построенная по данным регистра в интервале между «ДатаНач» и «ДатаКон». В качестве выходных полей берем «Номенклатура» и результат деления значения полей источника «СтоимостьОборот» и «КоличествоОборот». Причем оператором ВЫРАЗИТЬ() тип последнего поля приводится к примитивному типу ЧИСЛО с определенным форматом (длинна 15, точность 2). Как вывести многострочное предупреждение? Переменные «Остаток» и «Зарезервировано» содержат значения, которые необходимо вывести в виде предупреждения. Кроме того, нужно еще вывести свободный остаток, вычисляемый по формуле: СвободныйОстаток = Остаток - Зарезервировано. Все это может быть выполнено следующим образом: 24 Примитивные типы, системные функции Процедура глобального контекста Предупреждение() выводит на экран модальное окно предупреждения. Текст предупреждения передается первым параметром, вторым - таймаут, содержащий указание количества секунд, через которое окно самостоятельно закроется (если раньше его не закроет пользователь), третьим - указывается заголовок окна. Многострочность предупреждения в нашем примере осуществляется за счет добавления значения ПС (перевод строки) системного набора значений СИМВОЛЫ в текст предупреждения. Обратите внимание на вычисление свободного остатка в скобках для обеспечения корректности выполнения арифметических действий и преобразования данных к типу Строка. Кроме того, хотелось бы предупредить об опасности попыток применения процедуры Предупреждение() в ходе проведения документов. Проведение документов выполняется в транзакции, поэтому использование каких либо интерфейсных решений, останавливающих работу системы, является совершенно неприемлемым. В подобных случаях лучше информировать пользователей посредством Сообщить(). Как при выполнении обработки сообщить пользователю текущее время? Метод ТекущаяДата() возвращает системную дату. Тип значения Дата. В его значение входит и дата и время. Для получения представления только времени можно применяем функцию Формат(). Как вывести число прописью по-русски, но без дробной части? Для этого используется функция ЧислоПрописью(). У нее могут быть указаны в качестве параметров: преобразуемое число; форматная строка; параметры предмета исчисления (вид этой форматной строки определяется значением кода локализации). 25 Примитивные типы, системные функции Все возможные варианты локализаций описаны в файле Locllnfo.txt, входящем в комплект поставки программы. Для решения нашей задачи можно использовать следующий текст: В форматной строке указываем код локализации - Русский(Россия). В параметрах предмета исчисления показываем, что дробная часть не должна содержать ни одного разряда. Для ВыводимоеЧисло = 234,4 результат будет: «Двести тридцать четыре». Как вывести число прописью по-русски, с указанием сотых в дробной части? В параметрах предмета исчисления указываем возможные спряжения и склонения слов «целая» и «сотая», а так же количество разрядов дробной части, которые будут выводиться прописью. В форматной строке указываются код языка локализации и необходимость вывода дробной части прописью. Для ВыводимоеЧисло - 123,45 результат будет: «Сто двадцать три целых сорок пять сотых». 26 Примитивные типы, системные функции Как вывести прописью число килограммов с указанием дробной части в граммах? В отличие от вышеприведенного примера здесь предметами исчисления являются килограммы и граммы, а количество разрядов дробной части - три. Для ВыводимоеЧисло = 12,345 результат будет: «Двенадцать килограммов триста сорок пять граммов» Как долларовую сумму вывести прописью поанглийски? Для ВыводимоеЧисло = 1 232,45 результат будет: «One thousand two hundreds thirty two dollars 45 cents» Какзагрузитьвнешнююкомпоненту? Загрузим компоненту, позволяющую работать со сканером штрихкодов: 27 Примитивные типы, системные функции В случае ошибки загрузки компоненты или создания объекта возникает исключительная ситуация, которую рекомендуется отрабатывать с помощью конструкции Попытка. Как выполнить команду операционной системы? К примеру, требуется удалить все файлы из указанного каталога. Для реализации данной возможности достаточно выполнить следующую строку кода: Для просмотра доступных команд можно в командной строке системы выполнить команду «help». Вызвать командную строку, можно выполнив строку кода: Кроме этого, для запуска внешнего приложения (или открытия файла с использованием ассоциированного с ним приложения) может быть использован метод глобального контекста ЗапуститьПриложение(). В этом случае запуск приложения будет осуществляться непосредственно, минуя командный интерпретатор. Например: 28 Примитивные типы, системные функции Как реализовать код процедуры в зависимости от режима выполнения (на клиенте, на сервере, во внешнем соединении) ? Если алгоритм должен выполняться по-разному в зависимости от места выполнения процедуры, то можно воспользоваться инструкциями препроцессора: 29 Примитивные типы, системные функции Как при групповой обработке объектов реализовать стратегию «либо все, либо ничего»? Требуется загрузить либо все данные по справочнику «Единицы измерения», либо, в случае возникновения ошибки, нужно чтобы ни один элемент не был записан. Для реализации стратегии «либо все, либо ничего» можно использовать следующий фрагмент кода: Если необходимо но мере накопления каких-либо признаков «искусственно» отменить действия, совершаемые в транзакции, можно использовать метод системы: МО Примитивные типы, системные функции Как посчитать сумму по формуле сложного процента? Возведение в степень реализуется функцией Pow(). Первым параметром передается основание степени, вторым - показатель степени. Замечание: кроме работы со степенями математический аппарат системы позволяет работать с корнями, логарифмами и тригонометрическими функциями. 31 Универсальные коллекции Массив В каких ситуациях обычно используются массивы? Массив является универсальной коллекцией, то есть объектом, предназначенным для работы с временными наборами данных в течение сеанса работы пользователя. Необходимость в его использовании возникает, когда требуется работать с временным набором данных. Чаще всего это промежуточные операции обработки информации: подготовка отборов, реализация поиска, подготовка группирования, передача параметров и проч. Массивы могут создаваться оператором Новый или получаться в результате применения методов некоторых объектов. Как создать массив? Создание массивов чаще всего происходит посредством оператора Новый: где «СозданныйМассив» - имя переменной, которая будет содержать созданный объект типа Массив. После создания к массиву можно добавлять элементы (произвольное количество). Если же мы хотим создать массив с заранее определенной размерностью, это можно сделать так: В результате в переменной «СозданныйМассив» будет создан массив с десятью значениями. Для такого массива можно потом сразу обращаться к любому из десяти значений (начиная с нулевого по девятое) для записи или для чтения. А при необходимости к такому массиву можно так же еще добавлять новые элементы. Первый же добавленный элемент получит индекс «10». 32 Массив Как создать многомерный массив? Массив является линейной динамической коллекцией с произвольным типом значений. Поэтому значениями массива могут выступать другие массивы. То есть создание массива массивов и решает задачу создания многомерного массива. Это можно делать при использовании конструктора массива: или в процессе добавления очередных элементов к массиву: И в том и в другом случае мы решим задачу создания двумерного массива размерностью 2x8. Чтение и запись значений такого массива можно производить посредством директивного указания индексов: или при помощи метода Получить(): Хотелось бы еще раз отметить, что создание массива определенной размерности конструктором ограничивает только количество возможных к заполнению значений массива, но не препятствует добавлению новых значений (в качестве которых могут выступать массивы произвольной размерности). 33 Универсальные коллекции Как добавить элементы в массив? Допустим, массив, к которому нужно добавить значение из переменной «НовоеЗначение», называется «НашМассив». Если нужно просто добавить очередной элемент (с индексом на единицу больше самого старшего) - действуем следующим образом: Если нужно, чтобы новые значения добавлялись с определенным индексом, то можно использовать метод Вставить(): Как определить размер массива? Чтобы определить можно сделать так: количество элементов массива «НашМассив» Однако имейте в виду, поскольку индексация элементов массива начинается с нуля - значение переменной «Размер» будет на единицу больше значения самого старшего индекса. Как обратиться к элементу массива? При обращении как для записи, так и для чтения элементов массива лучше пользоваться оператором , указывая индекс элемента. Помните, что индексация начинается с нуля. Пусть в переменную «ПервоеЗначение» нужно считать значение самого первого элемента массива, а в элемент массива с индексом «9» записать значение из переменной «ДесятоеЗначение»: 34 Массив Аналогичных результатов можно добиться при помощи методов Получить() и Установить(): Замечание: в любом случае, чтобы иметь возможность обратиться к элементу массива, он должен уже существовать. Иначе получим ошибку с сообщением о том, что индекс находится за границами массива. Как перебрать элементы массива? Если перебор элементов массива нужен для чтения данных из массива - проще всего организовывать посредством цикла перебора коллекции. Например, чтобы вывести сообщения о каждом числе, найденном в массиве «МассивЭлементов», достаточно сделать следующее: Обратите внимание, «ЭлементМассива» - это произвольное имя переменной, принимающей в себя очередное значение элемента коллекции при выполнении цикла. Если же при переборе элементов массива нужно их редактировать, то для этого нужно работать еще и с индексами элементов. Лучше тогда использовать так называемый «цикл-счетчик». Например, чтобы обнулить все числовые элементы массива, достаточно сделать следующее: 35 Универсальные коллекции «Сч» - это переменная, принимающее очередное значение счетчика на каждом выполнении цикла. Именно из нее и будем считывать значение индекса очередного элемента массива. Значение самого большого индекса массива определяется посредством метода ВГраница(). Как удалить элемент массива? Удаление отдельных элементов массива происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границы массива - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» массива приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Массив как бы «сомкнет ряды». Поэтому, например, один из наиболее простых вариантов удаления всех числовых элементов массива может выглядеть так: Сначала определяем самый старший индекс элементов массива. Цикл проверок и удалений чисел будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов массива проводится с конца, эффект «смыкания рядов» будет производиться только для уже проверенных элементов. 36 Массив ® Как удалить все элементы массива? Если требуется полное удаление элементов из массива, операция выполняется гораздо проще: Как удалить повторяющиеся элементы массива? Поскольку объект «массив» является одной из самых простых универсальных коллекций, методами поиска по значению он не обладает. Поэтому для того, чтобы удалить повторяющиеся элементы, следует перебрать все элементы массива и проверить их значения. Для выполнения поставленной задачи организуется два цикла: в первом цикле осуществляется перебор элементов массива и для каждого выбранного элемента осуществляется вложенный цикл сравнения 37 Универсальные коллекции текущего элемента с последующими элементами массива. В случае совпадения значений последующий элемент массива удаляется. Когда для очередного элемента с индексом «ТекущийИндекс» завершился вложенный цикл проверки с последующими - увеличиваем значение «ТекущийИндекс» на единицу с тем, чтобы следующий по индексу элемент попал в положение проверяемого. Как скопировать массив? Для получения копии массива в другом объекте (массиве) необходимо создать новый массив (массив-копию) конструктором. Далее в цикле перебора элементов исходного массива добавлять эти элементы в массив-копию. Массив Как проверить, что два массива идентичны? Это можно выполнить при помощи следующей функции. В качестве параметров ей передаются сами проверяемые массивы «ПервыйМассив» и «ВторойМассив». Сначала проверяем совпадение наибольших индексов в массивах, если совпадения нет - массивы уже не идентичны. Значит функция возвращает значение ЛОЖЬ. Далее необходимо произвести проверку идентичности элементов массивов с одинаковыми индексами. Поскольку индексация элементов массива начинается с нулевого значения - выполняем цикл-счетчик от нуля до значения наибольшего индекса массива. Внутри цикла при выполнении неравенства очередных элементов функция возвращает значение Ложь. Если цикл пройден до конца - значения всех элементов с одинаковыми индексами совпали. Значит функция может вернуть значение Истина. 39 Универсальные коллекции В массив выгружены данные, содержащие наименования контрагентов. Как их отсортировать? Список значений позволяет выполнять сортировки по представлению или по значению и, кроме того, обладает возможностями загрузки данных из массива и выгрузки в массив. Поэтому один из вариантов решения данной задачи может быть таким: Создаем список значений. Загружаем значения из массива «МассивНаименований». Сортируем список значений по значениям. Поскольку параметр не указали, направление сортировки будет - по возрастанию. Если нужно по убыванию - в качестве параметра надо передать соответствующее значение системного перечисления НаправлениеСорТИрОВКИ: После выполнения сортировки выгружаем значения из списка значений в массив. 40 Массив Есть массив, в который выгружены значения типа СправочникСсылка.Номенклатура. Как удалить все пустые значения массива? Получаем в виде параметра процедуры массив номенклатурных позиций. Устанавливаем нулевое значение счетчика - переменной «Счетчик». Организуем цикл, который будет выполняться, пока значение переменной «Счетчик» меньше количества элементов массива. Поскольку индексы элементов массива начинаются с нулевого значения, то наш цикл прервется в момент, когда значения индекса («Счетчик») и количества элементов совпадут. Внутри цикла проверяется условие, является ли ссылка, содержащаяся в очередном элементе массива - пустой. Если это так текущий элемент массива удаляется. В результате у следующих за ним элементов автоматически на единицу уменьшаться индексы. Кроме того, необходимо уменьшить на единицу значение переменной, отслеживающей количество элементов в массиве. Если же ссылка не пустая - увеличивается на единицу значение «Счетчик» с тем, чтобы на следующем ходе цикла работать уже со следующим элементом. 41 Универсальные коллекции Замечание: проверка на пустое значение для разных типов данных проводится по-разному. Только для ссылочных типов данных можно ее осуществлять посредством метода Пустая(). Как получить массив номенклатурных позиций, использованных в табличных частях «Номенклатура» и «Тара» накладной? Имеем ссылку на документ «СсылкаНаДокумент». Номенклатурные позиции могут быть указаны в колонке «Номенклат}фа» табличной части «Номенклатура» и в колонке «Номенклатура» табличной части «Тара». Тогда массив номенклатуры из обеих табличных частей можно получить следующим образом: Формируем массив «МассивНоменклатуры» посредством выгрузки колонки «Номенклатура» табличной части «Товары» документа. Аналогично формируем массив «МассивНоменклатурыТара» по табличной части «Тара». Далее в цикле перебора элементов второго массива добавляем их в первый. 42 Массив Есть две таблицы значений. Как получить массив совпадающих имен колонок? Данная операция может применяться для вспомогательного контроля перед загрузкой таблицы значений в таблицу записей регистра. Итак, есть «ТаблицаИсточник» PI «ТаблицаПриемник», требуется получить массив имен совпадающих по имени колонок. Создаем сначала конструктором «МассивСовпадающихКолонок». Далее выполняем цикл перебора колонок одной из таблиц. Внутри цикла в переменную «ИмяКолонки» получаем имя очередной колонки. Далее обращаемся к коллекции колонок другой таблицы значений и при помощи метода Найти() пытаемся найти такую же по имени колонку. Если поиск успехом не увенчается - метод выдаст значение Неопределено. А если удалось - добавляем очередной элемент к массиву «МассивСовпадающихКолонок». 43 Универсальные коллекции Как в запросе сделать отбор по нескольким вариантам заполнения реквизита типа «ПеречислениеСсылка»? Одним из приемов программирования, использующим массивы, является формирование коллекции возможных значений для заполнения параметров запроса. Это выполняется, например, когда в запросе используются отборы с операндами В или В ИЕРАРХИИ. Вот пример решения задачи: В параметр «МассивПричин» устанавливается значение - массив возможных причин, набранный из элементов перечисления « ПричиныОтсутствия». Замечание: для решения подобных задач (с операндами В и В ИЕРАРХИИ) можно передавать не только данные типа Массив, можно еще СписокЗначениЙ или вообще сформировать коллекцию возможных значений вложенным запросом в самом тексте запроса. Вариант выбора заполнения параметра зависит от конкретики самой задачи. 44 Массив Как из регистра сведений «РасчетчикиЗарплатыОрганизации» получить в виде массива всех расчетчиков зарплаты определенного подразделения организации? Периодический независимый регистр сведений «РасчетчикиЗарплатыОрганизации» имеет следующую структуру: Данную задачу можно решить посредством применения методов объектной модели или запросом. Пример решения посредством объектной модели: Создаем набор записей регистра. Устанавливаем отбор по значению измерения «ПодразделениеОрганизации». Читаем данные набора записей. Выгружаем колонку набора записей «Пользователь» в массив. Пример решения задачи посредством запроса: 45 Универсальные коллекции Источником в запросе будет таблица регистра «РегистрСведений.РасчетчикиЗарплатыОрганизации». Накладываем отбор по условию равенства поля «ПодразделениеОрганизации» определенному значению. В качестве выходных полей выбираем только «Пользователь». После выполнения запроса делаем выборку по результату запроса и в цикле перебора ее - формируем нужный массив. В данных примерах оба способа возвращают одинаковые результаты примерно за одинаковое время потому, что никаких дополнительных действий в процессе получения информации не требуется. Второй способ на первый взгляд кажется более длинным в отношении написания кода. Но если нам понадобится произвести отбор более чем по одному условию, или получить массив неповторяющихся значений - то вторым способом получить такие данные будет значительно легче и быстрее с точки зрения скорости исполнения. 46 Структура ® В каких ситуациях обычно используются объекты типа «Структура»? Структура является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в ее использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в массиве. Если элемент массива можно было характеризовать только числовым индексом и значением произвольного типа, то элемент структуры характеризуется строковым ключом и значением произвольного типа. Чаще всего структуры применяют в ситуациях, когда необходимо узнать или использовать имена реквизитов, свойств, полей, подчиненных объектов для тех или иных объектов; узнать или использовать значения реквизитов, свойств, полей, подчиненных объектов по их именам для тех или иных объектов. Кроме того, структуры удобно использовать для передачи параметров при работе с различными объектами. Структуры могут создаваться конструктором НОВЫЙ или получаться в результате применения методов некоторых объектов. Ввод элементов в структуру можно осуществлять как посредством параметров конструктора, так и посредством метода Вставить(). Как создать структуру? Создание структуры чаще всего происходит посредством оператора НОВЫЙ: где «СозданнаяСтруктура» - имя переменной, которая будет содержать созданный объект типа Структура. После вышеприведенного создания в структуру можно вставлять элементы (произвольное количество). 47 Универсальные коллекции Если же мы хотим создать структуру с заранее определенными элементами - это можно сделать, например, так: Первым параметром передается строка, в которой через запятую перечисляются ключи элементов структуры. Остальные параметры содержат значения для элементов структуры в том же порядке, в котором были перечислены ключи. Для такой структуры впоследствии можно обращаться к любому из элементов для записи или для чтения значения. А так же, при необходимости, к этой структуре можно еще добавлять новые элементы. Как добавить элементы в структуру? Для добавления элементов в структуру используется метод Вставить(). Первым параметром указывается ключ, вторым - значение нового элемента. Замечание: если в составе структуры уже был элемент с подобным ключом - то старый элемент будет замещен новым. Например: Как обратиться к элементу структуры? Для чтения значений элементов структуры можно использовать несколько вариантов написания кода. Для структуры «Оппонент», в составе которой есть элемент с ключом «Возраст» можно использовать явное указание значения ключа: 18 Структрура или передачу ключа в переменной: Также можно использовать метод СвоЙСТВО(), который получает значение элемента структуры по указанному ключу: Для записи значений элементов структуры использовать несколько вариантов написания кода. Если мы хотим изменить значение возраста в вышеописанного примера - можно это сделать так: также можно структуре из или так: или так: Как перебрать элементы структуры? Поскольку структура является коллекцией - перебрать элементы структуры можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов структуры «СтруктураПараметров», можно сделать следующее: 49 Универсальные коллекции Как удалить элемент структуры? Чтобы удалить элемент структуры - необходимо знать его ключ. Например, чтобы удалить из структуры «СтруктураПараметров» элемент с ключом «Номенклатура», достаточно сделать следующее: Если же нужно удалить все элементы структуры - применяется метод ОЧИСТИТЬ(): Как в структуре установить значение для элемента с определенным ключом? Все ключи элементов структуры - уникальны. Поэтому добавление новых элементов и замена (установка) значений для «старых» элементов выполняется одним и тем же методом Вставить^): Результатом примера выше будет структура, состоящая только из одного элемента: ключ у него - «Цвет», значение - «Синий» из системного набора значений \Л/еЬЦвета. Структрура Как получить в структуру многомерные данные? Как собрать информацию по установленным в форме журнала отборам? Для формы журнала документов установлены некие отборы. Чтобы сформировать многомерную структуру всех используемых отборов объекта «ЖурналДокументовСписок», можно сделать следующее: Создаем конструкторами две структуры. Структура «СтруктураОтборов» впоследствии будет содержать элементы, где в качестве ключа будет указано название отбора, а в качестве значения « СтруктураПараметровОтбора». В цикле перебора коллекции отборов объекта «ЖурналДокументовСписок» сначала проверяем, используется ли данный отбор. Если используется - заполняем структуру параметров данного отбора. Полученную структуру используем в качестве значения добавляемого элемента объекта «СтруктураОтборов». Впоследствии, если нам потребуется информация из полученной структуры, можно будет, например, перебрать элементы 51 Универсальные коллекции «СтруктураОтбора», а для каждого из этих элементов - перебрать элементы ее значения - структуры «ПараметрыОтбора» Как определить, есть ли в структуре элемент с ключом «Контрагент», и если есть, но содержит пустое значение справочника или Неопределено - удалить этот элемент? В качестве параметров метода СвоЙСТВО() можно указать ключ и переменную для получения значения по ключу. Кроме того, сам метод возвращает Истина, если элемент с данным ключом существует, и Ложь - если нет. Получив значение и проверив его на требуемые условия, удаляем элемент с указанным ключом из структуры. Замечание: кроме метода СвоЙСТВО() получить значения элемента структуры позволяют следующие варианты обращения по ключу: Структура-Контрагент или Структура[ "Контрагент" Структрура Как из табличной части «Товары» документа получить все строки, где значение реквизита «Цена» равно нулю, а значение реквизита «СтавкаНДС» равно значению «НДС18» перечисления «СтавкиНДС»? Для поиска строк, соответствующих условию определенного отбора, можно сделать следующее: СтруктураДляПоиска = Новый Структура("Цена, СтавкаНДС", О, Перечисления.СтавкиНДС.НДС 18); МассивСтрок = Товары. НайтиСтроки(СтруктураДляПоиска); Сначала создаем структуру для поиска. Далее посредством метода НаЙТиСтр0КИ() из табличной части документа «Товары» получаем массив строк, соответствующих отбору по структуре поиска. Обратите внимание, в данном примере был показан вариант добавления и заполнения элементов структуры непосредственно в конструкторе. Как получить данные о текущей учетной политике бухгалтерского учета организации из периодического регистра сведений на заданную дату? Периодический регистр сведений «УчетнаяПолитикаБухгалтерскийУчет» имеет следующую структуру: Тип значения измерения «Организация» СправочникСсылка. Организации. Ссылка на организацию находится в переменной «ЮрЛицо». Дата, на которую необходимо получить данные - переменная «ДатаПолучения». 53 Универсальные коллекции Получение необходимых данных можно организовать посредством метода ПолучитьПоследнее() менеджера регистра: Метод предназначен для получения данных наиболее поздней записи регистра, соответствующей указанным периоду и значениям измерений регистра. Значения измерений регистра должны предаваться в виде структуры. Каждый элемент структуры в качестве ключа должен использовать имя измерения. В качестве значения элемента структуры передаем значение отбора по этому измерению. Дату получения и полученную структуру отбора используем в качестве параметров для метода ПолучитьПоследнее(). Результатом применения метода к периодическому регистру сведений «УчетнаяПолитикаБухгалтерскийУчет» будет структура. Элементы полученной структуры состоят из названия ресурса в качестве ключа и значения ресурса в качестве значения. 54 Структрура Как сформировать структуру названий реквизитов табличной части произвольного документа? Пример функции, решающую данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ и имя табличной части документа. Конструктором создаем структуру « Стру ктураТабл ичнойЧасти Доку мента». В цикле перебора реквизитов нужной табличной части полученного документа вставляем в структуру элементы с названиями полученных реквизитов. Замечание: значения элементам структуры можно было и не указывать - все зависит от того, как в дальнейшем собираемся использовать полученную структуру. Как получить запросом данные табличной части документа, имея структуру названий реквизитов табличной части? Пример функции, решающей данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ или объект документа, имя табличной части и структуру названий реквизитов этой табличной части. 55 Универсальные коллекции Функция основана на сборе информации запросом, чей текст собирается «кусочками» из строковых переменных: Создаем переменную «ПоляРеквизитов». В цикле перебора элементов структуры имен полей табличной части добавляем к переменной «ПоляРеквизитов» «по кусочкам» будущие имена выходных полей запроса. Добавляются они через запятую. Далее формируем запрос, к тексту которого добавляем строку имен выходных полей запроса. Источником указываем таблицу нужной табличной части нужного документа. Кроме того, накладываем отбор по полю «Ссылка». Функция возвращает результат выполнения запроса. 56 Соответствие ф В каких ситуациях обычно используются объекты типа «Соответствие»? Соответствие является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в его использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в структуре. Если элемент структуры можно было характеризовать только строковым ключом и значением произвольного типа, то элемент соответствия характеризуется ключом произвольного типа и значением произвольного типа. Чаще всего соответствия применяют в ситуациях, когда необходимо хранить в оперативной памяти для последующей обработки данные с ключами произвольного типа. Кроме того, соответствия удобно использовать для передачи параметров при работе с различными объектами. Соответствия могут создаваться конструктором НОВЫЙ. ф Как создать соответствие? Создание соответствия происходит посредством оператора Новый: I СозданноеСоответствие = Новый Соответствие(); где «СозданноеСоответствие» «СозданноеСоответствие» - имя переменной, которая будет содержать созданный созданный объект типа типа Соответствие. Соответствие. содержать После вышеприведенного создания в соответствие можно вставлять элементы (произвольное количество). количество). элементы (произвольное ф Как добавить элементы в соответствие? Допустим к соответствию Допустим соответствию «ВозрастСотрудников» «ВозрастСотрудников» нужно добавить новый элемент. В качестве ключа должна выступать ссылка на сотрудника (ее можно считать из переменной «Сотрудник»), в качестве значения - возраст сотрудника (его можно считать из переменной «ВозрастСотрудника»). «ВозрастСотрудника»). 57 Универсальные коллекции Тогда добавление нового элемента можно произвести так: или так: Как обратиться к элементу соответствия? Запись значений элементов соответствия можно выполнять теми же способами, которые рассмотрены в вопросе «Как добавить элемент в соответствие?» на странице 57. А чтение значений элементов соответствия можно выполнять следующим образом: или так: В приведенных примерах из соответствия «ВозрастСотрудников» по ссылке на сотрудника в качестве ключа будет получено значение элемента соответствия. Как перебрать элементы соответствия? Поскольку соответствие является коллекцией - перебрать элементы соответствия можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов соответствия «Замены», можно сделать следующее: 58 Соответствие Как удалить элемент соответствия? Чтобы удалить элемент соответствия - необходимо знать его ключ. Например, чтобы удалить из соответствия «Замены» элемент со ссылкой на объект, содержащийся в переменной «УдаляемыйТовар», в качестве ключа, достаточно сделать следующее: Если же нужно удалить все элементы соответствия - применяется метод ОЧИСТИТЬ(): Как получить данные из соответствия? В соответствии «КурсыВалютДокумента» в качестве ключа используется значение валюты, а значениями являются структуры, содержащие «Курс» и «Кратность». Как получить курс и кратность валюты «УправленческаяВалюта» ? Сначала по ключу (ссылке на управленческую валюту) получаем значение соответствия. Поскольку значением является структура курса валют - далее получаем значения структуры по их названиям. 59 Универсальные коллекции Как получить многоуровневое соответствие видов расчетов, обладающих базовыми видами расчетов? Для плана видов расчетов «ОсновныеНачисления» необходимо получить соответствие «ВидыРасчетов», где в качестве ключей будут использоваться виды расчетов, обладающие базовыми. А в качестве значений - соответствия базовых видов расчетов. В качестве ключей последних - базовые виды расчета, в качестве значений - структуры, содержащие их свойства «Наименование» и «Предопределенный». Виды расчета Базовые виды расчета Оклад по дням Оклад по часам Ежегодный отпуск Оплата по часовому т арифу Оплата по дневному тарифу Оплата по произволе твенным нарядам Оклад по дням Надбавка за в редность Оклад по часам Оплата по произволе твенным нарядам Свойства базового вида расчета "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по часовому тарифу" "Предопределенный" - Ложь "Наименование" "Оплата по дневному тарифу" "Предопределенный" - Истина "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина Первичный сбор информации удобнее осуществить при помощи запроса с использованием итогов. Последующий перебор группировок результат запроса даст возможность сформировать необходимые объекты: 60 Соответствие Для запроса источником является таблица «ПланВидовРасчета.ОсновныеНачисленияОрганизации.БазовыеВидыРас чета». Выходными полями делаем все, необходимые для решения нашей задачи. Кроме того, вводим дополнительные итоги по полю «Ссылка» (ссылка на виды расчета). После выполнения запроса делаем выборку по верхнему уровню группировок результата запроса. 61 Универсальные коллекции Создаем конструктором три объекта - соответствие «ВидыРасчетов», в которое будем впоследствии добавлять виды расчетов, обладающие базовыми; соответствие «БазовыеВидыРасчетов», в которое будем добавлять базовые виды расчетов для каждого отдельного вида (владельца); структуру «СвойстваВидовРасчетов» для добавления информации о свойствах базовых видах расчетов. В цикле перебора верхнего уровня группировок (по видам расчета) сначала очищаем соответствие «БазовыеВидыРасчета». Далее открываем цикл перебора записей второго уровня группировки результата запроса (то есть уже по базовым видам расчетов определенного владельца). В этом цикле заполняем значения структуры «СвойстваВидовРасчетов» по ключам - названиям свойств. Далее добавляем сформированные структуры в качестве значений соответствия «БазовыеВидыРасчета» с конкретным базовым видом расчета в качестве ключа. По окончании вложенного цикла добавляем очередной элемент в соответствие «ВидыРасчетов» с заполнением значения ключа из поля «Ссылка», и заполненным соответствием «БазовыеВидыРасчета» в качестве значения. Список значений, таблица значений, дерево значений ® В каких ситуациях обычно используются списки значений, таблицы значений, дерево значений? Все эти объекты являются универсальными коллекциями, то есть объектами, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в использовании списка значений возникает, когда требуется работать с временным набором данных для решения интерфейсных задач. Дело в том, что в отличие от более простых универсальных коллекций (массива, структуры, соответствия) список значений состоит из объектов - ЭлементСпискаЗначениЙ. А элемент списка значений характеризуется следующим набором свойств: Значение; Представление. Содержит строковое пользовательское представление. То есть именно его пользователь увидит на экране. По умолчанию - генерируется автоматически; Пометка; Картинка; Применение списков значений для обычных задач универсальных коллекций, но не связанных с интерфейсными действиями, как правило - излишне. Обычно с этой функциональностью справляются объекты «попроще»: Массив, Структура, Соответствие. Таблицы значений позволяют работать с данными сущностей, представимых в виде таблиц, то есть «раскладываемых» на колонки и строки. А ведь с точки зрения многих систем автоматизации вообще «весь мир = совокупность таблиц». При этом можно добавлять/удалять данные (и колонки, и строки, и значения); искать данные (и колонки, и строки, и значения); сортировать данные (по любым колонкам); выгружать-загружать данные; подсчитывать итоги по колонкам; сворачивать данные и т.д. Дерево значений позволяет в добавление к вышеприведенным операциям еще вводить уровни иерархии для этих данных и оперировать в пределах уровней или игнорируя их. 63 Универсальные коллекции Подобный набор возможностей помогает решать самый широкий спектр задач промежуточной обработки данных произвольного типа. Как создать список значений? Список значений можно создать посредством оператора НОВЫЙ: где «СозданныйСписок» - имя переменной, которая будет содержать созданный объект типа СписокЗначении. Как добавить элементы в список значений? Например, требуется добавить в список значений «СписокСотрудников» новый элемент со значением ссылки на сотрудника (содержится в переменной «ТекущийСотрудник»), ФИО сотрудника в качестве представления (содержится в реквизите «ФИО» объекта «ТекущийСотрудник») и фотографии сотрудника в качестве картинки (содержится в переменной «Фото»): Если нужно, чтобы новые значения добавлялись с определенным индексом (переменная «Инд»), то можно использовать метод Вставить(): Если при этом в списке значений уже был элемент с таким индексом, то старый элемент получит индекс на единицу больше предыдущего; аналогично сдвинуться индексы у всех последующих. Если при использовании метода Вставить() указать индекс, выходящий за границы списка, - получим сообщение об ошибке. 64 Список значений, таблица значений, дерево значений Как найти элемент списка значений? Например, в списке значений «СписокСотрудников» надо найти элемент, в котором в качестве значения указан сотрудник, на которого ссылается переменная «ИскомыйСотрудник». Затем нужно сообщить индекс найденного элемента. Это можно выполнить следующим образом: Замечание: если искомое значение в списке может встретиться несколько раз - при таком подходе найдем только первый элемент, где оно содержится. Поэтому смотрите по ситуации. Поскольку список значения - объект, предназначенный, прежде всего для визуализации возможностей выбора пользователем, обычно при его заполнении уже сразу предотвращают возможность повторов. Если же такая возможность осмыслена, то получить все элементы списка значений, содержащие определенное значение можно, например, в цикле перебора элементов списка значений. Как обратиться к элементу списка значений? Если требуется получить доступ к элементу списка значений с определенным индексом (пусть содержится в переменной «Инд»), можно поступить так: или так: В любом случае - то, что получаем, еще не есть значение, заложенное в этот элемент списка (это еще не сотрудник), а именно объект типа ЭлементСпискаЗначений. 65 Универсальные коллекции Впоследствии с него можно считать значения свойств: Как перебрать элементы списка значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения всех элементов списка значений «СписокСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: Как удалить элемент списка значений? Удаление отдельных элементов списка значений происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границу индексов списка - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» списка приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Список значений - «сомкнет ряды». 66 Список значений, таблица значений, дерево значений Решим задачу удаления всех элементов списка «СписокОбъектов», содержащих числовые значения: значений Сначала определяем самый старший индекс элементов списка значений. Цикл проверок и удалений элементов будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов списка значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. ф Как создать таблицу значений и заполнить ее поля? Для создания таблицы значений используется оператор Новый: После этого молено создать колонки таблицы (при необходимости можно задать допустимые типы значений для колонки, заголовок и ширину колонки в символах). Затем можно добавить новую строку и установить значения в колонках таблицы: 67 Универсальные коллекции или так: Как найти значение в таблице значений? Если требуется «ТаблицаЗначений», сделать так: I найти первую где присутствует строку таблицы значений «ИскомоеЗначение», можно Найден наяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение); Если требуется найти первую строку, где «ИскомоеЗначение» может быть найдено, например, в колонках «Поставщик» и «Покупатель», то: Если же нужно найти все строки, где в колонке «Сотрудник» присутствует искомое значение, то это можно выполнить при помощи метода НаЙТиСтроки(): Сначала создаем структуру поиска, каждый элемент которой будет содержать название колонки таблицы значений в качестве ключа и искомое значение в этой колонке - в качестве значения. Далее структуру поиска передаем в качестве параметра методу НаЙТиСтроки(). Результат - массив строк таблицы значений, соответствующих структуре поиска. Список значений, таблица значений, дерево значений Замечание: если в этом примере в структуру поиска добавить поискнужного значения, например, еще и в колонке «Ответственный» - то в результате применения метода НаЙТиСтроки() получим все строки, где и «Сотрудник» и «Ответственный» равны искомому значению. Как перебрать строки таблицы значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения колонки «Сотрудник» всех строк таблицы значений «ТаблицаСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: ® Как удалить строки (колонки) таблицы значений? Удаление отдельных строк таблицы значений происходит с обязательным указанием удаляемой строки или индекса удаляемой строки. Если нужно удалить строку «УдаляемаяСтрока», входящую в таблицу значений «ТаблицаЗначений»: А так, например, будет удалена первая строка таблицы значений: 69 Универсальные коллекции Естественно, если указанный индекс будет выходить за границу индексов строк таблицы значений - получим сообщение об ошибке. Аналогично и для колонок. Только работать уже надо с коллекцией колонок таблицы значений. Доступ к ней - через свойство КОЛОНКИ таблицы значений. или Кроме того необходимо учитывать, что удаление строки (или колонки) «из середины» таблицы значений приведет к уменьшению на единицу индексов строк, стоявших «после» удаленной (эффект «смыкания рядов», вернее -«смыкание строк»). Например, решим задачу удаления всех строк таблицы значений «ТаблицаЗначений», содержащих числовые значения хотя бы в одной колонке: Сначала определяем самые старшие индексы строк и колонок таблицы значений. Цикл проверок и удалений строк будет выполняться, пока очередное значение индекса строки не окажется меньше нуля. Внутри цикла но строкам делаем цикл-счетчик перебора индексов колонок. Во вложенном цикле определяем тин значения элемента находящегося в строке с текущим индексом и в очередной колонке. Если 70 Список значений, таблица значений, дерево значений это число - удаляем строку таблицы значений и прерываем вложенный цикл. Кроме того, в любом случае на каждом шаге внешнего цикла уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор строк таблицы значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. Как заполнить таблицу значений, если имена колонок содержатся в переменных? Если имя колонки, для которой требуется установить значение, содержится в переменной, можно использовать оператор : В вышеприведенном коде: «ТаблицаЗначений» - имя таблицы значений; «ИмяКолонки» - строковая переменная, содержащая имя колонки, по которой нужно заполнить значение; «Значение» - переменная, содержащая само заполняемое значение. Как заполнить всю колонку таблицы значений нужным значением? Колонку «ФлагФискального Учета» в таблице «ТаблицаЗначений» необходимо заполнить значением Ложь. значений Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром - имя заполняемой колонки. Замечание: если нужно заполнить несколько колонок значением - их имена указывают через запятую во втором параметре. Если не указать второй параметр - значением заполнятся все поля таблицы. 71 Универсальные коллекции Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»? Если «ТаблицаПолучатель» на момент выполнения операции еще не существует, или ее предыдущие колонки сохранять не нужно, можно создать ее, как полную копию исходной: Вариант второй: таблица «ТаблицаПолучатель» существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы. Тогда можно так: Для каждой строки исходной таблицы добавляется новая строка в таблицу получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице. Замечание: если у таблиц не будет колонок с одинаковыми именами - таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике. Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя - в таких полях получим пустые значения. Рассмотрим третий случай. В случае одноименных колонок - колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника. 72 Список значений, таблица значений, дерево значений Нам придется заменить колонку в таблице получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника. Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Далее выполняем цикл перебора строк исходной таблицы. В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок. Внутри этого вложенного цикла производим заполнение ячеек таблицы получателя данными ячейки таблицы-источника. 73 Универсальные коллекции Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу? При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() - не трогать. В этом случае тип данных колонки - произвольный. Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов - через запятую) или массив допустимых типов. Если среди типов разрешенных к заполнению данных колонки есть строка - можно ограничить ее разрядность (длину), указать использование неременной или фиксированной длинны. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов. Аналогичные действия можно квалификаторов числа и даты. 74 осуществлять в отношении Список значений, таблица значений, дерево значений Обратите внимание, описание типов можно строить конструктором как «с нуля», так и использовать как основу уже существующее описание типов. Как изменить тип значения колонки таблицы значений, полученной выгрузкой из запроса? Запросом собираются данные по документам «Посту плениеТоваров Услуг» PI выгружаются в таблицу значений «ТаблицаСсылок» (колонка «Ссылка»). Впоследствии к этой таблице значений будут добавляться еще строки. Как обеспечить возможность добавления в полученную таблицу значений в колонку «Ссылка» документов других видов («ОприходованиеТоваров», « ВозвратОтПокупателя») ? При выгрузке данных из запроса в таблицу значений тип значения колонок определяется типом значений колонок результата запроса. Поэтому одним из самых простых вариантов решения задачи может быть воздействие на запрос, а не на таблицу значений. 75 Универсальные коллекции Создаем пустые ссылки на документы «ОприходованиеТоваров» и «ВозвратОтПокупателя». Далее в запросе делаем объединение с записями, содержащими эти пустые ссылки. Причем в объединяемых запросах по пустым ссылкам применяем ПЕРВЫЕ 0 для того, чтобы впоследствии не удалять строки с пустыми ссылками из таблицы выгруженного результата запроса После выполнения и выгрузки запроса в таблицу значений «ТаблицаСсылок» тип значения колонки «Ссылка» будет составным: «NULL, ДокументСсылка ЛоступлениеТоваровУ слуг, ДокументСсылка. ОприходованиеТоваров, ДокументСсылка.ВозвратОтПокупателя». То есть - то, что и требовалось. Как самостоятельно заполнить дерево значений? Для иллюстрации данной возможности создадим обработку, в которой определен реквизит «Дерево» (тип ДеревоЗначениЙ). В диалоге определено табличное поле, связанное через свойство данные с реквизитом «Дерево» (имя элемента управления «Дерево»). Следующая процедура произведет запись данных в дерево значений. 76 Список значений, таблица значений, дерево значений Следующая процедура показывает один из вариантов установки текущего значения в элементе управления, связанного с деревом (табличном поле). 77 Прикладные объекты Справочники © Как создать элемент (группу) справочника? Создание нового элемента в неиерархическом справочнике можно выполнить при помощи следующего кода: Если справочник иерархический, то выполнение этого кода приведет к созданию нового элемента в корне справочника. Для того чтобы создать новый элемент в определенной группе иерархического справочника, необходимо также указать родителя создаваемого элемента: Если требуется создать новую группу в иерархическом справочнике, то для этого следует использовать метод менеджера справочника Создать Груп пу (). Если группа должна находиться внутри 78 Справочники определенной группы справочника, также следует указать и родителя создаваемой группы: Следует обратить внимание на тот факт, что у реквизитов, в которые будет производиться запись значений в свойстве «Использование» должно стоять одно из перечисленных ниже значений: Для группы Для группы и элемента Если для справочника установлен вид иерархии Иерархия элементов, то для создания новых элементов следует использовать метод СоздатьЭлемент() менеджера справочника, а иерархия создаваемых элементов будет определяться значением свойства Родитель объекта справочника: 79 Прикладные объекты Как найти элемент справочника? Для поиска элемента справочника можно использовать несколько способов. По коду: При организации поиска по коду обращайте внимание на тип кода справочника (Число или Строка). По наименованию: По реквизиту: Во всех методах поиска есть параметры позволяющие искать в нужной группе, в рамках подчинения определенному элементу справочника владельца и ряд других параметров. 80 Справочники Как удалить элемент справочника? Для корректного удаления элемента справочника необходимо убедиться в том, что другие данные не содержат ссылок на удаляемый элемент справочника. Например, в переменной «СсылкаНаУдаляемыйЭлемент» содержится ссылка на удаляемый элемент справочника: Для пометки элемента справочника на удаление можно использовать метод УстановитьПометкуУдаления() объекта справочника: Использование этого метода позволяет установить или снять пометку на удаление элемента справочника, причем будут инициированы события Перед записью и При записи объекта справочника, поскольку выполняется сохранение измененного свойства ПометкаУдаления объекта справочника. 81 Прикладные объекты Как перебрать элементы справочника? Для того чтобы перебрать элементы справочника, необходимо сформировать выборку элементов с нужными параметрами и затем обойти ее в цикле. Например, для перебора всех элементов справочника «Номенклатура» в иерархическом порядке, можно использовать следующий код: Аналогичного результата можно добиться, используя запрос: Благодаря использованию запроса можно формировать выборку элементов справочника более «гибко», поскольку запрос позволяет задать произвольные условия на выбираемые данные. 82 Справочники ® Как выбрать все элементы из определенной группы? Организуем выборку элементов справочника из группы, ссылка на которую определена в переменной «ПолеВводаРодитель»: В результате работы этого кода будут получены все дочерние элементы выбранного элемента справочника. Аналогичное действие, выполняемое с помощью запроса, будет выглядеть следующим образом: 83 Прикладные объекты Если необходимо получить не только дочерние элементы, но и все элементы, находящиеся в иерархии выбранного элемента, следует, при использовании объектной техники, выполнять метод ВыбратьИерархически() менеджера справочника: а при использовании запроса применять условие В ИЕРАРХИИ: 81 Справочники ® Как перебрать элементы подчиненного справочника с помощью запроса? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». Делаем запрос по таблице справочника «Контактные лица» с отбором по полю «Владелец». В качестве владельца передаем ссылку на элемент справочника «Контрагенты». 85 Прикладные объекты ® Как перебрать элементы подчиненного справочника с помощью выборки справочника? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». ф Как открыть форму списка (элемента) справочника? Для того чтобы открыть форму списка справочника, можно воспользоваться методом ПолучитьФормуСписка() менеджера справочника: Для того чтобы открыть произвольную форму справочника, можно использовать метод ПолучитьФорму() менеджера справочника: Однако следует помнить, что если методом ПолучитьФорму() выполняется получение формы элемента или группы справочника, то будет получена форма нового элемента (группы). Справочники Для того чтобы открыть форму существующего элемента или группы справочника, следует использовать метод ПолучитьФорму() ссылки или объекта справочника: ® Как добавить запись в табличную часть элемента справочника? Имеется ссылка на элемент справочника «Контрагенты». Как добавить запись в табличную часть «ВидыДеятельности» этого элемента? Модифицировать можно только объект справочника. Поэтому так: Получаем объект справочника от ссылки на элемент. Добавляем новую строку к табличной части полученного объекта. Заполняем реквизиты табличной части в данной строке. Записываем измененный элемент справочника. Как удалить строки из табличной части справочника? Для того чтобы полностью очистить табличную часть элемента справочника, можно воспользоваться методом ОЧИСТИТЬ() табличной части справочника: 87 Прикладные объекты Если требуется выборочное удаление строк табличной части (например, в зависимости от значения их реквизитов), можно сначала отобрать строки, удовлетворяющие условию, а затем удалить каждую из них методом Удалить() табличной части справочника. В следующем примере подразумевается, что переменная «ВыбранныйЭлемент» содержит ссылку на обрабатываемый элемент справочника, а переменная «ВыбранныйВидДеятельности» содержит ссылку на вид деятельности, который не должен присутствовать у обрабатываемого элемента: ф Как перебрать строки табличной части справочника? Табличная часть справочника представляет собой коллекцию строк, которую можно перебрать в цикле. Реквизиты табличной части будут доступны как свойства строки табличной части. Например, перебор строк табличной части «ВидыДеятельности» справочника «Контрагенты» может быть выполнен следующим образом: Справочники ® Как создать элемент в нужной группе? Необходимо создать элемент справочника номенклатура, так чтобы при этом он попал в нужную группу. Если группы с указанным кодом нет, то тогда такая группа должна быть создана. Можно использовать предопределенную группу, в этом случае вместо поиска и создания новой группы можно использовать строку: 89 Прикладные объекты Обратите внимание на тот факт, что механизм работает, только если в справочнике установлен вид иерархии «Иерархия групп и элементов». В противном случае код будет выглядеть следующим образом: Если вид иерархии справочника «Иерархия элементов», то понятие группы в нем отсутствует. Как узнать, есть ли у текущего элемента подчиненные? Пусть ссылка на текущий элемент справочника содержится в переменной «Владелец». Необходимо узнать, есть ли в справочнике «Единицы измерения» элементы, подчиненные текущему элементу. Если использовать объектную модель доступа: 90 Справочники Фактически получаем выборку всех подчиненных элементов и если в выборке есть хоть одна позиция, считаем, что подчиненные элементы существуют. Именно этот факт и говорит о неэффективности использования данного варианта (выбираемые данные мы не используем, а получаемый блок данных может быть большим). Лучше всего подобную проверку можно выполнить, используя возможности запросов: Так как не предполагается, что нам понадобятся данные о подчиненном элементе, выборку результата запроса в переменной не сохраняем. Как узнать количество подчиненных элементов у выбранного элемента справочника? Необходимо определить количество элементов в справочнике «ЕдиницыИзмерения» подчиненных элементу справочника, ссылка на который находится в переменной «Владелец». С помощью объектной модели: 91 Прикладные объекты Данное решение в общем случае является не эффективным. Связано это с тем, что выборка фактически получает все данные о подчиненных элементах справочника, а в рамках данной задачи нужно только количество элементов. Если решать задачу с помощью запроса, то решение выглядит следующим образом: В результате в переменной «КоличествоЗаписей» будет находиться нужная нам величина. Справочники Как узнать количество подчиненных элементов у выбранного элемента справочника, если количество подчиненных справочников больше чем один? Если у справочника есть несколько подчиненных справочников, то запрос может выглядеть следующим образом: Данный запрос позволяет получить количество записей в двух подчиненных справочниках. В качестве источника данных в основном запросе используется подзапрос («ВложенныйЗапрос»). Сам подзапрос состоит из двух запросов (происходит их объединение). Каждый из объединяемых запросов получает данные о количестве записей в одном из подчиненных справочников. В выборке результата запроса (в случае если у элемента справочника, ссылка на который находится в переменной «Владелец», есть подчиненные элементы) будет одна строка, в поле «КоличествоПодчиненныхЭлементов» которой содержится количество подчиненных элементов. 93 Прикладные объекты Как получить всех родителей выбранного элемента справочника? В переменной «СсылкаНаЭлемент» находится ссылка на элемент справочника. Необходимо получить всех родителей данного элемента Перебрать всех родителей можно используя строки кода: Данную задачу можно решить и с помощью запроса, однако следует учитывать, что в языке запросов не предусмотрено специальных средств для получения всех родителей элемента. Для выполнения задачи можно воспользоваться, например, иерархическими итогами, текст запроса будет выглядеть следующим образом: Результат запроса будет содержать одну «лишнюю» запись, которую легко «отсеять» проверкой свойства «ЭтоГруппа». 94 Справочники Однако получение иерархических итогов оптимизировано для построения итогов большого количества записей, и не вполне эффективно для получения родителей одного элемента. Для более эффективного получения всех родительских записей элемента, рекомендуется перебирать в цикле его родителей небольшими порциями, например, так: 95 Прикладные объекты В данном примере в окно служебных сообщений выводятся все родители для ссылки, записанной в переменную «ЭлементНоменклатура». В цикле выбирается по 5 родителей ссылки. Если число уровней в справочнике ограничено и невелико, то возможно получение всех родителей одним запросом без цикла. Как получить запросом «полный» код элементов справочника, если тип кода Строка? Понятие «Полный код» соответствует объектной модели системы. Это свойство объектов «СправочникСсылка» и «СправочникОбъект», содержащее указание кодов элемента и всех родителей его иерархии. Представляет собой строку, в которой указаны коды всех вышестоящих элементов иерархии, начиная с самого верхнего уровня и разделяемые символом «/» заканчивая кодом самого элемента. В табличной модели хранения информации никакого поля «ПолныйКод» для таблиц справочника не существует. Однако можно говорить о значении поля «Родитель» каждой из записей таблиц справочников и о значении поля «Код». Поэтому запрос по трехуровневому справочнику «Контрагенты» будет выглядеть следующим образом: Источником является таблица справочника. Из нее выбираем поле «Ссылка» и вычисляемое поле «ПолныйКод». Вычисление полного кода производим путем сборки его из значений кодов самого элемента и кодов всех вышестоящих родителей. Для этого для каждой записи сначала определяем ее уровень. 96 Справочники Уровень определяем следующим образом: для записей корневого уровня поле «Родитель» содержит пустую ссылку на элемент справочника, поэтому значение поля «Код» этого «Родителя» будет NULL. Если это условие выполнилось - значит, элемент находится на корневом уровне, и в качестве полного кода достаточно указать код. Если условие не выполнилось - проверяем аналогичным способом элемент на принадлежность к первому уровню. В случае выполнения условия - выводим уже код родителя и код самого элемента через «/». Таким же образом можно построить «сборку» поля «ПолныйКод» для случаев 4-х, 5-ти и т.д. уровневых справочников. В отношении возможных возражений о «неуниверсальности» подобного подхода: хотя, в общем случае, количество уровней справочника может быть не ограничено, сложно представить себе реальную практику использования справочника более чем с 10 уровнями вложенности из-за явного неудобства работы пользователя с таким «глубоким» справочником. Как получить все элементы справочника, содержащие в наименовании определенную подстроку, со всей иерархией, в которую они входят? Допустим, речь идет о справочнике «Контрагенты». Лучше всего с данной задачей справится запрос со следующим текстом: 97 Прикладные объекты Источником запроса является таблица справочника. Делаем отбор по наименованиям, в составе которых присутствует значение параметра «ЧастьНаименования». Условие отбора обеспечивается посредством оператора проверки строки на подобие шаблону. В шаблоне служебными символами «%» обозначается, что перед и после части строки, считанной из «ПолеВводаПодстрока», может встречаться произвольное количество других символов. Как найти все элементы справочника, в которых не заполнен строковый реквизит? Получить желаемое можно таким запросом: Проверка пустой строки выполняется за счет операции сравнения «=». В данном случае будут отобраны и элементы, в которых пользователь ничего не вводил и даже те, в которые он ввел только пробел (или пробелы). Но на некоторые реквизиты при работе с формой накладывают маску. В таких случаях случайный ввод хотя бы одного пробела уже не позволяет данному реквизиту быть пустым. Его значение будет содержать маску с пробелами. Для того, чтобы «защитить пользователя от самого себя» в подобных случаях запрос лучше немножко изменить. Например, для реквизита с маской «999-999-999 99» запрос будет выглядеть таким образом: Количество пробелов соответствовать маске. перед и между символами «-» должно Справочники Как перенести все элементы справочника «Контрагенты» из одной группы в другую? Для этого необходимо перезаполнить значением нового родителя реквизит «Родитель» у элементов, непосредственно являющихся «потомками» исходного родителя. Итак, пусть переменная «СтарыйРодитель» содержит старого, а «НовыйРодитель» - нового родителя. Получение элементов справочника, которым нужно поменять родителя, производим следующим образом: Источником для запроса является таблица справочника «Контрагенты». Делаем отбор непосредственно по полю «Родитель» и получаем таблицу ссылок на нужные нам элементы справочника. Далее: В цикле обработки результата запроса производим получение объекта по ссылке. Для каждого полученного объекта производим запись нового родителя в реквизит «Родитель» и непосредственную запись объекта с измененными данными. 99 Прикладные объекты Как организовать программный выбор элемента справочника? Требуется из одной формы (например, формы документа) открыть для выбора элемента форму справочника. После того, как значение будет выбрано в форме справочника, его необходимо получить для дальнейшей обработки в форме документа. Для получения выбранного значения используется обработчик события Обработка выбора формы владельца (в нашем случае формы документа). Вместо метода Открыть() объекта Форма Выбора в ряде случаев можно использовать метод ОткрытьМодально(). В этом случае окно откроется в модальном режиме и пока данная форма не будет закрыта
