User Manual
Version 0.3work

Document revision history

Initials:
AETArne Tøn
MDMarco Delgado
JRAJorulv Rangnes
PPPrasad Pokala
PZPavelas Zolotariovas
PHPål Huse




Proprietary notice:
Information in this publication is subject to change without notice. The software described in this publication is furnished under license agreement or non-disclosure agreement. The software may be used only in accordance with the terms of those agreements. No part of this publication may be distributed to third parties, copied, duplicated, in any form, whole or in part, without the prior written permission of Jotne EPM Technology AS, Grenseveien 107, N-0607 Oslo, Norway.

Innhold
EDMmodelServerManager™ Arbeidsordre
1 Introduksjon
1.1 Referanser
1.2 Input fra Marco (rådata)
2 Installasjon
2.1 Server Installasjon
2.2 Klient installasjon
2.2.1 MSM Klient
2.2.2 Installasjon av klient-side plugins
2.2.3 Rapportmaler
2.2.4 Initiering av Arbeidsordre modul
2.2.5 Verifikasjon av Arbeidsordre modul
3 Vedlikehold av BIM for Arbeidsordre
4 Bruk av Arbeidsordre modul
4.1 Generelt
4.1.1 Registrere firma
4.2 Forespørsler
4.3 Prosjekter
4.3.1 Søke prosjekt
4.3.2 Redigere prosjekt
5 Problemløsning
5.1 Generelt
5.1.1 Arbeidsordre ikke tilgjengelig
5.1.2 Feilmeldinger "no access" eller tilsvarende

This document is a placeholder for a future English translation of "Brukermanual Prosjektmodul for St. Olav Eiendomsdrift, Trondheim."
Tekst skrevet med rød kursiv tilsvarendende dette er kommentarer til dokumentet.

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

Hi Arne,
Just commited the latest changes which among other things includes:

• BMS-469 - WO: Feedback notes 20150408 - Request Created By colomn and fields for assigning persons shows only first name

• BMS-319 - WO: Backref from objects to activity

• BMS-327 - WO: Milestones in GANTT

• Add project link to activity

• Activity Number shows as Project Number?

• Change request contact roles to its own enum

For BMS-319 I followed the Report approach. As such I have modified your "WOReports.qex" and created a new report (based on yours) called Element Issues (svn: …Install\schemata\Reports).
You are able to execute the report normally from Model Explorer, or from Viewer (see pic below).
To execute WO reports from the viewer just set the report category to "WorkOrder" and it will be available in the context menu.
I didn't add a specific Work Oder menu to Model Explorer, because MSM has a limitation (not sending group selection to plugins) which prevent the report execution on groups (I sent a previous email with this issue).
Since it would be incomplete (only execute reports from single selection) I have decided not to include that.
In the reports, when you select an item, if Activity/Project/Request  is present you can open them through the context menu.
Feel free to modify the report as you wish but don't change the name of the hidden columns ( xxx in report definition ).

From: Marco Delgado Sent: Friday, April 17, 2015 8:35 PM To: Arne Tøn Subject: RE: WO Module - "minifreeze"
Arne,
With respect to BMS-319
I found your report "WO_AssignedActivities" and your query schema "WOReports.qex" (you commited them). Are those the ones you were talking about in the email below?
The good news is that I can reuse them and I can add a way to execute WO reports directly from the plugin through context menu.
Also, I can implement a way for us to navigate from generic reposts in MSM to activities/requests/projects in WO.
To do this, I need to change some things in MSM related to the plugin framework and also to some other components.
I guess there is no problem with that, since you are planning to deliver another version of MSM to the customer, correct?
Let me know as soon as you can so I can know if I follow this strategy or not?

Last ned EDMSix fra omforent sted
Last ned maldatabase fra omforent sted
Set opp server med maldatabase
Dette er eksakt samme operasjon som for "Arealadministrasjon" modul, det er ikke nødvendig å kjøre en egen prosedyre for "Arbeidsordre".

I avsnittene nedefor er " klient_versjon_nr " typisk "3.2.b02.0912" eller tilsvarende.

• Last ned installasjonssett for EDMmodelServerManager (MSM) fra omforent sted.

• Eksekver EDMModelServerManager 3.2.b02 installasjonssett som ligger på skrivebordet.

• Last ned .ZIP "Plugin Folder" fra omforent sted

• Pakk ut .ZIP "Plugin Folder" til C:\ProgramData\Jotne EPM Technology AS\MSM\klient_versjon_nr\ mappe

• Ved oppgradering av klient, bare kopier alle plugins til den nye opprettede klientmappen i \MSM)

Figur 1 - Plassering av plugins og rapportmaler
Følgende plugins trengs for å kjøre "Arbeidsordre" modul:

• WorkOrderPlugin.dll

• WorkOrderPlugin.dll

Dersom plugins ikke lastes, må blokkering fjernes (høyre-klikk på .dll – Egenskaper – Unblock )

Figur 2 - Deblokkering av plugin (.DLL)

