Ștergerea spațiului de stocare al setărilor utilizatorului. Stocare setări Unde sunt stocate setările raportului utilizator 1s 8.3

Scopul obiectului de configurare „Settings Storage” este clar din nume - pentru a stoca diferite setări ale utilizatorului. Domeniul de aplicare al acestui obiect este larg - în orice configurație, oricât de gravă, este necesară stocarea unor setări de utilizator.

Pentru comoditatea programatorilor, în fiecare configurație există mai multe magazine de setări standard; în plus, este posibil să creați cât mai multe magazine de setări suplimentare cât este necesar.

Mai întâi, să ne uităm la magazinele de setări standard care sunt prezente în orice configurație 1C începând cu versiunea 8.2.

Magazine de setări standard

Deci, implicit, configurația conține următoarele depozite de setări:

• Stocare opțiuni raport - pentru a accesa setările opțiunilor de raport.
• Stocarea setărilor personalizate ale raportului - pentru accesarea setărilor personalizate ale rapoartelor.
• Form DataSettings Storage - pentru accesarea setărilor utilizatorului pentru datele formularului.
• General Settings Storage - pentru a accesa setările generale.
• SystemSettings Storage - pentru accesarea setărilor sistemului.
• Stocarea UserSettings of Dynamic Lists - pentru accesarea setărilor de utilizator ale listelor dinamice.

Fiecare dintre aceste magazine poate fi accesat ca o proprietate a contextului global.

Programatorul poate folosi stocarea standard pentru propriile nevoi, salvând diverse setări în contextul utilizatorului, al obiectului și al setării în sine.

Pentru a lucra cu depozitele de setări (atât standard, cât și cele adăugate de programator), sunt utilizate următoarele metode.

Setări de înregistrare și recepție:

GeneralSettings Storage.Save(ObjectName,SettingsName,SettingsValue,SettingsDescription,UserName); SettingsValue = GeneralSettings Storage.Load(ObjectName, SettingsName, SettingsDescription, UserName);

Eliminarea setărilor redundante/inutile:

GeneralSettings Storage.Delete(ObjectName,SettingsName,UserName);

Obținerea unei liste de setări:

SettingsValueList = GeneralSettings Storage.GetList(ObjectName, UserName);

Parametrii „ObjectName”, „SettingsName” și „UserName” trebuie să fie de tip șir.

În baza de date, toate setările sunt stocate într-un tabel separat.

Arhivele de setări create de programator

Acum să vorbim despre acele depozite de setări care sunt create de programator. În general, programatorul nu este limitat în niciun fel în dorința sa de a crea un nou magazin de setări, dar de obicei sunt create magazine separate de setări din următoarele motive:

• este necesar să mutați setările între baze de date;
• controlul referințelor este necesar la stocarea setărilor;
• este necesară o structură specială de setări 1C.

Magazinele de setări sunt adăugate în secțiunea de configurare corespunzătoare.

O caracteristică cheie a depozitelor de setări create de programator este necesitatea de a implementa manual metode de scriere și preluare a valorilor (Save() și Load()). În aceste metode, programatorul trebuie să descrie salvarea (în registre de informații, fișiere, directoare etc.) și setările de încărcare folosind limbajul încorporat.

În caz contrar, principiile de lucru cu depozitul creat nu sunt practic diferite de lucrul cu depozitele de setări standard.

Depozitul creat poate fi accesat astfel:

Setări Storage.StorageName.Load();

În plus, depozitele create le pot înlocui pe cele standard în diverse obiecte de configurare și în configurația propriu-zisă.

Formularele gestionate au două proprietăți:

• Salvarea automată a datelor - dacă este selectată valoarea „Utilizați”, datele vor fi salvate automat în stocarea standard a setărilor de date din formular;
• Salvarea datelor în setări - dacă este selectată valoarea „Utilizați listă”, atunci în fereastra cu detaliile formularului va apărea coloana „Salvare”, cu care puteți specifica ce detalii de formular trebuie salvate și veți putea, de asemenea, să selectați stocarea setărilor pentru aceste date.

Asta e tot, sper că acest articol te-a ajutat.

Nu este un secret pentru nimeni că periodic, în 1C trebuie să curățați setările utilizatorului!

deoarece În timpul procesului de actualizare a programului sau de finalizare a unei noi funcționalități, este posibil ca forma documentului sau modificărilor raportului și setările vechi salvate să nu fie afișate corect cu noua interfață. Pentru a remedia acest lucru, trebuie să ștergeți setările vechi și să le salvați cu altele noi.

Setările pentru formularele de tipărire a documentelor sunt de asemenea stocate aici; dacă documentul nu este tipărit de la 1C sau este tipărit strâmb, atunci trebuie să ștergeți setările 1C.

Procesarea ștergerii setărilor utilizatorului funcționează în 2 moduri:

1. Selectați un utilizator - faceți clic pe Ștergeți TOATE setările utilizatorului - toate setările vechi vor fi șterse pentru utilizatorul selectat, iar programul va funcționa și va afișa așa cum a fost intenționat de dezvoltatori. Această metodă ajută la eliminarea problemelor de afișare a formularelor în 1C.

