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

  1. The ACL configured in no.acando.iknowbase.plugin.microsite.adminAclExternalKey (Default value MICROSITE_ADMIN_ACL) must be created before you deploy the application.

  2. Set REQUIRED configuration options, see Configuration section below.

  3. 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.