SpacesDataSource

Defined in: src/dapi.ts:805

Data source for working with Spaces - hierarchical containers for organizing entities and files. Spaces support nested subspaces, file storage, and can contain various entities like scripts, queries, etc.

Extends

• HttpDataSource<Project>

Constructors

Constructor

new SpacesDataSource(s): SpacesDataSource

Defined in: src/dapi.ts:806

Parameters

Parameter	Type
s	any

Returns

SpacesDataSource

Overrides

HttpDataSource.constructor

Properties

Property	Type	Inherited from	Defined in
clsName	string	HttpDataSource.clsName	src/dapi.ts:246
dart	any	HttpDataSource.dart	src/dapi.ts:245

Methods

allPackageVersions()

allPackageVersions(): HttpDataSource<Project>

Defined in: src/dapi.ts:301

Turns off package versions isolation. This DataSource will return all entities in all versions, not only the current one *

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.allPackageVersions

---

by()

by(i): HttpDataSource<Project>

Defined in: src/dapi.ts:306

Parameters

Parameter	Type
i	number

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.by

---

count()

count(): Promise<number>

Defined in: src/dapi.ts:272

Counts entities that satisfy the filtering criteria (see filter). See examples: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/smart-search

Returns

Promise<number>

Inherited from

HttpDataSource.count

---

createRootSpace()

createRootSpace(name): Promise<Project>

Defined in: src/dapi.ts:810

Parameters

Parameter	Type
name	string

Returns

Promise<Project>

---

delete()

delete(e): Promise<void>

Defined in: src/dapi.ts:296

Deletes an entity.

Parameters

Parameter	Type
e	Entity

Returns

Promise<void>

Inherited from

HttpDataSource.delete

---

filter()

filter(w): HttpDataSource<Project>

Defined in: src/dapi.ts:329

Applies filter to current request. Also can be set with list method "options" parameter See example: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/navigation/views/browse#entity-search

Parameters

Parameter	Type
w	string

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.filter

---

find()

find(id): Promise<Project>

Defined in: src/dapi.ts:286

Returns an entity with the specified id. Throws an exception if an entity does not exist, or is not accessible in the current context. Sample: https://public.datagrok.ai/js/samples/data-access/save-and-load-df

Parameters

Parameter	Type	Description
id	string	GUID of the corresponding object

Returns

Promise<Project>

{Promise<object>} - entity.

Inherited from

HttpDataSource.find

---

first()

first(): Promise<Project>

Defined in: src/dapi.ts:277

Returns fist entity that satisfies the filtering criteria (see filter).

Returns

Promise<Project>

Inherited from

HttpDataSource.first

---

id()

id(spaceId): SpaceClient

Defined in: src/dapi.ts:825

Returns a SpaceClient for the space with the specified ID. Use the returned client to manage subspaces, entities, and files within the space.

Parameters

Parameter	Type	Description
spaceId	string	The unique identifier of the space Project.id

Returns

SpaceClient

---

include()

include(include): HttpDataSource<Project>

Defined in: src/dapi.ts:341

Includes entity in the result

Parameters

Parameter	Type
include	string

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.include

---

list()

list(options?): Promise<Project[]>

Defined in: src/dapi.ts:257

Returns all entities that satisfy the filtering criteria (see filter). See examples: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/smart-search

Parameters

Parameter	Type
options	{ filter?: string; order?: string; pageNumber?: number; pageSize?: number; }
options.filter?	string
options.order?	string
options.pageNumber?	number
options.pageSize?	number

Returns

Promise<Project[]>

Inherited from

HttpDataSource.list

---

nextPage()

nextPage(): HttpDataSource<Project>

Defined in: src/dapi.ts:320

Returns next page of all entities that satisfy the filtering criteria (see filter). Works only if pageSize was set during previous list() call See examples: https://public.datagrok.ai/js/samples/dapi/projects-list

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.nextPage

---

order()

order(fieldName, desc?): HttpDataSource<Project>

Defined in: src/dapi.ts:335

Instructs data source to return results in the specified order.

Parameters

Parameter	Type	Default value
fieldName	string	undefined
desc	boolean	false

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.order

---

page()

page(i): HttpDataSource<Project>

Defined in: src/dapi.ts:312

Restricts results to the specified page number. See also nextPage.

Parameters

Parameter	Type
i	number

Returns

HttpDataSource<Project>

Inherited from

HttpDataSource.page

---

rootSpaceExists()

rootSpaceExists(name): Promise<boolean>

Defined in: src/dapi.ts:817

Checks if a root space (top-level space) with the given name already exists. Use this before creating a new root space to avoid naming conflicts.

Parameters

Parameter	Type
name	string

Returns

Promise<boolean>

---

save()

save(e): Promise<Project>

Defined in: src/dapi.ts:291

Saves an entity.

Parameters

Parameter	Type
e	Entity

Returns

Promise<Project>

Inherited from

HttpDataSource.save