Image Removed

Image Added

Anchor
_Toc424624831 _Toc424624831

EDMmodelServerManager™

User Manual – general functionality
Version 0.7

Document revision history

Initials:

...

AETArne Tøn

...

MDMarco Delgado

...

JRAJorulv Rangnes

...

PPPrasad Pokala

...

PZPavelas Zolotariovas

...

...

...

...

...

...

...

Initials:
AETArne Tøn
MDMarco Delgado
JRAJorulv Rangnes
PPPrasad Pokala
PZPavelas Zolotariovas
PHPål Huse
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.

Anchor
_Toc424624832 _Toc424624832

Introduksjon

This document is a placeholder for a future English version of "Brukermanual for modellserver for St. Olav Eiendomsdrift, Trondheim." Følgende omhandles i denne manualen:
Installasjon
Brukeradministrasjon
Tekst skrevet med rød kursiv tilsvarendende dette er kommentarer til dokumentet.

Anchor
_Toc424624833 _Toc424624833

Referanser

...

From: Gudbrand Skarseth
Sent: 5. juni 2015 11:48
To: Arne Tøn
Cc: Pavelas Zolotariovas; Prasad Pokala; Marco Delgado
Subject: Releasenotes MSM3 - Release date tuesday 9. june.
New MSM3 core functionality

• Systems, zones and ownership nodes are not displayed in the IFC treeview any more.
    This reduces the number of nodes in the treeview significantly.
• New Catalog treeview showing all type objects in the model with their related element instances below.
    Must be configured in the enterprise registry.
    New Registry_Unit.xml checked in on \trunk\Install\Schemata\Export_Import\195.139.163.189.4020\ModelServer_#_ENTERPRISESCHEMA\EnterpriseModel_Entities
• New Systems treeview showing all groups, systems and zones in the model with their related element instances below.
    Must be configured in the enterprise registry.  New Registry_Unit.xml checked in (see above).
• Drag/drop functions for model import and export in Project Explorer
• Drop of documents (files) to any building object in the Model explorer
• Drag-drop export (check-out) of IFC files from Model Explorer.
• Drop of IFC files to Model Explorer initiates Check-in/Merge dialog.
• Animated image (GIF) in row indicator of the Project Explorer and Model Explorer indicating progress during export/import
  Gudbrand
  
  

  Anchor
  _Toc424624835 _Toc424624835

  Grunnfunksjonalitet / brukergrensesnitt

  Anchor
  _Toc424624836 _Toc424624836

  Anchor
  _Toc418757692 _Toc418757692

  Logge inn

  Brukere kan logge inn i modellserver dersom de har en brukerkonto. Om du ikke har noen brukerkonto, må denne opprettes av systemadministrator (superuser), se avsnitt xxx.
  For å holde orden på flere brukerkontoer og server kan du definere flere tilkoblingsoppsett (connections). Logg inn som følger:

...

Når all informasjon er lagt inn kandu sjekke om den korrekt ved å trykke "Test" knapp. Dersom informasjonen er riktig, skal knappen vise , dersom noe er galt vil du få en feilmelding. Det kan ta en liten stund fra du trykker på testknappen til testen er ferdig kjørt..
Dersom du krysser av "Log on when EDMmodelServer starts" vil du automatisk bli koblet til forrige brukte tilkobling når MSM klienten starter.
Dersom du krysser av "Use SSO" vil MSM klient bruke påloggingsinformasjon fra Windows / Active Directory, brukernavn og passord være grået ut, og din "domenebruker" vil bli brukt i stedet. Dette vil kun fungere dersom din domene-bruker er definert i modellserver, se avsnitt xxx.-
Du kan kjøre mot en local database på din egen maskin ved å bruke "LOCAL" fanen. Dette er en funksjon for spesielll bruk/brukere, og vil ikke bli omhandlet mer her.

Anchor
_Toc418757693 _Toc418757693

Anchor
_Toc424624837 _Toc424624837

Bytte passord

...

