FeatureServiceDataSource

Interface

FeatureServiceDataSource is created from feature service.

Inheritance: FeatureServiceDataSourceAbstractArcGISLayerFolderDataSource

Properties

Hide inherited properties
PropertyTypeNotes
addSourceVersion
 inherited 
() => void
addVersion
 inherited 
() => void
() => boolean
belongToDataSource
 inherited 

The data source which this data source derives from.

buildRecord
 inherited 
(dataany) => DataRecord
changeGDBVersion
 inherited 
(gdbVersionstring) => void
() => Promise<DataSource[]>
clearRecords
 inherited 
() => void
clearSourceRecords
 inherited 
() => void
count
 inherited 
number

The total records count depends on the current query

(dataSourceIdstring) => Promise<DataSource>
dataSourceManager
 inherited 

The data source manager, which is used to manage the data source, including create/get/destroy the data source instance.

dataViewId
 inherited 
string

The data view ID configured in JSON.

destroy
 inherited 
() => void
fetchSchema
 inherited 
() => Promise<IMDataSourceSchema>
() => DataSource[]
() => DataSource[]
getChildDataSource
 inherited 
(jimuChildIdstring) => DataSource
getChildDataSources
 inherited 
() => DataSource[]
getCountStatus
 inherited 
getDataSourceJson
 inherited 
() => IMDataSourceJson
getDataView
 inherited 
(dataViewIdstring) => DataSource
getDataViewConfig
 inherited 
() => IMDataViewJson
getDataViews
 inherited 
() => DataSource[]
getGDBVersion
 inherited 
() => string
getIdField
 inherited 
() => string
getInfo
 inherited 
() => IMDataSourceInfo
getLabel
 inherited 
() => string
getListenSelection
 inherited 
() => boolean
getLocalDataSource
 inherited 
(localIdstring) => DataSource
getLocalDataSources
 inherited 
() => DataSource[]
getMainDataSource
 inherited 
getRecord
 inherited 
(indexnumber) => DataRecord
getRecordById
 inherited 
(idstring) => DataRecord
getRecords
 inherited 
() => DataRecord[]
() => DataRecord[]
getRootDataSource
 inherited 
getSchema
 inherited 
() => string[]
() => number[]
getSelectedRecords
 inherited 
() => DataRecord[]
getSourceRecords
 inherited 
() => DataRecord[]
getSourceVersion
 inherited 
() => number
getStatus
 inherited 
getVersion
 inherited 
() => number
id
 inherited 
string

The data source ID.

isDataSourceSet
 inherited 
boolean

Whether a data source contains child data sources. A set data source won't create all its child data sources when ready is resolved. To make sure all child data sources are created, please use childDataSourcesReady .

isDataView
 inherited 
boolean

True means the data source is a data view. For local data source, this is false even the local data source is created from a data view.

isInAppConfig
 inherited 
() => boolean
isLocal
 inherited 
boolean

True means the data source is a local data source.

layer
 inherited 
Layer | ArcGISSubLayer

1 How to use ArcGIS Maps SDK for JavaScript layer 1.1 a data source may have a layer, the layer is the source of the data source ( isDataInDataSourceInstance should be false) and is used to save source data and communicate with Maps SDK for JavaScript (get popupTemplate, symbol and so on), if want to query features, should use data source instance, not the layer. 1.2 main data source and all other data views/local data source share the same layer. 1.3 selection view create a new layer when do query, but doesn't save the layer. 1.4 if widget needs an ArcGIS Maps SDK for JavaScript layer, call dataSource.createJSAPILayerByDataSource() to create a new layer, do not use the layer in data source instance directly, to listen data source changes and apply the changes to the new layer, see 2.2.

localId
 inherited 
string

The local ID of the data source.

order
 inherited 
number

Order in the parent data source.

parentDataSource
 inherited 

The parent data source of this data source, mull means it's a root data source.

ready
 inherited 
() => Promise<any>
selectRecordById
 inherited 
(idstring, record?DataRecord) => void
selectRecords
 inherited 