2. Selectiv - Faceți clic pe Obține setările tuturor utilizatorilor - bifați casetele pentru ceea ce doriți să ștergeți și faceți clic pe Ștergeți pe cei marcați. Această metodă vă permite să ștergeți numai acele setări pe care le considerați problematice sau inutile.

Setările utilizatorului în 1C sunt de obicei împărțite în trei părți.

În primul rând, platforma 1C permite fiecărui utilizator să-și facă propriile setări 1C pentru confort. De exemplu, setările pentru rapoartele 1C SKD.

În al doilea rând, în fiecare configurație tipică și non-standard există de obicei multe unități de procesare care efectuează acțiuni de service. Procesarea necesită ajustare. Este păcat să pierzi timpul reintroducând setările de fiecare dată când deschizi procesarea.

Și, în cele din urmă, în al treilea rând, pentru programatorul însuși, pentru ca programul să fie universal, este mai bine să nu scrieți niște valori implicite în codul programului, ci să le stocați în unele setări.

Unde să stocați toate aceste setări în 1C?

Cum au fost salvate setările 1C înainte

În clientul gros 1C, platforma a oferit următoarea opțiune standard:

Când este necesar să vă amintiți setarea 1C, programatorul folosește funcția

Valoare = RestoreValue("SettingName", Value);

În consecință, programatorul creează butoane pentru salvarea și restabilirea setărilor 1C, iar utilizatorul folosește acest mecanism (sau programatorul le salvează automat).

Ca valoare, puteți utiliza nu numai un număr sau un șir, ci și, de exemplu, o Structură - un tip care vă permite să stocați multe valori cu numele lor, de exemplu:

Setări = Structură nouă(); Settings.Insert("SettingsName", Value); Valoare = Settings.SettingsName;

Setările 1C sunt salvate pentru utilizatorul care a apăsat butonul proiectat de programator pentru a salva setările 1C (sau sub care aceste acțiuni au fost efectuate automat). Setările 1C sunt stocate într-un fișier text în folderul cu baza de date (când se utilizează o bază de date de fișiere).

De asemenea, programatorul a fost liber să-și dezvolte propriile metode arbitrare pentru stocarea setărilor 1C folosind metode convenționale - de exemplu, lucrând cu fișiere text și XML - salvând setările 1C într-un mod arbitrar într-un fișier.

În configurațiile tipice, setările raportului 1C au fost salvate în registrul de informații. Iar setările pentru rapoartele 1C SKD pot fi salvate într-un fișier XML.

Stocare standard a setărilor 1C

Toate aceste caracteristici rămân în noua platformă 8.2, dar în cele din urmă a apărut o anumită „metodă standard” de salvare a setărilor - 1C Settings Storage.

Mecanismul este împărțit în două părți - stocare de setări 1C standard și personalizate. Cel standard este implementat în platforma 1C, cel personalizat este un obiect 1C care este creat și programat de programator.

Stocarea standard a setărilor 1C este utilizată de platformă în mod implicit în clientul subțire pentru a salva setările 1C ale utilizatorului în următoarele mecanisme de platformă:

Interfață gestionată de comandă
Forme
Raportați setările și opțiunile.

Un programator poate folosi stocarea setărilor standard 1C din codul programului în limbajul 1C într-un mod similar cu ceea ce s-a făcut înainte:

Când trebuie să vă amintiți o setare

Valoare = GeneralSettings Storage.Load("ObjectName", "SettingsName", Value);

Pentru a obține o listă de setări

List = GeneralSettings Storage.GetList("ObjectName");

Setarile 1C sunt salvate direct in baza de date, in tabele speciale.

După cum puteți vedea, în comparație cu vechiul mecanism, a fost adăugată o secțiune suplimentară - numele obiectului. Platformă, la salvarea automată, numele obiectului 1C este folosit în metadatele care indică tipul, de exemplu:
Raport.Vânzări

De asemenea, este posibil să gestionezi numele de utilizator pentru care vor fi salvate setările 1C, specificându-l ca ultimul parametru.

Există următoarele stocări standard de setări 1C:

• Stocare pentru setările sistemului
• Setări generale Stocare
• Stocare FormsDataSettings
• Stocarea rapoartelor UserSettings
• și Repository of Report Options.

1C stocare setări.

Programatorul își poate crea propriul depozit de setări în configurator.

Acest lucru ar trebui să se facă în următoarele cazuri:

Control de referință la stocarea setărilor 1C
Migrarea setărilor 1C atunci când utilizați URBD
Structură specială a setărilor 1C (pentru conformitatea automată)
Depășirea stocurilor standard.

Pentru a vă crea propriul spațiu de stocare pentru setări 1C, trebuie să adăugați unul în configurator în fereastra de configurare din ramura General/1C de stocare setări.

Puteți suprascrie depozitele standard de setări 1C utilizate de platformă în proprietățile de configurare (ramura rădăcină a configurației, pe care programatorii o numesc de obicei Root sau Head).

