RFC 6861 - The "create-form" and "edit-form" Link Relations 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc6861
タイトル : RFC 6861 - 「フォームの作成」および「フォームの編集」リンク関係
翻訳編集 : 自動生成

[要約] RFC 6861は、"create-form"と"edit-form"のリンク関係についての仕様であり、フォームの作成と編集をサポートするための目的を持っています。

Independent Submission                                   I. Dzmanashvili
Request for Comments: 6861                                  January 2013
Category: Informational
ISSN: 2070-1721

The "create-form" and "edit-form" Link Relations

「フォームの作成」および「フォームの編集」リンク関係

Abstract

概要

RFC 5988 standardized a means of indicating the relationships between resources on the Web. This specification defines link relation types that may be used to express the relationships between a resource and an input form for constructing data submissions.

RFC 5988は、Web上のリソース間の関係を示す手段を標準化しました。この仕様は、リソースとデータ送信を構築するための入力フォームとの間の関係を表すために使用できるリンク関係タイプを定義します。

Status of This Memo

本文書の状態

This document is not an Internet Standards Track specification; it is published for informational purposes.

このドキュメントはInternet Standards Trackの仕様ではありません。情報提供を目的として公開されています。

This is a contribution to the RFC Series, independently of any other RFC stream. The RFC Editor has chosen to publish this document at its discretion and makes no statement about its value for implementation or deployment. Documents approved for publication by the RFC Editor are not a candidate for any level of Internet Standard; see Section 2 of RFC 5741.

これは、他のRFCストリームとは無関係に、RFCシリーズへの貢献です。 RFCエディターは、このドキュメントを独自の裁量で公開することを選択し、実装または展開に対するその価値については何も述べていません。 RFC Editorによって公開が承認されたドキュメントは、どのレベルのインターネット標準の候補にもなりません。 RFC 5741のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6861.

このドキュメントの現在のステータス、正誤表、およびフィードバックの提供方法に関する情報は、http：//www.rfc-editor.org/info/rfc6861で入手できます。

著作権表示

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document.

この文書は、BCP 78およびこの文書の発行日に有効なIETF文書に関するIETFトラストの法的規定（http://trustee.ietf.org/license-info）の対象となります。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。

Table of Contents

   1. Introduction ....................................................2
   2. Notational Conventions ..........................................2
   3. Link Relations ..................................................3
      3.1. The "create-form" Link Relation Type .......................3
           3.1.1. Using the "create-form" Link Relation ...............3
      3.2. The "edit-form" Link Relation Type .........................3
           3.2.1. Using the "edit-form" Link Relation .................4
      3.3. Error-Handling Example .....................................4
   4. IANA Considerations .............................................4
      4.1. The Link Relation Registration "create-form" ...............4
      4.2. The Link Relation Registration "edit-form" .................5
   5. Security Considerations .........................................5
   6. Internationalisation Considerations .............................5
   7. Normative References ............................................5
   Appendix A. Acknowledgements .......................................6

1. Introduction

1. はじめに

RFC 5988 [RFC5988] standardized a means of indicating the relationships between resources on the Web. This specification defines link relation types that may be used to express the relationships between a resource and an input form for constructing data submissions.

RFC 5988 [RFC5988]は、Web上のリソース間の関係を示す手段を標準化しました。この仕様は、リソースとデータ送信を構築するための入力フォームとの間の関係を表すために使用できるリンク関係タイプを定義します。

The "create-form" and "edit-form" link relations are intentionally generic, and they can be used with multiple media types in a wide variety of use cases.

「フォームの作成」および「フォームの編集」リンクの関係は意図的に一般的なものであり、さまざまなユースケースで複数のメディアタイプとともに使用できます。

2. Notational Conventions

2. 表記規則

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].

このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 [RFC2119]で説明されているように解釈されます。

3. Link Relations

3. リンク関係

The following link relations are defined.

以下のリンク関係が定義されています。

3.1. The "create-form" Link Relation Type

3.1. 「フォームの作成」リンク関係タイプ

When included in a response, the "create-form" link relation indicates a target resource that represents a form that can be used to append a new member to the link context.

応答に含まれる場合、「create-form」リンク関係は、リンクコンテキストに新しいメンバーを追加するために使用できるフォームを表すターゲットリソースを示します。

   <html>
     <ul>
       <li>Entry Description 1</li>
       <li>Entry Description 2</li>
     </ul>
     <a href="..." rel="create-form">[Add New Entry]</a>
   </html>

or, expressed as a Link header

または、Linkヘッダーとして表現

   Link: <...>; rel="create-form"; title="Add New Entry"

3.1.1. Using the "create-form" Link Relation

3.1.1. 「フォームの作成」リンク関係の使用

If the form representation includes a submission URI, this URI MUST be used to submit the form. The context URI SHOULD be used otherwise.

