解决 ArcGIS QuickCapture 移动应用程序中的常见问题。
工程需求更新
工程需求更新消息将指示工程项目已在 ArcGIS 组织中更新。 点击消息以更新此设备上的工程副本。 未发送的记录将保留在设备上,直到它们被自动或手动上传为止,具体取决于应用程序中选择的自动发送设置。
对图层的方案进行任何更新都可能导致记录无法上传。 如果发生这种情况,您可以将失败的记录发送到您所选择的电子邮件地址。
记录无法上传
记录可能由于以下原因而无法上传:
- 上传期间网络连通性可能已丢失。
- 一个或多个工程要素图层不可用(已删除或取消共享)。
- 一个或多个工程要素图层已更改方案。
- 一个或多个工程要素图层不再可供编辑。
- 一个或多个工程要素图层已禁用附件。
- 您不再具有编辑内容的权限。
- 该工程无效且无法从中提交记录。
- 提交的值超出了目标字段类型的大小限制。
当记录无法上传时,地图按钮上会显示一个警告符号。 当选择带有警告的地图按钮时,您将看到以下选项:
- 重试 - 允许用户尝试再次提交失败的记录。
- 通过电子邮件发送 - 创建一个包含所有失败记录的数据库,并允许用户通过电子邮件将其发送给工程管理员。 通过电子邮件发送数据库时不会从设备中移除失败的记录。 如果管理员可以找到失败原因,则用户可以选择重试。
- 放弃 - 从设备中移除失败的记录。 一旦放弃记录,则无法进行恢复。 建议首先选择通过电子邮件发送。
- 取消 - 关闭对话框。
数据恢复
通过电子邮件发送选项会生成一个文件,其文件名格式为 {project name}-{username}-{YYYY-MM-DD-HH-MM}.qrc。 该文件包含以下内容:
- 包含以下三个表的 SQLite 数据库:要素、图层和附件
- 包含所有捕获图像的附件文件夹
- 描述要素图层的地理数据库方案的 .json 文件集合
要查看此文件的内容,请将文件扩展名更改为 .zip 并提取该内容。 .sqlite 数据库的示例编辑器为 DB Browser for SQLite。 在 SQLite 数据库的要素表中,每个记录都包含它所属的要素图层的 URL。 其中还将包含错误消息,这些消息应指出提交失败的原因。 常见的错误消息包括以下内容:
- 几何类型不正确 - 这可能表示图层方案已更改。
- URL 无效 - 这可能表示该图层不再可用。
- 用户不具备执行该操作的权限 - 这可能表示图层权限已更改。
工程作者可以利用此错误信息对工程或要素图层进行更改,以允许提交记录。 进行这些更改后,应用程序用户可以提重新交记录。 如果更改工程或要素图层无法解决问题,则可能需要修改 SQLite 中的记录以允许发送。
以下将介绍如何使用 DB Browser for SQLite 以修改数据库中的记录,以及如何在 Windows 上使用 QuickCapture 移动应用程序以发送经过修改的记录:
- 在 Windows 上启动 QuickCapture 移动应用程序,登录并下载您尝试从中恢复记录的工程。
- 从通过电子邮件发送的错误恢复文件中复制 projects_db.sqlite 文件,然后替换刚刚在 Windows QuickCapture 移动应用程序的 QuickCapture 用户文件夹中创建的 projects_db.sqlite 文件。 该文件夹将如下所示:C:\Users\<username>\ArcGIS\ArcGIS QuickCapture\<user GUID>。 如果您正在发送的记录带有附件,您还必须将错误恢复文件中的附件复制到同一位置的工程附件子文件夹中。 该文件夹将如下所示:C:\Users\<username>\ArcGIS\ArcGIS QuickCapture\<user GUID>\projects_attachments。
- 启动 DB Browser for SQLite 并打开 projects_db.sqlite 文件。 在浏览数据选项卡上,选择 Features 表。 通常需要编辑的字段为 LayerURL(如果目标要素图层已更改)或 Feature(如果属性名称已更改)。
- 将任何已编辑记录的状态值由 -1(错误)更改为 1(准备好发送)。
- 进行任何更改后,请单击编辑数据库单元面板中的应用,然后单击数据库工具栏上的写入更改。
- 关闭 SQLite 数据库浏览器中的数据库并返回到 Windows 上的 QuickCapture 移动应用程序。 您现在可以打开工程并尝试发送经过修改的记录。
无法拍照
为了使移动应用程序能够拍照,QuickCapture 必须具有系统权限才能访问设备的相机。
首次打开移动应用程序时,系统将提示您设置应用程序权限。 如果您拒绝了权限请求,则将不再显示任何提示或错误消息,且该移动应用程序将停在等待拍照的显示状态。 请检查您的设备设置,以确保移动应用程序具备访问设备相机的权限。
使用设备的内部位置源时无法获取位置
为了使移动应用程序在使用设备的内部位置源时能够获取位置,必须满足以下条件:
- 设备的位置服务设置已开启。
- QuickCapture 具备访问设备位置的系统权限。
首次打开移动应用程序时,系统将提示您设置应用程序权限。 如果您拒绝了权限请求,则在工程处于活动状态时,将不再显示任何提示或错误消息,且该移动应用程序将停在等待位置的显示状态。 请检查您的设备设置,以确保移动应用程序具备访问设备位置的权限。
无法连接到外部 GNSS 接收器
尝试使用外部 GNSS 接收器时,最常见的问题是接收器与设备之间的蓝牙连接。 大多数接收器仅允许连接到一台设备。 请确认您所尝试连接的接收器没有与其他设备建立连接。 在 QuickCapture 中搜索接收器之前,请确保已启用蓝牙,且设备报告其已成功连接到接收器。
有关详细信息,请参阅将接收器连接至设备。
无法打开需要位置共享的工程,或无法在工程中启用位置共享
如果工程配置为使用位置共享而位置共享服务已被禁用,则无法使用位置共享。 如果位置共享为必需项,则工程将不会打开,如果位置共享是可选项,则移动应用程序中将不具有共享 UI。组织管理员必须启用位置共享服务,并且移动应用程序用户必须退出应用程序并重新登录才能使用位置共享。
如果位置共享服务已暂停,则移动应用程序将捕获位置共享信息。 位置共享图层取消暂停后,将发送轨迹和最后已知位置。
无法捕获数据
当移动应用程序正在等待相机加载或正在等待有效位置时,您将无法捕获数据。 相机和位置可用后,这些按钮将变为活动状态。
需要重新输入凭据
当您登录到移动应用程序后,在以下情况下,您可能需要重新输入凭据:
- 您的设备已离线超过两周。 此时间段可由您的组织管理员进行指定。
- 您正在网络条件较差的区域工作。
- 您的密码已更新。
您可以继续在设备上使用工程并捕获数据而无需重新输入凭据,但您将无法下载工程或发送数据。
应用程序在 Android 设备上崩溃
当 QuickCapture 在 Android 设备上崩溃时,可以检索日志文件以执行诊断研究和故障排除。 有关详细信息,请参阅从 Android 设备导出崩溃日志 (logcat)。