Dacă există o linie goală în proprietăți, se folosește stocarea setărilor standard 1C, în caz contrar, se folosește cea selectată, iar cea standard nu este utilizată.

În clientul gestionat subțire 1C, stocarea poate fi utilizată automat:

Există doi parametri într-o formă gestionată
o Salvarea automată a datelor – va fi efectuată automat, în stocarea standard a setărilor formularului
o Salvarea datelor în setările 1C - utilizați o listă - în lista detaliilor formularului va apărea o coloană Salvare, în care puteți bifa casetele care vor fi salvate și puteți specifica și stocarea setărilor create

În raport (inclusiv cei externi), au apărut parametri - Stocarea opțiunilor (rapoartelor) și Stocarea setărilor 1C - în ele trebuie să selectați stocarea 1C creată.

Într-un client gros, pentru a-l folosi, trebuie să scrieți un apel direct pentru a salva setările 1C în codul de limbă 1C:
Setări Storage.StorageName.Save();

Când adăugați propriul stocare de setări 1C la configurație, trebuie să scrieți handlere pentru încărcarea și salvarea valorilor în limbajul 1C, altfel stocarea nu va funcționa.

De fapt, în aceste funcții scrieți singur codul pentru salvarea valorii (într-o stocare standard sau într-un fișier sau într-un director sau într-un registru de informații etc.) și încărcarea valorii.

Salvarea setărilor utilizatorului este un punct destul de important în orice sistem informațional, deoarece uneori configurarea anumitor funcționalități necesită mult timp și efort.

În special pentru aceasta, în platforma 1C au fost create 2 obiecte - stocare generală standard și stocare setări 1C, create de dezvoltator în etapa de dezvoltare a configurației.

Această funcție a apărut împreună cu versiunea 8.2 a platformei 1C. Vă permite să salvați orice date de setări în contextul unui obiect definit de utilizator.

• Puteți salva setările utilizând metoda General Settings Storage. Salvați().
• Apoi, pentru a-l citi, trebuie să utilizați General Settings Storage. Descarca() cu aceiași parametri.
• Dacă o setare nu mai este relevantă, aceasta poate fi ștearsă folosind metoda General Settings Storage. Șterge().
• De asemenea, în contextul unui obiect, puteți obține o listă de setări salvate folosind metoda General Settings Storage. GetList().

Obțineți 267 de lecții video pe 1C gratuit:

Setările salvate sunt stocate într-un tabel rezumat separat al bazei de date.

Stocarea setărilor creată în configurator

Depozitul de setări poate fi creat de către dezvoltator însuși în configuratorul 1C:

În loc de depozite standard, puteți aloca un depozit creat de dezvoltator. Această setare este făcută în paleta de proprietăți de configurare:

Crearea propriilor setări poate fi necesară dacă:

• este necesară migrarea setărilor între baze de date;
• Este necesar controlul de referință al acestor setări.

Utilizarea stocărilor de setări în rapoarte și procesare 1C

Mecanismul de setări utilizator

Pentru a salva informații despre setările utilizatorului care trebuie salvate între sesiunile de lucru, platforma implementează stocarea setărilor.

Există două tipuri de magazine de setări:

1. Stocarea standard este stocarea folosită de sistem în mod implicit și stochează datele în tabelele de sistem ale bazei de informații.
2. Magazinele de setări sunt obiecte speciale de metadate care descriu stocarea datelor într-un anumit obiect de bază de informații.

De exemplu, acest obiect poate descrie lucrul cu setările care sunt stocate în director.

Platforma folosește cinci depozite:

1. Stocare de sistem – în această stocare sistemul salvează toate setările posibile care sunt necesare pentru ca platforma să funcționeze. Aceste setări includ setări pentru dimensiunile formularelor, setări pentru tipărirea unui document foaie de calcul etc. O listă completă a setărilor salvate în stocarea sistemului este listată în Anexa B. Stocarea setărilor standard este întotdeauna utilizată ca stocare a setărilor de sistem. Adică, datele de stocare a sistemului sunt întotdeauna stocate în tabelul de sistem al bazei de informații.

2. Stocare setări generale – această stocare este destinată stocării diferitelor setări ale soluției de aplicație. Platforma în sine nu scrie nicio setare în acest spațiu de stocare. Acest spațiu de stocare trebuie utilizat de dezvoltator din limba încorporată pentru a salva/restaura setările aplicației utilizator.

3. Stocarea setărilor personalizate ale rapoartelor – setările personalizate ale raportului sunt plasate în acest spațiu de stocare.

4. Stocare variante de raportare – variantele de raport sunt plasate în acest stocare.

5. Stocare setări date formular – datele formularului sunt salvate în această stocare. Această stocare poate fi folosită, de exemplu, pentru a salva detaliile de procesare. În acest caz, puteți selecta stocarea individuală pentru fiecare raport și procesare.

Când dezvoltați o configurație, este posibil să vă definiți propriile magazine de setări pentru toate magazinele (cu excepția magazinului de sistem). Pentru a face acest lucru, trebuie să creați un obiect de stocare a setărilor în ramura corespunzătoare a arborelui metadate și apoi să îl specificați în proprietatea de configurare necesară. Proprietățile obiectului Configurare au aceleași nume ca și depozitele de mai sus.

