EDMmodelServerManager™
Arbeidsordre
Version 0.4

Opphavsrett
Denne programvaren inneholder opphavsrettsbeskyttet materiale, forretningshemmeligheter samt annet beskyttet materiale. Du skal ikke, og skal ikke forsøke å, modifisere, reversere, dekompilere Programvaren. Du kan heller ikke lage avledede verk eller andre arbeider som er basert på eller avledet fra Programvaren, helt eller delvis.
Jotne EPM Technology AS navn, logo og grafikkfil som representerer Programvaren skal ikke brukes på noen måte å markedsføre produkter utviklet med programvaren uten Jotne EPM Technologys godkjennelse. Jotne EPM Technology AS beholder den eneste og eksklusive eierskap til alle rettigheter, tittel og interesser i og for Programvaren og alle immaterielle rettigheter knyttet til dette.
Copyright lov og internasjonale opphavsrettstraktatbestemmelser beskytter alle deler av programvaren, produkter og tjenester. Ingen program, kode, del, bilde, eller tekst kan kopieres eller brukes på noen måte av brukeren unntatt som forutsatt innenfor rammene av programvarens naturlige bruk. Alle rettigheter som ikke uttrykkelig er gitt, er forbeholdt for Jotne EPM Technology AS.
Ansvarsfraskrivelse
Denne programvaren og tilhørende dokumentasjon leveres som den er og det gis ingen garantier for dens egnethet for et spesielt formål. Ikke under noen omstendigheter skal Jotne stilles ansvarlig for direkte eller indirekte tap eller skader, (inkludert men ikke begrenset til tap av data, tap av fortjeneste eller produksjonsstans), uansett årsak og ansvarsteori, verken som følge av bruken av denne programvaren eller av de data den produserer.

Innhold
1 Referanser
1.1 Forkortelser
1.2 Eksterne referanser
1.3 EDMmodelServer referanser
2 Installasjon
2.1 EDMmodelServer ™ Installasjon
2.2 EDMmodelServerManager™ Installasjon
2.3 Plugin-installasjon og bruk av Arbeidsordre
3 Vedlikehold av BIM for Arbeidsordre
3.1 Importere og klargjøre modeller
3.2 Oppgradering av eksisterende BIM
3.3 Import av data fra TianDV regneark
3.3.1 Forberedelser og forutsetninger
3.3.2 Import av TianDV regneark
3.3.3 Redigering, komplettering og korrigering
3.3.4 Merge TFM data til BIM
4 Bruk av Arbeidsordre modul
4.1 Generelt
4.1.1 Registrere firma og ressurser
4.2 Forespørsler
4.2.1 Opprette forespørsel
4.2.2 Vurdering/behandling av forespørsel
4.3 Prosjekter
4.3.1 Søke prosjekt
4.3.2 Opprette prosjekt uten forespørsel
4.3.3 Redigere prosjekt
5 Problemløsning
5.1 Generelt
5.1.1 Arbeidsordre ikke tilgjengelig
5.1.2 Feilmeldinger "no access" eller tilsvarende
6 Annex : Tom IFC fil

Referanser

Forkortelser

Eksterne referanser

Jotne-1. «MSMSpecification-BIMUpgrade.docx.» .

EDMmodelServer referanser

EDMmodelServerManager™ Generell Brukermanual, versjon 3.2.13 (norsk)

Installasjon

EDMmodelServer ™ Installasjon

Se dokument EDMmodelServerManager™ Generell Brukermanual

EDMmodelServerManager™ Installasjon

Se dokument EDMmodelServerManager™ Generell Brukermanual

Plugin-installasjon og bruk av Arbeidsordre

Det forutsettes at EDMmodelServerManager™ er installert før installasjon av Plugins. Plugins installeres i en egen folder for hver versjon av EDMmodelServerManager™. Plugin folderen vil normalt ligge på C:\ProgramData\Jotne EPM Technology AS\MSM\klient_versjon_nr

Last ned .ZIP Plugin Folder.
Pakk den ut i "Plugin Folder"

