Tietoartikkelien rakenteen yhdistämismäärityksen määrittäminen

Osana integroidun hakupalvelun lisäämistä Customer Servicessa palvelulle on kerrottava, miten palvelulta saatuja tietämysartikkeleita käsitellään. Voit tehdä tämän valitsemalla tietoartikkelirakenteen ja määrittämällä sen asetukset. Rakennetta ei voi muuttaa määrityksen tallentamisen jälkeen.

Jos olet ottanut käyttöön kielisuodattimen Todennus ja testaus -osassa, kielialuemääritystä on ylläpidettävä JSON-rakenteessa tai tietoartikkelin rakenteen yhdistämismäärityksessä . Lisätietoja kielialueen arvoista: Kielen (LanguageLocale) taulukko- tai entiteettiviite.

Valitse asetus Tietoartikkelin rakenne -osasta:

• Kentän yhdistämismääritys
• JSON-rakenne

Kenttien yhdistämismääritys

Valitse ja lataa tiedosto palvelimeen metatietojen valintaa varten ja valitse sitten metatunnisteet, joita haluat käyttää yhdistämismäärityksessä. Kun käytät kenttien yhdistämismääritystä, yhdistät hakupalvelulta saadun tietoartikkelin (lähdeominaisuuden) tietoartikkelientiteetin määritteeseen (kohde) toimintotyypin perusteella.

Valitse ja lataa tiedosto palvelimeen metatietojen valintaa varten

1. Tallenna artikkeli paikallisesti WWW-sivu, vain HTML-tiedostona. Varmista, että tiedostonimessä on alle 99 merkkiä.

2. Lataa tiedosto Customer Servicen hallintakeskuksen sivustokartan Tietoartikkelin rakenne>Kenttien yhdistämismääritys -osassa valitsemalla Valitse tiedosto.

   Kaikki HTML-tiedostosta löydetyt metatunnisteet on lueteltu Metatunnisteiden asetukset -osassa.

3. Valitse joko Valitse kaikki alla olevat metatunnisteet tai valitse vain ne metatunnisteet, jotka sinun täytyy yhdistää.

   Tässä valitsemistasi metatunnisteista tulee määritteitä, jotka voit valita lähdeominaisuuksina Yhdistämismääritys-osassa. Jos et valitse mitään, vain oletusarvoiset lähdeominaisuudet HTML-Title ja HTML-Body ovat yhdistettävissä.

4. Valitse Yhdistämismääritys-osassa Seuraava. Jos haluat keskeyttää ja palata tähän kohtaan myöhemmin, valitse Tallenna luonnoksena.

Yhdistä artikkelin määritteet

Käytä operaatiotyyppiä yhdistämään lähdeominaisuus kohteeseen.

• Artikkelimääritteet: Tietoartikkelin kohdekentän arvot.
• Toimintotyypit: Yhdistämismääritystavat, jotka yhdistävät lähdeartikkelin tietoartikkeli-kohteen artikkelimääritteet. Lisätietoja toimintotyypin yhdistämismäärityksistä.
• Lähdeominaisuus: kullekin toimintotyypille määritettävä arvo. Jos esimerkiksi valitset Suora-toiminnon tyypin , valitse aiemmin valituista metatunnisteista tai HTML-Title-tunnisteen.

1. Customer Servicen hallintakeskuksen sivustokartassa Yhdistämismääritykset-osassa pakolliset tietoartikkelimääritteet ovat Sisältö, Ulkoinen viitetunnus ja Otsikko. Valitse kullekin niistä Toimintotyyppi ja Lähdeominaisuus.

   Varmista, että Ulkoinen viitetunnus -arvo on yksilöllinen.

2. Jos haluat lisätä enemmän artikkelimääritteitä, valitse Lisää rivi ja valitse sitten Artikkelimäärite, Toimintotyyppi ja Lähdeominaisuus.

   Voit myös poistaa artikkelimääritteen tarvittaessa valitsemalla Poista.

3. Valitse Tarkista yhdistämismääritys.

   Palvelu käyttää syöttämiäsi arvoja tunnistamaan määritteiden arvot lataamastasi HTML-tiedostosta. Se tarkistaa yhdistämistaulukon merkinnät ja Regex-kaavat. RegexUrl-tarkistuksia ei ole.

   Jos tarkistaminen onnistuu, näkyviin tulee vahvistussanoma. Jos tarkistus epäonnistuu, näkyviin tulee virhesanoma. Tarkista virhesanoman mukaan joko syöttämäsi yhdistämistaulukon merkinnät tai regex-kaavat.

4. Siirry seuraavaan osaan valitsemalla Seuraava. Jos haluat keskeyttää ja palata tähän kohtaan myöhemmin, valitse Tallenna luonnoksena.

Toimintotyypin yhdistämisvaihtoehdot

