Extract Data and Email Task (Server)

Summary

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.

Caution:

This tool is intended primarily for use as a part of a geoprocessing service. When using this tool as a part of a geoprocessing service, copy the tool into a custom toolbox, edit the model, and reconfigure it as necessary. It is important to note that this tool will not work unless you open and edit the model's unexposed input parameter options before publishing the model as a service.

Usage

• 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:

  1. Right-click a copied version of this model and select Edit. The model window should appear.
  2. Doubleclick the Send Email With Zip File Attachment in the model. The input dialog box for the tool should appear.
  3. Enter values for From, Subject, Text, Max File Size, and SMTP Email Server. Hit OK to persist the values you entered in the model.
  4. Save and exit the model.
  
  Note:

  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 drop-down 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:

  1. Right-click a copied version of this tool and select Properties.
  2. In the properties dialog box that appears, click the Parameters tab.
  3. Find the parameter of interest in the table of parameters. On the right side of the table click to bring up its value list. The set of default formats should be listed.
  4. Add, modify, or remove formats from the list as desired. The string you provide needs to be delimited in the following way: Name of format - Short Name - Extension.
  5. Click OK to apply the changes and exit.
  Note:

  Copy this model to your own custom toolbox before making any changes.

• Internally, the Extract Data Task tool uses the Export to CAD 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 Export to CAD tool.

• By default, all supported raster formats are in the drop-down list of raster formats.

  Caution:

  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 Technical Specifications for Raster Formats.

Syntax

ExtractDataAndEmailTask_Server (Layers_to_Clip, Area_of_Interest, Feature_Format, Raster_Format, To)

Parameter	Explanation	Data Type
Layers_to_Clip [Layers_to_Clip,...]	The Layers to be clipped. Layers should be either feature or raster layers.	Layer
Area_of_Interest	The area by which the layers will be clipped.	Feature Set
Feature_Format	The format in which the output features will be delivered. The string provided in the Feature Format parameter should be formatted as follows: Name or format - Short Name - extension (if any). Note: The hyphen between the components is required, as well as the spaces around the hyphen. For Example: File Geodatabase - GDB - .gdb Shapefile - SHP - .shp Autodesk AutoCAD - DXF_R2007 - .dxf Autodesk AutoCAD - DWG_R2007 - .dwg Bentley Microstation Design (V8) - DGN_V8 - .dgn 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. Exporting to non-default formats is supported using Quick Export Tool and that requires the Data Interoperability extension be installed. The Data Interoperability extension is not installed by default with ArcGIS Desktop or ArcGIS Server. If you have the Data Interoperability extension installed, here are the instructions to add another format to the default listadd, remove or modify default list	String
Raster_Format	The format in which the output raster datasets will be delivered. The string provided in the Raster Format parameter should be formatted as follows: Name of format - Short Name - extension (if any) 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 Caution: Some of the above raster formats have limitations and not all data can be converted to the format. For a list of formats and their limitations please read Technical Specifications for Raster Datasets	String
To	The email address of the recipient. Caution: This tool will be able to email to this address if and only if the SMTP server has been configured within this model.	String

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcView: Yes

ArcEditor: Yes

ArcInfo: Yes