Bilaga 1 Prelimina r Fö ra ndringar i fi2base

Transkript

1 Bilaga 1 Prelimina r Fö ra ndringar i fi2base Förändringarna i fi2base rör två områden: komplexa strukturer och basentiteter. De komplexa strukturerna (complex types) förändras främst för att hantera ändringar inom områdena dokumenthantering och miljö/vara. De basentiteter som ändrats finns i avtalsmodellen. Nya basentiteter har tillkommit för områdena miljö/vara och ärendehantering. Komplexa strukturer fi2complexvalue_type Typen ersätter fi2value_type för alla basentiteter. Syftet är att hantera egenskapsvärden som i sin tur består av flera värden, motsvarade en rad i en tabell. Detta åstadkoms genom att elementet fi2value_value i fi2value_type ersätts med ett val av antingen fi2value_value eller fi2value_fieldvalues. Fi2value_fieldvalues är i sin tur ett upprepningsbart element av typen fi2value_type. Införandet av den nya komplexa strukturen innebär att alla basentiteter kommer att ändras. Ändringen från fi2value_type till fi2complexvalue_type är dock helt bakåtkompatibel, då ändringen endast innebär att fi2value_fieldvalues har tillkommit som ett valfritt alternativ. Figur 1 Den nya komplexa strukturen fi2complexvalue_type

2 Fi2value_code (Värdekod) Identifikationen för värdet. Fi2value_scheme (Värdeschema) Identifierar den värdelista som avses. Lagras som strukturen fi2schema_type. Format: fi2schema_type Fi2value_value (Värde) Faktiskt värde. Attributet valuetype skall användas för att ange fälttyp för värdet. Attribut: unit (Mätenhet) Mätenhet för värdet. Attribut: valuetype (Värdetyp) Attributet skall användas för att beskriva formatet på det värde som avses. Fi2value_fieldvalues (Sammansatt värde) Faktiskt sammansatt värde. Delvärden uttrycks som upprepade fi2value_type. Format: fi2value_type Fi2value_measuredby (Mätkälla för värdet) Fi2value_measureddate (Mätdatum) Fi2value_measuretype (Mättyp) fi2document_type Denna komplexa struktur finns redan i den befintliga versionen av fi2xml (1.22), men saknar viktiga element för att uppfylla de krav som ställs på dokumentreferenser. Därför föreslås att strukturen ändras på två punkter: 1. Dokumentet kan antingen refereras eller infogas fysiskt i ett meddelande 2. Metadata ska kunna bifogas ett dokument/en dokumentlänk Den första ändringen åstadkoms genom att det befintliga elementet fi2document_link ersätts med ett val av antingen fi2document_link eller fi2document_document, där det senare är en platshållare för det fysiska dokumentet som avses. Större datamängder som externa dokument hanteras bäst som base64, vilket är ett vedertaget sätt att hantera externa datamängder i xmldokument. Metadata infogas genom att schemat metadata.se refereras i schemat för fi2base, och ett element för metadata läggs upp i fi2document_type. Elementet möjliggör att fullständiga metadata enligt metadata.se kan anges för varje dokument i en fil. Båda dessa ändringar håller strukturen helt bakåtkompatibel då det rör sig om valfria element som har tillförts strukturen.

3 Figur 2 Den komplexa strukturen fi2document_type fi2document_class (Dokumentklass) Klassificering av dokumentet för att ange typ av dokument. fi2document_ids (Dokumentidentitet) Används för att identifiera dokument. Format: fi2ids_type fi2document_descr (Dokumentbeskrivning) Kortfattad beskrivning av dokumentet fi2document_link (Dokumentlänk) Beskriver länk till det faktiska dokumentet. Attributet linktype kan användas för att beskriva typ av länk. Attribut: linktype (Länktyp) Anger typ av dokumentlänk (filnamn, url o.s.v.). fi2document_document (Dokument) Det fysiska dokumentet som avses. Format: xs:base64binary

