updateFeatures

Beschreibung

Aktualisiert Features in einer Tabelle, indem eine Feature-Sammlung mit einem optionalen Übergabeintervall weitergeleitet wird. Jedes Feature in der Sammlung muss über eine ID (Primärschlüssel) verfügen, die für einen Vergleich des Eingabe-Features mit dem Feature in der Tabelle verwendet wird. Die Antwort enthält die Anzahl der Features, die erfolgreich aktualisiert wurden. Nach einen typischen Workflow werden die Feature-Sammlung unter Verwendung eines listFeatures- oder Suchvorgangs generiert, die Feature-Sammlung geändert und dann die geänderte Feature-Sammlung an den updateFeatures-Vorgang weitergeleitet.

Anmerkung: Sie müssen über Berechtigungen zum Anzeigen für die benannte Tabelle verfügen und über Berechtigungen zum Erstellen/Ändern/Löschen für das zur benannten Tabelle gehörende Dataset, um Einfügungs-, Aktualisierungs- und Löschvorgänge für beschreibbare Tabellen durchführen zu können. Weitere Informationen finden Sie unter Zugriffssteuerung für Datasets im Abschnitt „Verwaltung“.

Der Standardwert für das Übergabeintervall ist 50. Daher werden die ersten 50 Aktualisierungen innerhalb einer Transaktion übergeben. Wenn der Wert kleiner als 1 ist, wird der Standardwert von 50 verwendet. Es wird nicht empfohlen, diesen Wert auf 1 festzulegen, da dann eine Transaktion für eine Aktualisierung verwendet wird.

Anmerkung: Dieser Vorgang wird für PostGIS, Oracle, SQL Server, SAP HANA, GeoPackage und generisches JDBC als Datenprovider unterstützt. Es wird auch bei MapInfo Native TAB- und Native Extended TAB-Dateien (NativeX) in Windows-Betriebssystemen unterstützt. (Das Übergabeintervall wird ignoriert.) Die Tabellen müssen über einen Primärschlüssel verfügen. Andernfalls werden sie als schreibgeschützt betrachtet. Benannte Tabellen mit zusammengesetzten Primärschlüsseln sind nicht beschreibbar.

ACL-Autorisierungsfluss

Um Features in einer benannten Tabelle zu aktualisieren, indem eine Feature-Sammlung mit einem optionalen Festschreibungsintervall übergeben wird, muss der Benutzer (oder alle Rollen, zu denen er gehört) wie folgt Ausführungs- und Änderungsberechtigungen für die benannte Tabelle haben:

„EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“
bzw. „MODIFY“ für den Entitätstyp „Location Intelligence.Dataset.DML“

Nachrichten

In der folgenden Tabelle sind die Anforderungs- und Antwortnachrichten für den Vorgang updateFeatures aufgelistet.

Klicken Sie auf einen Nachrichtennamen, um mehr Informationen zu dieser Nachricht zu erhalten.

Nachricht	Beschreibung
UpdateFeaturesRequest	Die Anforderungsnachricht für den Vorgang updateFeatures.
UpdateFeaturesResponse	Die Antwortnachricht für den Vorgang updateFeatures.

Beispiel

Beispiel für das Aktualisieren von Features in einer Tabelle. AttributeDefinitionList definiert die Spalten der Tabelle, und FeatureList definiert die zu aktualisierenden Werte:


						
<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://www.mapinfo.com/midev/service/feature/v1" xmlns:ns3="http://www.mapinfo.com/midev/service/featurecollection/v1" xmlns:ns4=http://www.mapinfo.com/midev/service/geometries/v1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<S:Header/>
	<S:Body>
		<UpdateFeaturesRequest table="/MyTable" commitInterval="1">
			<ns3:FeatureCollection>
				<ns3:FeatureCollectionMetadata>
					<ns3:AttributeDefinitionList>
						<ns3:AttributeDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:ScalarAttributeDefinition" dataType="Double" name="Column1"/>
						<ns3:AttributeDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:GeometryAttributeDefinition" srsName="epsg:4267" dataType="Geometry" name="SP_GEOMETRY"/>
					</ns3:AttributeDefinitionList>
				</ns3:FeatureCollectionMetadata>
				<ns3:FeatureList>
					<ns3:Feature id="1">
						<ns3:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:DoubleValue">
							<ns3:Value>123.456</ns3:Value>
						</ns3:AttributeValue>
						<ns3:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:GeometryValue">
							<ns4:FeatureGeometry xsi:type="ns4:Point" srsName="epsg:4326">
								<ns4:Pos>
									<ns4:X>-72</ns4:X>
									<ns4:Y>42</ns4:Y>
								</ns4:Pos>
							</ns4:FeatureGeometry>
						</ns3:AttributeValue>
					</ns3:Feature>
				</ns3:FeatureList>
			</ns3:FeatureCollection>
		</UpdateFeaturesRequest>
	</S:Body>
	</S:Header>
</S:Envelope>