フォーム表現に送信URIが含まれる場合、このURIを使用してフォームを送信する必要があります。それ以外の場合は、コンテキストURIを使用する必要があります。

If the form representation includes a submission method, this method MUST be used for submit requests. HTTP's POST method SHOULD be used otherwise.

フォーム表現に送信メソッドが含まれている場合、このメソッドは送信リクエストに使用する必要があります。それ以外の場合は、HTTPのPOSTメソッドを使用する必要があります（SHOULD）。

3.2. The "edit-form" Link Relation Type

3.2. 「編集フォーム」リンク関係タイプ

When included in a response, the "edit-form" link relation indicates a target resource that represents a form that can be used for updating the context resource.

応答に含まれる場合、「編集フォーム」リンク関係は、コンテキストリソースの更新に使用できるフォームを表すターゲットリソースを示します。

   <html>
    ...
    <ul>
      <li>
        Entry Description 1
        <a href="..." rel="edit-form">[Edit Entry]</a>
      </li>
    </ul>
    ...
   </html>
   or, expressed as a Link header

   Link: <...>; rel="edit-form"; title="Edit Entry"

3.2.1. Using the "edit-form" Link Relation

3.2.1. 「編集フォーム」リンク関係の使用

If the form representation includes a submission URI, this URI MUST be used to submit the form. The context URI SHOULD be used otherwise.

If the form representation includes a submission method, this method MUST be used for submit requests. HTTP's PUT method SHOULD be used otherwise.

フォーム表現に送信メソッドが含まれている場合、このメソッドは送信リクエストに使用する必要があります。それ以外の場合は、HTTPのPUTメソッドを使用する必要があります（SHOULD）。

3.3. Error-Handling Example

3.3. エラー処理の例

When submitting forms in unsupported media type format, service may respond to the client with HTTP's 415 Unsupported Media Type status code.

サポートされていないメディアタイプの形式でフォームを送信すると、サービスはHTTPの415 Unsupported Media Typeステータスコードでクライアントに応答する場合があります。

     HTTP/1.1 415 Unsupported Media Type
     Link: <...>; rel="create-form"; title="Create new entry"
     Content-Type: text/html
     Content-Length: ...

     <html>
       Use <a href="..." rel="create-form">
         this form
       </a> to create a new entry.
     </html>

4. IANA Considerations

4. IANAに関する考慮事項

IANA has registered the "create-form" and "edit-form" link relations below as per [RFC5988].

IANAは、[RFC5988]に従って、以下の「フォームの作成」および「フォームの編集」リンク関係を登録しています。

4.1. The Link Relation Registration "create-form"

4.1. リンク関係登録「作成フォーム」

Relation Name:

リレーション名：

create-form

作成フォーム

Description:

説明：

The target IRI points to a resource where a submission form can be obtained.

ターゲットIRIは、送信フォームを取得できるリソースを指します。

Security considerations:

セキュリティに関する考慮事項：

Automated agents should take care when this relation crosses administrative domains (e.g., the URI has a different authority than the current document).

自動化されたエージェントは、この関係が管理ドメインをまたぐ場合に注意する必要があります（たとえば、URIが現在のドキュメントとは異なる権限を持っている）。

Reference:

参照：

See Section 3.

セクション3を参照してください。

4.2. The Link Relation Registration "edit-form"

4.2. リンク関係登録「編集フォーム」

Relation Name:

リレーション名：

edit-form

編集フォーム

Description:

説明：

The target IRI points to a resource where a submission form for editing the associated resource can be obtained.

ターゲットIRIは、関連するリソースを編集するための送信フォームを取得できるリソースを指します。

Security Considerations:

セキュリティに関する考慮事項：

Automated agents should take care when this relation crosses administrative domains (e.g., the URI has a different authority than the current document).

Reference:

参照：

See Section 3.

セクション3を参照してください。

5. Security Considerations

5. セキュリティに関する考慮事項

See Section 7 of RFC 5988 [RFC5988].

RFC 5988 [RFC5988]のセクション7をご覧ください。

6. Internationalisation Considerations

6. 国際化に関する考慮事項

See Section 8 of RFC 5988 [RFC5988].

RFC 5988 [RFC5988]のセクション8をご覧ください。

7. Normative References

7. 引用文献

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、1997年3月。

[RFC5988] Nottingham, M., "Web Linking", RFC 5988, October 2010.

[RFC5988]ノッティンガム、M。、「Webリンク」、RFC 5988、2010年10月。

Appendix A. Acknowledgements

付録A謝辞

The author gratefully acknowledges the contributions of Jan Algermissen.

著者はJan Algermissenの貢献に感謝します。

Author's Address

著者のアドレス

Ioseb Dzmanashvili

イオセブ・ズマナシビリ

   EMail: ioseb.dzmanashvili@gmail.com