EDMmodelServerManager is divided into components, which are straightforward and have easy-to-use design-time experience. Each component can be customized based on user needs. If you want to have "Project Explorer" in the left bottom corner, you can drag and drop in there. After performed action selected component will always be located there (even after reloading EDMmodelServerManager) unless user will want to change it location again.

From "View" tab it possible to select two standard control windows layout options "Reload Last Saved" and "Default Layout".
"Reload Last Saved" – allows user to load last saved customization of windows layouts;
"Default Layout" – restores all component windows to default positioning.

Anchor
_Toc424624839 _Toc424624839

Working with Models

...

Users can export IFC models from EDMmodelServer™, both in STEP or XML format. Export option is also available either from "File" tab or from "Project Explorer" (right mouse click on the model and select "Export model"). As it was mentioned previously EDMmodelServer™ supports versioning at model level, so before exporting a model you should select a preferred model version.

Push "Browse" and navigate to the appropriate folder, where you want to save a model;
Note: It is not possible to store model on root level;
Rename Model name or accept the default model name;
Select in which format you want to save selected model;
Push "Export" button and wait for action to finish;
When export will finish file explorer will be opened.
Note: If you received an error message that export was unsuccessful please contact your EDM Administrator.

Anchor
_Toc418757698 _Toc418757698

Anchor
_Toc424624842 _Toc424624842

Åpne og lukke modeller

I Project Explorer listes tilgjengelige modeller, med navn, versjonsnummer, disiplin etc.
For å åpne ønsket modell, marker modellen i 'View' kolonnen som vist i figuren nedenunder. Flere modeller kan være åpne samtidig.
For å lukke modellen, fjern markering i 'View' kolonnen.

Anchor
_Toc418757699 _Toc418757699

Anchor
_Toc424624843 _Toc424624843

Model Navigation

...

Man kan ekspandere trestruktur og dobbeltklikke et element i strukturen for å zoome inn til det, samt se objektets egenskaper listet i 'Properties' vinduet for valgt element.

Anchor
_Toc418757701 _Toc418757701

Anchor
_Toc424624845 _Toc424624845

3D Viewer

...

Predefinert views velges ved å klikke symbolet og velge ønsket view:

For å zoome ut for å se hele modellen, klikk på .
For å zoome til et område, klikk på . Klikk så et punkt i viewer, og deretter et punkt til for å definere et rektangel for å zoome inn til dette.

Anchor
_Toc418757702 _Toc418757702

Anchor
_Toc424624846 _Toc424624846

Property Sheet

For et valgt element, vises dets egenskaper i Properties vinduet, under 'Properties' fanen. Egenskaper på hvit bakgrunn er egenskaper for det valgte elementet/individet, mens egenskaper som vises med rosa bakgrunn er egenskaper arvet fra aktuelt typeobjekt.

Under fanen 'Tasks' vil eventuelle oppgaver/arbeidsordre for aktuelt objekt listes.
Under fanen 'Relations', listes objektets relasjoner
Under fanen 'Placement' listes objektets posisjon (relative koordinater)
Under fanen 'Documents' listes eventuelle dokumenter for objektet. Se også kap. 5.1.

Anchor
_Toc418757703 _Toc418757703

Anchor
_Toc424624847 _Toc424624847

Reports

...

Man kan angi hvilke enheter man ønsker benyttet i modellene gjennom bruk av 'Unit Settings' og 'Unit Conversion On' under Tools menyen:

Klikke på 'Unit Settings' for å endre de enheter som ønskes benyttet for de ulike målerverdiene. Velg enheter og trykk OK for å aktivere.

For at endrede enheter skal vises i Propeties vinduet, må 'Unit Conversion On' være huket av (markert med blå ramme i figuren ovenfor).

Anchor
_Toc418757705 _Toc418757705

Anchor
_Toc424624849 _Toc424624849

Model Versioning