4 meta:document (Dokumentmetadata) Metadata för dokumentet. Format: komplex struktur från metadata.se fi2override_type Denna nya komplexa struktur har tillkommit för att tillfredsställa behov som har uppkommit i projektet Gemensamt datakommunikationsformat för livscykelinformation. Syftet är att beskriva hur objekts egenskaper kan förändras i olika kontexter. Typen innehåller därför en beskrivning av den kontext där egenskapsvärdet förändras, uttryckt som en klassreferens, och det värde egenskapen får i kontexten. Typen använder de befintliga komplexa strukturerna fi2value_type och fi2class_type. Figur 3 Den komplexa strukturen fi2override_type Fi2override_context (Kontext) Den kontext där egenskapsvärdet förändras. Fi2override_value (Kontextspecifikt värde) Det värde egenskapen får i den angivna kontexten. Format: fi2value_type fi2party_type Denna nya komplexa struktur föreslås för att hantera parter i avtalshanteringen. I den befintliga versionen av fi2xml uttrycks parter med typen fi2partner_type. Denna typ kan dock inte hantera roller. De avtalsentiteter som finns i fi2xml innehåller ett fast antal namngivna roller av typen fi2partner_type, och den föreslagna förändringen av avtalsentiteterna ställer krav på en mer generell beskrivning av aktörer i avtal. Strukturen för aktören har fått namnet fi2actor_type och innehåller den aktuella parten som fi2partner_type, och dess roll uttryckt som ett värde i en klasslista, via fi2class_type. Figur 4 Den komplexa strukturen fi2actor_type

5 fi2actor_partner (Part) Den part som har en roll i den avsedda relationen. Format: fi2partner_type fi2actor_role (Roll) Den roll parten spelar i den avsedda relationen. Basentiteter Förändringarna i basentiteterna finns inom tre områden: avtal, miljö/vara och ärendehantering. I avtalsområdet har förändringar gjorts för att likrikta de olika avtalsentiteterna, och för att generalisera hanteringen av avtalsparter och -intressenter. Inom miljö/vara har behov av en ny entitetet för att hantera produkter uppkommit, och genomgången av ärendehanteringen har gett upphov till två nya entiteter. Avtal Förändringarna i avtalsentiteterna utgörs av omflyttning av element, borttagning av tidigare element för parter och kontrakt, samt införande av ett nytt element för avtalsparter. Alla avtalsentiteter inleds liksom övriga entiteter av sju element: fi2[avtalstyp]_ids, fi2[avtalstyp]_sysids, fi2[avtalstyp]_class, fi2[avtalstyp]_value, fi2[avtalstyp]_documents, fi2[avtalstyp]_process samt fi2[avtalstyp]_apparea, och avslutas av elementen fi2[avtalstyp]_parentobject och fi2[avtalstyp]_childobject. Dessa kommer därför inte att specificeras separat i genomgången nedan. fi2[avtalstyp]contract [inledande element enligt ovan] fi2[avtalstyp]_descr (Beskrivning) Sammanfattande beskrivning av avtalet. Större textmassor bör hanteras som dokument. fi2[avtalstyp]_actor (Avtalspart) Part i den relation som regleras i avtalet. Upprepningsbart element. Format: fi2actor_type [övriga avtalstypsspecifika element] [avslutande element enligt ovan] Miljö/vara En ny entitet krävs för att hantera överföring av information om byggvaror. Entiteten har fått namnet fi2product (Byggvara) och läggs i insatsmodellen (tidigare resursmodellen). fi2product Entiteten byggvara har element avsedda för att ange byggvarans inre och yttre egenskaper, och hur den hanteras i olika sammanhang.

6 Figur 5 Entiteten fi2product fi2product_ids (Objektets fastställda identiteter) Fastställda identiteter för objektet. Format: fi2ids_type fi2product_sysids (Systemidentiteter) Unika systemidentiteter för objektet. Format: fi2sys_ids

7 fi2product_class (Klassificering) Klassifikation av objektet. Klassificering lagras som strukturen fi2class_type som styr klasslista samt klassificeringsbegrepp. fi2product_value (Värden) Värden kopplade till objektet. Värden lagras som strukturen fi2value_type som styr värdetyp, faktiskt värde samt värdeenhet. Format: fi2value_type fi2product_documents (Dokumentlänk) Generell struktur för dokument kopplade till objektet. Format: fi2document_type fi2product_process (Processlänk) Generell struktur för processer kopplade till objektet. fi2product_apparea (Kompletterande information) Odefinierad struktur för information om objektet som ej har definierats inom fi2xml. fi2product_name (Benämning) Kortfattad benämning på objektet. fi2product_descr (Beskrivning) Sammanfattande beskrivning av objektet. Större textmassor bör föras över som dokument. fi2product_manufacturer (Tillverkande företag) Tillverkaren av byggvaran. Format: fi2partner_type fi2product_picture (Bild) Bild som beskriver byggvaran. Upprepningsbart element. Format: xs:base64binary Attribut: picturetype Valfritt attribut för att beskriva bildens typ. fi2product_lcc (Livscykelkostnad) Beskrivning av produktens livscykelkostnad. Elementet är uppdelat i fyra underelement enligt nedan. fi2lcc_currency Valuta för livscykelkostnadsberäkningen. Format: xs:token

