Batch Reports (Business Analyst)

Summary

Allows you to batch reports and run them at a later time.

Usage

Syntax

BatchReports_ba (Boundaries, BDSFeatureClass, ReportTemplates, OutputFolder, {StitchReports}, {InsertMap}, {ReportStyle}, {ReportFormats})
ParameterExplanationData Type
Boundaries
[[Layer, {ID field}, {Store ID field}, {Ring ID field}, {Use selected}],...]

The input feature class that defines the boundary layers for which the reports will be generated.

Value Table
BDSFeatureClass

The input feature class that contains the data from which the reports will be generated.

Feature Layer
ReportTemplates
[ReportTemplates,...]

Selects from a list of predefined or custom report templates in Business Analyst.

String
OutputFolder

The output directory that will contain the reports.

Folder
StitchReports
(Optional)

Takes the report templates selected in the Create Reports parameter and stitches them into a single report based on the order they are added.

  • TrueGenerates stitched reports.
  • FalseGenerates individual reports for each boundary layer.
Boolean
InsertMap
(Optional)

Determine if map image will be inserted if supported by selected report(s).

  • TrueInserts map image into report based on the current view in ArcMap.
  • FalseWill not insert map image into report based on the current view in ArcMap.
Boolean
ReportStyle
(Optional)

The report style for your reports.

  • ScreenThis report format will display a modern look and feel using a more visually pleasing format.
  • PaperThis report format will display a classic look and feel using a more generic style.
String
ReportFormats
(Optional)

The report output format.

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSV
  • Stripped XLSX
String

Code Sample

BatchReports Example (Stand-alone Script)
# Name: BatchReports.py
# Description: Places an Age report in the batch queue.
# Author: ESRI

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
arcpy.CheckOutExtension("Business")
    
# Define input and output parameters for the Batch Reports tool

TAs = "C:\\temp\\TradeArea.shp' AREA_ID STORE_ID RING false"
InputGeo = "C:/Program Files/ArcGIS/Desktop10.0/Business Analyst/Data/BDS/esri_bg.bds"
Rpts = "Age"
OutPath = "C:/temp"
 
# Create batch reports

arcpy.BatchReports_ba(TAs, InputGeo, Rpts, OutPath, "REPORT_PER_BOUNDARY")

# Release extension license 

arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: Requires Business Analyst
ArcEditor: Requires Business Analyst
ArcInfo: Requires Business Analyst

11/8/2010