metadata.iptc Property HTML5/Flash Uploader JavaScript

Supported technologies: Adobe Flash

Gets or sets a list of IPTC fields which should be extracted and uploaded along with other data.

Syntax

JavaScript Initialize

$au.imageUploaderFlash({
    metadata: {
        //...other params...
        iptc: "",
        //...other params...
    }
})

Get/Set Value at Runtime

$au.imageUploaderFlash('uploaderID').metadata().iptc(value);
value = $au.imageUploaderFlash('uploaderID').metadata().iptc();

Property Value

Type: String

It may be either an array of strings containing IPTC field names which you want to extract or the string separated with a semicolon. It is recommended using array, the latter way is implemented only for a backward compatibility. If you specify an asterisk (* character), all fields are extracted.

You will find possible names of IPTC fields in the table below.

Field name	Description
IptcByline	The name of the creator of the image, e.g. artist, photographer, etc.
IptcBylineTitle	The byline title (e.g. staff photographer, correspondent, etc).
IptcCredit	The provider of the image.
IptcSource	The original owner of the intellectual content of this image.
IptcObjectName	The short reference for the object.
IptcDateCreated	The date the image (as an intellectual content, rather than physical file) created.
IptcCity	The city of the image origin.
IptcState	The state/province of the image origin.
IptcCountry	The country of the image origin.
IptcOriginalTransmissionReference	The location of the original transmission.
IptcCopyrightNotice	The copyright notice.
IptcCaption	The textual description of the image.
IptcWriter	The name of editor or other person involved in the writing.
IptcHeadline	The brief overview for the image.
IptcSpecialInstructions	Some custom editorial instructions.
IptcCategory	The image category.
IptcSupplementaryCategory	The supplementary category for the image.
IptcUrgency	The editorial urgency of the content.
IptcKeyword	The keywords used for search.

All date values have the following format: YYYYMMDD. E.g. 11th of May 2006 would be represented as: 20060511.

For more information about interpretation of these values, refer to IPTC specification (version 4.1 is currently supported).

Default value is "".

Remarks

To get an uploaded IPTC value at the server, you should extract POST field which is named in the following way: XXX_N, where XXX is a string value specified in this property (IPTC field name), and N is the index of the file in the request. E.g. if the property value is IptcCountry;IptcCity;IptcObjectName, you will get the following POST fields:

IptcCountry_1, IptcCountry_2, etc.
IptcCity_1, IptcCity_2, etc.
IptcObjectName_1, IptcObjectName_2, etc.

If you prefer to extract IPTC fields on the server, you can get them from the original file, or specify to preserve IPTC fields in the thumbnails you are going to upload. To do it, use the thumbnailCopyIptc property.

metadata.iptc Property HTML5/Flash Uploader JavaScript

Syntax

Property Value

Remarks

See Also

Reference

Manual