8 fi2lcc_unitprice Enhetspris. Format: xs:decimal fi2lcc_realcost Verklig kostnad. Format: xs:decimal fi2lcc_realcostbasedate Datum för beräkning av verklig kostnad. fi2product_content (Produktinnehåll) Produktens kemiska innehåll efter produktionsprocessen. Elementet består av ett underelement enligt nedan. fi2content_substance Upprepningsbart element för ämnen i produktens kemiska innehåll. Elementet är uppdelat i sex underelement enligt nedan. fi2substance_ids (Objektets fastställda identiteter) Fastställda identiteter för objektet. Format: fi2ids_type fi2substance_class (Klassificering) Klassifikation av objektet. fi2substance_name (Benämning) Kortfattad benämning för objektet. fi2substance_weightcontent (Viktprocent) Andelen av produktens vikt som utgörs av ämnet. Format: xs:decimal fi2substance_comment (Kommentar) Kommentar till uppgiften. fi2substance_context (Kontext) Kontext för uppgiften. fi2product_emission (Utsläpp) De utsläpp till luft, mark och vatten som produktens tillverkningsprocess ger upphov till. Elementet är uppdelat i fem underelement enligt nedan.

9 fi2emission_noise Beskrivning av bullerstörning som produkten genererar. fi2emission_electrictfields Beskrivning av elektriska fält som produkten genererar. fi2emission_electromagneticfields Beskrivning av elektromagnetiska fält som produkten genererar. fi2emission_otherinformation Annan information kring produktens utsläpp. fi2emission_releasesubstance Det ämne som emitteras. Elementet är uppdelat i fem underelement enligt nedan. fi2substance_name fi2substance_testmethod fi2substance_mandatedarea fi2substance_loadfactortype fi2substance_loadfactorvalue fi2substance_releasescenarioid fi2substance_releasescenarioemissionvalue fi2product_lca (Livscykelanalys) fi2product_valueoverride (Förändrade värden) fi2product_parentobject (Överliggande element) fi2product_childobject (Underliggande element) Ärendehantering Inom området ärendehantering skapas tre nya entiteter, ärende, arbetsorder och underhållsplan. Entiteterna läggs i en ny modell, ärendemodellen, som beskrivs i rapporten. Ärende (fi2case) Ärendet hanterar den information som kan vara betydelsefull när ärenden ska föras över mellan ärendehanteringssystem. När ärendet blir en arbetsorder som skickas till en utförare används entiteten arbetsorder som beskrivs nedan.

10 Figur 6 Entiteten fi2case (ärende)

11 fi2case_ids (Objektets fastställda identiteter) Fastställda identiteter för objektet. Format: fi2ids_type fi2case_sysids (Systemidentiteter) Unika systemidentiteter för objektet. Format: fi2systsemids_type fi2case_class (Klassificering) Klassifikation av objektet. fi2case_value (Värden) Värden kopplade till objektet. Format: fi2value_type fi2case_documents (Dokumentlänk) Generell struktur för dokument kopplade till objektet. Format: fi2document_type fi2case_process (Processlänk) Generell struktur för processer kopplade till objektet. fi2case_apparea (Kompletterande information) Odefinierad struktur för information om objektet som ej har definierats inom fi2xml. fi2case_descr (Beskrivning) Beskrivning av ärendet. fi2case_notificationdate (Rapportdatum) Det datum då ärendet rapporterats. fi2case_notificationtype (Rapporttyp) Det sätt på vilket rapporten lämnats till systemet. fi2case_notification (Rapportering) Annan information om hur rapporten inkommit till systemet. fi2case_notifier (Rapporterare) Den aktör som har rapporterar fel eller önskemål som lett till ärendet. Format: fi2partner_type

12 fi2case_registrationdate (Registreringsdatum) Det datum då ärendet registrerats i ärendhanteringssystem. fi2case_registrar (Registrerare) Den person eller process som registrerat ärendet. fi2case_object (Objekt) Den eller de fastigheter, byggnader eller andra objekt som ärendet hänför sig till. fi2case_category (Kategori) Ärendets kategori. fi2case_priority (Prioritet) Ärendets prioritetsgrad. fi2case_status (Status) Ärendets status. fi2case_contractor (Entreprenör) Utförande entreprenör. Format: fi2partner_type fi2case_estimatedcost (Beräknad kostnad) Beräknad kostnad för utfört arbete. Format: xs:decimal Attribut: currency (Valuta) Den valuta kostnaden anges i. fi2case_offeredprice (Offererat pris) Entreprenörens offererade pris i förekommande fall. Format: xs:decimal Attribut: currency (Valuta) Den valuta kostnaden anges i. fi2case_actualcost (Verklig kostnad) Den verkliga kostnaden för utfört arbete. Format: xs:decimal Attribut: currency (Valuta) Den valuta kostnaden anges i.

