영구 데이터 구성

영구 데이터 저장소의 항목을 설정하거나 삭제합니다.

옵션 

• 이름은 영구 데이터 항목의 이름을 지정하는 텍스트입니다. 이름은 비워둘 수 없습니다.

• 인스턴스 ID는 항목의 특정 인스턴스를 식별하는 데 사용할 수 있는 선택적 텍스트 표현식입니다. 각기 다른 인스턴스 ID가 지정된 여러 항목이 동일한 이름을 가질 수도 있습니다.

• 값은 저장할 데이터의 표현식입니다. 값을 저장할 때 데이터 유형도 보존됩니다.

• 항목 삭제는 지정된 항목을 삭제합니다.

다음 버전에서 시작됨 

26.0

설명 

지정된 이름과 인스턴스 ID를 가진 항목이 이미 존재하는 경우, 이 스크립트 단계는 값 또는 항목 삭제 중 무엇을 선택했는지에 따라 해당 값을 업데이트하거나 항목을 삭제합니다. 항목이 존재하지 않는 경우, 값을 지정하면 항목이 생성됩니다. 영구 데이터 저장소 정보를 참조하십시오.

참고 

• 항목의 값을 검색하려면 GetPersistentData 함수를 사용합니다.

• 계산 공식의 크기가 제한되어 있기 때문에(FileMaker Pro 기술 제한 참조), 값 옵션에서 해당 제한을 초과하는 텍스트 값을 입력할 수 없습니다. 이 제한보다 큰 텍스트 값을 지정하려면 값 옵션에 대한 데이터가 포함된 필드 또는 변수를 참조하십시오. 먼저 텍스트를 필드 또는 변수에 입력하려면, 텍스트 삽입(스크립트 단계 자체에 저장된 텍스트), URL에서 삽입(URL을 통해 제공되는 텍스트), 데이터 파일에서 읽기(로컬 파일의 텍스트)와 같은 스크립트 단계를 사용할 수 있습니다.

• 인스턴스 ID는 지정되지 않은 상태(공백)이거나 빈 문자열(")일 수 있습니다.

• 인스턴스 ID가 지정되지 않은 상태(공백)이면 빈 문자열(")과 동일하게 취급됩니다.

• 존재하지 않는 항목을 삭제하면 오류 코드 10("요청된 데이터가 유실되었습니다")이 반환됩니다.

예제 1 

현재 파일의 영구 데이터 저장소에서 AppVersion(인스턴스 ID 없음)이라는 항목에 간단한 버전 번호를 저장합니다.

영구 데이터 구성 [ AppVersion ; 값: "2.1.0" ]

이 항목을 읽으려면 GetPersistentData 함수의 예제 1을 참조하십시오.

예제 2 

애드온의 인스턴스 ID를 사용하여 애드온에 대한 여러 구성 값을 저장합니다.

변수 설정 [ $instanceID ; 값: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
영구 데이터 구성 [ com.claris.myaddon.theme ; 인스턴스 ID: $instanceID ; 값: "Dark" ]
영구 데이터 구성 [ com.claris.myaddon.language ; 인스턴스 ID: $instanceID ; 값: "en" ]
영구 데이터 구성 [ com.claris.myaddon.modificationdate ; 인스턴스 ID: $instanceID ; 값: Get ( CurrentTimestamp ) ]

예제 3 

이름과 인스턴스 ID로 특정 영구 데이터 항목을 삭제합니다.

변수 설정 [ $instanceID ; 값: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
영구 데이터 구성 [ com.claris.myaddon.theme ; 인스턴스 ID: $instanceID ; 삭제 ]

관련 주제 

• 영구 데이터 저장소 정보

• GetPersistentData 함수

• ListPersistentDataIDs 함수

• 스크립트 단계 참조