Dersom man installerer en ny versjon av EDMmodelServerManager™ kan man installere plugins ved å kopiere dem fra den forrige versjonens Plugin Folder til den nye.

Figur 1 - Plassering, Plugins og rapportmaler
For å kunne eksportere rapporter til Excel og PDF format, må også forhåndsdefinerte rapportmaler kopieres til Plugin Folderen.
Start EDMmodelServerManager™ og koble til EDMmodelServer™ på samme måte som du har gjort tidligere. Når innlastingen av plugin for Arbeidsordre er gjort vil du få opp en egen fane for Prosjekter i menylinja.

Figur 2 - Prosjekter fane og meny

Dersom plugins ikke lastes, må blokkering av biblioteksfila fjernes.
Høyreklikk på WorkOrderPlugin.dll ► Egenskaper ► Unblock

Figur 3 - Egenskaper, plugin fil

Vedlikehold av BIM for Arbeidsordre

ToDo: dette avsnittet er ikke komplett

Importere og klargjøre modeller

Det kreves ingen spesiell klargjøring av modeller for bruk med Arbeidsordre modul.

Oppgradering av eksisterende BIM

Med oppgradering menes her import av ny IFC fil som ny modellversjon.

VIKTIG: Eksistrende koblinger mellom arbeidsordre (prosjekt, aktivitet, forespørsel) og BIM objekter vil IKKE bli overført til ny modell. Unngå derfor ren oppgradering i en «live» setting.

Import av data fra TianDV regneark

Bygningselementer uten geometri kan importeres til IFC modell fra TianDV regneark, med TFM kode som primærnøkkel. Metoden er som følger:

Importer data til dedikert modell – disiplinodell «TFM»
Rediger og korriger TFM disiplinmodell etter ønske
«Merge» denne modellen inn i ønsket BIM modell

Data importeres med følgende modellering:

Alle rader i regneark akal ha en unik TFM-kode
Om TFM-koden er typeunik opprettes ett typeobjekt med samme TFM-kode og ett «virtuelt» instansobjekt slik at kan man bruke data på vanlig måte for tilordning av oppgaver m.v.
Om TFM-koden IKKE er typeunik (instansobjekt) opprettes ett typeobjekt med «typeuni8k» TFM-kode og ett instansobjekt.
Typeobjektene bør «merges» etter import, da de i svært mange tilfeller er like, men dessverre er det ingen enkel generell metode for å gjøre denne merge under import. Til det er ikke data i TianDV-arkene like nok på kryss av forskjellige typer elementer.

Kjente svakheter:

Importeren oppretter IKKE «TFM systemer» etter behov.

Metoden er beskrevet trinnvis i påfølgende avsnitt

Forberedelser og forutsetninger

TianDV (TFM) data importeres for ett bygg om gangen, til en dertil avsatt «TFM» disiplinmodell. Før import kan gjøres, må det finnes en egen modell for dette bruk, gjerne (helst) en tom modell:

Figur 4 - TFM disiplinmodell
En slik modell lages enkelt ved å importere en tom IFC fil. Om du ikke har noen, finnes det en i appendix til dette dokumentet.

VIKTIG: Pass på at displin er «TFM», og at bygningen modellen tilhører er «koblet til FDV» - det sees ved at hus-symbolet er synlig for en av modellene til bygget..

I tillegg må regnearket som skal importeres være på «.xlsx» format. Om regnearket er på et annet format, for eksempel «.xls», ta det inn i Excel og bruk «Lagre som» for å oppdatere formatet. Eventuelle feilmeldinger for makroer etc kan neglisjeres, da data skal leses og ikke manipuleres.

Import av TianDV regneark

TianDV importer starter fra «Arbeidsordre» verktøylinje:

Figur 5 - Starte TianDV importverktøy
Skjermbildet er som følger:

