.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Jifty::Action::Record::Create 3pm"
.TH Jifty::Action::Record::Create 3pm "2010-12-10" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Jifty::Action::Record::Create \- Automagic creation action
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This class is used as the base class for Jifty::Actions that are
merely creating Jifty::Record objects.  To use it, subclass it and
override the \f(CW\*(C`record_class\*(C'\fR method to return the name of the
Jifty::Record subclass that this action creates.
.SH "METHODS"
.IX Header "METHODS"
.SS "arguments"
.IX Subsection "arguments"
Set the default value in each of the fields to whatever the default of
the column is in the model
.SS "take_action"
.IX Subsection "take_action"
Overrides the virtual \f(CW\*(C`take_action\*(C'\fR method on Jifty::Action to call
the appropriate \f(CW\*(C`Jifty::Record\*(C'\fR's \f(CW\*(C`create\*(C'\fR method when the action is
run, thus creating a new object in the database.
.PP
The \f(CW\*(C`id\*(C'\fR of the new row is returned in the \f(CW\*(C`id\*(C'\fR content of the
Jifty::Result for the action.  You can use this in conjunction with
request mapping in order to give later parts
of the request access to the \f(CW\*(C`id\*(C'\fR.
.SS "create_record"
.IX Subsection "create_record"
This method actually performs the call to \f(CW\*(C`record\->create\*(C'\fR. It receives as
arguments the parameter hash and should return the message for the user,
indicating success or failure.
.SS "report_success"
.IX Subsection "report_success"
Sets the \*(L"message\*(R" in Jifty::Result to default success message,
\&\*(L"Created\*(R". Override this if you want to report some other
more user-friendly result.
.SS "possible_columns"
.IX Subsection "possible_columns"
Create actions do not provide fields for columns marked as \f(CW\*(C`private\*(C'\fR
or \f(CW\*(C`protected\*(C'\fR.
.SS "_extra_validator_args"
.IX Subsection "_extra_validator_args"
Passes \f(CW\*(C`for => \*(Aqcreate\*(Aq\*(C'\fR to validators.
.SS "_extra_canonicalizer_args"
.IX Subsection "_extra_canonicalizer_args"
Passes \f(CW\*(C`for => \*(Aqcreate\*(Aq\*(C'\fR to canonicalizers.
.SS "_extra_autocompleter_args"
.IX Subsection "_extra_autocompleter_args"
Passes \f(CW\*(C`for => \*(Aqcreate\*(Aq\*(C'\fR to autocompleters.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Jifty::Action::Record, Jifty::Record
.SH "LICENSE"
.IX Header "LICENSE"
Jifty is Copyright 2005\-2010 Best Practical Solutions, \s-1LLC\s0.
Jifty is distributed under the same terms as Perl itself.