Zellis (Preview)
This connector consists of various GET/POST/PUT/PATCH actions you can use to perform your daily tasks.
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 | Zellis Support |
| URL | https://www.zellis.com/contact-existing-zellis-customer/ |
| support@service.zellis.com |
| Connector Metadata | |
|---|---|
| Publisher | Zellis |
| Website | https://www.zellis.com/ |
| Privacy policy | https://www.zellis.com/privacy-policy/ |
| Categories | Business Intelligence;Human Resources |
The Zellis connector for Power Automate allows you to interact directly with your data in Zellis HCM, enabling rich business process automation. React to changes in data in real time to trigger flows. Allow flows to search, retrieve or update your data through the Zellis Intelligence Platform.
Prerequisites
To utilise the connector, you must be operating on version 6.0 or later of Zellis HCM Cloud and should also already have the Zellis Notification Hub enabled. Previous versions of Zellis HCM Cloud do not have the necessary functionality to support the connector operation. More details on the Notification Hub can be found at the following link: https://help.zellis.com/csm?id=kb_article_view&table=kb_knowledge&sys_id=de3907e71bb3d51068a843f5e34bcbb9 It will be necessary to have configured a user connection to the Zellis Intelligence Platform APIs for the user with which you will be creating Power Automate flows.
How to get credentials
Visit the Zellis Customer Help Centre https://help.zellis.com/csm for instructions on how to request your access credentials for the Zellis Intelligence Platform.
Get started with your connector
Visit the Power Automate knowledge hub on the Zellis Customer Help Centre https://help.zellis.com/csm for detailed documentation on how to configure your connection to the Zellis Intelligence Platform. We’ve create a library of template Power Automate flows to help you to quickly realise the operational efficiency savings which can be achieved. They can also provide a basis, or inspiration, for you to build upon to match more closely your business automation. The template library can be found in our customer help centre.
Known issues and limitations
The Search Zellis Records action does not at this time support pagination and so care should be taken to limit results sets to under 1000 records. If you expect to retrieve a large number of records then consider splitting your records using a filter.
Common errors and remedies
If you aren’t able to instantiate a connection with the Zellis Intelligence Platform, please check that you have entered the correct Client ID, secret and subscription key in your connection parameters. If you cannot retrieve the list of entity triggers, please ensure that you have entered the correct Notification Hub domain, context and HMAC key in your connection parameters. If you cannot retrieve the list if entities in the search or update actions, please ensure that you have entered the correct Zellis Intelligence Platform domain and contexts in your connection parameters.
FAQ
Visit the Zellis Customer Help Centre https://help.zellis.com/csm to access the knowledge base on how to interact with the Zellis Intelligence Platform.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Client Id | string | Client Id | True |
| Client Secret | securestring | Client Secret | True |
| Scope | string | Scope (Example: api://OdataServerClientId/.default). | True |
| Resource URI | string | Resource URI (Example: api://OdataServerClientId). | True |
| ZIP Domain | string | URL without http/https (Example: abc.com). | True |
| ZIP Read Context | string | ZIP Read Context (Example: zip/odata). | True |
| ZIP Write Context | string | ZIP Write Context (Example: zip/api). | True |
| Notification Hub Domain | string | URL without http/https (Example: abc.com). | True |
| Notification Hub Context | string | Notification Hub Context (Example: notificationhub). | True |
| APIM Subscription Key | string | APIM Subscription Key to access ZIP via APIM url. | |
| HMAC Signature Key | string | HMAC Signature Key to generate HMAC Access Token. |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Partially amend Zellis record |
Partially amend Zellis standard Zellis record available from list, e.g. Worker, via its WorkerNumber. |
| Search Zellis records |
Retrieve a list of Zellis standard records, e.g. Workers, that matches your search criteria. |
| Update Zellis record |
Update Zellis standard record available from list, e.g. Fixed Payment in Zellis Intelligence Platform. |
| Validate Notification |
To validate incoming webhook notification |
Partially amend Zellis record
Partially amend Zellis standard Zellis record available from list, e.g. Worker, via its WorkerNumber.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
Select entity name |
|
Request Body
|
body | True | dynamic |
Request for the selected entity. |
Returns
Search Zellis records
Retrieve a list of Zellis standard records, e.g. Workers, that matches your search criteria.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
Select entity name |
|
Filter
|
$filter | string |
Enter criteria to filter out the records |
|
|
Expand
|
$expand | string |
Enter entity name to expand on |
|
|
Order By
|
$orderby | string |
Enter field on which results should ordered by |
|
|
Top
|
$top | string |
Number of records to be returned |
|
|
Skip Token
|
$skiptoken | string |
Token number to go next set of pagination results |
|
|
Select
|
$select | string |
Enter fields to be returned in results |
Returns
Update Zellis record
Update Zellis standard record available from list, e.g. Fixed Payment in Zellis Intelligence Platform.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
Select entity name |
|
Request Body
|
body | True | dynamic |
Request for the selected entity. |
Returns
Validate Notification
To validate incoming webhook notification
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
X-Zip-Signature
|
X-Zip-Signature | True | string |
X-Zip-Signature |
|
Payload
|
payload | True | string |
Payload to verify |
Returns
Triggers
| Entity Trigger |
Trigger for webhook |
Entity Trigger
Trigger for webhook
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Entity Name
|
Event | True | string |
Name of entity on which trigger placed |
|
Create Event
|
Create | True | boolean |
Whether to enable trigger when new entity created |
|
Delete Event
|
Delete | True | boolean |
Whether to enable trigger when entity deleted |
|
Update Event
|
Update | True | boolean |
Whether to enable trigger when entity updated |
|
Enable/Disable trigger
|
IsEnabled | True | boolean |
Whether to enable or disable the trigger |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
specversion
|
specversion | string |
specversion |
|
id
|
id | string |
id |
|
source
|
source | string |
source |
|
type
|
type | string |
type |
|
time
|
time | string |
time |
|
topic
|
topic | string |
topic |
|
validationCode
|
data.validationCode | string |
validationCode |
|
validationUrl
|
data.validationUrl | string |
validationUrl |
|
Action
|
data.Action | string |
Action |
|
Entity
|
data.Entity | string |
Entity |
|
EntityId
|
data.EntityId | string |
EntityId |
|
EntityPath
|
data.EntityPath | string |
EntityPath |
|
UpdatedFields
|
data.UpdatedFields | array of string |
UpdatedFields |
|
UpdatedFieldsUrl
|
data.UpdatedFieldsUrl | string |
UpdatedFieldsUrl |
|
LeaveDate
|
data.LeaveDate | string |
LeaveDate |
|
ParameterFive
|
data.Payload.ParameterFive | string |
ParameterFive |
|
EventUUID
|
data.Payload.EventUUID | string |
EventUUID |
|
ConnectionType
|
data.Payload.ConnectionType | string |
ConnectionType |
|
ParameterOne
|
data.Payload.ParameterOne | string |
ParameterOne |
|
ParameterThree
|
data.Payload.ParameterThree | string |
ParameterThree |
|
OperatorId
|
data.Payload.OperatorId | string |
OperatorId |
|
DateTimeAmended
|
data.Payload.DateTimeAmended | string |
DateTimeAmended |
|
OperatorSelectionNo
|
data.Payload.OperatorSelectionNo | string |
OperatorSelectionNo |
|
ParameterFour
|
data.Payload.ParameterFour | string |
ParameterFour |
|
EventDatetime
|
data.Payload.EventDatetime | string |
EventDatetime |
|
ParameterTwo
|
data.Payload.ParameterTwo | string |
ParameterTwo |
|
DateTimeCreated
|
data.Payload.DateTimeCreated | string |
DateTimeCreated |
|
Application
|
data.Payload.Application | string |
Application |
|
hmac
|
data.additionalDetails.hmac | string |
hmac |
|
subject
|
subject | string |
subject |
|
eventType
|
eventType | string |
eventType |
|
eventTime
|
eventTime | string |
eventTime |
|
metadataVersion
|
metadataVersion | string |
metadataVersion |
|
dataVersion
|
dataVersion | string |
dataVersion |
|
verifySubscription
|
verifySubscription | boolean |
verifySubscription |
Definitions
StaticResponseWriteSchema
| Name | Path | Type | Description |
|---|---|---|---|
|
timeTaken
|
payload.timeTaken | string |
timeTaken |
|
service
|
payload.service | string |
service |
|
transactionId
|
payload.transactionId | string |
transactionId |
|
transactionId
|
transactionId | string |
transactionId |
|
errors
|
errors | array of object |
errors |
|
errorType
|
errors.errorType | string |
errorType |
|
errorCode
|
errors.errorCode | string |
errorCode |
|
message
|
errors.message | string |
message |
|
success
|
processingStatus.success | string |
success |
|
workerNumber
|
worker.workerNumber | string |
workerNumber |