-*- auto-fill -*- ################ # XML struktur # ################ Templates skal indeholde strukturer, men ingen makroer. En template indeholder et course (forl�b), som refererer til makroer, vha. navn. I makroreferencerne st�r dependencies og optional/required. Makronerne findes seperat i egne filer, s� de kan genbruges i flere forl�b uden duplikering. Makroerne indeholder queries og maps til de widgets de indeholder. Specielle include makroer skal stilles til r�dighed for makroerne som bets�r af klumper af widgets som kan inds�ttes i en makro. Disse skal ligeledes lagres i seperate filer. Include makroerne skal v�re self contained, dvs. de skal selv indeholde de queries og maps de skal bruge. Kan include makroerne undv�res hvis man blot lader includes inkludere andre makroer? Hvad er den egentlige forskel p� en includemacro og en macro? Hvis include blot er en anden makro, hvor det eventuelle ydre vindue ignoreres, kan deciderede include makroer helt undv�res. Makroer kan skrives med det form�l at de skal inkluderes, hvormed deres ydre vindue helt undlades. For at det skla kunne lade sig g�re skal det ydre vindue ikke v�re p�kr�vet i specifikationen Hvordan skal klienten reagere hvis den modtager en makro uden ydre vindue? En l�sning kan v�re blot at bruge den yderste widget som vindue. En anden l�sning kan v�re at ignorere makroen (Der er alligevel forksel hvad der accepteres p� serverens xml og klientens xml). Et tag includeable kan overvejes, s� det kun er makroer der er designede til det som kan inkluderes. ############################# # Pracro database interface # ############################# Databasen skal dybest set kunne 2 ting: skrive commits og genindl�se gamle v�rdier til preudfyldning af makroer. Database modulet skal kunne oprettes uden at det connectes, og disconnectes explicit, med henblik p� genbrug af connection, for at spare tid i udf�rslen af en request. Skal database objektet lave en connection pr. transaktion? Eller skal der laves et system med en connection pool? Det afh�nger naturligvis af om det er hurtigt nok med en connection pr. transaktion. Alle opslag skal laves initielt, og s� skal queries efterf�lgende laves 'lokalt', i et result set (std::map eller lign.). ################### # Svar fra server # ################### Svaret fra pracro serveren til klienten skal udover svar p� eventuelle makro queries indeholde en liste af errorcodes tilh�rende de atomare elementer i transaktionne, specielt commits. Det er vigtigt at man p� klienten kan f� at vide hvis der gik noget galt i en commit. ############ # Ordliste # ############ forl�b: course makro: macro skabelon: template ####################################### # Navngivning af markoerne i requests # ####################################### En makro er nested indeni en template paa serversiden. Makroen er logisk nested indeni en macrosequence. Templatesne er navngivet efter den macro sequence den indeholder. Man skal referere til baade macrosequencen og macroen for at faa fat i den. Eksempel: <request macrosequence="forundersoegelse" macro="stamdata"/> ################## # Makro editoren # ################## Den skal kunne uploade makroer/templates til serveren, som validerer dem inden de lagres. Under lagringen skal versioneringen samtidig foregaa. Editoren skal laese makroerne/templatesne direkte fra serveren, saa en servernaer editering bliver bibeholdt, blandt andet med henblik paa versionering. ################### # Makro templates # ################### En makro template best�r af fire dele: 1: Header 2: Queries 3: Maps 4: Widgets Headeren indeholder alle overordnede info, s�som cpr nummer og makro version. Queries udf�res af serveren een gang og resultaterne mappes til nogle symboler som kan bruges i value felterne i widgets sektionen. Der skal v�re mulighed for simpel aritmetik i mapningsfunktionerne. Widgets sektionen er som beskrevet andetsteds. ########### # Queries # ########### For hver makro er der defineret en raekke queries. For at en query skal give mening, skal der v�re en stor m�ngde klasser man kan lave requests p�. Disse klasser skal tilsammen beskrive al apparatur p� afdelingen, hiraktisk, s� man f.eks kan bede om "lensmeter" eller en konkret model. En nedarvningsmodel kan bruges som inspirationskilde. Der skal v�re mulighed for at h�fte flere klasser p� det samme apparat, idet nogle apparater m�ler mere end een ting. (ala multipel nedarvning.) En attribute "automap" soerger for at lave en default 1:1 mapning mellem vaerdier i resultatet og value namespacet. Disse vil blive overskrevet af maps ved eventuelle overlap i navnene. Eksempel paa en query til pentominos: <query ttl="86400" class="lensmeter" automap="true"/> Queries til pracro serveren selv bliver automatisk udfoert vha. tag navnet i wigdets sektionen. Alle queries sker til pentominos. Hvis der bliver behov for at traekke data andre steder fra, skal dette ske via pentominos, istedet for direkte (Det er hele tanken bag pentominos, at den skal vaere samlingspunkt for alle taenkelige dataudtraek). Sproget i en query som laver mapningen. -> class, cpr, timestamp (oldest) <- xml formateret <?xml version="1.0" encoding="UTF-8"?> <results> <result timestamp="1234567890"> <group name="fisk"> <value name="dims" value="42"/> <value name="fnuller" value="blah"/> </group> <group name="ostemad"> <value name="dims" value="42"/> <group name="olm"> <value name="fnuller" value="blah"/> </group> </group> </result> </results> Mapningerne kan s�ledes laves 1:1 fisk.dims, fisk.fnuller, ostemad.dims og ostemad.olm.fnuller. Eksempler p� mapninger: <map name="myvalue"> return 2 * fisk.dims </map> <map name="anothervalue"> return math.sin(fisk.dims / math.pi) + 42 </map> Mapningssproget: LUA En simpel map kan overvejes at bruges til enkelte expressions (det er muligvis de simple som skal hedde map og de avancerede som skal hedde complexmap). De simple kan i koden pakkes ind i en return statement: <map name="myvalue" value="2 * dimmer"/> bliver til "return 2 * dimmer" som LUA kode. De komplekse bliver ikke pakket ind i noget: <complexmap name="myvalue"> function recurser( var ) recurser( tail(var) ) return head( var ) end return recurser( [1, 2, 3, 4] ) </complexmap> En endnu simplere map kan bruges ved 1:1 mapninger: <simplemap name="myvalue" value="dimmer"/> Denne map type skal ikke engang koeres igennem LUA, men kan blot udfyldes direkte. Hvis der performance maessigt ikke er nogen forskel paa map og simplemap kan simplemap helt undlades, for at bibeholde simpliciteten i serverkoden. ###################################### # Preudfyldning af felter i en makro # ###################################### Preudfyldningen skal ske serverside. Det skal indikeres i feltet at det er preudfyldt og den information skal lagres sammen med dataene naar de senere bliver gemt paa serveren efter en commit. Hvis preudfyldte felter aendres paa klienten, skal dette indikeres i de lagrede data. Skal den preudfyldte vaerdi lagres, saa man altid kan se hvad det foreslaaede var? Data som allerede eksisterer paa serveren: Hvis et felt allerede findes paa serveren fra en tidligere indtastning og dens ttl ikke er overskredet, skal feltet preudfyldes med denne vaerdi. TTLerne? Hvem skal saette dem? Hvor skal de saettes? Hvis de saettes paa feltet paa kontruktionstidspunktet, uafhangig af kilden, betyder det at feltet har samme udloebstid uanset om det er manuelt indtastet, eller indlaest fra en ekstern kilde. Et felts ttl vil nok vaere defineret uafhaengigt af kilden, saa ovenstaeende loesning kan sikkert vaere fin nok. Data som kommer fra eksterne kilder (Pentominos): Et flest skal have en eller flere properties som indikerer at feltet skal udfyldes fra en ekstern datakilde. Disse properties skal beskrive hvilken kilde dataene skal hentes fra, samt hvor gamle dataene maksimalt maa vaere. %% %% Flg. er slettet %% % En maade at goere det paa kunne vaere at kalde en ekstern applikation % (via. popen eller lign.) som spytter data ud paa stdout i et af % pracro velkendt format. % Parametrene til dette eksterne program kan saa styres vha. af en % lignende mekanisme som i formatet til journal resumeet ($$, ${cpr}, % ${firstname}, etc). % % En anden maade at goere det paa kunne vaere at lave et indbygget % kommandosaet som kan tage en raa streng som parameter, som derved % fungerer som kald til et eksternt program, bortset fra at der kaldes % en intern rutine istedet. % % En tredie maade, som er en afart af den anden maade, vil vaere at % lave kommandsaet baseret udelukkende paa kilde. [kilde]/[apparat]/[parameter] % ex. pentominos/lensmeter/axis % Problem: Hvordan skelnes mellem flere ensnavngivne parametre? % I lensmeter findes axis parameteren principielt to gange, een gang % for hoejre og een gang for venstre linse. Hvis der baade eksisterer data paa serveren og findes ekstern data. Dataene paa serveren har precedens over data fra eksterne kilder, hvis: a) Dataene paa serveren er nyere end dem fra den eksterne kilde. b) Dataene paa serveren er indtastet af en bruger og stadig gyldige. Hvis der hverken findes gyldig data (ikke eksisterende eller udloebet) paa serveren eller fra den eksterne kilde (igen ikke eksisterende eller udloebet) benyttes value feltets indhold. %% %% Flg. er slettet %% %Pentominos data eksempel: % Serveren laeser: % <lineedit name="dioptri_odex" % source="pentominos/lensmeter" % command="cliclient --cpr=${cpr} query --filter=latest --deviceid=lensmeter --devicetype=lensmeter --format=xml" % ttl="86400" % value=""/> % % Serveren oversaetter dette til: % <lineedit name="dioptri_odex" % value="4" % source="pentominos/lensmeter"/> % %Taenkt eksempel med et fundus billede: % Serveren laeser: % <image name="dioptri_odex" % source="pentominos/fundus" % command="cliclient --cpr=${cpr} query --filter=latest --devicetype=fundus --format=raw" % ttl="86400" % value="SOMERAWJPEGCODEINBASE64-9823fasd73487234fas7asd8732487asd8fc7sd8f76328732"/> % % Serveren oversaetter dette til: % <image name="dioptri_odex" % value="SOMERAWJPEGCODEINBASE64-9823fasd73487234fas7asd8732487asd8fc7sd8f76328732" % source="pentominos/lensmeter"/> ################################### # Avanceret validering af widgets # ################################### LUA Ide: LUA som validering, sat i serie med en regexp validering. Begge kan vaere tomme, eller udeladt (svarende til tomme). Hver widget optraeder automatisk som preloaded variabel i lua programmet. Programmet indeholder en funktion validate som returnerer true eller false afhaengigt af om den er valid eller ej. Hvad med reserverede karaterer i hhv. LUA og XML? skal lua koden base64 enkodes? Eller maaske bare XML kodes (i.e. " osv.) Hvornaar skal koden udfoeres? Naar feltet aendres? Naar feltet forlades (lost focus) eller inden makroen comittes? Flere funktioner kan introduceres for at kunne udfoere lua kode paa forskellige tidspunkter (onfocus(), onfocusleave(), onchange(), beforecommit(), etc...) Istedet for at bruge direkte mapninger mellem variable og widgets kan man bruge et array (eller hvad der nu svarer til map< std::string, std::string > i c++), saa man slipper for at overskrive nogen af LUAs interne variable og funktioner. Hvis der ikke findes en saadan type i LUA kan man lave et funktionkald ind i c koden som goer det, altsaa field('varname') Injicering af data i makroen paa runtime. Et funktionskald fra lua programmet saetter vaerdien af et felt. En serie af funktioner kan introduceres til at kontrollere GUI igennem LUA. Funktioner som disable('button1'), uncheck('checkbox2'), osv. Disse funktioner skal bruges til at lave selve makroindholdet dynamisk, saa man f.eks vaelger en radiobutton som aktiverer en hel undersektion af lineedits. Alt dette kan muligvis implementeres vha. checkbox/radiobutton grupper istedte, saa man slipper for denne forholdsvis dybe kontrol paa LUA niveau (laes, der er mange muligheder for fejl!) Eksempel: <lineedit name="dioptri_odex" regexp="[1-9][0-9]{0,2}" lua="function validate() return math.abs(fields['dioptri_odex'] - fields['dioptri_osin']) < 3 end" value="" help="Dioptrien p� venstre �je skal v�re max 2 dioptri fra h�jre."/> <lineedit name="diotri_osin" regexp="[1-9][0-9]{0,2}" lua="function validate() return math.abs(fields['dioptri_odex'] - fields['dioptri_osin']) < 3 end" value="" help="Dioptrien p� h�jre �je skal v�re max 2 dioptri fra venstre."/> ################################## # Forl�b og deres struktur i xml # ################################## Makro er en del af et forl�b Forl�b skal sammens�tte makroer i logiske sekvenser. - Backward dependancy - Forward dependancy - Optional - Required Et forl�b beskrevet som et komplet xmldokument? - Alle makroer er indeholdt i et st�rre dokument, forl�bet. - N�r data postes, lagres forl�bs id sammen med makro id'et. - Der er indbygget i xml strukturen en logisk sammenh�ng mellem makroerne (dependencies o. lign.). Eksempel: <forl�b> <makro navn="makro1" completed="true" optional> ... </makro> <makro navn="makro2" depencies="makro1" required> ... </makro> <makro navn="makro3" depencies="makro2" optional> ... </makro> <makro navn="makro4" optional> ... </makro> <makro navn="makro5" optional> ... </makro> <makro navn="makro6" depencies="makro1,makro5" required> ... </makro> </forl�b> Eksempel med B2 forloebet i pseudokode: B2 req B21 dep=B2 opt B22 - B26, B28 dep=B2,B21 opt B27 dep=B2,B21 req B29 dep=B27 req ############################################# # CPR indtastning, hvordan? hvor? hvornaar? # ############################################# 1) - CPR nummeret hentes fra sygesikringsbevis eller RFID eller lign. - Det sendes til cpr server (ligesom paa barcode) - Naar et apparat skal sende data henter det foerst cpr nummeret vha. sit lokationnummer. 2) - CPR nummeret hentes fra sygesikringsbevis eller RFID eller lign. - Det sendes til pentominos med lokationsnummer som raa data som alle andre apparater. - Naar der sendes data fra et andet apparat vedhaeftes kun lokationkoden, og det er pentominos serverens ansvar at vide hvilket cpr nummer der skal bruges. 3) - CPR nummeret hentes fra sygesikringsbevis eller RFID eller lign. - Nummeret lagres lokalt paa den Soekris kassen. - Naar der sendes apparatdata vedhaeftes det lagrede cpr nummer. 4) - CPR nummeret hentes fra sygesikringsbevis eller RFID eller lign. - Nummeret sendes til en server sammen med et lokationsnummer. - Serveren har registreret hvilkemaskiner der findes paa den lokation og broadcatser cpr nummeret til disse. 5) - CPR nummeret hentes fra sygesikringsbevis eller RFID eller lign. - Det sendes til cpr server (ligesom paa barcode) - Naar der sendes data fra et andet apparat vedhaeftes kun lokationkoden. - Pentominos serveren henter cpr nummeret fra cpr serveren vha. den vedhaeftede lokationskode. Overvejelser: a - Data og kilde (cpr nummer) boer holdes samlet. b - Hvem har ansvaret for at cpr nummer og data haenger sammen. c - Hvem har ansvaret for at cpr nummer og data er rigtige? d - Fordele/ulemper ved at have een cpr indtastningsmekaniske pr. Soekris boks. e - Hvilken vej koerer forbindelserne? Kan de fungere igennem en firewall? f - Hvor mange forbindelser er der? g - Boer forbindelserne holdes i live fremfor at lave nye hver gang der skal kommunikeres? h - Hvilke muligheder vil vi have for central logning af hvor patienter bliver 'logget ind'? i - Hvor og hvordan skal cpr numrenes ttl implementeres?