Azure 통합 문서 만들기 또는 편집

아티클
01/08/2024

이 문서에서는 새 통합 문서를 만드는 방법과 Azure 통합 문서에 요소를 추가하는 방법을 설명합니다.

이 비디오에서는 통합 문서를 만드는 단계를 안내합니다.

새 Azure 통합 문서 만들기

새 Azure 통합 문서를 만들려면 다음을 수행합니다.

Azure 통합 문서 페이지에서 빈 템플릿을 선택하거나 위쪽 도구 모음에서 새로 만들기를 선택합니다.
이러한 요소를 결합하여 통합 문서에 추가합니다.
- Text
- 매개 변수
- 쿼리
- 메트릭 차트
- 연결
- Groups
- 구성 옵션

Add text

통합 문서를 사용하면 작성자가 해당 통합 문서에 텍스트 블록을 포함할 수 있습니다. 텍스트는 데이터에 대한 사람의 분석, 사용자가 데이터를 해석하는 데 도움이 되는 정보, 섹션 제목 등일 수 있습니다.

텍스트는 작성자가 콘텐츠를 추가할 수 있는 markdown 컨트롤을 통해 추가됩니다. 작성자는 markdown의 전체 서식 지정 기능을 사용할 수 있습니다. 여기에는 다양한 제목 및 글꼴 스타일, 하이퍼링크, 테이블 등이 포함됩니다. Markdown을 통해 작성자는 풍부한 Word 또는 포털과 유사한 보고서 또는 분석 설명을 만들 수 있습니다. 텍스트는 markdown 텍스트에 매개 변수 값을 포함할 수 있으며 매개 변수가 변경되면 해당 매개 변수 참조가 업데이트됩니다.

편집 모드:

미리 보기 모드:

Azure 통합 문서에 텍스트를 추가하려면 다음을 수행합니다.

도구 모음에서 편집을 선택하여 편집 모드로 전환합니다. 다음 단계 중 하나를 수행하여 쿼리를 추가합니다.
- 기존 요소 아래 또는 통합 문서 아래쪽에서 추가, 텍스트 추가를 차례로 선택합니다.
- 통합 문서의 요소 중 하나 옆에 있는 편집 단추 오른쪽의 줄임표(...)를 선택한 다음, 추가, 텍스트 추가를 차례로 선택합니다.
편집기 필드에 markdown 텍스트를 입력합니다.
텍스트 스타일 옵션을 사용하여 일반 markdown과 Azure Portal의 표준 정보/경고/성공/오류 스타일로 래핑된 markdown 간에 전환할 수 있습니다.

팁

이 Markdown 치트 시트를 사용하여 다양한 서식 옵션을 확인합니다.
미리 보기 탭을 사용하여 콘텐츠가 어떻게 표시되는지 확인할 수 있습니다. 미리 보기는 스크롤 가능 영역 내에 콘텐츠를 표시하여 크기를 제한하지만, 런타임에 표시될 때에는 Markdown 콘텐츠가 스크롤 막대 없이 필요한 공간을 채우도록 확장됩니다.
편집 완료를 선택합니다.

텍스트 스타일

이러한 텍스트 스타일을 사용할 수 있습니다.

스타일	설명
plain	형식이 적용되지 않았습니다.
info	`ℹ` 또는 유사한 아이콘과 파란색 배경을 사용하는 포털의 ‘info’ 스타일
error	`❌` 또는 유사한 아이콘과 빨간색 배경을 사용하는 포털의 ‘error’ 스타일
성공	`✔` 또는 유사한 아이콘과 녹색 배경을 사용하는 포털의 ‘success’ 스타일
upsell	`🚀` 또는 유사한 아이콘과 보라색 배경을 사용하는 포털의 ‘upsell’ 스타일
경고	`⚠` 또는 유사한 아이콘과 파란색 배경을 사용하는 포털의 ‘warning’ 스타일

스타일의 원본으로 텍스트 매개 변수를 선택할 수도 있습니다. 매개 변수 값은 위의 텍스트 값 중 하나여야 합니다. 값이 없거나 값을 인식할 수 없으면 plain 스타일로 처리됩니다.

텍스트 스타일 예제

정보 스타일 예:

경고 스타일 예:

쿼리 추가

