Adobe InDesign CS (3.0) Object Model JS: MetadataPreference

InDesign CS

Class

MetadataPreference

 Metadata preferences.

QuickLinks

append, countContainer, createContainerItem, getProperty, replace, save, setProperty

Hierarchy

Document
MetadataPreference

Properties

PropertyTypeAccessDescription
authorstring r/wThe author of the document.
copyrightInfoURLstring r/wThe URL of the file that contains the linked copyright statement.
copyrightNoticestring r/wThe text to use as a copyright notice.
copyrightStatusCopyrightStatus:
CopyrightStatus.UNKNOWN
CopyrightStatus.YES
CopyrightStatus.NO
r/wThe copyright status of the document.
creationDateDate readonlyThe creation date of the document.
creatorstring readonlyThe name of the application used to create the document.
descriptionstring r/wThe description of the MetadataPreference.
documentTitlestring r/wThe title of the document.
formatstring readonlyThe format of the document.
jobNamestring r/wThe job name.
keywords Array of string r/wThe list of keywords associated with the document.
modificationDateDate readonlyThe most recent modification date of the document.
parentDocument readonlyThe parent of the MetadataPreference (a Document).
propertiesObject r/wA property that allows setting of several properties at the same time.
serverURLstring readonlyThe location of the document on the asset management server.

Methods

Instances

void append (from: File[, affectAll: bool=false])
Uses metadata from the specified external file to define any undefined metadata properties in the document.

ParameterTypeDescription
fromFileThe path to the external file that contains the metadata.
affectAllboolIf true, also replaces existing metadata with data from the external file. If false, does not replace existing metadata. Note: Defaults to false. (Optional) (default: false)

number countContainer (namespace: string, path: string)
Counts the number of items in the container.

ParameterTypeDescription
namespacestringThe namespace of the container.
pathstringThe path to the container.

void createContainerItem (namespace: string, path: string[, index: number=0][, container: ContainerType=ContainerType.BAG])
Creates an empty container.

ParameterTypeDescription
namespacestringThe namespace of the container.
pathstringThe path to the container.
indexnumberThe index of the item within the container. Specified values must be 1 or greater. To append the item to the end of the index and allow the next available value to be assigned, use 0. (Optional) (default: 0)
containerContainerType:
ContainerType.BAG
ContainerType.SEQ
ContainerType.ALT
The container type. Note: Required when the new item is the first item added to the container. (Optional) (default: ContainerType.BAG)

string getProperty (namespace: string, path: string)
Gets the XMP property value associated with the specified path.

ParameterTypeDescription
namespacestringThe namespace of the property.
pathstringThe specified path.

void replace (using: File[, affectAll: bool=false])
Replaces the current metadata in the document with metadata from the specified file.

ParameterTypeDescription
usingFileThe full path to the file that contains the replacement metadata.
affectAllboolIf true, treats all properties as external. Note: Defaults to false. (Optional) (default: false)

void save (to: File)
Saves the metadata in the document to an external file.

ParameterTypeDescription
toFileThe path to the external file.

void setProperty (namespace: string, path: string, value: string)
Sets the XMP property associated with the specified path.

ParameterTypeDescription
namespacestringThe namespace of the property.
pathstringThe specified path(s).
valuestringThe value to assign to the property. Note: To remove the property, pass an empty string.

Element of

Document.metadataPreferences

Jongware, 27-Jun-2010 v3.0.3dContents :: Index