(optionsSelectOptions) => Promise<Pick<QueryResult"records">>
selectRecordsByIds
 inherited 
(idsstring[], records?DataRecord[]) => void
setCountStatus
 inherited 
(statusDataSourceStatus) => void
setDataSourceJson
 inherited 
(dsJsonIMDataSourceJson) => void
setListenSelection
 inherited 
(listenboolean) => void
setRecords
 inherited 
(recordsDataRecord[]) => void
setSourceRecords
 inherited 
(recordsDataRecord[]) => void
setStatus
 inherited 
(statusDataSourceStatus) => void
updateSelectionInfo
 inherited 
(optionsSelectOptions, triggerDataSourceDataSource, forceCheck?boolean) => void

addSourceVersion

inherited
Interface Property
addSourceVersion: () => void
Type declaration
    function(): void

    When current data source is created from an array of records, it will be saved in sourceRecords . Add the version of sourceRecords .setSourceRecords will add the version by default.

    Returns 
    void

addVersion

optionalinherited
Interface Property
addVersion: () => void
Type declaration
    function(): void

    Update data source version.

    Returns 
    void

areChildDataSourcesCreated

optionalinherited
Interface Property
areChildDataSourcesCreated: () => boolean
Type declaration
    function(): boolean

    Return whether all child data sources (including descendant data sources) are created. Data source has this method only if it is data source set ( dataSource.isDataSourceSet is true).

    Returns 
    boolean

belongToDataSource

optionalinherited
Interface Property
belongToDataSource: DataSource

The data source which this data source derives from.

buildRecord

inherited
Interface Property
buildRecord: (dataany) => DataRecord
Type declaration
    function(dataany): DataRecord

    Builds a data record only -- does not add the record into data source.

    Parameters
    ParameterType
    data
    any
    Returns 
    DataRecord

changeGDBVersion

inherited
Interface Property
changeGDBVersion: (gdbVersionstring) => void
Type declaration
    function(gdbVersionstring): void

    Change the GDB version for all layers in the service.

    Parameters
    ParameterType
    gdbVersion
    string
    Returns 
    void

childDataSourcesReady

optionalinherited
Interface Property
childDataSourcesReady: () => Promise<DataSource[]>
Type declaration
    function(): Promise<DataSource[]>

    All child data sources (including descendant data sources) are ready for use. Data source has this method only if it is data source set ( dataSource.isDataSourceSet is true).

    Returns 
    Promise<DataSource[]>

clearRecords

optionalinherited
Interface Property
clearRecords: () => void
Type declaration
    function(): void

    This function will clear the loaded records and won't clear the sourceRecords. Once the loaded records are cleared, the version in the data source info will be updated.

    Returns 
    void

clearSourceRecords

inherited
Interface Property
clearSourceRecords: () => void
Type declaration
    function(): void

    Clear both sourceRecords and loaded records. Both source version and version in data source info will be updated.

    Returns 
    void

count

optionalinherited
Interface Property
count: number

The total records count depends on the current query

createDataSourceById

optionalinherited
Interface Property
createDataSourceById: (dataSourceIdstring) => Promise<DataSource>
Type declaration
    function(dataSourceIdstring): Promise<DataSource>

    Create a child or a descendant data source by id. Data source has this method only if it is data source set ( dataSource.isDataSourceSet is true).

    Please note will only create the specific data source, won't create descendant data sources of it.

    Parameters
    ParameterType
    dataSourceId
    string
    Returns 
    Promise<DataSource>

dataSourceManager

inherited
Interface Property
dataSourceManager: DataSourceManager

The data source manager, which is used to manage the data source, including create/get/destroy the data source instance.

dataViewId

optionalinherited
Interface Property
dataViewId: string

The data view ID configured in JSON.

destroy

inherited
Interface Property
destroy: () => void
Type declaration
    function(): void

    Destroy the data source.

    Returns 
    void

fetchSchema

inherited
Interface Property
fetchSchema: () => Promise<IMDataSourceSchema>
Type declaration
    function(): Promise<IMDataSourceSchema>

    Fetch the data schema from an actual data source. If it's a statistic data source, the schema will not be fetched.

    Returns 
    Promise<IMDataSourceSchema>

