---
title: "URL書き換えの設定"
slug: "configure-url-rewriting"
abstract: "レンダリングホストをSitecoreエディターと統合する際のURL書き換えをカスタマイズできます。"
---
# URL書き換えの設定

HTMLの相対リンクが高度なSitecoreエディタと統合される際に適切にレンダリングされるようにするため、Headless Servicesは返還されたマークアップ内の相対URLを絶対的なURLに書き換えます。この処理に含まれるデフォルトのタグと属性は以下の通りです。

タグ名

属性名

audio

src

img

src, srcset

link

href

script

src

source

src, srcset

track

src

video

poster, src

## URL書き換えを無効にする

Headless Servicesが返されるマークアップ内の相対的なURLを絶対URLに書き換えたくない場合は、URL書き換えを無効にできます。

URL書き換えを無効にするには:

-   アプリの設定で、設定済みhttpレンダリングエンジンインスタンスに対して、オプションEnableRelativeLinkProcessingの値をfalseに変更してください:
    
    <javaScriptServices>
     <renderEngines>
     <renderEngine name="http">
     <instance id="RenderEngineInstance" inherits="defaults">
     <EnableRelativeLinkProcessing>false</EnableRelativeLinkProcessing>
     </instance>
     </renderEngine>
     </renderEngines>
    </javaScriptServices>
    

## 書き換えたHTML属性の設定

レンダリングエンジンのインスタンスの設定を変更することでURLの書き換えをカスタマイズできます。

書き換えたHTML属性を設定するには:

-   アプリの設定で、設定済みhttpレンダリングエンジンインスタンスのLinkReplacement要素でリンク置換に使う属性をLinkMap要素で指定します。例えば:
    
    <javaScriptServices>
     <renderEngines>
     <renderEngine name="http">
     <instance id="RenderEngineInstance" inherits="defaults">
     <LinkReplacement>
     <LinkMap tag="audio" attributes="src" />
     <LinkMap tag="img" attributes="src, srcset" />
     <LinkMap tag="link" attributes="href" />
     <LinkMap tag="script" attributes="src" />
     <LinkMap tag="source" attributes="src, srcset" />
     <LinkMap tag="track" attributes="src" />
     <LinkMap tag="video" attributes="src, poster" />
     </LinkReplacement>
     </instance>
     </renderEngine>
     </renderEngines>
    </javaScriptServices>
    

## 無視された経路にパスを追加します

一部の相関URLパスはヘッドレスサービスによって書き換えられません。デフォルトでは以下の通りです:

-   \-/media/
-   ~/media/
-   \-/jssmedia/
-   ~/jssmedia/

無視されたパスにURLパスを追加するには:

-   アプリの設定で、設定済みのhttpレンダリングエンジンインスタンスに対して、IgnoredPaths要素の無視パスをPath要素で指定します。例えば:
    
    <javaScriptServices>
     <renderEngines>
     <renderEngine name="http">
     <instance id="RenderEngineInstance" inherits="defaults">
     <IgnoredPaths>
     <Path>-/media/</Path>
     <Path>~/media/</Path>
     <Path>-/jssmedia/</Path>
     <Path>~/jssmedia/</Path>
     <Path>sitecore/shell/</Path>
     </IgnoredPaths>
     </instance>
     </renderEngine>
     </renderEngines>
    </javaScriptServices>