EDMmodelServerManager™ Work Order

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

Introduksjon

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.

Referanser

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

Input fra Marco (rådata)

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?

Installasjon

Server Installasjon

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".

Klient installasjon

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

MSM Klient

• Last ned installasjonssett for EDMmodelServerManager (MSM) fra omforent sted.
• Eksekver EDMModelServerManager 3.2.b02 installasjonssett som ligger på skrivebordet.

Installasjon av klient-side plugins

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

Rapportmaler

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.

Initiering av Arbeidsordre modul

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.

Verifikasjon av Arbeidsordre modul

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

Vedlikehold av BIM for Arbeidsordre

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.

Bruk av Arbeidsordre modul

Generelt

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

Figur 4 - Verktøylinje

Registrere firma og ressurser

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

Forespørsler

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

Prosjekter

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:

Søke prosjekt

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.

Opprette prosjekt uten forespørsel

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.

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 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:

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 15 Aktivitet. Detaljert info
NB: I skrivende stund er det litt problemer med synkronisering / aggregering av kostnader. Ved å redigere for eksempel "Hour Cost" eller lukke og gjenåpne aktivitet vil feltene bli synkronisert.
For å legge inn ressurser, velg legg til knappen, og dialog for å legge inn en ressurs åpnes:

Figur 16 Legg til ressurs
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.
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 17 Kostelementer
For datagruppen "Aktører" kan man legge inn aktører for den aktuelle aktiviteten. Som default legges det inn hvem som har registrert prosjektet (rolle 'issue_by'), og denne kan ikke slettes fra aktiviteten. Eventuelle øvrige aktører kan fjernes ( ) fra aktiviteten dersom dette er nødvendig.
Man kan knytte bygningselementer opp til aktivitet. Velg fanen "Bygningselementer" for å åpne dialogen for å koble valgt(e) bygningselement(er) til aktiviteten.

Figur 18 Tilknyttet bygningselement
Følgende funksjoner er tilgjengelig:

Dersom prosjektet har tilknyttede bygningselementer, kan disse knyttes mer spesifikt til aktiviteter gjennom å dra bygningselement fra prosjekt dialogen og over til aktuell aktivitetsdialog («drag and drop» funksjonalitet). I prosjektdialogen vil det da vises hvilken aktivitet bygningselementet er tilknyttet.

Figur 19 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 20 Dokument opplasting til prosjekt
Følgende dokumentfunksjoner er tilgjengelig:

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. En registreringsdialog åpnes dermed:

Figur 21 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 22 Aktivitet over budsjett
Tilsvarende markeres ressurs tidsforbruk over budsjettert med rød bakgrunn i aktiviteten:

Figur 23 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 24 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 25 Prosjekt, Gantt diagram
I Gantt diagrammet kan man bevege seg langs tidsaksen gjennom å bruke symbolene, og zoome inn/ut med symbolene.
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 "EDM Supervisor" og sjekk/modifiser adgangsrettigheter.