From a4c00da2a97a942bbeaac25c7300a1e9dfe13fe1 Mon Sep 17 00:00:00 2001
From: deva <deva>
Date: Thu, 27 Sep 2007 10:28:13 +0000
Subject: Added radiobuttons, listbox and combobox to the xml spec.

---
 design/xmlformat.tex | 110 ++++++++++++++++++++++++++++++++++++++-------------
 1 file changed, 82 insertions(+), 28 deletions(-)

(limited to 'design/xmlformat.tex')

diff --git a/design/xmlformat.tex b/design/xmlformat.tex
index 17a80d2..98f26fa 100644
--- a/design/xmlformat.tex
+++ b/design/xmlformat.tex
@@ -38,7 +38,7 @@ Hvis klienten modtager en request sektion skal den blot ignorere den.
 \begin{verbatim}
 <?xml version="1.0" encoding="UTF-8"?>
 <pracro version="1.0" cpr="1505050505">
-  <request makro="visus"/>
+  <request macro="visus"/>
 </pracro>
 \end{verbatim}
 
@@ -253,28 +253,67 @@ En togglebutton har flg. attributter:
   ``false''.
 \end{itemize}
 
-\subsubsection{\texttt{radiobutton} elementet}
-En radiobutton bruges til at vælge et element ud af en gruppe.\\
-En radiobutton har flg. attributter:
+\subsubsection{\texttt{radiobuttons} elementet}
+En radiobuttons gruppe bruges til at vælge et element ud af en gruppe
+via radiobuttons.\\
+Radiobuttons gruppen har flg. attributter:
 \begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i knappen. Hvis
+\item \textit{value} - Inidikerer hvilken radiobutton i gruppen som skal være
+  valgt initielt. Hvis udeladt eller ikke-matchende vil ingen radiobutton være
+  valgt, hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
+  opfyldt.
+\end{itemize}
+Radiobuttons indeholder \texttt{item} tags som beskriver hvilke valgmuligheder
+den givne gruppe har.\\
+Et radiobutton item har flg. attributter:
+\begin{itemize}
+\item \textit{caption} - Den tekst som skal vises i radiobuttonen. Hvis
   udeladt vises radiobuttonen uden tekst.
-\item \textit{value} - Den værdi som radiobuttonen har intielt. Kan
-  ``true'' eller ``false''. Hvis udeladt vil checkboxen få værdien
-  ``false''.
-\item \textit{group} - Et id som beskriver hvilken gruppe
-  radiobuttonen er en del af. Gruppe id'et kan have værdier i
-  \verb|[a-z0-9_]+|.\\
-  Hvis udeladt tilhører den automatisk den samme gruppe som resten af
-  de radiobuttons som befinder sig i samme widget (f.eks frame eller
-  window).\\
+\item \textit{value} - Den værdi som radiobuttonen har og som sendes som værdi
+  af gruppen hvis denne radiobutton er valgt ved commit.
 \end{itemize}
+Ved commit returneres radiobutton gruppens navn med den valgte radiobuttons value.
 
 \subsubsection{\texttt{combobox} elementet}
-Kommer snart...
+En combobox gruppe bruges til at vælge et element ud af en gruppe.\\
+En combobox har flg. attributter:
+\begin{itemize}
+\item \textit{value} - Inidikerer hvilket element i gruppen som skal være
+  valgt initielt. Hvis udeladt eller ikke-matchende vil comboboxen være tom,
+  hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
+  opfyldt.
+\end{itemize}
+Comboboxen indeholder \texttt{item} tags som beskriver hvilke valgmuligheder
+den givne gruppe har.\\
+Et combobox item har flg. attributter:
+\begin{itemize}
+\item \textit{caption} - Den tekst som skal vises for denne valgmulighed. Hvis
+  udeladt vises den uden tekst.
+\item \textit{value} - Den værdi som valgmuligheden har og som sendes som værdi
+  af gruppen hvis den er valgt ved commit.
+\end{itemize}
+Ved commit returneres comboboxens navn med det valgte items value.
 
 \subsubsection{\texttt{listbox} elementet}
-Kommer snart...
+En listbox bruges til at vælge præcis et element ud af en gruppe via en liste.\\
+En listbox har flg. attributter:
+\begin{itemize}
+\item \textit{value} - Inidikerer hvilket element på listen som skal være
+  valgt initielt. Hvis udeladt eller ikke-matchende vil ingenting være valgt,
+  hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
+  opfyldt.
+\end{itemize}
+Listboxen indeholder \texttt{item} tags som beskriver hvilke linier der skal
+være i listen.\\
+Et listbox item har flg. attributter:
+\begin{itemize}
+\item \textit{caption} - Den tekst som skal vises for denne valgmulighed. Hvis
+  udeladt vises den uden tekst.
+\item \textit{value} - Den værdi som valgmuligheden har og som sendes som værdi
+  af gruppen hvis den er valgt ved commit.
+\end{itemize}
+Ved commit returneres listboxens navn med det valgte items value.
+
 
 \subsection{Commit}
 En commit sektion sendt til serveren skal  bevirke at serveren lagrer de
@@ -284,21 +323,36 @@ Hvis klienten modtager en commit sektion skal den blot ignorere den.
 \begin{verbatim}
 <?xml version="1.0" encoding="UTF-8"?>
 <pracro version="1.0" cpr="1505050505">
-  <commit macro="visus" version="1.0">
+  <commit user="johndoe" macro="visus" version="1.0">
     <field name="visus_objektiv" value="42"/>
     <field name="visus_subjektiv" value="42"/>
   </commit>
 </pracro>
 \end{verbatim}
 
-\subsection{Resumé}
-En resumé sektion sendt til klienten skal bevirke at klienten appender den
-sendte tekst til PC-Praxis journalfilen.\\
-Hvis serveren modtager en resumé sektion skal den blot ignorere den.
-\begin{verbatim}
-<?xml version="1.0" encoding="UTF-8"?>
-<pracro version="1.0" cpr="1505050505">
-  <resume macro="visus" version="1.0">Det objektive synsmål var
-42 dioptri, og det subjektive synsmål var 42 dioptri.</resume>
-</pracro>
-\end{verbatim}
+\subsubsection{\texttt{commit} elementet}
+Commit elementet har flg. attributter:
+\begin{itemize}
+\item \textit{user} - Brugernavnet på den bruger som har udfyldt makroen.
+\item \textit{macro} - Navnet på den makro som dataene er indtastet i.
+\item \textit{version} - Versionsnummeret på den makro som er blevet udfyldt.
+\end{itemize}
+
+\subsubsection{\texttt{field} elementet}
+Field elementet har flg. attributter:
+\begin{itemize}
+\item \textit{name} - Navnet på feltet.
+\item \textit{value} - Værdien af feltet.
+\end{itemize}
+
+%\subsection{Resumé}
+%En resumé sektion sendt til klienten skal bevirke at klienten appender den
+%sendte tekst til PC-Praxis journalfilen.\\
+%Hvis serveren modtager en resumé sektion skal den blot ignorere den.
+%\begin{verbatim}
+%<?xml version="1.0" encoding="UTF-8"?>
+%<pracro version="1.0" cpr="1505050505">
+%  <resume macro="visus" version="1.0">Det objektive synsmål var
+%42 dioptri, og det subjektive synsmål var 42 dioptri.</resume>
+%</pracro>
+%\end{verbatim}
-- 
cgit v1.2.3

