You can attach files or URL
links as artifacts to an asset. If you attach new artifacts to the
asset and a review process is available, you must submit the asset
into the review process to have the updated asset artifacts reviewed
before the change can take effect.
About this task
You can attach files (artifacts) to an asset in two ways.
If your browser supports Java applets, you can attach files larger
than 2 GB, create a folder structure in which to store files, and
add links as artifacts.
To use the Java applet, your browser
must use a Java™ Runtime Environment
(JRE) 1.5 Update 6 or later, or 1.6 Build 3 or later.
If you
do not use the Java applet and you want to attach more than ten files,
you can put the files into a single archive by using a compression
utility. If you add a file or archive to an asset that has a the same
file name or archive name attached to it, the existing file or archive
is replaced with the one being added.
Asset
artifacts can be attached files, references to remote development
artifacts in other repositories (a URL), or an Eclipse software update
site.
Procedure
To attach artifacts to the asset:
- In the Submit an Asset or Modify an Asset page, below the
attributes, click the Content tab.
- Select files to upload. Click Browse and
navigate to the file on your file system.
Important: With some browsers, you can upload only those file
sets that are smaller than 2 GB. If you are uploading a file or a
set of files that is larger than 2 GB, click More options and
use the Java applet to upload the file.
- To upload more than one file, click Add another
file, and then click Browse and
navigate to the file on your file system. You can upload
up to ten files by clicking Add another file.
To upload more than ten files, use the Java applet.
- If you have more than ten files to upload,
or want to add URL links or folders, click More options.
A Java applet opens:
- To upload multiple files:
- In the Upload Files section, click Add and
browse to the file on your file system. Repeat this for all files
you want to add.
- To remove a file, select the file and click Remove.
- When you have selected all the files you want to upload, click Upload.
The artifacts are listed in the Content section. To preview an artifact,
click either the spectacles icon or the artifact name. To remove a
file from the asset, click Delete.
- If you upload archive files (for example, .zip or .jar files),
you will be asked if you want to automatically extract and upload
the folders and files in the archive. To extract files, select Yes or Yes
to all. To leave them as archive files, select No or No
to all.
- (Optional) To create a folder:
- Click Create a folder.
- In the Name field, type a name for the
folder.
- Click Add. The new folder is displayed
in the list.
- To upload files into the folder, click the folder name; then click Upload
files.
- (Optional) To create a link artifact:
- Click Create a link.
- In the Name field, type a name for the
link. The name is an alias for the URL.
- In the URL field, copy and paste the web
address to use as an artifact.
- Optional: To save a local copy of the content of the URL to the
repository (so that the content of the artifact is searchable), select Cache
URL content. If you must enter a user name and password
to access the URL, select the appropriate set of credentials from
the Credentials list. To allow users to download
the cached file, click Allow content to be downloaded.
Note: You
can use credentials for sites that use HTTP basic access or form-based
authentication.
- Click Add.
- Optional: To give users information about a file, enter a
label for each artifact. For example: Start here, Deprecated,
or Primary example. Review processes might
require specific artifacts with specific labels, file extensions,
or types. Messages that describe the requirements are displayed in
the wizard.
What to do next
Next, categorize the asset or add
related assets.
When you are ready to submit the asset to the repository,
click Save. If you are modifying an existing
asset, click Update.
If the
artifacts comprise a complete Eclipse update site (a site.xml file,
a /features/ folder, and a /plugins/ folder),
after you have submitted the asset, users see a link on the Content
page labeled Eclipse Update Site with a URL
that they can use in the Eclipse IDE software update tool.