Figur 6 - TianDV importer
Trykk på mappa markert med rød pil for å lese inn et regneark. Du vil få tilgang gjennom en vanlig «Åpne fil...» dialog. Et utvalg av data vil vises i skjermbildet.
Nedtrekkmenyen under «Building» brukes for å velge hvilket bygg det skal importeres for. Om du ikke finner riktig bygg, så er ikke «TFM»-modellen beskrevet i forrige avsnitt riktig satt opp.
Når riktig bygg er valgt kan du trykke på [+] – symbolet rett til høyre for mappa nevnt over for å skrive data til TFM-modellen. «Status» kolonnen vil gi opplysning for hver rad om hvordan importen gikk. Denne operasjonen tar endel tid.

Om de fleste av radene får status «Created» mens noen få blir «Updated» kan det tyde på dupliserte TFM-koder i regnearket.

Du kan importere så mange regneark du vil til samme modell, men jo større datamengder det er der, jo vanskeligere kan det være å sjekke og eventuelt redigere dem.

Redigering, komplettering og korrigering

Etter at data er importert til «TFM»-modellen kan denne brukes som en hvilken som helst annen modell, bortsett fra at det ikke er geometri i den. Drfor er 2D/3D viewer av begrenset nytte.
Dokumenter tilordnes objekter og typeobjekter på vanlig måte (drag-and-drop).
TODO: Beskriv bruk av TFM-tilrettelagte rapporter:

Merge typeobjekter
Redigere inn i riktige egenskapssett (SB-merking?)

Merge TFM data til BIM

En av utfordringene her er at merge til ny versjon kan/vil ødelegge linker til eksisterende versjon av BIM modell, mens merge til eksisterende versjon ikke gir deg muligheten til å angre om det skulle være nødvendig. Derfor anbefales følgende metode:

Merge til ny versjon av modell og sjekk resultat.
Om resultatet er bra, gjenta operasjon UTEN merge til ny versjon
Om resultatet ikke er bra, slett ny versjon av modell og korriger TFM data mer

Denne testen bør gjøres mens ingen andre bruker data for gjeldende bygg.

Bruk av Arbeidsordre modul

Generelt

For å åpne Arbeidsordre modul velg verktøylinje Prosjekter:

Figur 7 – Verktøylinje

Registrere firma og ressurser

Firma og generiske resurser defineres i Arbeidsordremodulen;
Prosjekter ► Admin Console
Disse er nødvendig for registrering av kunder og kontraktører i prosjekter og aktiviteter.'

Figur 8 Admin Console

Figur 9 Dialoger for å registrere firma og generisk ressurs

Forespørsler

Eksisterende forespørsler kan listes fra verktøylinja;
Prosjekter ► Forespørsler
Her kan det også opprettes nye forespørsler.

	Følgende funksjoner er tilgjengelig
		Opprette ny forespørsl
		Redigere eksisterende forespørsl
		Slette forespørsel

Opprette forespørsel

Figur 10 Opprette forespørsel	Feltbeskrivelser
	Behov	kort beskrivelse av behovet
	Type	velg blant tilgjengelige typer fra nedtrekkslisten
	Fagområde	velg blant tilgjengelige fagområder fra nedtrekkslisten
	Beskrivelse	detaljert beskrivelse av behovet
	Foreslått start	foreslått dato for start
	Foreslått ferdig	foreslått dato for utført/ferdig

Datagrupper:

Bygningselementer - koble valgte bygningselementer til forespørsel
I BIM, velg aktuelle bygningsobjekter for forespørsel og trykk på ikonet for å koble objektene til forespørselen

Følgende funksjoner er tilgjengelig for kobling av bygningselementer:

	Koble valgte bygningsobjekter til forespørselen
	Zoom til valgt bygningsobjekt
	Velg alle
	Fjern alle elementer fra forespørselen

Ved å klikke på Opprette knappen lengst ned i dialogen, opprettes forespørselen, som dermed blir klar for vurdering.

Vurdering/behandling av forespørsel

	Følgende funksjoner er tilgjengelig
		Aksepter forespørsel og opprett et prosjekt.
		Avviser forespørsel. Prosjekt blir ikke opprettet.
		Sletter forespørsel.
		Linker forespørselen til en leieavtale
	Figur 11 Behandle forespørsel

