Adobe Experience Manager 페이지에서 ServiceNow 지식 문서 표시
AEM(Adobe Experience Manager) 내에서 이용 가능한 지식 구성요소를 사용하여 ServiceNow 인스턴스에서 지식베이스에 액세스하고 AEM 기반 웹 사이트에 관련 지식 문서를 표시합니다.
시작하기 전에
- 지식 문서에 대한 지식 관리 REST API 엔드포인트를 사용하도록 Knowledge API 플러그인(sn_km_api)을 활성화합니다. 자세한 내용은 지식 관리 REST API를 참조하십시오.
- AEM 인스턴스에서 Knowledge API에 액세스하려면 교차 원본 자원 공유(CORS) 규칙을 정의합니다. 자세한 내용은 AEM에서 API 엔드포인트에 액세스하기 ServiceNow 위한 교차 원본 자원 공유 규칙(CORS) 정의 문서를 참조하십시오.
필요한 역할: AEM 작성자
프로시저
- AEM 인스턴스에 로그인합니다.
- 편집 모드에서 AEM 페이지를 엽니다.
- 구성요소 브라우저를 엽니다.
- 모두 목록에서 ServiceNow를 선택합니다.
-
페이지에서 원하는 위치로 구성요소를 끌어옵니다.
주:구성요소를 사용할 수 없는 경우에는 지식 구성요소를 포함하도록 템플릿 구성을 업데이트합니다. 또한 사이트 템플릿의 속성을 수정하고 각 지식 문서 구성요소를 허용되는 구성요소 목록에 추가해야 합니다.
-
편집을 위해 구성요소 대화 상자를 엽니다.
주:기본적으로 로그인하지 않은 익명 AEM 사용자인 공개 사용자는 AEM 페이지의 편집 모드에 있는 지식 구성요소에 액세스할 수 없습니다. 기본 동작을 변경하려면 각 지식 구성요소에 대해 공개 속성을 사용하도록 설정해야 합니다.
-
인스턴스의 지식베이스 ServiceNow 에서 가져온 지식 문서 목록을 포함하는 지식 검색 결과를 표시하도록 검색 결과 구성요소 속성을 설정합니다.
표 1. 검색 결과 구성요소 속성 속성 설명 공개 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. 지식베이스 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다.
주:값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow언어 지식 문서 검색 결과를 다양한 언어로 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다.- ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다.
- 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다.
- 모든 언어: 지식 문서는 모든 언어로 표시됩니다.
검색 매개변수 검색 쿼리의 매개변수 키입니다. 예: kb_query
보조 필드 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예:
작성자,sys_view_count,sys_updated_on,등급검색 결과 수 검색 결과 목록에 포함되는 최대 문서 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 1보다 커야 합니다.
문서 페이지 URL 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html
사용자 지정 CSS 클래스 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 AEM에서 ServiceNow 구성요소 색상 사용자 지정 문서를 참조하십시오. -
사용자가 검색 텍스트를 입력하고 검색 텍스트와 일치하는 인스턴스에서 ServiceNow 지식 문서를 찾을 수 있는 검색 상자를 표시하도록 검색 상자 구성요소 속성을 설정합니다.
주:검색 상자 구성요소에서 검색을 트리거하면 검색 결과 구성요소가 표시됩니다.
표 2. 검색 상자 구성요소 속성 속성 설명 공개 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. 자리 표시자 검색할 수 있는 항목 또는 검색 텍스트의 조건에 대한 정보를 제공하기 위해 검색 상자에 표시되는 힌트 텍스트입니다. 예: 검색(최소 3자)
지식베이스 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다.
주:값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow언어 지식 문서를 검색 상자에 다양한 언어로 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다.- ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다.
- 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다.
- 모든 언어: 지식 문서는 모든 언어로 표시됩니다.
검색 페이지 URL 리디렉션할 검색 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_search.html
검색 매개변수 검색 쿼리의 매개변수 키입니다. 예: kb_query
자동 완성 자동 완성 검색 사용 옵션입니다. 자동 완성 검색 결과 개수 자동 완성 검색 결과 목록에 포함할 최대 문서 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 1보다 커야 합니다.
문서 페이지 URL 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html
사용자 지정 CSS 클래스 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 AEM에서 ServiceNow 구성요소 색상 사용자 지정 문서를 참조하십시오. -
지식 문서와 해당 첨부 파일(사용 가능한 경우)을 인스턴스에서 ServiceNow 표시하도록 문서 뷰 구성요소 속성을 설정합니다.
표 3. 문서 뷰 구성요소 속성 속성 설명 공개 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. 문서 매개변수 문서 번호의 URL 쿼리 매개변수 이름입니다. 예: kb_article
보조 필드 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예:
작성자,sys_view_count,sys_updated_on,등급언어 매개변수 지식 문서에 대해 요청된 언어를 포함하는 URL 쿼리 매개변수의 이름입니다. 예: kb_lang
사용자 지정 CSS 클래스 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 AEM에서 ServiceNow 구성요소 색상 사용자 지정 문서를 참조하십시오. -
목록 기준에 따라 지식 문서 목록을 표시하도록 문서 목록 구성요소 속성을 설정합니다.
표 4. 문서 목록 구성요소 속성 속성 설명 공개 공용 사용자가 구성요소 컨텐츠를 볼 수 있도록 하는 옵션입니다. 선택하면 구성요소에 포함된 인증되지 않은 사용자가 사용할 수 있는 지식 문서를 공용 사용자를 비롯한 모든 사용자가 사용할 수 있습니다. 직위 구성요소 헤더로 표시되는 문서 목록에 해당하는 제목입니다. 예: 가장 많이 본 문서
지식베이스 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id)입니다. 필드 추가를 클릭하고 지식베이스의 sys_id 입력합니다. 항목을 여러 개 추가할 수 있습니다.
주:값을 추가하지 않으면 OSGi 구성 설정의 지식베이스가 구성요소에 사용됩니다.ServiceNow언어 지식 문서를 볼 때 다양한 언어로 문서를 표시할 수 있도록 합니다. 다음 옵션 중 하나를 선택합니다.- ServiceNow OSGi 구성에서 선택: 구성요소에 대한 OSGi 구성에 구성된 언어로 지식 문서가 표시됩니다.ServiceNow 이 값은 기본적으로 선택됩니다.
- 포털 언어로 제한: 지식 문서는 AEM 사이트에 구성된 언어로 표시됩니다.
- 모든 언어: 지식 문서는 모든 언어로 표시됩니다.
보조 필드 문서와 함께 표시되는 지식 문서의 메타데이터입니다. 메타데이터에는 작성자, 문서가 마지막으로 업데이트된 날짜, 마지막으로 문서를 본 날짜 등의 정보가 포함됩니다. 여러 항목을 입력하는 경우 필드를 쉼표로 구분합니다. 예:
작성자,sys_view_count,sys_updated_on,등급기준 지식 문서 목록의 기준 목록입니다. 다음 옵션 중 하나를 선택합니다. - 추천: 속성에 구성된 키워드를 기반으로 하는 주요 지식 문서 목록입니다 glide.knowman.default_keyword . 추천 문서에 대한 자세한 내용은 추천 컨텐츠에 지식 문서 추가 및 지식 속성을 참조하십시오.
- 최다 조회: 가장 많이 본 지식 문서 목록입니다.
문서 개수 문서 목록에 포함할 문서의 최대 수입니다. 증가 또는 감소 아이콘을 사용하여 값을 높이거나 낮출 수 있습니다. 값을 수동으로 입력할 수도 있습니다. 값은 1보다 커야 합니다.
문서 페이지 URL 리디렉션할 문서 페이지의 상대 URL입니다. 예: /content/NOWApp/now_article_view.html
비어 있을 때 구성요소 숨기기 표시할 지식 문서가 없을 때 구성요소를 숨길 수 있는 옵션입니다. 사용자 지정 CSS 클래스 이 구성요소에 사용자 지정 스타일을 적용하기 위한 사용자 지정 CSS 클래스입니다. 자세한 내용은 AEM에서 ServiceNow 구성요소 색상 사용자 지정 문서를 참조하십시오.