13 fi2case_plannedstartdate (Planerat startdatum) Det datum då arbetet ska påbörjas. fi2case_actualstartdate (Verkligt startdatum) Det datum då arbetet faktiskt påbörjats. fi2case_plannedenddate (Planerat slutförandedatum) Det datum då arbetet ska vara slutfört. fi2case_actualenddate (Verkligt slutförandedatum) Det datum då arbetet faktiskt slutförts. fi2case_parentobject (Föräldraelement) Ovanliggande element. Format: fi2parentobject_type fi2case_childobject (Underliggande element) Underliggande element. Format: fi2childobject_type Arbetsorder (fi2order) Arbetsordern innehåller element som behövs när en arbetsorder ska skickas från ett ärendehanteringssystem till en utförare.

14 Figur 7 Entiteten fi2order (Arbetsorder) fi2order_ids (Objektets fastställda identiteter) Fastställda identiteter för objektet. Format: fi2ids_type fi2order_sysids (Systemidentiteter) Unika systemidentiteter för objektet. Format: fi2systsemids_type fi2order_class (Klassificering) Klassifikation av objektet. fi2order_value (Värden) Värden kopplade till objektet. Format: fi2value_type

15 fi2order_documents (Dokumentlänk) Generell struktur för dokument kopplade till objektet. Format: fi2document_type fi2order_process (Processlänk) Generell struktur för processer kopplade till objektet. fi2order_apparea (Kompletterande information) Odefinierad struktur för information om objektet som ej har definierats inom fi2xml. fi2order_descr (Beskrivning) Beskrivning av arbetsordern. fi2order_address (Adress) Adress där arbetet ska utföras. Format: fi2address_type fi2order_space (Utrymme) Driftcentral, affärslokal, lägenhet eller annat utrymme där arbetet ska utföras. fi2order_startdate (Startdatum) Det datum då arbetet påbörjas. fi2order_enddate (Slutdatum) Det datum då arbetet slutförs. fi2order_billing (Betalningsinformation) Information om avtal, betalning eller annat rörande ersättning för arbetet. fi2order_parentobject (Föräldraelement) Ovanliggande element. Format: fi2parentobject_type fi2order_childobject (Underliggande element) Underliggande element. Format: fi2childobject_type Underhållsplan (fi2maintenanceplan) Underhållsplanen genererar arbetsorder utifrån de regler som sätts upp i planen. Vid uppföljning eller kontroll kan underhållsplanen även generera ärenden.

16 Figur 8 Entiteten fi2maintenanceplan (Underhållsplan) fi2maintplan_ids (Objektets fastställda identiteter) Fastställda identiteter för objektet. Format: fi2ids_type fi2maintplan_sysids (Systemidentiteter) Unika systemidentiteter för objektet. Format: fi2systsemids_type fi2maintplan_class (Klassificering) Klassifikation av objektet. fi2maintplan_value (Värden) Värden kopplade till objektet. Format: fi2value_type fi2maintplan_documents (Dokumentlänk) Generell struktur för dokument kopplade till objektet. Format: fi2document_type fi2maintplan_process (Processlänk) Generell struktur för processer kopplade till objektet.

17 fi2maintplan_apparea (Kompletterande information) Odefinierad struktur för information om objektet som ej har definierats inom fi2xml. fi2maintplan_name (Benämning) Underhållsplanens namn. fi2maintplan_description (Beskrivning) Sammanfattande beskrivning av underhållsplanen. fi2maintplan_validfrom (Giltighetsdatum) Första giltighetsdatum för underhållsplanen. fi2maintplan_validto (Sista giltighetsdatum) Sista giltighetsdatum för underhållsplanen. fi2maintplan_object (Objekt) Den eller de fastigheter, byggnader eller andra objekt som omfattas av underhållsplanen. fi2maintplan_parentobject (Föräldraelement) Ovanliggande element. Format: fi2parentobject_type fi2maintplan_childobject (Underliggande element) Underliggande element. Format: fi2childobject_type