Bulk Importer and Exporter

你可以使用 批量导入器/导出器工具（Bulk Importer/Exporter Tool） 在开发者门户界面之外管理产品的统计数据和成就。此工具使用包含CSV格式数据的.zip存档，因此你可以在各种现有程序或自己的工具中查看和编辑你的统计数据和成就。

你可以在 开发者门户（Developer Portal） 的 游戏服务（Games Services） > 成就（Achievements） 下找到此工具。批量导入/导出（Bulk Import/Export） 按钮位于靠近顶部的 玩家查找（Player Lookup） 和 新建（Create New） 按钮之间。

导出流程会创建一个zip存档以供下载。此存档将包含产品的所有现有统计数据和成就的.csv和.png图像文件。

这些文件遵循标准的.csv格式，所以大多数电子表格软件包都可以轻松导出和导入此格式。导出前，你的图像文件应是标准的.png格式。

要开始导出，只需选择 导出当前成就（Export Current Achievements）。下载会自动开始，并在通常存放下载内容的路径下创建一个.zip文件夹。

也可选择 下一步（Next） 跳过导出。如果当前成就没有备份，不 建议跳过这一步。

导入流程与导出流程遵循同一文件格式。你的压缩导入文件（.zip）的根目录应包含以下文件：

为了准备导入.zip文件，你可以从开发者门户（上传zip的地方）下载我们的zip模板（选择 下载EOS成就Zip模板）或点击此处。上述任一方法都会自动下载我们的 BulkTemplate.zip 示例文件夹，内含整理有序的内容。

开始导入流程之前，查看你的CSV和图像文件的要求。

一旦准备好导入文件，在批量导入流程的第2步中选择 选择要上传的文件（Choose File to Upload）。查看通知，即导入操作会删除所有现有成就并清除产品的所有统计数据。

选择 下一步（Next），将发起对导入内容的验证检查。完成后，后端服务会删除你的所有现有统计数据和成就，然后替换为在.zip文件中找到的统计数据和成就。这包括在后端服务上缓存新成就使用的任何图标。

导入程序的最后一步会显示你的成就和统计资料导入成功。

为了确保上传的.csv文件通过验证检查，请遵守各个文件的数据格式，并避免留下空白行。所有CSV文件必须采用UTF-8编码。

Stats.csv 文件包含两个统计数据列：统计数据名称列及其聚合类型列。聚合类型的支持值是 SUM、MIN、MAX 或 LATEST。stats.csv 示例文件如下：

详见统计数据界面。

achievementsDefinitions.csv 使用三列来定义每个成就以及解锁成就的要求。前两列保存成就的内部名称和布尔值，该值指示成就是否隐藏。

第三列是可选的；如果为空，成就只能通过EOS SDK的显式命令解锁。如果第三列存在，则是一个统计数据名称和阈值的列表，格式为 Stat1:Threshold1;Stat2:Threshold2;StatN:ThresholdN，如以下 Achievements.csv 示例文件：

详见成就界面。

所有有关成就的用户可见信息都要本地化。

achievementLocalizations.csv 负责设置向不同地区用户描述各个成就所需的所有数据。这包括成就和区域设置的内部名称，之后是其锁定时的标题和描述、解锁时的标题和描述、风格文本、其锁定和解锁图标。以下 achievementLocalizations.csv 示例文件展示同一组成就的默认版本（第二列为空）和德语版本（第二列为“de”）。

csv文件的区域设置列（第二列）中输入的文本必须与下面“标签”列中的格式匹配：

你在 achievementDefinitions.csv 中引用的图标必须存在于导入的当前zip存档中，因为在进行新的导入时，所有之前的内容都将被删除。所有图标都必须采用.png格式，并存在于存档的根级别。你的.zip文件中不可有任何子文件夹。

为了消除用户的冗余下载，若引用相同图标，则成就可以共享图标。当多个成就使用同一图像时，可以使用此功能，比如隐藏的成就的“锁定”图标。