The Information Model Behind

Information Hierarchy

Smartfacts instance

The Model Warehouse

• A Smartfacts instance contains the complete Smartfacts server which holds one or more Model Warehouses.

• When you log-in, you can choose a Model Warehouse via the main menu if you are a member of multiple Model Warehouses. A Model Warehouse is a strictly separate area of data. You can link or search or do analysis only within one particular Model Warehouse. A Model Warehouse can carry an arbitrary number of projects, models, reviews, chats, etc.. It is recommended to keep the number of Model Warehouses to a minimum. For most organizations one Model Warehouse is appropriate.

• The next information level is the project. A Model Warehouse can carry an arbitrary number of projects. Projects contain users and content and allow to structure your content and share it with your team members.

Projects

• Projects help to structure any content like models, analysis, reviews, chats, etc. Every user has its own list of projects from which he can select and set the current project in the top bar of the application. Each project has its own project tree that references only those models which are part of the project.

• If you own the role Project Manager then you are entitled to start a new project.

• A user having started a new project is automatically project owner of this project. The project owner can invite other users as project owners or project users. Project owners have elevated rights and can rename, move, delete or update a model. Only users which are project owner or project user can see the project in their project list and access any information in the context of this project.

• All actions of commenting, adding links, contributing to reviews, using the model chat etc. will only be visible within the project.

  If you use a model in multiple projects, e.g. comments added in "Project A" will only be visible in "Project A". If the same model is also used in "Project B", the users of "Project B" will not see the comment when the current project is set to "Project B".

• You must decide to work with Smartfacts Global Configurations, IBM Jazz Global Configurations or no Global Configurations at all under My Project. This decision must be done in the profile tab of the project. It can only be done by a project owner. Only project owners will be able to see the profile tab.
  On the same profile tab you decide if you work with versioned links.

• The My Projects container presents this information:

  • Dashboard with the latest events

  • Project Tree

    • Models

    • References to external models like Codebeamer or Confluence

    • Global Components carrying Global Configurations

    • Pages

    • Analysis definitions

    • Files

• A favorite will be visible in every project which contains the referenced element, even if it has only been added in one project.

Models

• Models are published from within your authoring tool using the Smartfacts plug-ins.

• Only users that have been granted model manager rights can publish a model into a project. Having done so, the publishing user becomes the one and only model owner. The model owner can grant model ownership and visibility to other users.

Analysis Definitions, Chats

Analysis definitions and chats are project specific. They are only available in one project.

Comments

Comments are project and version specific. If you add a comment to a diagram or model element for a model in version 4, then it will only be visible in version 4. Navigating to version 5 will not show the comment in the Smartfacts application and also not in any plug-in.

Links

You can select between versioned and unversioned links in the project profile. Only project owners have access to the project profile under My Project.

Versioned Links

You can use versioned links to add links to a specific version of a model only. If you add a link to the latest version and publish a new version, then the link will be carried forward to the newly published version.

Unversioned Links

If you deactivate the versioned links option, then links are only defined between concept resources. The concept resource is the unversioned part of an artifact. Having linked two artifacts represents a link between any versions of the two artifacts.

Attachments

Attachments can be added to any versioned artifact of a model. They are treated like versioned links. An attachment is added to a specific version of the model. If the version is the latest version and a new version is published, then the attachment is carried forward to the newly published version of the artifact.

By selecting different versions of an artifact, version-specific attachments can be added to different versions of the artifact.