Difference between revisions of "Integration/Interface"
old>Admin |
m (10 revisions imported) |
||
| (8 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
=== Understanding interfaces === | |||
Interfaces allow access to the system with preset values for | Interfaces allow access to the system with preset values for | ||
| Line 13: | Line 13: | ||
* Create new records | * Create new records | ||
* Update an existing record | * Update an existing record | ||
Detailed information about the options can be found here: [[Interfaces]] | |||
=== Create operations === | |||
Create operations require no additional security information and can be used directly. | 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: | When updating an existing record a security token must be passed along to the interface: | ||
| Line 25: | Line 35: | ||
* a signature that guarantees that the server issued the token | * 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 [[Tutorial/Questionaires|Questionaires]] covers such an example. | |||
Latest revision as of 11:52, 10 December 2021
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
Detailed information about the options can be found here: Interfaces
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.