Astfel, datele de stocare pot fi stocate atât în ​​tabelul de sistem al bazei de informații, cât și într-un obiect special al bazei de date, de exemplu, într-un director sau registru de informații. De exemplu, puteți crea un obiect de stocare a setărilor în configurație și puteți specifica în proprietatea de configurare că această stocare trebuie utilizată pentru a stoca setările de raport. Astfel, setările raportului vor fi salvate nu în tabelul de sistem, ci într-un obiect, de exemplu, într-un director, ceea ce face posibilă organizarea muncii cu setări comune de raport, implementarea unui sistem de drepturi, schimbul de setări etc.

Obiect metadate Setări Stocare

Obiectul de metadate de stocare setări este destinat să furnizeze stocarea setărilor de configurare a aplicației. Prin implementarea handlerelor de evenimente și crearea unei forme de obiect, mecanismul de lucru cu setările este modificat astfel încât locația de stocare a setărilor să se modifice (în loc de tabelele de sistem se folosesc obiecte speciale de configurare create de dezvoltator) și mecanismele vizuale. pentru lucrul cu setările.

Configurația poate defini un număr arbitrar de depozite de setări.

Metode și manipulatori

Obiectul SettingsStorageManager are o serie de metode care ridică evenimentele corespunzătoare. Astfel, definiția de gestionare a evenimentelor descrie logica pentru salvarea/încărcarea setărilor.

Metodele de stocare și manipulatorii folosesc următorii parametri:

• ObjectKey – o valoare de orice tip care este utilizată în magazin ca identificator pentru un obiect de configurare. De exemplu, platforma folosește numele complet al raportului pentru a identifica un raport.
• SettingsKey este o valoare de orice tip care este utilizată în depozit ca un identificator al obiectului de depozit care stochează setarea. Această tastă este utilizată în cazurile în care sunt stocate mai multe setări din care utilizatorul poate selecta.

În timpul dezvoltării unui depozit, dezvoltatorul determină în mod independent modul în care va fi identificat obiectul depozitului, determinând astfel tipul de parametru.

De exemplu, dacă setările sunt salvate într-un director, atunci câmpul Cod sau valoarea Link (a unui element de director) poate fi folosită ca cheie de setări.

• Setare – un obiect care conține setări. O valoare de orice tip care trebuie salvată ca setare. De exemplu, la salvarea setărilor de raport, va fi utilizat obiectul UserDataCompositionSettings, iar la salvarea datelor din formular, va fi folosit obiectul Conformitate.
• DescriptionSettings – valoare de tip DescriptionSettings. Un obiect special care conține informații de configurare. Conține o cheie de obiect, o cheie de setare și o vizualizare de setare.
• Utilizator – nume de utilizator. Dacă valoarea este Nedefinită, atunci trebuie utilizat numele de utilizator curent. În alte cazuri, conține numele utilizatorului pentru care doriți să preluați sau să salvați setările. Valoarea implicită este Nedefinită.

Obiectul Settings Storage oferă următoarele metode:

• Save() – folosit pentru a salva setarea.

Declanșează evenimentul SaveProcessing. Dacă handlerul de evenimente nu este implementat sau este gol, atunci acțiunea nu va fi efectuată.

• Load() – folosit pentru a obține setarea.

Declanșează evenimentul Load Processing. Dacă handlerul de evenimente nu este implementat sau este gol, atunci acțiunea nu va fi efectuată.

• GetDescription() – folosit pentru a obține o descriere a setării.

Declanșează evenimentul ProcessingReceiptDescription. Dacă handlerul de evenimente nu este implementat sau este gol, atunci acțiunea nu va fi efectuată.

• SetDescription() – folosit pentru a seta descrierea setării.

Declanșează evenimentul ProcessingSettingsDescription. Dacă handlerul de evenimente nu este implementat sau este gol, atunci acțiunea nu va fi efectuată.

Mai multe detalii despre parametrii metodei pot fi găsite în ajutorul încorporat.

Modulul de gestionare a obiectelor ar trebui să conțină handlere pentru următoarele evenimente:

• Save Processing – conține implementarea metodei Save(). În acest handler, este necesar să salvați setările pentru un obiect. De exemplu, într-un element de director.
• Load Processing – conține o implementare a metodei Load(). În acest handler, este necesar să obțineți setări de la un obiect. De exemplu, dintr-un element de director.
• ProcessingGetDescription – conține o implementare a metodei GetDescription(). În acest handler, trebuie să completați o descriere a setării pe baza proprietăților setării salvate. De exemplu, dintr-un element de director.
• ProcessingSetDescription – conține o implementare a metodei SetDescription(). În acest handler, trebuie să completați descrierea setării salvate din obiectul SettingsDescription transmis. De exemplu, într-un element de director.

Mai multe detalii despre parametrii de gestionare pot fi găsite în ajutorul încorporat.

Forme