getAllChildDataSources

optionalinherited
Interface Property
getAllChildDataSources: () => DataSource[]
Type declaration
    function(): DataSource[]

    Return all child data sources of a parent data source, includes the grandchildren

    Returns 
    DataSource[]

getAllDerivedDataSources

inherited
Interface Property
getAllDerivedDataSources: () => DataSource[]
Type declaration

getChildDataSource

optionalinherited
Interface Property
getChildDataSource: (jimuChildIdstring) => DataSource
Type declaration
    function(jimuChildIdstring): DataSource

    Get child data source by jimuChildId . You can get jimuChildId by getJimuChildId() .

    Parameters
    ParameterType
    jimuChildId
    string
    Returns 
    DataSource

getChildDataSources

optionalinherited
Interface Property
getChildDataSources: () => DataSource[]
Type declaration

getCountStatus

inherited
Interface Property
getCountStatus: () => DataSourceStatus
Type declaration

getDataSourceJson

inherited
Interface Property
getDataSourceJson: () => IMDataSourceJson
Type declaration
    function(): IMDataSourceJson

    The data source JSON object in app config.

    Returns 
    IMDataSourceJson

getDataView

inherited
Interface Property
getDataView: (dataViewIdstring) => DataSource
Type declaration
    function(dataViewIdstring): DataSource

    Get data view by data view ID.

    Parameters
    ParameterType
    dataViewId
    string
    Returns 
    DataSource

getDataViewConfig

inherited
Interface Property
getDataViewConfig: () => IMDataViewJson
Type declaration
    function(): IMDataViewJson

    Return the config of the current data source.

    Returns 
    IMDataViewJson

getDataViews

inherited
Interface Property
getDataViews: () => DataSource[]
Type declaration

getGDBVersion

inherited
Interface Property
getGDBVersion: () => string
Type declaration
    function(): string

    Get the service GDB version.

    Returns 
    string

getIdField

inherited
Interface Property
getIdField: () => string
Type declaration
    function(): string

    Return the data source ID field.

    Returns 
    string

getInfo

inherited
Interface Property
getInfo: () => IMDataSourceInfo
Type declaration
    function(): IMDataSourceInfo

    Return the data source info in redux store.

    Returns 
    IMDataSourceInfo

getLabel

inherited
Interface Property
getLabel: () => string
Type declaration
    function(): string

    Return data source label.

    Returns 
    string

getListenSelection

inherited
Interface Property
getListenSelection: () => boolean
Type declaration
    function(): boolean

    Return whether listen selection.

    Returns 
    boolean

getLocalDataSource

inherited
Interface Property
getLocalDataSource: (localIdstring) => DataSource
Type declaration
    function(localIdstring): DataSource

    Get local data source by local ID.

    Parameters
    ParameterType
    localId
    string
    Returns 
    DataSource

getLocalDataSources

inherited
Interface Property
getLocalDataSources: () => DataSource[]
Type declaration
    function(): DataSource[]

    Return all local data sources created from a main data source or data view.

    Returns 
    DataSource[]

getMainDataSource

inherited
Interface Property
getMainDataSource: () => DataSource
Type declaration

getRecord

inherited
Interface Property
getRecord: (indexnumber) => DataRecord
Type declaration
    function(indexnumber): DataRecord

    Get record by index

    Parameters
    ParameterType
    index
    number
    Returns 
    DataRecord

getRecordById

inherited
Interface Property
getRecordById: (idstring) => DataRecord
Type declaration

getRecords

inherited
Interface Property
getRecords: () => DataRecord[]
Type declaration

getRecordsWithSelection

inherited
Interface Property
getRecordsWithSelection: () => DataRecord[]
Type declaration
    function(): DataRecord[]

    If selected records are not loaded in the current data source, they will be concatenated to the end of records array. For example, record 1 is selected in data view 1 and it is not loaded in data view 2 (record 1 actually matches query params of data view 2), dataView2.getRecordsWithSelection() will return all loaded records in data view 2 and record 1.

    Returns 
    DataRecord[]

