참조 자료 문서 스키마 매핑 구성

아티클
12/08/2023

Customer Service에서 통합 검색 제공자 추가의 일부로 제공자로부터 받은 참조 문서를 수집하는 방법을 서비스에 알려야 합니다. 참조 문서 스키마를 선택하고 구성하면 됩니다. 구성을 저장한 후에는 스키마를 변경할 수 없습니다.

인증 및 테스트 섹션에서 언어 필터를 적용한 경우 JSON 스키마 또는 참조 문서 스키마 매핑 섹션에서 언어 로캘에 대한 매핑을 유지해야 합니다. 언어 로캘 값에 대한 자세한 내용은 언어(LanguageLocale) 테이블/엔터티 참조를 참조하십시오.

참조 문서 스키마 섹션에서 옵션을 선택합니다.

필드 매핑
JSON 스키마

필드 매핑

메타데이터 선택을 위한 파일을 선택하고 업로드한 다음 매핑에 사용할 메타태그를 선택합니다. 필드 매핑을 사용하면 작업 유형에 따라 검색 공급자(소스 속성)로부터 받은 참조 문서를 참조 문서 엔터티(대상)의 속성에 매핑합니다.

메타데이터 선택을 위한 파일 선택 및 업로드

문서를 웹 페이지, HTML 전용 파일로 로컬에 저장합니다. 파일 이름이 99자 미만인지 확인하십시오.
Customer Service 관리 센터 사이트 맵, 지식 문서 스키마>필드 매핑 섹션에서 파일 선택을 선택하여 파일을 업로드합니다.

HTML 파일에 있는 모든 메타 태그는 메타 태그 설정 섹션에 나열됩니다.
아래 메타 태그 모두 선택을 선택하거나 매핑해야 하는 메타 태그만 선택합니다.

여기서 선택한 메타 태그는 매핑 섹션에서 소스 속성으로 선택할 수 있는 속성이 됩니다. 아무 것도 선택하지 않으면 기본 소스 속성인 HTML-Title 및 HTML-Body만 매핑할 수 있습니다.
맵핑 섹션으로 이동하려면 다음을 선택하십시오. 중지하고 나중에 이 지점으로 돌아가려면 초안으로 저장을 선택합니다.

문서 특성 매핑

작업 유형을 사용하여 소스 속성을 대상에 매핑합니다.

문서 특성: 참조 문서 대상 필드 값입니다.
작업 유형: 참조 문서 엔터티의 문서 특성에 소스 문서를 매핑하는 매핑 패턴입니다. 작업 유형 매핑 옵션에 대해 자세히 알아보세요.
소스 속성: 각 작업 유형에 대해 정의하는 값입니다. 예를 들어 직접 작업 유형을 선택한 경우 이전에 선택한 메타 태그 또는 HTML-Title 태그 중에서 선택해야 합니다.

Customer Service 관리 센터 사이트 맵, 매핑 섹션에서 필수 기술 자료 특성은 콘텐츠, 외부 참조 ID 및 제목입니다. 각각에 대해 작업 유형과 소스 속성을 선택합니다.

외부 참조 ID 값이 고유한지 확인하십시오.
문서 특성을 더 추가하려면 행 추가를 선택한 다음 문서 특성, 작업 유형 및 소스 속성을 선택합니다.

필요한 경우 삭제를 선택하여 문서 특성을 삭제할 수도 있습니다.
매핑 유효성 검사를 선택합니다.

서비스는 입력한 값을 사용하여 업로드한 HTML 파일에 대한 특성 값을 결정합니다. 매핑 테이블 및 Regex 패턴의 항목을 확인합니다. RegexUrl에 대한 유효성 검사가 없습니다.

유효성 검사가 성공하면 확인 메시지가 표시됩니다. 유효성 검사에 실패하면 오류 메시지가 표시됩니다. 오류 메시지에 따라 매핑 테이블의 항목 또는 입력한 regex 패턴을 확인하십시오.
다음을 선택하여 다음 섹션으로 이동합니다. 중지하고 나중에 이 지점으로 돌아가려면 초안으로 저장을 선택합니다.

작업 유형 매핑 옵션

다음 작업 유형 매핑 옵션 중에서 선택합니다.

Regex: regex 패턴을 사용하여 소스 웹 사이트에서 값을 추출합니다. 소스 속성은 regex 패턴을 입력할 수 있는 텍스트 필드입니다. 이 패턴과 일치하는 웹 사이트 HTML의 문자열은 해당 참조 문서 필드에 매핑됩니다.

regex 패턴에는 일치하는 텍스트의 특정 부분을 추출할 수 있도록 괄호로 묶인 캡처 그룹이 있어야 합니다. 텍스트는 첫 번째 일치 항목의 비어 있지 않은 첫 번째 그룹에서 추출됩니다.