Pe lângă descrierea manipulanților din magazinul de setări, este necesar să se definească formularele care vor fi folosite la salvarea și selectarea setărilor de către utilizator.

Când utilizatorul aplică comenzile de salvare sau încărcare a setărilor, sistemul primește formularul corespunzător al obiectului de stocare a setărilor și îl afișează pe ecran.

De exemplu, la salvarea setărilor raportului, sistemul va folosi formularul pentru salvarea obiectului de metadate care este specificat ca stocare a setărilor raportului (direct pentru raportul în sine sau pentru întreaga configurație). În acest caz, următorii parametri vor fi trecuți în formular:

• Object Key – identificatorul obiectului pentru care doriți să afișați o listă de setări. De exemplu, pentru un raport, acesta ar fi numele complet al raportului.
• CurrentSettingsKey – identificatorul setării care a fost curentă de unde este apelat formularul pentru salvarea sau restaurarea setărilor. De exemplu, acesta ar putea fi ID-ul setării curente a raportului.
• StandardSettings – o listă de valori care conține setări standard. De exemplu, pentru a selecta o opțiune de raport, această listă conține o listă de opțiuni și setări standard descrise în schema de prezentare a datelor raportului. Acest parametru este transmis doar formularului de încărcare.

Când creați un formular folosind designerul, parametrii de mai sus vor fi adăugați automat la lista de parametri ai formularului.

Formularele ar trebui să utilizeze parametrii trecuți și să filtreze lista de setări în consecință. Astfel, ar trebui să afișați doar setările pentru obiectul de setări specificat în parametrul ObjectKey (de exemplu, un raport).

Dacă utilizatorul a selectat o setare, atunci rezultatul formularului ar trebui să fie o valoare de tip SelectSettings. Această valoare, în proprietatea SettingsKey, ar trebui să conțină cheia setării selectate (de exemplu, codul unui element de director sau alt parametru care identifică setarea), iar proprietatea Additional Properties trebuie să conțină informații suplimentare pe care utilizatorul le-ar putea specifica în formă.

Închidere(NewSettingsSelection(StoredSettingsKey));

Stocarea setărilor standard

Stocarea setărilor standard este reprezentată în limbajul încorporat de obiectul StandardSettingsStorageManager. Acest obiect implementează același set de metode ca obiectul Settings StorageManager și, în plus, implementează următoarele metode:

• GetList() – metodă de obținere a unei liste de setări pentru obiectul de setări selectat,
• Delete() – șterge o anumită setare a obiectului de setare selectat.

Stocarea standard salvează setările în tabelele de sistem ale bazei de informații.

Magazinul de setări de sistem acceptă un șir atât ca cheie pentru obiect de setare, cât și ca cheie pentru setare.

Ca setări, depozitul de sistem acceptă orice valoare care poate fi plasată în depozitul de valori.

Se salvează setările formularului

Dezvoltatorul poate controla salvarea datelor din formulare gestionate în setări. Pentru a face acest lucru, atunci când dezvoltă un formular, trebuie să folosească următoarele proprietăți ale formularului:

• Salvarea datelor în setări – folosind această proprietate, dezvoltatorul formularului poate activa capacitatea de a salva datele formularului (cu posibilitatea de a selecta setarea în care vor fi salvate datele). Dacă formularul are salvarea activată, formularul oferă comenzi pentru a salva/încărca setările.
• Salvarea automată a datelor în setări – specifică necesitatea de a salva automat setările la închiderea formularului și de a le restaura la deschiderea formularului. Nu contează dacă lista de setări este folosită sau nu.
• Settings Storage – un link către spațiul de stocare al setărilor în care ar trebui să fie salvate setările. Dacă nu este specificat, este utilizată stocarea setărilor de date din formular specificată în configurație. Și dacă configurația nu specifică stocarea, atunci setările sunt salvate în stocarea setărilor standard.

Dacă capacitatea de a salva date este setată pentru formular, atunci trebuie să indicați ce detalii de formular trebuie salvate (coloana Salvare din fila Detalii a editorului de formulare).

La salvarea setărilor, numele complet al formularului este folosit ca cheie pentru obiect. În setări, este salvat un obiect de tip Compliance, în care căile către detaliile salvate sunt folosite ca chei, iar valorile acestora (detaliile) sunt folosite ca valori.

Pentru procesarea suplimentară de salvare și încărcare, formularul are următorii handlere:

• La salvarea datelor în setări pe server, un obiect (de tip de conformitate) în care vor fi salvate setările este transmis acestui handler. Obiectul conține deja valorile detaliilor care trebuiau salvate. În acest handler, puteți adăuga programatic informații suplimentare la obiectul setări. De exemplu, plasați selecția în atributul setări.
• Când se încarcă date din setări pe server - un obiect din care setările au fost deja încărcate este transmis acestui handler. Aceasta este corespondența în care se află valorile detaliilor. Acest handler vă va permite să vă încărcați propriile proprietăți din mapare. De exemplu, restabiliți parametrii de selecție.

Se salvează setările raportului

