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

BeschriftungErläuterungDatentyp
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 VersionStellt eine Verbindung mit einem definierten Zustand der Datenbank her (traditionelle Version).
  • Historische VersionStellt eine Verbindung mit einer Version her, die einen definierten Zeitpunkt darstellt, der häufig durch einen Zeit- oder historischen Marker festgelegt wird.
  • VerzweigungsversionStellt 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

BeschriftungErläuterungDatentyp
Ausgabe-Layer

Das aktualisierte Eingabe-Dataset.

Feature Layer

arcpy.management.ChangeVersion(in_features, version_type, {version_name}, {date}, {include_participating})
NameErläuterungDatentyp
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.

  • TRANSACTIONALStellt eine Verbindung mit einem definierten Zustand der Datenbank her (traditionelle Version).
  • HISTORICALStellt eine Verbindung mit einer Version her, die einen definierten Zeitpunkt darstellt, der häufig durch einen Zeit- oder historischen Marker festgelegt wird.
  • BRANCHStellt 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.

  • INCLUDEDie Version der beteiligten Feature-Classes des Controller-Datasets ändert sich, wenn diese aus demselben Workspace stammen wie das Controller-Dataset.
  • EXCLUDENur die Version des Controller-Datasets ändert sich.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
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.management.MakeFeatureLayer(myFS, 'myFSLayer')

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen