Product Documentation

将 Secure Forms 与 ShareFile 集成

Sep 13, 2016

要部署 WorxForms(以前称为 Citrix WorxForms),必须手动设置或使用 PowerShell 脚本设置 ShareFile 文件夹。

PowerShell 脚本设置

注意:仅当您具有 Citrix 托管的(云)ShareFile StorageZone 时此脚本才起作用。 如果您具有客户托管的(本地)StorageZone,请手动执行以下步骤:

1. 安装 ShareFile PowerShell SDK(可从此处获取)。

2. 打开 PowerShell 控制台并运行 CitrixsSecureForms.ps1 脚本(可从此处获取)。

3. 输入有权创建根级别文件夹以及用户和通讯组的用户名和密码。

localized image

此脚本会自动创建组 CitrixSecureFormsAdminUsers CitrixSecureFormsEndUsers 以及分配有恰当权限的必需文件夹。 

现在可以从 ShareFile 控制台向这些组中添加用户。

用户权限

添加到 CitrixSecureFormsAdminUsers 的用户可以从 secureforms.citrix.com 访问 Composer、创建和发布表单以及从提交的表单中读取数据。

已添加到 CitrixSecureFormsEndUsers 用户只能使用移动应用。 这些用户可以登录 secureforms.citrix.com,但只具有表单的只读访问权限。 这些用户无法编辑或发布表单,也无法访问提交的数据。

表单存储

所有已发布的表单保存在 Shared Folders(共享文件夹)> Citrix_SecureFormsTemplate.root > Default.workspace 中。 

所有已提交的表单保存在 Citrix_SecureFormsData 中。

手动设置

如果 PowerShell 脚本无法运行,可以手动设置必要的文件夹。

1. 使用有权创建根级别文件夹以及用户和通讯组的用户名和密码登录到 ShareFile。

2. 转至 Manage Users(管理用户)> Distribution Groups(通讯组),然后选择 New Group(新建组)。

localized image

3. 创建一个名为 CitrixSecureFormsAdminUsers 的通讯组。

localized image

4. 单击 Add Member(添加成员)添加可访问 Secure FormsComposer 的用户。 该组的成员可以创建、更新、发布和删除表单。

localized image

 

5. 创建一个名为 CitrixSecureFormsEndUsers 的通讯组。 该组的成员可以使用 Secure Forms 移动应用程序填写并提交表单。 在 Composer 中,成员能够以只读方式访问表单。 他们无法发布表单或查看已提交的数据。

localized image

您刚创建的通讯组将出现在 Manage Users(管理用户)> Distribution Groups(通讯组)中。

localized image

6. 返回 Home(主页)并转至 Shared Folders(共享文件夹)。

localized image

7. 创建一个名为 Citrix_SecureFormsTemplate.root 的文件夹。

localized image

8. 向 WorxFormsAdminUsers 提供针对 Citrix_SecureFormsTemplate.root 文件夹的所有权限(下载、上载、删除和管理)。  

localized image

9. 仅向 CitrixSecureFormsEndUsers 授予下载权限。

localized image

10. 在 Citrix_SecureFormsTemplate.root 文件夹中,创建另一个名为 Default.workspace 的文件夹。 确保 Default.workspace 具有与 Citrix_SecureFormsTemplate.root 相同的通讯组权限。 所有已发布的表单保存在 Default.workspace 中。

localized image

11. 返回“Home”(主页)并转至 Shared Folders(共享文件夹)。

12. 创建一个名为 Citrix_SecureFormsData.root 的文件夹。 所有提交的表单数据将进入该文件夹。

localized image

13. 向 WorxFormsAdminUsers 提供 Citrix_SecureFormsData.root 的所有权限(下载、上载、删除和管理)。

localized image

14. 只为 CitrixSecureFormsEndUsers 提供 Citrix_SecureFormsData.root 文件夹的上载权限。 CitrixSecureFormsEndUsers 成员可以提交但无法查看表单数据。

