From 088e153fefc48e3241964c7941a2ff8bc19b57ba Mon Sep 17 00:00:00 2001 From: deva Date: Thu, 8 May 2008 14:47:58 +0000 Subject: More design of the query/map system. --- server/NOTES | 160 +++++++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 107 insertions(+), 53 deletions(-) (limited to 'server/NOTES') diff --git a/server/NOTES b/server/NOTES index 8e99a1d..d9758b6 100644 --- a/server/NOTES +++ b/server/NOTES @@ -1,10 +1,21 @@ +################## +# 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. + ################### # Makro templates # ################### -En makro template består af tre dele: +En makro template består af fire dele: 1: Header 2: Queries - 3: Widgets + 3: Maps + 4: Widgets Headeren indeholder alle overordnede info, såsom cpr nummer og makro version. @@ -21,7 +32,7 @@ Widgets sektionen er som beskrevet andetsteds. ########### 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 beskive al apparatur på afdelingen, + Disse klasser skal tilsammen beskrive al apparatur på afdelingen, hiraktisk, så man f.eks kan bede om "lensmeter" eller en konkret model. @@ -31,6 +42,21 @@ Der skal v 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: + + +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 @@ -53,17 +79,39 @@ ostemad.dims og ostemad.olm.fnuller. Eksempler på mapninger: - 2*fisk.dims + return 2 * fisk.dims - pi = 3.14 - sin(fisk.dims / pi) + 42 + return math.sin(fisk.dims / math.pi) + 42 -Mapningssproget - LUA? - Simplere (ala bc)? +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: + + bliver til "return 2 * dimmer" som LUA kode. + +De komplekse bliver ikke pakket ind i noget: + + function recurser( var ) + recurser( tail(var) ) + return head( var ) + end + return recurser( [1, 2, 3, 4] ) + + +En endnu simplere map kan bruges ved 1:1 mapninger: + + 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 # @@ -97,31 +145,34 @@ Data som allerede eksisterer paa serveren: Et felts ttl vil nok vaere defineret uafhaengigt af kilden, saa ovenstaeende loesning kan sikkert vaere fin nok. -Data som kommer fra eksterne kilder: +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. - 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. +%% +%% 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, @@ -133,31 +184,34 @@ Hvis der baade eksisterer data paa serveren og findes ekstern data. udloebet) paa serveren eller fra den eksterne kilde (igen ikke eksisterende eller udloebet) benyttes value feltets indhold. -Pentominos data eksempel: - Serveren laeser: - - - Serveren oversaetter dette til: - - -Taenkt eksempel med et fundus billede: - Serveren laeser: - - - Serveren oversaetter dette til: - +%% +%% Flg. er slettet +%% +%Pentominos data eksempel: +% Serveren laeser: +% +% +% Serveren oversaetter dette til: +% +% +%Taenkt eksempel med et fundus billede: +% Serveren laeser: +% +% +% Serveren oversaetter dette til: +% ################################### -- cgit v1.2.3