New KOBI documentation is available: https://adeo-ccdp.gitbook.io/kobi/

What’s that ?

A Backend is an application that returns full HTML pages (with <html>, <head>, <body> tags) and can use KOBI tags (<kobi:fragment>, <kobi:container> …) to add components.

KOBI comes with a default backend, Shaper web used to display your designed Pages.

You may register custom backends in the case of a transition from a legacy website to a new KOBI site.

Registration

In order to use your Backend application in your Site configuration you have to register it.
The registration process is usually made at your application' startup by calling the Registry API

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "applicationType": "BACKEND",
  "applicationVersion": "1.0.0",
  "environment": "ref",
  "label": "my backend application",
  "name": "my-backend",
  "url": "https://my-backend-app-url",
  "rewriteContentTypePattern": "^(application/xhtml\+xml|.*javascript.*|application/json(;.*)?)$",
  "starterVersion": "2.0.0",
  "errorPassthrough": true,	
  "handleApplicationMode": false,
  "handlePageModel": false,
  "hostPassthrough": true
}

Applications may be registered manually through the Designer.
this might be usefull :

  • For test purpose
  • In the case your application is not aware of its URL at startup
  • If your application won’t change much

Administration

Once registered your application should be available in the Application administration and may be used in a Site configuration to define backend rules.