Survey123 Connect 可将使用 XLSForm 规范设计的表单转换为要在 Survey123 中使用的 XForm，并将其发布到 ArcGIS Online 或 ArcGIS Enterprise。 在此过程中，可能会出现一些问题。
表单转换错误
在 Survey123 Connect 中创建新调查时，可以使用 XLSForm 规范来设计使用电子表格的表单。 Survey123 Connect 可将电子表格转换为 XForm，从而按照调查在 Survey123 中的显示方式对其进行预览。
您需要先执行以下操作，然后才能进行转换：
- 保存电子表格中的更改。
- 在 Survey123 Connect 中，单击更新按钮。
如果调查存在问题，您将收到表单转换服务发送的错误消息。 在以下示例中，错误消息说明名为 last name 的姓名条目存在问题。 在本例中，条目中包含空格。 应移除空格或将其替换为下划线或短划线。
下表中列出了一些常见表单错误：
| 错误描述 | 诊断 |
|---|---|
转换 XLSForm 时出错 | 在以上示例中，该错误会突出显示名为 last name 的问题。 在本例中，错误是 name 列中包含空格。 另一个将导致出现此消息的常见错误是在 survey 或 choices 工作表的 name 列中使用非 ASCII 字符。 ASCII 字符可用于标注列，但不能用于名称列。 |
[row : 2] 列表名称未包含在选择工作表中：[JobType] | 该错误表明：其中一个 select_one 或 select_multiple 问题引用的列表未包含在 choices 工作表中。 在本示例中，应移除方括号。 |
应该存在针对此问题的选择。 | 该错误表明：将 or_other 附加参数作为类型一部分的其中一个 select_one 或 select_multiple 问题还具有一个已定义的选项过滤器。 对于输入其他值选项，无法在级联选择中使用包含此选项的选择问题。 |
网络错误
如果无法访问表单转换服务，您将收到以下类似错误消息：
下表中列出了一些常见网络错误：
| 错误编号 | 错误描述 | 诊断 |
|---|---|---|
-1 | 无法打开 C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | 文件中的 Excel 可能处于锁定状态。 请确保未由另外应用程序或用户打开调查。 |
3 | 未找到主机 survey123.arcgis.com | 您正在运行先前版本的 Survey123 Connect。 升级到最新版本。 |
6 | SSL 握手失败 | 许多问题可能会导致 SSL 握手失败，例如：
您可以使用在线测试程序（例如 SSL 实验室）来测试 web 服务器中所使用的 SSL 证书。 |
99 | 连接超时 | 如果使用非常大的调查，有时会出现此问题。 请重试。 |
202 | 下载 https://survey123.esri.com/api/xls2xform 时出错 - 服务器回复：已禁止 | 消息中包含 esri.com 的所有错误均与旧服务器有关。 升级到最新版本。 |
203 | 下载 https://survey123.esri.com/api/xls2xform 时出错 - 服务器回复：未找到 | 消息中包含 esri.com 的所有错误均与旧服务器有关。 升级到最新版本。 |
401 | 下载 https://survey123.arcgis.com/api/xls2xform 时出错 - 服务器回复：内部服务器错误 | 此错误通常是由相关列或计算列中的表达式造成的。 请使用大括号，并在语句开头使用 $ 符号。 |
403 | 下载 https://survey123.esri.com/api/xls2xform 时出错 - 服务器回复：服务暂时不可用 | 请立即向 Esri 报告此错误。 |
498 | 无效令牌 | 无法接受 Survey123 Connect 尝试传递给 ArcGIS 的令牌。 此错误通常是由尝试将令牌传递给公共要素图层的提交 URL 造成的。 |
499 | 传输 https://survey123.arcgis.com/api/xls2xform 时出错 - 服务器回复：代理错误 | Survey123 API 不可用或已超时。 请稍等片刻，然后再试一次。 如果问题仍然存在，请参阅 Survey123 Esri 社区 以了解详细信息。 |
在错误对话框中，您可以捕获错误以发送给 Esri。 将所有附加信息添加到电子邮件中可帮助对问题进行调试。
发布错误
在 ArcGIS 中创建调查项目时，通常会出现这些错误。
下表中列出了常见的发布错误：
| 错误 | 诊断 |
|---|---|
提交 url 不兼容（字段未找到） | 提交 URL 指定的要素图层中不存在指定字段，这意味着调查响应与调查不兼容。 取消指定提交 URL 以创建一个新的 URL，或者确保提交 URL 链接至正确的要素图层。 此错误通常是由在对 select_one 或 select_multiple 问题使用 or_other 选项时创建的附加字段引起的。 有关详细信息，请参阅多项选择问题。 |
提交 url 不兼容（请求错误） | 检查您用于登录到 Survey123 Connect 的用户是否拥有对要素图层的访问权限。 |
父项 repeat_1 的 SurveyName 中无子键字段 | 如果提交的要素图层所依赖的全局 ID 父键在调查中不存在，则会出现此错误。 在发布选项窗口中，将在重复关系中使用全局 ID 父键设置为 true。 |
由于表 'y' 中的列 'x' 超过最大值 1024 列，因此 CREATE TABLE 失败。 | 尝试发布的调查包含的字段数超过 ArcGIS 组织中要素图层允许的最大值 (1,024)。 请将字段数减为小于 1024 的值，然后再次发布调查。 有关这些限制的详细信息，请参阅 ArcGIS Online 帮助中的疑难解答。 |
自定义要素服务提交 url 与此调查不兼容（要素服务不符合重复调查的要求 - supportsApplyEditsWithGlobalIds） | supportsApplyEditsWithGlobalIds 属性设置为 false 并且必须是 true。 完成此操作最简单的方法是在发布要素图层时启用同步。 |
自定义要素服务提交 url 与此调查不兼容（未找到表格的目标关系） | 调查中的重复与要素图层中的相关表格关联错误，或者表格不存在。 请确保重复与目标相关表格具有相同名称。 |
门户错误
与发布至 ArcGIS Enterprise 的调查不同，发布至 ArcGIS Online 的调查具有以下列出的限制。
- 您无法将调查发布至 ArcGIS Enterprise，该产品将某些保留关键字用作字段名称，例如 end（如果字段名称不完全是关键字，则包含这些关键字的字段名称是可以接受的，例如 endSurvey）。 将在 Survey123 XLSForm 模板的 Reserved 工作表中列出保留关键字。
- 发布到 ArcGIS Enterprise 时，所有字段名称必须为小写。
- 发布到门户的要素图层可以包含的最大列数取决于企业级地理数据库。 请参阅数据库管理系统的文档以确定大小限制。 如果您调查中的问题数量超过了企业级地理数据库的列数限制，解决办法将是包含重复，并将 repeat_count 设置为 1 以将调查扩展到多个表。
- 调查工作表中问题名称必须小于 32 个字符。
- 如未使用 ArcGIS Data Store，则无法将 Survey123 内容上传至 ArcGIS Enterprise 或 Portal for ArcGIS。
- 如果在断开连接的环境中部署 ArcGIS Enterprise，则调查模板、示例和至 ArcGIS Online 要素图层的提交 URL 将无效。
- 提交 URL 无法直接与非联合的 ArcGIS Server 要素图层配合使用。 解决方法请参阅将服务注册到 ArcGIS Online 或 ArcGIS Enterprise。
- 如果使用多用户地理数据库，则图层可以使用分支版本化，但不可以使用传统版本化。 Survey123 将在使用分支版本化地理数据库时将默认版本作为目标版本。 有关详细信息，请参阅版本化类型。
启用诊断日志记录
如果您遇到未在本主题中列出的错误消息或其他异常行为，则从 Survey123 Connect 记录信息日志非常有用，以便与其他人（例如 Esri 支持）共享以解决问题。
要启用日志记录，请打开应用程序主页上的菜单，单击设置，然后单击诊断选项卡。
要将消息捕获到文件中，请单击日志记录切换按钮以启用日志记录。 将使用默认日志文件位置自动填充日志输出位置文本框。 您可以编辑此文件路径。 要在线将消息捕获至兼容 syslog 的控制台，请在日志输出位置文本框中，而非日志文件位置中输入其 URL。
可以共享日志文件，也可以通过电子邮件发送日志文件。 如果您选择在应用程序中通过电子邮件发送日志，则应用程序版本号、操作系统名称和系统区域设置将包含在电子邮件正文中，日志将作为附件包含在内。
注：
对于实时日志记录，诊断选项卡将显示当前在网络中打开的所有 AppStudio 控制台实例。 找到正在运行的 AppStudio 控制台前，诊断选项卡将始终显示一个搜索圆形符号。 如果您首先选择 AppStudio 控制台，然后单击日志记录切换按钮，则日志记录信息将开始显示在该控制台中。 有关详细信息，请参阅 ArcGIS AppStudio 帮助中的捕获控制台输出。