URLAttachment

Description

The URLAttachment type holds information about a URL attached to a primary or auxiliary item. The URLAttachment type parameters are listed below.

Parameters

Name	Type	Description
id	integer	This is the internal TS_ID of the URL attachment from the TS_ATTACHMENTS table.
name	string	The name you give the URL attachment in SBM.
url	string	The actual URL itself.
showAsImage	boolean	This flag indicates whether or not graphic images in a URL are shown on forms.
modificationDateTime	dateTime	The date and time when the URL attachment was last modified. See Supported Date/Time Formats for more information.
accessType	Attachment-Access-Type	Shows the access type for the URL attachment. The value is either DEFAULT, RESTRICTED, or UNRESTRICTED.
extendedData	ExtendedData	Placeholder for future arguments.

Usage

You can add a URL to a primary or auxiliary item using the URLAttachment argument. URLs can be links to an external Web site or to a page within SBM.

Note: If you set <urn:showAsImage> to true, the image appears instead of a hyperlink when the item is viewed. If you enter a URL to a graphic file such as http://www.acme.com/image.gif, the graphic appears. To show a URL graphically, an image file must be part of the URL. If you enter www.acme.com and select to show the URL as an image, an image does not appear because there is not an image file specified in the URL. Typically, this feature works for GIF and JPEG files, but can work in some browsers for PNG and BMP files as well. The file type that you can use for this feature depends on the file types your browser supports.

Tip: Internet Explorer is the only browser that supports URLs to files. Links to files do not work for users accessing the URLS to files from other browser types.

XML

The following XML snippet shows the URLAttachment type in the <urn:urlAttachment> parameter of TTItem.

<urn:urlAttachment>
    <urn:id>38</urn:id>
    <urn:name>test url</urn:name>
    <urn:url>http://www.acme.com/image.gif</urn:url>
    <urn:showAsImage>true</urn:showAsImage>
    <urn:modificationDateTime>2007-06-20T15:35:38-07:00
    →</urn:modificationDateTime>
    <urn:accessType>ATTACHACCESS-DEFAULT</urn:accessType>
    <urn:extendedData>
        <urn:data>
            <urn:name></urn:name>
            <urn:value></urn:value>
        </urn:data>
    </urn:extendedData>
</urn:urlAttachment>