Obiectele raport și raport extern au proprietăți de metadate Variant Storage și Settings Storage. Aceste proprietăți indică în ce opțiuni de stocare și, respectiv, setările de raport ar trebui salvate. Dacă stocările nu sunt specificate, atunci stocările specificate în proprietățile de configurare sunt utilizate.

Formularul de raport oferă comenzi pentru salvarea și încărcarea opțiunilor și setărilor raportului.

Pentru procesarea suplimentară a salvării și încărcării setărilor și opțiunilor pentru rapoarte, extensia formularului de raportare are următorii handlere:

• La salvarea unei opțiuni pe server – setările pentru aspectul datelor care vor fi salvate sunt transmise acestui handler. În acest handler, puteți adăuga programatic informații suplimentare la obiectul setări.
• WhenLoadingVariantOnServer – acestui handler primește un obiect de setări din care varianta de raport a fost deja încărcată. În acest handler, puteți citi informații suplimentare din obiectul setări.
• La salvarea setărilor utilizatorului pe server – setările de utilizator ale raportului sunt transferate la acest handler, care va fi salvat. În acest handler puteți adăuga informații suplimentare la setări.
• Când se încarcă UserSettings pe server - un obiect de setări este transmis acestui handler, care conține setările utilizatorului deja încărcate. În acest handler, puteți citi informații suplimentare din obiectul setări.

Dacă trebuie să salvați unele informații suplimentare în setările de compoziție a datelor sau setările personalizate de compoziție a datelor, puteți utiliza proprietățile AdditionalProperties ale obiectelor DataCompositionSettings și CustomDataCompositionSettings. Proprietatea AdditionalProperties este un obiect de tip Structure.

Procedura de dezvoltare a unui depozit de setări

1. Se stabilește ce stocare (vezi începutul capitolului) va fi folosită. De exemplu, vom implementa o stocare a setărilor datelor din formularul de configurare.

2. Se stabilește o listă de obiecte de metadate care vor folosi acest depozit și se determină o listă de informații stocate, structura și tipurile acesteia. Aceste informații ne vor ajuta să alegem obiectul de metadate potrivit în ale cărui date vor fi stocate setările noastre.

3. Pe baza informațiilor de la pasul 2, se creează un obiect (și structura acestuia) care va stoca setările. Lasă setările noastre să fie stocate în elemente de director. Deoarece în cazul nostru structura datelor stocate este extrem de eterogenă, nu are rost să implementăm un set separat de atribute pentru stocarea setărilor fiecărui formular, astfel încât setările vor fi stocate într-un atribut de director de tipul Value Storage.

4. Este creat un obiect de tip Settings Storage și pentru acesta sunt implementate formularele de salvare și încărcare. Astfel, oferim interactivitate la salvarea și restabilirea setărilor.

5. Pentru obiectul de stocare a setărilor creat, sunt implementați handlere de evenimente legate de salvarea și restaurarea setărilor. Dacă nu efectuați această operație, operațiunile reale de citire/scriere a setărilor nu vor avea loc. Pentru a rezolva această problemă, trebuie să implementați gestionatorii de evenimente SaveProcessing și LoadProcessing în modulul obiectului creat de tip SettingsStorage.

6. În obiectele selectate la pasul 2 (sau în proprietățile de configurare), se completează proprietățile corespunzătoare, indicând astfel obiectelor în care depozite vor fi stocate setările. În exemplul nostru, este necesar să completați proprietatea de configurare Form data settings storage cu un link către obiectul creat la pasul 4.

7. Dacă este necesar, implementați handlere de evenimente legate de salvarea și restaurarea setărilor în acele obiecte de aplicație unde este necesar.

Anexa B. Setări salvate de platformă în magazinele de setări

Aplicația descrie setările care sunt salvate automat de platformă în stocarea sistemului.

Stocare: opțiuni de raportare

• Configurare: opțiuni de raportare.
  • Cheia obiect este numele complet al raportului. De exemplu: Raport.Vânzări.
  • Tasta de setare este identificatorul text al variantei. De exemplu: vânzări pe regiune.
  • Tipul de valoare stocată este DataCompositionSettings.

Stocare: setări de raport

• Setări: setări de raport.
  • Cheia obiect este un șir de text format din numele complet al raportului, caracterul „/” și cheia de variantă. De exemplu: Report.Sales/SalesByRegions.
  • Tasta de setare – identificatorul text al setării. Exemplu: MyClients.
  • Tipul de valoare stocată este UserSettingsLayoutData.

Stocarea datelor din formular

• Setare: valorile câmpului de formular.
  • Cheia obiectului este numele complet al formularului. De exemplu: Processing.Data Upload.Form.MainForm.
  • Cheie de setare – identificatorul text al valorilor salvate. Exemplu: Încărcați în VSberbank.

Stocarea sistemului

• Setare: cheia versiunii curente a raportului.
  • Cheia obiect este un șir de text compus din numele complet al raportului și șirul „/CurrentVariantKey”.
    • De exemplu: Report.Sales/CurrentVariantKey.
