Follow

Bulk Upload Gadget

The Bulk Upload Gadget lets you select one or more files to upload into one of your assets folders. The content can be files (such as images) or HTML pages. If you upload HTML pages, you can extract content from the pages into the new asset.
cm1_BulkUploadGadgetDialog_1.gif
To use this gadget, you must have Flash Version 9 or later installed on the browser.
You can upload up to 999 pieces of content at one time. Upload of more than 999 pieces of content will result in an error. The maximum size of any individual file uploaded using this gadget is 150 MB.
Fields and Controls on Gadget
Target folder: Assets node tree. Expand the tree and select the folder where you want to store the uploaded files.
Approve assets: Enables you to set the workflow status to either Draft or Pending for all files in the bulk file upload:

  • Unchecked box: all files that you bulk upload will be in the Draft state. You then must explicitly Approve each uploaded file.
  • Checked box (the default): all files that you bulk upload will be in the Pending state.
Note: This option is only visible if you are logged into the system in the Admin or Editor role.


Asset type: CM1 creates an asset of the specified type for each file uploaded. Available asset types include:

  • File
  • Flash
  • HTML
  • Image
  • Rich Text
  • Simple Text

If you choose HTML, Rich Text, or Simple Text as the Asset Type, two additional fields are added:
Extract HTML from element: Enter the selector to determine the content to select for upload. Basic selectors include HTML tags, CSS classes, and CSS IDs. More complex selectors may combine these basic selectors. The extractor supports CSS Level 3 Selectors, so you can enter anyvalid CSS Level 3 selector. When entering the selectors, HTML tags can be entered as plain text, but CSS class and ID selectors must be marked correctly (classes must be designated using dot-classname [.classname] and IDs muse be designated using hash-ID [#ID]).
Include: Options are

  • Inner HTML
    Extracts only the content of the specified element. The specified element is not included in the asset.
  • Outer HTML
    Extracts the specified element as well as its content. The specified element is included in the asset.

Details: Each file queued for upload is listed in a box including a progress bar and a delete button (graphic). Click the delete button to remove the file from the queue. During upload, the progress bar indicates how much processing of the file has been completed. If an error occurs when uploading a file, the details box turns red.

Uploading Files

To upload multiple files:

  1. Under Target Folder click on the Assets node to expand the Assets folder tree, then click on the folders in the tree to open them until you find the folder where you want to store the uploaded files. Click on that folder to select it. Note that you must have write permission on the folder you specify. If you do not have write permission on the specified folder, the upload will fail.
  2. If you are logged into the system in the Admin or Editor role, you see the Approve assetscheck box. Check this box (the default) if you want all uploaded files in the Pending state. Un-check the box to have all uploaded files in the Draft state.
  3. In the Asset Type drop list, choose the type of asset you want to create. The default type isFile.
    • If you are uploading images (such as .jpg, .png, or .gif files), you should chooseImage.
    • If you are uploading Flash objects, you should choose Flash.
    • Otherwise, you should choose File.
  4. Click [Add File]
    CM1 displays a browse dialog.
  5. Find the file you want to upload and select it. You can select multiple files to upload. Click [Open] to queue the files for upload.
  6. To add files from another location, repeat Steps 4 and 5.
  7. To see a list of files queued to be uploaded, click the cuilittleblueexpandbutton.gif button next to Details. Click the cuilittlebluecollapsebutton.gif button to close the list.
  8. To remove a file from the queue, click the delete button: dl376 Delete Button.
  9. To remove all files from the queue, click [Clear All].
  10. To upload the queued files, click [Upload].
    • You can cancel upload of a file in the queue by clicking the delete button. If upload of the file has not started, it will be removed from the queue. If upload of the file has already started, it may be uploaded before the cancel can take effect.
    • You can cancel upload of all files remaining in the queue by clicking the [Cancel] button. If a file is being uploaded when you cancel, upload of that file may be completed before the cancel can take effect.
    • If upload of a file fails, the detail box for that file turns red and reports an error.

The Asset created for each uploaded file uses the filename of the uploaded file, including the file extension. All files are uploaded to the same Assets folder. If you specify files that have the same name, even if they come from different locations, additional assets will be created by incrementing the file name: FilenameN, where "N" is the count of assets with the same name in the target folder. If you upload the same file more than once, additional assets will also be created.

Uploading Text Content

To upload text content from HTML files:

  1. Under Target Folder click on the Assets node to expand the Assets folder tree, then click on the folders in the tree to open them until you find the folder where you want to store the uploaded content. Click on that folder to select it. Note that you must have write permission on the folder you specify. If you do not have write permission on the specified folder, the upload will fail.
  2. If you are logged into the system in the Admin or Editor role, you see the Approve assetscheck box. Check this box (the default) if you want all uploaded files in the Pending state. Un-check the box to have all uploaded files in the Draft state.
  3. In the Asset Type drop list, choose the type of asset you want to create for the text content:
    • HTML
    • Rich Text
    • Simple Text
  4. When you choose one of these options, two additional fields are added to the dialog.
    1. In the Extract HTML from element, enter the selector that identifies the content you want to upload. Basic selectors include HTML tags, CSS classes, and CSS IDs. More complex selectors may combine these basic selectors. The extractor supports CSS Level 3 Selectors, so you can enter any valid CSS Level 3 selector. When entering the selectors, HTML tags can be entered as plain text, but CSS class and ID selectors must be marked correctly (classes must be designated using dot-classname [.classname] and IDs muse be designated using hash-ID [#ID]). See "Defining Selectors" below for additional details.
    2. Select the radio button that indicates whether to include the selector tag.
      • Select Inner HTML if you only want to upload the content of the selector tag but not the tag itself.
      • Select Outer HTML if you want to include the selector tag in the uploaded content.
  5. Click [Add File]
    CM1 displays a browse dialog.
  6. Find the file you want to upload and select it. You can select multiple files to upload. Click [Open] to queue the files for upload.
  7. To add files from another location, repeat Steps 5 and 6.
  8. To see a list of files queued to be uploaded, click the cuilittleblueexpandbutton.gif button next to Details. Click the cuilittlebluecollapsebutton.gif button to close the list.
  9. To remove a file from the queue, click the delete button: dl376 Delete Button.
  10. To remove all files from the queue, click [Clear All].
  11. To upload the queued files, click [Upload].
    • You can cancel upload of a file in the queue by clicking the delete button. If upload of the file has not started, it will be removed from the queue. If upload of the file has already started, it may be uploaded before the cancel can take effect.
    • You can cancel upload of all files remaining in the queue by clicking the [Cancel] button. If a file is being uploaded when you cancel, upload of that file may be completed before the cancel can take effect.
    • If upload of a file fails, the detail box for that file turns red and reports an error. If the error is an HTML error, try modifying your selector.

The Asset created for each uploaded file uses the filename of the uploaded file, including the file extension. All files are uploaded to the same Assets folder. If you specify files that have the same name, even if they come from different locations, additional assets will be created by incrementing the file name: FilenameN, where "N" is the count of assets with the same name in the target folder. If you upload the same file more than once, additional assets will also be created.

Defining Selectors

When defining the selector, the obvious choice is to use the enter <body> to upload all body content, but the body usually also includes navigation and other content that you may not want in your assets. Another approach is to select all content tags, such as <p> or <li> tags. This can work, but may also result in uploading of undesired or unexpected content.
For sites that use CSS for layout, the main content of the page is often in a div tag that uses a class or (more often) ID to designate its purpose. In the Bright Voyage templates, for example, the main body content is in a <div> with an ID of "section-main-body" (<div id="section-main-body">. To select this content you would enter #section-main-body as your selector.
When uploading content from sites that use table-based layout, you may want to upload only the content of specific table cells. These cells might be identified by specific class. For example, suppose your layout used the .mainbody class to identify those table cells. You would define your selector as td.mainbody.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk