Skip to main content

IScopedOperationalResource

Resource API bound to an authenticated admin user by IOperationalResource.asUser. Every operation enforces the resource ACL and the column access rules, and runs the resource lifecycle hooks.

Error contract: a denied or failed operation is always visible. get, list, count, aggregate and delete throw, since their return value carries no room for an error; create and update resolve to { ok: false, error }. delete resolves to false when the record simply did not exist.

Properties​

aggregate​

aggregate: (filter, aggregations, groupBy?) => Promise<object[]>

Parameters​

ParameterType
filterIAdminForthSingleFilter | IAdminForthAndOrFilter | (IAdminForthSingleFilter | IAdminForthAndOrFilter)[]
aggregations{[alias: string]: IAggregationRule; }
groupBy?IGroupByRule | IGroupByRule[]

Returns​

Promise<object[]>


count​

count: (filter?) => Promise<number>

Parameters​

ParameterType
filter?IAdminForthSingleFilter | IAdminForthAndOrFilter | (IAdminForthSingleFilter | IAdminForthAndOrFilter)[]

Returns​

Promise<number>


create​

create: (record) => Promise<CreateResourceRecordResult & object>

Parameters​

ParameterType
recordany

Returns​

Promise<CreateResourceRecordResult & object>


dataConnector​

dataConnector: IAdminForthDataSourceConnectorBase


delete​

delete: (primaryKey) => Promise<boolean>

Parameters​

ParameterType
primaryKeyany

Returns​

Promise<boolean>


get​

get: (filter) => Promise<any>

Parameters​

ParameterType
filterIAdminForthSingleFilter | IAdminForthAndOrFilter | (IAdminForthSingleFilter | IAdminForthAndOrFilter)[]

Returns​

Promise<any>


list​

list: (filter, limit?, offset?, sort?, columns?) => Promise<any[]>

Parameters​

ParameterType
filterIAdminForthSingleFilter | IAdminForthAndOrFilter | (IAdminForthSingleFilter | IAdminForthAndOrFilter)[]
limit?number
offset?number
sort?IAdminForthSort | IAdminForthSort[]
columns?string[]

Returns​

Promise<any[]>


update​

update: (primaryKey, record) => Promise<any>

Parameters​

ParameterType
primaryKeyany
recordany

Returns​

Promise<any>