Azure 통합 문서를 사용하여 지원되는 통합 문서 데이터 원본을 쿼리할 수 있습니다.

예를 들어 Azure Resource Health를 쿼리하여 리소스에 영향을 주는 서비스 문제를 볼 수 있습니다. 정기적으로 수집되는 숫자 데이터인 Azure Monitor 메트릭을 쿼리할 수도 있습니다. Azure Monitor 메트릭은 특정 시간의 시스템 정보를 제공합니다.

Azure 통합 문서에 쿼리를 추가하려면 다음을 수행합니다.

도구 모음에서 편집을 선택하여 편집 모드로 전환합니다. 다음 단계 중 하나를 수행하여 쿼리를 추가합니다.
- 기존 요소 아래 또는 통합 문서 아래쪽에서 추가, 쿼리 추가를 차례로 선택합니다.
- 통합 문서의 요소 중 하나 옆에 있는 편집 단추 오른쪽의 줄임표(...)를 선택한 다음, 추가, 쿼리 추가를 차례로 선택합니다.
쿼리의 데이터 원본을 선택합니다. 다른 필드는 선택한 데이터 원본에 따라 결정됩니다.
선택한 데이터 원본에 따라 필요한 다른 값을 선택합니다.
통합 문서의 시각화를 선택합니다.
쿼리 섹션에서 쿼리를 입력하거나 샘플을 선택하여 샘플 쿼리 목록에서 선택한 다음, 원하는 대로 쿼리를 편집합니다.
쿼리 실행을 선택합니다.
통합 문서에 원하는 쿼리가 있다고 확신하면 편집 완료를 선택합니다.

로그 쿼리 모범 사례

가능한 가장 작은 시간 범위를 사용합니다. 시간 범위가 길수록 쿼리가 느려지고 더 많은 데이터가 반환됩니다. 더 긴 시간 범위의 경우 쿼리가 더 느린 "콜드" 스토리지로 이동해야 하므로 쿼리가 더 느려질 수 있습니다. 가장 짧은 유용한 시간 범위가 기본값이지만 사용자가 더 느릴 수 있는 더 큰 시간 범위를 선택할 수 있습니다.
드롭다운에서 "모두" 특수 값을 사용합니다. 드롭다운 매개 변수 설정에서 전체 특수 항목을 추가할 수 있습니다. 특별한 값을 사용할 수 있습니다. 전체 특수 항목을 올바르게 사용하면 쿼리를 크게 단순화할 수 있습니다.
누락된 열로부터 보호합니다. 사용자 지정 표 또는 사용자 지정 열을 사용하는 경우 작업 영역에 열이 없는 경우에 작동하도록 템플릿을 설계합니다. column_ifexists 함수를 참조하세요.
누락된 테이블로부터 보호합니다. 템플릿이 솔루션의 일부로 설치된 경우 또는 테이블의 존재가 보장되는 다른 경우에는 누락된 열을 확인할 필요가 없습니다. 모든 리소스 또는 작업 영역에서 볼 수 있는 일반 템플릿을 만드는 경우 존재하지 않는 테이블을 보호하는 것이 좋습니다. 로그 분석 쿼리 언어에는 열 테스트용 함수와 같은 table_ifexists 함수가 없습니다. 그러나 테이블이 있는지 확인하는 몇 가지 방법이 있습니다. 예를 들어 퍼지 통합을 사용할 수 있습니다. 통합을 수행할 때 isfuzzy=true 설정을 사용하여 일부 테이블이 없는 경우 통합을 계속할 수 있습니다. 테이블의 존재를 확인하고 존재하지 않는 경우 일부 콘텐츠를 숨기는 매개 변수 쿼리를 통합 문서에 추가할 수 있습니다. 표시되지 않는 항목은 실행되지 않으므로 테이블이 존재하지 않는 경우 실패할 통합 문서의 다른 쿼리가 테스트에서 테이블이 존재하는지 확인할 때까지 실행되지 않도록 템플릿을 설계할 수 있습니다.

