In this chapter, several configuration examples are presented. In addition to the delivered configuration, these minimal configuration examples are intended to provide a simple introduction to creating your own first configuration.
The Studio Desktop implementation supports the following operation types:
•Select: The target object is selected in the target APRX project
•SelectAndZoom: In the target APRX project, the selected object is additionally zoomed in on.
•AttributeEditAndZoomAndSelect: In the target APRX project, the selected object is additionally being edited based on the <TargetField> marked for edit (Edit="true").
•CreateObject: Object geometries are recreated in the target project. The geometry of the objects is transferred from the source project to the target.
Select and Zoom Operation
The well known ApplicationID of the Studio Desktop implementation is VgsProDesktop. The <Path> property needs to point to the ArcGISPro.exe within the installation folder. The <Project> property needs to point to a accessible .aprx project. The project file paths needs to be unique within the configuration in order to function properly. The Studio Desktop implementation allows x <TargetField> definition per table. The different target fields and their values will be used to create a search query for the given table. The selection is passed on based on the result of the search query. The name attribute of the <Table> property relates to the map member (layer/standaloneTable) name within a given map (.mapx).
Example Operation Configuration for Select and Zoom Operation
<Operation Run="Select" Name="Send Selection to TestClient">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WorkOrdersPlaceHolder$"/>
</TargetFields>
</Table>
<Table Name="Wells">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WellsPlaceHolder$"/>
</TargetFields>
</Table>
</Tables>
</Operation>
<Operation Run="SelectAndZoom" Name="Send Selection to TestClient and zoom to it">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WorkOrdersPlaceHolder$"/>
</TargetFields>
</Table>
<Table Name="Wells">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WellsPlaceHolder$"/>
</TargetFields>
</Table>
</Tables>
</Operation>
Example Source Configuration for Select and Zoom Operation
<SourceConfiguration>
<TargetInstances>
<TargetInstance Name="VgsProDesktop2 Ziel"></TargetInstance>
</TargetInstances>
<Tables>
<Table Name="Work Orders">
<Fields>
<Field SourceFieldName="OBJECTID" Placeholder="$WorkOrdersPlaceHolder$"/>
</Fields>
</Table>
<Table Name="Wells">
<Fields>
<Field SourceFieldName="OBJECTID" Placeholder="$WellsPlaceHolder$"/>
</Fields>
</Table>
</Tables>
</SourceConfiguration>
Edit Operation
The AttributeEditAndZoomAndSelect operation basically supports all field types including the geometry types known by the ArcGIS.Core.Geometry namespace. The target fields marked for the edit operation are fetched for each feature found based on the constructed where clause (all target fields not marked for edit). Each field and row that is edited may or may not trigger subsequent event chains.
Example Operation Configuration for Edit Operation
<Operation Run="AttributeEditAndZoomAndSelect" Name="Select and Zoom Work Orders and edit some fields">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WorkOrdersPlaceHolder$"/>
<TargetField TargetFieldName="REQUESTID" Values="$WorkOrdersRequestIdPlaceHolder$" Edit="true" />
<TargetField TargetFieldName="DESCRIPTION" Values="$WorkOrdersDescriptionPlaceHolder$" Edit="true" />
<TargetField TargetFieldName="Shape" Values="$WorkOrdersGeometryPlaceHolder$" Edit="true" />
</TargetFields>
</Table>
</Tables>
</Operation>
Example Source Configuration for Edit Operation
<SourceConfiguration>
<TargetInstances>
<TargetInstance Name="VgsProDesktop2 Ziel"></TargetInstance>
</TargetInstances>
<Tables>
<Table Name="Work Orders">
<Fields>
<Field SourceFieldName="OBJECTID" Placeholder="$WorkOrdersPlaceHolder$"/>
<Field SourceFieldName="REQUESTID" Placeholder="$WorkOrdersRequestIdPlaceHolder$" />
<Field SourceFieldName="DESCRIPTION" Placeholder="$WorkOrdersDescriptionPlaceHolder$" />
<Field SourceFieldName="Shape" Placeholder="$WorkOrdersGeometryPlaceHolder$" />
</Fields>
</Table>
</Tables>
</SourceConfiguration>
Create Operation
The CreateObject operation creates a new row for the given <Table> in the target project. All <TargetField> definitions are prefilled in the row buffer and should be present in the created row. The operation basically supports all field types including the geometry types known by the ArcGIS.Core.Geometry namespace. If the operation runs into issue, such as the target field does not exist or a single row could not be created, it will try to continue the process. The <TargetField> definition should include a geometry field in order to properly create the object in the target table.
The object geometry will be passed to the target client as a JSON string created by the ArcGIS.Core.Geometry.ToJSON() method including the specified spatial reference. The same is expected when receiving such geometries when acting as the target application.
Example Operation Configuration for Create Operation
<Operation Run="CreateObject" Name="Create the selected Work Orders">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="REQUESTID" Values="$WorkOrdersRequestIdPlaceHolder$" />
<TargetField TargetFieldName="DESCRIPTION" Values="$WorkOrdersDescriptionPlaceHolder$" />
<TargetField TargetFieldName="Shape" Values="$WorkOrdersGeometryPlaceHolder$" />
</TargetFields>
</Table>
</Tables>
</Operation>
Example Source Configuration for Create Operation
<SourceConfiguration>
<TargetInstances>
<TargetInstance Name="VgsProDesktop2 Ziel"></TargetInstance>
</TargetInstances>
<Tables>
<Table Name="Work Orders">
<Fields>
<Field SourceFieldName="REQUESTID" Placeholder="$WorkOrdersRequestIdPlaceHolder$" />
<Field SourceFieldName="DESCRIPTION" Placeholder="$WorkOrdersDescriptionPlaceHolder$" />
<Field SourceFieldName="Shape" Placeholder="$WorkOrdersGeometryPlaceHolder$" />
</Fields>
</Table>
</Tables>
</SourceConfiguration>
Send XY to Integrator
The geocoding tool Send XY to Integrator allows you to specify the XY coordinates of a click point within a specific object of the integration. The aim is to write these source coordinates to defined attributes of the corresponding target object in the target project. The XY coordinates are read from the source in the coordinate system of the data frame. They are written to the target table unchanged. There is no reprojection of the coordinate values. Therefore, when using this tool, care should be taken to ensure that the source and target coordinate systems are identical. Usually, exactly one object is passed, and in any case exactly one coordinate pair (X,Y).
The captured XY coordinates can be written to a field in the target object using the hard coded placeholder values $CoordinateX$ and $CoordinateY$. The placeholder values must not occur in the SourceConfiguration of the table because they originate from the clicked point in the map. The target field names CoordinateX and CoordinateY are wellknown names. If given, the message receiver tries to insert these coordinates as a map point geometry for the target object (e.g. for the Shape field). The Send XY to Integrator tool does not rely on a initial selection. The source object is identified based on the given source configuration and the map point click made with the geocoding tool.
Example Operation Configuration Send XY to Integrator
<Operation Run="AttributeEditAndZoomAndSelect" Name="Select and Zoom Work Orders and use XY for shape field">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WorkOrdersPlaceHolder$" />
<TargetField TargetFieldName="CoordinateX" Values="$CoordinateX$" Edit="true"/>
<TargetField TargetFieldName="CoordinateY" Values="$CoordinateY$" Edit="true"/>
<TargetField TargetFieldName="OtherFieldForX" Values="$CoordinateX$" Edit="true"/>
<TargetField TargetFieldName="OtherFieldForY" Values="$CoordinateY$" Edit="true"/>
</TargetFields>
</Table>
</Tables>
</Operation>
<Operation Run="CreateObject" Name="Create Work Orders and use XY as shape">
<Tables>
<Table Name="Work Orders">
<TargetFields>
<TargetField TargetFieldName="OBJECTID" Values="$WorkOrdersPlaceHolder$" />
<TargetField TargetFieldName="CoordinateX" Values="$CoordinateX$" />
<TargetField TargetFieldName="CoordinateY" Values="$CoordinateY$" />
</TargetFields>
</Table>
</Tables>
</Operation>
Example Source Configuration Send XY to Integrator
<SourceConfiguration>
<TargetInstances>
<TargetInstance Name="VgsProDesktop2 Ziel"></TargetInstance>
</TargetInstances>
<Tables>
<Table Name="Work Orders">
<Fields>
<Field SourceFieldName="OBJECTID" Placeholder="$WorkOrdersPlaceHolder$"/>
</Fields>
</Table>
</Tables>
</SourceConfiguration>
The official (GeoOffice) Integrator 2021 documentation contains a detailed explanation showing the difference between the Send to Integrator and Send XY to Integrator functionality.
https://resources.geooffice.vertigis.com/documentation/DE/Integrator_2021/index.html?unterschied.htm
Example GeoOffice Analyst to GeoOffice Analyst: CreateObject
<Applications>
<Application ID="GeoOfficeAnalyst">
<Path>C:\Program Files (x86)\ArcGIS\Desktop10.8\bin\ArcMap.exe</Path>
<Instances>
<Instance Name="GeoOffice analyst Source Project">
<Project>C:\data\Graz\SampleProjectSource.mxd</Project>
</Instance>
<Instance Name="GeoOffice analyst Target Project">
<Project>C:\data\Graz\SampleProjectTarget.mxd</Project>
<TargetDefinition StartBehaviour="IfNecessary" BringTargetToForeGround="true" StartTimeout="120">
<Operations>
<Operation Run="CreateObject" Name="CreateObject - Points">
<Tables>
<Table Name="Emergency">
<TargetFields>
<TargetField TargetFieldName="$GmlGeometry$" Values="$GmlGeometryPlaceholder$" />
<TargetField TargetFieldName="E_NAME" Values="$name$" />
</TargetFields>
</Table>
</Tables>
</Operation>
</Operations>
</TargetDefinition>
</Instance>
</Instances>
</Application>
</Applications>
<Sources>
<Source>
<SourceInstances>
<SourceInstance Name="GeoOffice analyst Source Project"></SourceInstance>
</SourceInstances>
<SourceConfigurations>
<SourceConfiguration>
<TargetInstances>
<TargetInstance Name="GeoOffice analyst Target Project"></TargetInstance>
</TargetInstances>
<Tables>
<Table Name="Emergency">
<Fields>
<Field SourceFieldName="$GmlGeometry$" Placeholder="$GmlGeometryPlaceholder$" />
<Field SourceFieldName="E_NAME" Placeholder="$name$" />
</Fields>
</Table>
</Tables>
</SourceConfiguration>
</SourceConfigurations>
</Source>
</Sources>
