Architect의 JSON 값

Architect의 JSON 리터럴 편집기에서 리터럴 값을 직접 설정할 수 있도록 JSON을 추가합니다. Architect의 식 편집기를 사용하여 식을 통해 JSON을 추가할 수도 있습니다.

메모:

Architect JSON 유형은 JavaScript 객체 리터럴 규칙이 아닌 JSON 규칙을 엄격하게 준수합니다. 즉, 키와 문자열 값을 큰따옴표로 묶어야 합니다.

이 문서에서는 보다 일반적으로 사용되는 JSON 함수를 구체적으로 다룹니다. ToJson, ToJsonCollection 및 JsonParse. 더 많은 JSON 함수에 대한 도움말은 Architect 표현식 도움말을 참조하세요.

JSON 값

표현식 모드에서 JsonParse 또는 ToJson 함수를 사용하거나 JSON 리터럴 편집기에 직접 JSON 데이터를 입력하여 JSON 값을 설정합니다. JSON 출력 값에는 변수 참조가 있어야 합니다.

JSON 편집기

예를 들어 JSON 유형 변수의 경우 데이터 업데이트 작업에서 JSON을 사용하도록 선택한 후 JSON 리터럴 값을 추가하려면 클릭을 클릭합니다. JSON 편집기 창이 열립니다. 그런 다음 편집기에서 직접 JSON 데이터를 추가합니다.

JSON으로 데이터 작업 업데이트

유효한 JSON 유형

JSON 데이터 유형 변수 편집기는 다음 유형을 허용합니다.

  • 끈: 큰따옴표로 묶음 예 "안녕하세요", "{\"unusualExample\": \”이 예는 객체처럼 보이지만 실제로는 객체로 파싱되지 않은 문자열입니다.\”}”.
  • 숫자 정수 또는 십진수 값 예 0.0, 1.0, 25, -100.
  • 부울: 소문자, 따옴표가 필요하지 않습니다. 값: 참/거짓
  • 널: 값이 없는 객체.
  • 정렬: 이 목록에 있는 모든 유형의 값(문자열, 숫자, 부울, Null, 개체)을 포함할 수 있습니다. 예 [ ], [1,2,3], [참, "안녕하세요", {"a": 참}].
  • 물체: 이 목록에 있는 모든 유형의 값(문자열, 숫자, 부울, Null, 배열)을 포함할 수 있습니다. 큰따옴표로 묶음 예 {'고객 이름': "John Doe"}, { }.

예 JSON 편집기

구성

  • JSON 값은 NOT_SET일 수 있습니다.
  • JSON 값에 객체가 포함된 경우 기능은 객체에서 대소문자를 구분하는 속성 이름을 조회합니다.
  • Architect 흐름 및 스크립팅에서 JSON 데이터 유형 변수를 생성할 수 있습니다.
  • 개체를 포함하는 JSON 값의 경우 속성 키를 큰따옴표로 묶어야 합니다.
  • 점 표기법을 통해 개체를 포함하는 JSON 변수 내에서 데이터를 쿼리할 수 있습니다. 예를 들어 "Flow.myJson.userName"을 통해 표현식에서 JSON 변수 "Flow.myJson" 내의 "userName" 속성 값에 액세스합니다. 개체 값이 포함된 JSON 변수의 속성에 액세스하려고 하는데 런타임 시 속성이 개체 내에 존재하지 않는 경우 Architect는 NOT_SET JSON 값을 반환합니다. 객체가 아닌 JSON 값의 속성에 액세스하려고 하면 런타임 엔진이 오류 처리를 시작합니다.

JSON 표현식 생성

ToJson, toJsonCollection 및 JsonParse와 함께 식 내에서 JSON을 사용할 수 있습니다.

  • ToJson: 지정된 싱글톤 값으로 JSON 값을 생성합니다. Architect는 문자열 값을 변환할 때 해당 문자열 값이 포함된 JSON 값을 반환합니다. 문자열 값을 구문 분석하려면 JsonParse를 사용하십시오.
  • ToJsonCollection: 항목이 배열의 항목에서 Architect가 복제하는 JSON 값인 경우 배열을 포함하는 JSON 값을 JSON 값 컬렉션으로 변환합니다.
  • JsonParse: JSON 구문 분석 의미 체계를 통해 제공된 문자열 값을 JSON으로 구문 분석합니다. JSON 문자열을 구문 분석할 때 키를 큰따옴표로 묶어야 합니다.

