User API

Cell

Other API in Package

Web

Internal Tunnel

Internal Web

Tunnel

A cell is a single storage container within a Cube. Nearly all methods that modify a cell require cell.save() to persist the changes.

Method Summary
Cell addChild(Cell child)

Sets this cell as the parent of the specified cell and returns this cell. This cell must be saved prior to calling this method.

Cell addSlice(String name, String value)

Adds the secondary slice to the cell. A cell can have a maximum of 1,000 secondary slices.

Cell deleteObject()

Deletes any associated object (Data, DataList, Payload, File) on save.

Cell deleteSlice(String name)

Deletes the secondary slice or slices with the given name.

Cell deleteSlice(String name, String value)

Deletes the secondary slice with the given name and value.

Cell deleteSlices()

Deletes all of the secondary slices from the cell.

  disconnectRemote()

If the object attached to this cell is stored remotely, this method removes the local pointer but leaves the remote file intact.

Cell encrypt(boolean encrypt)

Encrypts any child objects if true.

String get(String key)

Returns the specified value from the cell's properties or metadata.

String getCdnUrl(boolean secure)

Returns the full CDN url, if any, for the remote file. The cell must be saved before calling this method.

PacketDataList getChildren(String listName, long offset, int recordCount)

Returns the children of this cell, if any.

Data getData()

Returns the Data if set, null otherwise.

PacketDataList getDataList()

Returns the DataList if set, null otherwise.

long getDataSize()

Returns the data size (if any) in bytes.

Date getDate()

Returns the Date of this cell which by default is the date it was created.

String getExtra()

Returns the extra value.

File getFile()

Returns the File if set, null otherwise

String getFileId()

Returns the file ID, if any, for the remote file. See c:rfile tag. The cell must be saved before calling this method.

String getId()

Returns the cell ID. Max Length: 32.

String getImageId()

Returns the file handle, if any, for rendering an in image. See c:image tag. The cell must be saved before calling this method.

Data getMeta()

Returns the metadata.

Date getModified()

Returns the Date this cell was last modified.

String getName()

Returns the cell name. Max Length: 60.

Cell getParent()

Returns the parent of this cell, if any.

Payload getPayload()

Returns the Payload if set, null otherwise.

String getProfileId()

Returns the profileId.

String getSlice()

Returns the slice name. Max Length: 60

PacketDataList getSliceList()

Returns all of the secondary slices of this cell, if any.

Data getSlices()

Returns the secondary slices of this cell, if any.

int getSortOrder()

Returns the sort order.

String getStatus()

Returns the status. The default status is *.

String getType()

Returns the type of the data (if any).

boolean isSaved()

Returns true if this cell has been saved to persistent storage.

Cell remote(boolean remote)

If true, specifies child objects should be stored with a remote storage provider, if available.

Cell removeParent()

Removes the parent from this cell. Call save() to persist.

Cell save()

Saves the cell and returns it.

Cell set(String key, String value)

Sets or removes the metadata key/value of the cell. Total serialized metadata cannot exceed 255. See Data.toJSON().

Cell setData(Data data)

Associates a data with this cell. The cell must be new, already a data, or type must be reset (see Cell.clearType()).

Cell setDataList(PacketDataList datalist)

Associates a datalist with this cell. The cell must be new, already a datalist, or type must be reset (see Cell.clearType()).

Cell setDate(Date date)

Sets the date of the cell.

Cell setExtra(String extra)

Sets the extra property of the cell.

Cell setFile(File file)

Associates a file with this cell. The cell must be new, already a file, or type must be reset (see Cell.clearType()).

Cell setMeta(Data meta)

Sets the metadata of the cell. Total serialized metadata cannot exceed 255. See Data.toJSON().

Cell setName(String name)

Sets the name of the cell.

Cell setParent(Cell parent)

Sets the parent of this cell and returns this cell. The parent must be saved prior to calling this method.

Cell setPayload(Payload payload)

Associates a payload with this cell. The cell must be new, already a payload, or type must be reset (see Cell.clearType()).

Cell setProfileId(String profileId)

Sets the profileId of the cell. By default this is 'SYSTEM' or the profileId of the active user, but it can be anything.

Cell setSlice(String slice)

Sets the primary slice of the cell.

Cell setSortOrder(int sortOrder)

Sets the sort order of the cell which by default is 0 and must be 0 or less than 65535.

Cell setStatus(String status)

