Json数据源迁移

1. 概述

1.1 功能概述

支持对Wyn JSON数据源的配置文件进行加解密操作，以修改其中的ConnectionString连接字符串，从而在无法通过UI直接修改时完成数据源重指向。

1.2 应用场景

当Wyn 中JSON数据源迁移至新环境后接口无法返回数据时，通过该功能可手动修改配置文件中的接口地址。

2. 操作步骤

2.1 前提条件

1. 已备份原始JSON数据源文件：操作前需将原始数据源文件复制一个副本，防止修改错误导致数据源无法恢复。

2. 已安装PowerShell 7：加解密操作需在PowerShell 7版本环境中执行。

3. 已获取新环境的JSON数据源地址：需准备新环境中可正常访问的JSON API完整URL。

4. 用户权限要求：系统管理员和文档创建者可直接下载文档。其他用户如需下载文档，需满足以下条件：

   1. 用户权限设置：系统管理员给对应用户的角色/组织设置查看文档（查看仪表板、查看报表）和下载文档权限。否则无法进行下载操作，且菜单中的下载选项将被隐藏。具体权限说明详见权限说明。

   2. 文档权限设置：系统管理员将文档分享给对应的角色/组织，并指定读写或完全控制权限（文档直接引用的文档需具备只读或读写权限）。具体权限说明详见文档权限管理。

2.2 操作步骤

步骤一：下载json数据源文件

1. 使用有下载权限的用户登录Wyn，进入文档门户，从工作空间打开数据源列表找到对应的JSON数据源文件并下载（下载后文件后缀是.dsc）。
   

步骤二：加密/解密数据源文件

1. 打开下载的.dsc文件，将ConnectionString属性的值复制到一个文本文件中，例如：加密文本.txt。

   1）打开文件找到ConnectionString，复制其属性值。

   
   

   2）将复制的值粘贴到新的文本文件，例如：加密文本.txt。

   
   

2. 解密ConnectionString。

   1）根据本地/服务器的地址，修改执行脚本中的dll路径，该dll路径在本地/服务器Wyn安装目录下的 \Tools\EncryptOrDecryptString目录中。

   
   

   执行脚本：wyn-string-codec.ps1

   2）解密长文本，在PowerSheel 7版本中执行后会生成一个新的文本文件，例如："C:\Users\LucasYan\Desktop\新建文件夹\加密文本.txt"，里面是解密后的文本。

   执行脚本： wyn-string-codec.ps1 1 -f "对应文件地址"

   例：wyn-string-codec.ps1 1 -f "C:\Users\LucasYan\Desktop\新建文件夹\加密文本.txt"

   
   

   3）修改解密后的文本内容，如URL或者其他属性。

   
   

3. 加密ConnectionString。

   1）执行下面的脚本：

   wyn-string-codec.ps1 0 -f "C:\Users\LucasYan\Desktop\新建文件夹\加密文本.decrypted.txt"

   2）执行后会生成一个新的文本文件，例如： "C:\Users\LucasYan\Desktop\新建文件夹\加密文本.decrypted.encrypted.txt"，里面是加密后的文本。

   
   

步骤三：更换数据源文件的ConnectionString

1. 将加密后的文本复制，替换回原先下载的.dsc文件中的ConnectionString属性值。

   
   

2. 重新在Wyn的文档门户上传修改后的.dsc文件。建议先选择作为新文档上传，检查数据源连接正常后，再次上传选择替换原有文件。