getRootDataSource

inherited
Interface Property
getRootDataSource: () => DataSource
Type declaration

getSchema

inherited
Interface Property
getSchema: () => IMDataSourceSchema
Type declaration
    function(): IMDataSourceSchema

    The schema returned here is the merged result of the configured schema and the fetched schema. The configured schema is the user's changes, such as a new data source name. The fetched schema is the original schema from AGOL/portal item or a remote database, such as the service name, the fields and the filters.

    Returns 
    IMDataSourceSchema

getSelectedRecordIds

inherited
Interface Property
getSelectedRecordIds: () => string[]
Type declaration
    function(): string[]

    Get selected record IDs

    Returns 
    string[]

getSelectedRecordIndexes

inherited
Interface Property
getSelectedRecordIndexes: () => number[]
Type declaration
    function(): number[]

    Get selected record indexes

    Returns 
    number[]

getSelectedRecords

inherited
Interface Property
getSelectedRecords: () => DataRecord[]
Type declaration

getSourceRecords

inherited
Interface Property
getSourceRecords: () => DataRecord[]
Type declaration

getSourceVersion

inherited
Interface Property
getSourceVersion: () => number
Type declaration
    function(): number

    When current data source is created from an array of records, it will be saved in sourceRecords . Return the version of sourceRecords .

    Returns 
    number

getStatus

inherited
Interface Property
getStatus: () => DataSourceStatus
Type declaration

getVersion

inherited
Interface Property
getVersion: () => number
Type declaration
    function(): number

    Return data source version.

    Returns 
    number

id

inherited
Interface Property
id: string

The data source ID.

isDataSourceSet

inherited
Interface Property
isDataSourceSet: boolean

Whether a data source contains child data sources. A set data source won't create all its child data sources when ready is resolved. To make sure all child data sources are created, please use childDataSourcesReady .

isDataView

inherited
Interface Property
isDataView: boolean

True means the data source is a data view. For local data source, this is false even the local data source is created from a data view.

isInAppConfig

inherited
Interface Property
isInAppConfig: () => boolean
Type declaration
    function(): boolean

    Return whether the data source is added in builder and is saved in app config.

    Returns 
    boolean

isLocal

inherited
Interface Property
isLocal: boolean

True means the data source is a local data source.

layer

optionalinherited
Interface Property
layer: Layer | ArcGISSubLayer

1 How to use ArcGIS Maps SDK for JavaScript layer 1.1 a data source may have a layer, the layer is the source of the data source ( isDataInDataSourceInstance should be false) and is used to save source data and communicate with Maps SDK for JavaScript (get popupTemplate, symbol and so on), if want to query features, should use data source instance, not the layer. 1.2 main data source and all other data views/local data source share the same layer. 1.3 selection view create a new layer when do query, but doesn't save the layer. 1.4 if widget needs an ArcGIS Maps SDK for JavaScript layer, call dataSource.createJSAPILayerByDataSource() to create a new layer, do not use the layer in data source instance directly, to listen data source changes and apply the changes to the new layer, see 2.2.

2 How to listen data source changes via DataSourceComponent 2.1 if widget loads records, use onDataSourceInfoChange to listen selected records change, query params change and loaded records change. 2.2 if widget doesn't load records (use a Maps SDK for JavaScript widget and needs an ArcGIS Maps SDK for JavaScript layer), use onQueryRequired to listen query params change, use onSelectionChange to listen selected records change.

3 Relation between output data source and origin data source 3.1 if schema is not changed (e.g. query output) and only has one origin data source, will use origin data source's layerDefinition , popupInfo and Maps SDK for JavaScript layer . 3.2 if schema is changed (e.g. chart output), need widget to set layerDefinition , popupInfo and Maps SDK for JavaScript layer to data source instance.

localId

optionalinherited
Interface Property
localId: string

The local ID of the data source.

order

optionalinherited
Interface Property
order: number

Order in the parent data source.

parentDataSource

inherited
Interface Property
parentDataSource: DataSource

The parent data source of this data source, mull means it's a root data source.