예시:
```
let MissingTable = view () { print isMissing=1 };
union isfuzzy=true MissingTable, (AzureDiagnostics | getschema | summarize c=count() | project isMissing=iff(c > 0, 0, 1))
| top 1 by isMissing asc
```
이 쿼리는 AzureDiagnostics 테이블이 작업 영역에 없는 경우 1을 반환합니다. 실제 테이블이 없으면 MissingTable의 가짜 행이 반환됩니다. AzureDiagnostics 테이블의 스키마에 열이 있으면 0이 반환됩니다. 이를 매개 변수 값으로 사용할 수 있으며 매개 변수 값이 0이 아니면 쿼리 단계를 조건부로 숨길 수 있습니다. 또한 조건부 표시 유형을 사용하여 현재 작업 영역에 누락된 테이블이 없다는 텍스트를 표시하고 사용자를 온보딩 방법에 대한 설명서로 보낼 수 있습니다.

단계를 숨기는 대신 결과적으로 행이 없기를 원할 수 있습니다. MissingTable을 적절한 일치 스키마가 있는 빈 데이터 테이블로 변경할 수 있습니다.
```
let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')
```
이 경우 쿼리는 AzureDiagnostics 테이블이 없거나 ResourceId 열이 테이블에서 누락된 경우 행을 반환하지 않습니다.

자습서 - 통합 문서의 리소스 중심 로그 쿼리

다음 비디오에서는 Azure 통합 문서에서 리소스 수준 로그 쿼리를 사용하는 방법을 보여 줍니다. 또한 고급 시나리오를 사용하도록 설정하고 성능을 향상시키는 방법에 대한 팁과 힌트가 있습니다.

동적 리소스 형식 매개 변수

보다 효율적인 쿼리를 위해 동적 범위를 사용합니다. 아래 코드 조각에서는 이 추론을 사용합니다.

개별 리소스: 선택한 리소스 수가 5개 이하인 경우
리소스 그룹: 리소스 수가 5개를 초과하지만 리소스가 속한 리소스 그룹 수가 3개 이하인 경우
구독: 그렇지 않은 경우

Resources
| take 1
| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
| mvexpand x to typeof(string)
| extend jkey = 1
| join kind = inner (Resources
| where id in~ ({VirtualMachines})
| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
| extend jkey = 1) on jkey
| project x, label = 'x',
      selected = case(
        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true,
        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true,
        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true,
        false)

여러 리소스 종류를 쿼리하기 위한 정적 리소스 범위

[
    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
]

리소스 종류별로 그룹화된 리소스 매개 변수

Resources
| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets'
| where resourceGroup in~({ResourceGroups})
| project value = id, label = id, selected = false,
      group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets')

매개 변수 추가

매개 변수를 사용하여 소비자로부터 입력을 수집하고 통합 문서의 다른 부분에서 참조할 수 있습니다. 매개 변수를 사용하여 결과 집합의 범위를 지정하거나 적절한 시각적 개체를 설정합니다. 매개 변수는 대화형 보고서 및 환경을 빌드하는 데 도움이 됩니다. 매개 변수를 사용하는 방법에 대한 자세한 내용은 통합 문서 매개 변수를 참조하세요.

통합 문서를 사용하면 소비자에게 매개 변수 컨트롤을 텍스트 상자와 드롭다운 중에서, 단일 선택과 다중 선택 중에서, 텍스트나 JSON 또는 KQL의 값과 Azure Resource Graph 중에서 어떤 식으로 표시할지를 제어할 수 있습니다.

Azure Workbooks에서 매개 변수 및 로그 데이터를 사용하는 방법을 알아보려면 이 비디오를 시청하세요.

Azure 통합 문서에 매개 변수를 추가하려면 다음을 수행합니다.

도구 모음에서 편집을 선택하여 편집 모드로 전환합니다. 다음 단계 중 하나를 수행하여 매개 변수를 추가합니다.
- 기존 요소 아래 또는 통합 문서 아래쪽에서 추가, 매개 변수 추가를 차례로 선택합니다.
- 통합 문서의 요소 중 하나 옆에 있는 편집 단추 오른쪽의 줄임표(...)를 선택한 다음, 추가, 매개 변수 추가를 차례로 선택합니다.
나타나는 새 매개 변수 팝업 창에서 다음 필드의 값을 입력합니다.
- 매개 변수 이름: 매개 변수 이름은 공백이나 특수 문자를 포함할 수 없습니다.
- 표시 이름: 표시 이름에는 공백, 특수 문자, 이모지 등을 넣을 수 있습니다.
- 매개 변수 형식:
- 필수:
편집 완료를 선택합니다.

