Tribal (Preview)

Tribal Edge modules, such as Tribal Admissions, provide staff and students the tools they need to succeed in the world of education. Connect to Tribal Edge modules using the Tribal Connector to manage information, create clearance checks for applications, and much more.

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	Tribal Group
URL	https://www.tribalgroup.com
Email	servicedesk@tribalgroup.com

Connector Metadata
Publisher	Tribal Group
Website	https://www.tribalgroup.com
Privacy policy	https://www.tribalgroup.com/privacy-policy
Categories	Business Management

Tribal Edge modules, such as Tribal Admissions, provide staff and students the tools they need to succeed in the world of education. Use the Tribal connector to be notified of events and to query and manipulate entities within the Tribal Edge module.

Prerequisites

To use the Tribal Connector you will need to be Tribal Edge user for your module of choice.

How to get credentials

To access the Tribal Connector you must have a user on your tenant that has permissions to:

• Subscribe to Events
• Perform any actions/queries within Tribal Edge e.g. if you want to obtain reference data you will need the "Reference Data - Read" permission

In Power Automate when you create a connection you will be promoted for:

• The type of environment you wish to access i.e. Live, Testing or Development.
• The region that you are in EMEA or APAC
• Your tenant you received upon joining Tribal Edge

Upon entering credentials you will be asked for consent, the below are required

• Events Connector Endpoint
• Connect to the web hooks

Get started with your connector

The purpose of the Tribal connector is to allow you integrate with any Power Automate connector and extend the Tribal Edge logic beyond what it can provide internally. The Tribal connector provides triggers to notified on e.g. an applicant has had details updated and actions that can be performed within Tribal Edge e.g. create a new Clearance Check Type.

Below highlights 2 common scenarios.

1. Use the Excel connector to retrieve rows from an excel spreadsheet hosted in the cloud and use the Tribal create and update actions to populate reference data.
2. Use the Tribal connector to listen for if a person has been updated, retrieve details about that person and notify a staff member through the Teams Connector.

Known issues and limitations

• Triggers that are produced via Tribal Edge only continue unique identitiers which need further querying. A seperate action to retrieve details, which are protected by permissions, can be performed to find out more.
• Triggers and actions are currently in development, these will become available in the connector as and when they are ready.

Common errors and remedies

• When performing an action, you may get a permissions error. This can be resolved by requesting permissions from your administrator.

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
Environment	string	Environment	True
Region	string	Region	True
Edge Tenant Id	string	Tenant Id for Tribal Edge	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a child entity	Create a child entity
Create an entity	Create an entity
Delete a child entity	Delete a child entity
Delete an entity	Delete an entity
HTTP Request	Send an HTTP request to Edge
Read a child entity	Read a child entity
Read an entity	Read an entity
Read child entity collection	Read child entity collection
Read entity collection	Read entity collection
Replace a child entity	This replaces the contents of a child entity. This will remove any properties from the entity that have not been included.
Replace an entity	This replaces the contents of an entity. This will remove any properties from the entity that have not been included.
Upload a document to a child entity	Upload a document to a child entity
Upload a document to an entity	Upload a document to an entity

Create a child entity

Operation ID:

CreateChildEntity

Create a child entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity the child is being created on
Parent Entity Id	parentId	True	string	The unique identifier for the parent entity the child is being created on
Child Entity	childEntity	True	string	The child entity being created
Correlation Id	x-correlation-id		string	Correlation Id added in the x-correlation-id header
body	body	True	dynamic

Returns

The outputs of this operation are dynamic.

Create an entity

Operation ID:

CreateEntity

Create an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being created
Correlation Id	x-correlation-id		string	Correlation Id added in the x-correlation-id header
body	body	True	dynamic

Returns

The outputs of this operation are dynamic.

Delete a child entity

Operation ID:

DeleteChildEntity

Delete a child entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity the child is being deleted
Parent Entity Id	parentId	True	string	The id of the parent entity
Child Entity	childEntity	True	string	The child entity being queried
Child Entity Id	childId	True	string	The id of the child entity
Correlation Id	x-correlation-id		string	Correlation id added in the x-correlation-id header

Delete an entity

Operation ID:

DeleteEntity

Delete an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being deleted
Id	id	True	string	The id of the entity
Correlation Id	x-correlation-id		string	Correlation Id added in the x-correlation-id header

HTTP Request

Operation ID:

RawRequest

Send an HTTP request to Edge

Parameters

Name	Key	Required	Type	Description
Service	service		string	Service containing information
key	key		string	key
value	value		string	value
Verb	verb	True	string	HTTP Verb
Body	body		string	Body of the request
Relative URL e.g. /api/referenceData	relativeUrl	True	string	Relative URL

