com.esri.arcgis.geoprocessing.tools.servertools
Class ExtractDataAndEmailTask
java.lang.Object
com.esri.arcgis.geoprocessing.AbstractGPTool
com.esri.arcgis.geoprocessing.tools.servertools.ExtractDataAndEmailTask
- All Implemented Interfaces:
- GPTool
public class ExtractDataAndEmailTask
- extends AbstractGPTool
Extracts the data in the specified layers and area of interest to the selected format and spatial reference, zips the data and emails it to the specified address. This tool can be used to create a Data Extraction geoprocessing service.
The Extract Data and Email Task tool is contained in the Server Tools tool box.
Usage tips:
- This tool will not function correctly unless it is edited and the email server is configured. To configure the email server settings do the following:The above illustration shows the model after the unexposed input parameters are edited. Copy the original model from the Server Tools toolbox to your own custom toolbox before making any changes.
- The dropdown for the Feature and Raster Format parameters contain lists of default formats. These default formats are set from the Value List filter on the Parameters tab of the Model Properties.
- You can add, modify or remove the list of formats for either the Feature Format parameter or the Raster Format parameter:Copy this model to your own custom toolbox before making any changes.
- Internally, the tool uses the tool to convert data to the .dgn, .dwg and .dxf CAD formats. Each of these formats is in the default list and exports to the latest version of that file type. To change the version, edit the "Short Name" in the values list. For example, to use DXF R2005 rather than DXF R2007, change the Short Name to DXF_R2005, like this:
- Change the string from Autodesk AutoCAD - DXF_R2007 - .dxf to Autodesk AutoCAD - DXF_R2005 - .dxf
The list of short names can be found in the tool.
- For all non-ESRI, non-CAD formats, this model tool calls the tool. It is critical to make sure that both the Short Name and the Extension in the Feature Format parameter are specified correctly so that Quick Export will work as expected. You can find the short name and the extension required by Quick Export for your format in the Format Gallery of the Quick Export tool.Because Quick Export is a part of the Data Interoperability Extension, non-ESRI, non-CAD formats will only work if the Data Interoperability Extension is available.
- By default, all supported raster formats are in the drop down list of raster formats.There are limitations to some of the formats such that the software will not be able to convert to the format specified. For more details on the limitations of the various raster formats please read .
Constructor Summary |
ExtractDataAndEmailTask()
Creates the Extract Data and Email Task tool with defaults. |
ExtractDataAndEmailTask(java.lang.Object layersToClip,
java.lang.Object areaOfInterest,
java.lang.String featureFormat,
java.lang.String rasterFormat,
java.lang.String to)
Creates the Extract Data and Email Task tool with the required parameters. |
Method Summary |
java.lang.Object |
getAreaOfInterest()
Returns the Area of Interest parameter of this tool . |
java.lang.String |
getFeatureFormat()
Returns the Feature Format parameter of this tool . |
java.lang.Object |
getLayersToClip()
Returns the Layers to Clip parameter of this tool . |
java.lang.String |
getRasterFormat()
Returns the Raster Format parameter of this tool . |
java.lang.String |
getSent()
Returns the Sent parameter of this tool (Read only). |
java.lang.String |
getTo()
Returns the To parameter of this tool . |
java.lang.String |
getToolboxAlias()
Returns the alias of the tool box containing this tool. |
java.lang.String |
getToolboxName()
Returns the name of the tool box containing this tool. |
java.lang.String |
getToolName()
Returns the name of this tool. |
void |
setAreaOfInterest(java.lang.Object areaOfInterest)
Sets the Area of Interest parameter of this tool . |
void |
setFeatureFormat(java.lang.String featureFormat)
Sets the Feature Format parameter of this tool . |
void |
setLayersToClip(java.lang.Object layersToClip)
Sets the Layers to Clip parameter of this tool . |
void |
setRasterFormat(java.lang.String rasterFormat)
Sets the Raster Format parameter of this tool . |
void |
setTo(java.lang.String to)
Sets the To parameter of this tool . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
ExtractDataAndEmailTask
public ExtractDataAndEmailTask()
- Creates the Extract Data and Email Task tool with defaults.
Initializes the array of tool parameters with the default values specified when the tool was created.
ExtractDataAndEmailTask
public ExtractDataAndEmailTask(java.lang.Object layersToClip,
java.lang.Object areaOfInterest,
java.lang.String featureFormat,
java.lang.String rasterFormat,
java.lang.String to)
- Creates the Extract Data and Email Task tool with the required parameters.
Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.
- Parameters:
layersToClip
- the Layers to be clipped. Layers should be either feature or raster layers.areaOfInterest
- the area by which the layers will be clipped.featureFormat
- the format in which the output features will be delivered. The string provided in the Feature Format parameter should be formatted as follows: for Example: internally, this tool uses the Export to CAD tool to convert data to the .dgn, .dwg and .dxf CAD formats. The list of short names supported includes: DGN_V8, DWG_R14, DWG_R2000, DWG_R2004, DWG_R2005, DWG_R2006,
DWG_R2007, DWG_R2010, DXF_R14, DXF_R2000, DXF_R2004, DXF_R2005,
DXF_R2006, DXF_R2007, and DXF_R2010. for all non-ESRI, non-CAD formats, this tool also supports formats used by the Quick Export tool. since the Quick Export tool is a part of the Data Interoperability Extension, non-ESRI, non-CAD formats will only work if the Data Interoperability Extension is available.- File Geodatabase - GDB - .gdb
- Shapefile - SHP - .shp
- Personal Geodatabase - MDB - .mdb
- Geographic Markup Language - GML - .gml
- OpenGIS KML Encoding Standard - OGCKML - .kmz
- Autodesk AutoCAD - DXF_R2007 - .dxf
- Autodesk AutoCAD - DWG_R2007 - .dwg
- Bentley Microstation Design (V8) - DGN_V8 - .dgn
rasterFormat
- the format in which the output raster data sets will be delivered. The string provided in the Raster Format parameter should be formatted as follows: any of the following strings will work:- ESRI GRID - GRID
- File Geodatabase - GDB - .gdb
- ERDAS IMAGINE - IMG - .img
- Tagged Image File Format - TIFF - .tif
- Portable Network Graphics - PNG - .png
- Graphic Interchange Format - GIF - .gif
- Joint Photographics Experts Group - JPEG - .jpg
- Joint Photographics Experts Group - JPEG - .jp2
- Bitmap - BMP - .bmp
- Portable Network Graphics - PNG - .png
to
- the email address of the recipient. this tool will be able to email to this address if and only if the SMTP server has been configured within this model.
getLayersToClip
public java.lang.Object getLayersToClip()
- Returns the Layers to Clip parameter of this tool .
This parameter is the Layers to be clipped. Layers should be either feature or raster layers.
This is a required parameter.
- Returns:
- the Layers to Clip
setLayersToClip
public void setLayersToClip(java.lang.Object layersToClip)
- Sets the Layers to Clip parameter of this tool .
This parameter is the Layers to be clipped. Layers should be either feature or raster layers.
This is a required parameter.
- Parameters:
layersToClip
- the Layers to be clipped. Layers should be either feature or raster layers.
getAreaOfInterest
public java.lang.Object getAreaOfInterest()
- Returns the Area of Interest parameter of this tool .
This parameter is the area by which the layers will be clipped.
This is a required parameter.
- Returns:
- the Area of Interest
setAreaOfInterest
public void setAreaOfInterest(java.lang.Object areaOfInterest)
- Sets the Area of Interest parameter of this tool .
This parameter is the area by which the layers will be clipped.
This is a required parameter.
- Parameters:
areaOfInterest
- the area by which the layers will be clipped.
getFeatureFormat
public java.lang.String getFeatureFormat()
- Returns the Feature Format parameter of this tool .
This parameter is the format in which the output features will be delivered. The string provided in the Feature Format parameter should be formatted as follows: for Example: internally, this tool uses the Export to CAD tool to convert data to the .dgn, .dwg and .dxf CAD formats. The list of short names supported includes: DGN_V8, DWG_R14, DWG_R2000, DWG_R2004, DWG_R2005, DWG_R2006,
DWG_R2007, DWG_R2010, DXF_R14, DXF_R2000, DXF_R2004, DXF_R2005,
DXF_R2006, DXF_R2007, and DXF_R2010. for all non-ESRI, non-CAD formats, this tool also supports formats used by the Quick Export tool. since the Quick Export tool is a part of the Data Interoperability Extension, non-ESRI, non-CAD formats will only work if the Data Interoperability Extension is available.
This is a required parameter.
- Returns:
- the Feature Format
setFeatureFormat
public void setFeatureFormat(java.lang.String featureFormat)
- Sets the Feature Format parameter of this tool .
This parameter is the format in which the output features will be delivered. The string provided in the Feature Format parameter should be formatted as follows: for Example: internally, this tool uses the Export to CAD tool to convert data to the .dgn, .dwg and .dxf CAD formats. The list of short names supported includes: DGN_V8, DWG_R14, DWG_R2000, DWG_R2004, DWG_R2005, DWG_R2006,
DWG_R2007, DWG_R2010, DXF_R14, DXF_R2000, DXF_R2004, DXF_R2005,
DXF_R2006, DXF_R2007, and DXF_R2010. for all non-ESRI, non-CAD formats, this tool also supports formats used by the Quick Export tool. since the Quick Export tool is a part of the Data Interoperability Extension, non-ESRI, non-CAD formats will only work if the Data Interoperability Extension is available.
This is a required parameter.
- Parameters:
featureFormat
- the format in which the output features will be delivered. The string provided in the Feature Format parameter should be formatted as follows: for Example: internally, this tool uses the Export to CAD tool to convert data to the .dgn, .dwg and .dxf CAD formats. The list of short names supported includes: DGN_V8, DWG_R14, DWG_R2000, DWG_R2004, DWG_R2005, DWG_R2006,
DWG_R2007, DWG_R2010, DXF_R14, DXF_R2000, DXF_R2004, DXF_R2005,
DXF_R2006, DXF_R2007, and DXF_R2010. for all non-ESRI, non-CAD formats, this tool also supports formats used by the Quick Export tool. since the Quick Export tool is a part of the Data Interoperability Extension, non-ESRI, non-CAD formats will only work if the Data Interoperability Extension is available.- File Geodatabase - GDB - .gdb
- Shapefile - SHP - .shp
- Personal Geodatabase - MDB - .mdb
- Geographic Markup Language - GML - .gml
- OpenGIS KML Encoding Standard - OGCKML - .kmz
- Autodesk AutoCAD - DXF_R2007 - .dxf
- Autodesk AutoCAD - DWG_R2007 - .dwg
- Bentley Microstation Design (V8) - DGN_V8 - .dgn
getRasterFormat
public java.lang.String getRasterFormat()
- Returns the Raster Format parameter of this tool .
This parameter is the format in which the output raster data sets will be delivered. The string provided in the Raster Format parameter should be formatted as follows: any of the following strings will work:
This is a required parameter.
- Returns:
- the Raster Format
setRasterFormat
public void setRasterFormat(java.lang.String rasterFormat)
- Sets the Raster Format parameter of this tool .
This parameter is the format in which the output raster data sets will be delivered. The string provided in the Raster Format parameter should be formatted as follows: any of the following strings will work:
This is a required parameter.
- Parameters:
rasterFormat
- the format in which the output raster data sets will be delivered. The string provided in the Raster Format parameter should be formatted as follows: any of the following strings will work:- ESRI GRID - GRID
- File Geodatabase - GDB - .gdb
- ERDAS IMAGINE - IMG - .img
- Tagged Image File Format - TIFF - .tif
- Portable Network Graphics - PNG - .png
- Graphic Interchange Format - GIF - .gif
- Joint Photographics Experts Group - JPEG - .jpg
- Joint Photographics Experts Group - JPEG - .jp2
- Bitmap - BMP - .bmp
- Portable Network Graphics - PNG - .png
getTo
public java.lang.String getTo()
- Returns the To parameter of this tool .
This parameter is the email address of the recipient. this tool will be able to email to this address if and only if the SMTP server has been configured within this model.
This is a required parameter.
- Returns:
- the To
setTo
public void setTo(java.lang.String to)
- Sets the To parameter of this tool .
This parameter is the email address of the recipient. this tool will be able to email to this address if and only if the SMTP server has been configured within this model.
This is a required parameter.
- Parameters:
to
- the email address of the recipient. this tool will be able to email to this address if and only if the SMTP server has been configured within this model.
getSent
public java.lang.String getSent()
- Returns the Sent parameter of this tool (Read only).
This is an derived parameter.
- Returns:
- the Sent
getToolName
public java.lang.String getToolName()
- Returns the name of this tool.
- Returns:
- the tool name
getToolboxName
public java.lang.String getToolboxName()
- Returns the name of the tool box containing this tool.
- Returns:
- the tool box name
getToolboxAlias
public java.lang.String getToolboxAlias()
- Returns the alias of the tool box containing this tool.
- Returns:
- the tool box alias