http://jirava.net/blog/1.aspx Jarda Jirava .net - blog &copy; Jarda Jirava 2008 jarda jirava net Fri, 21 Nov 2008 17:47:46 +0100 jirava.net syndication generator sqlserver2008-management-studio http://jirava.net/blog/Archive/sqlserver2008-management-studio.aspx .net+technology <p>Ráno jsem si přečetl příspěvek Tomáše o <a href="http://tomas-net.blogspot.com/2008/11/pote-s-ms-sql-server-management-studiem.html">jeho problémech</a> s MS SQL Server Management Studiem pro <a href="http://www.microsoft.com/sqlserver/2008/en/us/default.aspx">SQL Server 2008</a>.</p> Tue, 18 Nov 2008 22:38:13 +0100 2008-11-18T22:38:13+01:00 &copy; Jarda Jirava 2008 <p>Ráno jsem si přečetl příspěvek Tomáše o <a href="http://tomas-net.blogspot.com/2008/11/pote-s-ms-sql-server-management-studiem.html">jeho problémech</a> s MS SQL Server Management Studiem pro <a href="http://www.microsoft.com/sqlserver/2008/en/us/default.aspx">SQL Server 2008</a>.</p> <p>Ač jsem reagoval již v komentáři, neodpustím si ještě několik poznámek, které si zaslouží maličko více rozvést a najít řešení, které z Management Studia vytvoří plnohodnotný nástroj pro databázového administrátora.</p> <p>Výroky a postesky nad tímto problémem:</p> <blockquote> <p>Nepodařilo se mi ho přesvědčit, aby přesunulo sloupce v tabulce tak jak potřebuji. Po této operaci, kterou Designer tabulky viditelně umí, dojde při uložení změn v tabulce k chybě, která se hlásí jako "<em>Název změněné tabulky</em>".</p></blockquote> <p>obdobně jako tímto:</p> <blockquote> <p>Velmi často při uložení změn v tabulce dojde k chybě ukládání. Netuším o jakou chybu jde, protože se hlásí stejně jako chyba předchozí.</p></blockquote> <p>jsou způsobeny pouze tím, jak se Management studio chová k ukládání databázových objektů. Tyto "problémy" jsou způsobeny tím, že se Management studio snaží při takovýchto změnách provést drop objektu a jeho znovuvytvoření, tak jak je popsáno na <a href="http://msdn.microsoft.com/en-us/library/bb895146.aspx">tomto místě</a>. Je zde i návod, jak docílit změny a být, takříkajíc, <strong>spokojený</strong>, postačující je odškrnout volbu v menu <em>Tools-&gt;Options-&gt;Designers-&gt;Table and Database designers-&gt;Prevent saving changes that require table re-creation</em>.</p> <blockquote> <p>Na Subversion je ovšem lepší ukládat textové soubory a to rozhodně záloha MS SQL serverů není. Textový soubor si tedy vyrábím v Management Studiu pomocí <em>Generate Scripts. </em>Jsem rád, že to Microsoft umí. Bohužel průvodce neumím zkrátit a nastavené volby si nepamatuje. Je to velmi zdlouhavé, zdržující a protivé.</p></blockquote> <p>Jak jsem se již zmínil v komentáři pod článkem, toto je asi lepší vyřešit pomocí Powershell scriptu. Samozřejmě, nesmí se zapomenout doinstalovat SQL Server PowerShell snapin pomocí příkazu <strong>sqlps</strong>. Poté je již možné vyscriptovat jakýkoli databázový objekt. Pro tabulky je to například příkazem:</p> <p><code>PS SQLSERVER:\&gt; sl SQLSERVER:\SQL\[server]\[instance]\Databases\[catalog]\Tables; gci| %{$_.Script()} &gt; c:\tables.txt</code></p> <p> Kde je potřeba zaměnit správné hodnoty za placeholdry [server], [instance] - zadat název <em>default</em> v případě, že se jedná o default instanci a samozřejmě [catalog] je název samotné databáze.</p> <p>Myslím, že jednodušeji to snad jít ani nemůže. ;-)</p> simple-aspnet-mvc-controls http://jirava.net/blog/Archive/simple-aspnet-mvc-controls.aspx .net+technology Výchozí release jednoduchých asp.net MVC prvků je na světě. Jaká je motivace pro vytvoření těchto prvků a jaká je jejich budoucnost? Mon, 17 Nov 2008 22:29:38 +0100 2008-11-17T22:29:38+01:00 &copy; Jarda Jirava 2008 <p>Před pár minutami se mi povedlo uveřejnit na serveru <a href="http://www.codeplex.com/">CodePlex.com</a> první alpha release verzi <a href="http://www.codeplex.com/simplemvccontrols">asp.net MVC prvků</a>.</p> <h3>Fieldset</h3> <p>V tomto úvodním release je zahrnut pouze prvek <strong>Fieldset</strong>, který je inspirován prvekem Grid z projektu <a href="http://www.codeplex.com/mvccontrib">MVCContrib</a>. Tento prvek jsem původně vytvořil pro webové stránky zpracovávané v soutěži na serveru vbnet.cz. Ona myšlenka takovéhoto prvku, který zabezpečí jednotný vzhled a ucelený přístup k tvorbě formulářů na web stránkách, se mi zalíbil a proto jsem jej rozvedl a maličko vylepšil.</p> <p>Již nyní mám v hlavě další vylepšení a možný rozvoj. Jsem však přesvědčen, že je takovýto prvek lepší publikovat co nejdříve a inspirovat se názory komunity. Budu proto rád, pokud mi napíšete možná vylepšení nebo připomínky.</p> <h3>Proč simple</h3> <p>V čem by měl být smysl takto vytvořeného prvku před samostatným tvořením vstupního formuláře? Prvním impulzem, k tvotbě tohoto ovládacího prvku pro mě bylo neustálé zapisování HTML kódu, který se pro každý prvek formuláře opakoval. Dalším podnětem pak byla náchylnost k chybám při zápisu. S release verzí asp.net MVC Beta přibyla možnost validací prvků, avšak pro tyto prvky bylo třeba uvést shodný název, jaký je uveden v tzv. ModelState. Vznikla tak potřeba pro každý validovaný prvek tento název zapsat dvakrát, což už vede k možným chybám.</p> <p>Z těchto důvodů jsem se rozhodl vytvořit takovou formu zápisu, která by <strong>vývojáře</strong> odstínila od těchto potřeb a nabídla mu přímou a jednoduchou cestu k cíli. Ukázku možného zápisu jsem prezentoval na oficiálních stránkách <a href="http://www.codeplex.com/simplemvccontrols">simple asp.net MVC Controls</a>.</p> <p>Doufám, že se mi cíl vytvoření jednoduchých prvků pro asp.net MVC podařil a bude na čem stavět pro další verze.</p> silverlight-2 http://jirava.net/blog/Archive/silverlight-2.aspx .net+technology <p>Je to tak, po del&#353;&#237;m ček&#225;n&#237; se konečně dostalo na Silverlight 2.0 a jeho ofici&#225;ln&#237; vypu&#353;těn&#237; na web.</p> Tue, 14 Oct 2008 10:40:02 +0200 2008-10-14T10:40:02+02:00 &copy; Jarda Jirava 2008 <p>Je to tak, po del&#353;&#237;m ček&#225;n&#237; se konečně dostalo na Silverlight 2.0 a jeho ofici&#225;ln&#237; vypu&#353;těn&#237; na web.</p> <p>Byť o t&#233;to hork&#233; novince jistě každ&#253; v&#237;, neboť se to obdobn&#253;mi př&#237;spěvky na bloz&#237;ch jen hemž&#237;, ani j&#225; si neodpust&#237;m několik m&#225;lo postřehů. Nejdř&#237;ve těch form&#225;ln&#237;ch:</p> <ul> <li><a href="http://www.microsoft.com/silverlight/">ke stažen&#237;</a> na str&#225;nk&#225;ch Microsoftu</li> <li>v př&#237;padě, že m&#225;te nainstalov&#225;nu předchoz&#237; Betu, update se provede automaticky</li> <li>velikost instalace cca 4.5 MB</li> <li>možnosti instalace do prohl&#237;žečů IE 7, IE6, Firefox 1.5, Firefox 2 a FireFox 3, pokud použ&#237;v&#225;te syst&#233;m MAC OS ve verzi 10.4.8 a vy&#353;&#353;&#237; na Intelu, tak i pro Safari.</li> <li>nepovedlo se mi roz&#353;&#237;řit si Chromium - Google chrome</li> </ul> <p>Samozřejmě nesm&#237; chybět nějak&#233; ty informace pro v&#253;voj&#225;ře. Takže pokud jste př&#237;znivci <a href="http://en.wikipedia.org/wiki/Rich_Internet_Application">RIA</a> aplikac&#237;, určitě v&#225;s možnosti, kter&#233; přin&#225;&#353;&#237; Silverlight ve verzi 2.0 potě&#353;&#237;. Mezi ty z&#225;kladn&#237; prvky patř&#237;</p> <ul> <li>ovl&#225;dac&#237; prvky jako jsou DataGrid, ListBox, Slider, ScrollViewer, Calendar a dal&#353;&#237;, kter&#233; se budou objevovat na str&#225;nk&#225;ch <a href="http://www.codeplex.com">CodePlex</a> (souč&#225;st&#237; by měl b&#253;t třeba WrapPanel, DockPanel, ViewBox, Label, Expander, TreeView a dal&#353;&#237;)</li> <li>pokud se zab&#253;v&#225;te tvorbou WPF aplikac&#237;, bude v&#225;m bl&#237;zk&#233; skinov&#225;n&#237; a použit&#237; templates.</li> <li>podpora vol&#225;n&#237; webov&#253;ch služeb - a to jak prov&#225;z&#225;nost&#237; na WCF tak tak&#233; možnost komunikovat přes REST, SOAP nebo standardn&#237; HTTP komunikaci</li> <li>podporu hned několika programovac&#237;ch jazyků - takže Silverlight aplikace můžete ps&#225;t nejen v C# nebo VB.NET, ale tak&#233; v dynamick&#253;ch jazyc&#237;ch jako je JavaScript nebo IronPython či IronRuby. A nepochybně se najdou i dal&#353;&#237; portace, třeba pro PHP</li> </ul> <p>Co určitě potě&#353;&#237; je skutečnost, že se připravuj&#237; Express n&#225;stroje, takže každ&#253; si bude moci vyzkou&#353;et jak vytvořit Silverlight aplikaci. A pokud přeci jen nejste tak &#250;plně zast&#225;nci MS a obl&#237;bili jste si v&#253;vojov&#253; n&#225;stroj Eclipse, tak můžete vyzkou&#353;et <a href="http://www.eclipse4sl.org/">Eclipse for Silverlight</a>.</p> <p>Pro ty z v&#225;s, kter&#233; jsem nal&#225;kal, je&#353;tě možnost stažen&#237; <a href="http://www.microsoft.com/downloads/details.aspx?familyid=8d933343-038f-499c-986c-c3c7e87a60b3&amp;displaylang=en&amp;tm">SDK</a> a v př&#237;padě, že použ&#237;v&#225;te Expression Blend 2, tak je vyd&#225;n <a href="http://www.microsoft.com/downloads/details.aspx?familyid=eb9b5c48-ba2b-4c39-a1c3-135c60bbbe66&amp;displaylang=en&amp;tm">Service pack</a>.</p> <p>Přeji př&#237;jemnou z&#225;bavu při vytv&#225;řen&#237; lep&#353;&#237;ch a hezč&#237;ch aplikac&#237;.</p> vyzva-sablonovy-system-nvelocity http://jirava.net/blog/Archive/vyzva-sablonovy-system-nvelocity.aspx .net+technology vyzva Zajištění výstupu ve formátu HTML ze vstupních dat je třeba zajistit pomocí šablonovacího systému, který systém jsem vybral pro moji výzvu, já? Tue, 07 Oct 2008 08:15:26 +0200 2008-10-07T08:15:26+02:00 &copy; Jarda Jirava 2008 <p>Pomalu se dostáváme do finální části, kdy již máme vše připraveno a stačí nám jednotlivé produkty (knihy) vypublikovat na web.</p> <h3>XSL jako šablona - zavrženo</h3> <p>Jak jsem se již zmínil v prvních krocích, kdy jsem vytvářel <a href="http://jirava.net/blog/Archive/vyzva-domenove-objekty-linq-to-xml.aspx">doménové objekty</a> a ty naplnil <a href="http://jirava.net/blog/Archive/vyzva-definice-zdroje-dat.aspx">vstupními daty</a>, <strong>xsl</strong> pro prezentaci dat bylo zavrženo. Přitom by se dalo říct, že jako šablonový systém, kdy na vstupní straně je <strong>xml</strong>, je toto řešení přímo ideální a též jsem jej v první chvíli doporučoval.</p> <p>Jenže jak se říká, zákazník je náš pán a já jsem si svoji práci nechtěl ulehčit tím, že bych xsl použil. Přitom jsem chtěl nabídnout takové možnosti, aby bylo jednoduché vkládat statické texty okolo dynamických polí a to vše s možností plně ovlivnit výstupní HTML.</p> <p>Chvíli jsem nad tím přemýšlel a uvažoval jsem jak něco tak jednoduchého zabezpečit, když v tom mě to napadlo, jednu takovou věc již používám a její implementace nebude náročná. Stejně tak věřím, že by nebylo náročné pro zkušenějšího uživatele znalého HTML syntaxe naučit se i těch několik málo příkazů. Navíc se tím vyvaruji i dalšího strašáka a to je použití <strong>PHP</strong>, které bylo taktéž zavrženo.</p> <h3>NVelocity</h3> <p>Přesně tak, onou spásnou knihovnou se stala <a href="http://www.castleproject.org/others/nvelocity/index.html">NVelocity</a> a to po úpravách z projektu <a href="http://www.castleproject.org/">Castle</a>. Domnívám se totiž, že je to velice jednoduše uchopitelný šablonovací systém, přesně splňující základní potřeby pro publikaci potřebných informací a v případě potřeby též snadno rozšiřitelný.</p> <p>Jelikož mám tuto knihovnu použitou například na <a href="http://jirava.net/blog/">tomto</a> webu, kde si pomocí ní generuji emailové notifikace, nebyl problém ji vzít a použít i v tomto systému.</p> <p>Právě z tohoto důvodu jsem se také v prvních krocích ujal vytvářet doménový model, protože objekty a především jejich vlastnosti jsou základním předpokladem a pomocí nich se zobrazují získaná data.</p> <p>Jak tedy potom vypadá vygenerování výstupu z takové šablony je vidět na ukázce níže:</p><pre class="csharpcode">IPathLocatorService pathLocatorService = <span class="kwrd">new</span> DesktopPathLocatorService(); ITemplateProcessor templateProcessor = <span class="kwrd">new</span> NVelocityTemplateProcessor(pathLocatorService); Hashtable data = <span class="kwrd">new</span> Hashtable(); data[<span class="str">"book"</span>] = book; post.description = templateProcessor.RenderView(<span class="str">"description"</span>, data);</pre> <p></p> <p>kdy právě instance třídy <em>Book</em> je předána jako parametr s názvem <em>book</em> do transformační metody a za pomocí definice šablony je vytvořen na výstupu HTML kód.</p> <h3>Šablona</h3> <p>Definování šablony je potom již otázkou vkusu a zručnosti. V mém případě tedy otázkou trošku delší, ale věřím, že pro schopného html kodéra by tato práce nebyla vůbec těžká. Já se rozhodl pro jednoduchý výpis informací a v případě generování description jsem použil následující:</p><pre class="csharpcode"><span class="kwrd">&lt;</span><span class="html">div</span> <span class="attr">class</span><span class="kwrd">="book"</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">h4</span><span class="kwrd">&gt;</span>Authors:<span class="kwrd">&lt;/</span><span class="html">h4</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">ul</span><span class="kwrd">&gt;</span> #foreach ($author in $book.Authors) <span class="kwrd">&lt;</span><span class="html">li</span><span class="kwrd">&gt;</span>$author.FullName<span class="kwrd">&lt;/</span><span class="html">li</span><span class="kwrd">&gt;</span> #end <span class="kwrd">&lt;/</span><span class="html">ul</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dl</span> <span class="attr">class</span><span class="kwrd">="metainfo"</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dt</span><span class="kwrd">&gt;</span>ISBN<span class="kwrd">&lt;/</span><span class="html">dt</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dd</span><span class="kwrd">&gt;</span>$book.ISBN<span class="kwrd">&lt;/</span><span class="html">dd</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dt</span><span class="kwrd">&gt;</span>Pages<span class="kwrd">&lt;/</span><span class="html">dt</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dd</span><span class="kwrd">&gt;</span>$book.NumberOfPages<span class="kwrd">&lt;/</span><span class="html">dd</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dt</span><span class="kwrd">&gt;</span>Publication date<span class="kwrd">&lt;/</span><span class="html">dt</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;</span><span class="html">dd</span><span class="kwrd">&gt;</span>$book.PublicationDate.ToString("dd.MM.yyyy")<span class="kwrd">&lt;/</span><span class="html">dd</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;/</span><span class="html">dl</span><span class="kwrd">&gt;</span> <span class="kwrd">&lt;/</span><span class="html">div</span><span class="kwrd">&gt;</span></pre> <p>Samozřejmě není nutné, aby výstupem transformace byl HTML kód, ale v tomto případě je to očekávané.</p> <h3>Jak by to probíhalo</h3> <p>Zde již opět přichází na řadu součinnost s případným zadavatelem zakázky. Záleží na tom, zda by měl již připravené HTML šablony, do kterých by se umisťovali jednotlivé atributy nebo by si šablony chtěl tvořit sám. V případě prvním bych nejspíše zasedl a začal jednu šablonu za druhou přepisovat a doplňovat řídící značky. V případě druhém by potom došlo k vysvětlení významu jednotlivých řídících značek a popsání doménového modelu.</p> <h3>Časový odhad</h3> <p>Vzhledem k tomu, že jsem měl připraveno a zaobaleno volání NVelocity v samostatné assembly bylo napojení do systému velice rychlé. Určitě delší čas jsem strávil nad tím, jak vhodně vygenerovat výstup a jaké informace zobrazit a předat do kterého vstupního pole třídy <em>Post</em> - viz <a href="http://jirava.net/blog/Archive/vyzva-xml-rpc-wordpress.aspx">napojení na WordPress pomocí XML-RPC</a>. Celkový čas pro tento krok tedy byl 40 minut. Zde musím upozornit, že v případě předání šablon pro Petru by především definice šablon a jejich úprava mohla zabrat nepoměrně delší dobu.</p> vyzva-lokalni-databaze http://jirava.net/blog/Archive/vyzva-lokalni-databaze.aspx .net+technology vyzva Některé informace je třeba uchovat na straně klienta, k tomu poslouží výborně SQL Server Compact Edition s přístupem pomocí LINQ to SQL. Thu, 02 Oct 2008 08:15:57 +0200 2008-10-02T08:15:57+02:00 &copy; Jarda Jirava 2008 <p>V tuto chvíli by se mohlo zdát, že naše aplikace je hotova. Postačující bude ji jen poskládat a předat k užívání.</p> <h3>Aktualizace dat</h3> <p>Co je však třeba si uvědomit, že toto nemá sloužit jako jednorázové naplnění webu a bude třeba přidávat nové produkty, případně si maličko pohrát s rozvržením a úpravou statických textů, které budou přidávány ke každému produktu.</p> <p>Je tedy nutné zajistit, aby se nové položky do <a href="http://jirava.net/blog/Archive/vyzva-publikacni-system-wordpress.aspx">publikačního systému</a> vložily a položky již jednou vložené pouze aktualizovaly. Pro zajištění tohoto úkolu jsem si vybral lokální datový soubor a využil jsem tak možností <a href="http://www.microsoft.com/sql/editions/compact/default.mspx">SQL Server Compact Edition</a> v. 3.5. Za atributy, které je nutné sledovat jsem si stanovil <em>Id</em>, které je každému příspěvku přiděleno publikačním systémem <strong>WordPress</strong> a také <em>ASIN</em>, který představuje identifikátor na straně <a href="http://jirava.net/blog/Archive/vyzva-domenove-objekty-linq-to-xml.aspx">vstupních dat</a>. Dále jsem se rozhodl též ukládat si atribut <em>Title</em> a <em>Publisher</em> a pro informaci též datum vystavení (publikace).</p> <p>Tyto všechny atributy se mi vešly do jedné tabulky, kterou jsem nadefinoval z prostředí <a href="http://msdn.microsoft.com/en-us/vstudio/default.aspx">Visual Studio</a>. Pro přístup a manipulaci s daty jsem si potom vybral <strong>LINQ to SQL</strong>, který dokáže pracovat právě i s touto lokální databází. Podpora v designeru Visual Studia však v současné chvíli chybí a tak je třeba použít nástroje <strong>sqlmetal.exe</strong>. Mě se v těchto případech osvědčilo použití <em>.bat</em> souboru, který obsahuje následující definice:</p><pre class="csharpcode"><span class="str">"c:\Program Files\Microsoft SDKs\Windows\v6.0A\bin\sqlmetal.exe"</span> /dbml:ArchiveModel.dbml ArchiveDb.sdf <span class="str">"c:\Program Files\Microsoft SDKs\Windows\v6.0A\bin\sqlmetal.exe"</span> /<span class="kwrd">namespace</span>:Vyzva.Data.Archive /serialization:Unidirectional /context:ArchiveDataContext /language:csharp /pluralize /code:ArchiveModel.cs /map:ArchiveModel.config ArchiveModel.dbml</pre> <p>Samozřejmě můžete vynechat vytvoření mapovacího souboru, osobně však tomu dávám přednost mít jej vygenerovaný znovu a s koncovou .config</p> <p>Takto vygenerované soubory tedy postačuje vložit do projektu, u .config souboru, kde jsou uloženy mapovací informace nastavit jeho <em>Build type</em> na <em>Embedded resource</em>, tak aby došlo ke vložení souboru do assembly a začít používat DataContext objekt. V tomto případě, kdy se negenerují atributy nad třídou a vlastnotmi, je třeba při vytváření instance DataContextu předat též odkaz na mapovací schéma a connection string.</p><pre class="csharpcode"><span class="kwrd">if</span> (_mappingSource == <span class="kwrd">null</span>) { <span class="kwrd">using</span> (Stream st = Assembly.GetExecutingAssembly().GetManifestResourceStream(<span class="str">"Vyzva.Data.Archive.ArchiveModel.config"</span>)) { _mappingSource = XmlMappingSource.FromStream(st); } } <span class="kwrd">string</span> conn = ConfigurationManager.ConnectionStrings[<span class="str">"DbMainConn"</span>].ConnectionString; context = <span class="kwrd">new</span> ArchivDataContext(conn, _mappingSource);</pre> <p>Proměnnou <em>_mappingSource</em> mám v tomto případě definovanou v mé <strong>Factory</strong> třídě jako statickou, neboť není nutné při každém požadavku na <a href="http://msdn.microsoft.com/en-us/library/system.data.linq.datacontext.aspx">DataContext</a> vytvářet a parsovat znovu mapovací schéma.</p> <p>Tímto mám zaručenu základní funkcionalitu a umožněnu práci s lokální databází.</p> <h3>Jak by to probíhalo</h3> <p>Ani tento krok se zdá, že by nemusel být učiněn v součinnosti s Petřinými požadavky. Co by však stálo za úvahu je definovat si seznam atributů, které budou v této lokální databázi uchovávány a případně další požadavky. Docela dobře si dokáži představit, že by mohl být učiněn požadavek na změnu kategorie, případně její hromadné doplnění k vybraným produktům, případně jiná úprava, která nelze zajistit v <a href="http://jirava.net/blog/Archive/vyzva-definice-zdroje-dat.aspx">exportu xml souboru</a>.</p> <h3>Časový odhad</h3> <p>Definice struktury databáze, vygenerování souborů pomocí sqlmetal.exe a práce s tím spojené zabrali přibližně 30 minut. Ani zde, obdobně jako v předchozím kroku se nedají očekávat nějaká větší časová zdržení.</p> vyzva-xml-rpc-wordpress http://jirava.net/blog/Archive/vyzva-xml-rpc-wordpress.aspx .net+technology vyzva Vytvoření klienta pomocí XML-RPC pro vzdálený přístup k publikačnímu systému WordPress. Tue, 30 Sep 2008 08:15:11 +0200 2008-09-30T08:15:11+02:00 &copy; Jarda Jirava 2008 <p>Pro toho, kdo si píše svůj blog a používá k tomu některý z offline klientů, jako třeba <a href="http://windowslivewriter.spaces.live.com/">Windows Live Writer</a> tomu nemůže být cizí, že každý rozumný publikační systém má svoje API rozhraní.</p> <h3>Publikační API rozhraní</h3> <p>Většina <strong>API</strong> rozhraní, která se v současné době používají u publikačních systémů je založena na <strong>XML-RPC</strong> volání. Těchto API je definováno hned několik a není výjimkou, že se i vzájemně doplňují. Mezi ty známější tak patří:</p> <ul> <li>blogger API <li>MovableType API <li>MetaWeblog API <li>a samozřejmě, své API má i <a href="http://jirava.net/blog/Archive/vyzva-publikacni-system-wordpress.aspx">WordPress</a>, který rozšiřuje možnosti MetaWeblog API o definici svých metod </li></ul> <h3>XML-RPC v .net</h3> <p><strong>.net framework</strong> neobsahuje ve svých assembly třídu, která by umožňovala volání pomocí specifikace <a href="http://www.xmlrpc.com/">XML-RPC</a>. To ovšem nevadí v případě, že znáte knihovnu <a href="http://www.xml-rpc.net/">XML-RPC.net</a>. Tato knihovna umožňuje velice elegantně a rychle vytvořit nejen klienta, ale také server pro vzdálená volání.</p> <p>V mém případě bylo plně dostačující vytvoření klienta služby a napojení se na vytvořený účet. A že vytvoření klienta je velice jednoduché může demonstrovat následující postup.</p> <p>Zároveň se stažením knihovny získáváte i zdrojové kódy a to nejen pro samotnou assembly, ale také s definovanými interface pro výše zmíněné publikační API a to i s definicí struktur parametrů.</p> <p>Po nareferencování knihovny <em>CookComputing.XmlRpcV2.dll</em> jsem tak do projektu přidal i definici interface pro MetaWeblog API a rozšíril jsem jej o implementaci interface <em>IXmlRpcProxy</em>, tak abych mohl vytvořit proxy klienta. Jelikož jsem však potřeboval ještě vytvářet nové kategorie, bylo potřebné doplnit definici metody pro vytvoření nové kategorie. Na stránkách WordPressu jsem v <a href="http://codex.wordpress.org/XML-RPC#wp.newCategory">dokumentaci</a> pro vývojáře zjistil, jaký předpis má takové volání a doplnil strukturu a interface metody.</p><pre class="csharpcode">[XmlRpcMethod(<span class="str">"wp.newCategory"</span>, Description = <span class="str">"Create a new category."</span>)] <span class="kwrd">object</span> newCategory(<span class="kwrd">string</span> blogid, <span class="kwrd">string</span> username, <span class="kwrd">string</span> password, Category category);</pre><pre class="csharpcode"><span class="kwrd">public</span> <span class="kwrd">struct</span> Category { <span class="kwrd">public</span> <span class="kwrd">string</span> name; <span class="kwrd">public</span> <span class="kwrd">string</span> slug; <span class="kwrd">public</span> <span class="kwrd">int</span> parent_id; <span class="kwrd">public</span> <span class="kwrd">string</span> description; }</pre> <p>Poté již stačí jen vytvořit instanci proxy třídy, a nastavit ji správně Url adresu na servisní stranu publikačního systému. Tím jsme hotovy a můžeme volat vzdálené metody a publikovat tak naše produkty, v mém případě knihy.</p><pre class="csharpcode">IMetaWeblog proxy = XmlRpcProxyGen.Create&lt;IMetaWeblog&gt;(); proxy.Url = URL; // zde již následuje volání metod nad proxy</pre> <h3>Jak by to probíhalo</h3> <p>Tento krok je plně v mé režii. Co vás případně může zaskočit a co je dobré vědět, že jednotlivá volání je možné trasovat. Což pomohlo i mě, kdy definice pro kategorie nebyla přesná a bylo ji třeba upravit dle skutečného stavu, který posílal nainstalovaný WordPress. Jak zajistit možnost odladit jednotlivá volání:</p><pre class="csharpcode">RequestResponseLogger logger = <span class="kwrd">new</span> RequestResponseLogger(); logger.Attach(proxy);</pre> <p>Poté bude již veškerá komunikace logována do samostatných souborů.</p> <h3>Časový odhad</h3> <p>V případě že víte, kam "sáhnout" a nemusíte znovu vynalézat kolo, potom je zprovoznění <strong>XML-RPC</strong> volání velice jednoduché a rychlé. Mě proklikání se k dokumentaci WordPressu pro jeho rozšířené API, dodefinování metody a odladění volání zabralo asi 35 minut.</p> vyzva-publikacni-system-wordpress http://jirava.net/blog/Archive/vyzva-publikacni-system-wordpress.aspx .net+technology vyzva Použití publikačního systému WordPress pro publikaci dat získaných z exportu xml pro tvorbu webu. Thu, 25 Sep 2008 08:15:39 +0200 2008-09-25T08:15:39+02:00 &copy; Jarda Jirava 2008 <p>Nyní se přesunu z prostředí <strong>.net frameworku</strong> někam hodně daleko, do míst, která jsem ještě před několika málo týdny téměř vůbec neznal a které je třeba alespoň částečně prozkoumat.</p> <p>Je to systém <strong>WordPress</strong>, který byl zmíněn, že je vhodným kandidátem na prezentaci dat o produktech, v mém případě i knih.</p> <h3>Hosting WordPressu</h3> <p>Jelikož jsem v tomto odvětví nováček a hosting, který mám je určen pro .net aplikace, jal jsem se hledat způsob, jak rozchodit systém <a href="http://wordpress.org">WordPress</a>, abych na něm mohl otestovat možnosti publikace informací získaných v <a href="http://jirava.net/blog/Archive/vyzva-domenove-objekty-linq-to-xml.aspx">předchozích</a> krocích. Je příjemné, že přímo na stránkách, kde je možné stáhnout si zdrojové kódy pro tento publikační systém je i odkaz na možnost hostovat své příspěvky na již <a href="http://wordpress.com">funkčním řešení</a>. Proto jsem neváhal a zřídil jsem si účet.</p> <p>V tuto chvíli se musím omluvit všem, kteří čekali odkaz, avšak nebudu jej zatím zveřejňovat, ten kdo má zájem jistě stránky dokáže najít, pro ostatní potom nezbyde, než dočíst tento seriál a odkaz najít v průběhu čtení.</p> <p>Prostor s publikačním systémem tedy mám, je nakonfigurován a já jsem zkusil vytvořit jednu stránku a jeden příspěvek, abych zjistil jak se zobrazují a co vše je třeba nastavit.</p> <p>Tady jsem si také definoval, že vhodné bude používat kategorie pro příspěvky a do nich řadit jednotlivé knihy, za kategorii jsem si potom vybral vydavatele dané knihy. Samozřejmě ono členění může být různé a dle možností by se mohl specifikovat třeba autor a vydavatel, případně zvolit jiná kriteria, která je možné získat ze vstupního xml souboru.</p> <p>Musím říct, že ovládání a administrace WordPressu mě velice mile překvapila a v případě, že bych měl k dispozici pouze <strong>PHP hosting</strong> s podporou <strong>MySQL</strong> databáze, byl by mojí volbou pro publikační činnost.</p> <p>Nakonec jsem si ještě pohrál s tím, abych si vybral nějakou pěknou šablonu a přidal několik widgetů do postraní lišty.</p> <h3>Jak by to vypadalo</h3> <p>Tady si myslím, že při spolupráci s Petrou bych se nechal spíše vést, protože věřím, že má více zkušeností s provozem tohoto publikačního systému. Předpokládám též, že by bylo nutné dořešit provázání jednotlivých produktů mezi sebou a vytvoření stromu první úrovně pro následné kategorie.</p> <h3>Časový odhad</h3> <p>Mě hledání a zkoumání WordPress publikačního systému zabralo necelou hodinku času.</p> vyzva-domenove-objekty-linq-to-xml http://jirava.net/blog/Archive/vyzva-domenove-objekty-linq-to-xml.aspx .net+technology vyzva Pokračování výzvy z webtrhu pokračuje, tentokráte povídáním o tom, jak jsem si vytvořil doménové objekty pro uchování dat a provedl jejich naplnění. Tue, 23 Sep 2008 08:15:26 +0200 2008-09-23T08:15:26+02:00 &copy; Jarda Jirava 2008 <p>Pokračování výzvy z webtrhu pokračuje, tentokráte povídáním o tom, jak jsem si vytvořil doménové objekty pro uchování dat a provedl jejich naplnění.</p> <h3>Doménové objekty</h3> <p>V příspěvku věnovaném <a href="http://jirava.net/blog/Archive/vyzva-definice-zdroje-dat.aspx">definici zdroje dat</a> jsem končil v okamžiku, kdy jsem byl schopen pomocí <strong>REST</strong> volání získat xml zdroj dat. Z následné diskuze na webtrhu vyplynulo, že <a href="http://vetrovka.cz/">Petra</a> zrovna neholduje <strong>XSL</strong> šablonám a přesto by byla ráda, pokud by si mohla v případě potřeby upravit výsledné HTML, které bude publikovat na web. O tom, jak jsem se tohoto problému zhostil v jednom z příštích článků. Co jsem však potřeboval, bylo mít naplněné objekty, které budou sloužit pro držení dat.</p> <p>Ze vstupního xml souboru jsem si tak definoval několik elementů, které stojí za to mít uchované, a které se budou moci následně zobrazovat a publikovat na webu. Obdobně bych postupoval i se vstupním xml souborem produktů, zde jsem se tedy zaměřil na knihy. Mnou vytvořené třídy tedy představovaly primitivní <a href="http://en.wikipedia.org/wiki/Plain_Old_CLR_Object">POCO</a> (Plain Old CLR Object) objekty s definicí vlastností, které odpovídaly dostupným elementům.</p> <ul> <li>Book - ASIN, ISBN, NumberOfPages, PublicationDate, Publisher, Title, Authors, Reviews <li>Author - FullName <li>Review - Source, Content </li></ul> <h3>Linq to Xml</h3> <p>Poté, co jsem měl nadefinovány tyto jednoduché objekty bylo je třeba vytvořit a naplnit daty. K tomu jsem s úspěchem použil nových objektů, které nabízí verze <strong>.net frameworku 3.5</strong>. A to konkrétně objektů <a href="http://msdn.microsoft.com/en-us/library/system.xml.linq.xelement.aspx">XElement</a> ve spojení s <strong>LINQ to XML</strong>.</p> <p>Stažení dat tak bylo otázkou jednoho jediného řádku:</p><pre class="csharpcode">XElement x = XElement.Load(url);</pre> <p>kde proměnná <em>url</em> představovala doplněnou adresu o proměnné parametry, které jsem představil v minulém článku.</p> <p>Pokud si nyní říkáte, jak složité je naplnit POCO objekty vstupnímy daty a získat tak seznam dostupných knih poskytovaných webovou službou amazonu, je to přesně 23 řádků kódu, z čehož je ještě několik řádků věci vizuálního formátování.</p> <p>A zde je celé kouzlo, kterým se provede instancování objektů a jejich naplnění</p><pre class="csharpcode">var result = from book <span class="kwrd">in</span> x.Descendants(ns + <span class="str">"Item"</span>) let attrs = book.Element(ns + <span class="str">"ItemAttributes"</span>) let revs = book.Element(ns + <span class="str">"EditorialReviews"</span>) select <span class="kwrd">new</span> Book() { ASIN = (<span class="kwrd">string</span>)book.Element(ns + <span class="str">"ASIN"</span>), ISBN = attrs.Element(ns + <span class="str">"ISBN"</span>) != <span class="kwrd">null</span> ? (<span class="kwrd">string</span>)attrs.Element(ns + <span class="str">"ISBN"</span>) : <span class="kwrd">string</span>.Empty, NumberOfPages = (<span class="kwrd">int</span>?)attrs.Element(ns + <span class="str">"NumberOfPages"</span>) ?? 0, PublicationDate = (DateTime)attrs.Element(ns + <span class="str">"PublicationDate"</span>), Publisher = (<span class="kwrd">string</span>)attrs.Element(ns + <span class="str">"Publisher"</span>), Title = (<span class="kwrd">string</span>)attrs.Element(ns + <span class="str">"Title"</span>), Authors = <span class="kwrd">new</span> List&lt;Author&gt;(from a <span class="kwrd">in</span> attrs.Elements(ns + <span class="str">"Author"</span>) select <span class="kwrd">new</span> Author() { FullName = (<span class="kwrd">string</span>)a }), Reviews = revs == <span class="kwrd">null</span> ? <span class="kwrd">new</span> List&lt;Review&gt;() : <span class="kwrd">new</span> List&lt;Review&gt;(from r <span class="kwrd">in</span> revs.Descendants(ns + <span class="str">"EditorialReview"</span>) select <span class="kwrd">new</span> Review() { Content = (<span class="kwrd">string</span>)r.Element(ns + <span class="str">"Content"</span>), Source = (<span class="kwrd">string</span>)r.Element(ns + <span class="str">"Source"</span>) }) };</pre> <h3>Přítelem je let</h3> <p>Teď to možná zní velice divně, ale pokud se blíže podíváte na zdrojový kód uvedený výše zjistíte, že jsem použil magické slůvko <em>let</em>, kterým jsem si vložil do dotazu další proměnné, které používám. První proměnná <em>attrs</em> je pouze pro usnadnění práce, u druhé to také tak může vypadat, ale má to i hlubší význam. Jak se můžete u některých knih přesvědčit, ne všechny obsahují recenzi. Pokud bych poté chtěl naplnit vlastnost <em>Reviews</em> přímo a to odkazem na element <em>EditorialReviews</em> obdržel bych výjimku, konkrétně <a href="http://msdn.microsoft.com/en-us/library/system.nullreferenceexception.aspx">NullReferenceException</a>, a to se mi zrovna nehodí. Proto jsem si odkaz na tento element uschoval do proměnné a v okamžiku potřeby přirazení do vlastnosti <em>Reviews</em> jej kontroluji a případně vytvořím pouze prázdný generický <a href="http://msdn.microsoft.com/en-us/library/6sh2ey19.aspx">List&lt;T&gt;</a>.</p> <h4>Scházející elementy</h4> <p>Do obdobné situace jsem se potom dostal v případě, že jsem se snažil naplnit vlastnosti, avšak ve zdrojovém xml scházel požadovaný element. Příkladem budiž třeba scházející ISBN kód nebo nevyplněný počet stránek knihy. V případě ISBN jsem toto vyřešil pomocí ternárního operátoru, v případě počtu stránek jsem potom opět využil možností přetypovat výsledek na nullable type typu int a pomocí operátoru <strong>??</strong> případně vrátit hodnotu 0.</p> <h3>Jak by to vypadalo</h3> <p>Tento krok by se nejspíše odehrál společně s krokem prvním a to při definici zdroje dat. Určili bychom si, které atributy ze vstupního souboru nás budou zajímat, jakým způsobem jsou tyto atributy provázány, stejně tak si řekli, které atributy jsou povinné a které volitelné. Pokud by k vstupnímu xml souboru bylo definováno <strong>xsd schéma</strong> bylo by to jistě jednodušší.</p> <h3>Časový odhad</h3> <p>Definice doménových objektů a jejich naplnění byl již poměrně rychlý krok. Co bylo spíše nepříjemné je definování vlastností, v čemž jsem s radostí uvítal automatické property. Dalším krokem pak bylo poskládání LINQ dotazu na zdrojové xml. Celkový čas byl odhadem 25 minut + 10 minut testování na vzorku několika stovek záznamů. V případě produktů, které chtěla Petra sledovat by byl čas závislý na tom, kolik atributů by bylo nutné sledovat a mít k nim uložená data.</p> vyzva-definice-zdroje-dat http://jirava.net/blog/Archive/vyzva-definice-zdroje-dat.aspx .net+technology vyzva Jednou z těch obtížnějších překážek na cestě k aplikaci, která ve výsledku vybuduje web z xml exportu bylo najít vhodný zdroj dat. Thu, 18 Sep 2008 08:15:12 +0200 2008-09-18T08:15:12+02:00 &copy; Jarda Jirava 2008 <p>Jednou z těch obtížnějších překážek na cestě k aplikaci, která ve výsledku vybuduje web z xml exportu bylo najít vhodný zdroj dat.</p> <p>Jak jsem již v <a href="http://jirava.net/blog/Archive/vyzva-z-webtrhu.aspx">úvodním příspěvku</a> naznačil, Petra se se mnou nespojila a tak její xml export, ze kterého se měl web vytvořit jsem neměl k dispozici. Co bylo řečeno, že dané xml bude obsahovat přibližně 500 produktů s atributy.</p> <h3>AWSE</h3> <p>Když jsem tedy přemýšlel nad tím, jaký zdroj dat použít, vzpoměl jsem si na ukázkový příklad <a href="http://community.infragistics.com/exemplars/tangerine.aspx">tangerine</a> od Infragistics. Ten pracoval nad veřejnou částí služeb poskytovaných <a href="http://www.amazon.com">Amazon.com</a>, konkrétně nad <a href="http://www.amazon.com/E-Commerce-Service-AWS-home-page/b/ref=sc_fe_l_2/104-2910409-3551969?ie=UTF8&amp;node=12738641&amp;no=342430011&amp;me=A36L942TSJ2AJA">AWSE</a>. Po bližším prozkoumání se dá zjistit, že je možné vytvořit si v .net webovou referenci s použitím wsdl a vytvořit si tak proxy na tuto službu.</p> <p>Úkolem však nebylo takto jednoduše přistupovat k datům, v daném požadavku přeci bylo, že je třeba vytvořit web z xml exportu. A tak jsem našel odkaz na <a href="http://docs.amazonwebservices.com/AWSEcommerceService/2007-01-17/">dokumentaci</a> a z ní zjistil, že je možné k webové službě přistupovat i pomocí <a href="http://en.wikipedia.org/wiki/Representational_State_Transfer">REST</a>u (<a href="http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm">Representational State Transfer</a>) a získat tak výstup v xml.</p> <p>Poté již stačilo vhodně nakombinovat parametry a vytvořit volání pro získání potřebných zdrojových dat.</p> <p>Výsledná URL, pomocí níž tedy získávám data o knihách je následující</p><pre class="csharpcode">http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService&amp;AWSAccessKeyId={0}&amp;Operation=ItemSearch&amp;Version=2007-07-16&amp;ResponseGroup=Medium&amp;SearchIndex=Books&amp;Keywords={1}&amp;ItemPage={2}</pre> <p>Prvním parametrem, který doplňuji za běhu aplikace je tak <em>AWSAccessKeyId</em>, které je uloženo v konfiguračním souboru aplikace. Tento klíč je přidělen každému, kdo se zaregistruje na stránkách amazon.com pro využívání jejich služeb.</p> <p>Dále je možné si všimnout, že volám operaci <em>ItemSearch</em> a požaduji zaslání středního výpisu všech dat, což je pro můj vzorový případ dostačující. Dále je uvedeno, jak jsem se již zmínil, že chci získat pouze knihy a to s mnou definovaným klíčovým slovem, což jsem zvolil jako parametr závislý na uživatelově volbě. Posledním parametrem je potom hodnota <em>ItemPage</em>, která získá i další stránky výsledků.</p> <p>Výhodou tohoto zdroje dat je, že je poměrně obsáhlý, velice dobře zdokumentovaný a přístupný téměř všem, kteří mají touhu projít si se mnou touto výzvou.</p> <h3>Jak by to vypadalo</h3> <p>Zde by se slušelo upozornit, že takto jednoduché by to nejspíše s Petrou nebylo. A i při získání takové zakázky by právě definice dat byla jednou z těch obtížnějších překážek. Právě tento krok by hodně určoval, jak dlouhou dobu bude tento projekt trvat. Také se zde může nejvíce projevit rozdíl mezi začátečníkem, nebo ne příliš zkušeným analytikem.</p> <h3>Časový odhad</h3> <p>Dohledání zdroje dat, nastudování dokumentace a prostudování výstupních xml souborů trvalo přibližně 90 minut. Myslím si, že sezení se zákazníkem typu Petra, který ví co chce a očekává za výsledek, by nemělo zabrat u obdobného projektu více jak 120 minut. Samozřejmě zde hodně záleží na složitosti vstupního xml souboru.</p> vyzva-z-webtrhu http://jirava.net/blog/Archive/vyzva-z-webtrhu.aspx .net+technology vyzva Jak také může skončit jedna celkem nevinná reakce na poptávku jednoduchého systému pro tvorbu webu z xml exportu. Tue, 16 Sep 2008 08:15:40 +0200 2008-09-16T08:15:40+02:00 &copy; Jarda Jirava 2008 <p>Konec kr&#225;sn&#233;ho slunečn&#233;ho počas&#237;, kter&#233; n&#225;s prov&#225;zelo cel&#233; l&#233;to je spr&#225;vn&#253;m časem zač&#237;t se věnovat někter&#253;m v&#253;zv&#225;m a předsevzet&#237;m, kter&#233; jsem si dal je&#353;tě na jaře.</p> <p>Pr&#225;vě jednu takovou v&#253;zvu jsem si si vzal z <a href="http://webtrh.cz">webtrhu</a>, kdy se je&#353;tě v Březnu ptala <a href="http://webtrh.cz/member.php?u=6">Petra</a>, zda by bylo možn&#233; <a href="http://webtrh.cz/5869-obnasi-udelat-xml-exportu-web">vytvořit web na z&#225;kladě xml exportu</a>. Po přečten&#237; jej&#237;ho požadavku jsem si dovolil skromně podotknout, že na vytvořen&#237; jednoduch&#233; aplikace bych potřeboval přibližně 5 hodin pr&#225;ce. Což se samozřejmě setkalo s patřičnou odezvou a tak vznikla tato v&#253;zva.</p> <p><a href="http://vetrovka.cz/">Petra</a> od t&#233; doby nic nepopt&#225;vala a tak jsem si jej&#237; zad&#225;n&#237; maličko upravil do potřeb pro seps&#225;n&#237; jednoduch&#233;ho n&#225;vodu k tomu, jak takovou aplikaci s pomoc&#237; <strong>.net frameworku ve verzi 3.5</strong> vytvořit. Vzniklo tak několik, na sebe navazuj&#237;c&#237;ch d&#237;lů, kter&#233; postupně d&#225;vaj&#237; dohromady funkčn&#237; syst&#233;m pro vytvořen&#237; webu.</p> <p>Přizn&#225;v&#225;m hned na zač&#225;tku, že zad&#225;n&#237; jsem si zřejmě př&#237;li&#353; zjednodu&#353;il a je tedy možn&#233;, že v&#253;sledn&#225; aplikace by byla složitěj&#353;&#237;, jako demonstrace toho, že je v&#353;ak možn&#233; takovou aplikaci napsat a to velice jednodu&#353;e a efektivně, nav&#237;c s dodržen&#237;m potřebn&#233;ho a deklarovan&#233;ho času je to mysl&#237;m vhodn&#225; uk&#225;zka.</p> <p>Pojďme se tedy pod&#237;vat na to, o čem budu hovořit:</p> <ul> <li>definov&#225;n&#237; zdroje dat jako export pro web </li> <li>definice dom&#233;nov&#253;ch objektů a jejich naplněn&#237; z xml </li> <li>zprovozněn&#237; publikačn&#237;ho syst&#233;mu <a href="http://wordpress.org/">WordPress</a> </li> <li>napojen&#237; aplikace na rozhran&#237; publikačn&#237;ho syst&#233;mu </li> <li>vytvořen&#237; lok&#225;ln&#237; datab&#225;ze publikovan&#253;ch čl&#225;nků </li> <li>&#353;ablonov&#253; syst&#233;m pro publikaci čl&#225;nků </li> <li>kompletace jednotliv&#253;ch modulů do funkčn&#237;ho celku </li> </ul> <p>Čl&#225;nky m&#225;m v současn&#233; chv&#237;li již připraveny a jejich publikace je napl&#225;nov&#225;na na &#250;ter&#253; a čtvrtek, proto př&#237;padně omluvte nedostatky, kter&#233; se mohou objevit a i to, že v jednotliv&#253;ch čl&#225;nc&#237;ch nebudu reagovat na př&#237;padn&#233; připom&#237;nky nebo dotazy. V př&#237;padě potřeby se pokus&#237;m vložit nějak&#253; vysvětluj&#237;c&#237; čl&#225;nek.</p>