dmaClass_ContentReference

A content element that represents content that exists outside the control of the document space, but to which the document space maintains a reference.

Class ID: dmaClass_ContentReference
Superclass: Content Element

Interfaces

IUnknown
IdmaObject
IdmaProperties
IdmaEditProperties [Optional]

Properties

Name

Impl. Required

System Gen'ed

Read-Only

Value Required

Type

Cardinality

Required Class

OIID

-

Yes

Yes

-

String

Scalar

Class Description

Yes

Yes

Yes

Yes

Object

Scalar

Class Description

This

-

Yes

Yes

Yes

Object

Scalar

Content Reference

Create Pending

-

Yes

Yes

Yes

Boolean

Scalar

Update Pending

-

Yes

Yes

Yes

Boolean

Scalar

Delete Pending

-

Yes

Yes

Yes

Boolean

Scalar

Component Type

Yes

-

-

Yes

String

Scalar

Content Location

Yes

-

-

Yes

String

Scalar

Property Descriptions

• OIID {dmaProp_OIID}
Property Inherited from DMA

• Class Description {dmaProp_ClassDescription}
Property Inherited from DMA

• This {dmaProp_This}
Property Inherited from DMA

• Create Pending {dmaProp_CreatePending}
Property Inherited from DMA

• Update Pending {dmaProp_UpdatePending}
Property Inherited from DMA

• Delete Pending {dmaProp_DeletePending}
Property Inherited from DMA

• Component Type {dmaProp_ComponentType}
Property Inherited from Content Element

• Content Location {dmaProp_ContentLocation}

Specifies, in URL format, the name of the resource which contains the content data.

When delivering new content, the client application must set a value for this property. The document space may validate the syntax of the URL and may even test to see that it refers to an existing resource, but it is required to do neither of these things.

When returning a saved value to subsequent clients, the document space is required only to deliver back the content location string exactly as it was supplied initially, without regard to whether the resource so referenced still exists or whether it contains the same content as at the time the reference was saved. The document space may however deliver back a different string, if it is able, for example:

- to transform the URL into a more globally applicable form

- to apply "link tracking" techniques to discover a new location for content which has been moved.

A document space may permit the Content Location property to be modified on an already persistent content reference, but is not required to allow this.