{"id":22159,"date":"2024-02-15T14:48:40","date_gmt":"2024-02-15T22:48:40","guid":{"rendered":"https:\/\/docs.extraview.com\/v22\/book\/attachment-layouts\/"},"modified":"2024-02-15T16:32:14","modified_gmt":"2024-02-16T00:32:14","slug":"attachment-layouts","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/","title":{"rendered":"Attachment Layouts"},"content":{"rendered":"

Click for end user documentation<\/a><\/p>\n

\n\tSecurity Permission Keys<\/h3>\n\n\n\n\n\n\n\n\n\n\n
\n\t\t\t\tField\/Security permission key<\/td>\n\n\t\t\t\tPurpose<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT<\/td>\n\n\t\t\t\tThis key controls the overall ability to create attachments. Write permission to this key is needed by the user role, for attachments to be able to be created or maintained. If there is no read permission, the attachment layout is not visible. This field is the only field that should be placed on reports where you want to display attachments, such as the detailed report. The remaining fields for the attachment will be placed onto the report by ExtraView, according to whether the field has read permission. When you have read permission to attachments on reports, a View attachment button is automatically placed on the report, allowing you to view the contents of all attachments to an issue directly.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_ADD<\/td>\n\n\t\t\t\tThis controls the Add button for attachments. Write access is needed to control this.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_DELETE<\/td>\n\n\t\t\t\tThis is to enable and disable the delete attachment button.<\/p>\n

\t\t\t\tA Delete<\/strong> button is also placed at the top of the attachment layout, if attachments exist and the ATTACH_SELECT button is placed on the layout and the user role has permission to this field.  This allows you to select multiple attachments and delete them with a single action.<\/td>\n<\/tr>\n

\n\t\t\t\tATTACHMENT_EDIT<\/td>\n\n\t\t\t\tControls whether a user role may edit the attachment description of a previously uploaded attachment. Write permission is needed for this<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_HIST<\/td>\n\n\t\t\t\tControls the presence of a History button on the edit screen within the attachment. This button presents a window with a layout defined in the layout editor and named ATTACHMENT_HISTORY, which presents the historic records showing the updates and accesses to attachments. Normally, this layout is defined in the global area, and inherited by all business areas and projects.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_VIEW<\/td>\n\n\t\t\t\tControls whether a user role may view a previously uploaded attachment. Read or write permission is needed for this<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_SAVE<\/td>\n\n\t\t\t\tThs button invokes the browser’s ability to download and save an attachment, as opposed to viewing the attachment with the ATTACHMENT_VIEW button.  Note that this button behaves differently within different browsers:<\/p>\n

<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\t\t\t\t\t\t\t\tGoogle Chrome<\/td>\n\n\t\t\t\t\t\t\t\tDownloads the attachment into the user’s default download directory<\/td>\n<\/tr>\n
\n\t\t\t\t\t\t\t\tMozilla FireFox<\/td>\n\n\t\t\t\t\t\t\t\tDisplays a Save As dialog box from which the user can select the destination into which the attachment may be saved<\/td>\n<\/tr>\n
\n\t\t\t\t\t\t\t\tMicrosoft Internet Explorer 11 running under Microsoft Windows 10<\/td>\n\n\t\t\t\t\t\t\t\tDisplays a Save As dialog box from which the user can select the destination into which the attachment may be saved<\/td>\n<\/tr>\n
\n\t\t\t\t\t\t\t\tMicrosoft Internet Explorer 11 running under Microsoft Windows 7<\/td>\n\n\t\t\t\t\t\t\t\tThis is not supported by the browser<\/td>\n<\/tr>\n
\n\t\t\t\t\t\t\t\tMicrosoft Edge<\/td>\n\n\t\t\t\t\t\t\t\tDownloads the attachment into the user’s default download directory<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_ID<\/td>\n\n\t\t\t\tThis is an internal ID used by ExtraView. It is not likely that you will give permission to this key for any user role.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_CONTENT_TYPE<\/td>\n\n\t\t\t\tThis is the mime content type of the attachment. You can control the visibility of this key with read permission. You cannot write to this field.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_CREATED_BY_USER<\/td>\n\n\t\t\t\tThis is the name of the user who created the attachment. Once again, you cannot write to this field, and its presence or absence is controlled with the read flag.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_DATE_CREATED<\/td>\n\n\t\t\t\tThis is the date that the attachment was created. Once again, you cannot write to this field, and its presence or absence is controlled with the read flag.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_DESC<\/td>\n\n\t\t\t\tThis is the description of the attachment that the user enters. Both write and read operations are allowable on this field.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_NAME<\/td>\n\n\t\t\t\tThis is the name of the file that is attached to the issue. Once again, you cannot write to this field, and its presence or absence is controlled with the read flag.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_SIZE<\/td>\n\n\t\t\t\tThis is the size, in bytes, of the attachment. Once again, you cannot write to this field, and its presence or absence is controlled with the read flag.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_PATH<\/td>\n\n\t\t\t\tThis is the path in which the file was originally stored on the local file system of the creator\u2019s computer. Once again, you cannot write to this field, and its presence or absence is controlled with the read flag.<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_THUMBNAIL<\/td>\n\n\t\t\t\tThis previews the attachments of image types (JPG, PNG and GIF) at a small size, in order that the user may see the image while they are inserting and updating issues, as well as seeing the field on reports when they are looking at attachment records.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\n\tFields<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\t\t\t\tField Name<\/td>\n\n\t\t\t\tPurpose<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_CHANGE_TYPE<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment.  This will show whether the attachment was inserted, viewed or deleted<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_CONTENT_TYPE<\/td>\n\n\t\t\t\tUsed to display the Mime type of the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_CREATED_BY_USER<\/td>\n\n\t\t\t\tThe user who inserted the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_DATE_CREATED<\/td>\n\n\t\t\t\tThe timestamp of when the attachment was created<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_DESC<\/td>\n\n\t\t\t\tThe user supplied description of the attaachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_NAME<\/td>\n\n\t\t\t\tThe file name of the attachment as it existed when it as uploaded<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_FILE_SIZE<\/td>\n\n\t\t\t\tThe file size, in bytes, of the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_HIST_TIMESTAMP<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment.  This field shows when the change to the attachment occurred or the attachment was viewed<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_LAST_DATE_UPDATED<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment.  This field shows when the change to the attachment occurred<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_LAST_UPDATED_BY_USER<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment.  This shows who last changed the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_LAST_UPDT_COMPANY<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment.   This shows the company name of the user who last viewed or updated the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_PATH<\/td>\n\n\t\t\t\tThe path to the attachment from the computer that uploaded the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_SELECT<\/td>\n\n\t\t\t\tThis field controls the presence of a checkbox by each attachment, allowing the user to select one or more attachments for further operations, such as deleting them<\/td>\n<\/tr>\n
\n\t\t\t\tATTACH_THUMBNAIL<\/td>\n\n\t\t\t\tA thumbnail of attachments with an image type.  A behavior setting named THUMBNAIL_MAX_SIZE<\/code> controls the maximum size of the thumnail images.  Users may click on the thumbnail image to view \/ download the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_ID<\/td>\n\n\t\t\t\tThe internal ID of the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_EDIT<\/td>\n\n\t\t\t\tA button that allows the user to edit \/ delete the attachment<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_SAVE<\/td>\n\n\t\t\t\tUsed within a fixed layout displayed when the user clicks the ATTACHMENT_VIEW button to show the history of accesses to the attachment. This allows the user to save their changes<\/td>\n<\/tr>\n
\n\t\t\t\tATTACHMENT_VIEW<\/td>\n\n\t\t\t\tThis places a View <\/strong>button on the screen.  When pressed, the user will either see the attachment in a new window, or will be prompted to save the attachment on their local computer<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\n\tAdd & Edit Layouts<\/h3>\n

There is a default layout in the Global Area, Master Project that defines the layout for file attachments.  This layout is named ATTACHMENT_SECTION.  This may be embedded within any add <\/em>or edit<\/em> layout.  Before any alterations, this looks like the following:<\/p>\n

\"\"<\/p>\n

The security permission keys PR_ADD_PROBLEM.ATTACHMENT and PR_RESOLUTION.ATTACHMENT control the overall visibility of the layout, and the following security permissions control the ability to place attachments from within the add <\/em>and edit <\/em>screen layouts. Security permission entries exist for both the PR_ADD_PROBLEM set of keys and the PR_RESOLUTION set of keys, except for ATTACHMENT_DELETE, ATTACHMENT_EDIT, ATTACHMENT_HIST, and ATTACHMENT_VIEW which only exist for the PR_RESOLUTION set of keys.<\/p>\n

\n\tRecommendation<\/h4>\n

If you are configuring mobile layouts, consider saving the ATTACHMENT_SECTION layout as a mobile layout and removing fields which are going to clutter up small screens, especially on phone targets.  You can configure the fields on the layout vertically as opposed to horizontally, similar to this:<\/p>\n

\"\"<\/p>\n

Multiple attachments can be added to issues, on both the add<\/em> screen and the edit<\/em> screen, if the user role has permission.  Note the Select?<\/strong> checkbox on add<\/em> and edit screens.<\/em> The presence of this is made by adding the ATTACH_SELECT field to the attachment layout.  With this configuration, a Delete<\/strong> button will also be displayed, and the user can select any of the attachments then press the Delete<\/strong> button. <\/p>\n

Note that if an attachment is added to an issue when you are updating an issue, the issue itself is immediately updated.<\/p>\n

<\/p>\n

Portion of edit screen showing attachments<\/span><\/p>\n

<\/p>\n

Portion of detailed report showing attachments<\/span><\/p>\n

A behavior setting named THUMBNAIL_MAX_SIZE <\/span>controls the size of the thumbnail. This is the maximum number of pixels in either the horizontal or vertical direction to which thumbnail images will be generated. The aspect ratio of the original image will be retained. Thumbnail images are generated for file attachments and for fields with a display type of image. If you change this value, existing thumbnail images will remain at their original size and new thumbnails will be generated at the changed value.<\/p>\n

\n\tDetailed Report Layouts<\/h3>\n

You should not embed the ATTACHMENT_SECTION layout within Detailed Report layouts.  Instead, there is a field with special properties, named ATTACHMENT.  This field should be placed on the Detailed Report layout.  You then can control the presence or absence of the individual fields that comprise the attachment information with their security permission key.  This leads to a layout for detailed reports that looks similar to this:<\/p>\n

<\/p>\n

 <\/p>\n

Click for end user documentation<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Click for end user documentation Security Permission Keys Field\/Security permission key Purpose ATTACHMENT This key controls the overall ability to create attachments. Write permission to this key is needed by the user role, for attachments to be able to be created or maintained. If there is no read permission, the attachment layout is not visible….<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-22159","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nAttachment Layouts - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Attachment Layouts - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Click for end user documentation Security Permission Keys Field\/Security permission key Purpose ATTACHMENT This key controls the overall ability to create attachments. Write permission to this key is needed by the user role, for attachments to be able to be created or maintained. If there is no read permission, the attachment layout is not visible....\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2024-02-16T00:32:14+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/\",\"url\":\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/\",\"name\":\"Attachment Layouts - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\"},\"datePublished\":\"2024-02-15T22:48:40+00:00\",\"dateModified\":\"2024-02-16T00:32:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v22\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Attachment Layouts\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Attachment Layouts - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/","og_locale":"en_US","og_type":"article","og_title":"Attachment Layouts - Product Documentation","og_description":"Click for end user documentation Security Permission Keys Field\/Security permission key Purpose ATTACHMENT This key controls the overall ability to create attachments. Write permission to this key is needed by the user role, for attachments to be able to be created or maintained. If there is no read permission, the attachment layout is not visible....","og_url":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/","og_site_name":"Product Documentation","article_modified_time":"2024-02-16T00:32:14+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/","url":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/","name":"Attachment Layouts - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v22\/#website"},"datePublished":"2024-02-15T22:48:40+00:00","dateModified":"2024-02-16T00:32:14+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v22\/attachment-layouts\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v22\/attachment-layouts\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v22\/"},{"@type":"ListItem","position":2,"name":"Attachment Layouts"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v22\/#website","url":"https:\/\/docs.extraview.com\/v22\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v22\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v22\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v22\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v22\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v22\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v22\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22159","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/comments?post=22159"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22159\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/media?parent=22159"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}