A Generic Entity is a major BioT platform feature that allows you to create templates, and entities of that template, that represent data structures or flows of your business logic.
To learn more about the creation of generic entities templates and uses, click here.
Once you have created a generic entity template from the BioT Console, you'll be able to create an instance of it by following these steps:
- Locate the template unique ID
- Locate the organization that the device/user belongs to
- Make an API call to create an instance
Use the following API:
You can use the
filter search parameter to search for the template by its
See Using BioT Search APIs for a detailed explanation on how to use this API, or Generic Entity Usage Example - Log File for an exact example.
From the search result, save the unique template ID.
You do not need to repeat this step every time you need to create an instance of a generic entity.
You may do this once, when your application loads, and save the ID for later use.
Each device or user belongs to an organization. When a user logs in, it will get the organization ID as part of the log in response. A device can get its organization ID by querying its own details.
To obtain an organization unique ID, use the following API:
See Generic Entity Usage Example - Log File for an exact example.
To create an instance of the generic entity, make the following API call:
The generic entity name must be unique and have a max length of 32 characters
_templateId values obtained from the previous steps.
generic_entity_custom_attributes section, add the values of custom attributes added to the generic entity template.
Updated 2 months ago