# Working in Portal With Portal, a digital asset management tool that is part of the PromoMats and MedComms applications, you can easily search, view, and download curated content for your brand or team. ## Accessing Portal Users with the correct permissions can access their Brand or Medical Portals through Business Admin or the **Portal** tab. ### About the Portal Selector Page {#about-all-portals} PromoMats and Medical users can view the **Portal Selector** page by clicking the Portal tab in Vault. By default, the _Portal Selector_ page displays in **Card** view. You can change this to **Grid** view by clicking . Vault remembers the view that you last selected and opens it automatically when you open the _Portal Selector_ page. You can perform the following actions on the _Portal Selector_ page: * Click a Portal name or logo to view that Portal. * Click to favorite the Portal. * Click **All Portals** to filter the _Portal Selector_ page on _All Portals_, _Recents_, or _Favorites_. While in _Grid_ view, you can also click **Filter** in the **Product** and **Portal Group** column headers to filter on those fields. * Hover over the Portal name and click the icon to launch the Portal in a new tab. To return to the _Portal Selector_ page from a Portal, click the Portal logo and select **View All Portals**. Select **Back to Vault** to return to your Vault. ### Direct Portal URL Once logged into your Portal, you can bookmark the Portal's URL to return to the same Portal in the future. You will need to provide your login credentials each time that you access your Portal. ## About the Portal Homepage {#portal_homepage} When you log into Vault or navigate to your Portal through the _Portal Selector_, you land on the Portal Homepage. The Portal Homepage houses widgets through which you can easily find relevant content: * **Carousel**: The Carousel displays your Portal's most important content as a click-through banner at the top of the Portal Homepage. * **Content Filters**: Content filters are saved search views that display filtered content for your brand. Click a filter to view the associated content in the Portal Library. * **About Section**: In the _About_ section, your Portal manager provides a quick description and key information about the Portal. * **Featured Items**: This section displays the top content for your brand, curated by your Portal manager. * **Most Popular Widget**: Vault automatically updates the _Most Popular_ widget with the steady state documents assigned to the Portal with the highest number of source file or rendition downloads from your Vault in the Portal in the previous 45 days. * **Recently Added Widget**: Vault automatically populates the _Recently Added_ widget with recently added steady state documents. * **Coming Soon Widget**: Vault automatically populates the _Coming Soon_ widget with documents in the Portal that are in the _In Review_ or _Starting_ state to provide visibility into materials that will soon be approved and available. * **Most Active Widget**: Vault automatically populates the _Most Active_ widget with steady state documents assigned to the Portal with the most activity, including views, copies, downloads, and rendition downloads, in your Vault and across all Portals. * **Most Viewed Widget**: Vault automatically populates the _Most Viewed_ widget with the most viewed steady state documents in your Vault and across all Portals. * **Additional Content Widgets 1-9**: These sections are manually maintained by your Portal managers. They may be renamed in your Portal. ## Using the Portal {#using_portal} Contents in the Portal Homepage and Portal Library use a hover over action, providing easy access to Portal materials. When you hover over content, Vault displays key information and options for quickly interacting with your document: * **Make a Copy**: Click the **Copy** button to make a copy of the document or binder. See details below about copying documents. * **View Full Details**: Click the **View Full Details** button to see the full document or binder in the document viewer. From the document viewer, you can interact with the document, view the document's metadata, access the **Actions** menu, and more. Use to breadcrumb trail to navigate **Back to Portal** from a document. * **Add to Cart**: Click this button to add the document to your cart. * **Download**: Click this button to download the document's source file. You can only download documents from the hovercard or Quick Look viewer. To download source files for a Binder, add the binder to your Cart. Your Admin may disable downloads. ## Using the Quick Look Viewer {#quick_look_viewer} Clicking a document in the Portal Homepage or Portal Library launches a Quick Look viewer that displays key document details, including the name, status, document type, document number, and description, as well as document actions. Click the left and right navigation arrows to browse through the documents in the widget or Library. Click **X** to exit the Quick Look viewer. ### Previewing Documents You can preview entire documents directly from the Quick Look viewer. From within the Quick Look viewer, hover over the document page to see navigation options. Click the up and down arrow buttons at the bottom of the document page to navigate through the document, or enter a page number manually to view that page. Click the **Expand** button to view the document in full-screen mode. In full-screen mode, navigation options appear at the top of the screen. Click **X** to exit full-screen mode. ### Previewing Video Files You can play back video files directly from the Quick Look viewer. Hover over the video file, and click the play button to start the video. From the Quick Look viewer, you can also pause the video, skip back 10 (ten) seconds, manually navigate the video, or control volume. Click the **Expand** button to play the video in full screen. Click the **Shrink** button to exit full-screen mode. ### Previewing Audio Files You can play audio files directly from the Quick Look viewer. Hover over the file and click the play button. From the Quick Look viewer, you can also pause, skip back ten seconds, manually navigate to a specific time signature in the file, or control volume. Vault displays the album art thumbnail associated with the audio file, if available. If no album art is available, Vault displays a black thumbnail. ## Content Filters {#content_filters} Content filters are saved search views that display filtered content for your brand. For example, your Portal could have filters for Campaign Toolkits, Videos, and Materials. Click a **Content Filter** icon to navigate to the associated content. When you click into a filter, Vault navigates you to a filtered view of the Portal Library. You can access other filters from the left sidebar of your Portal Library. ## Announcements {#announcements} Portal managers can make Portal-wide announcements and share information through the _Announcements_ page. Click **View All** to open the _Announcements_ page. Announcements appear in chronological order, with the most recent announcements at the top of the page. Use the _Announcements_ search bar to find older announcements in your Portal.
## Portal Subscriptions & Notifications With Portal Subscriptions & Notifications, you can subscribe to a Portal from the _Portal_ tab in Vault by hovering over a Portal and clicking the **Subscribe** icon. By subscribing to a Portal, you receive a weekly digest email listing the announcements and documents added to the Portal within the last seven days. You can also hover over the Portal and click **Unsubscribe** to be removed from the weekly digest email. If you subscribe to more than one Portal, you receive a weekly digest email for each Portal. If no new content is available, Vault does not send a weekly digest email. The weekly digest email provides a list of up to five announcements and up to ten documents added to the Portal within the last seven days. Clicking an announcement takes you to the Portal Homepage, and clicking a document takes you directly to the document in the Portal Library. ## Searching in Portal Portal uses Vault's powerful search engine to help you find your content. You can perform searches from the search bar. Click the binoculars icon in the search bar to use Advanced Search. You can filter search results or add filters to your current Portal Library view. When you search while in a Portal, Vault searches content within the current Portal and any related Portals. If you are viewing a Portal from within PromoMats or MedComms, you see Vault's primary search bar and can select **Portals** in the search bar's drop-down menu to search the Portal(s). By default, Vault displays content in the Portal Library in the _Grid_ view. Use the layout selector to switch between the _Grid_, _Detail_, _Thumbnail_, and _Compact_ views. ## Making a Copy {#copy} You can perform the **Make a Copy** action by clicking the **Copy** button from the document hovercard or Quick Look Viewer. To copy a document from Portal: 1. Click the **Copy** button in the hovercard or Quick Look Viewer. 2. In the dialog, enter a **Name** for the new document or binder. 3. Optional: Select a **Reason for Copy** from the picklist. This feature may not be enabled in your Vault. See Copying Documents for details. 4. Choose whether to copy the document contents, fields, or both. Contents include the document's source file, renditions, annotations, and references, including reference relationships. Fields include the document fields (metadata) and (non-reference) relationships. These options are not available for binders. 5. Click **Continue**. 6. The Doc Info page opens for the new document. Fill in any fields as needed and click **Save**. Vault navigates you to the Portal Library. ## Sharing Portals & Widgets While viewing a Portal or tabbed Portal widget, such as _Featured Items_, _Recently Added_, and _Most Viewed_, you can create and copy a shareable link. You can then paste the copied link to another location, such as an email. Users must have _Read_ permission on the Portal and any included documents to view the shared content. When you copy a link to a Portal or widget for the first time, Vault creates a _Portal Link_ (`portal_link__v`) record. The _Portal Link_ object is system-managed. You cannot create or modify _Portal Link_ records. To create and copy a link to a Portal, click the Portal logo and select **Copy Link**. To link to a widget, ensure you are on the correct widget tab, then click **Copy Link**.
## Working in Cart {#cart} With Cart, you can download multiple documents at once. To download with Cart: 1. Add documents to your Cart from the Portal Homepage, Portal Library, or the document viewer using the cart **button** with the green plus (**+**) symbol. If a document is already in your cart, the button displays with a red minus (**-**) symbol. 2. Click the Cart icon in the Vault navigation bar to navigate to your cart. 3. Click **Download**; Vault generates a ZIP file containing source files for all documents in your cart. To remove a document from your cart, click **Remove** under the document's name. To remove all documents from your cart, click the **Empty Cart** button. ## Related Permissions {#permissions} | Type | Permission Label | Controls | | --- | --- | --- | | Security Profile | Portal: Read | Grants PromoMats and MedComms users permission to see Portals that are configured in their Vaults. If your Vault uses Dynamic Access Control (DAC) on the _Portal_ object, you also need _View_ permission on each _Portal_ object record. | | Security Profile | Document: Download Document | Grants ability to download document source files; you must also have the appropriate role-based permissions for a document to perform this action. | | Security Profile | Document: Download Rendition | Grants ability to download document renditions, including _Viewable Rendition_. You must also have the appropriate role-based permissions for a document to perform this action. | | Document Role | Create Document | Grants ability to **Make a Copy** on documents by creating documents of the same document type. | | Document Role | Create Binder | Grants ability to **Make a Copy** on binders by creating binders of the same document type. | | Document Role | View Document | You must have this permission on a document which you want to copy in order to **Make a Copy** or preview a document from the Quick Look viewer. Users receiving a shared link must also have this permission to view documents included in the shared Portal and/or Portal widget. | | Document Role | View Content | You must have this permission on a document which you want to copy in order to **Make a Copy**. |