입력 출력
ToJson(MakeDateTime(2022, 8, 4, 0, 0, 0)) 문자열 "2022-08-04T00:00:00.000Z"를 포함하는 JSON 값입니다.
ToJson("안녕하세요") "Hello" 문자열을 포함하는 JSON 값입니다.
투제슨(5) 숫자 5를 포함하는 JSON 값입니다.
ToJson("{ \"a\": 참 }”) "{ \"a\" 문자열을 포함하는 JSON 값: 참 }”. 문자열 대신 객체로 JSON 값을 생성하려면 JsonParse를 사용하십시오.
ToJson(MakeCurrency(5.25, "USD")) { "금액"의 JSON 객체를 포함하는 JSON 값: 5.25, "코드": "USD"}.
ToJson(ToPhoneNumber(“전화:+13178723000”)) "tel:+13178723000" 문자열을 포함하는 JSON 값입니다.

입력 출력
ToJsonCollection(JsonParse("[ 참, 100 ]")) 두 개의 JSON 값 항목이 포함된 JSON 컬렉션 값입니다. 첫 번째 JSON 값에는 부울 값 true가 포함되고 두 번째 JSON 값에는 숫자 100이 포함됩니다.
ToJsonCollection(MakeEmptyJsonArray()) 빈 JSON 컬렉션 값입니다.
Count(ToJsonCollection(JsonParse("[ true, 100 ]")))) 2
Count(AddItem(ToJsonCollection(JsonParse("[ 참, 100 ]")),MakeEmptyJsonObject())) 3

입력 출력
JsonParse("\"안녕하세요\"") "Hello" 문자열을 포함하는 JSON 값입니다.
JsonParse("[ 0, 1, 2 ]") 배열 [ 0, 1, 2 ]를 포함하는 JSON 값입니다.
JsonParse("{ \"a\": 참, \"b\": 100, \"c\": [ 참, 거짓 ], \”d\”: null }”) { "a"의 JSON 객체를 포함하는 JSON 값: 참, "b": 100, "다": [참, 거짓], "c": 널 }
JsonParse(ToString(NOT_SET)) NOT_SET JSON 값입니다.
JsonParse("참") 부울 값 true를 포함하는 JSON 값입니다.

검사

JSON 리터럴 편집기에서 텍스트가 유효하지 않다고 판단하면 유효성 검사 오류가 나타납니다. 경우에 따라 오류에는 유효성 검사가 실패한 문자를 나타내는 위치 정보가 포함됩니다. 오류에 위치 번호가 포함된 경우 메시지를 클릭하여 커서를 오류로 이동하십시오. JSON 리터럴 값에 오류가 있는 동안 저장할 수 있지만 이렇게 하면 흐름에 유효성 검사 오류가 추가되고 게시할 수 없습니다.

JSON 위치 오류로 데이터 작업 업데이트

작업 순서에 시간 변수 추가

다음 예에서는 JSON 변수를 데이터 업데이트 작업에 추가하는 방법을 설명합니다.

  1. 도구 상자에서 확장 데이터 범주 및 드래그 데이터 업데이트 작업에서 원하는 위치로 작업합니다.
  2. 에서 이름 필드에 항목을 설명하는 의미 있는 이름을 추가합니다.
  3. 딸깍 하는 소리 업데이트 문 추가 그리고 선택 끈.
  4. 에서 변수 이름 필드에 레이블을 입력하여 작업의 변수를 식별합니다.
  5. 할당할 값 필드에서 다음 옵션 중에서 선택합니다.
    • 리터럴 모드에서 값을 설정하려면 JSON 리터럴 값을 추가하려면 클릭을 클릭합니다. JSON 리터럴 편집기가 열리고 형식이 지정된 JSON을 만들고 편집할 수 있습니다. 
    • 표현식을 사용하여 값을 설정하려면 JSON 리터럴 값을 추가하려면 클릭 옆에 있는 표현식 모드를 클릭하고 다음 단계 중 하나를 수행합니다.
      • 표현식을 인라인으로 추가하십시오.
      • 표현식을 클릭하고 표현식을 인라인으로 추가합니다.
  6. (선택사항) 다른 변수를 추가하려면 업데이트 문 추가를 클릭합니다.