Attachments

On this page

An attachment is a file or a link stored as a separate object and linked to a record. You can upload a file, attach a web address, or link an attachment that is already stored in Alloy Navigator.

Attachments in the Web App

What you can see and change

You can add, rename, describe, and delete attachments only while the record's form is editable. On a read-only form, dropping, pasting, and Attach are unavailable, Delete is disabled, and the Properties dialog opens without a Save button.

The Attachments tab

The Attachments tab lists the files and links attached to the record. When the record has no attachments yet and the form is editable, the tab shows a placeholder inviting you to drag and drop or paste a file.

  • A file row opens a preview of the file in a new browser tab: click its link, double-click the row, or use the open item of the row menu.
  • A link row's link opens the stored address.
  • The row menu's Properties item opens the attachment's properties.

The attachments of an individual activity entry are listed separately; see Activity Log. Their list, on the entry's Attachments tab, opens a file's preview in a new browser tab like the record's Attachments tab, but its row menu has no Properties item. It has a Save button that downloads the selected files and is disabled while no row is selected, and no Delete button. Opening an attachment from the attachment menu of an entry in the activity list downloads the file instead of previewing it.

  1. On the Attachments tab, click Attach.
  2. In the menu, choose one of:
    • Files to pick files from your computer.
    • Link to attach a web address. Enter the address, which must be a valid URL, and optionally a description, then click Attach. If you click Attach with an address that is not valid, the address is refused and Attach stays disabled until you correct it.
    • Attachment Browser to pick an attachment that is already stored in Alloy Navigator; see Use the attachment browser.
  3. If you added files or picked an existing attachment, save the record.

A link is saved as soon as you attach it. Files you select, drop, or paste, and existing attachments you select in the attachment browser, appear in a pending-files panel over the grid. They become attachments of the record when you save it.

You can also add files without the menu:

  • Drop files onto the Attachments tab.
  • Paste over the grid with Ctrl+V, Cmd+V, or the browser's Paste command. Every file the clipboard carries, such as a copied screenshot, is staged under the name the browser gives it. Pasting text adds nothing and shows no message.

Rename or remove a file before you save

Each entry in the pending-files panel has an Edit and a Delete icon.

  • Edit opens a dialog where you change the file's name and description. Only the part of the name before the extension can be changed, and the name cannot be empty. The dialog also shows the file's size in KB and in bytes. Edit is unavailable for an attachment you picked in the attachment browser.
  • Delete removes the entry from the panel.

View or change an attachment's properties

Open Properties from a row's menu. The dialog shows the name, the description, the file size (as a readable size and as an exact byte count), and, when a date is recorded, when and by whom the attachment was created and last modified. The technician's name opens that person's record in a new browser tab. When the attachment has no stored size, as is usual for a link, the dialog shows a not-available text in place of the size.

  • For a file, you can change only the description; the file name cannot be changed here.
  • For a link, you can change the address and the description. The address is required, and an address that is not a valid URL is refused with Invalid URL address.

Download or delete attachments

Download files

  1. Select one or more file rows.
  2. Click Download.

Link rows in the selection are skipped. If the first selected file cannot be opened, an error message appears and nothing is downloaded.

Delete attachments

IMPORTANT: Delete removes the attachment itself. If the same attachment is linked to another record, for example through the attachment browser, it is removed from that record too.

  1. Select one or more attachment rows. Delete is disabled when no row is selected.
  2. Click Delete.
  3. In the Delete confirmation, confirm Are you sure you want to delete the selected item(s)?

If the server reports an error, it appears in an alert.

Use the attachment browser

The attachment browser is a dialog for finding an attachment that is already stored in Alloy Navigator and linking it to the record. It opens from the Attach menu of the Attachments tab, from the attachment area of an action form, and from the attachments field of a recurring ticket's form. From an action form you can pick an existing attachment for a record that is not saved yet.

The dialog is titled AttachmentBrowser.

  1. Type text in the search box (up to 250 characters; the box has a control that clears it), and choose the field to match it against in the list beside it (the file name by default).
  2. Choose a scope. The choices depend on the class of the record, in this order:
    • This followed by the class name, which is selected when the dialog opens.
    • The class's own scopes, if it has any, such as the parent organization, location, or project and all children, the parents, children, and siblings of a work order, or the approval stage of an approval request.
    • Relationships, the record's related objects.
    • Custom search, which needs at least 3 non-blank characters of search text. While it is chosen, the dialog shows a prompt to enter at least 3 characters until you search with them.
  3. Click Search or press Enter.
  4. Double-click a row, or select it and click Select. Select is disabled until a row is selected.

Opening an attachment from the browser's list previews it.

Size limits

The Web App does not restrict the type of file you attach; it checks only the size of a single attachment. The limit is the attachment size set for the installation (see System Performance, Attachments and Help); when no size has ever been saved, it is 50MB. The effective limit can be lower when the web server's own request size limits are lower. When an administrator turns the limit off, only the web server's own request size limits apply.

  • A file you drop that is over the limit is rejected at once, with a message naming the file, its size, and the limit.
  • A file you paste over the Attachments tab is not checked when you paste it; the limit is applied when the file is uploaded as you save the record.

Add, replace, or clear a picture on a form

Some records have a picture field. On the default forms it is at the top of the General tab's second column, above Identification, on a Computer or Hardware form; first on the Contact Info inner tab of a Person form; and in a Picture container of its own in the first column below the details container on a Service Catalog Item form.

  1. On an editable form, click the picture (or the placeholder when there is none) and choose an image file, or drop an image file onto it. Only the first file is used.
  2. To remove the picture, hover over it and click Clear.
  3. Save the record.

The picture field has no size limit of its own. On a Service Catalog Item, it accepts BMP, JPEG, and PNG files; on other records, it accepts image files. PNG images keep their full size. Other images are adjusted to their recorded orientation, reduced to fit 300 by 300 pixels if necessary, and saved as JPEG. With no picture set, the field shows a placeholder icon that depends on the record's class. On a read-only form, clicking or dropping on the picture does nothing.

Attach files on an action form

An action's form can include an attachment area: a dashed drop zone that reads Drag files here to attach or press Ctrl+V to paste the image from the Clipboard., with an Attach button and an arrow beside it. An area can accept new files, existing attachments, or both; when it accepts neither, Attach and the arrow are disabled.

  • Click Attach to choose files from your computer. If the area accepts only existing attachments, Attach opens the attachment browser instead.
  • Click the arrow for a menu with Files, if the area accepts files, and Attachment Browser, if it accepts existing attachments. A link cannot be attached from an action form.
  • Drop files onto the zone, which takes drops only when the area accepts files, or paste them with Ctrl+V. Clicking the zone itself does nothing.
  • Click an entry's Edit icon to change the file's name and description; only the part of the name before the extension can be changed, and the name cannot be empty. Edit is unavailable for an existing attachment picked in the attachment browser.
  • Click an entry's Delete icon to remove the file from what the action will submit.

A file you pick passes the same size check as a dropped one. The files are uploaded when the action form is submitted, and before each step of an action wizard. A mandatory attachment area that holds no file fails validation with the message This field is required.