현장조사를 통해 새 데이터를 피처 레이어에 제출하는 것 외에도 최근 제출했거나, 얼마 전에 수집했거나, 다른 현장조사 사용자가 수집한 현장조사 데이터를 편집해야 할 수 있습니다.
편집 활성화
현장조사 응답은 발신함 폴더 및 수신함에서 편집할 수 있습니다. 현장조사에 대한 편집을 활성화하려면 기본 피처 레이어에 대한 편집도 활성화해야 합니다.
Survey123 현장 앱의 발신함 폴더에 있는 이전에 제출한 현장조사를 편집할 수 있습니다. 보낸 현장조사에 대한 옵션을 구성하는 방법에 대한 자세한 내용은 발신함 폴더를 참고하세요.
현장조사의 피처 레이어에 저장된 기존 현장조사 데이터(예시: 다른 사용자가 수집한 데이터)를 편집하려면 수신함을 활성화해야 합니다.
주의:
수신함을 활성화하면 현장조사 데이터에 대한 읽기 권한이 활성화되어 현장조사 응답이 표시됩니다. 데이터 보안에 대한 자세한 내용 및 모범 사례는 현장조사 공유를 참고하세요.
수신함을 활성화하려면 Survey123 Connect 현장조사의 옵션 탭으로 이동하여 수신함 활성화를 클릭합니다. 사용자와 현장조사 수신함과 상호작용 방식을 제어할 수 있는 일련의 옵션이 나타납니다. 이러한 옵션에 대한 변경 내용은 현장조사가 발행되었을 때 반영됩니다.
수신함의 현장조사를 편집할 수 있는지, 볼 수 있는지(읽기 전용), 새 현장조사에 복사할 수 있는지를 선택합니다. 쿼리 식을 입력하여 수신함에 반환되는 현장조사 수를 제한할 수 있습니다. 공간 필터를 적용할 수도 있습니다.
비고:
수신함에는 최대 5,000개의 현장조사 응답을 포함할 수 있습니다. 이러한 제한은 상위 현장조사 레코드에만 적용됩니다(반복 레코드에는 적용되지 않음).
반환할 레코드가 많을수록 수신함을 새로 고치는 시간이 더 오래 걸립니다 반복 레코드가 포함된 현장조사의 경우 수신함을 새로 고칠 때 검색되는 총 레코드 수가 상위 레코드의 수보다 훨씬 많을 수 있습니다. 예를 들어 피처 레이어에 2,000개의 상위 레코드가 있고 각 상위 레코드에 10개의 반복 레코드가 있는 경우 수신함은 총 22,000개의 레코드를 검색합니다. 쿼리 식 또는 공간 필터를 적용하여 상위 레코드 수를 제한할 수 있습니다. bind::esri:parameters 열에 쿼리를 정의하여 반복 레코드 수를 제한할 수 있습니다.
주의:
현장조사 응답은 기기에서 한 번에 하나의 폴더에만 존재할 수 있습니다. 발신함 폴더와 수신함이 둘 다 현장조사에 대해 활성화된 경우, 수신함을 새로 고침해도 이미 발신함 폴더에 있는 응답이 다운로드되지 않습니다. 즉, 다른 기기에 있는 사용자가 발신함 폴더에 있는 응답을 업데이트해도 업데이트된 응답이 수신함에 다운로드되지 않습니다.
이러한 이유로 여러 명의 사용자가 기존 응답을 지속적으로 편집하고 업데이트하길 원하는 경우에는 동일한 현장조사에 대해 발신함 폴더 및 수신함을 활성화하지 않는 것을 권장합니다.
WHERE 식
Survey123 현장 앱의 수신함에서 편집할 수 있는 현장조사는 Survey123 Connect에서 현장조사의 옵션 탭에 지정된 쿼리 식으로 확인됩니다. 변경 사항을 적용하려면 이 쿼리를 수정할 때마다 현장조사를 발행해야 합니다.
쿼리 식은 ArcGIS에서 지원되는 일반적인 SQL 구문 및 함수를 사용해야 합니다. 모든 쿼리가 현장조사의 피처 레이어에 대해 실행되므로 피처 레이어의 REST 엔드포인트에서 쿼리 연산을 사용하여 식을 생성하고 테스트할 수 있습니다. 이 절차 및 쿼리 구문의 예시에 대한 자세한 내용은 쿼리(피처 서비스)를 참고하세요. 지원되는 함수에 대한 자세한 내용은 ArcGIS Online의 표준화된 SQL 함수를 참고하세요.
다음은 사용 사례 및 구문의 예시입니다.
- 이 예시에서는 rating 필드의 수가 2보다 크거나 같은 현장조사를 반환합니다.
rating>=2
- 이 예시에서는 EditDate 필드의 날짜가 2017년 4월 13일 또는 이후인 현장조사를 반환합니다.
EditDate>='2017-4-13'
- 이 예시에서는 Editor 필드가 'BKlauser'와 동일한 현장조사를 반환합니다.
Editor='BKlauser'
- 이 예시에서는 status 필드가 'for_review'와 동일한 현장조사를 반환합니다.
status='for_review'
- 이 예시에서는 inspection_date 필드의 날짜가 지난 7일 이내인 현장조사를 반환합니다.
inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE
- 이 예시에서는 project_status 필드가 'complete'와 동일하지 않은 현장조사를 반환합니다.
project_status<>'complete'
- 이 예시에서는 final_approval 필드가 비어 있는(Null) 현장조사를 반환합니다.
final_approval IS NULL
- 이 예시에서는 final_approval 필드가 비어 있지(Null) 않은 현장조사를 반환합니다.
final_approval IS NOT NULL
수신함 쿼리는 username 변수도 지원합니다. 이러한 변수는 XLSForm 식과 동일한 형식으로 지정해야 합니다. 예를 들어 Creator=${username} 쿼리는 현재 로그인되어 있는 사용자가 생성한 모든 현장조사 레코드를 반환합니다.
비고:
username 변수는 수신함 쿼리 식에서 XLSForm 구문을 사용할 수 있는 유일한 경우입니다. username 변수를 ${username}(으)로 작성해야 하는 경우에도 해당 값은 현장조사의 질문이 아닌 로그인한 사용자의 ArcGIS 계정에서 파생됩니다.
여러 사용자 목록이 포함된 필드에서 로그인한 사용자에 대한 레코드를 반환하려면 쿼리에서 POSITION() 함수를 사용해야 합니다. 예를 들어 POSITION(${username} IN assigned_to) > 0 쿼리는 로그인한 사용자를 포함한 모든 현장조사 레코드를 반환하며, 여기에서 assigned_to 필드 값은 'George_Smith, Nick_Jones'와 같이 가능한 모든 작업자의 쉼표로 구분된 목록일 수 있습니다.
공간 필터
수신함에서 새로 고침을 선택하면 목록 탭에 표시된 현장조사 목록이 업데이트됩니다. 새로 고침 작업은 일반적으로 수신함 쿼리 식(설정된 경우)을 충족하지만 기기의 다른 폴더에 아직 저장되지 않은 모든 현장조사를 반환합니다. 맵 탭에서 새로 고침을 선택하면 공간 필터를 적용하여 현재 맵 범위 내에 있는 현장조사만 표시하도록 목록을 업데이트할 수 있습니다.
공간 필터를 활성화하려면 Survey123 Connect의 옵션 탭에 맵 탭이 보이는 경우 공간 필터 적용을 선택합니다. 다음 예시에서는 새로 고침를 선택하면 현재 맵 범위에서 보이는 4개의 현장조사 응답만 표시되도록 현장조사 목록이 업데이트됩니다. 현장조사에 인스턴스 이름이 설정되어 있는 경우 맵의 각 피처에는 해당 인스턴스 이름이 레이블로 지정됩니다.
반복
Survey123에서는 연계 레코드가 있는 피처를 수신함 또는 발신함 폴더에서 편집할 수 있습니다. 기존 레코드 삭제는 지원되지 않지만 새 레코드를 추가하고 기존 레코드를 편집할 수 있습니다. 쿼리 매개변수를 통해 allowUpdates=true가 활성화되지 않은 경우 기본 설정에 따라 기존 레코드 편집이 비활성화됩니다.
bind::esri:parameters 열은 반복에 대한 선택적 매개변수를 제공하는 데 사용될 수 있습니다. 이러한 매개변수는 따옴표로 묶인 공백이 포함된 값을 사용하는 키 값 쌍으로 형식이 지정됩니다.
기본 설정에 따라 연계 레코드는 수신함 또는 발신함 폴더에서 현장조사 응답에 제공되지 않습니다. 응답의 연계 레코드에 접근하려면 반복 시작 질문 유형에 대한 bind::esri:parameters 열에서 쿼리를 정의합니다. 쿼리 속성은 위의 WHERE 식과 동일한 매개변수(예시: 편집기 필드에서 'BKlauser'가 포함된 관련 레코드만 다운로드하려면 query="Editor='BKlauser'")를 지원합니다.
릴레이트 테이블의 모든 레코드를 다운로드하려면 매개변수 없이 쿼리를 지정합니다(query).
bind::esri:parameters 열을 통해 반복 시작(begin repeat) 질문 유형에 적용할 수 있는 매개변수는 다음과 같습니다.
- query - 릴레이트 테이블에 레코드를 쿼리하고 다운로드할 수 있도록 합니다(예시: query="severity='high'").
- allowAdds - 편집할 때 새 레코드를 반복해 추가할 수 있도록 합니다. 기본값은 true입니다. allowAdds=false를 사용하여 false로 설정할 수 있습니다.
- allowUpdates - 편집할 때 반복의 기존 레코드를 업데이트할 수 있도록 합니다. 기본값은 false입니다. allowUpdates=true를 사용하여 true로 설정할 수 있습니다.
공백으로 구분하여 여러 키 값 쌍을 함께 사용할 수 있습니다(예시: allowUpdates=true query="Editor='BKlauser'"). 이러한 값에 공백이 포함된 경우 따옴표로 묶을 수 있습니다.
이미지
Survey123에서는 사용자가 기존 현장조사 레코드에 이미지를 추가할 수 있습니다. 기존 이미지 편집은 지원되지 않지만 각 이미지 질문은 현장조사를 편집할 때 복제 버튼을 제공하여 기존 이미지를 복사한 후 회전, 이름 바꾸기 또는 draw 및 annotate 모양으로 편집할 수 있습니다.
새 이미지 제공은 기본 설정에 따라 활성화되어 있습니다. 해당 기능을 비활성화하려면 bind::esri:parameters 열에 allowAdds=false을(를) 입력합니다.
이미지 편집에는 몇 가지 알려진 제한 사항이 있습니다.
- 오프라인 워크플로는 지원되지 않습니다.
- signature 모양은 복제 기능을 지원하지 않습니다.
- 이미지 첨부 파일은 키워드 등록정보를 사용하여 이미지가 제출된 질문에 이미지를 연결합니다. 키워드 등록정보는 ArcGIS Enterprise 10.8.1 이전 버전에서 지원되지 않으므로 ArcGIS Enterprise portal 10.8.1 이전 버전에서 발행된 현장조사에 제출한 이미지는 질문에 연결되지 않습니다. 마찬가지로 현장조사 이외의 방식을 통해 피처에 연결된 이미지(예시: ArcGIS Pro 또는 ArcGIS Online 웹 맵의 이미지)에는 키워드가 없어야 합니다.
- 기존 현장조사가 수신함에서 사용하도록 기기에 다운로드될 때 기존 이미지는 다운로드되지 않습니다. count-selected 함수는 기기에 있는 이미지 개수만 계산하며 현장조사가 처음 열릴 때는 0을 반환합니다. 캡처된 새 이미지 개수가 계산됩니다.