Description
data is an array of operations (each of type 19) that defines how source data is pulled into the job's extraction database before any cartographic processing runs. Each operation describes a single input (a workspace, product file, feature service, map service, or raster service), the AOI used to filter it, and any buffering, format, or dataset-inclusion controls.
How it is used
When a job runs, the Topographic Production Service executes each data operation in order. Map-service and feature-service inputs produce feature classes inside extraction (typically under the product's feature), while raster inputs are written as raster datasets or files. The extracted data is then referenced by operations through the [ resource (for example, [) or directly by file path.
Expected values
Each data entry is a JSON object with the following syntax:
{
"name": "<name the operation>",
"type": 19,
"id": "<GUID or unique string>",
"description": "",
"featureDataset": "<optional name of the feature dataset to which the data is extracted>",
"disabled": <true | false>,
"parameters": [
{
"name": "input_data",
"value": "<file path to workspace connection | product file | feature service URL |
map service URL | raster service URL>"
},
{
"name": "AOI",
"value": "<the string representation of an extent (space delimited) | JSON geometry | None>"
},
{
"name": "spatial_relationship",
"value": "<...>"
},
{
"name": "buffer",
"value": "<the buffer value and unit of measurement>"
},
{
"name": "fileName",
"value": "<the name of the raster file that gets extracted>"
},
{
"name": "fileExtension",
"value": "<the extension for the raster format that the final output should be in>"
},
{
"name": "definitionQuery",
"value": "<a valid Where clause for all of the tables in the input_data parameter value>"
},
{
"name": "includeDatasets",
"value": "<a comma-delimited list of datasets to extract>"
},
{
"name": "excludeDatasets",
"value": "<a comma-delimited list of datasets to exclude from extraction>"
}
]
}Behavior and relationships
The default extraction operations interact with the rest of the product definition:
defaultwrites feature data intoMap Extraction extraction/Database feature. DownstreamDataset operationsreference the result through[.Source Workspace] defaultwrites a raster (when one is configured) and is referenced by elevation- and contour-related operations.Raster Extraction - The
AOIparameter typically resolves to[, tying extraction to the AOI feature identified byAOI Layer]\\ Extent sheet.ID Field - Setting
disabledtotruelets a product version skip extraction (for example, an SDE-connected editing version that works directly against the enterprise geodatabase).
User considerations
- Use
buffercarefully: a too-small buffer can clip features that influence cartography at the sheet edge, while an oversized buffer increases extraction time. Installed product definitions commonly use values such as2 kilometersfor vector data and1.5 kilometersfor raster. - Prefer
definitionto pre-filter large source tables rather than relying on AOI alone.Query - When extracting from a map service or feature service, ensure the service account used by the SOE has read access to all required layers.
- When extracting rasters, set
fileexplicitly if the default (Extension .imgfor DEMs and image services, or the source format for.dt2/.tifinputs) does not match the downstream tooling.
Example
The following dataExtraction operation example extracts a raster:
{
"name": "RasterDataset",
"type": 19,
"id": "RasterDataset",
"description": "Raster Dataset Extract",
"disabled": "false",
"parameters": [
{
"name": "input_data",
"value": "[ProductFiles]\\Elevation.gdb\\DEM"
}
{
"name": "AOI",
"value": "[AOILayer]\\Extent"
}
{
"name": "buffer",
"value": "2 kilometers"
}
{
"name": "fileName",
"value": "MyRaster"
},
{
"name": "fileExtension",
"value": ".tif"
},
{
"name": "spatial_relationship",
"value": "esriSpatialRelIntersects"
}
{
"name": "DefinitionQuery",
"value": ""
}
{
"name": "includeDatasets",
"value": ""
}
{
"name": "excludeDatasets",
"value": ""
}
]
}{
"name": "RasterDataset",
"type": 19,
"id": "RasterDataset",
"description": "Raster Dataset Extract",
"disabled": "false",
"parameters": [
{
"name": "input_data",
"value": "[ProductFiles]\\Elevation.gdb\\DEM"
}
{
"name": "AOI",
"value": "[AOILayer]\\Extent"
}
{
"name": "buffer",
"value": "2 kilometers"
}
{
"name": "fileName",
"value": "MyRaster"
},
{
"name": "fileExtension",
"value": ".tif"
},
{
"name": "spatial_relationship",
"value": "esriSpatialRelIntersects"
}
{
"name": "DefinitionQuery",
"value": ""
}
{
"name": "includeDatasets",
"value": ""
}
{
"name": "excludeDatasets",
"value": ""
}
]
}