GetSysAttr() 함수는 앱이 위치한 테넌트와 공간에 대한 정보를 반환하는 데 사용됩니다. GetSysAttr() 함수를 사용하면 앱이 있는 환경에 대한 테넌트 ID 및 이름, 공간 ID 및 이름, 기타 세부 정보를 평가할 수 있습니다. 이 함수는 서로 다른 환경 간에 이동할 수 있는 Qlik Sense 앱의 공간 및 테넌트 식별을 간소화합니다. 이 함수를 사용하면 작업 중인 특정 환경을 쉽게 식별할 수 있습니다. 이는 앱 수명 주기의 DTAP(개발, 테스트, 수용 및 생산) 단계에서 특히 유용합니다.
이 함수는 앱의 로드 스크립트 또는 차트 표현식에서 표현식으로 직접 사용하거나 변수로 저장된 표현식으로 사용할 수 있습니다. 수명 주기 동안 앱이 공간 또는 테넌트 간에 이동할 것으로 예상되는 경우 차트 표현식의 함수를 사용하여 앱을 다시 로드하지 않고 공간 및 테넌트 정보를 동적으로 가져옵니다. 이때 로드 스크립트 외부의 변수에 함수 표현식을 저장하거나 차트 표현식에서 직접 함수를 사용합니다.
GetSysAttr()을 사용하여 앱에 대한 다음 정보를 확인합니다.
앱이 위치한 테넌트의 ID.
앱이 위치한 테넌트의 이름.
앱이 위치한 테넌트의 URL.
앱이 포함된 테넌트에 대해 정의된 별칭 URL.
앱이 포함된 테넌트의 지역.
앱이 위치한 공간의 ID.
앱이 위치한 공간의 이름.
앱이 위치한 공간의 유형(공유 또는 관리).
GetSysAttr() 함수는 로드 스크립트 또는 차트 표현식에서 직접 사용할 수 있습니다. 두 경우 모두 함수를 사용하여 특성을 변수에 저장하거나 변수 없이 직접 저장할 수 있습니다.
Qlik Sense 클라이언트 관리에서 이 함수를 사용하면 빈 데이터 값만 반환됩니다. 따라서 나중에 앱을 Qlik Cloud에 업로드할 목적으로 이 함수를 사용하여 오류 발생 없이 Qlik Sense 클라이언트 관리에서 스크립트를 개발할 수 있습니다.
이 함수를 사용하여 앱에 환경 특성을 로드할 수 있습니다. 이 함수는 다음 특성을 반환할 수 있습니다.
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')
예 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')
이 도움말 항목의 소개 부분에 있는 특성 테이블에 제시된 표현식을 사용하여 다른 특성에 대해 이 단계를 반복합니다.
이 페이지가 도움이 되었습니까?
이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!