Version ändern (Data Management)

Zusammenfassung

Ändert den Workspace eines Feature-Layers oder einer Tabellensicht, um eine Verbindung mit der angegebenen Version herzustellen.

Verwendung

• Das Werkzeug kann nur für Feature-Layer und Tabellensichten verwendet werden.

• Die zum Erstellen der Eingabe-Feature-Layer oder Tabellensicht verwendete Enterprise-Geodatabase-Verbindungsdatei oder der Feature-Service wird von diesem Werkzeug nicht bearbeitet. Es wird lediglich der geöffnete Eingabe-Feature-Layer bzw. die geöffnete Tabellensicht geändert, um eine Verbindung mit der angegebenen Version herzustellen.

• Transaktions- und historische Sichten werden unterstützt.

Syntax

arcpy.management.ChangeVersion(in_features, version_type, {version_name}, {date})

Parameter	Erklärung	Datentyp
in_features	Der/die mit der angegebenen Version zu verbindende Feature-Layer/Tabellensicht.	Feature Layer; Table View
version_type	Gibt den Typ der Version an, mit der der Eingabe-Feature-Layer verbunden werden soll. TRANSACTIONAL —Stellt eine Verbindung mit einem definierten Zustand der Datenbank her (traditionelle Version). HISTORICAL —Stellt eine Verbindung mit einer Version her, die einen definierten Zeitpunkt darstellt, der häufig durch einen Zeit- oder historischen Marker festgelegt wird. BRANCH —Stellt eine Verbindung mit einer Verzweigungsversion her.	String
version_name (optional)	Der Name der Version, mit der der Eingabe-Feature-Layer verbunden werden soll. Dieser Parameter ist optional, wenn Sie eine historische Version verwenden.	String
date (optional)	Das Datum der historischen Version, mit der der Eingabe-Feature-Layer verbunden werden soll.	Date

Abgeleitete Ausgabe

Name	Erklärung	Datentyp
out_feature_layer	Das aktualisierte Eingabe-Dataset.	Feature-Layer

Codebeispiel

ChangeVersion – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ChangeVersion im unmittelbaren Modus verwendet wird.

import arcpy
from arcpy import env
env.workspace = r'c:\Connections\toolbox.sde'
arcpy.MakeFeatureLayer_management(r'TOOLBOX.Redlands\TOOLBOX.street','RedlandsStreets')
arcpy.MakeFeatureLayer_management(r'TOOLBOX.Redlands\TOOLBOX.streams','RedlandsStreams')
arcpy.MakeFeatureLayer_management(arcpy.SelectLayerByLocation_management("RedlandsStreams","WITHIN_A_DISTANCE","RedlandsStreets","100 Meters","NEW_SELECTION",'#'),
                                  'StreamsNearStreets','','','')
arcpy.ChangeVersion_management('RedlandsStreets','TRANSACTIONAL', 'TOOLBOX.proposedStreets2k9','')
arcpy.MakeFeatureLayer_management(arcpy.SelectLayerByLocation_management("RedlandsStreams","WITHIN_A_DISTANCE","RedlandsStreets","100 Meters","NEW_SELECTION",'#'),
                                  'NewStreamsNearStreets','','','')

ChangeVersion – Beispiel 2 (eigenständiges Skript)

Verwenden Sie die Funktion ChangeVersion in einem versionierten Standard-Analyse-Workflow.

# Name: ChangeVersion.py
# Description: Use the ChangeVersion tool in a typical versioned analysis workflow.
#              Quick check of additional streams within a pre-determined distance
#              of new proposed street development.

# Import system modules 
import arcpy
import sys
import os

# Set environments
arcpy.env.workspace = sys.path[0] + os.sep + "toolbox.sde"

# Create the layers
arcpy.MakeFeatureLayer_management(r'TOOLBOX.Redlands\TOOLBOX.street','RedlandsStreets')
arcpy.MakeFeatureLayer_management(r'TOOLBOX.Redlands\TOOLBOX.streams','RedlandsStreams')

# Perform analysis on the Default version to determine
# current number of streams within 100 meters of streets.
selection1 = arcpy.SelectLayerByLocation_management("RedlandsStreams",
                                                    "WITHIN_A_DISTANCE",
                                                    "RedlandsStreets",
                                                    "100 Meters",
                                                    "NEW_SELECTION",
                                                    '#')
arcpy.MakeFeatureLayer_management(selection1,'StreamsNearStreets','','','')
print("Streams within 100 Meters of current streets: {}".format(
    arcpy.GetCount_management("StreamsNearStreets")[0]))

# Change to the development version
arcpy.ChangeVersion_management('RedlandsStreets',
                               'TRANSACTIONAL',
                               'TOOLBOX.proposedStreets2k9',
                               '')

# Perform the same analysis on the development version to see the effect of the proposed changes.
selection2 = arcpy.SelectLayerByLocation_management("RedlandsStreams",
                                                   "WITHIN_A_DISTANCE",
                                                   "RedlandsStreets",
                                                   "100 Meters",
                                                   "NEW_SELECTION",
                                                   '#')
arcpy.MakeFeatureLayer_management(selection2,'NewStreamsNearStreets','','','')
print("Streams projected to be within 100 Meters of streets after proposed street additions: {}".format(
    arcpy.GetCount_management("NewStreamsNearStreets")[0]))

ChangeVersion – Beispiel 3 (eigenständiges Skript)

Verwenden Sie die Funktion ChangeVersion, um einen Feature-Service-Layer in eine benannte Verzweigungsversion zu ändern.

# Name: ChangeVersionBranchVersioning.py
# Description: Use the ChangeVersion tool to change the branch version of a feature service
#              layer that has the version management capability enabled.

# Import system modules 
import arcpy

# Sign into ArcGIS Enterprise
arcpy.SignInToPortal("https://myserver.mydomain.com/portal", 'portaladmin', 'my.password')

# Create a variable for the feature service URL
myFS = "https://myserver.mydomain.com/server/rest/services/BranchVersioningData/FeatureServer/0"

# Create the layers
arcpy.MakeFeatureLayer_management(myFS, 'myFSLayer')

# Change to a branch version named myVersion
arcpy.ChangeVersion_management('myFSLayer', "BRANCH", "portaladmin.myVersion")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Nein
• Standard: Ja
• Advanced: Ja