com.esri.arcgis.geoprocessing.tools.datamanagementtools
Class CreateReplicaFromServer

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.datamanagementtools.CreateReplicaFromServer

All Implemented Interfaces:

GPTool

public class CreateReplicaFromServer
extends AbstractGPTool

Creates a replica using a specified list of feature classes, layers, feature datasets, and/or tables from a remote geodatabase using a geodata service published on ArcGIS Server. The Create Replica From Server tool is contained in the Data Management Tools tool box.

Usage tips:

• The source must be a geodata service representing a remote ArcSDE geodatabase. The destination may be either a local or a remote geodatabase.
• The data that you wish to replicate must be versioned, but not with the option to move edits to base. The database user that is connected must also have write permissions to the data. For two way and both types of one way replicas, all datasets must have a globalid column and have a high precision spatial reference.
• For check-out and one-way replicas the child replica geodatabase can be an ArcSDE, file or personal geodatabase.
• For two-way and one-way child to parent replicas the child geodatabase must be ArcSDE.
• To use archiving for one-way replicas the parent workspace must be connected to the Default version. For one-way child to parent replicas the child workspace must be connected to the Default version.
• The default for feature classes is to replicate all features. The default filter for tables is Schema Only; only the schema for the table will be replicated. If you set the environment or specify replica geometry features, it will be applied as a spatial filter where only features intersecting the extent will be replicated. Tables will also include rows that are related to rows which are part of the replica.
• Replica Geometry Features can be used to define the replica geometry. You can also use the environment setting to define the replica geometry.
  • If only the Replica Geometry Features are set, only data intersecting the Replica Geometry Features will be replicated.
  • If only the environment setting is set, only data intersecting the extent will be replicated.
  • If both Replica Geometry Features and the environement are set, the Replica Geometry Features will be used.
  • If neither Replica Geometry Features nor the environment is specified, the full extent of the data is used.
• The replica geometry features can be points, lines or polygons.
• A feature layer used for the replica geometry features can contain one or more features. If there are more than one, the geometries are merged and only data that intersect the merged geometries will be replicated.
• If filters (i.e. spatial, selection, or definition query) have been defined on the replica geometry features, only features that satisfy these filters will be used to define the replica geometry.
• The Re-use Schema parameter options are only available for check-out replicas

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

CreateReplicaFromServer()
Creates the Create Replica From Server tool with defaults.

CreateReplicaFromServer(Object inGeodataservice, Object datasets, String inType, Object outGeodatabase, String outName, String archiving)
Creates the Create Replica From Server tool with the required parameters.

Method Summary

String	getAccessType() Returns the Replica Access Type parameter of this tool .
String	getArchiving() Returns the Use archiving to track changes for 1 way replication parameter of this tool .
Object	getDatasets() Returns the Datasets parameter of this tool .
String	getExpandFeatureClassesAndTables() Returns the Expand Feature Classes and Tables parameter of this tool .
Object	getGeometryFeatures() Returns the Replica Geometry Features parameter of this tool .
String	getGetRelatedData() Returns the Replicate Related Data parameter of this tool .
Object	getInGeodataservice() Returns the Geodata Service parameter of this tool .
String	getInitialDataSender() Returns the Initial Data Sender parameter of this tool .
String	getInType() Returns the Replica Type parameter of this tool .
Object	getOutGeodata() Returns the parameter of this tool (Read only).
Object	getOutGeodatabase() Returns the Geodatabase to replicate data to parameter of this tool .
String	getOutName() Returns the Replica Name parameter of this tool .
String	getOutputName() Returns the Replica Name parameter of this tool (Read only).
String	getReuseSchema() Returns the Re-use Schema parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
void	setAccessType(String accessType) Sets the Replica Access Type parameter of this tool .
void	setArchiving(String archiving) Sets the Use archiving to track changes for 1 way replication parameter of this tool .
void	setDatasets(Object datasets) Sets the Datasets parameter of this tool .
void	setExpandFeatureClassesAndTables(String expandFeatureClassesAndTables) Sets the Expand Feature Classes and Tables parameter of this tool .
void	setGeometryFeatures(Object geometryFeatures) Sets the Replica Geometry Features parameter of this tool .
void	setGetRelatedData(String getRelatedData) Sets the Replicate Related Data parameter of this tool .
void	setInGeodataservice(Object inGeodataservice) Sets the Geodata Service parameter of this tool .
void	setInitialDataSender(String initialDataSender) Sets the Initial Data Sender parameter of this tool .
void	setInType(String inType) Sets the Replica Type parameter of this tool .
void	setOutGeodatabase(Object outGeodatabase) Sets the Geodatabase to replicate data to parameter of this tool .
void	setOutName(String outName) Sets the Replica Name parameter of this tool .
void	setReuseSchema(String reuseSchema) Sets the Re-use Schema parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateReplicaFromServer

public CreateReplicaFromServer()

Creates the Create Replica From Server tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

CreateReplicaFromServer

