The document element allows you to load an application document (Microsoft Word, Microsoft Excel, PDF, and so on) into a portlet.
When you create document elements:
Portlets built with the document element may require that the Web browser plug-in for the application in which the document was authored be installed on the machine from which the user is browsing before they can view the portlet’s content. For example, to view a portlet with PDF content, the Adobe Acrobat Reader plug-in for your Web browser must be installed on the machine from which you are browsing. Refer to your Web browser’s Internet site for more information.
If you upload a document with the same name as a previously uploaded document, the second document overwrites the first, unless you create a subdirectory below the upload directory and upload the second document to the subdirectory.
Document elements must be saved with the IFRAME attribute.
You can use only the default template except for the content types text/HTML and text/plain.
You cannot import or export a document portlet across servers.
You can create a document portlet with a new content type that is not included in the drop-down menu. In this case, it may or may not work, depending on whether there is an application supports the plug-in.
You must set the content type of document element portlets to the correct type.
Portlets that use the document element (except for the content types text/HTML and text/plain) can contain only one element.
Creating a document element
Select Document Element. You see the Document Element Definition window.
In the Document to Upload field, enter the full path to the document you want to upload, or click Browse to search for and select the document.
In the Destination Location field, accept the default folder name or append the default name with an additional folder name. Enter only the folder name; that is, do not enter the complete path. This is the location to which the document is uploaded.
The default upload folder name is configurable in global.properties.xml.
See Appendix A, “Configuring Global Properties.”Also,
the parent location of the document root folder must have “write” permissions.
Web Studio creates a document root level directory on the drive of your EP installation and uses the current user’s login name as the default folder. For example, if the default for the Destination Location displays “Smith”, and the EP installation drive is D:, the uploaded document is saved to D:\tmp\PortalDocs\Smith\.
To create a different folder using this structure, enter another file name after the name that displays in the Destination Location field. For example, if the field displays “Smith” and you enter “\Smith,” the file is uploaded to D:\tmp\PortalDocs\Smith\Smith.
Click Upload. When a message displays confirming that the upload was successful, click OK.
The length of time before the confirmation message
displays depends on the document’s size.
Document Name – displays the document’s name.
Content Type – from the drop-down list, select the type of content the document contains.
If you do not see the content type you want, select Add New from the drop-down list to add a new content type.
New Content Type – displays only when you select Add New from the Content Type drop-down list. Enter the new type in this format:
[application | image | text]/plug-in
name
Whether the new type works depends on whether there
is an application and the plug-in installed for the content type
specified. See “Adding new content types” on page
57.
Click Next.
Enter a name for the element and click Finish. You return to the Portlet Builder.
Regardless of the element type, the procedure to save
the element and portlet is the same. See“Saving portlets”.
Copyright © 2004. Sybase Inc. All rights reserved. |
![]() |