1c úložiště dat dočasné úložiště. Dočasné úložiště. Jak se jim říká?
V úložišti hodnot lze uložit téměř jakoukoli informaci, např.
... obrázky (fotky):
// na tomto místě zobrazí vše... Form Elements.PictureField1.Picture = Storage.Get(); CurrentImage.Write();
...tabulkový dokument:
TabDoc=Nový tabulkový dokument; TabDoc.Output(FormElements.TabularDocumentField1); Storage=NewValueStorage(TabDoc); Napsat();
Konec procedury
Postup RestoreFromStoragePress (prvek)
TabDoc=Storage.Get(); Pokud TabDoc<>Nedefinováno ThenFormElements.TabularDocumentField1.Output(TabDoc); endIf;
Konec procedury
...libovolné soubory (binární data):
Osmička podporuje kompresi dat umístěných v úložišti:
... externí zpracování a reportování:
CompressionRate = NewDataCompression(9); //9 maximum PropsStorageType = New StorageValues(New BinaryData("c:\reports\report.epf", Kompresní poměr));
Konec procedury
Postup StartProcessingFromStorage(PropsStorageType)
TemporaryFileName = TemporaryFileDirectory()+"report.epf"; BinaryData = PropsStorageType.Get(); BinaryData.Write(TemporaryFileName); ExternalProcessing = ExternalProcessing.Create(TemporaryFileName); ExternalProcessing.GetForm().Open();
Konec procedury
Práce s úložištěm
Pokud se jednalo o binární data, lze je obnovit z úložiště hodnot pomocí metody Get a zapsat do souboru pomocí metody Write().
BinaryData = Storage.Get();
BinaryData = Úložiště;
endIf; BinaryData.Write(NázevSouboru);
Pokud to byl například dokument aplikace Word (soubor doc nebo jiný registrovaný typ souboru), lze jej otevřít takto:
Chcete-li vymazat pole typu Úložiště hodnoty, musíte mu přiřadit Nedefinováno:
Práce se soubory a obrázky ve vestavěném jazyce 1C:Enterprise 8
Účel
Spravovaná aplikace implementuje nový mechanismus pro práci se soubory. Poskytuje výměnu souborů mezi infobází a klientskou aplikací. Zvláštností tohoto mechanismu je, že je navržen pro použití v tenkém klientovi a webovém klientovi a je navržen s ohledem na omezení práce se soubory uložená webovými prohlížeči.
Mechanismus je soubor metod, které lze použít k umístění dat uložených lokálně na počítači uživatele do dočasného úložiště informační báze, přenosu těchto informací z dočasného úložiště do databáze a jejich přijetí zpět do počítače uživatele. Nejčastějšími aplikačními problémy řešenými tímto mechanismem je ukládání doprovodných informací, například obrázků zboží, dokumentů souvisejících se smlouvami atd.
Metoda Rozsah
Dočasné úložiště
Dočasné úložiště je specializovaná oblast informační základny, do které lze umístit binární data. Hlavním účelem je dočasné uložení informací během interakce klient-server před jejich přenesením do databáze.
Potřeba dočasného úložiště vyvstává, protože operační model webového prohlížeče vyžaduje, aby uživatelem vybraný soubor byl přenesen přímo na server bez možnosti jeho uložení na klientovi. Když je soubor přenesen, je umístěn do dočasného úložiště a lze jej pak použít při zápisu objektu do databáze.
Nejtypičtějším aplikačním úkolem řešeným dočasným úložištěm je poskytování přístupu k souborům nebo obrázkům předtím, než je objekt zaznamenán v informační databázi, například ve formě prvku.
Soubor nebo binární data umístěná v úložišti jsou identifikována jedinečnou adresou, kterou lze později použít při operacích zápisu, čtení nebo mazání. Tato adresa je dána metodami pro zápis souboru do dočasného úložiště. Samostatná metoda ve vestavěném jazyce umožňuje určit, zda je předaná adresa adresou ukazující na data v dočasném úložišti.
Informační základna
Mechanismus umožňuje přístup k binárním datům uloženým v atributech typu Value Storage.
Stejně jako v případě dočasného úložiště je přístup k informacím možný prostřednictvím speciální adresy. Můžete jej získat speciální metodou předáním odkazu na objekt nebo vstupního klíče informačního registru a názvu atributu. V případě tabulkové části je navíc nutné přenést index řádku tabulkové části.
Metody pro práci se soubory mají omezení při práci s detaily infobáze. Pro ně je na rozdíl od dočasného úložiště dostupné pouze čtení informací, nikoli však jejich zápis nebo mazání.
Popis metod práce se soubory
Ukládání dat do dočasného úložiště
Nejtypičtější scénář pro použití tohoto mechanismu zahrnuje počáteční umístění uživatelských dat do dočasného úložiště. Existují dvě metody: PlaceFile() a PlaceFileInTemporaryStorage().
První metoda, PlaceFile(), umístí soubor z místního souborového systému do dočasného úložiště. Metoda může přijmout cílovou adresu v úložišti. Pokud není definován nebo je prázdný, vytvoří se nový soubor a metoda vrátí svou adresu prostřednictvím odpovídajícího parametru.
Pokud je parametr, který určuje interaktivní režim provozu, True, pak metoda zobrazí standardní dialogové okno pro výběr souboru, ve kterém můžete vybrat soubor, který chcete uložit do úložiště. V tomto případě metoda také vrátí adresu vybraného souboru.
Výsledkem je, že metoda vrátí hodnotu False, pokud uživatel interaktivně odmítl provést operaci v dialogovém okně pro výběr souboru. Metoda je dostupná pouze u klienta.
Druhá metoda, PlaceFileInTemporaryStorage(), je podobná předchozí, s tím rozdílem, že je dostupná na serveru a data, která mají být zapsána do dočasného úložiště, nejsou reprezentována jako cesta v systému souborů, ale jako proměnná typu Binární data. Podobně, pokud není zadána žádná cílová adresa, vytvoří se v úložišti nový soubor. Jeho adresa je vrácena jako výsledek funkce.
Načtení souboru z dočasného úložiště
Při zápisu objektu do infobáze možná budete muset extrahovat data z dočasného úložiště a umístit je například do atributu. K tomu existuje odpovídající serverová metoda - GetFileFromTemporaryStorage(). Tato metoda načítá data z dočasného úložiště a jako výsledek je vrací. Chcete-li to provést, musíte zadat adresu v dočasném úložišti. Tato adresa je vrácena výše popsanými metodami PlaceFile() a PlaceFileInTemporaryStorage(), pokud jsou úspěšně provedeny.
Odstranění souboru z dočasného úložiště
Po uložení dat do podrobností lze soubor v dočasném úložišti smazat. Pro tento účel existuje metoda DeleteFileFromTemporaryStorage(), která smaže soubor z dočasného úložiště. Metoda bere jako parametr adresu souboru v dočasném úložišti. Dostupné na serveru.
Kontrola adresy pro dočasné uložení
Adresa souboru může označovat dočasné úložiště i podrobnosti v informační databázi. Pro kontrolu jeho typu existuje metoda This isTemporaryStorageAddress().
Zkontroluje, že předaná adresa je adresa směřující do obchodu. Vrátí hodnotu True, pokud adresa ukazuje na dočasné úložiště. Metoda je dostupná na serveru.
Příjem adresy rekvizit
Poté, co jsou data umístěna do podrobností v infobázi, možná k nim budete muset přistupovat pomocí souborových metod.
Než ale obdržíte data, například z nemovitosti, musíte získat adresu této nemovitosti. Pro tento účel existuje metoda GetFileAddressInInformationBase().
Jeho účelem je vrátit adresu souboru v infobázi podle původních parametrů. Chcete-li to provést, musíte předat klíč objektu (může to být buď odkaz na objekt nebo klíč položky registru informací) a název atributu. Pokud potřebujete získat adresu souboru uloženého v atributu tabulkové části, musíte před název atributu v parametru určujícím název atributu přidat název tabulkové části a tečku „.“. Metoda je dostupná jak na klientovi, tak na serveru.
Načtení souboru z infobáze
Metoda GetFile() přijme soubor z infobáze a uloží jej do lokálního systému souborů uživatele. První parametr určuje adresu souboru v rekvizitách nebo dočasném úložišti souborů. Druhý parametr určuje cílové umístění výsledného souboru. V neinteraktivním režimu musíte zadat cestu. V interaktivním režimu je parametr nepovinný.
Ve výchozím nastavení se metoda provádí v interaktivním režimu, to znamená, že poslední parametr je True. To znamená, že se zobrazí dialogové okno, ve kterém můžete určit akci s přijatým souborem: spustit jej nebo uložit na uživatelem určené místo. Pokud je aktivní interaktivní režim a není zadán parametr Cesta k souboru cílového disku, operace otevření souboru není dostupná. Vrátí booleovskou hodnotu. False znamená, že uživatel zvolil zrušení operace v dialogovém okně interaktivního uložení souboru.
Příklad použití souborových metod
Proměnná SelectedName; VariableTemporaryStorageAddress; If PutFile(TemporaryStorageAddress, SelectedName, True) Then Object.FileName = SelectedName; PlaceObjectFile(TemporaryStorageAddress); endIf;
Konec procedury
// Kopírování souboru z dočasného úložiště do adresáře // atribut, záznam objektu, smazání souboru z dočasného // úložiště &Na serveru Postup Umístění souboru objektu (adresa dočasného úložiště)
Element adresáře = Form AttributesValue("Object"); BinaryData = GetFileFromTemporaryStorage(TemporaryStorageAddress); Data adresáře Element.File = NewValueStorage(BinaryData); FilePathOnDisk = Nový soubor(DirectoryItem.FileName); Adresář Item.FileName = FilePathOnDisk.Name; Element adresáře.Write(); Upraveno = False; DeleteFileFromTemporaryStorage(TemporaryStorageAddress); ValueВFormAttributes(prvek adresáře, "Objekt");
Konec procedury
// Načtení souboru z rekvizit a jeho uložení // na místní disk v interaktivním režimu &Na klientské procedurě ReadFileAndSaveToDisk()
Adresa = GetFileAddressInInformationBase(Object.Link, "FileData"); GetFile(Address, Object.FileName, True);
Konec procedury
Podpora adres v poli obrázku
Ovládací prvek Picture Field podporuje zobrazení obrázku určeného adresou souboru v dočasném úložišti nebo v databázi.
Chcete-li to provést, musíte nastavit atribut typu řetězce ve vlastnosti Data prvku formuláře. Hodnota tohoto atributu bude interpretována jako adresa obrázku.
Příklad
PlaceFile(PictureAddress,True)
Picture.Data = AddressPictures
Omezení při práci s webovým klientem
Činnost popsaného mechanismu při použití webového klienta má určitá omezení. Tato omezení souvisejí s modelem zabezpečení prohlížeče. Klient tedy například nemůže samostatně uložit soubor do lokálního souborového systému, to znamená, že je k dispozici pouze interaktivní verze klientských metod PlaceFile() a GetFile(). Při pokusu o použití neinteraktivního režimu je vyvolána výjimka. Dialogová okna, která se zobrazují interaktivně, jsou specifická pro váš typ prohlížeče.
Funkce při práci s Value Storage na klientovi
Problém:
Pokud má dokument v tabulkové části atribut typu Úložiště hodnoty, zpomaluje otevírání formuláře dokumentu, pokud tento atribut obsahuje velká data.
Předpokládaný důvod:
Možná, že při otevírání formuláře se klientovi neodešle odkaz na data umístěná ve Value Store, ale data samotná.
Řešení
- Ve vlastnostech atributu tabulky formuláře je příznak "Vždy použít". Pokud je nastaveno, obsah pole se vždy přenáší mezi serverem a klientem – např. při otevírání formuláře. Tento příznak musí být deaktivován, ale musí to být zohledněno v kódu, protože ve výchozím nastavení nebude mít toto pole na klientovi žádnou hodnotu. Příklad lze nalézt v 1C:Archive.
Ještě lepší je použít dočasné úložiště pro přenos souborů mezi klientem a serverem.
Materiál byl aktualizován, aby odpovídal Drupalu 8.7.0+
Temp store(dočasné úložiště) - umožňuje dočasně uložit jakákoli data. Toto je druh úložiště dat v $_SESSION, protože toto úložiště je obvykle spojeno s určitým uživatelem. Nepoužívá však $_SESSION a vše ukládá uvnitř systému (v databázi).
Jádro má dvě služby pro dočasné úložiště, tempstore.private a tempstore.shared. Fungují identicky, ale soukromé vždy ukládají data pro konkrétního uživatele. To znamená, že volání jednoho klíče ze soukromého úložiště vrátí různá data pro každého uživatele. Sdílené je přístupné každému uživateli.
Rozsah použití těchto služeb a jejich ukládání může být velmi široké. Například uložit některé dočasné hodnoty formulářů, a pokud je uživatel neuložil, lze je z tohoto úložiště obnovit, například pro některé formuláře REST, a dokonce vhodné pro běžné. Obecně na co máte dostatek fantazie nebo úkolů. To lze například použít pro některé formuláře ovládané mimo Drupal, například v React nebo Vue.
Hodnoty v těchto úložištích žijí ve výchozím nastavení 604 800 sekund (1 týden), poté jsou automaticky smazány.
Chcete-li tuto hodnotu změnit. Budete muset připojit například sites/default/services.yml a předefinovat jej:
Parametry: # 10 sekund tempstore.expire: 10
Ale to by se z dobrého důvodu stávat nemělo.
Podívejme se na možnosti jednotlivých úložných zařízení; ačkoli jsou podobné, jsou mírně odlišné.
tempstore.private - soukromé úložiště
Toto úložiště je soukromé pro každého uživatele.
tempstore.shared - sdílené úložiště
Toto úložiště je sdílené a může obsahovat data společná pro všechny uživatele.
Úložiště má následující metody:
- get($key) : Načte hodnotu z obchodu podle jejího klíče. Pokud nejsou žádná data, vrátí hodnotu NULL, pokud existují, vrátí hodnotu.
- getIfOwner($key) : Načte hodnotu z obchodu podle jejího klíče. Pokud nejsou žádná data nebo data nebyla zapsána pod aktuálním uživatelem, vrátí NULL, pokud jsou a byla zapsána pod aktuálním uživatelem, vrátí hodnotu.
- setIfNotExists($key, $value) : Zapíše hodnotu $value pod klíč $key do úložiště pouze v případě, že pro tento klíč aktuálně nejsou žádná data. Vrátí TRUE, pokud je zaznamenáno, FALSE, pokud data již byla zaznamenána.
- setIfOwner($key, $value) : Zapíše hodnotu $value pod klíč $key do úložiště pouze v případě, že aktuálně nejsou žádná data nebo je vlastníkem skutečných dat aktuální uživatel.
- set($key, $value) : Zapíše hodnotu $value pod klíč $key do úložiště.
- getMetadata($key) : Vrátí metadata pro konkrétní $key , bez dat. Jedná se o objekt obsahující vlastnost vlastníka, která ukládá hodnotu, kdo hodnotu vlastní, a aktualizovanou vlastnost - unixové časové razítko času, kdy byla tato hodnota zapsána.
- delete($key) : Smaže data spojená s daným $klíčem z úložiště.
- deleteIfOwner($key) : Smaže data spojená s daným $klíčem z úložiště, pouze pokud data patří aktuálnímu uživateli.
Jak se jim říká?
Malé příklady, jak je nazývat.
Prvním krokem je získání dočasného úložiště požadovaného úložiště, poté se z úložiště získá „kolekce“, kde jsou již data uložena pod potřebnými klíči. Název "kolekce" se zpravidla rovná názvu modulu.
Použijte Drupal\Core\TempStore\PrivateTempStoreFactory; použijte Drupal\Core\TempStore\SharedTempStoreFactory; /** @var PrivateTempStoreFactory $private_tempstore */ $private_tempstore = \Drupal::service("tempstore.private"); $my_private_storage = $private_tempstore->get("figurína"); $my_private_storage->set("uživatelské jméno", "Drupal"); /** @var SharedTempStoreFactory $shared_tempstore */ $shared_tempstore = \Drupal::service("tempstore.shared"); $my_shared_storage = $shared_tempstore->get("figurína"); $my_shared_storage->set("uživatelské jméno", "Drupal");
Příklad
V příkladu vytvoříme formulář na stránce /temp-store-form se dvěma poli, z nichž jedno bude ukládat zprávu do soukromého úložiště a druhé na veřejné.
Vytvořte formulář:
Src/FormWithTempStore.php
privateTempStore = $private_temp_store->get("dummy"); $this->sharedTempStore = $shared_temp_store->get("dummy"); ) /** * (@inheritdoc) */ public static function create(ContainerInterface $container) ( return new static($container->get("tempstore.private"), $container->get("tempstore.shared") ); ) /** * (@inheritdoc) */ veřejná funkce getFormId() ( return "form_with_temp_store"; ) /** * (@inheritdoc) */ veřejná funkce buildForm(pole $form, FormStateInterface $form_state) ( $form ["private_message"] = [ "#type" => "textarea", "#title" => $this->t("Soukromá zpráva"), "#required" => TRUE, "#description" => $ this->t("Tato hodnota bude soukromá pro každého uživatele."), "#default_value" => $this->privateTempStore->get("message"), ]; $form["shared_message"] = [ " #type" => "textarea", "#title" => $this->t("Sdílená zpráva"), "#required" => TRUE, "#description" => $this->t("Tato hodnota bude sdílen pro všechny uživatele."), "#default_value" => $this->sharedTempStore->get("message"), ]; $form["actions"] = ["#type" => "actions" $form["actions"]["submit"] = [ "#type" => "odeslat", "#value" => $this->t("Uložit"), ]; návrat $form; ) /** * (@inheritdoc) */ public function submitForm(pole &$form, FormStateInterface $form_state) ( $this->privateTempStore->set("message", $form_state->getValue("private_message")); $this->sharedTempStore->set("message", $form_state->getValue("shared_message")); ) )
Tisknout (Ctrl+P)
1C:Enterprise má mechanismus pro práci s dočasným úložištěm, které poskytuje uložení některých dat souvisejících s relací.
Navíc byl implementován mechanismus pro práci se soubory, který zajišťuje výměnu souborů mezi infobází a klientskou aplikací. Zvláštností tohoto mechanismu je, že je navržen pro použití v tenkém klientovi a webovém klientovi a je navržen s ohledem na omezení práce se soubory uložená webovými prohlížeči.
Dočasné úložiště
Jedná se o specializované úložiště informací, do kterého lze umístit hodnotu. Hlavním účelem je dočasné uložení informací během interakce klient-server před jejich přenesením do databáze. Mechanismus dočasného úložiště spolu s mechanismem pro manipulaci se soubory poskytuje sadu, kterou lze použít k umístění dat uložených lokálně na počítači uživatele do dočasného úložiště informační báze, přenosu těchto informací z dočasného úložiště do databáze a získání zpět do počítače uživatele. Nejčastějšími aplikačními problémy řešenými těmito mechanismy je uchovávání doprovodných informací, například obrázků zboží, dokumentů souvisejících se smlouvami apod. Mechanismy pro dočasné uložení a práci se soubory se často používají společně, ale lze je použít i samostatně.
Potřeba dočasného úložiště vzniká například proto, že model webového prohlížeče vyžaduje, aby byl uživatelem vybraný soubor přenesen přímo na server, aniž by bylo možné jej uložit na klienta. Když je soubor přenesen, je umístěn do dočasného úložiště a lze jej pak použít při zápisu objektu do databáze.
Dočasné úložiště můžete použít jako univerzální úložiště s řízenou životností dat:
1. Pokud při umístění dat do dočasného úložiště byla data vázána na určitou formu, pak životnost uložených dat závisí na předpokládané životnosti formy, ke které jsou data vázána. Když odstraníte objekt formuláře, z dočasného úložiště budou vymazány všechny s ním spojené informace.
2. Pokud při umístění dat do dočasného úložiště nebyla dokončena vazba na formulář, pak bude dočasné úložiště vymazáno v následujících případech:
- Při příštím vyžádání formuláře.
- Při dalším volání serveru ze společného modulu klienta.
- Pro kontextová a nekontextová volání klientů z formuláře.
- Při volání na straně serveru z příkazového modulu. Pokud je provedeno volání serveru za účelem umístění hodnoty do dočasného úložiště, neprovádí se žádné čištění. K vyčištění dojde poté, co volání dokončí svou práci.
To znamená, že můžete uložit jednu nebo více hodnot do dočasného úložiště a použít tuto hodnotu v příštím volání. Avšak po použití a před dokončením volání serveru bude umístěná hodnota automaticky odstraněna.
Nejtypičtějším aplikačním problémem řešeným dočasným úložištěm je poskytování přístupu k souborům nebo obrázkům předtím, než je objekt zaznamenán v informační bázi, například ve formě prvku. Při organizování takového přístupu se doporučuje přenášet data z klientských počítačů na server přesně jako soubory, bez předchozí „konverze“ do textového dokumentu, tabulkového dokumentu a podobných formátů systému 1C:Enterprise. Doporučuje se přenést soubor na stranu serveru a na straně serveru načíst data souboru do požadovaného
formátu systému 1C:Enterprise.
Data umístěná v úložišti jsou identifikována jedinečnou adresou, kterou lze později použít při operacích zápisu, čtení nebo mazání. Tato adresa je dána metodami pro zápis hodnoty do dočasného úložiště. Samostatná metoda ve vestavěném jazyce umožňuje určit, zda je předaná adresa adresou ukazující na data v dočasném úložišti.
Dočasné úložiště vytvořené v jedné relaci není přístupné z jiné relace. Výjimkou je možnost přenést data z úlohy na pozadí do relace, která iniciovala úlohu na pozadí, pomocí dočasného úložiště.
Burty . Nejpřijatelnějším způsobem skladování brambor, kořenové zeleniny a bílého zelí je stáčení. Hromada je podlouhlý násep, nakloněný na obou stranách a nahoře pokrytý izolačním materiálem. Vyrábí se pro uskladnění sklizně na jednu sezónu. Buřty mohou být mleté, když se brambory sypou na rovnou plochu, a polomleté, když se vykopávají mělké jámy. Popunautny (zasypaný) hromada. Pro takovou hromadu se vykope jáma o hloubce 25 cm ve směru od severu k jihu.Nejlepší šířka jámy pro sadbové brambory je 170-200 cm.Pro krátkodobé skladování zdravých brambor můžete vyrobit širší násep (až 4 m). Délka jámy může být libovolná, ale přesto je lepší, když není větší než 20-25 m. Výška násypu hromady při její šířce u základny 2 m může být 90- 100 cm.Brambory se obvykle skladují na několika hromadách na jednom místě. Vrtné místo je umístěno v blízkosti oblastí pro pěstování brambor v místě, které není zaplavováno deštěm a vodou z tání, nedaleko silnice. Podél středové osy jámy se vykope větrací kanál o šířce a hloubce 20-25 cm, který přesahuje jámu a je o 25 cm delší než kryt na konci límce. Část žlabu přesahující hranice jímky je nahoře pevně zakryta deskami, aby se do jímky a žlabu nedostala žádná zemina. U zemních límců je ventilační potrubí umístěno přímo na povrchu země a je vyrobeno ve formě příhradového stanu složeného ze samostatných 1,5metrových sekcí. Aby se sláma a země nedostaly do ventilačního potrubí, jeho konce jsou vyrobeny bez mezer. Pro zakrytí vzduchotechnického potrubí jsou předem připraveny příhradové sekce o délce 1,5 m a šířce 0,5 m. Sekci tvoří latě široké 2-3 cm a mezery mezi nimi 2-2,5 cm. navzájem. Výsledná průběžná ventilační mřížka zakrývá část kanálu umístěného pod produktem. Při tvoření kopečku brambor nebo jiných výrobků se dovnitř umisťuje límcový teploměr nebo speciálně vyrobená čtyřstěnná trubicová pouzdra o vnitřním průřezu 3x3 cm, do kterých se na konci tyče vkládají teploměry. Obojky jsou odvětrávány hřebenem a ventilačním potrubím. Hromady jsou pokryty slámou a zeminou. Sláma v plné tloušťce se pokládá v husté vrstvě zdola nahoru tak, aby se hřeben hromady překrýval. Poté je hromada po stranách posypána tenkou vrstvou zeminy. Hřeben hromady zůstává pod slaměným krytem až do prvního mrazu. Za deštivého počasí se dočasně přikryje střešní lepenkou nebo plastovou fólií. Při ochlazení brambor na +4 °C před nástupem stabilních mrazů jsou ventilační kanály pevně pokryty slámou a hromada je zcela pokryta zeminou. Při poklesu teploty v hromadách pod +1°C se hromady dodatečně přikryjí tepelně izolačními materiály - rašelinou, slámou, slaměným hnojem nebo sněhem. V případě silných sněhových srážek, které vedou k nadměrnému zakrytí hromad, jsou pravidelně odklízeny od sněhu.
Zákopové uložení . Tento způsob skladování vyžaduje 2x méně slámy nebo jiných tepelně izolačních materiálů než při skladování na hromadách. Příkopy se používají, když je podzemní voda hluboká. Hloubka a šířka příkopu je od 60-80 cm (v jižních oblastech) do 1,5-2 m (na Sibiři). Příkopy jsou nahoře pokryty vrstvou slámy: ve středních oblastech je to 30-40 cm, na Sibiři - až 70 cm. Poté se nalije vrstva země (od 40 do 70 cm v závislosti na zóně). Obvykle se používají různé typy příkopů: mělké, hluboké s ventilačními kanály, s vrstvou zeminy a bez vrstvy a obyčejné. Příkopy a piloty jsou vybaveny (přirozeným) jednoduchým větráním. Jeho hlavním účelem je chladit brambory a zeleninu na podzim. Princip fungování přívodního a odtahového větrání je založen na rozdílu tlaku vzduchu, tzn. na tahu pohybu vzduchu nahoru v důsledku rozdílu teplot ve stohu produktů a venku. Teplý vzduch, který je lehčí, odchází výfukovým potrubím a studený vzduch vstupuje přívodním potrubím. Větrací systém se skládá z přívodního a výfukového potrubí. Vstupní kanál probíhá uprostřed základny límce, na koncích jsou výstupy ven. V hromadách s bramborami a kořenovou zeleninou udělají drážku o průřezu 20x20 cm nebo 30x30 cm, překrytou mřížovinami, příčnými latěmi nebo klestí, aby jednotlivé kopie produktu nepropadaly. Tímto kanálem proudí do komína chladnější venkovní vzduch gravitací. Ohřátý vzduch z komína je odváděn výfukovými kanály (potrubím). Jsou to čtyřboké truhlíky z prken o průřezu 20x20 cm nebo 15x15 cm, ve spodní části procházející vrstvou zeleniny jsou mřížkované a v horní části procházející přístřeškem pevné aby do nich nepadala půda. Nad nimi je instalován přístřešek, který chrání produkty před dešťovou vodou. Výfukové potrubí, v závislosti na vlastnostech a kvalitě zeleniny skladované pro skladování, jsou instalovány každé 2-4 m po délce hromady. Jednou z nevýhod vertikálních výfukových trubek je, že teplý a vlhký vzduch je odváděn pouze z přilehlých oblastí komína a odlehlé oblasti jsou téměř ochlazovány. Voda proudí v blízkosti výfukového potrubí, potí a zmrazuje produkty, protože zde je přístřešek méně hustý a spolehlivý. Proto se používá hřebenová odsávací ventilace. Při skladování zeleniny v suchém chladném počasí je hřeben příkopu pokryt pouze slámou, kterou je odváděn teplý vzduch. Takové podmínky jsou však vzácné, na podzim je často deštivé počasí. V takových případech se instaluje horizontální výfukové potrubí - desky sražené dohromady pod úhlem 90°, které se pokládají na stoh zeleniny s výstupem na koncích ven. V tomto případě může být příkop podél hřebene okamžitě pokryt slámou a zeminou, aniž by se museli obávat zvlhnutí slámy a zamrznutí produktu. Jen je potřeba včas uzavřít koncové otvory. Výhodou horizontálního hřebenového odsávacího potrubí oproti vertikálním odsávacím ventilačním potrubím je také to, že v tomto případě je teplý a vlhký vzduch odváděn rovnoměrně z celého stohu produktů.
Jáma. Nejjednodušším úložištěm je zemní jáma - určená pro skladování nejčastěji malé dávky brambor, příležitostně okopanin. Kopá se na vyvýšené ploše s nízkou hladinou spodní vody. Podle hustoty půdy se ryje s rovnými nebo šikmými stěnami. Nejpřijatelnější tvar jámy je kulatý, někdy jsou však obdélníkové. V husté hlinité půdě je vykopána díra ve tvaru džbánu. Nedoporučuje se to dělat v písčité půdě, protože se zhroutí. Vykopejte díru následujícím způsobem: nakreslete kruh o průměru 1 m a vykopejte hrdlo džbánu, poté kopáním hlouběji otvor postupně rozšiřujte na šířku 2–2,5 m v průměru. Hloubka džbánu by měla být 1,5-2 m. Aby se zabránilo vniknutí roztavené vody do jámy, je kolem otvoru hrdla položen váleček z odstraněné hlíny. Takové skladovací zařízení je zakryto víkem umístěným ve svahu, aby mohla dešťová voda stékat. Dobře vyrobený džbán vydrží bez opravy 30-40 let. V zimě bude udržovat stálejší teplotu a vlhkost než v běžném suterénu. Brambory v takové jámě se nepotí a dlouho neklíčí. Brambory se skladují v malých jámách bez větrání. Ve velkých se instaluje odvětrávací potrubí z prken nebo čtyř kůlů zaražených do dna jámy a omotaných slaměnou šňůrou. Brambory se spouštějí do otvoru pomocí kbelíku. Ke kbelíku jsou přivázána dvě lana: jedno k rukojeti a druhé ke dnu. Poté, co kbelík dosáhne podlahy, zatáhněte za lano připevněné ke dnu. Přitom se kbelík překlopí a brambory se vysypou. Při tomto způsobu zásypu nedochází k poranění hlíz. Po naplnění džbánu bramborami se krkovička uzavře slámou a pokličkou. Během prvních dvou týdnů brambory při dýchání uvolňují hodně vlhkosti, takže vrstva slámy by neměla být silná. Později se vrstva upraví na 50-70 cm v závislosti na místních zimních podmínkách.
Tisknout (Ctrl+P)
Tato část popisuje nejběžnější použití mechanismu pro práci s dočasným úložištěm a soubory.
Ukládání dat ze souboru do dočasného úložiště
Umístění jednoho souboru
Metoda PlaceFile() umístí soubor z místního systému souborů do dočasného úložiště. Metoda může přijmout adresu v dočasném úložišti, kam má být soubor uložen. Pokud adresa není definována nebo je prázdným řetězcem, bude vytvořena nová adresa a metoda ji vrátí prostřednictvím speciálního parametru.
Poznámka. Množství dat přenesených mezi klientem a serverem v rámci jednoho volání metody PutFile().
Pokud je parametr, který určuje interaktivní režim provozu, True, pak metoda zobrazí standardní dialogové okno pro výběr souboru, ve kterém můžete vybrat soubor, který chcete uložit do úložiště. V tomto případě metoda také vrátí adresu vybraného souboru.
Výsledkem je, že metoda vrátí hodnotu False, pokud uživatel interaktivně odmítl provést operaci v dialogovém okně pro výběr souboru.
Umístění sady souborů
Metoda PlaceFiles() umístí více souborů do dočasného úložiště v jednom hovoru. Existuje několik různých způsobů použití této metody:
● předem vygenerovat seznam souborů, které mají být přidány, například když jste dříve vybrali soubory, které je třeba umístit do informační databáze;
● předat metodě masku pro vyhledávání souborů, například když chcete umístit všechny soubory určitého typu, například všechny obrázky, do informační databáze;
● předat metodě dříve připravený objekt Dialogové okno pro výběr souboru v režimu otevírání souborů.
Po ukončení své práce může metoda vrátit seznam aktuálně přidaných souborů.
// FileList – atribut formuláře typu ValueList,
// obsahující seznam přidaných souborů
FileArray = Nové pole;
Pro každý prvek cyklu seznamu ze seznamu souborů
FileArray.Add(NewDescriptionofTransferFile(ListElement,));
EndCycle;
Umístěné soubory= Nové pole;
Výsledek = PlaceFiles(ArrayFiles, PlacedFiles, False, UniqueIdentifier);
Poznámka 1: Chcete-li použít metodu PlaceFiles() Webový klient vyžaduje připojení rozšíření pro zpracování souborů.
Poznámka 2: Množství dat přenesených mezi klientem a serverem na volání metody PlaceFiles(), by neměla přesáhnout 4 Gb (v serializované podobě).
Umístění dat do dočasného úložiště
Metoda je podobná metodě PlaceFile() kromě toho, že data, která mají být zapsána do dočasného úložiště
nejsou reprezentovány jako cesta v systému souborů, ale jako hodnota. Podobně, pokud není v dočasném úložišti zadána žádná existující adresa, vytvoří se nová adresa. Adresa je vrácena jako výsledek funkce. Stejně jako u souborů musí zveřejněná data patřit do nějakého formuláře a po smazání se automaticky smažou.
Poznámka. Množství dat přenesených mezi klientem a serverem na volání metody PlaceInTemporaryStorage(), by neměla přesáhnout 4 Gb (v serializované podobě).
Pozornost! Při umístění do dočasného úložiště není hodnota ve skutečnosti serializována. Odkaz na hodnotu je umístěn a uložen do mezipaměti po dobu 20 minut. Po uplynutí této doby je hodnota serializována, zapsána na disk (úložiště dat relace) a odstraněna z mezipaměti.
Načítání dat z dočasného úložiště
Při zápisu objektu do infobáze možná budete muset extrahovat data z dočasného úložiště a umístit je například do atributu objektu infobáze. Na to existuje speciální metoda – GetFromTemporaryStorage(). Tato metoda načítá data z dočasného úložiště a vrací je jako výsledek provedení. Chcete-li přijímat data, musíte dočasně uvést adresu
úložný prostor. Tato adresa je vrácena metodami pro umístění dat do dočasného úložiště, pokud jsou úspěšné (viz předchozí sekce).
Pozornost! Při načítání hodnoty z dočasného úložiště na serveru byste měli vzít v úvahu, že je získána odkazem. Ve skutečnosti tento odkaz ukazuje na hodnotu, která je uložena v mezipaměti. Do 20 minut, od okamžiku, kdy byla umístěna do úložiště nebo od okamžiku, kdy byla naposledy zpřístupněna, bude hodnota uložena do mezipaměti a poté zapsána na disk a smazána z mezipaměti. Při příštím přístupu k hodnotě je tato načtena z disku a umístěna zpět do mezipaměti.
Po deserializaci a obnovení hodnot z dočasného úložiště se reference neobnoví. Hodnota mezipaměti se obnoví z disku. Ale po serializaci/deserializaci není možné obnovit odkazy na jiné objekty uvnitř hodnoty.
Smazání dat z dočasného úložiště
Po uložení dat do atributu objektu infobase lze data v dočasném úložišti smazat. Existuje na to metoda
RemoveFromTemporaryStorage(), který provádí odstranění. Metoda bere jako parametr adresu v dočasné paměti.
Kontrola adresy pro dočasné uložení
Adresa může označovat jak dočasné úložiště, tak podrobnosti v informační základně. Existuje způsob, jak zkontrolovat jeho typ
Toto jeTemporaryStorageAddress(). Zkontroluje, že předaná adresa je adresa směřující do obchodu. Vrátí hodnotu True, pokud adresa ukazuje na dočasné úložiště.
Příjem adresy rekvizit
Po umístění dat do atributu objektu infobase k nim možná budete muset přistupovat pomocí souborových metod.
Než ale obdržíte data, například z nemovitosti, musíte získat adresu této nemovitosti. Existuje na to metoda GetNavigationLink().
Dokáže vrátit adresu hodnoty v infobázi na základě původních parametrů. Chcete-li to provést, musíte předat klíč objektu (může to být
jak odkaz na objekt, tak vstupní klíč registru informací) a název atributu. Pokud potřebujete získat adresu hodnoty uložené v atributu
tabulkové části, pak k názvu atributu v parametru určujícím název atributu musíte přidat název tabulkové části a tečku „.“. Například: Products.Image
Načtení souboru z infobáze
Příjem jednoho souboru
Metoda GetFile() přijme soubor z infobáze a uloží jej do lokálního systému souborů uživatele. První parametr určuje adresu souboru v atributu objektu infobase nebo v úložišti dočasného souboru. K uložení nedojde, pokud uživatel, jehož jménem se operace provádí, nemá právo Zobrazit detaily objektu infobáze. Druhý parametr určuje umístění, kam se uloží výsledný soubor. V neinteraktivním režimu musíte zadat cestu. V interaktivním režimu je parametr
volitelný.
Ve výchozím nastavení se metoda provádí interaktivně. To znamená, že se vygeneruje dialogové okno, ve kterém můžete určit akci s přijatým souborem: spustit jej nebo uložit do uživatelem určeného umístění v systému souborů. Pokud je vybrán interaktivní režim a není zadaná možnost Název souboru, operace otevření souboru není k dispozici. Metoda vrací booleovskou hodnotu. False znamená, že uživatel zvolil zrušení operace v dialogovém okně interaktivního uložení souboru.
Příjem sady souborů
Metoda GetFiles() vám umožňuje přijímat a ukládat několik souborů uložených v informační databázi v lokálním systému souborů uživatele. Jako parametr je předán seznam nahraných souborů.
// FileList – seznam hodnot obsahující odkazy na prvky
// adresář, ve kterém jsou umístěny nahrané soubory
// Reprezentace seznamu hodnot je název nahrávaného souboru
FileArray = Nové pole;
Pro každý prvek cyklu seznamu ze seznamu souborů
Soubor = Nový File(String(ListElement.Value));
ReceiveFile = Nový Popis přenášeného souboru;
ReceiveFile.Name = ListElement.View;
ReceiveFile.Storage= P getNavigationLink(ListItem.Value, “Data”);
FileArray.Add(ReceivingFile);
EndCycle;
Přijaté soubory= Nové pole;
Výsledek = ReceiveFiles(FilesArray, ReceivedFiles, UploadedFilesPath, False);
Pokud NE Výsledek Pak
Zpráva = Nové Zpráva uživateli;
Zpráva.Text = "Chyba při přijímání souborů!";
Zpráva.Zpráva();
EndIf;
Po dokončení může metoda vrátit seznam skutečně stažených souborů s uvedením celého názvu každého uloženého souboru.
POZNÁMKA. Chcete-li použít metodu GetFiles() ve webovém klientovi, musíte připojit příponu souboru. Pokud vlastnost Název objektu Popis přenášeného souboru obsahuje absolutní cestu k souboru, bude soubor uložen do této cesty bez ohledu na parametr Umístění souboru.
Parametr Umístění souboru může být buď cesta v lokálním systému souborů nebo objekt File Selection Dialog v režimu výběru adresáře nebo ukládání souborů. Pokud je hodnota parametru Umístění souboru zadaný objekt Dialogové okno pro výběr souboru v režimu
ukládání souborů, pak:
● dialogové okno bude vyvoláno pro každý přenesený soubor, kromě těch souborů, pro které vlastnost názvu objektu Popis přenášeného souboru obsahuje absolutní cestu;
● jako počáteční název souboru v dialogu bude použita hodnota objektu Název vlastnosti Popis přenášeného souboru;
● pokud je pro jakýkoli soubor vybráno odmítnutí uložení, pak bude název objektu Popis vlastnosti Přenesený soubor obsahovat prázdný řetězec;
● metoda GetFiles() vrátí hodnotu True, pokud byl úspěšně přijat alespoň jeden soubor;
● je třeba vzít v úvahu, že soubory jsou skutečně přijaty poté, co uživatel odpoví na otázky týkající se zadání názvu a cesty
všechny přijaté soubory;
● pokud uživatel, jehož jménem se metoda GetFile() provádí, nemá právo Zobrazit alespoň jeden atribut objektu infobáze, ze kterého jsou soubory načítány, celá operace se nezdaří.
Příklad:
TransferredFiles = Nové pole;
Popis = Nové Popis přenášeného souboru(„Popis“, FileAddress);
Přenesené soubory. Přidat(Popis );
FileSelect = Nový FileSelectionDialog(FileSelectionDialogMode.Save);
FileSelect.Header= „Uložit archiv“;
File Selection.Extension= "zip";
FileSelect.Filter= “Archiv(*.zip)|*.zip|Všechny soubory|*.*”;
FileSelect.FilterIndex = 0;
ReceiveFiles (TransferFiles, SelectFile, False);
Pokud je zvolen interaktivní režim pro výběr adresáře pro ukládání souborů, webový klient si navíc vyžádá povolení k ukládání souborů zadaných s absolutními cestami. V případě neinteraktivního ukládání (cesta k adresáři je uvedena v příslušném parametru) bude požadavek proveden pro celý seznam uložených souborů.
Příklad použití souborových metod
// Interaktivní načtení souboru z disku
// a umístěním do dočasného úložiště.
&OnClient
Postup SelectDiskFileIWrite()
Proměnná SelectedName;
Perem TemporaryStorageAddress;
NewObject = Object.Link.Empty();
Li PlaceFile(TemporaryStorageAddress, “”, SelectedName, True) Pak
Object.FileName = SelectedName;
PlaceObjectFile(TemporaryStorageAddress);
endIf;
Konec procedury
// Kopírování souboru z dočasného úložiště do rekvizit
// adresář, zápis objektu, smazání souboru z dočasného
// úložný prostor.
&Na serveru
Postup PlaceObjectFile(TemporaryStorageAddress)
Prvek adresáře = Form AttributesValue(“Object”);
Binární data = GetFromTemporaryStorage(TemporaryStorageAddress);
Data adresáře Element.File= Nové StorageValues(BinaryData, NewDataCompression());
Soubor = Nový File(Directory Item.FileName);
Adresář Item.FileName = File.Name;
Element adresáře.Write();
Upraveno = False;
DeleteFromTemporaryStorage(TemporaryStorageAddress);
ValueВFormAttributes(prvek adresáře, „Objekt“);
Konec procedury
// Přečtěte si soubor z rekvizit a uložte jej
// na lokálním disku v interaktivním režimu.
&OnClient
Postup ReadFileAndSaveToDisk()
Adresa = GetNavigationLink(Object.Link,"FileData");
GetFile(Address, Object.FileName, True);
Konec procedury
Oprávnění k provádění skupiny operací se soubory
Při provádění některých operací ve webovém klientovi může být nutné získat oprávnění pro operace s více soubory.
Potřebujete například načíst dokument z informační databáze a poté uložený dokument otevřít pomocí přidružené aplikace.
Chcete-li provést tuto operaci, budete muset odpovědět na otázku o uložení dokumentu a otázku o nutnosti jeho spuštění. Pokud je operací více, uživatel bude mít také více otázek.
Chcete-li snížit počet otázek, můžete použít metodu. Při použití této metody
Uživateli se zobrazí seznam všech operací, které se mají provést, a je požádán, aby povolil provedení skupiny operací. Pokud uživatel povolil provádění, budou požadované operace provedeny bez dalších požadavků na uživatele. Pokud povolení není uděleno, operace budou pokračovat jako obvykle: jeden požadavek na operaci.
POZNÁMKA. Chcete-li použít metodu RequestUserPermission() Ve webovém klientovi musíte povolit rozšíření pro správu souborů.
Podívejme se na příklad použití metody:
Li ConnectExtensionWorking With Files() Pak
Odkaz = GetNavigationLink(Object.Link, “FileData”);
// Vytvoření popisu přenášených souborů (v tomto případě je pouze jeden soubor)
Přenesené soubory= Nové pole;
Popis = Nový popis přeneseného souboru (Object. FileName, Link);
TransferredFiles.Add(Description);
// Příprava objektu pro příjem informací o přijatých souborech
Přenesené soubory= Nové pole;
// Definování dalších parametrů metody
DirectorySave= "c:\temp";
Interactive = False ;
Název přeneseného souboru = Ukládání Directory + “\” + Object.FileName;
// Připravte popis metod pro získání oprávnění
Metody = New Array;
Methods.Add(“GetFiles”);
Methods.Add(TransferFiles);
Methods.Add(TransferredFiles);
Methods.Add(SaveDirectory);
Methods.Add(Interactive);
Methods.Add(New Array);
Methods.Add(“RunApplication”);
Methods.Add(TransferredFileName);
Pokud ne Žádost o uživatelské oprávnění (metody) Pak
Warning("Uživatel odepřel oprávnění.");
Vrátit se;
endIf;
GetFiles(TransferFiles, TransmittedFiles, SavingDirectory, Interactive);
RunApplication(TransferredFileName);
v opačném případě
Warning("Spuštění není podporováno. Přípona souboru není nainstalována.");
endIf;
Je třeba poznamenat několik vlastností metody RequestUserPermission().
1. Povolení je požadováno pouze pro následující metody:
● GetFiles()/StartGettingFiles(),
● PlaceFiles()/StartPlaceFiles(),
● FindFiles()/StartSearchFiles(),
● CopyFile()/StartCopyFile(),
● MoveFile()/StartMovingFile(),
●DeleteFiles()/StartDeleteFiles(),
● CreateDirectory()/StartCreatingDirectory(),
● LaunchApplication()/StartRunApplication().
2. Je požadováno povolení pro konkrétní sadu parametrů metody. Pokud se během skutečného provádění metody manipulace se soubory budou hodnoty parametrů lišit od hodnot, pro které bylo získáno oprávnění, toto oprávnění nebude platné a uživatel obdrží samostatnou žádost o potvrzení operace.
3. Pokud potřebujete provést dvě (nebo více) identických operací se soubory (dokonce se stejnou sadou parametrů), měli byste zadat příslušný počet prvků v poli parametrů metody RequestUserPermission(). Pokud například potřebujete získat stejný soubor z informační databáze dvakrát a umístit jej na pevné místo v systému souborů, měli byste požádat o povolení
na dvě operace.
4. Pokud je požadováno oprávnění pro operaci, která provádí interaktivní operaci (například funkce GetFiles(), je objekt předán jako parametr Dialogové okno pro výběr souboru), pak je taková operace z požadavku vyloučena.
Udělená oprávnění jsou zachována, dokud není provedeno autorizované volání, nebo dokud se nedokončí provádění vestavěného jazyka.
POZNÁMKA. U tlustých i tenkých klientů RequestUserPermission() Metoda vždy vrátí True, bez interakce uživatele.
Práce s dočasným úložištěm v úloze na pozadí
Mechanismus pro práci s dočasným úložištěm má schopnost přenášet data z úlohy na pozadí do relace, která iniciovala úlohu na pozadí.
Pro takový přenos byste měli umístit prázdnou hodnotu do dočasného úložiště v nadřazené relaci (pomocí metody PlaceInTemporaryStorage()), s uvedením libovolného identifikátoru vytvářeného dočasného úložiště (parametr Adresa). Poté předejte přijatou adresu úloze na pozadí prostřednictvím parametrů úlohy na pozadí. Dále, pokud je v úloze na pozadí tato adresa použita jako hodnota parametru Method Address PlaceInTemporaryStorage(), pak bude výsledek zkopírován do relace, ze které byla spuštěna úloha na pozadí.
Data umístěná v dočasném úložišti v úloze na pozadí nebudou z nadřazené relace dostupná, dokud nebude úloha na pozadí dokončena.
Podpora adres v poli obrázku
Prvek formuláře Zobrazit pole Pole Obrázek podporuje zobrazení obrázku určeného adresou hodnoty (což může být obrázek nebo binární data) v dočasném úložišti nebo v databázi.
Chcete-li to provést, musíte nastavit atribut typu řetězce ve vlastnosti Data prvku formuláře. Hodnota tohoto atributu bude interpretována jako adresa obrázku.
// Příklad 1
// Dočasné svázání pole obrázku s adresou obrázku
// úložný prostor. AddressPictures – podrobnosti formuláře typu řetězce
PlaceFile(ImageAddress, InitialName, SelectedName, True, UniqueIdentifier);
// Příklad 2
// Získání adresy obrázku z atributu object
// informační základna
FilePictures = Object.FilePictures;
If Not PictureFile.Empty() Then
ImageAddress = GetNavigationLink(ImageFile, “FileData”);
v opačném případě
ImageAddress = "";
Nekonečný;
Přístup ke standardním adresářům
Při používání systému je potřeba určitý prostor v souborovém systému, kam lze ukládat různá souborová data, která jsou jednak dočasná, jednak musí být uložena poměrně dlouho. Mezi takové soubory patří koncepty systémů správy dokumentů, externí komponenty běžící na straně klientského počítače atd.
Pro ukládání takových souborů je určen speciální adresář, který je vázán na konkrétního uživatele konkrétní informační báze.
Stejný uživatel pracující se dvěma infobázemi bude mít přístup ke dvěma různým adresářům pro ukládání uživatelských dat. Umístění tohoto adresáře je určeno pomocí metody WorkUserDataDirectory(). Pokud adresář neexistuje, vytvoří se při prvním přístupu. Pokud adresář nelze vytvořit, systém vyvolá výjimku.
POZNÁMKA. Metoda UserDataWorkDirectory() není na straně serveru dostupná.
Operační systém má vyhrazený speciální adresář pro trvalé uložení uživatelských dat. Mohlo by to být nějaké
výkazy, tištěné formuláře dokladů apod. Do tohoto adresáře jsou umístěna data, která lze později odeslat na externí
spotřebitelům. Pro přístup k tomuto adresáři se používá metoda DocumentDirectory(). Fyzické umístění adresáře se liší v závislosti na operačním systému.
systém, kde se aplikace spouští a je uvedena v asistentu syntaxe.