Sets the status of the cell.

Data toData()

Creates a data of this cell with with its properties and meta, if any. Note, if meta has keys that collide with the standard properties, meta will take precedence.

Payload toPayload()

Creates a payload of this cell with all child objects included except a file.

String toString()

Returns a description of this object.

Method Detail


Cell addChild(Cell child)

Sets this cell as the parent of the specified cell and returns this cell. This cell must be saved prior to calling this method.

Parameters:

  • Cell   child Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell addSlice(String name, String value)

Adds the secondary slice to the cell. A cell can have a maximum of 1,000 secondary slices.

Parameters:

  • String   name Required parameter. Maximum allowed size of parameter: 60
  • String   value Required parameter. Maximum allowed size of parameter: 120

Returns:  Cell

Since: 07-25-2019

top

Cell deleteObject()

Deletes any associated object (Data, DataList, Payload, File) on save.

Returns:  Cell

Since: 07-25-2019

top

Cell deleteSlice(String name)

Deletes the secondary slice or slices with the given name.

Parameters:

  • String   name Required parameter. Maximum allowed size of parameter: 60

Returns:  Cell

Since: 07-25-2019

top

Cell deleteSlice(String name, String value)

Deletes the secondary slice with the given name and value.

Parameters:

  • String   name Required parameter. Maximum allowed size of parameter: 60
  • String   value Required parameter. Maximum allowed size of parameter: 120

Returns:  Cell

Since: 09-12-2019

top

Cell deleteSlices()

Deletes all of the secondary slices from the cell.

Returns:  Cell

Since: 08-12-2019

top

disconnectRemote()

If the object attached to this cell is stored remotely, this method removes the local pointer but leaves the remote file intact.

Since: 07-25-2019

top

Cell encrypt(boolean encrypt)

Encrypts any child objects if true.

Parameters:

  • boolean   encrypt Required parameter.

Returns:  Cell

Since: 07-25-2019

top

String get(String key)

Returns the specified value from the cell's properties or metadata.

Parameters:

  • String   key Required parameter.

Returns:  String

Since: 09-20-2019

top

String getCdnUrl(boolean secure)

Returns the full CDN url, if any, for the remote file. The cell must be saved before calling this method.

Parameters:

  • boolean   secure  - if true, this will return the https:// url, otherwise the http version..

Returns:  String

Since: 07-25-2019

top

PacketDataList getChildren(String listName, long offset, int recordCount)

Returns the children of this cell, if any.

Parameters:

  • String   listName Required parameter.
  • long   offset  - 0 based. Required parameter.
  • int   recordCount Required parameter.

Returns:  PacketDataList

Since: 07-25-2019

top

Data getData()

Returns the Data if set, null otherwise.

Returns:  Data

Since: 07-25-2019

top

PacketDataList getDataList()

Returns the DataList if set, null otherwise.

Returns:  PacketDataList

Since: 07-25-2019

top

long getDataSize()

Returns the data size (if any) in bytes.

Returns:  long

Since: 07-25-2019

top

Date getDate()

Returns the Date of this cell which by default is the date it was created.

Returns:  Date

Since: 07-25-2019

top

String getExtra()

Returns the extra value.

Returns:  String

Since: 08-09-2019

top

File getFile()

Returns the File if set, null otherwise

Returns:  File

Since: 07-25-2019

top

String getFileId()

Returns the file ID, if any, for the remote file. See c:rfile tag. The cell must be saved before calling this method.

Returns:  String

Since: 07-25-2019

top

String getId()

Returns the cell ID. Max Length: 32.

Returns:  String

Since: 07-25-2019

top

String getImageId()

Returns the file handle, if any, for rendering an in image. See c:image tag. The cell must be saved before calling this method.

Returns:  String

Since: 07-25-2019

top

Data getMeta()

Returns the metadata.

Returns:  Data

Since: 07-25-2019

top

Date getModified()

Returns the Date this cell was last modified.

Returns:  Date

Since: 08-09-2019

top

String getName()

Returns the cell name. Max Length: 60.

Returns:  String

Since: 07-25-2019

top

Cell getParent()

Returns the parent of this cell, if any.

Returns:  Cell

Since: 07-25-2019

top

Payload getPayload()

Returns the Payload if set, null otherwise.

Returns:  Payload

Since: 07-25-2019

top

String getProfileId()

Returns the profileId.

Returns:  String

Since: 07-25-2019

