Share via


LCP - iCordis

Retrieve submissions for iCordis e-loket forms, either by polling for them or by subscribing to a webhook.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name LCP nv
URL https://www.lcp.be
Email helpdesk@lcp.be
Connector Metadata
Publisher LCP nv
Website https://www.lcp.be
Privacy policy https://www.lcp.be/privacybeleid
Categories Productivity

LCP - iCordis

The LCP - iCordis connectors offers the possibility to get entries for an e-loket form on your website and use them in Microsoft application or tools.

Prerequisites

  • An account on the LCP (iCordis) backoffice for your municipality
  • Client/Secret to login log in iCordis.

How to get credentials

  1. Create an account in the CBO (https://#YOURCBOURL#/module/index/504)
  2. Send a request to helpdesk@lcp.be to give the created account access to the API.

Get started with your connector

Get notified when a submission is created for a iCordis e-loket form

Use the trigger 'When a new submission is created for the e-loket form' to start a flow.
To subscribe to the trigger, one parameter is required 'formid'. This formid can be found in your iCordis Backoffice (/module/index/12, ID field).

Get the data for a submission (or multiple submissions)

Use the action 'Get submission(s) for an iCordis e-loket form' to get data for a submission (or multiple submissions). Multiple parameters are available to customize the response.
This action can be used on its own in a manual flow, or in a polling flow. This action can also be used to be executed when the trigger is fired.
In the 'eloket form id' field the id of the form needs to be entered. For this field, the 'formid' from the trigger can be used.
In the 'eloket submission id' field, the id of the submissions needs to be entered. For this field, the 'newrowid' from the trigger can be used.
These fields are returned:

  • 'formTitle': the title of the form
  • 'formID': the id of the form
  • 'errormessage': if there was an error, this field will contain that error
  • 'responseStatus': status of the response
  • 'nextPage': url for the nextPage, if paging is enabled
  • 'fields': list of fields for this form. Each item contains a fieldname, fielddescription and fieldtype.
  • 'data': key-value pair list. Each item contains a key containing the fieldname and a value, containing the entered value by the user.

Known issues and limitations

Only data for forms you have access to will be returned. If a request is made to get data for a form you don't have access to, an error will be returned. If you feel you should have access to that form data, please send a request to helpdesk@lcp.be.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

delete trigger

unsubscribe for the webhook for this form

Get submission(s) for an iCordis e-loket form

Get the submissions for a specific form. There is a possibility to pass several parameters to customize the export.

delete trigger

unsubscribe for the webhook for this form

Parameters

Name Key Required Type Description
formid to unsubscribe
formid True integer

the id of the form to stop receiving submissions from

webhook url
webhookurl string

the subscriber url to delete

Returns

response
boolean

Get submission(s) for an iCordis e-loket form

Get the submissions for a specific form. There is a possibility to pass several parameters to customize the export.

Parameters

Name Key Required Type Description
eloket form id
formid True integer

id of the form to get the submissions for

eloket submission id
entryid integer

id of the submission to get

date from
lastsynch date-time

get submissions from this datetime on

include files
includeFiles boolean

if true, will include the attachments as base64 string

include PDF of submission
includePDF boolean

if true, a base64 pdf will be included which contains the form with its values

include HTML of submission
includeHTML boolean

if true, will contain a base64 html of the form with its values

page
page integer

if given, will only return 10 submissions and paging will be enabled. If not given, all submissions will be returned.

Returns

Triggers

When a new submission is created for the e-loket form

subscribe to the webhook to get the new submissions for the specified form

When a new submission is created for the e-loket form

subscribe to the webhook to get the new submissions for the specified form

Parameters

Name Key Required Type Description
formid to get the new submissions for
formid True integer

id of the form to get the new submissions for

Returns

Name Path Type Description
formid
formid integer

formid

newrowid
newrowid integer

newrowid

Definitions

EloketExport

Name Path Type Description
nextPage
nextPage string

link to use to get the next page when paging is enabled

errormessage
errorMessage string

if there was an error, this field will contain the error message

formID
formID integer

id of the exported form

formTitle
formTitle string

title of the exported form

responseStatus
responseStatus string

status of the response.

data
data array of object

Key-Value list of entered values where the key is the fieldname

items
data object
fields
fields array of EloketField

list of fields available for this form

EloketField

Name Path Type Description
fieldName
fieldName string

name of the field

fieldType
fieldType string

type of the field

fieldDescription
fieldDescription string

description of the field

boolean

This is the basic data type 'boolean'.