[Bitrepository-devel] Omfattende trimning af protokollen

Mikis Seth Sørensen mss at statsbiblioteket.dk
Tue Jan 10 15:34:40 CET 2012


I et forsøg på en general oprydning har jeg en rækkeforslag til udtyndning i message-xsd'erne, så vi får en mere overskuelig protokol.

Generalt er oprydningen en simplificering af modellen for alarmer og audit trails. Strategien her er at vi ikke ikke protokollen skal have en meget rig karaktisering af alarmer og audit trails, da det er meget svært her at lave en general model der passer alle. Bemærk at en hel del af disse elementer allerede er gøre optional efter beslutning på et tidligere møde.

Jeg har allerede diskuteret ændringerne med Kåre.

 *   Slette AlarmConcerning<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to19> elementet elementet: Vi har en AlarmRaiser til at fortælle, hvem alarmen kommer fra, resten af Alarm informationerne kan findes i AlarmDescription<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to66> elementet.
 *   Slette Priority og Risk elementerne på AlarmDescription<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to93>.
 *   Renavngive AuditTrailData<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to115> til AuditTrailEvents og AuditTrailDataItem<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to126> til AuditTrailEvent.
 *   Slette Actor_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to642> og erstatte den med en ActorId som er en simple streng de steder den bliver brugt.
 *   Slette ActorID_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to705>.
 *   Generalt konvertere alle enumtyper til string typer fremfor int type. Dette vil dels gøre at Java kan JAXB generere uden at vi skal vedligeholde en bindings definition vedsiden af. Samtidig ville det give os en menneskelig forstående kode, eg. ´FAILURE_OPERATION´ fremfor et intetsigende tal '504' i vores xml.
 *   Slette Component_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to867> og erstatte den med en ComponentId som er en simple streng de steder den bliver brugt.
 *   Slette PriorityCode_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to965>.
 *   Slette Risk_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to1083>.
 *   Slette RiskArea_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to1109>.
 *   Slette RiskImpactScore_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to1129>.
 *   Slette RiskProbabilityScore_TYPE<https://sbforge.org/fisheye/browse/Bitmagasinet/bitrepository-message-xml/trunk/src/main/resources/xsd/BitRepositoryElements.xsd?r=686#to1175>.

Kåre har bemærket at det er ærgeligt hvis vi smider overvejelser væk som måske kan blive relevante igen efterhånden som Bitmagasinet modnes. Men jeg mener at vi på nuværende tidspunkt står i en situation, hvor vi er tvunget til med hård hånd at rydde op i specifikation, så vi d. 1.3 rammer en brugbar protokol som svarer nogenlunde til det funktionelle ambitionsniveau vi har på det tidspunkt. Bitmagasinet/protokollen vil selvfølge herefter kunne udvides efter behov.

Hvad siger I?

Mvh
Mikis

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://ml.sbforge.org/pipermail/bitrepository-devel/attachments/20120110/e791226e/attachment.html>


More information about the Bitrepository-devel mailing list