다음은 특정 div 태그에서 콘텐츠를 추출하는 regex 패턴의 몇 가지 예입니다.
- Div 태그 ID 기반: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
- Div 태그 클래스 기반: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
- Body 태그 내부 콘텐츠의 경우: <body[^>]*>([\s\S]*)<\/body>
- Head 태그 내부 콘텐츠의 경우: <head[^>]*>([\s\S]*)<\/head>
Direct: 소스 웹 사이트의 모든 메타 태그 값을 참조 문서 필드에 직접 매핑합니다. 소스 속성 목록에는 기본적으로 사용 가능한 소스 속성 HTML-Title 및 HTML-Body와 함께 샘플 웹 사이트에서 추출된 모든 메타 태그가 표시됩니다.

작업 유형으로 Direct를 선택하고 소스 속성으로 og: url을 선택한 경우 og: url 소스 속성의 메타 태그가 해당 참조 문서 속성에 매핑됩니다.
상수: 지식 항목 필드에 상수 값을 입력합니다. 소스 속성은 상수 값을 입력할 수 있는 텍스트 필드입니다.
RegexUrl: Regex와 비슷하지만 소스 웹 사이트의 URL에서만 일치 항목을 찾습니다. 전체 소스 웹 사이트 URL을 지식 속성 필드에 매핑하려면 오퍼레이션 유형에서 Regexurl을 선택하고 소스 속성에 (. *) 패턴을 사용하십시오.

다음은 문서 특성을 매핑하는 방법을 설명하는 예입니다.

예

샘플 HTML:

<html>
<head>
	<meta charset="utf-8" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
	<meta property="og:type" content="website" />
	<meta property="og:url" content="https://contoso.com/en-us/id/2911cacd-efa5-4593-ae22-e09ae14c6698/ee734739(v=msdn.10)" />
	<meta name="ms.keywords" content="XML Reader, WS-Trust" />
</head>	
<title>WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn</title>
<body lang="en-us" dir="ltr">
	<div id="ms-descriptionArticle">
	 Checks if an XML reader is positioned at a WS-Trust RequestSecurityToken element. This is crucial for handling security token requests in .NET applications using Windows Identity Foundation (WIF).
	</div>
	<div id="ms--content-well-notifications" data-bi-name="content-well-notification">
	</div>
	<p>Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5</p>
	<p>When implemented in a derived class, checks if the specified XML reader is positioned at a WS-Trust RequestSecurityToken element.</p>
	<p><strong>Namespace:</strong> Microsoft.IdentityModel.Protocols.WSTrust<br/>
	<strong>Assembly:</strong> Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)</p>
	<h2 id="usage">Usage</h2>
	<pre><code class="lang-vb">'Usage
	Dim instance As WSTrustRequestSerializer
	Dim reader As XmlReader
	Dim returnValue As Boolean

	returnValue = instance.CanRead(reader)
	</code></pre>
	<h4 id="parameters">Parameters</h4>
	<ul>
	<li><strong>reader</strong><br/>
	The XmlReader object from which to read.</li>
	</ul>
	<h4 id="return-value">Return Value</h4>
	<p><strong>true</strong> if the reader is positioned at an RST element that the serializer can read; otherwise, <strong>false</strong>.</p>
</body>
</html>

다음 작업 유형을 사용하여 소스 속성을 샘플 HTML 파일의 대상에 매핑합니다.

스크린샷은 선택한 HTML 파일의 매핑을 설명합니다.

위치,

문서 특성: 콘텐츠
작업 유형: Regex
소스 속성: <body[^>]>([\s\S])</body>

샘플 regex는 HTML 파일의 본문 태그 내부에 있는 전체 콘텐츠를 추출합니다.

문서 특성: 외부 참조 ID
작업 유형: RegexUrl
소스 속성: ^https://.?/id/(.?)/.*$

RegexUrl은 HTML 파일에서 ID - 2911cacd-efa5-4593-ae22-e09ae14c6698를 추출합니다.

문서 특성: 제목
작업 유형: Direct
소스 속성: HTML-제목

Direct는 HTML 파일의 제목 필드 내의 콘텐츠를 추출합니다(예: WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn)

문서 특성: 설명
작업 유형: Regex
소스 속성: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

샘플 regex는 ID를 기반으로 특정 div 태그에서 콘텐츠를 추출합니다. 여기서 ms-desciptionArticle은 html에 있는 div 태그의 ID입니다.

문서 특성: 키워드
작업 유형: Direct
소스 속성: ms.keywords

Direct는 HTML 파일(예: XML Reader, WS-Trust)의 ms.keywords 필드 내 콘텐츠를 추출합니다.

JSON 스키마

메타데이터 매핑 템플릿을 구축하기 위한 스키마 세부 정보에 대해 자세히 알아보기.

Customer Service 관리 센터 사이트 맵의 참조 문서 스키마>JSON 스키마 섹션에서 문서 속성과 스키마 JSON을 복사하여 제공된 필드에 붙여넣습니다.
JSON 유효성 확인을 선택합니다.

유효성 검사가 성공하면 확인 메시지가 표시됩니다. 유효성 검사에 실패하면 값이 잘못된 매개 변수를 식별하는 오류 메시지가 표시됩니다.
다음을 선택하여 다음 섹션으로 이동합니다. 중지하고 나중에 이 지점으로 돌아가려면 초안으로 저장을 선택합니다.

다음 단계

통합 검색 공급자 관리

다음을 통해 공유