메트릭 차트 추가

대부분의 Azure 리소스는 CPU 사용률, 스토리지 가용성, 데이터베이스 트랜잭션 수, 실패한 앱 요청 수 등 상태에 대한 메트릭 데이터를 내보냅니다. 통합 문서를 사용하면 메트릭 데이터를 시계열 차트로 시각화할 수 있습니다.

아래 예제는 이전 시간 동안 스토리지 계정에서의 트랜잭션 수를 보여줍니다. 이를 통해 스토리지 소유자는 트랜잭션 추세를 보고 동작의 변칙을 찾을 수 있습니다.

Azure 통합 문서에 메트릭 차트를 추가하려면 다음을 수행합니다.

도구 모음에서 편집을 선택하여 편집 모드로 전환합니다. 다음 단계 중 하나를 수행하여 메트릭 차트를 추가합니다.
- 기존 요소 아래 또는 통합 문서 아래쪽에서 추가, 메트릭 추가를 차례로 선택합니다.
- 통합 문서의 요소 중 하나 옆에 있는 편집 단추 오른쪽의 줄임표(...)를 선택한 다음, 추가, 메트릭 추가를 차례로 선택합니다.
리소스 종류, 대상으로 지정할 리소스, 메트릭 네임스페이스 및 이름, 사용할 집계를 선택합니다.
필요한 경우 시간 범위, 분할 기준, 시각화, 크기, 색상표와 같은 다른 매개 변수를 설정합니다.
편집 완료를 선택합니다.

다음은 편집 모드의 메트릭 차트입니다.

메트릭 차트 매개 변수

매개 변수	설명	예시
리소스 종류	대상으로 지정할 리소스 종류	스토리지 또는 가상 머신입니다.
리소스	메트릭 값을 가져올 리소스 세트	MyStorage1
네임스페이스	메트릭이 있는 네임스페이스	Storage > Blob
메트릭	시각화할 메트릭	Storage > Blob > Transactions
집계	메트릭에 적용할 집계 함수	합계, 개수, 평균 등
시간 범위	메트릭을 볼 기간	지난 1시간, 지난 24시간 등
시각화	사용할 시각화	영역형, 막대형, 꺾은선형, 분산형, 그리드
분할 기준	필요에 따라 차원에서 메트릭 분할	지역 유형별 트랜잭션
크기	컨트롤의 수직 크기	소형, 중형, 또는 대형
색상표	차트에 사용할 색상표입니다. `Split by` 매개 변수가 사용되는 경우 무시됨	파랑, 녹색, 빨강 등

메트릭 차트 예

API 이름을 기준으로 분할된 트랜잭션(꺾은선형 차트)

응답 유형을 기준으로 분할된 트랜잭션(큰 막대형 차트)

평균 대기 시간(분산형 차트)

링크 추가

링크를 사용하여 통합 문서 내의 다른 보기, 통합 문서, 기타 항목에 대한 링크를 만들거나 통합 문서 내에서 탭 형식 보기를 만들 수 있습니다. 링크는 하이퍼링크, 단추 및 탭으로 스타일을 지정할 수 있습니다.

이 비디오를 시청하여 Azure Workbooks에서 탭, 그룹 및 컨텍스트 링크를 사용하는 방법을 알아봅니다.

링크 스타일

링크 요소 자체와 개별 링크에 스타일을 적용할 수 있습니다.

링크 요소 스타일

스타일	예제	주의
글머리 기호 목록		기본 링크는 각 줄에 하나씩 글머리 기호 링크 목록으로 표시됩니다. 링크 앞의 텍스트 및 링크 뒤의 텍스트 필드는 링크 항목 앞이나 뒤에 텍스트를 추가하는 데 사용할 수 있습니다.
List		링크가 글머리 기호 없이 링크 목록으로 표시됩니다.
단락		링크가 텍스트 단락처럼 래핑된 링크 단락으로 표시됩니다.
탐색		링크가 각 링크 사이에 세로 구분선 또는 파이프(`\|`)가 있는 링크로 표시됩니다.
탭		링크가 탭으로 표시됩니다. 각 링크는 탭으로 표시되고, 개별 링크에는 링크 스타일 옵션이 적용되지 않습니다. 탭을 구성하는 방법은 아래의 탭 섹션을 참조하세요.
도구 모음		링크는 아이콘과 텍스트가 있는 Azure Portal 스타일의 도구 모음으로 표시됩니다. 각 링크는 도구 모음 단추로 표시됩니다. 도구 모음을 구성하는 방법은 아래의 도구 모음 섹션을 참조하세요.

