Disponible avec une licence Business Analyst.
Résumé
Exécute rapidement des rapports pour un ou plusieurs sites.
Utilisation
Crée un ou plusieurs rapports pour une couche de contours donnée.
Cet outil doit principalement être utilisé afin de créer des rapports pour les zones de chalandise Business Analyst.
Dans ArcMap, les rapports sont créés uniquement pour les entités qui se trouvent à l'intérieur de la zone d'étude ou de l'étendue d'analyse active.
La couche à synthétiser est généralement composée de données Esri standard provenant de Business Analyst, mais il peut s'agir d'une couche de contours contenant des données quantifiables qui ont été configurées à l'aide de la fonction configuration des couches d'analyse.
Si vous sélectionnez un jeu de données Business Analyst pour agréger des données, choisissez le niveau géographique le moins élevé possible afin améliorer la précision. Sélectionnez par exemple les données des groupes d'îlots pour bénéficier de la meilleure précision possible lorsque vous créez des rapports pour les zones de chalandise.
L'option REPORT_PER_BOUNDARY du paramètre ReportsOutputReportType est la valeur standard par défaut pour tous les rapports Business Analyst. Cette option n'est disponible que si plusieurs zones de chalandise sont sélectionnées. Par exemple, si un utilisateur souhaite générer un rapport sur deux zones de chalandise (par exemple, une zone de chalandise avec anneaux statiques et une zone de chalandise isochrone) et qu'il veut exécuter trois types de rapports distincts (Age, Population et Ménage, par exemple), cette option permet d'obtenir un fichier en sortie pour chaque zone de chalandise et chaque rapport.
L'option SINGLE_REPORT du paramètre ReportsOutputReportType assemble tous les rapports et zones de chalandise sélectionnés dans un seul fichier de rapport.. Par exemple, si un utilisateur souhaite générer un rapport sur deux zones de chalandise (par exemple, une zone de chalandise avec anneaux statiques et une zone de chalandise isochrone) et qu'il veut exécuter trois types de rapports distincts (Age, Population et Ménage, par exemple), cette option permet d'obtenir un fichier en sortie avec toutes les zones de chalandise et tous les rapports sélectionnés rassemblés. Il est important de noter que cette option ne permet pas de résumer toutes les données de rapport de toutes les zones de chalandise dans le rapport (voir Options de récapitulatif).
L'option INDIVIDUAL_FEATURES du paramètre SummarizationOptions permet de générer un rapport pour chaque contour de la zone de chalandise. Par exemple, si une zone de chalandise avec trois anneaux a été sélectionnée comme couche de contours en entrée et qu'un rapport démographique et de revenu a été sélectionné comme type de rapport, la sortie sera un rapport démographique et de revenu pour chacun des anneaux de la zone de chalandise à trois anneaux. Il s'agit du paramètre par défaut pour tous les rapports Business Analyst reports.
L'option WHOLE_LAYER du paramètre SummarizationOptions utilise chaque variable du rapport et les synthétise pour tous les contours. Par exemple, si une zone de chalandise avec trois anneaux a été sélectionnée comme couche de contours en entrée et qu'un rapport démographique et de revenu a été sélectionné comme type de rapport, la sortie sera un rapport démographique et de revenu unique qui synthétise les trois anneaux dans un seul rapport.
Le paramètre OutputReportsList est requis uniquement en tant qu’entrée du paramètre ReportFile dans l'outil Export Reports.
Le paramètre InsertMap utilise le fond de carte Business Analyst par défaut. Si vous souhaitez utiliser un fond de carte différent (dans la vue de données actuelle), vous devez désactiver le traitement en arrière-plan dans les options de géotraitement.
Certains rapports, notamment le rapport démographique et de revenu, n'ont pas la place d'inclure une carte de type image.
Syntaxe
arcpy.ba.QuickReports(InputFeatureLayer, IDField, BDSFeatureClass, ReportTemplates, OutputFolder, {StoreIDField}, {RingIDField}, {UseSelectedFeatures}, {InsertMap}, {ReportsOutputReportType}, {TERRITORY_LEVEL}, {SummarizationOptions}, {StoreNameField}, {OutputReportsList}, {ReportFormats}, {ReportStyle}, {Header1Field}, {Header2Field})| Paramètre | Explication | Type de données |
InputFeatureLayer | Couche de contours qui sera utilisée pour générer les rapports. Cette couche de contours est généralement une zone de chalandise Business Analyst. | Table View |
IDField | Identifiant unique pour chaque polygone de la couche de contours. | Field |
BDSFeatureClass | Couche contenant les données qui seront utilisées pour générer le rapport. | Feature Layer |
ReportTemplates [ReportTemplates,...] | Modèles de rapport qui seront créés pour chaque entité de la couche de contours. | String |
OutputFolder | Crée un nouveau dossier qui stockera les rapports générés par cet outil. | Folder |
StoreIDField (Facultatif) | ID point de vente associé à chaque zone de chalandise. | Field |
RingIDField (Facultatif) | ID d'anneau associé à chaque zone de chalandise. | Field |
UseSelectedFeatures (Facultatif) | Génère un rapport sur les entités sélectionnées de la couche de zones de chalandise.
| Boolean |
InsertMap (Facultatif) | Insère une carte d'ArcMap dans un modèle de rapport approprié.
| Boolean |
ReportsOutputReportType (Facultatif) | Cette option permet à un utilisateur de choisir entre la génération de rapports individuels par contour et l'assemblage de tous les rapports dans un seul fichier de rapport.
| String |
TERRITORY_LEVEL (Facultatif) | Sélectionnez une couche créée avec le gestionnaire de sectorisation. | String |
SummarizationOptions (Facultatif) | Cette option détermine le mode d'affichage des données dans un rapport.
| String |
StoreNameField (Facultatif) | Nom du point de vente associé à chaque zone de chalandise. | Field |
OutputReportsList (Facultatif) | Ce document indique le répertoire Windows dans lequel les rapports ont été enregistrés et la liste des rapports devant être générés. | File |
ReportFormats [ReportFormats,...] (Facultatif) | Sélectionnez le format souhaité pour le rapport en sortie.
| String |
ReportStyle (Facultatif) | Sélectionnez le style de vos rapports.
| String |
Header1Field (Facultatif) | Description facultative sur l'en-tête du rapport. | Field |
Header2Field (Facultatif) | Sous-description facultative sur l'en-tête du rapport. | Field |
Exemple de code
Exemple d'utilisation du script QuickReports (script autonome)
# Name: QuickReports.py
# Description: Runs a Demographic and Income report on a selected trade area.
# Author: Esri
# Import system modules
import arcview
import arcpy
arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
try:
# Acquire extension license
arcpy.CheckOutExtension("Business")
# Define input and output parameters for the Quick Reports tool
Boundary = "C:/temp/TradeArea.shp"
Id = "AREA_ID"
Bds = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
Output = "C:/temp"
Rpt = "Demographic and Income Report"
# Create Quick reports
arcpy.QuickReports_ba(Boundary, Id, Bds, Rpt, Output)
# Release extension license
arcpy.CheckInExtension("Business")
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Requiert Business Analyst
- Standard: Requiert Business Analyst
- Advanced: Requiert Business Analyst