public CreateReplicaFromServer(Object inGeodataservice,
                               Object datasets,
                               String inType,
                               Object outGeodatabase,
                               String outName,
                               String archiving)

Creates the Create Replica From Server tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inGeodataservice - the geodata service representing the geodatabase from which the replica will be created. The geodatabase referenced by the geodata service must be an ArcSDE geodatabase.

datasets - the list of the feature datasets, stand-alone feature classes, tables, and stand-alone attributed relationship classes from the geodata service to replicate.

inType - the kind of replica to create.

outGeodatabase - the local geodatabase or geodata service that will host the child replica. Geodata services are used to represent remote geodatabases. The geodatabase can be an ArcSDE, file, or personal geodatabase. For two-way replicas the child geodatabase must be ArcSDE. For one-way and check-out replicas the geodatabase can be personal, file, or ArcSDE. Personal or file geodatabases must already exist before running this tool.

outName - the name that identifies the replica.

archiving - specifies whether to use the archive class to track changes instead of using the versioning delta tables. This is only available for one-way replicas.

Method Detail

getInGeodataservice

public Object getInGeodataservice()

Returns the Geodata Service parameter of this tool . This parameter is the geodata service representing the geodatabase from which the replica will be created. The geodatabase referenced by the geodata service must be an ArcSDE geodatabase. This is a required parameter.

Returns:

the Geodata Service

setInGeodataservice

public void setInGeodataservice(Object inGeodataservice)

Sets the Geodata Service parameter of this tool . This parameter is the geodata service representing the geodatabase from which the replica will be created. The geodatabase referenced by the geodata service must be an ArcSDE geodatabase. This is a required parameter.

Parameters:

inGeodataservice - the geodata service representing the geodatabase from which the replica will be created. The geodatabase referenced by the geodata service must be an ArcSDE geodatabase.

getDatasets

public Object getDatasets()

Returns the Datasets parameter of this tool . This parameter is the list of the feature datasets, stand-alone feature classes, tables, and stand-alone attributed relationship classes from the geodata service to replicate. This is a required parameter.

Returns:

the Datasets

setDatasets

public void setDatasets(Object datasets)

Sets the Datasets parameter of this tool . This parameter is the list of the feature datasets, stand-alone feature classes, tables, and stand-alone attributed relationship classes from the geodata service to replicate. This is a required parameter.

Parameters:

datasets - the list of the feature datasets, stand-alone feature classes, tables, and stand-alone attributed relationship classes from the geodata service to replicate.

getInType

public String getInType()

Returns the Replica Type parameter of this tool . This parameter is the kind of replica to create. This is a required parameter.

Returns:

the Replica Type

setInType

public void setInType(String inType)

Sets the Replica Type parameter of this tool . This parameter is the kind of replica to create. This is a required parameter.

Parameters:

inType - the kind of replica to create.

getOutGeodatabase

public Object getOutGeodatabase()

Returns the Geodatabase to replicate data to parameter of this tool . This parameter is the local geodatabase or geodata service that will host the child replica. Geodata services are used to represent remote geodatabases. The geodatabase can be an ArcSDE, file, or personal geodatabase. For two-way replicas the child geodatabase must be ArcSDE. For one-way and check-out replicas the geodatabase can be personal, file, or ArcSDE. Personal or file geodatabases must already exist before running this tool. This is a required parameter.

Returns:

the Geodatabase to replicate data to

setOutGeodatabase

public void setOutGeodatabase(Object outGeodatabase)

Sets the Geodatabase to replicate data to parameter of this tool . This parameter is the local geodatabase or geodata service that will host the child replica. Geodata services are used to represent remote geodatabases. The geodatabase can be an ArcSDE, file, or personal geodatabase. For two-way replicas the child geodatabase must be ArcSDE. For one-way and check-out replicas the geodatabase can be personal, file, or ArcSDE. Personal or file geodatabases must already exist before running this tool. This is a required parameter.

Parameters:

outGeodatabase - the local geodatabase or geodata service that will host the child replica. Geodata services are used to represent remote geodatabases. The geodatabase can be an ArcSDE, file, or personal geodatabase. For two-way replicas the child geodatabase must be ArcSDE. For one-way and check-out replicas the geodatabase can be personal, file, or ArcSDE. Personal or file geodatabases must already exist before running this tool.

getOutName

public String getOutName()

Returns the Replica Name parameter of this tool . This parameter is the name that identifies the replica. This is a required parameter.

Returns:

the Replica Name

setOutName

public void setOutName(String outName)

Sets the Replica Name parameter of this tool . This parameter is the name that identifies the replica. This is a required parameter.

Parameters:

outName - the name that identifies the replica.

getAccessType

public String getAccessType()

Returns the Replica Access Type parameter of this tool . This parameter is the type of access you want: This is an optional parameter.

Returns:

the Replica Access Type

setAccessType

public void setAccessType(String accessType)

Sets the Replica Access Type parameter of this tool . This parameter is the type of access you want: This is an optional parameter.

Parameters:

accessType - the type of access you want:

getInitialDataSender

