현장조사에 이미지, 오디오, 파일 질문을 포함하여 사용자가 현장조사 응답과 함께 첨부 파일을 제출하도록 할 수 있습니다.
팁:
참조 및 스타일 지정을 위해 이미지와 오디오를 현장조사의 기타 질문에 추가할 수도 있습니다. 자세한 내용은 현장조사에 미디어 추가를 참고하세요.
기본 설정에 따라 이미지, 오디오, 파일 질문에는 하나의 첨부 파일이 허용됩니다. 모양 열에서 질문 모양을 다중 행으로 설정하여 여러 첨부 파일을 포함할 수 있습니다.
이미지
이미지 질문 유형을 통해 사용자는 기기에 저장된 이미지 또는 기기 카메라로 촬영한 사진을 제출할 수 있습니다.
Survey123에서 촬영한 사진은 .jpg 파일로 저장되며 품질 수준은 기기 카메라에 따라 다릅니다. 이미지 크기는 가장 긴 가장자리의 픽셀 수로 측정되며, Survey123 Connect의 옵션 탭에서 설정할 수 있습니다. 이 크기는 현장조사의 모든 이미지 질문에 적용됩니다. 다음과 같은 옵션이 제공됩니다.
- 320픽셀
- 640픽셀
- 1280픽셀
- 1920픽셀
- 제한 없음(어떤 크기의 사진이든 현장조사에 첨부할 수 있음)
기본 이미지 크기는 1280픽셀입니다. 기기에 저장되어 있었던 제출된 이미지는 기존 파일 형식, 해상도 및 품질이 그대로 유지됩니다.
해당 이미지 크기는 Survey123 현장 앱에 제공된 이미지 미리 보기에 영향을 주지 않으며 previewHeight 매개변수로 제어할 수 있습니다. 이 매개변수는 height 매개변수가 지원하는 모든 단위 유형을 지원하지만, 이미지 미리 보기 높이는 최종적으로 기기의 화면 너비와 이미지의 경사면 방향 비율로 제한됩니다. 이미지 미리 보기에서 불필요한 공백을 제거해 최대 크기로 설정하려면 previewHeight=0을 사용합니다.
현장조사의 각 개별 이미지 질문에 대해 허용되는 최대 이미지 크기를 설정할 수 있습니다. 제한하려는 질문에 대해 XLSForm의 매개변수 열에서 max-pixels을(를) 지정합니다. 예를 들어 max-pixels=100의 경우 해당 이미지의 가장 긴 가장자리가 100픽셀이 되도록 비율이 계산되어 축소됩니다. max-pixels 매개변수가 지정되지 않은 경우, Survey123 Connect에 설정된 이미지 크기를 사용합니다.
XLSForm의 body::esri:style 열에 method=camera 또는 method=browse을(를) 지정하여 이미지 질문을 특정 캡처 방법으로 제한할 수 있습니다. 모양을 새 전면 또는 새 후면으로 설정하여 이미지 질문이 기기 카메라의 이미지만 사용하도록 제한할 수도 있으며, 각각 전면 또는 후면 카메라를 기본값으로 사용합니다. 애노테이트(annotate) 모양이 사용된 경우에는 method=map을 지정할 수도 있습니다.
개별 이미지의 기본 최대 파일 크기는 10MB입니다. Survey123 웹 앱 내 이미지 질문의 경우 bind::esri:parameters 열에서 max-size을(를) 사용하여 최대 파일 크기(메가바이트)를 지정할 수 있습니다. 예를 들어 max-size=5로 지정하면 사용자가 최대 5MB의 이미지를 첨부할 수 있습니다.
비고:
Survey123 현장 앱에서 제출된 개별 첨부 파일의 최대 파일 크기는 10MB입니다.
이미지 질문에 적용된 경우 max-size 매개변수는 Survey123 웹 앱에서만 지원됩니다. 최대 크기는 ArcGIS Online의 경우 100MB를, ArcGIS Enterprise의 경우 20MB를 초과할 수 없습니다.
이미지(Image) 질문은 사진에 주석을 달거나 캔버스에 그리거나 서명할 수 있는 다른 모양을 지원합니다. 자세한 내용은 모양을 참고하세요.
기본 설정에 따라 Survey123은 질문에 제출된 이미지에 대해 파일 이름을 자동으로 생성합니다. 파일 이름에는 질문 이름이 접두어로 포함되며 그 다음에는 고유 번호가 옵니다. 일부 질문의 경우 파일 이름을 사용자 정의하여 의미 있는 이름을 지정하려고 할 수 있습니다. 자세한 내용은 파일 이름 사용자 정의를 참고하세요. 현장조사 데이터를 내보내고 Survey123에서 다시 사용하기 위해 피처 레이어로 발행한 경우, 파일 이름을 사용자 정의하지 않는 것을 권장합니다. 자세한 내용은 키워드를 참고하세요.
이미지 메타데이터 추출
pulldata("@exif") 함수를 사용하여 표준 EXIF(Exchangeable Image File) 메타데이터 태그를 응답에서 이미지 질문으로 추출할 수 있습니다. 다음 예시를 소수 질문에 입력하면 이미지에서 기기 위도 값이 추출됩니다.
pulldata("@exif", ${image}, "GpsLatitude")
다음 테이블에는 pulldata("@exif") 함수에 주로 사용되는 위치 EXIF 태그가 나와 있습니다.
| EXIF 태그 | 설명 |
|---|---|
| GpsLatitude | 기기 위치의 위도를 문자열로 반환합니다. |
| GpsLongitude | 기기 위치의 경도를 문자열로 반환합니다. |
| GpsAltitude | 기기 위치의 고도를 문자열로 반환합니다. |
| GpsLatitudeRef | 기기 위치의 위도 참조(N, E, S, W)를 문자열로 반환합니다. |
| GpsLongitudeRef | 기기 위치의 경도 참조(N, E, S, W)를 문자열로 반환합니다. |
| GpsDestDistance | 기기와 대상 위치의 거리를 정수(km)로 반환합니다. |
| 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 태그가 아래에 나와 있습니다. 사용 중인 하드웨어에 따라 추출할 수 없는 태그도 있습니다.
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 통합
이미지 질문은 또한 ikeGPS가 개발한 레이저 측정 솔루션인 Spike와의 통합을 지원하여 사진에서 객체의 위치 및 측정을 취득할 수 있습니다. Spike과 함께 Survey123를 사용하는 방법에 대한 자세한 내용은 모양을 참고하세요.
Spike는 JSON 객체를 Spike 기기와 관련된 비표준 속성과 측정값을 포함하는 ImageDescription EXIF 태그에 작성하여 추가 사용자 설정 태그의 수를 기록합니다. 태그는 다음 테이블에 설명되어 있습니다.
| 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에서 오디오를 녹음하고 업로드할 수 있습니다. 녹음은 기기의 기본 오디오 캡처 형식을 사용하여 오디오 파일을 캡처합니다. 진행률 표시줄은 남은 녹음 시간을 나타냅니다. 사용자는 언제든지 녹음을 일시 중지하거나 중단할 수 있습니다. 녹음이 완료되면 파일 이름을 선택하여 편집할 수 있습니다.
비고:
Android에서는 현장 앱에서 녹음 중인 오디오를 일시 중지하는 기능이 지원되지 않습니다.
기존 오디오 파일을 업로드하는 기능은 현장 앱에서 지원되지 않습니다.
기본 설정에 따라 오디오 녹음은 현장 앱에서 최대 파일 크기 10MB, 웹 앱에서 10분으로 제한됩니다.
bind::esri:parameters 열에서 max-size 매개변수를 사용하여 크기 하한값(메가바이트)을 설정할 수 있습니다. 이 최대 파일 크기에 도달하면 녹음이 자동으로 중단됩니다. 예를 들어 max-size=5로 설정하면 사용자가 최대 5MB의 오디오를 녹음할 수 있습니다.
또는 bind::esri:parameters 열에서 max-duration 매개변수를 사용하여 시간 제한(초)을 지정할 수 있습니다. 이 최대 길이에 도달하면 녹음이 자동으로 중단됩니다. 예를 들어 max-duration=30으로 지정하면 사용자가 최대 30초의 오디오를 녹음할 수 있습니다.
주의:
Survey123 현장 앱에서 제출된 개별 첨부 파일의 최대 파일 크기는 10MB입니다. 설정하는 max-duration 또는 max-size 값으로 인해 오디오 파일이 최대 파일 크기를 초과하지 않는지 확인해야 합니다.기본 설정에 따라 오디오 파일은 기기에서 지원되는 경우 AAC(Advanced Audio Coding) 코덱을 사용하여 iOS 및 Android 기기에 인코딩됩니다. bind::esri:parameters 열에서 codec 매개변수를 사용하여 기본 오디오 코덱을 지정할 수 있습니다. 여러 코덱을 쉼표로 구분하여 제공할 수 있습니다(예시: codec=amr-nb,aac). 기기와 호환되는 첫 번째 코덱이 사용됩니다.
비고:
기기에서 지원하는 코덱은 Survey123 현장 앱의 정보 페이지에 나와 있습니다. 정보 페이지 상단의 ArcGIS Survey123 정보 제목을 길게 누르면 지원하는 오디오 코덱을 포함하여 기기에 대한 추가 정보가 표시됩니다. Windows 기기의 경우 오디오 파일은 항상 압축 해제된 WAV 형식으로 녹음됩니다.
일부 코덱은 브라우저에서 지원되지 않으므로 일부 오디오 파일은 웹 브라우저에서 재생하지 못할 수 있습니다. 웹의 오디오 코덱에 대한 자세한 내용은 Mozilla 개발자 네트워크 문서를 참고하세요.
파일 질문을 사용하여 기기에 저장된 오디오 파일을 제출할 수도 있습니다. 지원되는 오디오 파일 형식 목록은 파일을 참고하세요.
기본 설정에 따라 Survey123은 질문에 제출된 오디오에 대해 파일 이름을 자동으로 생성합니다. 파일 이름에는 질문 이름이 접두어로 포함되며 그 다음에는 고유 번호가 옵니다. 일부 질문의 경우 파일 이름을 사용자 정의하여 의미 있는 이름을 지정하려고 할 수 있습니다. 자세한 내용은 파일 이름 사용자 정의를 참고하세요. 현장조사 데이터를 내보내고 Survey123에서 다시 사용하기 위해 피처 레이어로 발행한 경우, 파일 이름을 사용자 정의하지 않는 것을 권장합니다. 자세한 내용은 키워드를 참고하세요.
파일
파일 질문 유형을 사용하면 사용자가 다양한 파일 유형을 제출할 수 있습니다.
개별 파일의 기본 최대 크기는 10MB입니다. Survey123 웹 앱 파일 질문의 경우 bind::esri:parameters 열에서 max-size을(를) 사용하여 최대 파일 크기(메가바이트)를 지정할 수 있습니다. 예를 들어 max-size=5로 지정하면 사용자가 최대 5MB의 파일을 첨부할 수 있습니다.
비고:
Survey123 현장 앱에서 제출된 개별 첨부 파일의 최대 파일 크기는 10MB입니다.
파일 질문에 적용된 경우 max-size 매개변수는 Survey123 웹 앱에서만 지원됩니다. 최대 크기는 ArcGIS Online의 경우 500MB를, ArcGIS Enterprise의 경우 20MB를 초과할 수 없습니다.
기본 설정에 따라 파일 질문에는 하나의 파일이 허용됩니다. 모양 열로 다중 행을 사용하여 파일 질문에 여러 파일을 첨부할 수 있습니다.
파일 질문 유형은 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 유형에 허용되는 형식에 대한 정보는 Mozilla 일반적인 MIME 유형 목록을 참고하세요.
기본 설정에 따라 Survey123은 질문에 제출된 파일에 대해 파일 이름을 자동으로 생성합니다. 파일 이름에는 질문 이름이 접두어로 포함되며 그 다음에는 고유 번호가 옵니다. 파일 이름을 사용자 정의하여 의미 있는 이름을 지정할 수 있습니다. 자세한 내용은 파일 이름 사용자 정의를 참고하세요. 현장조사 데이터를 내보내고 Survey123에서 다시 사용하기 위해 피처 레이어로 발행한 경우, 파일 이름을 사용자 정의하지 않는 것을 권장합니다. 자세한 내용은 키워드를 참고하세요.
키워드
Survey123은 첨부 파일 키워드를 사용하여 현장조사에 특정 질문이 있는 첨부 파일을 연결합니다. 현장조사에서 이미지, 오디오 또는 파일 질문을 만들고 발행하면 질문 이름이 첨부 파일 테이블에서 키워드로 사용됩니다. 예를 들어, 현장조사에 image_closeup 및 image_wideview라는 이미지 질문이 포함된 경우, 첨부 파일 테이블의 KEYWORDS 열에 저장된 값은 각 사진에 대해 image_closeup 또는 image_wideview입니다. Survey123은 첨부 파일 키워드를 질문 이름과 자동으로 일치시켜 첨부 파일을 질문에 연결합니다.
키워드 연결의 목적은 보고서를 인쇄할 때 가장 잘 드러납니다. 이를 통해 Survey123이 현장조사의 올바른 질문에 대한 응답으로 올바른 사진을 인쇄할 수 있습니다. 키워드 연결은 수신함에서 이미지 편집을 허용하는 데도 사용됩니다.
이미지 질문의 이름을 변경하고 현장조사를 다시 발행하면 기존 첨부 파일 레코드의 키워드도 변경해야 합니다.
주의:
Survey123 데이터를 내보내면 첨부 파일 테이블의 KEYWORDS 열은 유지되지 않습니다.
이후 이 데이터가 호스팅 피처 서비스로 다시 발행되고, 이미지 질문이 1개 있고, 첨부 파일에 기본 파일 이름이 사용된 경우 첨부 파일 키워드 업데이트 Python Notebook을 사용하여 KEYWORDS 열을 다시 채울 수 있습니다. 현장조사에 이미지 질문이 2개 이상 있는 경우 Notebook을 사용할 수 없으며, 어떤 파일이 어떤 질문과 연결되는지 수동으로 판단하고 각 첨부 파일 레코드에 대해 KEYWORDS 열에 질문 이름을 입력해야 합니다. 자세한 내용은 이 기술지원 문서를 참고하세요.
데이터가 ArcGIS Server 피처 서비스로 다시 발행되는 경우, 먼저 첨부 파일 테이블에 KEYWORDS 열을 추가해야 합니다. 첨부 파일 업그레이드 도구를 사용하여 이 열을 추가할 수 있습니다. 이미지 질문이 1개 있고 첨부 파일에 기본 파일 이름이 사용된 경우, 첨부 파일 키워드 업데이트 Python Notebook을 사용하여 KEYWORDS 열을 다시 채울 수 있습니다. 현장조사에 이미지 질문이 2개 이상 있는 경우 Notebook을 사용할 수 없으며, 어떤 파일이 어떤 질문과 연결되는지 수동으로 판단하고 각 첨부 파일 레코드에 대해 KEYWORDS 열에 질문 이름을 입력해야 합니다. 자세한 내용은 이 기술지원 문서를 참고하세요.
두 환경 모두 다음에 Survey123에서 이러한 레코드를 볼 때는 첨부 파일 테이블의 키워드 값이 질문 이름과 일치하며 연결이 자동으로 이루어집니다.
파일 이름 사용자 정의
기본 설정에 따라 Survey123은 질문에 제출된 이미지, 오디오, 파일에 대해 파일 이름을 자동으로 생성합니다. 파일 이름에는 질문 이름이 접두어로 포함되며 그 다음에는 고유 번호가 옵니다. 파일 이름을 사용자 정의하여 의미 있는 이름을 지정할 수 있습니다. 예를 들어 서명 파일 이름에 서명자의 이름과 성을 포함할 수 있습니다. 사진의 경우 날짜나 피사체의 설명자를 포함할 수 있습니다.
주의:
사용자 정의된 파일 이름은 웹 앱의 이미지, 오디오, 파일 질문에 대해 지원됩니다. 사용자 정의된 파일 이름은 현장 앱의 이미지 질문에 대해서만 지원됩니다.
사용자 정의된 파일 이름은 파일이 미디어 질문에 추가되면 지정되며, 현장조사의 이후 변경 사항을 반영하도록 자동으로 업데이트되지 않습니다. 예를 들어 파일 이름이 텍스트 질문을 참조하며 파일이 추가된 후 해당 질문의 값이 변경되는 경우, 파일 이름은 변경 사항을 반영하도록 업데이트되지 않습니다.
bind::esri:parameters 열에서 fileName 매개변수를 사용하여 생성할 파일 이름을 동적으로 설정할 수 있습니다. 다음 예시에서 asset_id 질문, 현재 날짜와 시간을 사용하여 ASSET406-20221018145109.jpg과(와) 유사한 이미지 파일 이름이 생성됩니다.
더 많은 구문 예시는 Survey123 Connect의 이미지 및 애노테이션 샘플을 참고하세요.
파일 이름은 다음을 따라야 합니다.
- 파일 이름은 기기에 있는 모든 현장조사의 모든 질문에 대해 고유해야 합니다. 내 현장조사 첨부 파일 폴더에는 기기에 있는 모든 현장조사의 모든 이미지가 저장되므로 중복 파일 이름을 포함할 수 없습니다. 파일 이름이 고유한지 확인하려면 now() 식에 fileName와 같은 함수를 사용하세요.
- 파일 이름은 140자를 넘을 수 없습니다
- 파일 이름은 공백이나 특수 문자(\ / : * ? < > ; | . , ")를 포함할 수 없습니다. 공백과 특수 문자는 밑줄로 교체됩니다.
주의:
현장 앱에서 fileName 매개변수의 식으로 생성된 파일 이름이 중복되거나 최대 길이를 초과하는 경우 해당 이미지에 대해 자동 생성된 파일 이름이 사용됩니다. 마찬가지로 사용자가 현장조사의 파일 이름을 수동으로 편집하는 경우 중복되거나 최대 길이를 초과하는 파일 이름은 허용되지 않습니다.
웹 앱에서 fileName 매개변수의 식 또는 수동 편집으로 생성된 파일 이름이 중복되는 경우 새 파일 이름에 증분된 숫자가 추가됩니다.
다음 매개변수를 질문의 body::esri:style 열에 적용하여 파일 이름을 추가로 제어할 수 있습니다.
- fileNameVisible — 파일 이름이 현장조사에 표시되는지 여부를 지정합니다. 기본값은 true입니다. 파일 이름을 숨기려면 fileNameVisible=false를 입력합니다.
- allowRename — 사용자가 파일 이름을 수동으로 편집할 수 있는지 여부를 지정합니다. 기본값은 true입니다. fileNameVisible=false인 경우 allowRename=true라도 사용자는 파일 이름을 편집할 수 없습니다.