Service: Segment

Reading and editing the segments

Functions

ResultName / ParamsComment
SegmentGetResultsegment.GetReturns a filtered list of Segment Objects.
modestring(Optional) View of the objects to return: raw or effective. Default is effective. See DataMode.
includestring(Optional) Adds the other view to the result; only values that differ are added (under @meta.overlay). See DataMode.
filterDataFilter(Optional) Filter definition which determines the result set.
sortDataSortItem[](Optional) Sorting definition as a list of properties with order.
offsetint(Optional) Offset of the first Object in the result set that should be returned. Used for direct pagination.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
selectstring[](Optional) List of properties that should be contained in the result objects.
SegmentGetResultsegment.GetNextReturns a filtered list of Segment Objects as a follow up to a previous Get call.
contextstringThe context received within the last get result. Mandatory for subsequent get calls with pagination.
scrollint(Optional) Scrolls through the result set with 'Next' or 'Prev'. Used for pagination. See PaginationScroll.
offsetint(Optional) Offset of the first Object in the result set that should be returned. Used for direct pagination.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
Segmentsegment.GetOneReturns a single Segment Object identified by the given id.
idguidThe Segment's id.
modestring(Optional) View of the object to return: raw or effective. Default is effective. See DataMode.
includestring(Optional) Adds the other view to the result; only values that differ are added (under @meta.overlay). See DataMode.
selectstring[](Optional) List of properties that should be contained in the result object.
guidsegment.CreateCreates the Segment in the system and returns the id of the Segment. The Segment must not have an id. If an id is set, the creation is rejected and an empty id is returned.
objectSegmentRawThe Segment to create.
boolsegment.UpdateUpdates a Segment with data from the provided Object.
idguidId of the Segment to update.
objectSegmentRawSegment to update
boolsegment.SetSets specific properties of a Segment Object.
idguidId of the Segment to modify.
propsvalue{}(Key: SymbolPath) List of properties that should be set. Property paths may be used as ids to address any partial aspect of the Object.
boolsegment.DeleteDeletes a Segment Object. Returns true if successfully deleted or if no such Object existed to begin with.
idguidId of the Segment to delete.
boolsegment.BulkModifyPerforms a bulk of changes at once.
createSegmentRaw[](Optional) List of Segment Objects to create.
updateSegmentRaw[](Optional) List of Segment Objects to update.
setObjectAspect[](Optional) List of Segment Object properties to set.
deleteguid[](Optional) List of Segment ids to delete.

Notifications

Name / ParamsComment
segment.CreatedNotifies about new Segment Objects.
objectsSegment[]Newly created Segment Objects.
segment.UpdatedNotifies about updated Segment Objects.
objectsSegment[]Changed Segment Objects.
segment.DeletedNotifies about deleted Segment Objects.
idsguid[]Ids of the deleted Segment Objects.

Objects

Segment

This object extends SegmentRaw.

Property Type Description
EditTime time (Readonly, Not in default set)
EditUser string (Readonly, Not in default set)

SegmentGetResult

Property Type Description
Objects Segment[] Array of Objects.
Pagination Pagination Describes the result set, if not all Objects were returned.

SegmentRaw

Property Type Description
Id guid (Readonly)
Name string
Desc string
GeoPos GeoPosition Geographical coordinates.
Last modified September 25, 2026