---
sourceDocument: 호주 고객 서비스 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/customer-service-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 고객 서비스 관리

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# AEM 페이지에 ServiceNow 지식 문서 표시

# Adobe Experience Manager 페이지에서 ServiceNow 지식 문서 표시 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분

AEM(Adobe Experience Manager) 내에서 이용 가능한 지식 구성요소를 사용하여 ServiceNow 인스턴스에서 지식베이스에 액세스하고 AEM 기반 웹 사이트에 관련 지식 문서를 표시합니다.

## 시작하기 전에

* 지식 문서에 대한 지식 관리 REST API 엔드포인트를 사용하도록 Knowledge API 플러그인(sn_km_api)을 활성화합니다. 자세한 내용은 [지식 관리 REST API](https://www.servicenow.com/docs/access?context=knowledge-api&version=australia&pubname=australia-api-reference&ft:locale=en-US)를 참조하십시오.
* AEM 인스턴스에서 Knowledge API에 액세스하려면 교차 원본 자원 공유(CORS) 규칙을 정의합니다. 자세한 내용은 [AEM에서 API 엔드포인트에 액세스하기 ServiceNow 위한 교차 원본 자원 공유 규칙(CORS) 정의](https://servicenow-prod.fluidtopics.net/SrrKx8DnptuWvpXUgP~QpA#aem-set-cors-rules "AEM(Adobe Experience Manager) 인스턴스에서 지식 관리 REST API, Case API 또는 CSM 첨부 파일 API 엔드포인트에 액세스하려면 ServiceNow 인스턴스에 교차 원본 자원 공유(CORS) 규칙을 정의합니다.") 문서를 참조하십시오.

{#aem-display-knowledge-components__ul_a5r_1lt_flb}

필요한 역할: AEM 작성자

## 프로시저

1. AEM 인스턴스에 로그인합니다.
2. [편집 모드에서](https://helpx.adobe.com/in/experience-manager/6-5/sites/authoring/using/author-environment-tools.html#main-pars_title_20) AEM 페이지를 엽니다.
3. [구성요소 브라우저](https://helpx.adobe.com/in/experience-manager/6-5/sites/authoring/using/author-environment-tools.html#main-pars_title_17)를 엽니다.
4. 모두 목록에서 ServiceNow를 선택합니다.
5. 페이지에서 원하는 위치로 구성요소를 끌어옵니다.  
   주:  
   구성요소를 사용할 수 없는 경우에는 지식 구성요소를 포함하도록 템플릿 구성을 업데이트합니다. 또한 사이트 템플릿의 속성을 수정하고 각 지식 문서 구성요소를 허용되는 구성요소 목록에 추가해야 합니다.
6. [편집을 위해 구성요소 대화 상자](https://helpx.adobe.com/in/experience-manager/6-5/sites/authoring/using/editing-content.html#ComponentEditDialog)를 엽니다.  
   주:  
   기본적으로 로그인하지 않은 익명 AEM 사용자인 공개 사용자는 AEM 페이지의 편집 모드에 있는 지식 구성요소에 액세스할 수 없습니다. 기본 동작을 변경하려면 각 지식 구성요소에 대해 공개 속성을 사용하도록 설정해야 합니다.
7. 인스턴스의 지식베이스 ServiceNow 에서 가져온 지식 문서 목록을 포함하는 지식 검색 결과를 표시하도록 검색 결과 구성요소 속성을 설정합니다.  
   {#aem-display-knowledge-components__table_kx2_4q2_tkb__entry__2}{#aem-display-knowledge-components__component-public-desc}{#aem-display-knowledge-components__component-kb-desc}{#aem-display-knowledge-components__component-lan-desc}{#aem-display-knowledge-components__component-search-desc}{#aem-display-knowledge-components__component-secondary-desc}{#aem-display-knowledge-components__component-article-page-desc}

   | 속성 | 설명 |
   |-|-|
   | 공개 | 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. |
   | 지식베이스 | 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다. 주: 값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow |
   | 언어 | 지식 문서 검색 결과를 다양한 언어로 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다. * ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다. * 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다. * 모든 언어: 지식 문서는 모든 언어로 표시됩니다. {#aem-display-knowledge-components__ul_o4d_wjp_tkb} |
   | 검색 매개변수 | 검색 쿼리의 매개변수 키입니다. 예: <kbd class="ph userinput">kb_query</kbd> |
   | 보조 필드 | 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예: `작성자,sys_view_count,sys_updated_on,등급` |
   | 검색 결과 수 | 검색 결과 목록에 포함되는 최대 문서 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 <kbd class="ph userinput">1</kbd>보다 커야 합니다. |
   | 문서 페이지 URL | 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html |
   | 사용자 지정 CSS 클래스 | 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 [AEM에서 ServiceNow 구성요소 색상 사용자 지정](https://servicenow-prod.fluidtopics.net/5V3t2mCHujlVuiJGPu_fYQ#aem-style-components "Adobe Experience Manager(AEM)에서 색상을 지정하여 ServiceNow 구성요소의 모양과 느낌을 정의할 수 있습니다.") 문서를 참조하십시오. |
   [표 1. 검색 결과 구성요소 속성]

   {#aem-display-knowledge-components__table_kx2_4q2_tkb}
8. 사용자가 검색 텍스트를 입력하고 검색 텍스트와 일치하는 인스턴스에서 ServiceNow 지식 문서를 찾을 수 있는 검색 상자를 표시하도록 검색 상자 구성요소 속성을 설정합니다.  
   주:  
   검색 상자 구성요소에서 검색을 트리거하면 검색 결과 구성요소가 표시됩니다.
   {#aem-display-knowledge-components__table_cbh_dlp_tkb__entry__2}

   | 속성 | 설명 |
   |-|-|
   | 공개 | 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. |
   | 자리 표시자 | 검색할 수 있는 항목 또는 검색 텍스트의 조건에 대한 정보를 제공하기 위해 검색 상자에 표시되는 힌트 텍스트입니다. 예: <kbd class="ph userinput">검색(최소 3자)</kbd> |
   | 지식베이스 | 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다. 주: 값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow |
   | 언어 | 지식 문서를 검색 상자에 다양한 언어로 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다. * ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다. * 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다. * 모든 언어: 지식 문서는 모든 언어로 표시됩니다. {#aem-display-knowledge-components__ul_bgj_5ck_vkb} |
   | 검색 페이지 URL | 리디렉션할 검색 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_search.html |
   | 검색 매개변수 | 검색 쿼리의 매개변수 키입니다. 예: <kbd class="ph userinput">kb_query</kbd> |
   | 자동 완성 | 자동 완성 검색 사용 옵션입니다. |
   | 자동 완성 검색 결과 개수 | 자동 완성 검색 결과 목록에 포함할 최대 문서 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 <kbd class="ph userinput">1</kbd>보다 커야 합니다. |
   | 문서 페이지 URL | 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html |
   | 사용자 지정 CSS 클래스 | 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 [AEM에서 ServiceNow 구성요소 색상 사용자 지정](https://servicenow-prod.fluidtopics.net/5V3t2mCHujlVuiJGPu_fYQ#aem-style-components "Adobe Experience Manager(AEM)에서 색상을 지정하여 ServiceNow 구성요소의 모양과 느낌을 정의할 수 있습니다.") 문서를 참조하십시오. |
   [표 2. 검색 상자 구성요소 속성]

   {#aem-display-knowledge-components__table_cbh_dlp_tkb}
9. 지식 문서와 해당 첨부 파일(사용 가능한 경우)을 인스턴스에서 ServiceNow 표시하도록 문서 뷰 구성요소 속성을 설정합니다.  
   {#aem-display-knowledge-components__table_tfp_h4q_tkb__entry__2}

   | 속성 | 설명 |
   |-|-|
   | 공개 | 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. |
   | 문서 매개변수 | 문서 번호의 URL 쿼리 매개변수 이름입니다. 예: <kbd class="ph userinput">kb_article</kbd> |
   | 보조 필드 | 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예: `작성자,sys_view_count,sys_updated_on,등급` |
   | 언어 매개변수 | 지식 문서에 대해 요청된 언어를 포함하는 URL 쿼리 매개변수의 이름입니다. 예: <kbd class="ph userinput">kb_lang</kbd> |
   | 사용자 지정 CSS 클래스 | 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 [AEM에서 ServiceNow 구성요소 색상 사용자 지정](https://servicenow-prod.fluidtopics.net/5V3t2mCHujlVuiJGPu_fYQ#aem-style-components "Adobe Experience Manager(AEM)에서 색상을 지정하여 ServiceNow 구성요소의 모양과 느낌을 정의할 수 있습니다.") 문서를 참조하십시오. |
   [표 3. 문서 뷰 구성요소 속성]

   {#aem-display-knowledge-components__table_tfp_h4q_tkb}
10. 목록 기준에 따라 지식 문서 목록을 표시하도록 문서 목록 구성요소 속성을 설정합니다.  
    {#aem-display-knowledge-components__table_ywq_wbr_tkb__entry__2}

    | 속성 | 설명 |
    |-|-|
    | 공개 | 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. |
    | 직위 | 구성요소 헤더로 표시되는 문서 목록에 해당하는 제목입니다. 예: <kbd class="ph userinput">가장 많이 본 문서</kbd> |
    | 지식베이스 | 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다. 주: 값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow |
    | 언어 | 지식 문서를 볼 때 다양한 언어로 문서를 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다. * ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다. * 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다. * 모든 언어: 지식 문서는 모든 언어로 표시됩니다. {#aem-display-knowledge-components__ul_cjd_xgn_vkb} |
    | 보조 필드 | 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예: `작성자,sys_view_count,sys_updated_on,등급` |
    | 기준 | 지식 문서 목록의 기준 목록입니다. 다음 옵션 중 하나를 선택합니다. * 추천: 속성에 구성된 키워드를 기반으로 하는 주요 지식 문서 목록입니다 glide.knowman.default_keyword . 추천 문서에 대한 자세한 내용은 [추천 컨텐츠에 지식 문서 추가](https://www.servicenow.com/docs/access?context=t_PinAnArticle&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 및 [지식 속성을](https://www.servicenow.com/docs/access?context=r_KnowledgeProperties&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하십시오. * 최다 조회: 가장 많이 본 지식 문서 목록입니다. {#aem-display-knowledge-components__ul_gyg_qjs_tkb} |
    | 문서 개수 | 문서 목록에 포함할 문서의 최대 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 <kbd class="ph userinput">1</kbd>보다 커야 합니다. |
    | 문서 페이지 URL | 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html |
    | 비어 있을 때 구성요소 숨기기 | 표시할 지식 문서가 없을 때 구성요소를 숨길 수 있는 옵션입니다. |
    | 사용자 지정 CSS 클래스 | 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 [AEM에서 ServiceNow 구성요소 색상 사용자 지정](https://servicenow-prod.fluidtopics.net/5V3t2mCHujlVuiJGPu_fYQ#aem-style-components "Adobe Experience Manager(AEM)에서 색상을 지정하여 ServiceNow 구성요소의 모양과 느낌을 정의할 수 있습니다.") 문서를 참조하십시오. |
    [표 4. 문서 목록 구성요소 속성]

    {#aem-display-knowledge-components__table_ywq_wbr_tkb}
{#aem-display-knowledge-components__steps_vqd_flt_flb}