您可以在调查中包含媒体（音频、文件和图像）问题，以允许用户在调查响应中提交附件。
提示：
图像和音频也可以添加到调查中的其他问题中，以进行参考和设置样式。 有关详细信息，请参阅向调查中添加媒体。
默认情况下，媒体问题允许一个附件。 要允许多个附件，请设置其外观。
默认情况下，Survey123 将自动为问题中提交的媒体生成文件名。 文件名包括作为前缀的问题名称，后跟一个唯一编号。 您可以自定义文件名使其更加有意义。 有关详细信息，请参阅自定义文件名。 如果导出调查数据并发布为要素图层以在 Survey123 中重用，建议不要自定义文件名。 有关详细信息，请参阅关键字。
音频
音频问题类型允许用户在 Survey123 中录制音频。 进度条用于指示录制的剩余时间 。 用户可以随时暂停或停止录制。 录制完成后，他们可以编辑文件名。
注：
在 Survey123 外业应用程序中，Android 设备不支持在录制音频时暂停。
默认情况下，在 Survey123 Mobile 和 Survey123 外业应用程序中，音频录制的最大文件大小为 10 MB，在 Survey123 Web 应用程序中为 10 分钟。
您可以使用 bind::esri:parameters 列中的 max-size 参数设置不同的大小限制（以 MB 为单位）。 达到最大文件大小时，录制将自动停止。 例如，max-size=5 允许用户录制的音频的最大大小为 5 MB。
或者，您可以使用 bind::esri:parameters 列中的 max-duration 参数指定时间限制（以秒为单位）。 达到最大持续时间时，录制将自动停止。 例如，max-duration=30 允许用户录制长达 30 秒的音频。
警告：
在 Survey123 外业应用程序中，单个提交附件的最大文件大小为 10 MB。 请确保您设置的 max-duration 或 max-size 值不会导致音频文件超过此最大文件大小。
您可以使用 bind::esri:parameters 列中的 codec 参数指定首选音频编解码器。 可以提供多个编解码器，以逗号分隔，例如 codec=amr-nb,aac。 将使用与设备兼容的第一个编解码器。
注：
在 Survey123 Mobile 中，如果设备支持，音频文件默认使用高级音频编码 (AAC) 编解码器进行编码。 每个操作系统支持的编解码器如下：
- Android - AAC、MP3
- iOS - AAC、ALAC、FLAC、MP3、PCM、Vorbis
- Windows - AAC、ALAC、MP3、PCM、Vorbis、WMAudioLossless、WMAudioV8、WMAudioV9
注：
在 Survey123 外业应用程序中，录制会使用设备的默认音频捕获格式捕获音频文件。 设备支持的编解码器列在应用程序的关于页面上。按住关于页面顶部的关于 ArcGIS Survey123 标题可显示有关设备的其他信息，包括它支持的音频编解码器。 在 Windows 设备上，音频文件始终以未压缩的 WAV 格式录制。
您可能无法在 web 浏览器中播放某些音频文件，因为浏览器并非支持所有编解码器。 有关 web 上音频编解码器的详细信息，请参阅 Mozilla 开发人员网络文档。
在 Web 应用程序中，音频问题仅允许上传现有的音频文件。 您也可以使用文件问题提交存储在设备上的音频文件。 有关支持音频的文件类型的列表，请参阅文件。
文件
注：
本部分将介绍仅在 Survey123 Connect 和 Survey123 外业应用程序中可用的功能。此功能在 Survey123 Studio 或 Survey123 Mobile 中不可用。
文件问题类型允许用户提交一系列文件类型。
单个文件的默认最大文件大小为 10 MB。 对于 Survey123 Web 应用程序中的文件问题，可以使用 bind::esri:parameters 列中的 max-size 指定最大文件大小（以 MB 为单位）。 例如，max-size=5 允许用户附加最大为 5 MB 的文件。
注：
从 Survey123 外业应用程序提交的单个附件的最大文件大小为 10 MB。
应用于文件问题时，max-size 参数仅在 Survey123 Web 应用程序中受支持。 对于 ArcGIS Online，最大大小不能超过 500 MB；对于 ArcGIS Enterprise，最大大小不能超过 20 MB。
文件问题类型接受由 ArcGIS Online 和 ArcGIS Enterprise 支持的所有文件附件类型。 支持的文件类型如下：
| 类别 | 文件类型 |
|---|---|
归档 | 7Z、GTAR、GZ、TAR、TGZ、ZIP |
音频 | AIF、M4A、MID、MP2、MP3、MPA、RA、RAM、RMI、WAV、WMA |
数据 | CSV、GEODATABASE、GEOJSON、GML、GPKG*、JSON、MDB、PBF*、SD*、VRML、XML |
文档 | DOC、DOCX、DOT、PDF、PPT、PPTX、TXT、WPS、XLS、XLSX、XLT |
图像 | BMP、ECW、EMF、EPS、GIF、IMG、J2K、JP2、JPC、JPE、JPEG、JPF、JPG、PNG、PS、PSD、RAW、SID、TIF、TIFF、WMF |
视频 | AVI、MOV、MP4、MPE、MPEG、MPG、MPV2、QT、WMV |
*此附件类型在 ArcGIS Enterprise 中不受支持。
通过使用 body::accept 列，可以限制可提交给文件问题的文件类型。 此列允许文件扩展名（例如，.wav）和 MIME 类型（例如，audio/*）。 可以通过用逗号进行分隔来设置多个文件扩展名或 MIME 类型。
有关 MIME 类型可接受格式的信息，请参阅常见 MIME 类型的 Mozilla 列表。
图像
用户可以通过图像问题类型提交保存在其设备上的图像或使用其设备的相机拍摄的照片。
在 Survey123 中拍摄的照片将被保存为 .jpg 文件，质量级别取决于您的设备相机。 图像大小（以最长边的像素数进行衡量）可以在 Survey123 Studio 或 Survey123 Connect 中使用选项进行设置。 该大小可应用至调查中的所有图像问题。 可用选项如下：
- 320 像素
- 640 像素
- 1280 像素
- 1920 像素
- 无限制（可以将任意大小的照片附加至调查。）
默认图像大小为 1280 像素。 对于保存在设备上的图像，在提交后会保留其原始文件类型、分辨率和质量。
这些图像大小不会影响 Survey123 Mobile 或 Survey123 外业应用程序中提供的图像预览。
单个图像的默认最大文件大小为 10 MB。 对于 Survey123 Web 应用程序中的图像问题，可以使用 bind::esri:parameters 列中的 max-size 指定最大文件大小（以 MB 为单位）。 例如，max-size=5 允许用户附加最大为 5 MB 的图像。
注：
从 Survey123 外业应用程序提交的单个附件的最大文件大小为 10 MB。
应用于图像问题时，max-size 参数仅在 Survey123 Web 应用程序中受支持。 ArcGIS Online 的最大大小不能超过 100 MB，ArcGIS Enterprise 的最大大小不能超过 20 MB。
自定义图像大小和捕获方法
注：
本部分将介绍仅在 Survey123 外业应用程序中可用的功能。此功能在 Survey123 Mobile 中不可用。
您可以使用 previewHeight 参数控制 Survey123 外业应用程序中提供的图像预览大小。 该参数支持 height 参数支持的所有单位类型，但预览图像高度最终受限于设备的屏幕宽度和图像的纵横比。 使用 previewHeight=0 将图像预览设置为最大大小，而不留出不必要的空白空间。
可以为调查中的每个单个图像问题设置图像的最大允许大小。 在 XLSForm 的参数列中为您想要限制的问题指定 max-pixels。 例如，max-pixels=100 将图像最长边按比例缩小到 100 像素。 如果未指定 max-pixels 参数，则将使用在 Survey123 Connect 中设置的图像大小。
通过指定 XLSForm 的 body::esri:style 列的 method=camera 或 method=browse，可以将图像问题限制为特定的捕获方法。 您还可以将外观设置为 new-front 或 new-rear，以将图像问题限制为仅使用来自设备相机的图像，分别使用前置或后置相机作为默认设置。 使用 annotate 外观时，也可以指定 method=map。
外观
您可以通过设置外观来更改问题的行为及其呈现方式。 要确认哪些提交应用程序支持特定外观，请参阅外观表。
通过将外观列设置为 multiline，文件或图像问题可以在单个问题中接受多个附件。
此外观可以与其他外观组合，例如通过空格分隔设置两个外观，例如图像问题的 multiline annotate。
您可以使用 constraint 列中的 count-selected 函数来控制可提交的文件或图像数量。 示例如下：
- count-selected(${file_question}) <= 5 将可以提交的文件数量限制为最多五个。
- count-selected(${image_question}) <= 3 将可提交的图像数量限制为最多三个。
将外观设置为 signature 后，图像问题将可用于完成签名。
注：
在 Survey123 Connect 中，您还可以为与 Survey123 外业应用程序一起使用的调查中的图像问题设置以下外观：
- 通过将外观设置为 new-front 或 new-rear，您可以将图像问题仅限制为使用设备的照相机，并分别默认使用前置或后置照相机。 通过将两个外观均设置为以空格分隔（例如 new-front annotate），可以将这些外观与 annotate 进行组合。
- 通过将外观设置为 draw 或 annotate，您可以允许用户在照片上绘制内容或添加注记。
- 通过将外观设置为 spike，图像问题会显示一个按钮，用于打开 Spike 移动应用程序，将 Survey123 与 Spike 集成。 有关详细信息，请参阅 Spike 图像外观。
签名外观
在将外观设置为 signature 后，图像问题将显示一个弹出窗口，用于捕获签名。
签名将另存为 .jpg 图像附件，其尺寸与弹出窗口相同。 默认情况下，弹出窗口的宽度将拉伸为与设备屏幕宽度相同，固定高度为 200 像素。 要使用 max-pixels 参数设置此弹出窗口的最大宽度，请参阅自定义图像大小和捕获方法。
还可以在默认列中提供图像，以为签名设置自定义背景。 默认图像的尺寸决定了弹出窗口的横纵比。
弹出窗口的宽度将为以下各项中的最小值：
- max-pixels 值
- 默认图像的宽度
- 设备屏幕的宽度
高度将为 200 像素，除非提供了默认图像。
使用签名外观设计调查时，确保考虑所有目标设备的屏幕大小。
可以使用 body::esri:style 列中的 footerText 参数为签名问题的弹出窗口提供页脚文本。 通过仅使用不包含值的 footerText 参数，可将问题的指导提示显示在签名下方。 可以使用 footerText=@[hint] 将上述内容更改为问题提示。 用作页脚文本的提示或指导提示不会显示在问题名称下方的默认位置。 要了解有关提示的详细信息，请参阅提示。
注：
当应用于签名外观时，Survey123 Web 应用程序不支持多行、max-pixels 参数或默认值。
绘制和注记外观
注：
本部分将介绍仅在 Survey123 Connect 和 Survey123 外业应用程序中可用的功能。此功能在 Survey123 Studio 或 Survey123 Mobile 中不可用。
将外观设置为 draw 后，图像问题将显示一个按钮，用于加载要草绘的画布。 在绘制工具选项板中，您可以在绘制工具之间进行切换以及控制每个工具的设置，例如文本大小、线宽、颜色等。 有关画布界面的信息，请参阅 Draw 和 annotate。 您可以创建自定义工具板，以配置符合您需求的绘制和注记工具。 有关详细信息，请参阅绘制和注记板。
将外观设置为 annotate 后，图像问题将显示一个按钮，用于打开设备的相机以拍摄照片，可以使用图形和文本对照片进行注记。 在绘制工具选项板中，您可以在绘制工具之间进行切换以及控制每个工具的设置，例如文本大小、线宽、颜色等。 有关画布界面的信息，请参阅 Draw 和 annotate。 您可以创建自定义工具板，以配置符合您需求的绘制和注记工具。 有关详细信息，请参阅绘制和注记板。
提示：
在 Survey123 3.13 及更高版本中，EXIF 数据将从源图像复制到注记图像。
或者，您可以允许用户对设备存储中的现有图像或地图快照添加注记。 为此，将该问题的 body::esri:style 设置为 method=browse、method=camera 或 method=map。 annotate 外观的默认行为与提供 method=camera 的行为相同。 通过提供多个用逗号分隔的选项，您可以将问题设置为提供多个源图像选项，例如 method=camera,browse。
警告：
无论设置了哪种方法，Survey123 Web 应用程序仅显示浏览文件选项。
对于使用 draw 和 annotate 的图像问题，默认值和计算具有不同的表现形式。 如果调查的媒体文件夹中的图像文件名用作默认值或计算结果，则图像将用作画布的初始背景。 使用 annotate 时，此图像将替换为提供的图像，并且仅当用户明确拒绝提供图像或在已提供图像后重置图像时才会显示。
注：
您可以通过在 parameters 列中定义 max-pixels 值来设置图像的分辨率。 对于 draw 问题，设置 max-pixels=1000 会将画布设置为 1000 x 1000 像素的正方形图像。 对于 annotate 问题，设置 max-pixels=1000 会将图像的最长边设置为 1000 像素，同时保留所提供图像的纵横比。 如果未设置 max-pixels，则图像大小将由 Survey123 Connect 中调查的选项设置中的图像大小设置来定义。
通过为问题提供默认图像来覆盖这两种设置图像分辨率的方法，在这种情况下将应用默认图像的分辨率。 这可用于确保所有已提交图像的标准分辨率。 为注记提供地图快照还将覆盖任何其他图像分辨率设置，其中图像将设置为可查看画布区域的大小。
Spike 图像外观
注：
本部分将介绍仅在 Survey123 Connect 和 Survey123 外业应用程序中可用的功能。此功能在 Survey123 Studio 或 Survey123 Mobile 中不可用。
注：
Spike 集成不适用于 Survey123 web 应用程序。
图像问题还支持将 Survey123 与 Spike 进行集成的外观；Spike 是由 ikeGPS 开发的激光测量解决方案，可用于从照片中捕捉对象的测量值和位置。 将外观设置为 spike、spike-full-measure 或 spike-point-to-point 后，图像问题将显示一个按钮，用于在 iOS 和 Android 设备上打开 Spike 移动应用程序。
如果照片是使用 Spike 应用程序和激光设备拍摄的，则您可以记录对象的坐标和距离，并通过绘制面和线来测量照片中对象的尺寸。 随后带有测量标记的照片将附加到您的调查中，且您可以记录来自照片的元数据（如坐标和测量值）。 您可以通过标准的可交换图像文件 (EXIF) 标签将相关的 Spike 和测量元数据记录在图像文件中。 随后即可提取 EXIF 信息并将其用于填充其他字段。
Spike 外观之间的区别在于图像中存储的值的范围。 spike 外观将仅测量距离和位置，而 spike-full-measure 外观将测量距离、位置、面积和长度。 spike-point-to-point 外观将捕获一系列其独有的值，表示为以 P2P 开头的属性名称。
有关这些 EXIF 标签的详细信息，请参阅 Spike 集成。 有关 Spike 的详细信息，请参阅 Spike 网站。
提取图像元数据
您可以使用 pulldata("@exif") 函数从对图像问题的响应中提取标准的可交换图像文件 (EXIF) 元数据标签。 如果将以下示例输入为小数问题，则系统将从图像中提取设备纬度值：
pulldata("@exif", ${image}, "GpsLatitude")
可与 pulldata("@exif") 函数一起使用的常见位置 EXIF 标签如下表所示：
| EXIF 标签 | 描述 |
|---|---|
| GpsLatitude | 设备位置的纬度为字符串 |
| GpsLongitude | 设备位置的经度为字符串 |
| GpsAltitude | 设备位置的高度为字符串 |
| GpsLatitudeRef | 设备位置的纬度参考（即 N、E、S、W）为字符串 |
| GpsLongitudeRef | 设备位置的经度参考（即 N、E、S、W）为字符串 |
| GpsDestDistance | 设备与目标位置之间的距离（以公里为单位）为整数 |
| GpsImgDirection | 从设备位置到目标位置的方向为字符串 |
| GpsDestLatitude | 目标位置的纬度为字符串 |
| GpsDestLongitude | 目标位置的经度为字符串 |
| GpsDestLatitudeRef | 目标位置的纬度参考（即 N、E、S、W）为字符串 |
| GpsDestLongitudeRef | 目标位置的经度参考（即 N、E、S、W）为字符串 |
可使用以下示例在单个字段中显示纬度和经度值，然后您可以将其用于填充地理点问题：
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
以下列出了 Survey123 可以提取的其他图像 EXIF 标签： 并非所有这些标签都可用，具体取决于所使用的硬件。
| EXIF 标签 | ||
|---|---|---|
GpsAltitudeRef | GpsTimeStamp | GpsSatellites |
GpsStatus | GpsMeasureMode | GpsDop |
GpsSpeedRef | GpsSpeed | GpsTrackRef |
GpsTrack | GpsImgDirectionRef | GpsMapDatum |
GpsDestBearingRef | GpsDestBearing | GpsDestDistanceRef |
GpsProcessingMethod | GpsAreaInformation | GpsDateStamp |
GpsVersionId | GpsDifferential | GpsHPositioningError |
ImageWidth | ImageLength | ImageBitsPerSample |
ImageCompression | ImagePhotometricInterpretation | ImageDescription |
ImageMake | ImageModel | ImageStripOffsets |
ImageOrientation | ImageSamplesPerPixel | ImageRowsPerStrip |
ImageStripByteCounts | ImageXResolution | ImageYResolution |
ImagePlanarConfiguration | ImageResolutionUnit | ImageTransferFunction |
ImageSoftware | ImageDateTime | ImageArtist |
ImageWhitePoint | ImagePrimaryChromaticities | ImageYCbCrCoefficients |
ImageYCbCrSubSampling | ImageYCbCrPosition | ImageReferenceBlackWhite |
ImageRating | ImageRatingPercent | ImageCopyright |
ImageXPTitle | ImageXPComment | ImageXPAuthor |
ImageXPKeywords | ImageXPSubject | ImageLensSpecification |
ImageLensModel | ImageLensMake | ImageLensSerialNumber |
ExtendedSubjectDistanceRange | ExtendedExposureTime | ExtendedFNumber |
ExtendedExposureProgram | ExtendedSpectralSensitivity | ExtendedISOSpeedRatings |
ExtendedOecf | ExtendedExifVersion | ExtendedDateTimeOriginal |
ExtendedDateTimeDigitized | ExtendedComponentsConfiguration | ExtendedCompressedBitsPerPixel |
ExtendedShutterSpeedValue | ExtendedApertureValue | ExtendedBrightnessValue |
ExtendedExposureBiasValue | ExtendedMaxApertureValue | ExtendedSubjectDistance |
ExtendedMeteringMode | ExtendedLightSource | ExtendedFlash |
ExtendedFocalLength | ExtendedSubjectArea | ExtendedMakerNote |
ExtendedUserComment | ExtendedSubSecTime | ExtendedSubSecTimeOriginal |
ExtendedSubSecTimeDigitized | ExtendedFlashPixVersion | ExtendedColorSpace |
ExtendedPixelXDimension | ExtendedPixelYDimension | ExtendedRelatedSoundFile |
ExtendedFlashEnergy | ExtendedSpatialFrequencyResponse | ExtendedFocalPlaneXResolution |
ExtendedFocalPlaneYResolution | ExtendedFocalPlaneResolutionUnit | ExtendedSubjectLocation |
ExtendedExposureIndex | ExtendedSensingMethod | ExtendedFileSource |
ExtendedSceneType | ExtendedCfaPattern | ExtendedCustomRendered |
ExtendedExposureMode | ExtendedWhiteBalance | ExtendedDigitalZoomRatio |
ExtendedFocalLengthIn35mmFilm | ExtendedSceneCaptureType | ExtendedGainControl |
ExtendedContrast | ExtendedSaturation | ExtendedSharpness |
ExtendedDeviceSettingDescription | ExtendedImageUniqueId | |
有关这些标签的详细信息，请参阅 Survey123 Connect 中的 EXIF 示例。
警告：
如果一个图像问题包含多个图像，则无法使用 pulldata("@exif") 函数从图像中提取 EXIF 数据。 要从提交到同一问题的多个图像中提取 EXIF 数据，请考虑使用重复函数。
Spike 集成
注：
本部分将介绍仅在 Survey123 Connect 中可用的功能。 此功能在 Survey123 Studio 中不可用。
图像问题还支持与 Spike 激光测量解决方案进行集成；该解决方案由 ikeGPS 开发，可供您从照片中捕捉对象的测量值和位置。 有关如何将 Spike 与 Survey123 结合使用的信息，请参阅 Spike 图像外观。
Spike 可通过将 JSON 对象写入 ImageDescription EXIF 标签来记录一些额外的自定义标签，其中包含与 Spike 设备相关的非标准属性及其所采用的测量值。 标签将在下面的表格中进行介绍：
| Spike 标签 | 描述 |
|---|---|
| device_id | Spike 设备的 ID 为字符串 |
| local_accuracy | Spike 设备的精度为小数 |
| destination_altitude | 目标位置的高度为有理数 |
| declination | Spike 设备的偏角为有理数 |
| pitch | Spike 设备的仰俯角为有理数 |
| rotation | Spike 设备的旋转为字符串 |
| objects | 被测对象（面积和长度）的 JSON 数组为字符串 |
| P2P.capture_id | 点对点进程的两个图像的 ID 为字符串 |
| P2P.horizontal_distance | 两点间的水平距离（以米为单位） |
| P2P.distance | 两点间的距离（以米为单位） |
| P2P.gradient | 两点间的坡度（以度为单位） |
| P2P.vertical_distance | 两点间的垂直距离（以米为单位） |
| P2P.azimuth | 两点的方位角（以度为单位） |
要访问这些 Spike 标签，首先请使用 objects 属性上的 pulldata("@exif") 提取存储在 EXIF 中的 JSON 对象，如下所示：
pulldata("@exif", ${image}, "objects")
如果此 JSON 对象位于其他字段中，则您可以在 pulldata("@json") 函数中使用 Spike. 对象名称路径从 JSON 数组中提取特定值。 有关 pulldata("@json") 函数的详细信息，请参阅从 JSON 中检索值。 以下示例将从内部具有数组的问题中提取 Spike 设备的仰俯角：
pulldata("@json", ${spikedata}, "Spike.pitch")
objects 数组还包含由 Spike 设备捕获的面积和长度。 此数组中包含图像中的被测对象，其中包括形状和线，以及用于图像转换的对齐形状。 数组中的对象可通过引用其在数组中的位置进行提取，提取顺序与它们被捕获的顺序相一致。 以下示例将返回数组中的第一个面或线：
pulldata("@json", ${spikedata}, "Spike.objects[1].type")
注：
数组中的位置 0 将始终包含对齐形状。
要返回存在于数组中的对象的数量，请使用 length 属性，如下所示：
pulldata("@json", ${spikedata}, "Spike.objects.length")
要查看当前使用的这些标签的示例，请参阅 Survey123 Connect 中的 Spike 示例调查。 有关 Spike 的详细信息，请访问 ikeGPS 产品页面。
关键字
Survey123 使用附件关键字将附件与调查中的特定问题相关联。 当在调查中创建图像、音频或文件问题并发布调查时，问题名称将用作附件表中的关键字。 例如，如果调查包含名为 image_closeup 和 image_wideview 的图像问题，则对于每张照片，附件表的 KEYWORDS 列中存储的值将为 image_closeup 或 image_wideview。 Survey123 会自动匹配附件关键字与问题名称以将附件关联到问题。
关键字关联的作用在打印报告时作为明显，Survey123 确保在对调查中的正确问题作出响应时打印正确的照片。 关键字关联还用于支持在收件箱中编辑图像。
如果您更改了图像名称并重新发布调查，则还必须更改任何现有附件记录的关键字。
警告：
在导出 Survey123 数据后，不会保留附件表的 KEYWORDS 列。
如果随后将此数据重新发布为托管要素服务，则您具有一个图像问题，并且默认文件名已用于附件，您可以使用更新附件关键字 Python 笔记本重新填充 KEYWORDS 列。 如果您的调查中包含多个图像问题，则您无法使用笔记本，必须手动确定哪个文件与哪个问题相关联，然后在每个附件记录的 KEYWORDS 列中输入问题名称。 有关详细信息，请参阅技术支持文章。
如果数据重新发布为 ArcGIS Server 要素服务，则首先必须将 KEYWORDS 列添加至附件表。 可以使用升级附件工具添加此列。 如果您具有一个图像问题并且默认文件名已用于附件，则您可以使用更新附件关键字 Python 笔记本重新填充 KEYWORDS 列。 如果您的调查中包含多个图像问题，则您无法使用笔记本，必须手动确定哪个文件与哪个问题相关联，然后在每个附件记录的 KEYWORDS 列中输入问题名称。 有关详细信息，请参阅技术支持文章。
在任一环境中，当您接下来在 Survey123 中查看这些记录时，附件表中的关键字值将与问题名称性匹配，并自动进行关联。
自定义文件名
注：
本部分将介绍仅在 Survey123 Connect 和 Survey123 外业应用程序中可用的功能。此功能在 Survey123 Studio 或 Survey123 Mobile 中不可用。
默认情况下，Survey123 将自动为问题中提交的媒体生成文件名。 您可以自定义文件名使其更加有意义。 例如，您可以在签名文件的名称中包含签名者的名字和姓氏。 对于照片，您可以在其中包含日期或所拍摄对象的描述信息。
警告：
在 Web 应用程序中，图像、音频和文件问题支持自定义文件名。 在外业应用程序中，仅图像问题支持自定义文件名。
自定义的文件名会在将文件添加至媒体问题时设置，不会自动更新以反映调查中的后续更改。 例如，如果文件名引用文本问题并且该问题的值在添加文件后发生变化，则不会更新文件名来反映更改。
您可以使用 bind::esri:parameters 列中的 fileName 参数来动态设置要创建的文件的文件名。 在以下示例中，根据 asset_id 问题和当前日期和时间创建了一个类似于 ASSET406-20221018145109.jpg 的图像文件名：
有关其他语法示例，请参阅 Survey123 Connect 中的图像和注释示例。
文件名必须符合以下要求：
- 设备上所有调查中的所有问题必须具有唯一的文件名。 我的调查附件文件夹用于存储设备上所有调查的所有图像，并且不能包含重复的文件名。 要确保文件名是唯一的，请考虑在 fileName 表达式中使用 now() 函数。
- 文件名的长度不能超过 140 个字符。
- 文件名不能包含空格或以下特殊字符：\ / : * ? < > ; | . , "。 将使用下划线替换空格和特殊字符。
警告：
在 Web 应用程序中，如果因 fileName 参数表达式或手动编辑文件名而导致重复，则将在新文件名中追加递增数字。
在外业应用程序中，如果 fileName 参数的表达式导致文件名重复或超过最大长度，则将使用为图像自动生成的图像文件名。 同样，如果用户在调查中手动编辑文件名，当文件名重复或超过最大长度时，其将不被接受。
可以在问题的 body::esri:style 列中应用以下参数，以进一步控制文件名：
- fileNameVisible - 指定文件的名称在调查中是否可见。 默认值为 true。 要隐藏文件名，输入 fileNameVisible=false。
- allowRename - 指定是否允许用户手动编辑文件名。 默认值为 true。 当 fileNameVisible=false 时，用户无法编辑文件名，尽管 allowRename=true。