Entities
Service for managing UiPath Data Fabric Entities.
Entities are collections of records that can be used to store and manage data in the Data Fabric. UiPath Data Fabric Guide
Methods¶
getAll()¶
Gets all entities in the system
Returns¶
Promise
<EntityGetResponse
[]>
Promise resolving to either an array of entities NonPaginatedResponse
Example¶
// Get all entities
const entities = await sdk.entities.getAll();
// Iterate through entities
entities.forEach(entity => {
console.log(`Entity: ${entity.displayName} (${entity.name})`);
console.log(`Type: ${entity.entityType}`);
});
// Find a specific entity by name
const customerEntity = entities.find(e => e.name === 'Customer');
// Use entity methods directly
if (customerEntity) {
const records = await customerEntity.getRecords();
console.log(`Customer records: ${records.items.length}`);
const insertResult = await customerEntity.insert([
{ name: "John", age: 30 }
]);
}
getById()¶
Gets entity metadata by entity ID with attached operation methods
Parameters¶
Parameter | Type | Description |
---|---|---|
id |
string |
UUID of the entity |
Returns¶
Promise
<EntityGetResponse
>
Promise resolving to entity metadata with operation methods EntityGetResponse
Example¶
// Get entity metadata with methods
const entity = await sdk.entities.getById(<entityId>);
// Call operations directly on the entity
const records = await entity.getRecords();
const insertResult = await entity.insert([
{ name: "John", age: 30 }
]);
getRecordsById()¶
getRecordsById<T>(entityId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
Gets entity records by entity ID
Type Parameters¶
Type Parameter | Default type |
---|---|
T extends EntityGetRecordsByIdOptions |
EntityGetRecordsByIdOptions |
Parameters¶
Parameter | Type | Description |
---|---|---|
entityId |
string |
UUID of the entity |
options? |
T |
Query options |
Returns¶
Promise
<T
extends HasPaginationOptions
<T
> ? PaginatedResponse
<EntityRecord
> : NonPaginatedResponse
<EntityRecord
>>
Promise resolving to either an array of entity records NonPaginatedResponse
Example¶
// Basic usage (non-paginated)
const records = await sdk.entities.getRecordsById(<entityId>);
// With expansion level
const records = await sdk.entities.getRecordsById(<entityId>, {
expansionLevel: 1
});
// With pagination
const paginatedResponse = await sdk.entities.getRecordsById(<entityId>, {
pageSize: 50,
expansionLevel: 1
});
// Navigate to next page
const nextPage = await sdk.entities.getRecordsById(<entityId>, {
cursor: paginatedResponse.nextCursor,
expansionLevel: 1
});
insertById()¶
insertById(
id: string,
data: Record<string, any>[],
options?: EntityOperationOptions): Promise<EntityOperationResponse>;
Inserts data into an entity by entity ID
Parameters¶
Parameter | Type | Description |
---|---|---|
id |
string |
UUID of the entity |
data |
Record <string , any >[] |
Array of records to insert |
options? |
EntityOperationOptions |
Insert options |
Returns¶
Promise
<EntityOperationResponse
>
Promise resolving to insert response EntityInsertResponse
Example¶
// Basic usage
const result = await sdk.entities.insertById(<entityId>, [
{ name: "John", age: 30 },
{ name: "Jane", age: 25 }
]);
// With options
const result = await sdk.entities.insertById(<entityId>, [
{ name: "John", age: 30 },
{ name: "Jane", age: 25 }
], {
expansionLevel: 1,
failOnFirst: true
});
updateById()¶
updateById(
id: string,
data: EntityRecord[],
options?: EntityOperationOptions): Promise<EntityOperationResponse>;
Updates data in an entity by entity ID
Parameters¶
Parameter | Type | Description |
---|---|---|
id |
string |
UUID of the entity |
data |
EntityRecord [] |
Array of records to update. Each record MUST contain the record Id. |
options? |
EntityOperationOptions |
Update options |
Returns¶
Promise
<EntityOperationResponse
>
Promise resolving to update response EntityUpdateResponse
Example¶
// Basic usage
const result = await sdk.entities.updateById(<entityId>, [
{ Id: "123", name: "John Updated", age: 31 },
{ Id: "456", name: "Jane Updated", age: 26 }
]);
// With options
const result = await sdk.entities.updateById(<entityId>, [
{ Id: "123", name: "John Updated", age: 31 },
{ Id: "456", name: "Jane Updated", age: 26 }
], {
expansionLevel: 1,
failOnFirst: true
});
deleteById()¶
deleteById(
id: string,
recordIds: string[],
options?: EntityDeleteOptions): Promise<EntityOperationResponse>;
Deletes data from an entity by entity ID
Parameters¶
Parameter | Type | Description |
---|---|---|
id |
string |
UUID of the entity |
recordIds |
string [] |
Array of record UUIDs to delete |
options? |
EntityDeleteOptions |
Delete options |
Returns¶
Promise
<EntityOperationResponse
>
Promise resolving to delete response EntityDeleteResponse