localized image

在 Secure Forms Composer 中执行故障排除

以下故障排除提示信息可用于解决用户在使用 Secure Forms Composer 时可能会遇到的错误。 其中许多错误由初始 ShareFile 设置过程中的错误导致。

错误代码

用户看到的消息

含义

应执行的操作

12501

您无权进行发布。 请联系您的 ShareFile 管理员。

用户无法发布模板。 这通常是因为用户没有权限访问
我的文件和文件夹 > Citrix_SecureForms.root > 我的未发布模板,或
共享文件夹 > Citrix_SecureFormsTemplate.root > Default.workspace。

 

以管理员身份登录到 ShareFile,将用户添加到 CitrixSecureFormsAdminUsers 通讯组,并按照与 ShareFile 集成 > 手动设置中的说明进行操作。 这将使用户有权访问这些文件夹。

 

12502

您无权执行删除操作。 请联系您的 ShareFile 管理员。

该用户无权删除特定的表单或模板。

 

以管理员身份登录到 ShareFile,并为用户授予删除权限:

将用户添加到 CitrixSecureFormsAdminUsers 通讯组,并按照与 ShareFile 集成 > 手动设置中的说明进行操作。  确保 CitrixSecureFormsAdminUsers 具有删除权限。

 

 

12503

您无权取消发布。 请联系您的 ShareFile 管理员。

用户无法取消发布模板。 

当用户具有共享位置 Shared Folders > Citrix_SecureFormsTemplate.root > Default.workspace 的只读访问权限时会发生这种情况。

 

以管理员身份登录到 ShareFile,并授予共享位置的完全用户权限。

将用户添加到 CitrixSecureFormsAdminUsers 通讯组,并按照与 ShareFile 集成 > 手动设置中的说明进行操作。  确保 CitrixSecureFormsAdminUsers 具有共享文件夹的写入权限。

12504

无法查找或创建指定的 NFS 路径。

发生了多种可能网络文件系统 (NFS) 错误中的一种错误:

  • NFS 连接器的名称无效,或此连接器不存在(将返回 HTTP 404)
  • 没有足够权限在 NFS 连接器中创建新文件夹
  • NetScaler/NetScaler Gateway 不通过单独的负载平衡器/策略来处理 OPTIONS 请求
  • 已在存储区域控制器中禁用匿名/Windows 身份验证
  • 存储区域控制器已关闭/不可用
  • 无效的凭据(用户名、密码、域名)
  • Citrix.com 不是允许的顶级域。

 

  • 确保 NFS 连接器名称存在,并可在 ShareFile 中进行访问。
  • 检查共享文件夹的权限。
  • 检查 NetScaler中的负载平衡器配置。
  • 确保在存储区域控制器中启用匿名身份验证基本身份验证
  • 执行手动检查,以确保存储区域控制器可用。
  • 验证用户的凭据。
  • 添加 citrix.com 作为允许的顶级域。

有关详细信息,请参阅配置网络文件系统

12505

您已经达到了副本限值。 请删除一些副本,然后再继续。

模板已达到 100,000 个副本(允许的最大值)。

 

请删除一些模板。

 

 

12506

无法在您的 ShareFile 帐户中找到“My Files and Folders”。

顶部文件夹 My Files and Folders 不可用。 通常,当用户添加到特定的子域时,会自动在 ShareFile 中创建“我的文件和文件夹”。 Secure Forms 会在“我的文件和文件夹”中创建一个根文件夹,用于存储所有特定于用户的数据。

 

确保将用户作为员工而非客户端添加到该文件夹。 有关 ShareFile 中员工和客户端之间的差异的详细信息,请参阅本文

也有可能存在许可问题,在这种情况下,您应联系 ShareFile 支持部门,或从 MyCitrix 门户寻求帮助。 

12507

无法在您的 ShareFile 帐户中找到“Shared Folders”。

