Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following illustrates the basic components of a genOSLC integration.

...

genOSLC Integration Components

genOSLC consists of two components (blue above):

  1. genOSLC Java Framework This is a Spring Boot based framework delivered as a Java Jar file. The Authoring Tool Integration implements an IToolAdapter Java interface and the genOSLC framework exposes an OSLC API for the the Authoring Tool.

  2. genOSLC Plugin : This is the server for the genOSLC plugin. It is delivered as a docker container. The plugin is integrated into the native UI of the Authoring Tool, which communicates with the genOSLC plugin notifying it of the selection of artifacts in the Authoring Tool. The genOSLC plugin enables display, creation and deletion of links to artifacts of the Authoring Tool.

Authoring Tool

The authoring tool (in green above), may be implemented in any technology. The following are general requirements of the Authoring tool Architecture.

  • The Authoring Tool has a web interface with which the Authoring Tool Integration may communicate (Native API above).

  • The Authoring Tool is capable of hosting the genOSLC plugin. In a web application the genOSLC plugin is hosted in an HTML iframe element. In programmatic clients, like Eclipse, this is often achieved with an embedded browser.

  • The Authoring Tool Native UI is capable of communicating with the genOSLC Plugin. This is normally done with JavaScript postMessage in the browser.

Doc in Smartfacts (will be moved):

https://smartfacts.atlassian.net/wiki/spaces/GV2

  • Different images for different Authoring tools

  • Every genOSLC will contain the OSLC Framework and the specific code for the given tool

  • 2 Containers

    • one for Authoring tool

    • one is genOSLC plugin

  • Tagging of Images

    • Default is “latest”

    • with PluginVersionOverride and “integrationVersionOverride” the Image tag can bei used

    • Images has a naming convention: only the name of the authoring tool changes

      • sfit-oslc-generic-<authoring tool>

  • genOSLC v2 a separate helm chart. It is necessary to be able to reference it from the smartfacts helm chart.

...

Purpose

OSLC is an Oasis standard (about OSLC) the purpose of which is to enable integration between application and product lifecycle management tools. The standard is meant to support collaboration between tools general purpose tools from various commercial vendors as well as custom-built solutions. OSLC was originally conceived by IBM 2009-2010, and the initial work was a multi-company effort heavily focused on IBM Enterprise Lifecycle Management technology. Since the growth and adoption of OSLC have steadily increased.

Barriers to adoption

There are some significant barriers to adoption of OSLC.