Valitse seuraavista operaatiotyypin yhdistämismääritysvaihtoehdoista:

• Regex: poimii arvoja lähdesivustosta regex-kaavojen avulla. Lähdeominaisuus on tekstikenttä, johon voit kirjoittaa regex-kaavan. Verkkosivuston HTML-koodista merkkijono, joka vastaa tätä kaavaa, yhdistetään vastaavaan tietoartikkelikenttään.

  Säännöllisissä lausekemalleissa on oltava sulkeisiin sijoitettu sieppausryhmä, joka mahdollistaa tietyn vastaavan tekstin osan poimimisen. Teksti puretaan ensimmäisen vastineen ensimmäisestä ei-tyhjästä ryhmästä.

  Esimerkkejä tietystä div-tunnisteesta sisältöä poimivista säännöllisistä lausekemalleista:

  • Perusteena div-tunnisteen tunnus: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Perusteena div-tunnisteen luokka: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Jos sisältö on body-tunnisteen sisällä: <body[^>]*>([\s\S]*)<\/body>
  • Jos sisältö on head-tunnisteen sisällä: <head[^>]*>([\s\S]*)<\/head>

• Suora: yhdistää minkä tahansa metatunnisteen arvon lähdesivustosta suoraan mihin tahansa tietoartikkelikenttään. Lähdeominaisuus-luettelossa näkyvät kaikki näytesivustosta puretut metatunnisteet sekä lähdeominaisuudet HTML-Title ja HTML-Body, jotka ovat oletusarvoisesti käytettävissä.

  Jos valitset toiminnon tyypiksi Suora ja lähdeominaisuudeksi og: url , lähdeominaisuuden og: url-metatunnisteen arvo yhdistetään vastaavaan tietoartikkelimääritteeseen.

• Vakio: kirjoita vakioarvo mihin tahansa tietoartikkelikenttään. Lähdeominaisuus on tekstikenttä, johon voit kirjoittaa vakioarvon.

• RegexUrl: kuten Regex, mutta etsii vastineita vain lähdesivuston URL-osoitteesta. Jos haluat yhdistää koko lähdesivuston URL-osoitteen tietomääritekenttään, valitse toiminnon tyypiksi Regexurl ja käytä lähdeominaisuudessa kaavaa (. *).

Tässä on esimerkki, joka selittää, kuinka artikkelin määritteet yhdistetään.

Esimerkki

HTML-esimerkki:

<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>

Käytä seuraavia operaatiotyyppejä yhdistämään lähdeominaisuus kohteeseen HTML-esimerkkitiedostossa:

missä

• Artikkelin määrite: Sisältö
• Operaatiotyyppi: Regex
• Lähdeominaisuus: <body[^>]>([\s\S])</body>

Regex-esimerkki purkaa koko sisällön HTML-tiedoston body-tunnisteen sisällä.

• Artikkelin määrite: Ulkoinen viitetunnus
• Operaatiotyyppi: RegexUrl
• Lähdeominaisuus: ^https://.?/id/(.?)/.*$

RegexUrl purkaa tunnuksen 2911cacd-efa5-4593-ae22-e09ae14c6698 HTML-tiedostosta.

• Artikkelin määrite: Otsikko
• Operaatiotyyppi: Suora
• Lähdeominaisuus : HTML-Title

Suora purkaa sisällön HTML-tiedoston Otsikko-kentässä, esim. WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

• Artikkelin määrite: Kuvaus
• Operaatiotyyppi: Regex
• Lähdeominaisuus: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Regex-esimerkki poimii sisällön tietystä div-tunnisteesta tunnuksen perusteella. Tässä ms-desciptionArticle on HTML-koodin div-tunnisteen tunnus.

• Artikkelin määrite: Avainsanat
• Operaatiotyyppi: Suora
• Lähdeominaisuus: ms.keywords

Direct purkaa sisällön HTML-tiedoston ms.keywords-kentässä, esimerkiksi XML Reader, WS-Trust.

JSON-rakenne

Tietoja metatietojen yhdistämismallin luomiseen tarvittavista rakenteen tiedoista.

1. Kopioi ja liitä artikkelin ominaisuudet ja rakenteen JSON annettuun kenttään Customer Servicen hallintakeskuksen sivustokartan Tietoartikkelirakenne>JSON-rakenne -osiossa.

2. Valitse Tarkista JSON.

   Jos tarkistaminen onnistuu, näkyviin tulee vahvistussanoma. Jos tarkistus epäonnistuu, näkyviin tulee virhesanoma, joka määrittää parametrin, jolla on virheellinen arvo.

3. Siirry seuraavaan osaan valitsemalla Seuraava. Jos haluat keskeyttää ja palata tähän kohtaan myöhemmin, valitse Tallenna luonnoksena.

Seuraavat vaiheet

Integroitujen hakupalveluiden hallinta