Har man en ny versjon av en modell, kan man importere den nye versjonen gjennom å høyreklikke på aktuell modell i Project Explorer. Man får da en contextmeny, og velger da 'Model Management > Import new version of model'.

Man får da opp en dialog for å velge fil inneholdende den nye versjonen. En del felter er preutfyllt, med informasjon fra aktuell versjon i databasen.

Felter med rød asterisk er obligatoriske. Fyll ut disse feltene, og velg 'Import' knappen for å importere den nye versjonen av modellen. Versjonsnummer for aktuell modell inkrementeres med en. Man kan når som helst åpne hvilken som helst av versjonene man har tilgjengelig, gjennom å velge ønsket versjonsnummer for ønsket modell i Project Explorer.

Anchor
_Toc418757706 _Toc418757706

Anchor
_Toc424624850 _Toc424624850

Check-In and Merge

Users can open couple of models at the same time and 3D View of each will be merged into 3D scene by the system. During the check in operation, users can select the original model and the system will automatically merge the imported data back into the model.
Right mouse click on the model in "Project Explorer" and select Check-In/Merge option, a new for will appear.
"From Model" list or "From File" select which model/s to you want to merge with a selected model;
By need select your Check-In/Merge options (do not combine them between):
Version Control:
"Do not create new model version" – merge will be processed on the current model version.
Note: Rollback will not be possible.
"Create only one new model version" – create new version of the final result only. This option is relevant when you merge couple of models.
Note: By default merge will create new version for each individual input model.
Performance:
"Skip 3D outline" – skips 3D outline. Therefore merge functionality will be performed quickly;
"Skip entire 3D generation" –no 3D generation is being done.
Merge:
"Do not recalculate relative positions of elements" - by default when elements are checked-in to a new parent in the spatial structure the relative placement is re-referenced to the parents placement and relative placement is recalculated. This option turns off this feature.

Push "Check-In" button.
The system performs a deep merge operation where each element of the model is checked for existence or modification. If the element no longer exists in the imported data it's deleted from the model, whether if it's modified the model element is updated accordingly.
Note: Merge finished successfully will indicate that a new version of the model has been added to "Project Explorer".

If you suspect that merge was performed not correctly, press "Show Messages" button in order to show output log of the merge functionality which can be sent to support team for detailed investigation.

Anchor
_Toc418757707 _Toc418757707

Anchor
_Toc424624851 _Toc424624851

Access Control for Models

...

Anchor
_Toc418757711 _Toc418757711

Anchor
_Toc424624855 _Toc424624855

Create and Edit Reports

How to create a new report:

• Navigate to "Report Management" under Tools.
• Press [+] button
• Give the report a new name (Name)
• Navigate to "Assign to Objects"
• Choose selected type(s) for example"ifcDoor" and press [>>]
• The report is now created.

Anchor
_Toc418757712 _Toc418757712

Anchor
_Toc424624856 _Toc424624856

Running a report

• Open a model
• Select object(s) in Model Explorer
• Right-click and run the report by selecting it from the drop-down list under "Show Reports"
• Velg en dør i rapporten (klikk på en rad) slik at Properties vises.

Anchor
_Toc418757713 _Toc418757713

Anchor
_Toc424624857 _Toc424624857

Selecting columns

Use Drag-Drop from Properties to column header area to add new columns to report.

Anchor
_Toc418757714 _Toc418757714

Anchor
_Toc424624858 _Toc424624858

Formatting of cells

...

Please note:
There is a bug in your current MSM version that will cause this sort of formatting of reports not to be kept between MSM sessions. All sorts of report formatting (e.g. column format, column width, column sequence etc) is not always kept between sessions.
This bug is corrected and will be available in next release.

Setting format in report definition  

2. Specify "Format" in "Detail" tab in Report Management module.
    This will define the initial column format the first time the report is used by a user.
    This format can also be obtained by the "Reset to standard layout" button in the report module.
    Format specification syntax:  e.g. "BTASpace,Numeric,0.##; NTASpace,Numeric,0.##"
    ";" is used as splitter between each column spec.
    "," us used between column name (e.g. "BTASpace") and the column type and format spec (e.g. "0.##")
  

