Receiver er en service til brug for afvikling af Linkpakker - et biblioteksprojekt

The following operations are supported. For a formal definition, please review the Service Description.

• domainData
  Bruges til at hente eller opdatere data paa en kilde, der er blevet refereret til et antal gange i linkpakkens database. Hvis url gives, finder servicen .. Url er et domaene, der angivies UDEN et evt. afsluttende /.
• questionWrite
  Bruges til at hente eller opdatere de overordnede felter i en linkpakke/Question. Hvis Username gives, finder servicen selv userid og overskrives den tidligere userid (ejer) af den specifikke linkpakke med det nye userid. Dette kan anvendes til at lade en bruger overtage en anden brugers pakke. For de resterende felter (Title, Question, InternalNote, Email) gaelder, at en given vaerdi overskriver eksisterende vaerdi. Derfor kan man blanke et felt ved at give et mellerumstegn som vaerdi. Tom streng i et felt vil ikke overskrive eksisterende vaerdi, og dermed kan metoden ogsaa anvendes naar man kun skal aendre 1 af felterne. Metodens returvaerdi vil altid reflektere det aktuelle indhold i pakken (efter aendringer er foretaget).
• refNote
  Bruges til at hente eller opdatere den individuelle note paa en reference (er IKKE den generelle note på referencens domain). Er input fra Note variablen en streng, indsaettes denne som den nye note - er den tom eller er variablen udeladt, returneres det aktuelle indhold. Ønskes det at slette det aktuelle indhold af noten, sendes blot et mellemrumstegn i variablen Note.
• refWrite
  Bruges ved indsaettelse af nye referencer i Linkpakker. Det forudsaettes, at der foreligger et sessionId. Feltet metadata er et array af key-value par. Indtil videre opereres der med fields url:string, men flere vil kunne introduceres til at beskrive referencen. Felterne activeProgramName og activeProgramId henviser til det aktive vindue i Windows-miljoeet. clipboardText baerer det evt. indhold af windows klippebordet. Parameteren refId er valgfri: Den kan anvendes, hvis man kender sit refId og oensker at overskrive en specifik reference i en Linkpakke.
• search
  Bruges til at fremsoege linkpakker paa basis af soegekriterier. Ingen adgangskontrol. Resultatsaet er anonymisteret mht. bibliotek og evt. brugerdata.
• sessionInit
  Bruges til at oprette en ny Linkpakke og returnerer dennes sessionId. Hvis metoden kaldes med et allerede kendt sessionId, oprettes intet nyt, men tilgengaeld returneres det aktuelle antal af referencer i den specifikke Linkpakke man vil fortsaette paa.