• Setare: Tasta de setare a raportului curent.
  • Object Key – este o valoare șir formată din numele complet al raportului, cheia variantei raportului (sub formă de șir) și textul „CurrentUserSettingsKey”, separate prin caractere „/”.
    • De exemplu: Report.Sales/SalesByRegion/KeyCurrentUserSettings.
  • Tasta de setare este un șir gol.
  • Tipul valorii stocate este o valoare arbitrară care conține cheia variantei curente.
• Setare: setări pentru varianta de raport la închiderea raportului sau schimbarea variantei.
  • Object Key este o valoare șir care constă din numele complet al raportului, cheia variantei raportului (sub formă de șir) și textul „CurrentUserSettings”, separate prin caractere „/”.
    • De exemplu: Report.Sales/SalesByRegion/CurrentUserSettings.
  • Tasta de setare este un șir gol.
  • Tipul valorii stocate – UserDataCompositionSettings
• Setare: cheia pentru setările curente ale câmpului formularului.
  • Cheia obiect este o valoare șir formată din numele complet al formularului și textul „CurrentDataSettingsKey”, separate prin caracterul „/”.
    • De exemplu: Processing.Data Upload.Form.MainForm/Key of CurrentDataSettings
  • Tasta de setare este un șir gol.
  • Tipul valorii stocate este o valoare arbitrară care conține cheia setării curente.
• Setare: valorile câmpului de formular la închidere.
  • Cheia obiect este o valoare șir formată din numele complet al formularului și textul „CurrentData”, separate printr-un caracter „/”.
    • De exemplu: Processing.Data Upload.Forms.MainForm/CurrentData.
  • Tasta de setare este un șir gol.
  • Tipul de valoare stocată este Potrivire. Cheia de potrivire este calea textului către atributul de date stocat, iar valoarea este valoarea atributului.
• Setări: Configurați afișarea formularului.
  • Cheia obiectului este o valoare șir formată din numele complet al formularului și textul „FormSettings”, separate de un caracter „/”.
    • De exemplu: Processing.Data Upload.Form.MainForm/FormSettings.
  • Tasta de setare este un șir gol.
  • Tipul de valoare salvată este FormSettings. Un obiect fără proprietăți și metode.
• Personalizare: Dimensiunile formularului și controalelor.
  • Cheia obiectului este o valoare șir formată din numele complet al formularului și textul „WindowSettings”, separate de un caracter „/”.
    • De exemplu: Processing.Data Upload.Form.MainForm/Window Settings.
  • Tasta de setare este un șir gol.
  • Tipul de valoare salvată este Setări fereastră. Un obiect fără proprietăți și metode.
• Setare: favorite.
  • Cheia obiect este „Common/UserWorkFavorites”.
  • Tasta de setare este un șir gol.
  • Tipul de valoare stocată este Favoritele de lucru ale utilizatorului. Pentru mai multe detalii, consultați secțiunea „Legături favorite ale utilizatorilor” din capitolul „Servicii de navigare”.
• Configurare: setări globale ale interfeței de comandă.
  • Cheia obiect este o valoare șir, una dintre opțiuni:
    • numele complet al fragmentului de interfață de comandă și „/ActionsPanel” (“/ActionsPanel”);
    • numele complet al fragmentului de interfață de comandă și „/NavigationPanel/CommandInterfaceSettings” (“/NavigationPanel/CommandInterfaceSettings”);
    • „Common/PartitionPanel/CommandInterfaceSettings”.
    • De exemplu: Subsistem.Vânzări/Panou de navigație/Us-trei din interfața de comandă.
  • Tasta de setare este un șir gol.
  • Tipul de valoare salvat este Setări interfețe de comandă. Un obiect fără proprietăți și metode.
• Setări: setări desktop.
  • Cheia obiect este „Common/DesktopSettings”.
  • Tasta de setare este un șir gol.
  • Tipul de valoare salvată este Setări desktop. Un obiect fără proprietăți și metode.
• Setări: setări pentru tipărirea unui document foaie de calcul.
  • Cheia obiect este o valoare șir formată din „Common/SpreadsheetDocumentPrintSettings/” și numele parametrilor de imprimare. De exemplu:
    • Generale/Setări de tipărire a documentului tabelar/Factură.
  • Tasta de setare este un șir gol.
  • Tipul de valoare care se salvează este Setări de imprimare a documentului tabelar. Un obiect fără proprietăți și metode.

Obiecte configuratoare pentru lucrul cu setări

meniu Ajutor/Ajutor Cuprins/1C Enterprise/Limba încorporată/Context global/Proprietăți/Setări Stocare

meniu Ajutor/Ajutor Cuprins/1C Enterprise/Limba încorporată/Obiecte aplicație/Arhivele de setări

Contextul global

Contextul global conține o serie de proprietăți (obiecte globale) utilizate pentru a lucra cu setări.

Utilizare: Numai citire.

Tip: StandardSettingsStorageManager; Setări StorageManager.

Proprietățile contextului global:

