W ankietach można umieszczać pytania typu image (obraz), audio (dźwięk) i file (plik), aby umożliwić użytkownikom wysyłanie załączników z odpowiedziami na ankietę.
Wskazówka:
Obrazy oraz dźwięki można również dodawać do innych pytań w ankiecie w celach informacyjnych i związanych ze stylem. Więcej informacji na ten temat zawiera sekcja Dodawanie multimediów do ankiety.
Domyślnie pytania typu image (obraz), audio (dźwięk) i file (plik) zezwalają na jeden załącznik. W przypadku ustawienia ich wyglądu na multiline (wielowierszowy) w kolumnie appearance (wygląd) można dołączyć wiele załączników.
Obrazy
Typ pytania image (obraz) pozwala użytkownikom przesyłać obrazy zapisane na ich urządzeniu i zdjęcia robione za pomocą aparatu urządzenia.
Zdjęcie zrobione w aplikacji Survey123 zostaje zapisane jako plik .jpg. Poziom jakości zdjęcia zależy od aparatu fotograficznego urządzenia. Rozmiar obrazów, mierzony w pikselach wzdłuż najdłuższej krawędzi, można skonfigurować na karcie Opcje aplikacji Survey123 Connect. Ten rozmiar jest stosowany względem wszystkich pytań typu image (obraz) w ankiecie. Dostępne są następujące opcje:
- 320 pikseli
- 640 pikseli
- 1280 pikseli
- 1920 pikseli
- Bez ograniczeń (do ankiety można dołączyć zdjęcie dowolnej wielkości)
Domyślny rozmiar obrazu to 1280 pikseli. Przesłane obrazy, które zostały zapisane na urządzeniu, zachowują typ pliku, rozdzielczość i jakość oryginalnego obrazu.
Rozmiary tych obrazów nie mają wpływu na podgląd obrazu dostępny w aplikacji terenowej Survey123. Można nim sterować za pomocą parametru previewHeight. Ten parametr obsługuje wszystkie typy jednostek obsługiwane przez parametr height, ale wysokość obrazu podglądu zawsze jest ograniczona przez szerokość ekranu urządzenia i współczynnik proporcji obrazu. Aby skonfigurować podgląd obrazu o maksymalnej wielkości bez zbędnego pustego miejsca, należy użyć parametru previewHeight=0.
Dla każdego pytania typu image (obraz) w ankiecie można skonfigurować maksymalny dozwolony rozmiar. Podaj wartość max-pixels w kolumnie parameter formularza XLSForm pytania, które chcesz ograniczyć. Na przykład podanie wartości max-pixels=100 spowoduje proporcjonalne zmniejszenie obrazu do 100 pikseli wzdłuż najdłuższej krawędzi. Jeśli parametr max-pixels nie zostanie podany, stosowany będzie rozmiar obrazu skonfigurowany w aplikacji Survey123 Connect.
Pytanie typu image (obraz) można ograniczyć do określonej metody rejestrowania, podając wartość method=camera lub method=browse w kolumnie body::esri:style formularza XLSForm. Wygląd można również ustawić na new-front lub new-rear, aby pytanie typu image (obraz) było ograniczone do korzystania wyłącznie z aparatu urządzenia, przy czym domyślnie używany jest odpowiednio aparat przedni lub tylny. Gdy jest używany wygląd annotate (notatka), można także podać wartość method=map.
Domyślna maksymalna wielkość pliku jednego obrazu wynosi 10 MB. W przypadku pytań typu image (obraz) w aplikacji internetowej Survey123 można podać maksymalną wielkość pliku w megabajtach w parametrze max-size w kolumnie bind::esri:parameters. Na przykład podanie parametru max-size=5 spowoduje, że użytkownicy będą mogli załączyć obraz o wielkości do 5 MB.
Notatka:
Maksymalny rozmiar pliku jednego załącznika przesłanego z aplikacji terenowej Survey123 wynosi 10 MB.
Parametr max-size zastosowany względem pytań typu image (obraz) jest obsługiwany tylko w aplikacji internetowej Survey123. Wielkość maksymalna nie może przekroczyć 100 MB dla usługi ArcGIS Online i 20 MB dla oprogramowania ArcGIS Enterprise.
Pytania typu image (obraz) obsługują także inne wyglądy, które umożliwiają dodawanie opisów do zdjęć, rysowanie na płótnie lub składanie odręcznych podpisów. Więcej informacji można znaleźć w temacie Wygląd.
Domyślnie aplikacja Survey123 automatycznie generuje nazwy plików dla obrazów przesłanych w odpowiedzi na pytanie. Nazwa pliku zawiera nazwę pytania jako prefiks, po którym następuje unikalny numer. W przypadku niektórych pytań można dostosować nazwy plików, aby były bardziej zrozumiałe. Więcej informacji na ten temat zawiera sekcja Dostosowywanie nazw plików. Jeśli dane ankiety są eksportowane i publikowane jako warstwa obiektowa w celu ponownego użycia w aplikacji Survey123, zaleca się, aby nie dostosowywać nazw plików. Więcej informacji na ten temat zawiera sekcja Słowa kluczowe.
Wyodrębnianie metadanych obrazu
Funkcji pulldata("@exif") można używać do wyodrębniania standardowych znaczników metadanych Exchangeable Image File (EXIF) z odpowiedzi na pytanie typu image (obraz). Wprowadzenie następującego przykładu w pytaniu typu decimal (wartość dziesiętna) powoduje wyodrębnienie z obrazu wartości szerokości geograficznej urządzenia:
pulldata("@exif", ${image}, "GpsLatitude")
Często używane lokalizacyjne znaczniki EXIF, z których można korzystać w funkcji pulldata("@exif"), są wymienione w poniższej tabeli:
| Znacznik EXIF | Opis |
|---|---|
| GpsLatitude | Szerokość geograficzna lokalizacji urządzenia — ciąg znakowy |
| GpsLongitude | Długość geograficzna lokalizacji urządzenia — ciąg znakowy |
| GpsAltitude | Wysokość lokalizacji urządzenia — ciąg znakowy |
| GpsLatitudeRef | Odniesienie do szerokości geograficznej (tzn. N,E,S,W) lokalizacji urządzenia — ciąg znakowy |
| GpsLongitudeRef | Odniesienie długości geograficznej (tzn. N,E,S,W) lokalizacji urządzenia — ciąg znakowy |
| GpsDestDistance | Odległość między urządzeniem i lokalizacjami docelowymi wyrażona w kilometrach — liczba całkowita |
| GpsImgDirection | Kierunek do lokalizacji docelowej z lokalizacji urządzenia — ciąg znakowy |
| GpsDestLatitude | Szerokość geograficzna lokalizacji docelowej — ciąg znakowy |
| GpsDestLongitude | Długość geograficzna lokalizacji docelowej — ciąg znakowy |
| GpsDestLatitudeRef | Odniesienie szerokości geograficznej (tzn. N,E,S,W) lokalizacji docelowej — ciąg znakowy |
| GpsDestLongitudeRef | Odniesienie długości geograficznej (tzn. N,E,S,W) lokalizacji docelowej — ciąg znakowy |
Poniższy przykład może zostać wykorzystany do wyświetlenia wartości zarówno szerokości, jak i długości geograficznej w pojedynczym polu, które może następnie zostać użyte przy wypełnianiu pytania typu geopoint (punkt geograficzny):
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
Inne znaczniki EXIF, które można wyodrębnić za pomocą aplikacji Survey123, są wymienione poniżej. W zależności od używanego sprzętu nie wszystkie te znaczniki będą dostępne.
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 |
Szczegółowe informacje na temat tych znaczników są dostępne w przykładzie dotyczącym znaczników EXIF w aplikacji Survey123 Connect.
Uwaga:
Jeśli pytanie typu image (obraz) zawiera wiele obrazów, nie można wyodrębnić danych EXIF z obrazów przy użyciu funkcji pulldata("@exif"). Aby wyodrębnić dane EXIF z wielu obrazów przesłanych w odpowiedzi na to samo pytanie, użyj powtórzenia.
Integracja z aplikacją Spike
Pytania typu image (obraz) obsługują także integrację z opracowanym przez firmę ikeGPS rozwiązaniem do wykonywania pomiarów laserowych o nazwie Spike, które umożliwia dokonywanie pomiarów i określanie lokalizacji obiektu na podstawie zdjęcia. Informacje na temat sposobu użycia rozwiązania Spike z aplikacją Survey123 zawiera sekcja Wygląd.
System Spike rejestruje pewną liczbę dodatkowych niestandardowych znaczników, zapisując obiekt JSON w znaczniku EXIF ImageDescription, który zawiera niestandardowe właściwości związane z urządzeniem Spike i wykonanymi pomiarami. Znaczniki te są opisane w poniższej tabeli:
| Znacznik Spike | Opis |
|---|---|
| device_id | Identyfikator urządzenia Spike — ciąg znakowy |
| local_accuracy | Dokładność urządzenia Spike — liczba dziesiętna |
| destination_altitude | Wysokość lokalizacji docelowej — liczba wymierna |
| declination | Odchylenie urządzenia Spike — liczba wymierna |
| pitch | Skok urządzenia Spike — liczba wymierna |
| rotation | Rotacja urządzenia Spike — ciąg znakowy |
| objects | Tablica JSON zmierzonych obiektów (pole powierzchni i długości) — ciąg znakowy |
| P2P.capture_id | Identyfikator dwóch obrazów procesu punkt-punkt — ciąg znakowy |
| P2P.horizontal_distance | Odległość w poziomie między dwoma punktami w metrach |
| P2P.distance | Odległość między dwoma punktami w metrach |
| P2P.gradient | Gradient między dwoma punktami w stopniach |
| P2P.vertical_distance | Odległość w pionie między dwoma punktami w metrach |
| P2P.azimuth | Azymut dwóch punktów w stopniach |
Aby uzyskać dostęp do tych znaczników systemu Spike, należy najpierw wyodrębnić obiekt JSON zapisany w znacznikach EXIF, stosując funkcję pulldata("@exif") do właściwości objects:
pulldata("@exif", ${image}, "objects")
Gdy obiekt JSON znajduje się już w innym polu, można za pomocą ścieżki nazwy obiektu Spike. w funkcji pulldata("@json") wyodrębnić konkretną wartość z tablicy JSON. Więcej informacji na temat funkcji pulldata("@json") zawiera sekcja Pobieranie wartości z formatu JSON. Poniższy przykład przedstawia wyodrębnianie skoku urządzenia Spike z pytania zawierającego tablicę:
pulldata("@json", ${spikedata}, "Spike.pitch")
Tablica objects zawiera również obszary i długości zarejestrowane przez urządzenie Spike. Ta tablica zawiera zmierzone obiekty na zdjęciu, w tym kształty i linie, jak również kształt dopasowania używany do transformacji obrazu. Obiekty w tablicy można wyodrębniać przez odwołanie się do ich pozycji w tablicy — pozycje te odpowiadają kolejności, w jakiej obiekty zostały zarejestrowane. W następującym przykładzie jest zwracany pierwszy obszar lub pierwsza linia w tablicy:
pulldata("@json", ${spikedata}, "Spike.objects[1].type")
Notatka:
Pozycja 0 w tablicy zawsze zawiera kształt dopasowania.
Aby zwrócić liczbę obiektów znajdujących się w tablicy, należy użyć właściwości length w następujący sposób:
pulldata("@json", ${spikedata}, "Spike.objects.length")
Przykłady użycia tych znaczników można znaleźć w przykładowej ankiecie wykorzystującej system Spike, która jest dostępna w aplikacji Survey123 Connect. Więcej informacji na temat systemu Spike można znaleźć na stronie produktów firmy ikeGPS.
Dźwięk
Typ pytania audio (dźwięk) pozwala użytkownikom rejestrować i przesyłać dźwięk w aplikacji Survey123. Rejestrowanie przechwytuje plik dźwiękowy przy użyciu domyślnego formatu rejestrowania dźwięków na urządzeniu. Pasek postępu wskazuje, ile czasu pozostało do końca rejestrowania. W dowolnej chwili użytkownicy mogą wstrzymać lub zatrzymać rejestrowanie. Po zakończeniu rejestrowania można zmienić nazwę pliku, wybierając ją.
Notatka:
Wstrzymywanie dźwięku podczas jego nagrywania w aplikacji terenowej nie jest obsługiwane w systemie Android.
W aplikacji terenowej nie jest obsługiwane przesyłanie istniejącego pliku dźwiękowego.
Domyślnie nagrania dźwiękowe mogą mieć maksymalną wielkość pliku 10 MB w aplikacji terenowej i 10 minut w aplikacji internetowej.
Za pomocą parametru max-size w kolumnie bind::esri:parameters można skonfigurować niższy limit wielkości. Po osiągnięciu maksymalnej wielkości pliku rejestrowanie zatrzymuje się automatycznie. Na przykład wartość max-size=5 pozwala użytkownikom na zarejestrowanie pliku dźwiękowego o wielkości maksymalnej 5 MB.
Można również podać limit czasowy w sekundach, korzystając z parametru max-duration w kolumnie bind::esri:parameters. Po osiągnięciu maksymalnego czasu trwania rejestrowanie zatrzymuje się automatycznie. Na przykład wartość max-duration=30 pozwala użytkownikowi na zarejestrowanie maksymalnie 30 sekund dźwięku.
Uwaga:
Maksymalny rozmiar pliku jednego załącznika przesłanego z aplikacji terenowej Survey123 wynosi 10 MB. Należy się upewnić, że skonfigurowana wartość max-duration lub max-size nie powoduje przekroczenia przez plik dźwiękowy maksymalnego rozmiaru pliku.Domyślnie pliki dźwiękowe są kodowane na urządzeniach iOS i Android kodekiem AAC (Advanced Audio Coding), jeśli urządzenie go obsługuje. W parametrze codec w kolumnie bind::esri:parameters można podać preferowane kodeki dźwiękowe. Można podać wiele kodeków, rozdzielając je przecinkami, na przykład codec=amr-nb,aac. Używany jest pierwszy kodek zgodny z urządzeniem.
Notatka:
Kodeki obsługiwane przez urządzenia są wymienione na stronie Informacje w aplikacji terenowej Survey123. Naciśnij i przytrzymaj tytuł Informacje o aplikacji ArcGIS Survey123 na górze strony Informacje, aby ujawnić dodatkowe informacje o urządzeniu, w tym obsługiwane przez nie kodeki dźwiękowe. W przypadku urządzeń z systemem Windows pliki dźwiękowe są zawsze rejestrowane w nieskompresowanym formacie WAV.
Istnieje również możliwość wysłania za pomocą pytania typu file (plik) pliku dźwiękowego zapisanego na urządzeniu. Lista obsługiwanych typów plików dźwiękowych znajduje się w temacie Pliki.
Domyślnie aplikacja Survey123 automatycznie generuje nazwy plików dla dźwięków przesłanych w odpowiedzi na pytanie. Nazwa pliku zawiera nazwę pytania jako prefiks, po którym następuje unikalny numer. W przypadku niektórych pytań można dostosować nazwy plików, aby były bardziej zrozumiałe. Więcej informacji na ten temat zawiera sekcja Dostosowywanie nazw plików. Jeśli dane ankiety są eksportowane i publikowane jako warstwa obiektowa w celu ponownego użycia w aplikacji Survey123, zaleca się, aby nie dostosowywać nazw plików. Więcej informacji na ten temat zawiera sekcja Słowa kluczowe.
Pliki
W przypadku pytań typu file (plik) użytkownicy mogą przesyłać pliki różnych typów.
Domyślna maksymalna wielkość jednego pliku wynosi 10 MB. W przypadku pytań typu file (plik) w aplikacji internetowej Survey123 można podać maksymalną wielkość pliku w megabajtach w parametrze max-size w kolumnie bind::esri:parameters. Na przykład podanie parametru max-size=5 spowoduje, że użytkownicy będą mogli załączyć plik o wielkości do 5 MB.
Notatka:
Maksymalny rozmiar pliku jednego załącznika przesłanego z aplikacji terenowej Survey123 wynosi 10 MB.
Parametr max-size zastosowany względem pytań typu file (plik) jest obsługiwany tylko w aplikacji internetowej Survey123. Wielkość maksymalna nie może przekroczyć 500 MB dla usługi ArcGIS Online i 20 MB dla oprogramowania ArcGIS Enterprise.
Domyślnie pytania typu file (plik) zezwalają na jeden plik. Aby zezwolić na załączenie do pytania typu file (plik) wielu plików, użyj wyglądu multiline (wielowierszowe).
Typ pytania file (plik) akceptuje wszystkie typy załączników plikowych obsługiwane przez usługę ArcGIS Online i oprogramowanie ArcGIS Enterprise. Obsługiwane są następujące typy plików:
| Kategoria | Typ pliku |
|---|---|
Archiwizuj | 7Z, GTAR, GZ, TAR, TGZ, ZIP |
Dźwięk | AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA |
Dane | CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML |
Dokument | DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT |
Obraz | BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF |
Wideo | AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV |
*Typ załącznika nie jest obsługiwany w oprogramowaniu ArcGIS Enterprise.
Za pomocą kolumny body::accept można ograniczyć typy plików, które można przesyłać do pytania typu file (plik). Ta kolumna zezwala zarówno na rozszerzenia nazw plików (na przykład .wav), jak i na typy MIME (na przykład audio/*). Wiele rozszerzeń nazw plików i typów MIME można skonfigurować, oddzielając je przecinkiem.
Aby uzyskać informacje na temat akceptowanych formatów typów MIME, zobacz listę popularnych typów MIME produktów Mozilla.
Domyślnie aplikacja Survey123 automatycznie generuje nazwy plików dla plików przesłanych w odpowiedzi na pytanie. Nazwa pliku zawiera nazwę pytania jako prefiks, po którym następuje unikalny numer. Nazwy plików można dostosować, aby były bardziej zrozumiałe. Więcej informacji na ten temat zawiera sekcja Dostosowywanie nazw plików. Jeśli dane ankiety są eksportowane i publikowane jako warstwa obiektowa w celu ponownego użycia w aplikacji Survey123, zaleca się, aby nie dostosowywać nazw plików. Więcej informacji na ten temat zawiera sekcja Słowa kluczowe.
Słowa kluczowe
Aplikacja Survey123 korzysta ze słów kluczowych załącznika w celu powiązania załączników z konkretnymi pytaniami w ankiecie. Podczas tworzenia pytania typu image (obraz), audio (dźwięk) lub file (plik) w ankiecie i publikowania tej ankiety nazwa pytania jest używana jako słowo kluczowe w tabeli załączników. Jeśli na przykład ankieta zawiera pytania typu image (obraz) o nazwach image_closeup i image_wideview, wartością zapisaną w kolumnie KEYWORDS tabeli załączników dla każdego zdjęcia będzie albo image_closeup, albo image_wideview. Aplikacja Survey123 automatycznie dopasowuje słowo kluczowe załącznika do nazwy pytania, aby powiązać załączniki z pytaniami.
Cel tego powiązania słowa kluczowego jest najbardziej widoczny podczas drukowania raportów, aplikacja Survey123 zapewni, że właściwe zdjęcie zostanie wydrukowane jako odpowiedź na właściwe pytanie w ankiecie. Powiązanie słowa kluczowego jest również używane do umożliwienia edycji Obrazów w skrzynce odbiorczej.
Po zmianie nazwy pytania typu image (obraz) i ponownym opublikowaniu ankiety konieczna jest również zmiana słowa kluczowego każdego istniejącego rekordu załącznika.
Uwaga:
Przy eksporcie danych Survey123 kolumna KEYWORDS tabeli załączników nie zostanie zachowana.
Gdy te dane zostaną następnie ponownie opublikowane jako hostowana usługa obiektowa, istnieje jedno pytanie typu image (obraz) i załączniki mają domyślne nazwy plików, można użyć notatnika Aktualizuj słowa kluczowe załączników Python do ponownego zapełnienia kolumny KEYWORDS. Jeśli w ankiecie jest więcej niż jedno pytanie typu image (obraz), nie można użyć notatnika i należy samodzielnie określić, który plik jest powiązany z którym pytaniem, oraz wprowadzić nazwę pytania w kolumnie KEYWORDS każdego rekordu załącznika. Więcej informacji zawiera ten artykuł pomocy technicznej.
Jeśli dane są ponownie publikowane jako usługa obiektowa ArcGIS Server, należy najpierw do tabeli załączników dodać kolumnę KEYWORDS. W celu dodania tej kolumny można użyć narzędzia Aktualizuj załączniki. Jeśli istnieje jedno pytanie typu image (obraz) i załączniki mają domyślne nazwy plików, można użyć notatnika Python Aktualizuj słowa kluczowe załączników do ponownego zapełnienia kolumny KEYWORDS. Jeśli w ankiecie jest więcej niż jedno pytanie typu image (obraz), nie można użyć notatnika i należy samodzielnie określić, który plik jest powiązany z którym pytaniem, oraz wprowadzić nazwę pytania w kolumnie KEYWORDS każdego rekordu załącznika. Więcej informacji zawiera ten artykuł pomocy technicznej.
W obu środowiskach przy następnym wglądzie w te rekordy w aplikacji Survey123 wartość słowa kluczowego w tabeli załączników będzie zgodna z nazwą pytania i powiązanie zostanie utworzone automatycznie.
Dostosowywanie nazw plików
Domyślnie aplikacja Survey123 automatycznie generuje nazwy plików dla obrazów, dźwięków i plików przesłanych w odpowiedzi na pytanie. Nazwa pliku zawiera nazwę pytania jako prefiks, po którym następuje unikalny numer. Nazwy plików można dostosować, aby były bardziej zrozumiałe. Na przykład nazwa pliku z podpisem może zawierać imię i nazwisko osoby podpisującej. W przypadku zdjęć można podać datę lub opis sfotografowanego obiektu.
Uwaga:
W aplikacji internetowej dostosowane nazwy plików są obsługiwane w przypadku pytań typu image (obraz), audio (dźwięk) i file (plik). W aplikacji terenowej dostosowane nazwy plików są obsługiwane tylko dla pytań typu image (obraz).
Dostosowane nazwy plików są konfigurowane w momencie dodawania pliku do pytania multimedialnego i nie są automatycznie aktualizowane w celu odzwierciedlenia kolejnych zmian w ankiecie. Jeśli na przykład nazwa pliku odwołuje się do pytania typu text (tekst), a wartość tego pytania zmieni się po dodaniu pliku, nazwa pliku nie zostanie zaktualizowana w celu odzwierciedlenia zmiany.
W parametrze fileName w kolumnie bind::esri:parameters można dynamicznie skonfigurować nazwę tworzonego pliku. W poniższym przykładzie jest tworzona nazwa pliku obrazu podobna do ASSET406-20221018145109.jpg. Powstaje ona na podstawie pytania asset_id oraz bieżącej daty i czasu:
Więcej przykładów składni zawierają przykłady obrazów i opisów w aplikacji Survey123 Connect.
Nazwy plików muszą być zgodne z poniższymi zasadami:
- Nazwy plików muszą być unikalne dla wszystkich pytań we wszystkich ankietach na urządzeniu. W folderze Załączniki mojej ankiety są zapisane wszystkie obrazy dla wszystkich ankiet na urządzeniu i nie może on zawierać zduplikowanych nazw plików. Aby zapewnić unikalność nazw plików, należy rozważyć użycie funkcji, takiej jak now() w wyrażeniu fileName.
- Nazwy plików mogą składać się z maksymalnie 140 znaków.
- Nazwy plików nie mogą zawierać spacji ani następujących znaków specjalnych: \ / : * ? < > ; | . , ". Spacje i znaki specjalne zostaną zastąpione podkreśleniem.
Uwaga:
W aplikacji terenowej, jeśli wyrażenie w parametrze fileName da w wyniku nazwę pliku, która jest zduplikowana lub przekracza maksymalną długość, aplikacja będzie używać automatycznie generowanej nazwy pliku tego obrazu. Podobnie w sytuacji, gdy użytkownik ręcznie zmieni nazwę pliku w ankiecie, nazwa pliku nie zostanie zaakceptowana, jeśli jest duplikatem lub przekracza maksymalną długość.
W aplikacji internetowej, jeśli wyrażenie w parametrze fileName lub ręczna edycja nazwy pliku powodują powstanie duplikatu, do nowej nazwy pliku zostanie dodana przyrostowa liczba.
Aby lepiej sterować nazwami plików, w kolumnie body::esri:style pytania można zastosować następujące parametry:
- fileNameVisible — określa, czy nazwa pliku będzie widoczna w ankiecie. Wartość domyślna to true. Aby ukryć nazwę pliku, wpisz fileNameVisible=false.
- allowRename — określa, czy użytkownicy mogą ręcznie edytować nazwę pliku. Wartość domyślna to true. Użytkownicy nie mogą edytować nazwy pliku, gdy zostanie ustawiona wartość fileNameVisible=false, nawet jeśli ustawiono wartość allowRename=true.