링크 스타일

스타일	설명
링크	기본적으로 링크는 하이퍼링크로 표시됩니다. URL 링크는 링크 스타일만 가능합니다.
단추(기본)	링크가 포털에서 "기본" 단추(일반적으로 파란색)로 표시됩니다.
단추(보조)	링크가 포털에서 "보조" 단추로 표시되며, 일반적으로 "투명한" 색, 밝은 테마의 흰색 단추 및 어두운 테마의 진한 회색 단추로 표시됩니다.

단추 텍스트, 도구 설명 텍스트 또는 값 필드에 필수 매개 변수를 사용하고 단추를 사용할 때 필수 매개 변수가 설정되지 않은 경우 단추가 비활성화됩니다. 예를 들어 이 기능을 사용하여 다른 매개 변수 또는 컨트롤에서 값이 선택되지 않은 경우 단추를 비활성화할 수 있습니다.

링크 작업

링크는 링크 작업에서 제공하는 모든 링크 작업을 사용할 수 있으며, 다음과 같은 두 가지 작업을 추가로 사용할 수 있습니다.

작업	설명
매개 변수 값 설정	링크, 단추 또는 탭을 선택할 때 매개 변수를 특정 값으로 설정할 수 있습니다. 탭은 종종 매개 변수를 특정 값으로 설정하도록 구성되며, 해당 값을 기반으로 통합 문서의 다른 부분을 숨기고 표시합니다.
단계로 스크롤	링크를 선택하면 통합 문서가 포커스를 이동하고 스크롤하여 다른 단계를 표시합니다. 이 작업을 사용하여 "목차"를 만들거나 "맨 위로 돌아가기" 스타일 환경을 만들 수 있습니다.

탭

대부분의 경우 탭 링크는 매개 변수 값 설정 작업과 결합됩니다. 다음은 2개의 탭을 만들도록 구성된 링크 단계를 보여주는 예제입니다. 두 탭 중 하나를 선택하면 selectedTab 매개 변수가 다른 값으로 설정됩니다. 이 예제에서는 매개 변수 이름 및 매개 변수 값 자리 표시자를 표시하도록 편집 중인 세 번째 탭을 보여줍니다.

그 후 고급 설정을 사용하여 selectedTab 매개 변수 값이 "1"일 때 조건부로 표시되는 다른 항목을 통합 문서에 추가할 수 있습니다.

첫 번째 탭은 기본적으로 선택되며, 처음에는 selectedTab을 1로 설정하고 해당 단계를 표시합니다. 두 번째 탭을 선택하면 매개 변수 값이 "2"로 변경되고 다른 콘텐츠가 표시됩니다.

위의 탭이 있는 샘플 통합 문서는 링크가 있는 샘플 Azure 통합 문서에서 사용할 수 있습니다. g

탭 제한 사항

URL 링크는 탭에서 지원되지 않습니다. 탭의 URL 링크는 비활성화된 탭으로 표시됩니다.
탭에서는 항목 스타일 지정이 지원되지 않습니다. 항목이 탭으로 표시되고, 탭 이름(링크 텍스트) 필드만 표시됩니다. 탭 스타일에 사용되지 않는 필드는 편집 모드에서 숨겨집니다.
첫 번째 탭은 기본적으로 선택되며, 탭이 지정한 작업을 호출합니다. 첫 번째 탭의 작업이 또 다른 보기를 열면 탭이 만들어지는 즉시 보기가 나타납니다.
탭을 사용하여 또 다른 보기를 열 수 있지만, 대부분의 사용자는 탭을 선택하여 탐색할 필요가 없으므로 이 기능은 드물게 사용됩니다. 다른 탭에서 매개 변수를 특정 값으로 설정하는 경우 보기를 여는 탭은 해당 값을 변경하지 않으므로 통합 문서 콘텐츠의 나머지 부분은 이전 탭의 보기/데이터를 계속 표시합니다.

