u DB2 jsme aktivovali úlohy REORG (indexování dat a defragmentace tabulek) a RUNSTATS (optimalizace přístupu k datům). Aktivace se provede v následujícím způsobem

spustím Health Center, poté spouštím Configure Automatic Maintenance

procházím wizardem…, na straně 3.Timing mohu definovat, kdy úlohy poběží a v bodě 5.Activities nastavím REORG a RUNSTATS na automate

dvojklik do řádku REORG a v záložce Reogatization options  změním na online

pokračuji wizardem do bodu 6.Summary, tlačítkem Finish úlohy aktivuji

Rád uvítám další tipy na zlepšení výkonu Lotus Quickru.

Pro tento případ se hodí použití knihovny (tedy příkaz “Use”) použít až po stisknutí tlačítka a to pomocí příkazu Execute. Nejedná se z programátorského hlediska o úplně čistou operaci, ale k tomu se občas programátor musí uchýlit. Klasický příklad je použití knihoven z Lotus Workflow:

rem ... nějaký kód před
 
Call doc.Replaceitemvalue("WFAction", "approve")
 
Execute |
Use "OS AgentBase"
Call LWFExecuteNotesAction ("ActivityCompleteSRClick","")
|
 
rem nějaký kód po ...

Problém nastává hlavně při ladění – jednoduše to ladit nelze. Takže doporučuji vývoj klasickou cestou a ve fázi optimalizace kódu vybrané (a odladěné) části přepsat do Execute.

@DbCommand("qkr":"NoCache"; "InsertLink");

Musíme upřesnit, že tato akce bude funkční pouze pokud jsou nainstalovány Quickr konektory. Na formuláři, kam chceme link vložit, je nutné mít nějaké richtextové pole, umístit do něj kurzor a poté spuštěním výše uvedené formule je zobrazen dialog výběru souboru z Quickru. Po výběru a potvrzení je do richtextového pole vygenerován obsah viz obr. Nás zajímá hlavně link, který je zde obsažen. Lze ho pomocí práce s textem vyextrahovat (pole musí mít nastaveno ukládání obsahu jako html) a uložit kam potřebujeme. V naší aplikaci máme kód pro umístění kurzoru, zobrazení dialogu a vyextrahování linku celý právě ve zmíněné akci pro přidání souboru z Quickru. Když máme získaný tento link, je dále možno např. po dvojkliku na dokument ve vloženém pohledu tento soubor rovnou pomocí REST services stáhnout z Quickru a spustit (zobrazit) nebo např. plánovaný agent může v předem stanovaném okamžiku (např. v průběhu workflow) soubor stáhnout, připojit k mailu a odeslat.

Uvedený formula kód využívá knihovnu ndbqkr.dll, která je po nainstalování Quickr konektorů uložena v programovém adresáři Lotus Notes.

