Extract Data and Email Task

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 (as described below) 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, you will have to copy this model to your own custom toolbox before editing the model.

  1. Right-click a copied version of this model and select Edit. ModelBuilder will open and the model will appear similar to the illustration below.

     

  2. Double-click the Send Email With Zip File Attachment model element to open the tool dialog box.
     1. Enter values for From, Subject, Text, Max File Size, and SMTP Email Server.
     2. Click OK.
  3. You can leave the parameter Layers to Clip and Custom Spatial Reference Folder blank unless you want to provide specific layers or customized spatial reference folder. Leave the parameter to and Sent blank. The parameter Sent is a derived output of Boolean data type, which means it will not show as a parameter when you use the tool. It will set the value automatically when the zip file is sent to the e-mail address you provide.
  4. Save and exit the model.
  5. Run the model tool in ArcMap containing the layers you want to provide to create a result, then publish the result as a geoprocessing service.

• The drop-down menu for the Feature Format and Raster Format parameters contains a list 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. You will have to copy this model to your own custom toolbox before making any changes.

  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 as: Name of format - Short Name - Extension. The hyphens are required and there must be one space before and after the hyphen.
  5. Click OK to apply the changes and exit.

• 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, do the following:

  • Change the string from Autodesk AutoCAD - DXF_R2007 - .dxf to 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, see the help topic Supported raster dataset file formats.

Syntax

arcpy.server.ExtractDataAndEmailTask(Layers_to_Clip, Area_of_Interest, Feature_Format, Raster_Format, To)

Parameter	Explanation	Data Type
Layers_to_Clip [Layer,...]	The layers to be clipped. Layers must be feature or raster layers in the map's table of contents. Layer files do not work for this parameter.	Layer
Area_of_Interest	One or more polygons by which the layers will be clipped.	Feature Set
Feature_Format	The format in which the output features will be delivered. The string provided should be formatted as follows: Name or format - Short Name - extension (if any) 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_R2007, DWG_R2010, DXF_R14, DXF_R2000, DXF_R2004, DXF_R2005, DXF_R2007, and DXF_R2010. Exporting to nondefault formats is supported using the 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.	String
Raster_Format	The format in which the output raster datasets will be delivered. The string provided 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, see Supported raster dataset file formats.	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

Derived Output

Name	Explanation	Data Type
Sent	A Boolean indicating whether or not the email was sent successfully.	Boolean

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes