ArcGIS Python API 中生成使用报告时的常见问题解析

问题背景

在使用ArcGIS Python API的gis.admin.usage_reports.generate_report()功能时，开发者可能会遇到"Specified output format not supported"的错误提示。这个问题主要出现在尝试生成特定类型的报告时，如"content"、"activity"、"credits"和"serviceUsages"等报告类型。

问题分析

经过深入调查，我们发现这个问题与API版本和参数设置有关。虽然官方文档中曾提到这个问题在"当前版本"中已修复，但实际上在多个较新版本（包括2.3.0.3和2.4.0）中仍然存在。

解决方案

要成功生成使用报告，需要注意以下几点关键因素：

1. 必须参数：对于"activity"、"credits"和"serviceUsages"等报告类型，必须指定start_time参数。这个参数应该设置为报告周期的起始时间。

2. 时间计算：建议使用Python的datetime模块计算合适的起始时间。例如，要生成两周前的周报，可以使用以下代码计算起始时间：

   from datetime import datetime, timedelta
   start_time = datetime.now() - timedelta(days=datetime.now().weekday() + 14)
   

3. 完整示例：以下是生成各种类型报告的正确代码示例：

   from arcgis.gis import GIS
   from datetime import datetime, timedelta
   
   gis = GIS(profile="your_online_profile")
   
   report_types = ["content", "users", "activity", "credits", "serviceUsages"]
   
   start_time = datetime.now() - timedelta(days=datetime.now().weekday() + 14)
   
   for rtype in report_types:
       try:
           report_job = gis.admin.usage_reports.generate_report(
               report_type = rtype,
               duration = 'weekly',
               start_time=start_time,
               future = False
           )
           print(f"成功生成{rtype}报告")
       except Exception as e:
           print(f"生成{rtype}报告失败: {e}")
   

注意事项

1. 对于"itemUsages"报告类型，目前还需要额外的timeAggregate参数，这个问题将在下一个API版本中修复。

2. 建议始终检查API文档中的最新参数要求，因为随着版本更新，参数要求可能会发生变化。

3. 如果遇到错误，可以尝试捕获异常并输出详细错误信息，这有助于更准确地定位问题原因。

总结

通过正确设置参数，特别是确保为特定报告类型提供必要的start_time参数，可以成功生成各种使用报告。开发者应该注意不同报告类型可能有不同的参数要求，并在代码中做好异常处理，以确保程序的健壮性。