Opsamlerkomponent: beskrivelse og udkast til krav

Beskrivelse
En serviceapplikation/tynd klient/daemon, der kan arbejde i baggrunden på computeren og kalde en webservice med et SOAP Document. Den aktiveres hver gang indhold kopieres til windows klippebord, og henter dette indhold. Data sendes derefter øjeblikkeligt videre til en webservice på nettet, klippebordet og opsamleren tømmes, og opsamleren er klar til næste kopiering.

Diagram



Overordnede krav

• Er selvstændig, og er ikke nogen udvidelse til eksisterende programmer.
• Skal have en dokumenteret API, så den kan kaldes fra både applikationer som mailprogrammer og webbrowsere. Mulig implementering af API: kommandoer, der ryger i klippebordet og således opfanges af komponenten.
  
• Overfører data via SOAP-protokollen
• Konfigurerbar mht. detaljer som:
• URL til modtagende webservice
• Sti til placering af lokal (dvs. på den enkelte workstation) error log
  Netværksti til placering af global error log (samler op på fejl på tværs af workstations)
• Sti til arbejdsfolder for det aktuelle SOAP dokument
• Sti til skabelon: SOAP dokument
• dialogX: bredde på browservindue, når der skal åbnes dialogboks
• dialogY: højde på browservindue, når der skal åbnes dialogboks
• Hvilke tastekombinationer der aktiverer komponenten
• Indikatorlys tydelig på Windows' desktop, der indikerer når komponenten er klar, aktiv, sender data m.m.
• Skal vedligeholde oversigt over de seneste 10 sessions fra skabt fra hhv.:
  
• dette netværk
  
• denne workstation
  
• denne windows account
  

Metoder/funktioner
forward()

1. Aktiveres ved aflæsning af indhold i windows klippebordet.
   
2. tjekker at session er startet/er åben (i hvilket tilfælde der allerede eksisterer et SOAP dokument i arbejdsfolder). Hvis ikke, køres metoden startSession() inden der fortsættes.
3. Indsætter indhold i SOAP-dokumentets BODY-element.
4. Sender kopi af det aktuelle SOAP-dokument til modtagende webservice. Svaret fra webservicen overskriver SOAP-dokumentets BODY-element.
5. det aktuelle SOAP dokument gemmes som fil i arbejdsfolder

Der skal være mulighed for at svaret i (4) kan aktivere dialog()-metoden med en specifik URL, der skal åbnes.

dialog()
Anvendes typisk ved afslutning af en session eller hvis indholdet af session skal gennemses.

1. tjekker at session er startet/er åben (i hvilket tilfælde der allerede eksisterer et SOAP dokument i arbejdsfolder). Hvis ikke, køres metoden startSession() inden der fortsættes.
2. indsætter tekst-streng i SOAP-dokumentets BODY-element.
3. åbner default web-browser med dimensionerne dialogX, dialogY. I dette vindue åbnes den modtagende webservice, der modtager kopi af det aktuelle SOAP-dokument og reagerer på det.
4. Hvis session skal sluttes, køres endSession()
   

startSession()

1. Henter SOAP Dokument skabelon og opretter SOAP dokument som kopi heraf.
2. indsætter evt. startdata i SOAP dokumentets BODY-element
3. Sender kopi af det aktuelle SOAP-dokument til modtagende webservice. Svaret fra webservicen overskriver SOAP-dokumentets BODY-element.
4. det aktuelle SOAP dokument gemmes som fil i arbejdsfolder
5. Indikatorlys tændes (Opsamleren er aktiveret+"i session")
   

endSession()

1. sletter aktuel SOAP dokument fra arbejdsfolder
2. slukker indikatorlys (Opsamleren viser "aktiveret"+"ingen session i gang")