10.5 10320/loc要素

このセクションでは、DOIマルチプルレゾリューション（5.4.2 DOIマルチプルレゾリューションを参照）に使用される10320/loc要素について詳しく説明します。

10.5.1 10320/loc：XML属性

DOIレコードでは10320/locタイプを使い、場所を選択する複雑なルールをXML形式で記述します。表9は、これらルールでサポートされるXML属性のリストです。

表910320/loc：XML属性
属性	説明	必須
chooseby	カンマで区切られた選択方法のリストを識別。DOIリゾルバは、指定された順序で選択方法を繰り返し実行する。適用された各選択方法について：唯一の場所が選択された場合、DOIリゾルバはその場所にリダイレクトする。そうでない場合、DOIリゾルバは次の選択方法を適用する。選択方法が残っていなければ、DOIリゾルバは重み付け選択方法を適用し、単一の場所を返すことを保証する。 chooseby属性が指定されていない場合はデフォルト（「locatt,coun-try,weighted」）が想定される。考えられる場所選択方法： locatt：プロキシ/DOI名-URLリンクで渡される属性からのみ場所を選択。例：doi:10.123/456?locatt=id:1とすると、リゾルバは「id」属性が1の場所を返す。 country：リクエスタの国に一致する「country」属性を持つ場所のみが選択される。一致する場所が見つからない場合は、「country」属性を持たない場所が選択される。注:https://hdl.handle.netおよびhttps://doi.orgプロキシは、GeoIP ルックアップを使ってリクエスタの国を判断する。 weighted：次に示すように、各場所に割り当てられた重みに基づいて、1つの場所が選択される。「weight」属性を持たない場所は、重み1とされる。重みが大きいほど、最初に選択される。複数の場所の重みが同じ場合、ランダム選択が実行される。重み付け選択方法が、全て正以外の重みを持つ場所に適用される場合は、場所の重みを無視して、残りの場所の中から1つの場所をランダムに選択する。注：重み付けにおいてごく基本的な負荷分散（ロードバランシング）が可能になるが、ある場所だけを直接アドレスする手段にもなる（例えば、countryまたはlocatt/属性）。	必須ではない
href="/stock/stock_detail.html?	場所のURL。	必須
weight	重み付け選択を行うときに、その場所に適用される重み（0から1の間の浮動小数点）。	必須ではない
country	リクエスタの国。指定可能な値： ISO 3166-1に従った2文字の国コード。	必須ではない

10.5.2 10320/loc: 例

表10は、doi:10.123/456に対して返されるDOIレコードを示しています。

表10リダイレクト表を格納した（with redirection graph）DOIレコード
インデックス	タイプ	データ
1	URL	https://www.defaultexample.com
1000	10320/loc	<locations> <location id="0" href="https://uk.example.com/" country="gb" weight="0" /> <location id="1" href="https://www1.example.com/" weight="1" /> <location id="2" href="https://www2.example.com/" weight="1" /> </locations>。

表10リダイレクト表を格納した（with redirection graph）DOIレコード

インデックス

タイプ

データ

URL

https://www.defaultexample.com

1000

10320/loc

<locations>
    <location id="0" href="https://uk.example.com/" country="gb" weight="0" />
    <location id="1" href="https://www1.example.com/" weight="1" />
    <location id="2" href="https://www2.example.com/" weight="1" />
</locations>。

この例では、DOIリゾルバはデフォルトの選択方法の順序を適用します（つまり、表11に示すように、1)locatt、2)country、3)weighted）。DOIリゾルバが10320/loc要素のタイプを理解しない（あるいは無視するよう要求された）場合には、URL値のタイプはhttps://www.defaultexample.comとなります。

表11解決リクエストの例とその結果
解決リクエスト	選択方法	結果
英国にいるリクエスタからの10.123/456	1. 「locatt」選択方法は適用されない。 2. リゾルバは「country」選択方法を適用する。https://uk.example.com/を選択。（単一マッチング選択（single matching selection））	https://uk.example.com/
英国以外の地域にいるリクエスタからの10.123/456	1. 「locatt」選択方法は適用されない。 2. リゾルバは「country」選択方法を適用する。URLは選択できない。 3. リゾルバは、https://www1.example.com/ と https://www2.example.com/ に重み付け選択方法を適用する。この2つは同じ重みを持つため、リゾルバはこの2つのURLのうち1つを無作為に選択する。	https://www1.example.com/ または https://www2.exam-ple.com/
10.123/456?locatt= id:1	1.リゾルバはid=「1」で「locatt」選択方法を適用する。https://www1.exam-ple.com/を選択し、停止する。（単一マッチング選択（single matching selection））	https://www1.example.com/
10.123/456?locatt= id:0	1.リゾルバはid=「0」で「locatt」選択方法を適用する。https://uk.example.com/ を選択し、停止する（単一マッチング選択（single matching selection））	https://uk.example.com/
10.123/456?locatt= country:gb	1.リゾルバはcountry=「gb」で「locatt」選択方法を適用する。https://uk.exam-ple.com/を選択し、停止する。（単一マッチング選択（single matching selection））	https://uk.example.com/
10.123/456?locatt=country:us（リクエスターが米国にいる場合）	1. リゾルバはcountry=「us」で「locatt」選択方法を適用する。URLは選択できない。 2. リゾルバは、リクエスタの国で「country」選択方法を適用する。URLは選択できない。 3. リゾルバは、https://www1.example.com/ と https://www2.example.com/ に重み付け選択方法を適用する。この2つは同じ重みを持つため、リゾルバはこの2つのURLのうち1つを無作為に選択する。	https://www1.example.com/ または https://www2.exam-ple.com/

10.5.3 プレフィックスレベルの10320/loc

あるプレフィックスを持つすべて、またはほとんどのDOI名に適用される位置情報（10320/loc要素で特定される情報）は、プレフィックスレベルに格納することができます。この情報はそのプレフィックスを持つすべてのDOI名に適用されます。DOI名レベルに格納される位置情報は、プレフィックスレベルで格納される情報をオーバーライドします。

位置情報は、プレフィックスHandleのレコードのHS_NAMESPACE 値（0.NA/<prefix>）を使ってプレフィックスレベルに格納されます。HS_NAMESPACE値は10320/loc要素を格納する別のHandle名またはDOI名を指し示します。通常、この値はURLテンプレートを含みます。HS_NAMESPACE値について詳しくは、Handle.netテクニカルマニュアルを参照してください。

図23は、プレフィックスレコードに 10320/loc要素が格納されているプレフィックスHandle「0.NA/10.5237」の例です。