Toolbars(도구 모음)

도구 모음 스타일을 사용하여 링크를 도구 모음 스타일로 표시할 수 있습니다. 도구 모음 스타일에서 작성자는 다음 항목에 대한 필드를 입력해야 합니다.

단추 텍스트 - 도구 모음에 표시할 텍스트입니다. 매개 변수는 이 필드에 사용할 수 있습니다.
아이콘 - 도구 모음에 표시할 아이콘입니다.
도구 설명 텍스트 - 도구 모음 단추의 도구 설명 텍스트에 표시할 텍스트입니다. 매개 변수는 이 필드에 사용할 수 있습니다.

단추 텍스트, 도구 설명 텍스트 또는 값 필드에 필수 매개 변수를 사용하는데 필수 매개 변수를 설정하지 않으면 도구 모음 단추가 비활성화됩니다. 예를 들어 다른 매개 변수/컨트롤에서 값이 선택되지 않으면 도구 모음 단추를 비활성화하는 데 사용할 수 있습니다.

도구 모음, 전역 매개 변수 및 ARM 작업이 포함된 샘플 통합 문서는 링크가 있는 샘플 Azure 통합 문서에서 사용할 수 있습니다.

그룹 추가

통합 문서에서 그룹 항목을 사용하면 통합 문서의 단계 세트를 논리적으로 그룹화할 수 있습니다.

통합 문서의 그룹은 다음과 같은 여러 경우에 유용합니다.

레이아웃: 항목을 세로로 구성하려면 위로 쌓이는 항목 그룹을 만들고 개별 항목의 백분율 너비를 설정하는 것이 아니라 그룹 스타일을 백분율 너비로 설정하면 됩니다.
가시성: 여러 항목을 함께 숨기거나 표시하려면 개별 항목의 표시 여부를 설정하는 것이 아니라 전체 항목 그룹의 표시 여부를 설정하면 됩니다. 그룹을 탭 콘텐츠로 사용할 수 있고 선택한 탭을 통해 설정된 매개 변수에 따라 전체 그룹을 숨기거나 표시할 수 있으므로 탭을 사용하는 템플릿에서 유용할 수 있습니다.
성능: 많은 섹션 또는 탭이 포함된 대형 템플릿이 있는 경우 각 섹션을 하위 템플릿으로 변환하고, 그룹을 사용하여 최상위 템플릿 내의 모든 하위 템플릿을 로드할 수 있습니다. 하위 템플릿의 콘텐츠는 사용자가 해당 그룹을 표시하도록 지정할 때까지 로드되거나 실행되지 않습니다. 크기가 큰 템플릿을 여러 템플릿으로 분할하는 방법에 대해 자세히 알아보세요.

통합 문서에 그룹을 추가하려면 다음을 수행합니다.

도구 모음에서 편집을 선택하여 편집 모드로 전환합니다. 다음 단계 중 하나를 수행하여 매개 변수를 추가합니다.
- 기존 요소 아래 또는 통합 문서 아래쪽에서 추가, 그룹 추가를 차례로 선택합니다.
- 통합 문서의 요소 중 하나 옆에 있는 편집 단추 오른쪽의 줄임표(...)를 선택한 다음, 추가, 그룹 추가를 차례로 선택합니다.
그룹에 대한 항목을 선택합니다.
편집 완료를 선택합니다.

다음은 내부에 텍스트 항목과 쿼리 항목이라는 두 개의 항목이 있는 읽기 모드의 그룹입니다.

편집 모드에서는 두 항목이 실제로 그룹 항목 내에 있는 것을 볼 수 있습니다. 아래 스크린샷에서 그룹은 편집 모드에 있습니다. 그룹의 파선 영역 내에는 두 개의 항목이 있습니다. 각 항목은 서로 독립적으로 편집 또는 읽기 모드로 전환할 수 있습니다. 예를 들어 쿼리 단계는 읽기 모드인 동안 텍스트 단계는 편집 모드일 수 있습니다.

그룹 범위 지정

그룹은 통합 문서에서 새 범위로 처리됩니다. 그룹에 만들어진 모든 매개 변수는 그룹 내에서만 표시됩니다. 병합의 경우에도 마찬가지로, 해당 그룹 내 또는 부모 수준에서만 데이터를 볼 수 있습니다.