public String getInitialDataSender()

Returns the Initial Data Sender parameter of this tool . This parameter is used by replication to determine which replica can send changes when in disconnected mode. If you are working in a connected mode, this parameter is inconsequential. This ensures that the relative replica doesn't send updates until the changes are first received from the initial data sender. This is an optional parameter.

Returns:

the Initial Data Sender

setInitialDataSender

public void setInitialDataSender(String initialDataSender)

Sets the Initial Data Sender parameter of this tool . This parameter is used by replication to determine which replica can send changes when in disconnected mode. If you are working in a connected mode, this parameter is inconsequential. This ensures that the relative replica doesn't send updates until the changes are first received from the initial data sender. This is an optional parameter.

Parameters:

initialDataSender - used by replication to determine which replica can send changes when in disconnected mode. If you are working in a connected mode, this parameter is inconsequential. This ensures that the relative replica doesn't send updates until the changes are first received from the initial data sender.

getExpandFeatureClassesAndTables

public String getExpandFeatureClassesAndTables()

Returns the Expand Feature Classes and Tables parameter of this tool . This parameter is specifies whether you will include expanded feature classes and tables, such as those found in geometric networks, topologies, or relationship classes. This is an optional parameter.

Returns:

the Expand Feature Classes and Tables

setExpandFeatureClassesAndTables

public void setExpandFeatureClassesAndTables(String expandFeatureClassesAndTables)

Sets the Expand Feature Classes and Tables parameter of this tool . This parameter is specifies whether you will include expanded feature classes and tables, such as those found in geometric networks, topologies, or relationship classes. This is an optional parameter.

Parameters:

expandFeatureClassesAndTables - specifies whether you will include expanded feature classes and tables, such as those found in geometric networks, topologies, or relationship classes.

getReuseSchema

public String getReuseSchema()

Returns the Re-use Schema parameter of this tool . This parameter is indicates whether to reuse a geodatabase that contains the schema of the data you want to replicate. This reduces the amount of time required to replicate the data. This option is only available for check-out replicas. This is an optional parameter.

Returns:

the Re-use Schema

setReuseSchema

public void setReuseSchema(String reuseSchema)

Sets the Re-use Schema parameter of this tool . This parameter is indicates whether to reuse a geodatabase that contains the schema of the data you want to replicate. This reduces the amount of time required to replicate the data. This option is only available for check-out replicas. This is an optional parameter.

Parameters:

reuseSchema - indicates whether to reuse a geodatabase that contains the schema of the data you want to replicate. This reduces the amount of time required to replicate the data. This option is only available for check-out replicas.

getGetRelatedData

public String getGetRelatedData()

Returns the Replicate Related Data parameter of this tool . This parameter is specifies whether to replicate rows related to rows already in the replica. For example, consider a feature (f1) inside the replication filter and a related feature (f2) from another class outside the filter. Feature f2 is included in the replica if you choose to get related data. This is an optional parameter.

Returns:

the Replicate Related Data

setGetRelatedData

public void setGetRelatedData(String getRelatedData)

Sets the Replicate Related Data parameter of this tool . This parameter is specifies whether to replicate rows related to rows already in the replica. For example, consider a feature (f1) inside the replication filter and a related feature (f2) from another class outside the filter. Feature f2 is included in the replica if you choose to get related data. This is an optional parameter.

Parameters:

getRelatedData - specifies whether to replicate rows related to rows already in the replica. For example, consider a feature (f1) inside the replication filter and a related feature (f2) from another class outside the filter. Feature f2 is included in the replica if you choose to get related data.

getGeometryFeatures

public Object getGeometryFeatures()

Returns the Replica Geometry Features parameter of this tool . This parameter is the features used to define the area to replicate. This is an optional parameter.

Returns:

the Replica Geometry Features

setGeometryFeatures

public void setGeometryFeatures(Object geometryFeatures)

Sets the Replica Geometry Features parameter of this tool . This parameter is the features used to define the area to replicate. This is an optional parameter.

Parameters:

geometryFeatures - the features used to define the area to replicate.

getArchiving

public String getArchiving()

Returns the Use archiving to track changes for 1 way replication parameter of this tool . This parameter is specifies whether to use the archive class to track changes instead of using the versioning delta tables. This is only available for one-way replicas. This is a required parameter.

Returns:

the Use archiving to track changes for 1 way replication

setArchiving

public void setArchiving(String archiving)

Sets the Use archiving to track changes for 1 way replication parameter of this tool . This parameter is specifies whether to use the archive class to track changes instead of using the versioning delta tables. This is only available for one-way replicas. This is a required parameter.

Parameters:

archiving - specifies whether to use the archive class to track changes instead of using the versioning delta tables. This is only available for one-way replicas.

getOutGeodata

public Object getOutGeodata()

Returns the parameter of this tool (Read only). This is an derived parameter.

Returns:

the

getOutputName

public String getOutputName()

Returns the Replica Name parameter of this tool (Read only). This is an derived parameter.

Returns:

the Replica Name

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias