Skip to main content

The Create-Form and Edit-Form Link Relations
draft-ioseb-dzmanashvili-link-relation-06

The information below is for an old version of the document.
Document Type
This is an older version of an Internet-Draft that was ultimately published as RFC 6861.
Author Ioseb Dzmanashvili
Last updated 2012-05-16
RFC stream (None)
Formats
IETF conflict review conflict-review-ioseb-dzmanashvili-link-relation, conflict-review-ioseb-dzmanashvili-link-relation, conflict-review-ioseb-dzmanashvili-link-relation, conflict-review-ioseb-dzmanashvili-link-relation, conflict-review-ioseb-dzmanashvili-link-relation, conflict-review-ioseb-dzmanashvili-link-relation
Stream Stream state (No stream defined)
Consensus boilerplate Unknown
RFC Editor Note (None)
IESG IESG state Became RFC 6861 (Informational)
Telechat date (None)
Responsible AD (None)
Send notices to (None)
draft-ioseb-dzmanashvili-link-relation-06
Network Working Group                                    I. Dzmanashvili
Internet-Draft                                              May 16, 2012
Expires: November 17, 2012

              The Create-Form and Edit-Form Link Relations
               draft-ioseb-dzmanashvili-link-relation-06

Abstract

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

Editorial Note (To be removed by RFC Editor)

   Distribution of this document is unlimited.  Comments should be sent
   to the IETF Apps-Discuss mailing list (see
   <https://www.ietf.org/mailman/listinfo/apps-discuss>).

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on November 17, 2012.

Copyright Notice

   Copyright (c) 2012 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   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

Dzmanashvili            Expires November 17, 2012               [Page 1]
Internet-Draft        The Create-Form and Edit-Form             May 2012

   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

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

Dzmanashvili            Expires November 17, 2012               [Page 2]
Internet-Draft        The Create-Form and Edit-Form             May 2012

1.  Introduction

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

   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

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

3.  Link Relations

   The following link relations are defined.

3.1.  The "create-form" Link Relation

   When included in a resource, the "create-form" link relation MAY
   identify a target resource that represents the form to append a new
   member to the link context.

   <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: <...>; rel="create-form"; title="Add New Entry"

3.1.1.  Using the "create-form" Link Relation

   Target URI specified in the form representation MUST be used for
   submit requests.  Context URI MUST be used otherwise.

   Request method specified in the form representation MUST be used for
   submit requests.  HTTP's POST method MAY be used otherwise.

   A content type specified in the form representation MUST be used for

Dzmanashvili            Expires November 17, 2012               [Page 3]
Internet-Draft        The Create-Form and Edit-Form             May 2012

   submitting requests, or otherwise, a content type defined in the
   media type specification of a form MUST be used.

3.2.  The "edit-form" Link Relation

   When included in a resource, the "edit-form" link relation identifies
   a target resource that represents the form for editing associated
   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

   Target URI specified in the form representation MUST be used for
   submit requests.  Context URI MUST be used otherwise.

   Request method specified in the form representation MUST be used for
   submit requests.  HTTP's PUT method MAY be used otherwise.

   A content type specified in the form representation MUST be used for
   submitting requests, or otherwise, a content type defined in the
   media type specification of a form MUST be used.

3.3.  Error Handling Example

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

Dzmanashvili            Expires November 17, 2012               [Page 4]
Internet-Draft        The Create-Form and Edit-Form             May 2012

     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

   IANA is asked to register the "create-form" and "edit-form" link
   relations below as per [RFC5988].

4.1.  The Link Relation Registration "create-form"

   Relation Name:

      create-form

   Description:

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

   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.

4.2.  The Link Relation Registration "edit-form"

   Relation Name:

      edit-form

   Description:

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

Dzmanashvili            Expires November 17, 2012               [Page 5]
Internet-Draft        The Create-Form and Edit-Form             May 2012

   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.

5.  Security Considerations

   See Section 7 of RFC5988 [RFC5988].

6.  Internationalisation Considerations

   See Section 8 of RFC5988 [RFC5988].

7.  Normative References

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

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

Appendix A.  Acknowledgements

   The author gratefully acknowledges the contributions of Jan
   Algermissen.

Author's Address

   Ioseb Dzmanashvili

   EMail: ioseb.dzmanashvili@gmail.com

Dzmanashvili            Expires November 17, 2012               [Page 6]