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.

About this task

You can attach files (artifacts) to an asset in two ways. If your browser supports Java applets, you can attach multiple files individually, create a folder structure in which to store files, and add links as artifacts. If your browser does not support Java applets, you can upload multiple files by browsing for them one at a time.

To use the Java applet, your browser must use an 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 multiple 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. If you have only file to upload, click Browse and navigate to the file on your file system.
    Note: If you upload archive files (for example, .zip or .jar files), Rational Asset Manager will automatically extract them and upload the contents of the archive by default. If you do not want to expand the archive, use the Java applet as described in step 3 and when you are prompted, click No to not expand the archive.
    Important: Some browsers will only allow you to upload a file that is smaller than 2 gigabytes. If you are uploading a file that is larger than 2 GB, click More options and use the Java applet to upload the file.
  3. If you have many files to upload, or want to add URL links or folders, click More options. A Java applet will appear:
    • 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 below. 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. 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 appears below.
      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 forms-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 will 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