Read a child entity

Operation ID:

ReadChildEntity

Read a child entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity the child is being read
Parent Entity Id	parentId	True	string	The unique identifier for the parent entity the child is being created on
Child Entity	childEntity	True	string	The child entity being read
Child Entity Id	childId	True	string	The id of the child entity

Returns

The outputs of this operation are dynamic.

Read an entity

Operation ID:

ReadEntity

Read an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being read
Id	id	True	string	The id of the entity

Returns

The outputs of this operation are dynamic.

Read child entity collection

Operation ID:

ReadChildEntities

Read child entity collection

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity the child is being read
Parent Entity Id	parentId	True	string	The unique identifier for the parent entity the child is being created on
Child Entities	childEntity	True	string	The child entities being read
Records to skip	skip	True	integer	The number of records to skip
Records to take	take	True	integer	The number of records to take
Filter	filter		string	Filter the records using Open Data Protocol syntax

Returns

The outputs of this operation are dynamic.

Read entity collection

Operation ID:

ReadEntities

Read entity collection

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being read
Records to skip	skip	True	integer	The number of records to skip
Records to take	take	True	integer	The number of records to take
Filter	filter		string	Filter the records using Open Data Protocol syntax

Returns

The outputs of this operation are dynamic.

Replace a child entity

Operation ID:

UpdateChildEntity

This replaces the contents of a child entity. This will remove any properties from the entity that have not been included.

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity which child is being updated
Parent Entity Id	parentId	True	string	The unique identifier for the parent entity the child is being updated on
Child Entity	childEntity	True	string	The parent entity being updated
Child Entity Id	childId	True	string	The id of the child entity
Correlation Id	x-correlation-id		string	Correlation id added in the x-correlation-id header
If-Match	If-Match	True	string	ETag added in the If-Match header
body	body	True	dynamic

Returns

The outputs of this operation are dynamic.

Replace an entity

Operation ID:

UpdateEntity

This replaces the contents of an entity. This will remove any properties from the entity that have not been included.

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being updated
Id	id	True	string	The id of the entity
Correlation Id	x-correlation-id		string	Correlation id added in the x-correlation-id header
If-Match	If-Match	True	string	ETag added in the If-Match header
body	body	True	dynamic

Returns

The outputs of this operation are dynamic.

Upload a document to a child entity

Operation ID:

UploadChildDocument

Upload a document to a child entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Parent Entity	parentEntity	True	string	The parent entity of the child
Parent Entity Id	parentId	True	string	The unique identifier for the parent entity of the child
Child Entity	childEntity	True	string	The child entity being uploaded a document on
Child Entity Id	childId	True	string	The id of the child entity
Input file to perform the operation on.	file	True	file	Input file to perform the operation on.
The type of document being uploaded	documentTypeName		string	The type of document being uploaded
Who created the document	createdBy		string	Who created the document

Upload a document to an entity

Operation ID:

UploadDocument

Upload a document to an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being created
Id	id	True	string	The id of the entity
Input file to perform the operation on.	file	True	file	Input file to perform the operation on.
The type of document being uploaded	documentTypeName		string	The type of document being uploaded
Who created the document	createdBy		string	Who created the document

Triggers

When a long running operation is performed on an entity	When a long running operation is performed on an entity
When an entity is created	When an entity is created
When an entity is deleted	When an entity is deleted
When an entity is updated	When an entity is updated
When an event is triggered on an entity	When an event is triggered on an entity

When a long running operation is performed on an entity

Operation ID:

LongRunningEvents

When a long running operation is performed on an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity
EventType	eventType	True	string	The event type
Property	key		string	Filter entity further
Value	value		string	Value

Returns

The outputs of this operation are dynamic.

When an entity is created

Operation ID:

CreatedEvents

When an entity is created

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being created
Entity	key		string	Filter entity further
value	value		string	value

Returns

The outputs of this operation are dynamic.

When an entity is deleted

Operation ID:

DeletedEvents

When an entity is deleted

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being deleted
Entity	key		string	Filter entity further
value	value		string	value

Returns

The outputs of this operation are dynamic.

When an entity is updated

Operation ID:

UpdatedEvents

When an entity is updated

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity	entityType	True	string	The entity being updated
Entity	key		string	Filter entity further
value	value		string	value

Returns

The outputs of this operation are dynamic.

When an event is triggered on an entity

Operation ID:

CustomEvents

When an event is triggered on an entity

Parameters

Name	Key	Required	Type	Description
Service	service	True	string	Service containing information
Entity Type	entityType	True	string	The entity being triggered
Event Type	eventType	True	string	The event type for the operation
Entity	key		string	Filter entity further
value	value		string	value

Returns

The outputs of this operation are dynamic.