top

String getSlice()

Returns the slice name. Max Length: 60

Returns:  String

Since: 07-25-2019

top

PacketDataList getSliceList()

Returns all of the secondary slices of this cell, if any.

Returns:  PacketDataList

Since: 09-12-2019

top

Data getSlices()

Returns the secondary slices of this cell, if any.

Returns:  Data

Since: 07-25-2019

top

int getSortOrder()

Returns the sort order.

Returns:  int

Since: 07-25-2019

top

String getStatus()

Returns the status. The default status is *.

Returns:  String

Since: 07-25-2019

top

String getType()

Returns the type of the data (if any).

Returns:  String

Since: 07-25-2019

top

boolean isSaved()

Returns true if this cell has been saved to persistent storage.

Returns:  boolean

Since: 07-25-2019

top

Cell remote(boolean remote)

If true, specifies child objects should be stored with a remote storage provider, if available.

Parameters:

  • boolean   remote Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell removeParent()

Removes the parent from this cell. Call save() to persist.

Returns:  Cell

Since: 09-06-2019

top

Cell save()

Saves the cell and returns it.

Returns:  Cell

Since: 07-25-2019

top

Cell set(String key, String value)

Sets or removes the metadata key/value of the cell. Total serialized metadata cannot exceed 255. See Data.toJSON().

Parameters:

  • String   key Required parameter.
  • String   value

Returns:  Cell

Since: 09-20-2019

top

Cell setData(Data data)

Associates a data with this cell. The cell must be new, already a data, or type must be reset (see Cell.clearType()).

Parameters:

  • Data   data Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setDataList(PacketDataList datalist)

Associates a datalist with this cell. The cell must be new, already a datalist, or type must be reset (see Cell.clearType()).

Parameters:

Returns:  Cell

Since: 07-25-2019

top

Cell setDate(Date date)

Sets the date of the cell.

Parameters:

  • Date   date Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setExtra(String extra)

Sets the extra property of the cell.

Parameters:

  • String   extra Required parameter. Maximum allowed size of parameter: 255

Returns:  Cell

Since: 08-09-2019

top

Cell setFile(File file)

Associates a file with this cell. The cell must be new, already a file, or type must be reset (see Cell.clearType()).

Parameters:

  • File   file Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setMeta(Data meta)

Sets the metadata of the cell. Total serialized metadata cannot exceed 255. See Data.toJSON().

Parameters:

  • Data   meta Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setName(String name)

Sets the name of the cell.

Parameters:

  • String   name Required parameter. Maximum allowed size of parameter: 60

Returns:  Cell

Since: 07-25-2019

top

Cell setParent(Cell parent)

Sets the parent of this cell and returns this cell. The parent must be saved prior to calling this method.

Parameters:

  • Cell   parent Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setPayload(Payload payload)

Associates a payload with this cell. The cell must be new, already a payload, or type must be reset (see Cell.clearType()).

Parameters:

  • Payload   payload Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setProfileId(String profileId)

Sets the profileId of the cell. By default this is 'SYSTEM' or the profileId of the active user, but it can be anything.

Parameters:

  • String   profileId Required parameter.

Returns:  Cell

Since: 07-25-2019

top

Cell setSlice(String slice)

Sets the primary slice of the cell.

Parameters:

  • String   slice Required parameter. Maximum allowed size of parameter: 60

Returns:  Cell

Since: 07-25-2019

top

Cell setSortOrder(int sortOrder)

Sets the sort order of the cell which by default is 0 and must be 0 or less than 65535.

Parameters:

  • int   sortOrder Required parameter. Maximum allowed size of parameter: 65535

Returns:  Cell

Since: 07-25-2019

top

Cell setStatus(String status)

Sets the status of the cell.

Parameters:

  • String   status Required parameter. Maximum allowed size of parameter: 24

Returns:  Cell

Since: 07-25-2019

top

Data toData()

Creates a data of this cell with with its properties and meta, if any. Note, if meta has keys that collide with the standard properties, meta will take precedence.

Returns:  Data

Since: 07-25-2019

top

Payload toPayload()

Creates a payload of this cell with all child objects included except a file.

Returns:  Payload

Since: 07-25-2019

top

String toString()

Returns a description of this object.

Returns:  String

Since: 07-25-2019

top
Copyright © 2006 - 2024, ContractPal, Inc. All rights reserved. API Date: Dec 03, 2024 10:24 AM