Man kan legge inn kommentarer på en forespørsel. Hvordan dette gjøres, er beskrevet nedenfor, for aktivitet. Kommentar kan også legges direkte på koblede bygningselementer gjennom å klikke på fanen.

Prosjekter

For å liste eksisterende prosjekter, velg Prosjekter fra verktøylinja.
Prosjekter ► Prosjekter

Figur 12 - Arbeidsordre – prosjektliste
Følgende funksjoner er tilgjengelig:

	Opprette nytt prosjekt
	Åpne prosjekt
	Slette prosjekt

Søke prosjekt

Trykk på "Søk " på verktøylinje for å søke etter prosjekter. Prosjekter ► Søk
Søkevinduet starter som et flytende vindu, men kan dokkes på same måte som de andre vinduene om ønskelig.

Figur 13 - Søke prosjekt
Søkefunksjonen gjør en logisk "OG" (Boolean "AND") mellom alle feltene. Det brukes ikke spesialkarakterer for matching, det vil si a "A" i "navn" vil matche alle prosjekter hvor navn begynner på "A".
Følgende felt er tilgjengelige

Navn	Navnestreng for søket, starter med første karakter
Beskrivelse	Vilkårlig tekst som inngår i prosjektets beskrivelsesfelt
Status	Prosjektstatus
Type	Prosjekttype
Datofelt/type	Datotype for søket, datointervall med Dato etter og Dato før. Eksempel: Datofelt/type : Planned Start Dato etter: 02.02.2015 Dato før: 31.12.2015
Fra nummer	Prosjektnummer fra (Eksempel; 4 vil kun returnere prosjektnumre 4 eller høyere)
Fra indeks	Indeks i database å starte fra
Maksimum	Maksimum antall i søkeresultat

Knappene Fjern feltinnhold og Fjern resultater tømmer søkefeltene respektive søkeresultat.

Opprette prosjekt uten forespørsel

Gjennom å klikke symbolet for å opprette prosjekt, åpnes en dialog for å angi nøkkelinformasjon for prosjektet.

	Følgende felt er tilgjengelige
	Navn	Gi prosjektet et beskrivende navn. Feltet er obligatorisk
	Type	Tilgjengelige typer er Repair, Periodic maintenance, Planned maintenance and Development
	Prosjektleder	Velg aktuell prosjektleder
	Klient	Oppdragsgiver for prosjektet
	Kontonr	Prosjektets kontonummer
	Start	Planlagt startdato for prosjektet
	Slutt	Planlagt sluttdato for prosjektet
	Beskrivelse	Fritekst beskrivelse av prosjektet
	Figur 14 Dialog for å opprette prosjekt

Felt markert med stjerne er obligatoriske.
Trykk på Lagre knappen for å opprette prosjektet, som så blir tilgjengelig i prosjektlisten.

Redigere prosjekt

Hvert prosjekt inneholder datafelt på toppen av fanen, og et antall datagrupper for tilknyttede data. Bruk [-] / [+] knapper for å skjule/vise en datagruppe:

Figur 15 - komprimere / ekspandere dataseksjon
Følgende funksjoner er tilgjengelig innenfor hver datagruppe:

	Opprette ny
	Redigere
	Slett

Tilgjengelige datagrupper:
Aktiviteter : Aktiviteter i dette prosjektet
Aktører : Aktører i dette prosjektet
Aktiviteter legges inn i prosjektet gjennom å trykke på , for deretter å legge inn informasjon om aktiviteten.

Figur 16 Liste over aktiviteter i prosjektet
Dersom bygningselementer ikke er koblet til prosjektet når dette opprettes (f.eks. ikke tilkoblet i en korresponderende forespørsel), kan man gjøre dette gjennom å klikke på fanen Bygningselementer i prosjektet, og deretter å koble valgte bygningselementer til prosjektet.

Figur 17 Koble bygningselement til prosjekt
Følgende funksjoner er tilgjengelig:

	Tilknytt bygningselement(er)
	Zoom til valgt bygningselement
	Velg alle tilknyttede elementer
	Fjern alle elementer
	Legg inn kommentar for valgt element
	Slett tilknytting til element

