Attaching artifacts to assets

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.
Important: If your file or archive contains non-ASCII (for example, Unicode) characters in the name or contents, use the archiving tool on the Extensions page to create the archive. For instructions to use the tool, see Creating and opening asset archives by using the asset archive tool.

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:

  1. In the Submit an Asset or Modify an Asset page, below the attributes, click the Content tab.
  2. 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.
  3. 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.
  4. 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:
      1. 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.
      2. To remove a file, select the file and click Remove.
      3. 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.
      4. 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:
      1. Click Create a folder.
      2. In the Name field, type a name for the folder.
      3. Click Add. The new folder is displayed in the list.
      4. To upload files into the folder, click the folder name; then click Upload files.
    • (Optional) To create a link artifact:
      1. Click Create a link.
      2. In the Name field, type a name for the link. The name is an alias for the URL.
      3. In the URL field, copy and paste the web address to use as an artifact.
      4. 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.
      5. 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.


Feedback