Shared Folders 文件夹不可用。 通常,当用户添加到特定的子域时,会自动在 ShareFile 中创建“共享文件夹”。 Secure Forms 使用此位置来访问共享的数据。

 

以管理员身份登录到 ShareFile。 确保 Shared Folders 可用,并且用户属于有权访问 Shared Folders 的组。 按照与 ShareFile 集成 > 手动设置中的说明执行操作。

 

12508

无法在共享文件夹中找到根文件夹。

Shared Folders > Citrix_SecureFormsTemplate.root 文件夹不可用。 此文件夹包含 default.workspace 文件夹,其用于存储已发布的表单。

以管理员身份登录到 ShareFile。 请确保 SecureFormsTemplate.root 存在,且用户有权访问它。

转到与 ShareFile 集成 > 手动设置,并按照创建名为 Citrix_SecureFormsTemplate.root 的文件夹中的说明执行操作

12509

无法在共享文件夹中找到数据文件夹。

Shared Folders > itrix_SecureFormsData.root 文件夹不可用。  已提交的表单存储在该文件夹中。

 

以管理员身份登录到 ShareFile。 请确保 Citrix_SecureFormsData.root 存在,且用户有权访问它。

转到与 ShareFile 集成 > 手动设置,并按照创建名为 Citrix_SecureFormsData.root 的文件夹中的说明执行操作。

 

12510

无法在 Shared Folders 下找到默认工作区。

Shared Folders > Citrix_SecureFormsTemplate.root > default.workspace 文件夹不可用。 已发布的表单存储在该文件夹中。

以管理员身份登录到 ShareFile。 请确保 default.workspace 文件夹存在,且用户有权访问它。


转到与 ShareFile 集成 > 手动设置,并按照创建名为 default.workspace 的文件夹中的说明执行操作。

12511

无法在共享文件夹中加载根文件夹。

无法加载 Shared Folders > Citrix_SecureFormsTemplate.root 文件夹。 

 

以管理员身份登录到 ShareFile,并确保用户有权访问 Shared Folders > Citrix_SecureFormsTemplate.root。

转到与 ShareFile 集成 > 手动设置,并按照向 CitrixSecureFormsAdminUsers 授予所有文件夹权限(即“下载”、“上载”、“删除”和“管理”权限)的说明执行操作。

12513

无法访问 ShareFile 用户信息。

Secure Forms 移动应用程序尝试访问用户基本信息(如名字、姓氏或电子邮件),但 ShareFile 未响应。 当管理员已禁用用户时,通常会发生此情况。

 

以管理员身份登录到 ShareFile,转到 Manage Users(管理用户)> Search Users(搜索用户),并确保用户未被禁用。

12514请刷新此页面并输入您的公司凭据。在 ShareFile 受限区域设置中,用户输入了错误的凭据。用户应刷新页面,并输入正确的凭据。
12515从您所在组织的网络内部访问此 Web 站点。 如果仍然出现此错误,请联系技术支持。
  • 在失败的登录尝试后用户取消或关闭 Composer。
  • 存在一些不受浏览器信任的自签名证书。
  • 用户正尝试从网络外部访问受限区域。
  • 发生了一般网络故障、Internet 故障或 DNS 故障。
用户应稍后再试,或者联系技术支持人员。

错误代码 12000

错误代码 12000 是一个未确定的问题。 您需要联系 Citrix 技术支持。 请执行以下步骤生成控制台日志并将其发送给 Citrix。

1. 打开 Chrome 检查器。 右键单击 Chrome 窗口中的任意位置,然后选择 Inspect(检查)。 将出现页面源代码。

2. 获取控制台日志。 单击检查器窗口中的 Console(控制台)选项卡。 右键单击然后选择 Save as(另存为),将日志保存为一个文件。 关闭检查器。

3. 联系 Citrix。 单击 Secure Forms Composer 右上角的对话框气泡图标。 在消息窗口中,编写关于问题的简短说明。 然后,获取屏幕截图,并附加控制台日志文件。 

localized image