DBnomics PowerPoint (pptx) 工具

此CLI工具允许更新来自DBnomics的PowerPoint演示文稿中的数据。

示例

查看示例目录

用法

首先，定义一个YAML元数据文件，描述需要更新的每个幻灯片上的图表和表格。

阅读下面的元数据文件部分以获取更多详细信息。

从simple_presentation_1.yaml示例中获取灵感

fetch命令

此命令读取YAML元数据文件中所有幻灯片图表和表格所需的所有序列，去重并下载到缓存目录，其中它们以JSON文件的形式存储。

dbnomics-pptx fetch samples/simple_presentation_1.yaml

使用-v选项显示调试消息。

默认情况下，始终下载序列，即使它们已存在于缓存目录中。否则请使用--resume选项。

save-data-archive 命令

此命令创建用于更新演示文稿的系列 ZIP 存档（参照 update 命令）。

dbnomics-pptx -v save-data-archive samples/simple_presentation_1.yaml series.zip
unzip -t series.zip
    Archive:  series.zip
        testing: OECD/KEI/NAEXKP01.DEU.GP.A.csv   OK
        testing: OECD/GDP_GROWTH/W.Eurozone.tracker_yoy.csv   OK
        testing: OECD/KEI/NAEXKP01.EA20.GP.A.csv   OK
        testing: OECD/KEI/NAEXKP01.FRA.GP.A.csv   OK
        testing: OECD/GDP_GROWTH/W.USA.tracker_yoy.csv   OK
        testing: OECD/KEI/NAEXKP01.ITA.GP.A.csv   OK
    No errors detected in compressed data of series.zip.

update 命令

此命令接收 PowerPoint 演示文稿文件和一个 YAML 元数据文件作为输入，然后更新元数据文件中定义的图表和表格，并将结果保存到输出演示文稿文件中（它不会修改输入文件）。

dbnomics-pptx update samples/simple_presentation_1.pptx --metadata-file samples/simple_presentation_1.yaml samples/simple_presentation_1.output.pptx

使用-v选项显示调试消息。

元数据文件

以下是一个示例文件，其中包含虚构的 ID，以展示其结构。

slides:
  AE_GDP: # the ID of the slide (as defined in the slide notes, cf below)
    charts:
      US_EU_GDP: # the ID of the chart (as defined in the "Selection pane")
        series:
          - id: OECD/GDP_GROWTH/W.USA.tracker_yoy # the ID of the series on DBnomics
            name: United States
          - id: OECD/GDP_GROWTH/W.Eurozone.tracker_yoy
            name: Eurozone
    tables:
      EU_GDP: # the ID of the table (as defined in the "Selection pane")
        series:
          - id: OECD/KEI/NAEXKP01.EA19.GP.A
            name: Euro Area
          - id: OECD/KEI/NAEXKP01.DEU.GP.A
            name: Germany
          - id: OECD/KEI/NAEXKP01.FRA.GP.A
            name: France
          - id: OECD/KEI/NAEXKP01.ITA.GP.A
            name: Italy

幻灯片 ID

要更新，幻灯片必须已被分配一个 ID。由于 PowerPoint 不提供分配 ID 的方法，我们决定在幻灯片备注中使用特殊字符串，使用语法 slide_id:xxx，其中 xxx 应替换为实际值。例如，在上面的 YAML 文件中，幻灯片 ID 是 AE_GDP，因此我们期望相应的幻灯片备注包含字符串 slide_id:AE_GDP。

图表和表格 ID

可以从 PowerPoint 的“选择面板”中读取或修改图表和表格的 ID。

可以通过 PowerPoint 中的 Alt+F10 打开“选择面板”。然后您只需选择一个图表或表格，它将在“选择面板”中突出显示对应的行，显示其 ID。

您还可以修改 ID 以提高可读性。

一旦获得图表或表格的 ID，您就可以将其放入 YAML 文件中。在之前的示例中，ID 是“我的图表 1”和“我的表格 1”。

另请参阅

• 使用选择面板管理对象
• PowerPoint 选择面板