ready

inherited
Interface Property
ready: () => Promise<any>
Type declaration
    function(): Promise<any>

    Ready is resolved means the data source instance is ready for use. Please note that can not make sure all child data sources are created if a set data source is ready. To make sure all child data sources are created, please use childDataSourcesReady .

    Returns 
    Promise<any>

selectRecordById

inherited
Interface Property
selectRecordById: (idstring, record?DataRecord) => void
Type declaration
    function(idstring, record?DataRecord): void

    Select a record by ID. When select record by ID, we can pass in the record. So when the selected record is not loaded, we can add it in.

    Parameters
    ParameterTypeNotes
    id
    string

    The ID to be selected. The selection will be cleared if the ID is null.

    record
    DataRecord
    Returns 
    void

selectRecords

inherited
Interface Property
selectRecords: (optionsSelectOptions) => Promise<Pick<QueryResult"records">>
Type declaration

selectRecordsByIds

inherited
Interface Property
selectRecordsByIds: (idsstring[], records?DataRecord[]) => void
Type declaration
    function(idsstring[], records?DataRecord[]): void

    Select records by IDs. When select records by IDs, we can pass in the records. So when the selected records are not loaded, we can add them in.

    Parameters
    ParameterTypeNotes
    ids
    string[]

    The IDs to be selected. The selection will be cleared if the IDs are null.

    records
    DataRecord[]
    Returns 
    void

setCountStatus

optionalinherited
Interface Property
setCountStatus: (statusDataSourceStatus) => void
Type declaration

setDataSourceJson

inherited
Interface Property
setDataSourceJson: (dsJsonIMDataSourceJson) => void
Type declaration
    function(dsJsonIMDataSourceJson): void

    Update data source JSON in data source instance

    Parameters
    ParameterType
    dsJson
    IMDataSourceJson
    Returns 
    void

setListenSelection

inherited
Interface Property
setListenSelection: (listenboolean) => void
Type declaration
    function(listenboolean): void

    Whether listen selected records from other data sources which are derived from the same main data source. If true, will update selected record IDs of current data source info when selecting records via other derived data sources. Will also update selected record IDs when selecting records via current data source itself. If false, won't change selected record IDs when selecting records via other derived data sources. Will update selected record IDs only when selecting records via current data source itself.

    Main data source and its data views will listen selected records by default, local data source does not listen selected records by default.

    Parameters
    ParameterType
    listen
    boolean
    Returns 
    void

setRecords

inherited
Interface Property
setRecords: (recordsDataRecord[]) => void
Type declaration
    function(recordsDataRecord[]): void

    Update the records in the data source object only, does not update the source data.

    Parameters
    ParameterType
    records
    DataRecord[]
    Returns 
    void

setSourceRecords

inherited
Interface Property
setSourceRecords: (recordsDataRecord[]) => void
Type declaration
    function(recordsDataRecord[]): void

    When current data source is created from an array of records, will save it in sourceRecords . These two methods are used to update or get the source data.

    Parameters
    ParameterType
    records
    DataRecord[]
    Returns 
    void

setStatus

optionalinherited
Interface Property
setStatus: (statusDataSourceStatus) => void
Type declaration

updateSelectionInfo

inherited
Interface Property
updateSelectionInfo: (optionsSelectOptions, triggerDataSourceDataSource, forceCheck?boolean) => void
Type declaration
    function(optionsSelectOptions, triggerDataSourceDataSource, forceCheck?boolean): void

    Update selected records in data source info if the current data source listens selection change (see setListenSelection ) or the current data source is the trigger data source (that is to say, select via it).

    Before update info, will check whether these selected records match filters of the current data source firstly, and then only set the matched selected records to info. Will skip the check in some cases to improve performance if the forceCheck is not passed in or is false. For example, if the curren data source is main data source (we suppose that main data source contains all records, no need to check). But if the forceCheck is true, won't skip the check.

    Parameters
    ParameterType
    options
    SelectOptions
    triggerDataSource
    DataSource
    forceCheck
    boolean
    Returns 
    void

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.