Integration/Interface

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.