Anchor
_Toc418757715 _Toc418757715

Anchor
_Toc424624859 _Toc424624859

Running a report

...

Ved å klikke på dokument-ikon vil dokumentene vises i en tilpasset rapport "Documents". Rapporten må våre definert i konteksten "NoticeFlags", og kategorien må være "Document":

Om dette er i orden, skal det vises en rapport som ser omtrent slik ut:

Anchor
_Toc424624868 _Toc424624868

Basisfunksjonalitet

...

Last ned EDMSix fra omforent sted
Last ned maldatabase fra omforent sted
Set opp server med Areal Administrasjon "mal" database

Anchor
_Toc424624873 _Toc424624873

Klient Installasjon

Last ned installasjonssett for EDMmodelServerManager (MSM) fra omforent sted.
Pavelas: er dette fremdeles riktig?
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 release av en ny klient, bare kopier alle plugins til den nye opprettede klientmappen i \MSM)

Plassering, Plugins og rapportmaler
For å installere og/eller sette opp programtillegg for moduler som "Arealadministrasjon" og "Prosjekt" referer til manualer for den enkelte modul. Her er kun gitt den generelle framgangsmåten.
Dersom et programtillegg (plugin) ikke lastes, må blokkering fjernes (høyre-klikk på .dll – Egenskaper – Unblock )

For å sjekke om et programtillegg er lastet må du starte opp en installert klient, og logge inn med en gruppe som skal ha tilgang til tillegget, eksempel: logg inn i "fm-admin" gruppe for å sjekke Arealadministrasjon. Om Arealadministrasjon plugin er vellykket lastet inn, skal du kunne se "Areal Administrasjon" fanen/menyen.

"Areal Administrasjon" fane/meny

Anchor
_Toc424624874 _Toc424624874

Brukeradministrasjon

...

Velg "Active Directory" fane, fyll ut eventuelt gruppenavn for å begrense brukerlista til en gruppe og trykk "Get Users" :

Brukerliste fra Active Directory
Velg de brukerne som skal ha tilgang til modellserver ved å dobbeltklikke på dem. De skal da dukke opp i "Selected Users" feltet. Avslutt med å trykke "Add".
OBS: Adgangsrettigheter, gruppetilhørigheter osv i modellserver må settes opp på samme måte for SSO bruker som for enkeltstående brukere.

Anchor
_Toc424624877 _Toc424624877

Roller / grupper

Følgende roller er aktuelle:
fm-user: kun leseaksess for "åpne" data.
fm-owner: Full aksess til de kontrakter hvor din organisasjon (firma) har eierskap. Vanlig rolle for saksbehahandlere
fm-admin: full råderett over arealmodul. Denne rollen trengs for å tildele eierskap, dvs det må finnes minst en fm-admin for hvert prosjekt.
fm-prosjekt: full råderett over Arbeidsordre/Prosjekt modul
Roller kan konfigureres i Administration Center, hvor man kan gi tilgang til ulik funksjonalitet gjennom å markere et sett med aktuell funksjonalitet for den enkelte rolle. Rollene kommer med «default» sett av tilganger. Nedenunder vises en oversikt over tilgjengelige tilganger, med korte forklaringer:

Se avsnitt 8 for default settings for system default roller.
Nedenunder vises et eksempel for markering av tilgang for rollen fm-admin.

Eksempel, tilgang for fm-admin

...

Dialoger for tildeling av roller (fm-admin eller fm-user) for valgte prosjekt

Anchor
_Toc424624880 _Toc424624880

Backup

Mangler foreløbig

Anchor
_Toc424624881 _Toc424624881

Problemløsning

...

Default tilganger for system default roller:

...

Anchor
_Toc424624887 _Toc424624887

Teknisk informasjon

...

Følgende rapporter må være lagt inn i modellserver, og alle relevante brukere må ha tilstrekkelig tilgang: