数据报表的脚本化导出


目的：

可能在12月17日出现的破坏性变更：某些属性的大小写已被修改。如果您有脚本运行失败，请考虑以下修改：
JobStatus -> jobStatus
ExportDataFileUrl -> exportDataFileUrl
 
角色

具有以下任一角色的用户可以访问该报告：

 

保存您的身份验证密钥

1. 进入 订阅分析报表

2. Click on 数据导出

3. 点击右上角的齿轮图标。 

4. “管理密钥”对话框将会打开。保存两个身份验证密钥。 

如果密钥大多是星号（如上图所示），则表示您所在组织的管理员已经查看过这些密钥。您需要从该管理员那里获取密钥，或者使用刷新图标重新生成密钥。
 
身份验证密钥本质上是一种允许您运行可脚本化导出的密码。首次有人在您的组织中访问此屏幕，或者在它们被刷新后，身份验证密钥将是可见的。保存它们，并将它们保存在一个安全的地方。像保护密码一样保护它们的安全性。之后，它们将对组织中的任何人都不可见。如果您无法访问现有的密钥，或者怀疑未经授权的人已经访问过它们，请尽快刷新它们。您组织中的任何管理员或共同管理员都可以执行此操作。当身份验证密钥被刷新时，之前的密钥将被永久禁用。每个组织只有两个活跃的身份验证密钥。

输入任务设置

一旦您已经获取了至少一个授权密钥，您就可以生成脚本了。

 1. 在之前的屏幕（数据导出）上，点击右上角的“创建新的导出任务”。 

2.这将打开“创建新的导出任务”窗口。选择导出类型，输入您的任务名称和日期范围。日期范围最多为一年。

如果您选择预设的日期范围，例如“昨天”，脚本将根据脚本运行时的日期自动获取“昨天”的日期。例如，如果您在2月26日生成脚本并运行它，它将检索2月25日的数据。如果您在2月28日执行相同的脚本，它将检索2月27日的数据。



3. 点击“下载脚本”。这将允许您将一个PowerShell脚本（扩展名为.ps1）下载到您的计算机上。请确保将其保存到一个非写保护的目录中。该脚本将根据您输入的特定任务设置进行定制。 

 

编辑脚本设置

本节描述了您必须更改的设置，以便能够运行可脚本化导出。

1. 右键点击您下载的脚本并选择“属性”。 
2. 在“常规”选项卡的底部，在“安全”部分，可能会有一个警告，提示该文件来自另一台计算机。如果存在此警告，请勾选“解除锁定”框，然后点击“确定”。 

3. 右键点击该文件并选择“编辑”。默认情况下，这将使用 Windows PowerShell ISE 打开.

4. 在文件中放置一个您的授权密钥。这在第18行的$AuthorizationKey参数中。将"$$FeedMeAPIKey$$"的值替换为您的授权密钥。直接在上面的第17行显示了正确的格式。
5. 默认情况下，数据导出文件将被保存到与该脚本相同的目录中。如果您希望将其保存到不同的目录，只需更新第46行的$DownloadLocalDataExportJobFilePath参数。直接在上面的第45行显示了正确的格式。 

6. 保存文件。脚本已准备好运行。 

此时，您可以测试脚本而无需安排它运行。为此，只需点击工具栏上的绿色“运行脚本”按钮。 


 

使用任务计划程序进行调度

1. 在您的计算机上打开任务计划程序。 

2.从窗口右侧的“操作”菜单中，选择“创建基本任务...”。这将启动“创建基本任务向导”。 

3. 创建基本任务 - 输入名称和描述 

4. 触发器 - 选择任务的频率。例如，每日、每周，并指定一个时间。请注意，您的计算机必须处于开机状态，任务才能运行。 

5. 操作 - 选择“启动程序” 

6. 启动程序 - 程序/脚本 - 输入PowerShell程序。这不是您下载的脚本。PowerShell的默认路径是"C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe"（不含引号）。 
7.启动程序 - 添加参数 - 输入从数据导出下载的脚本的位置。格式为"-File <FileName>"（不含引号）。例如，如果文件位于您的桌面上，文件名为“Sample_Job_LastSevenDays.ps1”，那么您应在参数字段中输入"-File C:\Users\Path\Desktop\Sample_Job_LastSevenDays.ps1"。 

8. 完成 - 检查您的选择，然后点击“完成”。您的任务现在已经安排好了。 

当任务运行时，会打开一个PowerShell窗口。您无需与该窗口交互，任务完成后它将自动关闭。数据导出文件将默认保存到从订阅分析下载脚本的同一目录中。该文件也可以由您组织中的任何管理员从数据导出页面下载。
请注意，如果授权密钥发生变化，脚本需要更新为新的授权密钥。
每次只能执行一个脚本。如果您安排多个脚本同时运行，它们将按接收顺序排队并依次执行。

用量日期

大多数报告都有某种类型的“使用日期”（UsageDate）列。当在纯文本工具（如记事本）中查看CSV文件时，该列将以YYYY-MM-DD格式显示。

根据您的默认Excel设置，如果您在Excel中打开CSV文件，可能需要更改该列的格式。