그룹 종류

통합 문서에 추가할 그룹 유형을 지정할 수 있습니다. 두 가지 유형의 그룹이 있습니다.

편집 가능: 통합 문서의 그룹을 사용하여 그룹에서 항목 콘텐츠를 추가, 제거 또는 편집할 수 있습니다. 대부분 레이아웃 및 표시 여부를 나타내기 위해 사용됩니다.
템플릿에서: 통합 문서의 그룹은 ID를 통해 다른 통합 문서의 콘텐츠를 로드합니다. 통합 문서의 콘텐츠는 런타임 시 통합 문서로 로드되고 병합됩니다. 다음에 항목이 로드될 때 템플릿에서 다시 로드되므로 편집 모드에서 그룹 콘텐츠를 수정할 수 없습니다. 템플릿에서 그룹을 로드하는 경우 기존 통합 문서의 전체 Azure 리소스 ID를 사용합니다.

로드 유형

그룹의 콘텐츠가 로드되는 방법과 시기를 지정할 수 있습니다.

지연 로드

지연 로드가 기본값입니다. 지연 로드에서는 항목이 표시될 때만 그룹이 로드됩니다. 이렇게 하면 탭 항목에서 그룹을 사용할 수 있습니다. 탭을 선택하지 않으면 그룹이 표시되지 않으므로 콘텐츠가 로드되지 않습니다.

템플릿에서 만들어진 그룹은 그룹이 표시될 때까지 템플릿 콘텐츠가 검색되지 않으며 그룹에 항목이 만들어지지 않습니다. 콘텐츠가 검색되는 동안 전체 그룹의 진행률 회전자가 사용자에게 표시됩니다.

명시적 로드

이 모드에서는 그룹이 있을 위치에 단추가 표시되며 사용자가 명시적으로 단추를 선택하여 콘텐츠가 로드될 때까지 콘텐츠가 검색되거나 만들어지지 않습니다. 콘텐츠를 컴퓨팅하는 데 비용이 많이 들거나 콘텐츠가 거의 사용되지 않는 시나리오에 유용합니다. 작성자는 단추에 표시할 텍스트를 지정할 수 있습니다.

다음 스크린샷은 "추가 로드" 단추가 구성된 명시적 로드 설정을 보여줍니다.

다음은 통합 문서에 로드되기 전의 그룹입니다.

통합 문서에 로드된 후의 그룹입니다.

항상 모드

항상 모드에서는 통합 문서가 로드되는 즉시 그룹 콘텐츠가 항상 로드되고 만들어집니다. 콘텐츠가 항상 표시되는 레이아웃에만 그룹을 사용하는 경우 이 모드가 가장 많이 사용됩니다.

그룹 내 템플릿 사용

그룹이 템플릿에서 로드되도록 구성된 경우 해당 콘텐츠는 기본적으로 지연 모드로 로드되며, 그룹이 표시되는 경우에만 로드됩니다.

템플릿이 그룹으로 로드되는 경우 통합 문서는 템플릿에 선언된 모든 매개 변수를 이미 그룹에 있는 매개 변수와 병합하려고 시도합니다. 이름이 동일하고 통합 문서에 이미 있는 매개 변수는 로드되는 템플릿에서 병합됩니다. 매개 변수 단계의 모든 매개 변수가 병합되면 전체 매개 변수 단계가 사라집니다.

예제 1: 모든 매개 변수의 이름이 같음

맨 위에 시간 범위 매개 변수와 "Filter"라는 텍스트 매개 변수의 두 개 매개 변수가 있는 템플릿이 있다고 가정하겠습니다.

그러면 그룹 항목은 매개 변수 이름이 동일하게 지정되고 고유한 두 개의 매개 변수와 한 개의 텍스트 단계가 있는 두 번째 템플릿을 로드합니다.

두 번째 템플릿이 그룹에 로드되면 중복된 매개 변수가 병합됩니다. 모든 매개 변수가 병합되므로 내부 매개 변수 단계도 병합되고, 결국 그룹은 텍스트 단계만 포함하게 됩니다.

예 2: 한 매개 변수의 이름이 같음