Checkboksen Synkroniser utvalg vil synkronisere EDMviewer™ og treeview mot lista. Ved å klikke i lista vil objektene markeres i EDMviewer™ og treeview
Tilknyttet bygningselement vises som Ikke tildelt i figuren ovenfor, da det ikke er tilknyttet en aktivitet i prosjektet.
Åpne aktivitet for å legge inn aktuelle data for valgt aktivitet. Her legges informasjon inn for planlagte og virkelige start/sluttdatoer for aktiviteten, samt knytte ressurser og kostnader, så som planlagte kostnader og -tidsforbruk til aktiviteten.

Figur 18 Aktivitet. Detaljert info
For å legge inn ressurser, velg legg til knappen, og dialog for å legge inn en ressurs åpnes:

Velg aktuell ressurstype, ressurs, samt angi rolle og fagområde fra korresponderende nedtrekkslister. Fyll inn feltene for timepris og anslått medgått tid for aktiviteten. Planlagt start- og slutt datoer angis enten ved å skrive dato, eller gjennom valg i kalenderen.
Ressurs type kan være person, firma eller generisk. Alternativene som vises i nedtrekkslisten for ressurs avhenger av valgt ressurstype. For person vises registrerte personer, for firma vises registrerte firmaer, og for generisk vises registrerte generiske funksjoner.

Figur 19 Legg til ressurs

I gruppen Kostelementer legger man inn de planlagte kostnadselementene. Rediger feltene direkte i aktuell tabell rad. For kolonnen Type, velges det blant predefinerte typer.

Figur 20 Kostelementer
For datagruppen Aktører kan man koble aktører til aktiviteter. Brukeren som har registrert prosjektet legges inn som aktør som default og kan ikke slettes fra aktiviteten. Eventuelle øvrige aktører kan fjernes med fra aktiviteten med knappen.
Velg fanen Bygningselementer for å knytte bygningselementer opp til aktivitet..

Figur 21 Tilknyttet bygningselement
Følgende funksjoner er tilgjengelig:

	Tilknytt bygningselement
	Zoom til valgt bygningselement
	Velg alle tilknyttede elementer
	Fjern alle elementer
	Legg inn kommentar for valgt element
	Slett tilknytting