For å kunne eksportere standard Arbeidsordre rapporter må rapportmalene kopieres til C:\ProgramData\Jotne EPM Technology AS\MSM\ klient_versjon_nr \, se Figur 1 - Plassering av plugins og rapportmaler.
Malene lastes ned fra omforent sted.
Det er ingen rapporter definert i skrivende stund.

I foreliggende prototype må følgende gjøres etter initiall databaseinstallasjon med verktøy "EDM Supervisor" og/ eller "Developer Tool" fra MSM:

• Compile the Express schema "work_orders.exp"

• Create a repository named "WORep"

• Create a model in the repository "WOModel"

• Assign right permission for named users in both repository and model

• Deploy the latest query schema (work_orders_queries.exp)

Dette trinnet er ikkenødvendig dersom du bruker en ferdigoppsatt database (template database) fra 2015-01-13 eller senere.

Start MSM klient og logg inn som "superuser".
Om Arbeidsordre plugins er vellykket lastet inn, skal du kunne se "Prosjekter" fanen/menyen.

Figur 3 – Prosjekter/Arbeidsordre plug-in verktøylinje

Hele dette kapittelet er egentlig en "BIM prosess" og må samkjøres og harmoniseres med andre prosesser, for eksempel tilsvarende prosess for "Arealadministrasjon" modul.
Implisitt er dette en delprosess / variant av "Oppgradering av BIM", se (Jotne-1 ).
I skrivende stund – for WP prototype – er oppgradering ikke relevant.

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

Figur 4 - Verktøylinje

Fra "Prosjekter" verktøylinje gir knappen "Admin Console" aksess til å registrere firma og generiske ressurser som brukes i registrering av kunde / kontraktør i prosjekter og aktiviteter. Denne funksjonen vil bli utvidet i senere utgaver.

Figur 5 Admin Console

Figur 6 Dialoger for å registrere firma og generisk ressurs

Trykk på "Forespørsler" på verktøylinje for å åpne "Forespørsler" oversikt. Denne inneholder liste av forespørsler, og knapp for å opprette nye forespørsler.

Følgende funksjoner er tilgjengelig:

Opprette forespørsel

Figur 7 Opprette forespørsel
Feltbeskrivelser:

• Behov: kort beskrivelse av behovet

• Type: velg blant tilgjengelige typer fra nedtrekkslisten

  • Tilgjengelige typer: Repair, Request

• Fagområde: velg blant tilgjengelige fagområder fra nedtrekkslisten

  • Tilgjengelige fagområder: General/Electrical/Plumbing/Security/IT

• 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å

  Open

  

  ikonet for å koble objektene til forespørselen

Følgende funksjoner er tilgjengelig for kobling av bygningselementer:

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

Vurdering/behandling av forespørsel

Figur 8 Behandle forespørsel
Følgende funksjoner er tilgjengelig:

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

.

Trykk på "Prosjekter" på verktøylinje for å åpne "Prosjekter" oversikt. Denne inneholder liste av prosjekter, og knapp for å opprette nytt prosjekt.

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

 

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

Figur 10 - 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". Feltbeskrivelser:

• Navn: navnestreng for søket, starter med første karakter: f.eks. søk med 'Navn': "Sm" vil kun returnere prosjektet med nummer 3 i figuren ovenfor

• 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 – for prosjekter som starter etter 02.02.2015 og er avsluttet før 31.12.2015

    • Datofelt/type : "Planned Start"

    • Dato etter: "02.02.2015"

    • Dato før: "31.12.2015"

• Fra nummer: Prosjektnummer starter fra (f.eks."4", vil kun returnere prosjektnumre som starter på 4 eller høyere)

• Fra indeks: Indeks i database å starte fra

• Maksimum: Maksimum antall i søkeresultat

  • De to siste feltene gir muligheten til å kontrollere volum av søkeresultatet. For eksempel kan du starte på indeks 0 og returnere 10 prosjekter, og deretter søke fra 10 til 40, etc.

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

Gjennom å klikke symbolet

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

Figur 11 Dialog for å opprette prosjekt
Feltbeskrivelser:

• Navn: Gi prosjektet et beskrivende navn. Feltet er obligatorisk.

• Type: Velg aktuell type fra nedtrekkslisten. Tilgjengelige typer er:

  • Repair,

  • Periodic maintenance,

  • Planned maintenance,

  • Development

• Prosjektleder: Velg aktuell prosjektleder fra nedtrekkslisten.

• Klient: Oppdragsgiver for prosjektet, velges fra nedtrekkslisten

• Kontonr.: Prosjektets kontonummer. Feltet er obligatorisk.

• Start: Planlagt startdato for prosjektet (som default vises dagens dato). Velg aktuell dato fra kalenderfunksjonen

• Slutt: Planlagt sluttdato for prosjektet. Velges med kalenderfunksjonen

• Beskrivelse: Fritekst beskrivelse av prosjektet

Når feltene er gitt innhold, trykk på «Lagre» knappen for å opprette prosjektet, som så blir tilgjengelig i prosjektlisten, og tilgjengelig for redigering og ytterligere detaljering.

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

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

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 detaljert informasjon for aktiviteten.

Figur 13 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 valgt(e) bygningselement(er) til prosjektet.

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