이 함수를 사용하여 앱에 환경 특성을 로드할 수 있습니다. 이 함수는 다음 특성을 반환할 수 있습니다.
GetSysAttr() 함수에서 반환할 수 있는 환경 특성
특성
설명
로드 스크립트 변수의 예
차트 표현식 예(변수 없음)
tenantId
테넌트 ID입니다.
Let vTenantID = GetSysAttr('tenantId')
=GetSysAttr('tenantId')
tenantName
테넌트의 이름입니다.
Let vTenantName = GetSysAttr('tenantName')
=GetSysAttr('tenantName')
tenantUrl
테넌트의 기본 URL입니다.
Let vTenantUrl = GetSysAttr('tenantUrl')
=GetSysAttr('tenantUrl')
tenantUrlAlias
테넌트에 대해 정의된 별칭 URL입니다.
Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')
=GetSysAttr('tenantUrlAlias')
tenantRegion
테넌트가 있는 지역입니다.
Let vTenantRegion = GetSysAttr('tenantRegion')
=GetSysAttr('tenantRegion')
spaceId
공간 ID입니다. 이는 공유 공간 또는 관리 공간의 앱에 대해서만 정의됩니다.
정보 메모
GetSysAttr() 함수가 Qlik Cloud에서 빈 spaceId 값을 반환하면 앱이 개인 공간에 있음을 나타냅니다.
GetSysAttr() 함수는 Qlik Sense 클라이언트 관리에서 사용될 때 항상 빈 spaceId 값을 반환합니다.
Let vSpaceId = GetSysAttr('spaceId')
=GetSysAttr('spaceId')
spaceName
공간의 이름입니다. 이는 공유 공간 또는 관리 공간의 앱에 대해서만 정의됩니다.
정보 메모
GetSysAttr() 함수가 Qlik Cloud에서 빈 spaceName 값을 반환하면 앱이 개인 공간에 있음을 나타냅니다.
GetSysAttr() 함수는 Qlik Sense 클라이언트 관리에서 사용될 때 항상 빈 spaceName 값을 반환합니다.
Let vSpaceName = GetSysAttr('spaceName')
=GetSysAttr('spaceName')
spaceType
앱이 위치한 공간의 유형입니다. 이는 공유 공간 또는 관리 공간의 앱에 대해서만 정의됩니다.
정보 메모
GetSysAttr() 함수가 Qlik Cloud에서 빈 spaceType 값을 반환하면 앱이 개인 공간에 있음을 나타냅니다.
GetSysAttr() 함수는 Qlik Sense 클라이언트 관리에서 사용될 때 항상 빈 spaceType 값을 반환합니다.
Let vSpaceType = GetSysAttr('spaceType')
=GetSysAttr('spaceType')
사용 시기
이 함수는 서로 다른 환경 간에 이동할 수 있는 Qlik Sense 앱의 공간 및 테넌트 식별을 간소화합니다. 이 함수를 사용하면 작업 중인 특정 환경을 쉽게 식별할 수 있습니다. 이는 앱 수명 주기의 DTAP(개발, 테스트, 수용 및 생산) 단계에서 특히 유용합니다.
이 함수는 앱의 로드 스크립트 또는 차트 표현식의 LOAD 문에서 표현식으로 직접 사용하거나 변수로 저장된 표현식에서 사용할 수 있습니다. 수명 주기 동안 앱이 공간 또는 테넌트 간에 이동할 것으로 예상되는 경우 차트 표현식의 함수를 사용하여 앱을 다시 로드하지 않고 공간 및 테넌트 정보를 동적으로 가져옵니다. 이때 로드 스크립트 외부의 변수에 함수 표현식을 저장하거나 차트 표현식에서 직접 함수를 사용합니다.
예 1 – 환경 특성을 로드 스크립트 변수로 저장
이 예에서는 만든 앱 콘텐츠에서 사용할 수 있는 스크립트 변수 집합을 정의합니다. 앱이 다시 로드될 때마다 특성이 평가되어 앱에 추가됩니다.
다음과 같이 하십시오.
공유 공간에서 새 Qlik Sense 앱을 만듭니다.
데이터 로드 편집기을 엽니다.
다음 로드 스크립트를 새 탭에 붙여넣습니다.
Transactions:
Load * inline [
id,date,amount
1,1/1/2023,500.67
2,1/2/2023,458.91
3,1/3/2023,12.34
4,1/4/2023,90.90
5,1/5/2023,256.30
6,1/6/2023,789.16
7,1/7/2023,501.25
8,1/8/2023,87.01
9,1/9/2023,161.16
10,1/10/2023,300.06
];
Let vTenantId = GetSysAttr('tenantId');
Let vTenantName = GetSysAttr('tenantName');
Let vTenantUrl = GetSysAttr('tenantUrl');
Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias');
Let vTenantRegion = GetSysAttr('tenantRegion');
Let vSpaceId = GetSysAttr('spaceId');
Let vSpaceName = GetSysAttr('spaceName');
Let vSpaceType = GetSysAttr('spaceType');
이 로드 스크립트에는 다음이 포함됩니다.
샘플 트랜잭션 데이터가 포함된 Transactions라는 새 테이블입니다. 이는 임의의 데이터로 바뀔 수 있으며 자리 표시자로 추가됩니다.
GetSysAttr()로 가져올 수 있는 사용할 수 있는 특성에 대한 일련의 스크립트 변수 정의입니다.
데이터를 로드하고 고급 편집 모드에서 새 시트를 엽니다.
Table 개체를 만들고 각각의 레이블과 함께 다음 표현식을 차원으로 추가합니다.
=vTenantId, 레이블 포함 Tenant ID
=vTenantName, 레이블 포함 Tenant Name
=vTenantUrl, 레이블 포함 Tenant URL (Default)
=vTenantUrlAlias, 레이블 포함 Tenant URL (Alias)
=vTenantRegion, 레이블 포함 Tenant Region
=vSpaceId, 레이블 포함 Space ID
=vSpaceName, 레이블 포함 Space Name
=vSpaceType, 레이블 포함 Space Type
이제 사용할 수 있는 각 환경 특성을 동적으로 표시하는 테이블이 앱에 있습니다. 앱을 내보내고 다른 테넌트 및 공간에 업로드하면 새로 업로드된 앱 버전에 대한 이러한 특성이 제공됩니다.
예 2 – 환경 특성을 변수로 저장하고 차트 표현식에서 사용
이 예에서는 스크립트에서 변수를 정의하는 대신 고급 편집 모드에서 대화 상자를 사용하여 여러 변수를 정의합니다. 그런 다음 앱의 차트 표현식에서 변수를 사용할 수 있습니다.
다음과 같이 하십시오.
공유 공간에서 새 Qlik Sense 앱을 만듭니다.
고급 편집 모드에서 새 시트를 엽니다.
을 클릭하여 변수 대화 상자를 엽니다.
새로 만들기를 클릭합니다.
이름 아래에 vTenantId를 입력합니다.
정의 아래에 =GetSysAttr('tenantId')를 입력합니다.
만들기를 클릭합니다.
이렇게 하면 테넌트의 ID를 표시하는 앱 변수가 만들어집니다. 3~6단계를 반복하여 나머지 각 특성에 대한 변수를 만듭니다. 다음 매개 변수를 사용합니다.
테넌트 이름
이름: vTenantName
정의: =GetSysAttr('tenantName')
테넌트 URL
이름: vTenantUrl
정의: =GetSysAttr('tenantUrl')
테넌트 URL 별칭
이름: vTenantUrlAlias
정의: =GetSysAttr('tenantUrlAlias')
테넌트 지역
이름: vTenantRegion
정의: =GetSysAttr('tenantRegion')
공간 ID
이름: vSpaceId
정의: =GetSysAttr('spaceId')
공간 이름
이름: vSpaceName
정의: =GetSysAttr('spaceName')
공간 유형
이름: vSpaceType
정의: =GetSysAttr('spaceType')
Table 개체를 만들고 다음 표현식을 각 레이블과 함께 차원으로 추가합니다.
=vTenantId, 레이블 포함 Tenant ID
=vTenantName, 레이블 포함 Tenant Name
=vTenantUrl, 레이블 포함 Tenant URL (Default)
=vTenantUrlAlias, 레이블 포함 Tenant URL (Alias)
=vTenantRegion, 레이블 포함 Tenant Region
=vSpaceId, 레이블 포함 Space ID
=vSpaceName, 레이블 포함 Space Name
=vSpaceType, 레이블 포함 Space Type
이제 앱에 사용할 수 있는 각 환경 특성을 동적으로 표시하는 테이블이 있습니다. 앱을 내보내고 다른 테넌트 및 공간에 업로드하면 새로 업로드된 앱 버전에 대한 이러한 특성이 제공됩니다.
차트 표현식에서 함수를 사용하는 주요 이점은 이러한 특성을 새로 고치기 위해 앱을 다시 로드할 필요가 없다는 것입니다. 이를 통해 앱 수명 주기의 일부로 테넌트와 공간 간에 앱을 보다 원활하게 이동할 수 있습니다.
예 3 – 로드 스크립트에서 직접 함수 사용
변수 없이 앱에서 함수를 사용할 수도 있습니다. 이 예는 각 특성이 있는 테이블을 개별 필드로 로드하는 방법을 보여 줍니다. 여기에서 앱에서 시각화를 만들어 이러한 세부 정보를 표시할 수 있습니다.
다음과 같이 하십시오.
공유 공간에서 새 Qlik Sense 앱을 만듭니다.
데이터 로드 편집기를 엽니다.
다음 로드 스크립트를 새 탭에 붙여넣습니다.
Attributes:
Load RowNo() as Key,
GetSysAttr('tenantId') as TenantID,
GetSysAttr('tenantName') as TenantName,
GetSysAttr('tenantUrl') as TenantUrl,
GetSysAttr('tenantUrlAlias') as TenantUrlAlias,
GetSysAttr('tenantRegion') as TenantRegion,
GetSysAttr('spaceId') as SpaceID,
GetSysAttr('spaceName') as SpaceName,
GetSysAttr('spaceType') as SpaceType autogenerate 1;
데이터를 로드합니다. 개별 필드의 각 특성을 표시하는 테이블이 데이터 모델에 만들어집니다.
이제 테이블 또는 텍스트 및 이미지 개체와 같은 시각화에서 특성 필드를 사용할 수 있습니다.
예 4 – 차트 표현식에서 직접 함수 사용
변수를 사용하지 않고 차트 표현식에 직접 함수를 입력할 수 있습니다.
차트 표현식에서 함수를 사용하는 주요 이점은 이러한 특성을 새로 고치기 위해 앱을 다시 로드할 필요가 없다는 것입니다. 이를 통해 앱 수명 주기의 일부로 테넌트와 공간 간에 앱을 보다 원활하게 이동할 수 있습니다.
다음과 같이 하십시오.
공유 공간에서 새 Qlik Sense 앱을 만듭니다.
고급 편집 모드에서 새 시트를 엽니다.
텍스트 및 이미지 개체를 시트로 끕니다.
빈 차트 내부를 클릭하여 텍스트를 추가하고 다음을 입력합니다.
테넌트 ID:
속성 패널에서 측정값 추가를 클릭합니다.
다음 표현식을 입력합니다.
=GetSysAttr('tenantId')
이 도움말 항목의 소개 부분에 있는 특성 테이블에 제시된 표현식을 사용하여 다른 특성에 대해 이 단계를 반복합니다.
이 페이지가 도움이 되었습니까?
이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!