Connect to a branch version

Available with Standard or Advanced license.

There are several workflows that require you to connect to a named version to access and work with your versioned geodatabase datasets. Connecting to a named version is a two-step process.

  • Configure the database connection—The database connection must be set to branch for the versioning type before you add data to a map and publish branch versioned data. The version properties are stored as part of the database connection file and used when performing tasks that use the database connection, such as when you add feature classes and tables to a map.
    Tip:

    Before geodatabase administrators can perform branch version administration tasks in the geodatabase, they must also set their database connection to use branch versioning.

  • Change the version for the map data source—In the active map, use the Change Version dialog box to connect to a specific version for viewing and editing. This requires that the data source is from a web feature layer with the version management capability enabled.

Configure the database connection for branch versioning

When working with branch versioned data for publishing or version administration tasks in the geodatabase, ensure that the connection properties are set to branch for the versioning type.

When you make a connection to an enterprise geodatabase using the Database Connection dialog box, the default versioning type specified in the application versioning options for the project is used. You can change the versioning type and the version you are connected to by opening the Geodatabase Connection Properties dialog box for the database connection.

Tip:

Use the application versioning options to configure the default versioning type used for database connections.

Geodatabase Connection Properties for branch versioning

How you access the geodatabase connection properties varies depending on whether you access it for a new connection or an existing connection.

  1. Access the database connection in the Databases folder Databases of the Catalog pane or Catalog view.
  2. Right-click the database connection Geodatabase Connection and click Geodatabase Connection Properties Geodatabase Connection Properties.
  3. Choose Branch for the Versioning Type option.
    Note:
    Only the default version is available.
  4. Click OK.

The connection file is updated to use branch for the versioning type.

Alternatively, you can use the Update Geodatabase Connection Properties To Branch geoprocessing tool to set the versioning type to branch for the database connection.

Change the version for the web feature layer

When you add a web feature layer that references registered data to a map, the web feature layer accesses the data in the default version. If the web feature layer has the version management capability enabled, you can use the Change Version dialog box to change the data source to a named version. When you change versions, all layers in the map that share the same data source are changed to access the data in the version you select.

Change Version dialog box

To change the version accessed by a web feature layer in the active map, complete the following steps:

  1. On the Versioning tab, in the Data Source group, ensure the desired web feature layer data source ArcGIS server is chosen from the drop-down menu.
  2. In the Versioning group, click the Change Version button Change Version.

    If you want to change to the default version when accessing a named version for the data source, you can bypass the Change Version dialog box by clicking Change To Default .

    Note:
    • If you have unsaved edits, you will be prompted to save or discard edits before changing the version.
  3. Choose a version from the list and click OK.

    You can also double-click the version name to change to that version.

When you change from one version to another, all layers in the web feature layer in the map change to the version you choose.

Dive-in:

You can also create a version on the Versioning tab and change to this new version for active map layers.