Вы можете включить в опросы вопросы типа медиа (с изображениями, аудио или файлами), чтобы пользователи могли отправлять вложения со своими ответами на опрос.
Подсказка:
Изображения и аудио также можно добавлять к другим вопросам в опрос для справки или в целях настройки оформления. Более подробную информацию см. в разделе Добавление медиа в опрос.
По умолчанию в вопросах типа медиа допускается одно вложение. Чтобы разрешить несколько вложений, настройте их оформление.
По умолчанию Survey123 автоматически создает имя файла для медиа, содержащихся в вопросе. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Вы можете изменить имена файлов, чтобы сделать их более понятными. Подробнее см. Настройка имен файлов. Если данные опроса экспортируются и публикуются как векторный слой, для повторного использования в Survey123 рекомендуется не изменять имена файлов. Дополнительные сведения см. в разделе Ключевые слова.
Аудио
Вопрос типа Аудио позволяет записывать аудио в Survey123. Строка состояния показывает оставшееся время записи. Пользователи могут приостановить или завершить запись в любой момент. По завершении записи они могут отредактировать имя файла.
Примечание:
В полевом приложении Survey123 приостановка аудио во время записи невозможна в Android.
По умолчанию максимальный размер аудиозаписи ограничен 10 МБ в Survey123 Mobile и полевом приложении Survey123 и 10 минутами в веб-приложении Survey123.
Можно задать различный размер в мегабайтах с помощью параметра max-size в столбце bind::esri:parameters. Запись автоматически останавливается при достижении максимального размера файла. Например, max-size=5 позволит пользователю записывать до 5 МБ аудио.
Можно, кроме того, задать время в секундах в параметре max-duration в столбце bind::esri:parameters. Запись автоматически останавливается при достижении максимальной продолжительности. Например, max-duration=30 позволит пользователю записывать до 30 секунд аудио.
Внимание:
В полевом приложении Survey123 максимальный размер файла для отдельного вложения составляет 10 МБ. Убедитесь, что установленное вами значение max-duration или max-size не приведет к тому, что аудиофайл превысит максимальный размер файла.
Можно задать подходящие аудиокодеки в параметре codec в столбце bind::esri:parameters. Можно ввести несколько кодеков, разделенных запятыми, например, codec=amr-nb,aac. Используется первый кодек, совместимый с устройством.
Примечание:
Аудиофайлы в Survey123 Mobile кодируются по умолчанию кодеком Advanced Audio Coding (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 без сжатия.
Воспроизведение некоторых аудиофайлов в веб-браузере может оказаться невозможным, поскольку не все кодеки поддерживаются браузерами. Дополнительную информацию об аудиокодеках в интернете можно найти в документации Mozilla Developer Network.
Для аудиовопросов в веб-приложении допускается только загрузка уже существующего аудиофайла. Вы также можете отправить аудио-файл, хранящийся на вашем устройстве, с помощью вопроса-файла. Список поддерживаемых типов аудио файлов см. в разделе Файлы.
Файлы
Примечание:
В этом разделе описывается функциональность, доступная только в Survey123 Connect и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Studio или Survey123 Mobile.
Вопрос типа Файл позволяет пользователям отправлять разные типы файлов.
Максимальный размер файла по умолчанию для отдельного изображения составляет 10 МБ. Для вопросов типа Файл в веб-приложении Survey123 можно задать максимальный размер файла в мегабайтах, используя max-size в столбце bind::esri:parameters. Например, max-size=5 позволяет пользователям прикреплять файл размером до 5 МБ.
Примечание:
Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ.
При применении к вопросам типа Файл параметр max-size поддерживается только в веб-приложении Survey123. Максимальный размер не может превышать 500 МБ для ArcGIS Online и 20 МБ для ArcGIS Enterprise.
Тип вопроса-файла принимает все типы вложения файлов, поддерживаемые 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 МБ. Для вопросов типа изображение в веб-приложении Survey123 можно задать максимальный размер файла в мегабайтах, используя max-size в столбце bind::esri:parameters. Например, max-size=5 позволяет пользователям прикреплять изображение размером до 5 МБ.
Примечание:
Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ.
При применении к вопросам типа Изображение параметр max-size поддерживается только в веб-приложении Survey123. Максимальный размер файла не может превышать 100 МБ для ArcGIS Online и 20 МБ для ArcGIS Enterprise.
Настройка размера изображения и способа захвата
Примечание:
В этом разделе описывается функциональность, доступная только в и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Mobile.
Размер предварительного просмотра изображения, отображаемого в полевом приложении Survey123, можно регулировать с помощью параметра previewHeight. Этот параметр поддерживает все типы устройств, поддерживаемые параметром height, но высота изображения предварительного просмотра в конечном счете ограничена шириной экрана устройства и соотношением сторон изображения. Используйте previewHeight=0, чтобы установить максимальный размер изображения предварительного просмотра без ненужных пробелов.
Вы можете установить максимально допустимый размер изображения для каждого отдельного вопроса типа Изображение в опросе. Укажите max-pixels в столбце parameters в XLSForm для вопроса, которому вы хотите задать ограничение. Например, max-pixels=100 уменьшает масштаб изображения пропорционально 100 пикселам по самому длинному краю. Если параметр max-pixels не указан, используется размер изображения, установленный в Survey123 Connect.
Вопрос типа изображение может быть ограничен конкретным методом получения, задав method=camera или method=browse в столбце body::esri:style XLSForm. Вы также можете установить для оформления значение new-front или new-rear, чтобы ограничить вопрос типа изображение использованием только изображений с камеры устройства, используя по умолчанию фронтальную или заднюю камеру соответственно. Когда используется оформление аннотации, вы можете также указать method=map.
Оформление
Вы можете изменить поведение вопросов и способ их отображения, настроив оформление. Чтобы уточнить, какие приложения для отправки поддерживают определенное оформление, см. раздел Таблица оформления.
Задав для значения столбца оформления несколько строк, вопрос типа файл или изображение поддерживает несколько изображений в вопросе одного изображения.
Это оформление можно объединить с другими видами оформления изображения, разделив оформления пробелом, например, multiline annotate для вопроса типа изображение.
Вы можете контролировать число файлов и изображений, которые могут быть отправлены функцией count-selected в столбец ограничение. Примеры приведены ниже:
- count-selected(${file_question}) <= 5 ограничивает количество файлов, которые могут быть отправлены, максимум пятью.
- count-selected(${image_question}) <= 3 ограничивает количество изображений, которые могут быть отправлены, максимум тремя.
Задав для оформления подпись, можно использовать вопрос типа изображение для написания подписи.
Примечание:
В Survey123 Connect вы также можете задать следующие варианты оформления для вопросов типа изображение в опросах, используемых с полевым приложением Survey123:
- При выборе для оформления новая фронтальная или новая задняя, вопросы типа изображение могут быть ограничены использованием по умолчанию только фронтальной или основной камеры устройства, соответственно. Эти виды оформления можно комбинировать с оформлением annotate, разделив их пробелом, например, new-front annotate.
- Задав оформление рисование или аннотации, вы можете разрешить пользователям рисовать на фотографиях или добавлять к ним аннотации.
- Если задать оформление скачок, в вопросе типа изображение появится кнопка для открытия мобильного приложения Spike для интеграции Survey123 с Spike. Дополнительные сведения см. в разделе Оформление изображений Spike.
Оформление подпись
При выборе оформления signature, вопрос типа Изображение будет представлен в виде всплывающего окна, в котором можно оставить подпись.
Подпись сохраняется в виде прикрепленного изображения .jpg с теми же размерами, что и всплывающее окно. По умолчанию ширина всплывающего окна растягивается до ширины экрана устройства при фиксированной высоте 200 пикселов. Чтобы задать максимальную ширину этого всплывающего окна с помощью параметра max-pixels, см. раздел Настройка размера изображения и метода его получения.
Также можно предоставить изобаржение в столбце default, чтобы задать пользовательский фон для подписи. Размеры изображения по умолчанию будут определять соотношение сторон всплывающего окна.
Ширина всплывающего окна будет наименьшим из следующего:
- Значение max-pixels
- Ширина изображения по умолчанию
- Ширина экрана устройства
Высота будет 200 пикселов, если не предоставлено изображение по умолчанию.
При разработке опроса, использующего оформление типа подписи, проверьте, что учли размер экрана всех целевых устройств.
Текст нижнего колонтитула для всплывающего окна вопроса с подписью можно задать с помощью параметра footerText в столбце body::esri:style. При использовании параметра footerText без значения, ниже подписи появится указывающая подсказка. Ее можно заменить на подсказку вопроса, используя footerText=@[hint]. Подсказка и указывающая подсказка, используемые в тексте колонтитула, не отображаются в местоположении по умолчанию под именем вопроса. Чтобы узнать больше об подсказках, см. раздел Подсказки.
Примечание:
Веб-приложение Survey123 не поддерживает многострочность, параметр max-pixels или значения по умолчанию при применении оформления signature.
Оформление рисования и аннотаций
Примечание:
В этом разделе описывается функциональность, доступная только в Survey123 Connect и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Studio или Survey123 Mobile.
При выборе для оформления draw, вопрос типа Изображение будет отображать кнопку для загрузки холста, на котором вы можете делать наброски. В палитре инструментов рисования вы можете переключаться между инструментами рисования, а также управлять такими настройками каждого инструмента, как размер текста, ширина линии, цвет и т.д. Подробнее об интерфейсе канвы см. Рисование и аннотации. Вы можете создать собственные палитры, которые позволят вам настраивать инструменты рисования и аннотаций для ваших целей. Дополнительные сведения см. в разделе Палитры инструментов рисования и аннотаций.
При выборе для оформления annotate вопрос типа Изображение отображает кнопку, открывающую камеру устройства, чтобы сделать снимок, на которой можно добавить примечание в виде графики и текста. В палитре инструментов рисования вы можете переключаться между инструментами рисования, а также управлять такими настройками каждого инструмента, как размер текста, ширина линии, цвет и т.д. Подробнее об интерфейсе канвы см. Рисование и аннотации. Вы можете создать собственные палитры, которые позволят вам настраивать инструменты рисования и аннотаций для ваших целей. Дополнительные сведения см. в разделе Палитры инструментов рисования и аннотаций.
Подсказка:
В Survey123 3.13 и более поздних версий данные EXIF копируются из исходного изображения в аннотируемое.
Кроме того, можно разрешить пользователю прикреплять аннотации к изображению, хранящемся в хранилище устройства или снимок карты. Для этого, задайте body::esri:style для этого вопроса как method=browse, method=camera или method=map. Поведение по умолчанию для оформления аннотации идентично заданию method=camera. Можно настроить вопрос на предоставление различных опций для исходного изображения, указав различные опции, разделенные запятыми, например, method=camera,browse.
Внимание:
Независимо от заданного метода, веб-приложение Survey123 отображает только опцию поиска файлов.
Значения по умолчанию и вычисления ведут себя по-разному в вопросах типа image, использующих draw и annotate. Если имя файла с изображением в папке опроса media используется в качестве значения по умолчанию или как результат вычисления, то это изображение будет использоваться в качестве фона основы. В случае ввода аннотаций это изображение заменяется предоставленным изображением и отображается только в том случае, если пользователь специально отказывается предоставить изображение или сбрасывает уже введенное изображение.
Примечание:
Вы можете задать разрешение изображения, указав значение max-pixels в столбце parameters. Для вопроса типа нарисовать настройка 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.
Вопросы типа Изображение также поддерживают виды оформления для интеграции Survey123 с решением для лазерных измерений Spike, которое было разработано ikeGPS, что позволяет проводить измерения и определять местоположение объектов по фото. Если задать оформление spike, spike-full-measure или spike-point-to-point, в вопросе типа Изображение появится кнопка для открытия мобильного приложения Spike на устройствах iOS и Android.
Фотография, сделанная с помощью приложения Spike и лазерного устройства, позволяет записывать координаты и расстояние до объекта, а также выполнять измерение объектов на фотографиях путем нанесения областей и линий. Затем к опросу будут прикреплены фото с меткой измерения, и метаданные координат и измерений станут доступными для записи. Связанные Spike и метаданные измерений записываются в файл изображения с использованием стандартных тегов файлов exchangeable image file (EXIF). Затем полученная информация EXIF может использоваться для заполнения других полей.
Разница между видами оформления Spike – это экстент значений, хранящихся в изображении. Оформление spike будет измерять только расстояние и местоположение, в то время как оформление spike-full-measure измеряет расстояние, местоположение, площадь и длину. Оформление spike-point-to-point захватывает серию собственных значений, обозначенных именами свойств, начинающихся с P2P.
Подробнее о тегах EXIF см. в разделе Интеграция Spike. Более подробно о Spike см. на веб-сайте Spike.
Извлечение метаданных изображения
Вы можете использовать функцию pulldata("@exif") для извлечения тегов метаданных стандарта Exchangeable Image File (EXIF) из ответа на вопрос с изображением. Ввод этого примера в вопрос с типом decimal извлекает из изображения, полученного с устройства, значение широты:
pulldata("@exif", ${image}, "GpsLatitude")
Часто используемые теги местоположений EXIF для использования с функционалом pulldata("@exif") перечислены в следующей таблице:
| Тег XML | Описание |
|---|---|
| GpsLatitude | Широта местоположения устройства в виде строкового значения |
| GpsLongitude | Долгота местоположения устройства в виде строкового значения |
| GpsAltitude | Высота местоположения устройства в виде строкового значения |
| GpsLatitudeRef | Направление широты (например, С,В,Ю,З) местоположения устройства в виде строкового значения |
| GpsLongitudeRef | Направление долготы (например, С,В,Ю,З) местоположения устройства в виде строкового значения |
| GpsDestDistance | Расстояние между устройством и целевыми местоположениями, в километрах, в виде целочисленного |
| GpsImgDirection | Направление к целевому местоположению от местоположения устройства в виде строкового |
| GpsDestLatitude | Широта целевого местоположения в виде строкового значения |
| GpsDestLongitude | Долгота целевого местоположения в виде строкового значения |
| GpsDestLatitudeRef | Направление широты (например, С,В,Ю,З) целевого местоположения в виде строкового значения |
| GpsDestLongitudeRef | Направление долготы (например, С,В,Ю,З) целевого местоположения в виде строкового значения |
Следующий пример можно использовать для отображения значений широты и долготы в одном поле, которое затем можно использовать для заполнения вопроса типа Геоточка:
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
Другие теги изображений EXIF, которые могут быть извлечены с помощью Survey123, перечислены ниже. В зависимости от используемого оборудования не все эти теги будут доступны.
| Тег XML | ||
|---|---|---|
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 | |
Чтобы подробно ознакомиться с этими тегами, см. пример EXIF в разделе Survey123 Connect.
Внимание:
Если вопрос типа Изображение содержит несколько изображений, данные EXIF не могут быть извлечены из изображений с помощью функции pulldata("@exif"). Чтобы извлечь данные EXIF из нескольких изображений одного вопроса, воспользуйтесь повтором.
Интеграция Spike
Примечание:
В этом разделе описываются функции, доступные только в Survey123 Connect. Эта функциональность недоступна в Survey123 Studio.
Вопросы с типом image также поддерживают интеграцию с решением Spike для лазерного измерения разработанного ikeGPS, которое позволяет захватывать измерения и местоположение объекта с фотографии. Дополнительные сведения об использовании Spike с Survey123 см. в разделе Оформление Скачок изображений.
Spike записывает ряд дополнительных пользовательских тегов, внося объект JSON в EXIF-тег ImageDescription, содержащий нестандартные свойства, относящиеся к устройству Spike и измерениям, которые оно выполнило. Теги описаны в следующей таблице:
| Тег Spike | Описание |
|---|---|
| device_id | ID устройства Spike в виде значения string |
| local_accuracy | Точность устройства Spike в виде значения decimal |
| destination_altitude | Высота целевого местоположения в виде значения rational |
| declination | Склонение устройства Spike в виде значения rational |
| pitch | Тангаж устройства Spike в виде значения rational |
| rotation | Поворот устройства Spike в виде значения string |
| objects | Массив JSON измеренных объектов (площадь и длина) в виде значения string |
| P2P.capture_id | ID двух изображений процесса точка-точка в виде значения string |
| P2P.horizontal_distance | Расстояние по горизонтали между двумя точками в метрах |
| P2P.distance | Расстояние между двумя точками в метрах |
| P2P.gradient | Градиент между двумя точками в градусах |
| P2P.vertical_distance | Расстояние по вертикали между двумя точками в метрах |
| P2P.azimuth | Азимут двух точек в градусах |
Чтобы открыть эти теги Spike, сначала извлеките объект JSON, который хранится в EXIF, используя pulldata("@exif") для свойства objects, как описано ниже:
pulldata("@exif", ${image}, "objects")
После того как этот объект JSON перемещен в другое поле, можно использовать путь к имени объекта Spike. в функции pulldata("@json") для извлечения определенного значения из массива 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")
Примеры использования этих тегов см. в образце опроса Spike в Survey123 Connect. Дополнительную информацию о 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 автоматически создает имя файла для медиа, содержащихся в вопросе. Вы можете изменить имена файлов, чтобы сделать их более понятными. Например, вы можете включить имя и фамилию подписывающего лица в имя файла подписи. Для фотографии вы можете указать дату или описание объекта, который вы фотографируете.
Внимание:
В веб-приложении поддерживаются пользовательские имена файлов для запросов, касающихся изображений, аудиофайлов и самих файлов. В полевом приложении пользовательские имена файлов поддерживаются только для вопросов, связанных с изображениями.
Индивидуальные имена файлов задаются по мере добавления файла к вопросу типа media и не обновляются автоматически, чтобы отразить последующие изменения в опросе. Например, если имя файла ссылается на текстовый вопрос и значение этого вопроса изменилось после добавления файла, имя файла не будет обновлено, чтобы отразить это изменение.
Вы можете использовать параметр fileName в столбце bind::esri:parameters, чтобы динамически задать имя файла для создаваемого файла. В следующем примере имя файла изображения ASSET406-20221018145109.jpg состоит из вопроса asset_id и текущей даты и времени:
Примеры синтаксиса см. в разделе Пример изображений и аннотаций в Survey123 Connect.
Имена файлов должны соответствовать следующим требованиям:
- Имена файлов должны быть уникальными для всех вопросов во всех опросах на устройстве. В папке Мои вложения к опросу хранятся все изображения для всех опросов на устройстве и она не может содержать файлы с одинаковыми именами. Чтобы убедиться в том, что имена файлов уникальны, рассмотрите возможность использования такой функции, как now() в выражении fileName.
- Имена файлов не могут быть длиннее 140 символов.
- Имена поля не должны содержать пробелов и следующих специальных символов: \ / : * ? < > ; | . , ". Пробелы и специальные символы будут заменены нижними подчеркиваниями.
Внимание:
В веб-приложении, если выражение для параметра fileName либо ручная правка имени файла приводит к дублированию, следующий по порядку номер будет присвоен к новому имени файла.
В полевом приложении, если выражение для параметра fileName приводит к тому, что имя файла становится неуникальным или превышается его максимальная длина, будет использоваться автоматически сгенерированное для изображения имя файла. Точно так же, когда пользователи вручную редактируют имя файла в опросе, это имя не будет принято, если оно дублируется или будет превышена его максимальная длина.
Следующие параметры могут использоваться в столбце body::esri:style для вопроса для дальнейшего управления именами файлов:
- fileNameVisible — указывает, будет ли имя файла отображаться в опросе. По умолчанию – true. Чтобы скрыть имя файла, введите fileNameVisible=false.
- allowRename — указывает, разрешено ли пользователям редактировать имя файла вручную. По умолчанию – true. Пользователи не могут редактировать имя файла, когда fileNameVisible=false, даже если allowRename=true.