Knihovna obsahuje i další funkce, které však již nejsou tak efektivně využitelné (spíše z neznalosti) nebo je nelze pomocí @DbCommand(”qkr”.. použít. Zde je přehled fukcí, které knihovna obsahuje:

PROMPTSENDATTACHMENTLOCATION – zobrazí výběr složky, po potvrzení neznámý výsledek
SAVEATTACHMENTS – pokud je kurzor v richtextovém poli obsahujícím přílohy, zobrazí dialog, kam soubory uložit (+volba, zda si přejeme soubor v LN nahradit pouze jeho linkem) a po potvrzení je uloží
GETSENDATTACHMENTOPTION – neznámý výsledek
SETSENDATTACHMENTOPTION- neznámý výsledek
DISPLAYPREFERENCES- zobrazí uživatelské nastavení konektorů
INSERTLINK- akce z našeho příkladu

přičem obecný zápis formule je:

@DbCommand("qkr":"NoCache"; "SaveAttachments"; [list of note IDs]; [source db server]:[source db path]; [display status]; [display errors]; [refresh current UI note]);

Hlavní problém je v tom, že nikde nelze nalézt oficiální dokumentaci, která by nám použití těchto funkcí značně usnadnila.

V portálovém Quickru tato automatická funkce chybí, lze ji ale celkem jednoduše nasimulovat – a to pomocí RSS feedů.

1. Nejdříve je třeba nalézt “posledně přidané” dokumenty – asi nejjednodušší je si vytvořit pohled všech dokumentů, který setřídíme sestupně podle data modifikace
2. Po otevření tohoto pohledu se nám vpravo dole nabídne “Subscribe” – kliknutím se otevře stránka s RSS – zkopírujeme si URL
3. A nakonec si do našeho místa vložíme novou komponentu “Feed Reader” přes menu Customize, nazveme ji třeba Novinky a vložíme zkopírované URL z bodu 2
4. Výsledek je vidět na obrázku:

Najskôr malé zhrnutie, ako je možné z databázy dostať dáta štandardnými spôsobmi:

1. Kópia / replika celej databázy

3. Kopírovanie dokumentov – Ctrl + C, Ctrl + V

4. Export – buď pohľadu, alebo nejakého konkrétneho dokumentu

5. Tlač

6. Screenshot

Kópia / replika celej databázy

S týmto nám pomôže ACL, konkrétne možnosť “Replicate or copy documents”, ktorá sa dá nastaviť u užívateľov od Depositora až po Managera. Ak daný užívateľ túto voľbu v ACL nemá zapnutú, každý pokus o vytvorenie kópie alebo repliky skončí chybovou hláškou “You are not authorized to perform this operation.”. Toto nastavenie zabráni aj kopírovaniu dokumentov pomocou Ctrl+C, Ctrl+V.

Kopírovanie dokumentov, exporty, tlač

Druhý spôsob ako zabrániť kopírovaniu dokumentov, je nenápadný checkbox na poslednej záložke nastavenia formulára.

Dokumenty vytvorené pomocou formulára s takýmto nastavením majú automaticky vytvorené pole s názvom $KeepPrivate a hodnotou 1. Takéto dokumenty nie je možné vytlačiť, kopírovať ani exportovať nezávisle na právach pridelených v ACL. Po menšom testovaní som ale zistil, že toto nastavenie má 2 nedostatky.

Dokumenty označené $KeepPrivate je možné vytlačiť v pohľade voľbou Print selected view. Ďalším nedostatkom je, že toto pole je možné zmazať napr. agentom, alebo magickým tlačítkom. Vyjadrenie IBM je, že sa nejedná o “security feature”, takže to nie je vhodné na zabezpečenie, každopádne je dobré vedieť, že niečo také existuje.

Takto zabezpečené je možné odosielať aj maily, stačí v Delivery options zapnúť Prevent copying.

Screenshot

Užívateľom s operačným systémom Windows je možné zakázať vytváranie screenshotov pomocou nasledujúceho kódu v LotusScripte. Autorom je  Charles Robinson a viac informácií sa je možné dozvedieť v jeho článku (v angličtine).

Napr. ak nechceme aby užívatelia vytvárali screenshoty v nejakom pohľade, pridáme do Declarations pohľadu tento kód.

Declare Function FindWindowByClass Lib "user32" Alias "FindWindowA" (Byval lpClassName As String, Byval lpWindowName As Long) As Long
Declare Function GetTickCount Lib "kernel32" () As Long
Declare Function RegisterHotKey Lib "user32" (Byval hWnd As Long, Byval id As Long, Byval fsModifiers As Long, Byval vk As Long) As Long
Declare Function UnregisterHotKey Lib "user32" (Byval hWnd As Long, Byval id As Long) As Long
Declare Function GlobalAddAtom Lib "kernel32" Alias "GlobalAddAtomA" (Byval lpString As String) As Long
Declare Function GlobalDeleteAtom Lib "kernel32"   (Byval nAtom As Long) As Long
Declare Function GetActiveWindow Lib "user32" Alias "GetActiveWindow" () As Long
 
Const VK_SNAPSHOT = &H2C
 
Const  MOD_ALT = &H1
Const  MOD_CONTROL = &H2
Const  MOD_SHIFT = &H4
 
Dim g_hWnd As Long
Dim g_Print As Long
Dim g_AltPrint As Long
Dim g_CtrlPrint As Long
Dim g_ShiftPrint As Long

Do QueryOpen:

'Get a handle to the Notes client window so you can tell Windows which window to hook the hotkeys to
g_hWnd = FindWindowByClass("Notes", 0)
 
'Register new identifiers for our custom hotkeys.  GetTickCount returns a number that's based on the system clock,
'     so you know it won't be duplicated.
g_Print = GlobalAddAtom(Cstr(GetTickCount))
g_AltPrint = GlobalAddAtom(Cstr(g_Print) + Cstr(GetTickCount))
g_CtrlPrint = GlobalAddAtom(Cstr(g_AltPrint) + Cstr(GetTickCount))
g_ShiftPrint = GlobalAddAtom(Cstr(g_CtrlPrint) + Cstr(GetTickCount))
 
'Now register the hotkeys
Call RegisterHotKey(g_hWnd, g_Print, 0&, VK_SNAPSHOT) 'PrintScreen
Call RegisterHotKey(g_hWnd, g_AltPrint, MOD_ALT, VK_SNAPSHOT) 'Alt+PrintScreen
Call RegisterHotKey(g_hWnd, g_CtrlPrint, MOD_CONTROL, VK_SNAPSHOT) 'Ctrl+PrintScreen
Call RegisterHotKey(g_hWnd, g_ShiftPrint, MOD_SHIFT, VK_SNAPSHOT) 'Shift+PrintScreen

A do QueryClose:

Call UnregisterHotKey(g_hWnd, g_Print)
Call UnregisterHotKey(g_hWnd, g_AltPrint)
Call UnregisterHotKey(g_hWnd, g_CtrlPrint)
Call UnregisterHotKey(g_hWnd, g_ShiftPrint)
 
'Delete our custom entries
Call GlobalDeleteAtom(g_Print)
Call GlobalDeleteAtom(g_AltPrint)
Call GlobalDeleteAtom(g_CtrlPrint)
Call GlobalDeleteAtom(g_ShiftPrint)

Hlavnou nevýhodou tohoto prístupu je, že vytváranie screenshotov je vypnuté pre celý systém až do zavolania kódu ktorý je v predchádzajúcom príklade v QueryClose, čo môže niektorých užívateľov trochu zmiasť. Ďalej tento kód funguje na princípre preregistrovania klávesových skratiek, čo znamená, že bude stále možné vytvárať screenshoty rôznymi utilitami.

Ak by ste vedeli o nejakej ďalšej technike, ktorú som v článku nespomínal, podeľte sa o ňu pomocou komentáru a ja článok rád rozšírim.

Při vypínání J2EE Quickru (z konzole i pomocí services) se WAS ptá na heslo wpsadmina – vyžaduje se zásah uživatele, což je dost hloupé. Heslo je možné zadat do konfiguračního souboru soap.client.props, ale je jasné, že v otevřeném formátu není dobrý nápad ho tam psát. Doporučuje se řádku s heslem zašifrovat.

Technické řešení:

v adresáři wp_profile/bin nalézt encodovací utilitku PropFilePasswordEncoder.bat – co provádí?

• pomocí nějakého klíče (jakého MD5?) zašifruje zadanou řádku jakéhokoliv konfiguračního souboru
• WAS je schopen si tento řádek rozšifrovat, ale uživateli se tento řádek jeví jako zmatek – něco jako com.ibm.SOAP.loginPassword={xor}CB4MLz4sLCgwLTs\=

Heslo se zadává do souboru wp_profile/properties/soap.client.props:

1. vypnete Quickr
2. zazálohujete tento soubor (klidně do toho samého adresáře s příponou bak)
3. naleznete (nebo doplníte) řádky:
   • com.ibm.SOAP.loginUserid=wpsadmin #username WAS admina
   • com.ibm.SOAP.loginPassword=heslo #heslo WAS admina v nezašifrované podobě
4. zašifrujete v tomto souboru řádku s heslem – spustíte si command line, vlezete do adresáře wp_profile/bin a napíšete:
   • PropFilePasswordEncoder.bat ../properties/soap.client.props com.ibm.SOAP.loginPassword
5. zapnete Quickr přes services
6. zkusíte vypnout Quickr přes services – mělo by vše proběhnout samo (stejně tak v příkazové řádce)

Prošel jsem všechny logy, ale jednoznačné řešení jsem z nich nevyčetl. Společně s Petrem Kuncem jsme vytvořili PMR a řešení navržené supportem IBM je naprosto jednoduché a hlavně FUNKČNÍ!!!

Postup:

1. Zastavte WebSphere_Portal server
2. Smažte obsah adresáře C:/IBM/Quickr/PORTAL~1/jcr/search
3. Restartujte WebSphere_Portal server

Zhruba do 30 min server rebuild(uje) index vašeho Quickru. V některých případech je prý třeba “popostrčit” ho vytvořením nového dokumentu, ještě lépe knihovny.

Načítavanie dát a kategorizované pohľady

Ako som už písal, všetky dáta medzi Dominom a prehliadačom sa prenášajú vo formáte JSON. To je umožnené volaním URL príkazu ReadViewEntries, ktorý síce vracia XML, ale má voliteľný parameter OutputFormat=JSON, ktorý spôsobí, že vrátené dáta sú vo formáte JSON a tak sú jednoducho použiteľné v JavaScripte  bez zložitého parsovania. Volaná URL potom vyzerá nasledovne:

http://server/db/pohlad?ReadViewEntries&OutputFormat=JSON

Ukážka vrátených dát s popisom štruktúry:

{
	"@timestamp": "20100406T122630,96Z", //Časová značka
	"@toplevelentries": "21", //Počet dokumentov v pohľade
	"viewentry": [ //Pole obsahujúce jednotlivé záznamy
		{ //Začiatok prvého záznamu
			"@position": "1", //Pozícia
			"@unid": "55077D8D4E8E6F51C12576A9004DF87D", //UNID
			"@noteid": "AB6",
			"@siblings": "21", //Počet dokumentov na rovnakej úrovni
			"entrydata": [ //Pole obsahujúce hodnoty v jednotlivých stĺpcoch
				{
					"@columnnumber": "0", //Číslo stĺpca
					"@name": "Název", //Názov stĺpca
					"text": { //Hodnota / hodnoty (v prípade multivalue)
						"0": "AAA aktivita JW do 60"
					}
				},
				{
					"@columnnumber": "1",
					"@name": "Datum",
					"text": {
						"0": "11.01.2010"
					}
				}
			]
		}
	]
}

Dáta v kategorizovaných pohľadoch sa načítavajú rovnako, akurát sa ešte využíva agent, ktorý vracia zoznam možných kategórií pre výber.

Abeceda

Filtrovanie podľa abecedy funguje na nasledovnom princípe. Každý webový pohľad, ktorý nie je kategorizovaný (v kategorizovaných pohľadoch abeceda nie je) má na začiatok pridaný stĺpec, ktorý kategorizuje dokumenty podľa začiatočného písmena v názve. Viewgenerator potom pri výbere nejakého písmena načítava dokumenty iba z danej kategórie pomocou URL parametru RestrictToCategory. Ak nie je vybrané žiadne písmeno, dokumenty sa načítavajú s kategórie all, ktorá je priradená všetkým dokumentom.

Pri implementácii sme narazili, na jedem menší problém, a to spôsob, akým parameter RestrictToCategory funguje. V prípade, že nenájde žiadne dokumenty v zvolenej kategórií, hľadá inú kategóriu s aspoň čiastočnou zhodou názvu. Napríklad ak neexistujú žiadne dokumenty v kategórii “a”,  volanie RestrictToCategory=a vráti dokumenty z kategórie “all”. Ťažko povedať, či je toto správanie Domina bug, alebo feature, ale rozhodne by nebolo na škodu niečo ako parameter ExactMatch, ktorým by sa toto dalo nastavovať. Tento problém (ale v inom kontexte) už riešil Jake Howlett (codestore.net) v tomto článku.

Radenie podľa stĺpcov

Pôvodne mali radenie podľa stĺpcov zabezpečiť parametre ResortAscending a ResortDescending, ktoré preberajú číslo stĺpca, podľa ktorého má byť pohľad zoradený. Malo to však “menší” háčik a to fakt, že tieto parametre nefungujú v kategorizovaných pohľadoch a nakoľko aj pohľady z užívateľského hľadiska nekategorizované sú na back-ende kategorizované kvôli abecede, nemohli sme tieto parametre použiť.

Tým pádom sme boli nútení uchýliť sa k nie práve elegantnému riešeniu, a to že pre každé radenie máme špeciálny pohľad. Toto je jedna z vecí, ktoré by sme chceli vyriešiť v ďalšej verzii viewgeneratoru.

Stránkovanie

Na stránkovanie sa využívajú URL parametre Start a Count. Parameter Start určuje ktorý dokument bude vrátený ako prvý, pomocou parametru Count sa nastavuje požadovaný počet vrátených dokumentov.

Vyhľadávanie v pohľade

Vyhľadávať v pohľade nie je možné žiadnym z parametrov URL príkazu ReadViewEntries, preto sme si napísali vlastného agenta, ktorý preberie názov pohľadu a vyhľadávaný výraz a vráti výsledky vo formáte JSON. Prevod, na JSON zabezpečuje trieda oddelená od agenta, ktorá do tohto formátu dokáže previesť NotesViewEntryCollection.

Ďakujem všetkým, ktorým sa dočítali až sem. Ak by bolo niekomu niečo nejasné, prípadne by mal záujem dozvedieť sa viac, rád zodpoviem všetky otázky v komentároch a privítam akýkoľvek feedback.

V každém připadě potřebujete bezpečně přesunout data uložená v DB2 databázi. V tom případě by se vám mohl hodit následující postup (pro Windows):

Nejprve korektně zastavíme Lotus Quickr a DB manager

1. Z příkazové řádky, nebo pomocí Start-> Programs -> IBM Lotus Quickr -> Stop the Server zastavte váš WebSpehere_Portal server
2. V menu Start-> Programs -> IBM DB2 najděte nástroj “Control Centre” (patří do General Administration Tools) a spusťte ho
   1. Vlevo klikněte na položku “All Databases” a poznačte si cestu k db, kterou budete přesouvate (sloupec Path)
   2. Rozklikněte strom “All Databases” a vyberte vaši databázi – v mém případě se jmenuje WPSDB
   3. Jakmile na ni kliknete, změní se obsah pravé části okna, klikněte na hotspot Connect
   4. Ve druhém řádku je “DBM State: Started” -> klikněte na hotspot Stop

Vlastní přesun databáze

1. Na cílovém disku vytvoříme adresář, kam budeme naši databázi přesouvat (já použiju adresář TEST)
2. Překopírujte databázi (cestu jste si poznačili) do adresáře TEST
3. Nyní si vytvoříme v notepadu texťák, který použijeme pro migrační nástroj “db2relocatedb”
   1. texťák bude obsahovat:
      DB_NAME=WPSDB
      DB_PATH=C:\, C:\TEST
      INSTANCE=QADMIN
      NODENUM=0
   2. přejmenujte texťák na relocate.cfg
   3. zkopírujte tento soubor do adresáře C:\IBM\Quickr\DB2\Bin
4. V menu Start-> Programs -> IBM DB2 najděte nástroj “Comand Window” (patří do Command Line Tools) a spusťte ho
   1. Zadejte příkaz
      db2relocatedb -f relocate.cfg
5. Pokud se objeví informace “The tool completed succesfully” máte vyhráno

Teď už jen překontrolovat v Control Center zda je cesta k db opravdu změněna C:\TEST a spustit DB manger a Lotus Quickr