Checkboksen Synkroniser utvalg vil synkronisere EDMviewer™ og treeview mot lista. Ved å klikke i lista vil elementene markeres i EDMviewer™ og treeview
Dersom prosjektet har tilknyttede bygningselementer, kan disse knyttes mer spesifikt til aktiviteter gjennom å dra bygningselement fra prosjekt dialogen og over til aktuell aktivitetsdialog (Drag'nDrop). I prosjektdialogen vil det da vises hvilken aktivitet bygningselementet er tilknyttet.

Figur 22 Bygningselement (dør) tilknyttet aktivitet (Snekkerjobb)
Man kan legge inn dokumenter på prosjekter og aktiviteter gjennom å gå til fanen Documents, og deretter klikke opplastingssymbolet . Filutforsker åpnes, hvor man velger filen man ønsker å laste opp.

Figur 23 Dokument opplasting til prosjekt
Følgende dokumentfunksjoner er tilgjengelig:

	Åpne dokument
	Last ned dokument til egen maskin
	Slett dokument

For opplastede dokumenter kan man legge inn beskrivende tekst i kolonnene Beskrivelse og Category gjennom å skrive direkte i de korresponderende cellene.
Man kan stenge for muligheten til å laste opp nye dokumenter til en aktivitet eller et prosjekt, gjennom å skru av/på en bryter for dette i Documents vinduet:

Påløpt tidsforbruk registreres gjennom å velge fanen Registrert arbeid, og deretter velge knappen for å registrere.

Figur 24 Registrere arbeid
Velg aktuell ressurs fra nedtrekklisten Resource, og legg inn informasjon i de øvrige feltene. Trykk på Registrere knappen, og tidsforbruket registreres på aktiviteten.
Når tidsforbruk registreres på en aktivitet, vises aktiviteten i prosjektet med grønn bakgrunn dersom tidsforbruket er lavere enn budsjettert. Om registrert tidsforbruk overstiger budsjett, vises aktiviteten med rød bakgrunn.

Figur 25 Aktivitet over budsjett
Tilsvarende markeres ressurs tidsforbruk over budsjettert med rød bakgrunn i aktiviteten:

Figur 26 Ressurs over budsjett
Man kan legge inn kommentarer på hver enkelt aktivitet gjennom å velge fanen Kommentarer, og deretter velge knappen for kommentar. Velg symbolet for å lagre kommentar etter at den er ferdig skrevet.

Figur 27 Legg inn kommentar på aktivitet
Kommentarer kan redigeres og slettes ( knappene).
Prosjektets aktiviteter kan vises i Gantt diagram gjennom å klikke "Gantt" fanen for prosjektet:

Figur 28 Prosjekt, Gantt diagram

	Benyttes til å forflytte seg langs tidsaksen
	zoome inn/ut i gantt diagrammet

Bygningselementer kan knyttes til prosjektet på samme måte som beskrevet for tilknytting til aktivitet ovenfor. Tilsvarende for kommentarer.

Problemløsning

Generelt

Arbeidsordre ikke tilgjengelig

Dersom fanen Prosjekter mangler, er det gjerne feil i konfigurasjonsfil for lasting av plugins "msmplugins.msm". Denne finnes under installasjonsdatamappe - typisk "C:\ProgramData\Jotne EPM Technology AS\MSM\3.2.b02.1029".
Sjekk at følgende seksjon finnes og ikke er kommentert bort:
<Plugin Type="Application" Id="WorkOrder">
<AssemblyGuid>12c67e53-6878-409e-8360-b6696d5a7e34</AssemblyGuid> <AssemblyPath>C:\ProgramData\Jotne EPM Technology AS\MSM \3.2.b021029 \WorkOrderPlugin.dll</AssemblyPath>
</Plugin>
Dersom seksjonen er der, må både path og GUID (versjons-id) stemme med installert versjon. Sjekk eventuelt med leverandør.

Feilmeldinger "no access" eller tilsvarende

Dette kan skje dersom innlogget bruker ikke har full aksess til model og/eller repository som ble opprettet under installasjon. Bruk Developer Tool eller EDMsupervisor™ og sjekk/modifiser adgangsrettigheter.

Annex : Tom IFC fil

Kopier innholdet i «boksen» til en tekstfil, for eksempel med navn «tom.ifc», med en teksteditor.
ISO-10303-21;
HEADER;
/******************************************************************************************
* STEP Physical File produced by: EDMsix Version 1.0100.b18 Dec 9 2015
* Module: EDMstepFileFactory/EDMapplicationServer
* Creation date: Mon Dec 14 19:25:19 2015
* Host: EPMT-ANTON2
* Database: O:\proj_dev\StOlav\lm_server\db\db1
* Database version: 6008
* Database creation date: Mon Nov 03 14:13:08 2014
* Schema: IFC2X3
* Model: facility_0130_ArK_100.New_Model_1_ArK_V1
* Model creation date: Mon Dec 14 19:19:16 2015
* Header model:
* EDMuser: superuser
* EDMgroup: fm-admin
* License ID and type: 10007 : Test license. Expiry date: 1 Jan 2016
* EDMstepFileFactory options: 040000000
******************************************************************************************/
FILE_DESCRIPTION((''),'2;1');
FILE_NAME(
'O:\\proj_dev\\StOlav\\lm_server\\db
db1.facility_0130_ArK_100.New_Model_1_ArK_V1'
,
'2015-12-14T19:25:19',
('ANONYMOUS USER'),
('ANONYMOUS ORGANISATION'),
'EDMsix Version 1.0100.b18 Dec 9 2015',
'',
'');
FILE_SCHEMA(('IFC2X3'));
ENDSEC;
DATA;
ENDSEC;
END-ISO-10303-21;