• StorageSettings. Proiectat pentru a accesa depozitele de setări.
• Stocarea opțiunilor de raportare. Conține spațiu de stocare pentru stocarea opțiunilor de raport.
• Stocare FormsDataSettings. Conține stocare pentru stocarea setărilor datelor din formular.
• Setări generale Stocare. Conține spațiu de stocare folosit pentru a salva setările generale.
• . Conține spațiu de stocare pentru stocarea setărilor rapoartelor.
• Stocare pentru setările sistemului. Conține spațiu de stocare în care sunt salvate setările sistemului.

Arhivele de setări

Această secțiune descrie obiectele aplicației utilizate pentru a lucra cu depozitul de setări.

StandardSettingsStorageManager

• Sarcină
• GetList
• Salvați
• Șterge

Descriere: un magazin de setări care stochează setările în tabelele de sistem.

Disponibilitate: client, server, conexiune externă.

Vedeți și: Context global, proprietatea de stocare a setărilor sistemului

SetăriStoragesManager

Elemente de colecție: Setări StorageManager

Pentru un obiect, este posibil să parcurgeți colecția folosind operatorul Pentru fiecare... Din... Buclă. Când accesați cu crawlere, sunt selectate magazinele de setări.

Este posibil să accesați stocarea setărilor folosind [...] operatorul. Numele de stocare, așa cum este specificat în configurație, este transmis ca argument.

Proprietăți:

• <Имя хранилища> (<Имя хранилища>)

Descriere: O colecție de depozite de setări definite în configurație.

Disponibilitate: client, server, conexiune externă.

Vedeți și: Context global, Proprietatea de stocare a setărilor

Setări StorageManager.<Имя хранилища>(SettingsStorageManager.<Имя хранилища>)

• Sarcină
• GetTemplate
• Obțineți descriere
• GetForm
• GetLoadForm (GetLoadForm)
• GetSaveForm
• Salvați
• SetDescription

• LoadProcessing
• GetDescriptionProcessing
• Salvare procesare
• ProcessingSettingsDescriptions (SetDescriptionProcessing)

Descriere: un obiect care oferă acces la o stocare de setări de un anumit tip.

Disponibilitate: client, server, conexiune externă.

Vezi și: Setări StorageManager, proprietate<Имя хранилища>

SettingsChoice

Proprietăți:

• Tasta Setări

Designeri:

• Pe baza cheii

Descriere: Conține informații despre setarea selectată de utilizator.

Disponibilitate: client, server, conexiune externă, client subțire, client web.

Descrierea setărilor (SettingsDescription)

Proprietăți:

• Proprietăți suplimentare
• Tasta Setări
• ObjectKey
• Utilizator
• Prezentare

Descriere: conține informații despre descrierea setării.

Disponibilitate: client, server, conexiune externă.

Vezi si:

• Setări StorageManager, metoda GetDescription
• Setări StorageManager, metoda SetDescription
• Setări StorageManager, eveniment ProcessingReceiptDescriptions
• Setări StorageManager, eveniment ProcessingSettingsDescriptions
• StandardSettingsStorageManager, metoda GetDescription
• StandardSettingsStorageManager, metoda Salvare
• StandardSettingsStorageManager, metoda SetDescription
• Setări StorageManager, metoda de salvare
• Setări StorageManager, eveniment de procesare de salvare

Utilizarea formularelor de salvare și încărcare

Această secțiune descrie mecanismele de utilizare a formularelor de salvare și încărcare.

Salvare formular

Parametrii formularului:

• ObjectKey

Descriere: Formular folosit pentru salvarea setărilor. Rezultatul formularului ar trebui să fie o valoare de tip SelectSettings sau o valoare Nedefinită dacă utilizatorul a refuzat să salveze setarea.

Disponibilitate: client.

Descărcați formularul

Parametrii formularului:

• ObjectKey
• CurrentSettingsKey
• StandardSettings

Descriere:

Formular folosit pentru a încărca setările.

Rezultatul formularului (valoarea transmisă metodei Close()) trebuie să fie o valoare de tip SelectSettings sau o valoare Undefined dacă utilizatorul a refuzat să încarce setarea.

Disponibilitate: client.

Caracteristici de utilizare a mecanismului de setări

Din câte se poate înțelege din descriere, se pot distinge două părți ale mecanismului:

• Utilizarea obiectelor aplicației de stocare de personalizare pentru a salva/restaura setările
• Înlocuirea obiectelor încorporate cu cele definite în configurare (plugin de model)

Nu este foarte clar de ce este necesar un mecanism pentru suprascrierea stocării standard, dar poate putem veni cu ceva... De exemplu, sensibilitatea contextului setărilor.

În context global, există întotdeauna un set de obiecte manager de stocare de diferite tipuri de setări, care sunt utilizate de sistem și/sau dezvoltatori.

• Stocarea opțiunilor de raportare
• Stocare FormsDataSettings
• Setări generale Stocare
• Stocarea rapoartelor UserSettings
• Stocare pentru setările sistemului

Salvarea/restaurarea setărilor utilizatorului

În loc de SaveValue: SystemSettings Storage.Save ("Compania de lucru", SessionParameters.Compania de lucru);În loc de RestoreValue: WorkCompany = Setări sistem Storage.Load("WorkCompany");