GetPersistentData

이름과 인스턴스 ID로 지정된 영구 데이터 값을 반환합니다.

포맷

GetPersistentData ( name ; instanceID )

매개 변수

name - 영구 데이터 항목의 이름을 지정하는 텍스트 표현식입니다.

instanceID - 항목의 특정 인스턴스를 식별하는 텍스트 표현식입니다. 데이터를 저장할 때 사용한 인스턴스 ID와 일치해야 합니다. 빈 문자열("")일 수 있습니다.

반환되는 데이터 유형

텍스트, 숫자, 날짜, 시간, 타임스탬프, 컨테이너

다음 버전에서 시작됨

26.0

설명

이 함수는 이름과 인스턴스 ID로 영구 데이터 저장소에서 값을 검색합니다. 반환된 값의 데이터 유형은 저장된 데이터 유형과 일치합니다. 영구 데이터 저장소 정보를 참조하십시오.

지정된 이름과 인스턴스 ID를 가진 항목이 없으면 이 함수는 "?"를 반환합니다.

참고

지정된 이름에 대한 모든 인스턴스 ID를 찾으려면 ListPersistentDataIDs 함수를 사용합니다.
instanceID를 빈 문자열(")로 지정하면 이 함수는 빈 인스턴스 ID를 가진 항목을 찾습니다.

예제 1

AppVersion이 인스턴스 ID 없이 설정된 경우 영구 데이터 구성 스크립트 단계의 예제 1과 같이 GetPersistentData ( "AppVersion" ; "" )는 2.1.0을 반환합니다.

예제 2

지정된 항목을 반환하며, 지정된 항목을 찾을 수 없는 경우에는 빈 JSON 대상체를 기본값으로 반환합니다.

복사

Let (
  config = GetPersistentData ( "com.claris.myaddon.settings" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  If ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

예제 3

웹 뷰어의 URL을 설정할 때 영구 데이터 저장소에서 JavaScript 라이브러리를 가져옵니다. 이 접근 방식을 사용하면 계산 공식에 대량의 JavaScript 코드를 작성하지 않아도 되므로 업데이트가 더 쉬워집니다.

복사

웹 뷰어 설정 [ 대상체 이름: "webviewer" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetPersistentData ( "ChartLibrary" ; "SharedLibraries" ) &
  "</script></head>" &
  "<body><div id='chart'></div>" &
  "</body></html>" 
]