About¶

About:

The About Page provides detailed information about the product.

Usage ---¶

The About Page is a part of an overarching concept to fulfil legal guidelines beside of providing additional information about the product (e.g. version).

Code ---¶

The component has 3 modes which can be selected using the licenseInfo parameter.

• api (preferred): License texts are lazy loaded separately for each component. Requires a service to provide license data. With the parameter licenseInfo.icon you can set a custom license file icon.
• text: Plain text input to dump all license texts
• iframe (avoid): Embedded page to display the licenses from another source.

Usage¶

import { SiAboutComponent } from '@siemens/element-ng/about';

@Component({
  imports: [SiAboutComponent,...]
})

Please use the appropriate input properties for the legal artifact links like Corporate Information or Acceptable Use Policy. This ensures the same order in all applications.

License via API¶

The API variant allows fast and neat navigation through the different license files. By clicking on the subsystems and components, the license details are loaded lazily via API and revealed when loaded.

Just set the licenseInfo.api parameter to the API endpoint which provides the license data.

License data format¶

The JSON based API supported by the about dialog is structured into three levels of endpoints:

1. Endpoint: /api/licenses/

   • MIME Type: application/json
   • Description: Top-level index listing all subsystems
   • Result:

     [
         { "name": "OS", "href": "/api/licenses/os/"},
         { "name": "Dummy", "href": "/api/licenses/Dummy/"}
     ]
     

2. Endpoint: /api/licenses/<subsystem>

   • MIME Type: application/json
   • Description: Subsystem-level index listing all components
   • Result:

     [
         { "name": "boost 1.66", "href": "/api/licenses/os/boost_1.66.copyright"}
     ]
     

3. Endpoint: /api/licenses/<subsystem>/<component>

   • MIME Type: text/plain
   • Description: Literal content of the component’s copyright or acknowledgement file
   • Result:

     Boost copyright text
     

License Text¶

Use the licenseInfo.text parameter to display the provided license text as plain text.

License Introduction Text and API¶

If your application requires showing a disclaimer in addition to the component licenses provided via API, you can combine the parameters licenseInfo.text and licenseInfo.api.

License Iframe¶

You can also use a URL in the licenseInfo.iframe parameter to show an embedded page containing license information.