Integration/Interface

From TempusServa wiki
Jump to navigation Jump to search

Understanding interfaces

Interfaces allow access to the system with preset values for

  • Wrapper
  • Stylesheet
  • Template
  • Language
  • User context

When accessing the interface the user is redirceted to the main page with the correct parameters set. In case the user context is active, a session with a matching user profile is also created i process.

The following types of record operations are allowed

  • Create new records
  • Update an existing record

Create operations

Create operations require no additional security information and can be used directly.

URL for testing the interface:

http://[server name]/[application]/webinterface?[interfacename]

Update operations

When updating an existing record a security token must be passed along to the interface:

  • The right data is displayed for the user
  • Bind user session to this piece of data

A security token contains

  • a reference to the record
  • a timestamp shen the token was issued
  • a signature that guarantees that the server issued the token

URL for testing the interface: http://[server name]/[application]/webinterface?[interfacename]=[security token]

Security tokens can be generated in various ways

  • Create a status action that generates a notification
  • Administrator tool: Designer > Modules > Admin Services > BuildSecuityToken
  • Add the special "Token display" field to a solution

Questionaires and email invitations

Generation of security tokens are closly tied to the use of questionaires and status actions.

The guide Questionaires covers such an example.