Aplikacja ArcGIS Survey123 obsługuje ustawienie instance_name (nazwa instancji) specyfikacji XLSForm. Za pomocą ustawienia instance_name (nazwa instancji) autor ankiety może kontrolować informacje, które są używane do jednoznacznej identyfikacji każdej odpowiedzi w folderach ankiety (takich jak Skrzynka nadawcza i Wysłane), podczas dostępu w aplikacji Survey123 Mobile lub aplikacji terenowej Survey123.
Nazwa instancji jest przydatna podczas przeglądania historii przesłanych ankiet w folderze Wysłane lub przy identyfikacji poszczególnych ankiet, tak jak poniższym przykładzie dotyczącym aplikacji Survey123 Mobile i folderu Skrzynka odbiorcza.
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. Poniżej znajduje się 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 są 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>'))
