1. Introduction
Microsite solution for iKnowBase, developed as an iKnowBase JavaSDK plugin.
The solution is a simple, user-friendly tool for building simple web pages, ie microsites. It is intended for end users. The solution contains logic for creating and displaying microsites with given URLs and components like banners, quotes and articles. A user with technical skills can add more logic to a microsite using HTML and JavaScript.
2. Concept
The concept behind iKnowBase Microsites is that pages and content are defined as iKnowBase documents, with templates which controls the layout. When a user creates a page, a page document is created. Page content is saved as subdocuments or document links.
3. Metadata
There is only one document type in use: MICROSITE.
A microsite is stored as an iKnowBase document with subdocuments, all with the MICROSITE document type. The mother document represents the microsite and contains microsite specific settings. A microsite consists of a set of components (e.g. banner, quote, html component). Some components may contain elements (e.g. the article component contains articles).
The solution uses standard iKnowBase metadata in addition to custom microsite metadata. The plugin contains scripts which may create and update metadata upon plugin startup. See Configuration for more details.
4. User interface
The iKnowBase Microsite solution consists of an admin page, available at /<context-root>, for administration of the microsite pages, and the microsite pages which are rendered using a predefined template and the microsite content. Authorized users may run a microsite page in edit mode, which allows him to modify the configuration and content of the page. The microsite pages are available at /<context-root>/<microsite-url>.
Adminstration access to the iKnowBase Microsite solution requires iKnowBase Microsite ACL membership.
5. Installation
-
The ACL configured in
no.acando.iknowbase.plugin.microsite.adminAclExternalKey
(Default value MICROSITE_ADMIN_ACL) must be created before you deploy the application. -
Set REQUIRED configuration options, see Configuration section below.
-
Application deployment: See the iKnowBase Installation Guide for instructions for Java Plugin installation.
5.1. Dependencies
The application has these library dependencies, which you’ll need to deploy as well:
5.2. Metadata
The iKnowBase Microsite plugin requires a set of metadata, which automatically gets installed upon startup of the plugin. You may disable this behaviour, see the configuration table below.
5.3. Configuration
Note
|
You must disable Spring Boot’s default flyway integration to avoid conflict with Spring Boot’s Flyway setup. |
The following configuration options are available for iKnowBase Microsite:
Property | Description |
---|---|
flyway.enabled |
REQUIRED: Set this to false to disable Spring Boot’s default flyway integration. We’re handling this our selves and per plugin. |
no.acando.iknowbase.plugin.microsite.contextRoot |
Custom context root. Default value /microsite. |
no.acando.iknowbase.plugin.microsite.adminAclExternalKey |
External key for the ACL to be used to control access to administration of the microsites. Default value MICROSITE_ADMIN_ACL. |
no.acando.iknowbase.plugin.microsite.valueSetAclExternalKeys |
Comma separated list of external keys for ACLs which should be available for use in the microsites. No default value supplied, ie all ACLs will be available for use. |
no.acando.iknowbase.plugin.microsite.valueSetOrganizationDimensionExternalKeys |
Comma separated list of external keys for organization dimensions which should be available for use in the microsites. No default value supplied, ie all organization dimensions will be available for use. |
no.acando.iknowbase.plugin.microsite.databaseMigration.enabled |
Execute database migration (metadata) upon startup. Default value true. |
no.acando.iknowbase.plugin.microsite.databaseMigration.repair |
Execute repair for failed database migrations (metadata). Default value false. |
no.acando.iknowbase.plugin.microsite.databaseMigration.tableName |
Name of database table to be used for database migrations (metadata). Default value MICROSITE_FLYWAY. |
no.acando.iknowbase.plugin.microsite.databaseMigration.baselineVersion |
The version to tag an existing schema with when executing baseline. Default value 1. |