Version ändern (Data Management)

Zusammenfassung

Ändert den Workspace eines 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 Workspace des Eingabe-Feature-Layers, der Tabellensicht, des Topologie-Layers, des Flurstück-Layers, des Versorgungsnetz-Layers oder des Verfolgungsnetzwerk-Layers geändert, um eine Verbindung mit der angegebenen Version herzustellen.

• Transaktions- und historische Sichten werden unterstützt.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Der/die mit der angegebenen Version zu verbindende Layer/Tabellensicht. Hinweis: Die Sublayer eines Topologie-Layers, Flurstück-Layers, Versorgungsnetz-Layers oder Verfolgungsnetzwerk-Layers sind keine gültigen Eingaben.	Feature Layer; Table View; Topology Layer; Parcel Layer; Utility Network Layer; Trace Network Layer
Versionstyp	Gibt den Typ der Version an, mit der der Eingabe-Feature-Layer verbunden werden soll. Traditionelle Version—Stellt eine Verbindung mit einem definierten Zustand der Datenbank her (traditionelle Version). Historische Version—Stellt eine Verbindung mit einer Version her, die einen definierten Zeitpunkt darstellt, der häufig durch einen Zeit- oder historischen Marker festgelegt wird. Verzweigungsversion—Stellt eine Verbindung mit einer Verzweigungsversion her.	String
Versionsname (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
Datum und Uhrzeit (optional)	Das Datum der historischen Version, mit der der Eingabe-Feature-Layer verbunden werden soll.	Date
Beteiligte Feature-Classes des Controller-Datasets einbeziehen (optional)	Gibt an, ob sich auch der Workspace beteiligter Feature-Classes ändert. Der Parameter kann nur verwendet werden, wenn der Eingabe-Layer ein Topologie-Layer, Flurstück-Layer, Versorgungsnetz-Layer oder Verfolgungsnetzwerk-Layer ist. Aktiviert: Die Version der beteiligten Feature-Classes des Controller-Datasets ändert sich, wenn diese aus demselben Workspace stammen wie das Controller-Dataset. Dies ist die Standardeinstellung. Deaktiviert: Nur die Version des Controller-Datasets ändert sich.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Layer	Das aktualisierte Eingabe-Dataset.	Feature Layer

Python

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

Name	Erläuterung	Datentyp
in_features	Der/die mit der angegebenen Version zu verbindende Layer/Tabellensicht. Hinweis: Die Sublayer eines Topologie-Layers, Flurstück-Layers, Versorgungsnetz-Layers oder Verfolgungsnetzwerk-Layers sind keine gültigen Eingaben.	Feature Layer; Table View; Topology Layer; Parcel Layer; Utility Network Layer; Trace Network Layer
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
include_participating (optional)	Gibt an, ob sich auch der Workspace beteiligter Feature-Classes ändert. Der Parameter kann nur verwendet werden, wenn der Eingabe-Layer ein Topologie-Layer, Flurstück-Layer, Versorgungsnetz-Layer oder Verfolgungsnetzwerk-Layer ist. INCLUDE—Die Version der beteiligten Feature-Classes des Controller-Datasets ändert sich, wenn diese aus demselben Workspace stammen wie das Controller-Dataset. EXCLUDE—Nur die Version des Controller-Datasets ändert sich.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	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