2021年5月6日

在Confluence Server中将Gliffy图大量导入draw.io

大量Gliffy导入将所有页面(或选定空间)上的所有Gliffy图转换为draw.io图。当前的Gliffy JSON格式和旧版XML格式均受支持。

注意:如果您正在寻找Lucidchart本地大量导入器,请参阅本文。

重要的

首先在镜像测试实例上测试批量导入。

在执行批量导入之前,必须重新索引合流度,以便找到所有图表。

必须安装Gliffy应用程序,但建议删除许可证,以在批量导入期间使Gliffy图有效地为只读。

批量导入器无法触摸草稿。如果您有未发布的带有Gliffy图的草稿页,则发布该页面将发布Gliffy图。

运行Gliffy批量导入功能

以管理员身份,安装draw.io应用程序。

转到实例管理区域左侧面板中的Atlassian Marketplace标题,然后点击查找新应用。

搜索draw.io 并安装Confluence应用程序的draw.io图表。

安装完成后,在实例管理区域左侧面板中的draw.io附加标题下,然后单击“配置”并选择“ Gliffy导入”选项卡。

要限制您导入的空格,请在“按空格过滤”字段中输入一个过滤器。使用此工具在较小的演示空间上测试导入。然后点击 开始导入。

注意:完全导入可能需要一些时间,具体取决于存在的Gliffy图的数量。创建导入的文本报告,导入完成后,您可以下载该文本报告并将其用于检查结果。

其他配置选项

您可以通过将URL参数添加到draw.io配置页面的URL中来添加以下配置选项。

通过添加pageVersionComment = YourURIEncodedString URL参数,配置要应用于转换后的图的注释。

通过添加keepDates = 1 URL参数,确保对每个页面进行的最后修改的日期没有改变。

例如,将BASE_URL替换为Confluence Server实例的URL:

https://BASE_URL/admin/drawioConfig.action?pageVersionComment = MyComment&keepDates = 1

大量导入常见问题

何时执行导入

最好在公司的Confluence实例正常使用时间之外执行转换。您可以在正常工作时间内进行导入,但是最好在对相关页面进行最少更改的同时执行整个操作。

我们建议您删除Gliffy许可证,以使用户在进程运行时不要开始编辑Gliffy图。没有许可证,Gliffy图实际上是只读的。请告知用户您正在执行此操作,以及何时开始/完成该过程。

图备份

draw.io会自动为每个包含Gliffy图的页面创建一个新的页面修订版。如果需要,您可以始终将页面还原到以前的版本,因为不会删除任何Gliffy数据。

卸载Gliffy

当您购买Gliffy之类的应用时,如果发布日期早于维护期结束,则您将获得任何版本的永久许可。这些版本将在此到期日期之后继续工作,从而允许您查看和编辑Gliffy图。

大多数Confluence管理员更喜欢使用draw.io明确推荐用户图表,因此请卸载Gliffy应用程序。如果已经卸载了Gliffy,则批量Gliffy to draw.io导入仍将起作用,因为图表文件仍附加在其页面上。

请注意,我们不建议您在批量导入完成并检查结果之后再卸载Gliffy。

权限

对您的Confluence实例中的所有空间具有完全写入权限的管理员应运行批量导入。如果不存在这样的用户,则您将需要暂时提升管理员的权限,以在导入期间拥有这些权限。

故障排除

确保始终首先使用生产数据在测试实例上测试批量Gliffy导入。如果在此批量导入期间遇到任何问题,请发送电子邮件至support@draw.io,发送Gliffy导入报告文本文件作为电子邮件的附件。

CONFSERVER-59196错误的解决方法

Confluence版本7.0.0及更高版本存在一个错误,要求供应商禁用批量操作,例如批量Gliffy导入。

解决方法是,将draw.io应用程序更新到版本9.2.7或更高版本,然后将ignoreBulkOpsWarning = 1 URL参数添加到draw.io配置页面的URL中。例如:

的HTML

https://conf.example.com/admin/drawioConfig.action?ignoreBulkOpsWarning=1

此解决方法将仅重试失败的操作,不存在涉及数据丢失的风险。但是,我们不能保证变通办法将100%成功。