GenerateGeodatabaseParameters Class

  • GenerateGeodatabaseParameters
  • class Esri::ArcGISRuntime::GenerateGeodatabaseParameters

    The parameters to sync data of a sync-enabled geodatabase. More...

    Header: #include <GenerateGeodatabaseParameters.h>
    Since: Esri::ArcGISRuntime 100.0

    Public Functions

    GenerateGeodatabaseParameters()
    GenerateGeodatabaseParameters(const Esri::ArcGISRuntime::GenerateGeodatabaseParameters &other)
    GenerateGeodatabaseParameters(Esri::ArcGISRuntime::GenerateGeodatabaseParameters &&other)
    ~GenerateGeodatabaseParameters()
    Esri::ArcGISRuntime::AttachmentSyncDirection attachmentSyncDirection() const
    Esri::ArcGISRuntime::GenerateGeodatabaseParameters clone() const
    Esri::ArcGISRuntime::Geometry extent() const
    bool isEmpty() const
    bool isReturnAttachments() const
    bool isSyncAnnotations() const
    bool isSyncContingentValues() const
    bool isSyncDimensions() const
    QList<Esri::ArcGISRuntime::GenerateLayerOption> layerOptions() const
    Esri::ArcGISRuntime::SpatialReference outSpatialReference() const
    void setAttachmentSyncDirection(Esri::ArcGISRuntime::AttachmentSyncDirection attachmentSyncDirection)
    void setExtent(const Esri::ArcGISRuntime::Geometry &extent)
    void setLayerOptions(const QList<Esri::ArcGISRuntime::GenerateLayerOption> &generateLayerOptions)
    void setOutSpatialReference(const Esri::ArcGISRuntime::SpatialReference &outSpatialReference)
    void setReturnAttachments(bool returnAttachments)
    void setSyncAnnotations(bool syncAnnotations)
    void setSyncContingentValues(bool syncContingentValues)
    void setSyncDimensions(bool syncDimensions)
    void setSyncModel(Esri::ArcGISRuntime::SyncModel syncModel)
    void setUtilityNetworkSyncMode(Esri::ArcGISRuntime::UtilityNetworkSyncMode utilityNetworkSyncMode)
    Esri::ArcGISRuntime::SyncModel syncModel() const
    Esri::ArcGISRuntime::UtilityNetworkSyncMode utilityNetworkSyncMode() const
    Esri::ArcGISRuntime::GenerateGeodatabaseParameters &operator=(const Esri::ArcGISRuntime::GenerateGeodatabaseParameters &other)
    Esri::ArcGISRuntime::GenerateGeodatabaseParameters &operator=(Esri::ArcGISRuntime::GenerateGeodatabaseParameters &&other)

    Detailed Description

    GenerateGeodatabaseParameters is used with GeodatabaseSyncTask::generateGeodatabase to generate sync-enabled geodatabases from supporting ArcGIS Feature services.

    Note: Rather than constructing one of these directly, consider using the convenience method GeodatabaseSyncTask::createDefaultGenerateGeodatabaseParametersAsync(Geometry). It will create a GenerateGeodatabaseParameters object initialized with appropriate parameters based on the supported capabilities and data of the ArcGIS Feature Service.

    Member Function Documentation

    GenerateGeodatabaseParameters::GenerateGeodatabaseParameters()

    Default constructor.

    GenerateGeodatabaseParameters::GenerateGeodatabaseParameters(const Esri::ArcGISRuntime::GenerateGeodatabaseParameters &other)

    Copy constructor from other GenerateGeodatabaseParameters.

    GenerateGeodatabaseParameters::GenerateGeodatabaseParameters(Esri::ArcGISRuntime::GenerateGeodatabaseParameters &&other)

    Move constructor from other GenerateGeodatabaseParameters.

    GenerateGeodatabaseParameters::~GenerateGeodatabaseParameters()

    Destructor.

    Esri::ArcGISRuntime::AttachmentSyncDirection GenerateGeodatabaseParameters::attachmentSyncDirection() const

    Returns the attachment sync direction.

    See also setAttachmentSyncDirection().

    [since Esri::ArcGISRuntime 200.1] Esri::ArcGISRuntime::GenerateGeodatabaseParameters GenerateGeodatabaseParameters::clone() const

    Clones the GenerateGeodatabaseParameters to a new instance.

    Returns a new instance of the current GenerateGeodatabaseParameters.

    This function was introduced in Esri::ArcGISRuntime 200.1.

    Esri::ArcGISRuntime::Geometry GenerateGeodatabaseParameters::extent() const

    Returns the geographic extent within which features will be included in the sync-enabled geodatabase.

    To include non-spatial records, you must set up the LayerOptions for that layer to include a GenerateLayerOption::whereClause and set GenerateLayerOption::isUseGeometry to false.

    See also setExtent().

    bool GenerateGeodatabaseParameters::isEmpty() const

    Returns whether this GenerateGeodatabaseParameters is empty.

    bool GenerateGeodatabaseParameters::isReturnAttachments() const

    Returns whether the sync-enabled geodatabase should contain attachments for the features that are included.

    [since Esri::ArcGISRuntime 100.14] bool GenerateGeodatabaseParameters::isSyncAnnotations() const

    Returns whether Annotation data is to be included from the service, when generating, or downloading to, an offline geodatabase.

    Feature layers and tables are always included in the generation and synchronization of the geodatabase. Annotation data can be optionally included when downloading from the service.

    After this data is taken offline to a local geodatabase, any subsequent inserts, edits or deletions will NOT be applied to the server data when re-synchronized. If features linked to the annotation have been changed, the server WILL apply the feature-linked annotation updates. Another download from the server will replace any offline inserts, edits or deletions of Annotation features.

    The default value is true. Annotation data will be included.

    SyncCapabilities::isSupportsAnnotations can be used to check whether Annotation data is available from the service.

    This property can be used at the same time as specifying other additional data types to be included.

    This function was introduced in Esri::ArcGISRuntime 100.14.

    [since Esri::ArcGISRuntime 100.13] bool GenerateGeodatabaseParameters::isSyncContingentValues() const

    Returns whether Contingent Value data is to be included from the service, when generating, or synchronizing with, an offline geodatabase.

    Feature layers and tables are always included in the generation and synchronization of the geodatabase. Contingent Value data can be optionally included.

    The default value is false. Contingent Value data will not be included.

    SyncCapabilities::isSupportsContingentValues can be used to check whether Contingent Value data is available from the service.

    This property can be used at the same time as specifying other additional data types to be included.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    [since Esri::ArcGISRuntime 100.14] bool GenerateGeodatabaseParameters::isSyncDimensions() const

    Returns whether Dimension data is to be included from the service, when generating, or synchronizing with, an offline geodatabase.

    Feature layers and tables are always included in the generation and synchronization of the geodatabase. Dimension data can be optionally included.

    The default value is true. Dimension data will be included.

    SyncCapabilities::isSupportsDimensions can be used to check whether Dimension data is available from the service.

    This property can be used at the same time as specifying other additional data types to be included.

    This function was introduced in Esri::ArcGISRuntime 100.14.

    QList<Esri::ArcGISRuntime::GenerateLayerOption> GenerateGeodatabaseParameters::layerOptions() const

    Returns the options specifiying how to filter features from individual layers for inclusion into the geodatabase.

    See also setLayerOptions().

    Esri::ArcGISRuntime::SpatialReference GenerateGeodatabaseParameters::outSpatialReference() const

    Returns the spatial reference in which you would like the generated geodatabase.

    See also setOutSpatialReference().

    void GenerateGeodatabaseParameters::setAttachmentSyncDirection(Esri::ArcGISRuntime::AttachmentSyncDirection attachmentSyncDirection)

    Sets the attachment sync direction.

    • attachmentSyncDirection - The directions to sync attachments.

    This property specifies how the geodatabase should be configured to sync attachment data with its originating service. This parameter is available when the service resource sync capabilities includes supports attachmentsSyncDirection (SyncCapabilities::isSupportsAttachmentsSyncDirection returns true).

    attachmentSyncDirection defines how attachments will be synced and is only applicable if the feature service has attachments:

    When GenerateGeodatabaseParameters::isReturnAttachments is set to true, you can set GenerateGeodatabaseParameters::attachmentSyncDirection to either AttachmentSyncDirection::Bidirectional (default) or AttachmentSyncDirection::Upload. In this case, create replica includes attachments from the service.

    When GenerateGeodatabaseParameters::isReturnAttachments is set to false, you can set GenerateGeodatabaseParameters::attachmentSyncDirection to either AttachmentSyncDirection::Upload or AttachmentSyncDirection::Done (default). In this case, the geodatabase does not include attachments from the service.

    See also attachmentSyncDirection().

    void GenerateGeodatabaseParameters::setExtent(const Esri::ArcGISRuntime::Geometry &extent)

    Sets the geographic extent of features to include in the geodatabase.

    • extent - The geographic extent.

    See also extent().

    void GenerateGeodatabaseParameters::setLayerOptions(const QList<Esri::ArcGISRuntime::GenerateLayerOption> &generateLayerOptions)

    Sets the options specifiying how to filter features from individual layers for inclusion into the geodatabase.

    • generateLayerOptions - The options specifiying how to filter features.

    If not specified, all features within the extent are included. For non-spatial records, set GenerateLayerOption::useGeometry to false and provide a GenerateLayerOption::whereClause.

    See also layerOptions().

    void GenerateGeodatabaseParameters::setOutSpatialReference(const Esri::ArcGISRuntime::SpatialReference &outSpatialReference)

    Sets the spatial reference for the generated geodatabase.

    • outSpatialReference - The output spatial reference.

    If the data on the server is not in this spatial reference, it will be reprojected before being included in the geodatabase.

    See also outSpatialReference().

    void GenerateGeodatabaseParameters::setReturnAttachments(bool returnAttachments)

    Sets whether the sync-enabled geodatabase should contain attachments for the features that are included.

    • returnAttachments - Whether to include attachments.

    This property only applies if the feature service supports attachments.

    See also isReturnAttachments().

    [since Esri::ArcGISRuntime 100.14] void GenerateGeodatabaseParameters::setSyncAnnotations(bool syncAnnotations)

    Sets the syncAnnotations to syncAnnotations.

    This function was introduced in Esri::ArcGISRuntime 100.14.

    See also isSyncAnnotations.

    [since Esri::ArcGISRuntime 100.13] void GenerateGeodatabaseParameters::setSyncContingentValues(bool syncContingentValues)

    Sets the syncContingentValues to syncContingentValues.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    See also isSyncContingentValues.

    [since Esri::ArcGISRuntime 100.14] void GenerateGeodatabaseParameters::setSyncDimensions(bool syncDimensions)

    Sets the syncDimensions to syncDimensions.

    This function was introduced in Esri::ArcGISRuntime 100.14.

    See also isSyncDimensions.

    void GenerateGeodatabaseParameters::setSyncModel(Esri::ArcGISRuntime::SyncModel syncModel)

    Sets the SyncModel.

    • syncModel - The sync model.

    This property specifies whether the geodatabase should be configured to sync with the service as a whole (SyncModel::Geodatabase) or by individual layer or table (SyncModel::Layer).

    See also syncModel().

    [since Esri::ArcGISRuntime 100.11] void GenerateGeodatabaseParameters::setUtilityNetworkSyncMode(Esri::ArcGISRuntime::UtilityNetworkSyncMode utilityNetworkSyncMode)

    Sets the utilityNetworkSyncMode to utilityNetworkSyncMode.

    This function was introduced in Esri::ArcGISRuntime 100.11.

    See also utilityNetworkSyncMode.

    Esri::ArcGISRuntime::SyncModel GenerateGeodatabaseParameters::syncModel() const

    Returns the SyncModel.

    See also setSyncModel().

    [since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::UtilityNetworkSyncMode GenerateGeodatabaseParameters::utilityNetworkSyncMode() const

    Returns the generation and synchronization mode of Utility Network data from the service to an offline geodatabase.

    Feature layers and tables are always included in the generation and synchronization of the geodatabase. Utility Network System data can be optionally included.

    When this property is set to something other than UtilityNetworkSyncMode::None, GeodatabaseSyncTask::createDefaultGenerateGeodatabaseParametersAsync(Geometry) will include all the data layers and tables in the feature service in the layerOptions. Since only the feature layers' schema is required to support querying associations or tracing offline, their feature data may be filtered out by:

    Use SyncCapabilities to check which synchronization mode the feature service supports. If SyncCapabilities::isSupportsUtilityNetworkSystem is true, UtilityNetworkSyncMode::SyncSystemTables may be used. If SyncCapabilities::isSupportsUtilityNetworkTopology is also true, UtilityNetworkSyncMode::SyncSystemAndTopologyTables may be used.

    Setting this property to something other than UtilityNetworkSyncMode::None allows the UtilityNetwork query associations offline. Setting this property to SyncCapabilities::isSupportsUtilityNetworkTopology also enables tracing offline. However, SyncCapabilities::isSupportsUtilityNetworkTopology does not allow editing the feature layers, which means syncModel must be set to SyncModel::None or such a combination will result in an error in the GenerateGeodatabaseJob.

    The default value is UtilityNetworkSyncMode::None. Utility Network System data will not be included.

    This property can be used while specifying other additional data types to be included.

    This function was introduced in Esri::ArcGISRuntime 100.11.

    See also setUtilityNetworkSyncMode().

    Esri::ArcGISRuntime::GenerateGeodatabaseParameters &GenerateGeodatabaseParameters::operator=(const Esri::ArcGISRuntime::GenerateGeodatabaseParameters &other)

    Assignment operator from other GenerateGeodatabaseParameters.

    Esri::ArcGISRuntime::GenerateGeodatabaseParameters &GenerateGeodatabaseParameters::operator=(Esri::ArcGISRuntime::GenerateGeodatabaseParameters &&other)

    Move operator from other GenerateGeodatabaseParameters.

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