맨 위로 이동

보고서 식

본 항목

  1. 식 메소드
  2. 식 키워드

질문에 대한 응답은 중괄호({})로 묶인 이름과 그 앞에 달러 기호를 입력하여 보고서 템플릿에 표시할 수 있습니다. 식에 포함된 모든 문자열 값은 큰따옴표로 묶어야 합니다.

다음 예시는 firstname이라는 텍스트 질문의 응답을 표시합니다.

${firstname}

보고서에 질문에 대한 응답을 표시하는 것 외에도 키워드를 사용하여 다른 유용한 정보를 표시할 수 있습니다. 다음은 보고서를 인쇄할 때 현재 날짜 및 시간을 표시합니다.

${$date}

결과가 배열인 경우 중괄호 내에 #을 시작 태그로 사용하고 /를 종료 태그로 사용하여 배열을 반복 처리할 수 있습니다. 다음은 모든 이미지 파일을 각 라인에 출력합니다.

${#image1}
${$file}
${/}

식을 사용하여 응답이 표시되는 방식을 세부 조정할 수도 있습니다. 식은 단일 질문 이름이나 키워드(위와 같이), 하나 이상의 질문이나 키워드가 포함된 계산 또는 응답에 스타일을 제한하거나 적용하기 위한 메소드 및 매개변수가 포함된 질문 이름이나 키워드일 수 있습니다. 식은 다음 표기법을 사용합니다.

${questionname or keyword | method:parameter}

식에는 메소드와 매개변수가 여러 개 포함될 수도 있고, 전혀 포함되지 않을 수도 있습니다. 매개변수는 다른 질문의 값이거나 고정 값일 수 있습니다.

다음 식은 totaltrees라는 숫자 질문을 floweringtrees라는 숫자 질문으로 나눈 계산을 표시합니다. 동일한 식에서 여러 질문을 참조할 때 개별 질문 이름을 직접 지정하면 추가 중괄호가 필요하지 않습니다.

${floweringtrees / totaltrees}

다음 식은 위치(location) 질문의 x 좌표 값을 표시합니다. 여기서 getValue는 메소드이고 x는 매개변수입니다.

${location | getValue:"x"}

다음 식은 fruitcolor라는 질문에 대한 응답이 red가 아닌 경우에 true로 평가됩니다.

${if fruitcolor!="red"}The fruit is not red.${/}

문자열은 더하기 기호로 결합하여 식에서 연결할 수 있습니다. 다음 식은 해당 연결을 통해 field_0이라는 질문의 콘텐츠를 QR code-generating 서비스에 전달하여 질문 응답에 대한 QR 코드를 생성합니다.

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

각 질문 유형에 대한 예제 식은 다음 항목에서 사용할 수 있습니다.

  • 텍스트 식
  • 숫자 식
  • 이미지 및 기타 첨부 파일 식
  • 맵 식(지오포인트, 지오추적, 지오쉐이프 포함)
  • 날짜, 시간, 날짜-시간 식
  • 선택 항목 식
  • 반복 식

식 메소드

모든 질문 유형이 식과 방법을 지원하는 것은 아닙니다. 다음 테이블에는 다양한 질문 유형에 사용할 수 있는 메소드와 매개변수가 나와 있습니다.

메소드매개변수Connect 질문 유형웹디자이너 질문 유형설명

getValue

-

모든 질문 유형

모든 질문 유형

피처 레이어에서 원시 데이터 값을 검색하거나 첨부 파일에서 원시 이미지를 검색합니다.

getValue

x, y, z, wkid

지오포인트

맵

지정된 공간 기준 체계에서 x, y, z 좌표를 개별적으로 검색합니다. wkid 매개변수는 선택 사항이며 생략하는 경우 해당 값은 피처 레이어의 공간 기준 체계와 동일합니다.

getValue

길이, 면적, 단위, 측정 유형

지오추적, 지오쉐이프

맵

폴리라인의 길이나 폴리곤의 둘레 또는 면적을 지정된 단위로 반환하고 측정 값이 평면인지 아니면 측지인지 지정합니다. 기본 측정 유형은 측지입니다.

getValue

이름, 크기

이미지, 오디오, 파일

이미지, 서명, 오디오, 파일

파일 이름과 첨부 파일의 크기를 반환합니다.

getValue

너비, 높이, x, y, 날짜, 시간, 방향

이미지

이미지, 서명

너비와 높이는 픽셀 단위로 이미지 너비와 높이의 정수(Integer) 값을 반환하고 x, y, 날짜, 시간, 방향은 존재하는 경우 이미지 EXIF에서 읽은 값을 반환합니다.

getValue

개수

반복 시작, 이미지, 오디오, 파일

반복, 이미지, 서명, 오디오, 파일

반복 또는 첨부 파일의 총 개수를 반환합니다.

getValue

위치

반복 시작, 이미지, 오디오, 파일

반복, 이미지, 서명, 오디오, 파일

배열에서 색인이 1인 위치와 동일한 정수를 반환합니다.

getValue

기간

오디오, 파일

오디오, 파일

오디오 녹음의 길이(초)를 반환합니다.

주의:

Safari 사용 시 웹 앱에서 수집된 응답에서는 기간이 반환되지 않습니다.

모양

다중 행

텍스트

여러 줄 텍스트

문자열에서 줄바꿈을 유지합니다. 모양값이 지정되지 않은 경우 단일 행 문자열이 반환됩니다.

모양

글머리 기호

선다형

선다형

글머리 기호 형식으로 답변을 반환합니다.

선택

선택 항목 이름

select_one, select_multiple

선다형, 단답형, 단답형 격자, 드롭다운, 리커트 척도, 평점

필드 값이 선택 항목 이름과 같으면 선택한 체크 박스를 반환하고, 그렇지 않으면 선택하지 않은 체크 박스를 반환합니다.

선택함

선택 항목 이름

select_one, select_multiple

선다형, 단답형, 단답형 격자, 드롭다운, 리커트 척도, 평점

코드 값 도메인이 있는 경우 필드 값이 선택 항목 이름과 같으면 true를 반환하고 그렇지 않으면 false를 반환합니다.

countSelected

-

select_one, select_multiple

선다형, 단답형, 단답형 격자, 드롭다운, 리커트 척도, 평점

선택한 항목의 숫자를 반환합니다.

selectedAt

색인

select_one, select_multiple

선다형, 단답형, 단답형 격자, 드롭다운, 리커트 척도, 평점

선택 목록의 색인 위치에 있는 문자열을 반환합니다. 색인은 0부터 시작됩니다.

로캘

언어 코드

날짜, 날짜와 시간, 시작, 종료, 소수

날짜, 날짜와 시간, 숫자

현지화된 날짜, 시간, 숫자를 반환합니다.

형식

형식 문자열

날짜, 날짜와 시간, 정수, 소수, 시작, 종료

날짜, 날짜와 시간

서식이 지정된 날짜 문자열을 반환합니다.

utcOffset

오프셋 값

날짜, 날짜와 시간, 시작, 종료

날짜, 날짜와 시간

협정 세계시(UTC) 오프셋 값으로 이동된 날짜 또는 날짜-시간 값을 반환합니다.

mapSettings

웹 맵 항목 ID, 맵 축척

지오포인트, 지오추적, 지오쉐이프

맵

맵 이미지를 인쇄할 때 베이스맵과 축척을 지정합니다.

레거시:

이 메소드는 map 및 mapScale로 교체되었습니다.

mapExtent

xmin, ymin, xmax, ymax, wkid

지오포인트, 지오추적, 지오쉐이프

맵

맵 이미지를 인쇄할 때 고정된 맵 범위를 지정합니다. wkid 매개변수는 선택 사항이며 생략하는 경우 4326(WGS84)으로 설정됩니다.

맵

웹 맵 항목 ID

지오포인트, 지오추적, 지오쉐이프

맵

맵 이미지를 인쇄할 때 베이스맵을 지정합니다.

mapScale

맵 축척

지오포인트, 지오추적, 지오쉐이프

맵

맵 이미지를 인쇄할 때 맵 축척을 지정합니다.

mapFilters

웹 맵 JSON의 레이어 ID, 쿼리 매개변수

지오포인트, 지오추적, 지오쉐이프

맵

맵 이미지를 인쇄할 때 웹 맵에서 하나 이상의 피처 레이어 필터를 지정합니다.

회전

도

지오포인트, 지오추적, 지오쉐이프, 이미지

맵, 이미지

맵 또는 이미지의 회전각을 지정합니다.

drawingInfo

현재 레이어, 피처 레이어 URL

지오포인트, 지오추적, 지오쉐이프

맵

심볼, 레이블, 투명도를 포함하여 맵 이미지를 인쇄할 때 그리기 정보를 지정합니다.

src

이미지 URL

-

-

동적 이미지 요소의 원본 URL을 지정합니다.

크기

너비, 높이, 최대 너비, 최대 높이

이미지

이미지

인쇄된 이미지의 크기를 지정합니다.

round

장소

소수, 지오포인트, 지오쉐이프, 지오추적

숫자

소수를 지정된 소수 자릿수로 반올림합니다.

useGrouping

불린

소수

숫자

true인 경우 로캘에 따른 그룹화 구분자가 있는 숫자가 반환되며, false인 경우 구분자가 사용되지 않습니다.

toFixed

장소

소수, 지오포인트, 지오쉐이프, 지오추적

숫자

소수점 이하 고정 자릿수를 지정합니다. 고정 자릿수를 충족하기 위해 필요한 경우 0으로 채워집니다.

attachmentsDefExp

SQL 식

이미지, 오디오, 파일

이미지, 서명, 오디오, 파일

$attachment 키워드를 사용하여 질문 또는 현재 피처에 대한 첨부 파일을 식별합니다.

식 키워드

다음 테이블에는 식에 사용할 수 있는 모든 키워드가 나와 있습니다.

키워드설명

$date

보고서를 인쇄할 때 현재 날짜 및 시간을 삽입합니다. 기본 설정에 따라 현재 날짜를 현재 로캘 형식으로 출력합니다.

예:

${$date | format:"MM/DD/YYYY"}
$($date | utcOffset:"+08:00"}
$($date | locale:"zh-cn"}

$image

보고서에 이미지 요소를 삽입합니다. src 메소드를 사용하여 이미지 URL을 지정합니다.

예:

${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}

$map

현장조사 질문을 참조하지 않고 보고서에 맵 요소를 삽입합니다.

예:

${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$shape

맵에 현재 피처의 지오메트리(포인트, 폴리라인, 폴리곤)를 인쇄합니다.

예:

${$shape}
${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$attachment

현재 피처의 첫 번째 첨부 파일 또는 모든 첨부 파일을 나타냅니다.

예:

${$attachment | getValue:"name"}
${$attachment | getValue:"size"}
${$attachment | size:200:300}

모든 첨부 파일을 반복 처리하려면 시작 및 종료 태그를 포함합니다.

${#$attachment}
${$file}
${/}

$file

첨부 파일 현장조사 질문의 여러 파일 또는 피처의 첨부 파일을 반복 처리할 때 현재 파일을 나타냅니다.

예:

${#image1}
${$file | size:460:0}
{/}

${#$attachment}
${$file | getValue:"position"}. ${$file | getValue:"name"}
${/}

$feature

피처 배열의 현재 피처를 나타냅니다.

예:

{#repeat1}
{$feature | getValue: "position"}
{/}

$layers["<layername>"] 또는

$layers[<layerId>]

현장조사 레이어와 동일한 피처 서비스에서 이름 또는 ID로 레이어를 참조합니다.

예:

${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”}
${#$layers["states"]}...${/}

이 항목에 대한 피드백을 제공하시겠습니까?

본 항목
  1. 식 메소드
  2. 식 키워드