맨 위에 시간 범위 매개 변수와 "FilterB"라는 텍스트 매개 변수의 두 개 매개 변수가 있는 템플릿이 있다고 가정하겠습니다.

그룹의 항목 템플릿이 로드되면 TimeRange 매개 변수가 그룹에서 병합됩니다. 통합 문서에는 TimeRange 및 Filter를 사용하는 초기 매개 변수 단계가 포함되고, 그룹의 매개 변수에는 FilterB만 포함됩니다.

로드된 템플릿에 FilterB가 아닌 TimeRange 및 Filter가 포함된 경우 결과 통합 문서에는 텍스트 단계만 남은 그룹 및 매개 변수 단계가 포함됩니다.

대형 템플릿을 여러 템플릿으로 분할하는 방법

성능 향상을 위해 일부 콘텐츠를 지연 모드로 로드하거나 사용자가 요청 시 로드하는 크기가 큰 템플릿을 여러 개의 작은 템플릿으로 분할하면 유용합니다. 이렇게 하면 최상위 템플릿이 크기가 더 작아질 수 있으므로 초기 로드 속도가 빨라집니다.

템플릿을 여러 부분으로 분할하는 경우 기본적으로 각 부분이 개별적으로 작동하는 여러 템플릿(하위 템플릿)으로 템플릿을 분할해야 합니다. 다른 항목에서 사용하는 TimeRange 매개 변수가 최상위 템플릿에 있는 경우 정확하게 같은 이름으로 매개 변수를 정의하는 매개 변수 항목이 하위 템플릿에 있어야 합니다. 하위 템플릿은 독립적으로 작동하며 그룹의 더 큰 템플릿 내부에 로드할 수 있습니다.

더 큰 템플릿을 여러 개의 하위 템플릿으로 전환하려면 다음을 수행합니다.

공유 매개 변수 다음에 있는 통합 문서 위쪽 근처에 비어 있는 새 그룹을 만듭니다. 이 새 그룹이 결국에는 하위 템플릿이 됩니다.
공유 매개 변수 단계의 복사본을 만든 다음 ‘그룹으로 이동’을 사용하여 1단계에서 만든 그룹으로 복사본을 이동합니다. 이 매개 변수는 하위 템플릿이 외부 템플릿과 독립적으로 작동할 수 있게 하며, 외부 템플릿 내에서 로드될 때 병합됩니다.

참고 항목

하위 템플릿 자체를 표시할 계획이 전혀 없는 경우 하위 템플릿에는 병합되는 매개 변수가 필요 없습니다. 그러나 하위 템플릿에 매개 변수가 없으면 나중에 필요할 때 하위 템플릿을 편집하거나 디버그하기가 매우 어렵습니다.
하위 템플릿에 포함할 통합 문서의 각 항목을 1단계에서 만든 그룹으로 이동합니다.
3단계에서 이동된 개별 단계에 조건부 표시 여부가 있는 경우 이는 외부 그룹의 표시 여부입니다(예: 탭에서 사용됨). 그룹 내 항목에서 제거하고 그룹 자체에 해당 표시 여부 설정을 추가합니다. 변경 내용이 손실되지 않도록 여기에서 저장하거나 JSON 콘텐츠의 복사본을 내보내서 저장합니다.
해당 그룹이 템플릿에서 로드되도록 하려면 그룹에서 ‘편집’ 도구 모음 단추를 사용할 수 있습니다. 이렇게 하면 해당 그룹의 콘텐츠만 통합 문서로 새 창에 열립니다. 그러면 해당 통합 문서를 적절히 저장하고 이 통합 문서 보기를 닫을 수 있습니다. 브라우저를 닫지 말고 해당 보기만 닫아야 편집 중인 이전 통합 문서로 돌아갑니다.
그런 다음, 그룹 단계가 템플릿에서 로드되도록 변경하고 템플릿 ID 필드를 5단계에서 만든 통합 문서/템플릿으로 설정할 수 있습니다. 통합 문서 ID를 사용하려면 원본이 공유 통합 문서의 전체 Azure 리소스 ID여야 합니다. 로드를 누르면 이제 해당 그룹의 콘텐츠가 이 외부 통합 문서 내에 저장되지 않고 해당 하위 템플릿에서 로드됩니다.