/
REST Glossary of Terms

REST Glossary of Terms

Glossary

ServiceBroker's primary purpose is to provide a powerful, REST API driven mechanism for integrating different systems.    

However, one of the key difficulties in systems integration is that different systems often use different terminology for the same things. 

This glossary defines common terms used throughout the ServiceBroker documentation, and helps to clarify what the terms mean.

On this page:

ServiceBroker TermMeaningCommon Alternate Terms
Common Data Model (CDM)The Common Data Model is the term ServicePower use to refer to the integration through Broker where we centralize and rationalize our data fields.
DispatchA Work Item has been Dispatched when it has been successfully sent to the Sub-system(s) which are responsible for informing the Worker about the Work Item.Earmarked
Primary Sub-systemThe Sub-system which is the "system of record" for the relevant information; generally, the Sub-system in which the information was initially created.
Sub-system

A software application that has configured, via the relevant Tenant's ServiceBroker configuration, to be integrated with ServiceBroker. Therefore, a Sub-system is a software application which ServiceBroker will initiate a connection to, rather than a software application which calls the ServiceBroker APIs. (Compare with System, below.)

However, note that a single software application could be both a Sub-system, and a System, if so configured.


System

A software application that has been integrated with ServiceBroker via the pathway of that application calling (using) the ServiceBroker APIs. Therefore, a System is a software application which calls the APIs provided by ServiceBroker, rather than a software application which ServiceBroker initiates connections to. (Compare with Sub-system, above.)

However, note that a single software application could be both a System, and a Sub-system, if so configured.  


System Access TokenA string (token) which not validates that a call to a ServiceBroker APIs is permitted, but which also Tenant the API call is associated with (and therefore which Tenant configuration is to be used when executing the API call).JWT, Token
TenantServiceBroker is a multi-tenant software application, allowing for multiple, independently operated and configured accounts to exist. These accounts are called Tenants in ServiceBroker.Entity, Account
WorkerAn individual person who can perform Work Items.Employee, Staff Member, Technician
Work CenterA grouping of Workers (e.g. a team, a service group, etc.)FRU
Work ItemA unit of activity that is to be / has been performed.Break, Job, Standard Activity, Task

Related content

REST Integration Overview
REST Integration Overview
More like this
RESTified APIs
RESTified APIs
More like this
REST APIs
More like this
ServiceMobility
ServiceMobility
More like this