Aplikacja ArcGIS Survey123 obsługuje ustawienie instance_name (nazwa instancji) specyfikacji XLSForm. Używając ustawienia instance_name (nazwa instancji), autor ankiety może kontrolować informacje, które są używane do jednoznacznego identyfikowania każdej odpowiedzi w folderach Wersje robocze, Skrzynka nadawcza, Skrzynka odbiorcza i Wysłane aplikacji terenowej Survey123.
Nazwa instancji jest także przydatna podczas przeglądania historii przesłanych ankiet w folderze Wysłane aplikacji terenowej Survey123 lub przy identyfikacji poszczególnych ankiet w folderze Skrzynka odbiorcza aplikacji terenowej.
W tym przykładzie następujące wyrażenie zostało zastosowane do nazwy instancji dla odpowiedzi na dwa pytania tekstowe oddzielone spacją jako identyfikator dla każdego rekordu ankiety (w tym przypadku imię i nazwisko osoby):
concat(${first_name}, ' ', ${last_name})
Nazwa instancji jest zdefiniowana w arkuszu ustawień formularza XLSForm. Jeśli kolumna instance_name jest pusta, zastosowana zostanie domyślna nazwa instancji, która zawiera wszystkie odpowiedzi na pytania w ankiecie. Podaj wyrażenie w kolumnie instance_name, aby dostosować nazwę instancji. Na przykład:
${site_name}
format-date(${date_time}, '%Y-%m-%d')
concat(${category}, ' Remarks: ', ${remarks})
concat(${street_number}, ' ', ${street_name}, ' ', ${suburb})
Tworząc nazwę instancji, można używać obliczeń, na przykład:
${first_number} + ${second_number}
Do nazwy instancji można też zastosować formatowanie HTML. Musisz połączyć składnię HTML jako część nazwy instancji za pomocą funkcji concat(). W poniższym przykładzie nazwa instancji jest sformatowana jako niebieski tekst kursywą, a nazwisko jest pogrubione:
concat('<font color="blue"><i><b>', ${last_name}, '</b>, ', ${first_name}, '</i></font>')
Wskazówka:
Jeśli składnia HTML zawiera cudzysłowy, musisz użyć pojedynczych cudzysłowów do zamknięcia ciągu tekstowego, który zawiera podwójne cudzysłowy, lub odwrotnie. Na przykład: '<font color="yellow">'.
Nazwy instancji będą wyświetlane w maksymalnie trzech wierszach tekstu.
Poniższy przykład wykorzystuje instrukcję if() do zastosowania formatowania warunkowego do nazwy instancji. Jeśli odpowiedź na pytanie approved brzmi yes, to nazwa instancji jest wyświetlana na zielono, w przeciwnym razie na czerwono:
if(${approved}='yes', concat('<font color="green"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'), concat('<font color="red"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'))
