Introduction

Levels Beyond introduced a Reach Engine Panel Extension for several Adobe Creative Cloud^® software applications to assist with the production process, allowing users to access the Levels Beyond repository to work with assets. As of May 2018, the following software can have the Levels Beyond extension installed:

• Adobe Photoshop^®
• Adobe Illustrator^®
• Adobe InDesign^®
• Adobe AfterEffects^®

Benefits

The benefit of having the Panel Extension allows access to all your production within the Levels Beyond repository. All assets become integrated into the move-to-production process.
For additional information: {+}https://www.reachengine.com/+

What's New?

2.7.26 Release

• Panel Extension applies a metadata form to the assets that are about to be ingested into Reach Engine from Adobe Applications, and can then save the asset. 
• The Login panel remembers the username of the last user to login. 
• Metadata can be viewed in either Tile or List. 
• Unified Collection View lets you view assets within a collection, and take action on selected asset.
• Ping Authentication
• Signing Panel Installers for MacOS Gatekeeper
• All .pkg installers are notarized by Apple using the Levels Beyond Apple Developer ID during the build process
• Apply a metadata form to the Assets that are about to be ingested into Reach Engine from Adobe Applications
• Updated Panel look and feel to quickly navigate and view assets in a consistent and streamlined manner, including the ability to view Metadata in Tiles.
• S3 download and upload credentials via API

2.7.25 Release

• Panel Extension checks to see if a folder exists in temp the directory on the Status tab.
• Panel Extension version displays in Preferences panel. 

2.7.0 Release

• Additional Action Menu Options Based On Application
• Ingest a Selected Composition to Reach Engine from After Effects
• See asset icons in list view
• SAML works with One Panel
• Ingest Adobe project files
• Ingest multiple assets
• Use OAuth when logging in

0.5.0 Release

• Installation Instructions
• Cancel Search
• Setting Initial Preferences for Source and Proxy
• Creating a collection
• Ingesting assets
• Opening assets
• Showing versions of assets
• Ingest asset into collection from application
• Reviewing asset status
• Updated pathmapping

Installing Reach Engine Panel Extension

The Reach Engine Panel Extension is available for both Mac and Windows users. To download the installation package, select the associated link:
Mac: reach-engine-panel-extension-2.7.0.pkg
Windows: reach-engine-panel-extension-2.7.0.exe
To install the Reach Engine Panel Extension:

1. Download the .pkg or .exe from the associated link.
2. Double-click the package.
   • To support the increased Security requirements of the latest MacOS versions and "Gatekeeper" all Panel installers are now Signed with the Levels Beyond Apple Developer ID and officially validated and Notarized by Apple Inc.
3. Click Continue on the Introduction panel.
4. Navigate to the disk where to install the package and click Continue.
5. Click Install to install the Reach Engine Panel Extension
6. If required, enter the Administrator User Name and Password and click Install Software.
7. Click Close.

Using Reach Engine Panel Extension

The Reach Engine Panel Extension from Levels Beyond lets you access assets that previously were not as easily accessible for Adobe products other than Adobe Premiere and Adobe Prelude. Having an extension that can be loaded into other Adobe applications makes it easier to use and modify assets during the workflow process.

Accessing the Levels Beyond Extension Panel

After the extension has been installed on for your Adobe products, the extension panel can be accessed similarly regardless of which software product you are using. To access the extension panel:

1. In your application, navigate to Window > Extensions > Reach Engine Panel Extensions.
2. Click the the selection to display the Preferences screen.

Setting initial Preferences

The Preferences dialog box displays the first time accessing the Reach Engine Panel extension. To set up the preferences for accessing your assets:

1. Enter the Reach Engine URL. This address can be an http or https URL.
2. (Optional) Enter the Local Repository path where you want your assets to download to.
   • (Required) if Reach Engine is configured with cloud storage.
   • (Not Required) if Reach Engine is configured with local storage.
3. Enter the Source settings:
   • Source
   • Mezzanine
   • Proxy
4. Enter the Proxy setting:
   • Proxy
   • Mezzanine
5. Click Show Advanced Settings to set additional preferences for the level of detail required for error logs:
   • Error
   • Warning
   • Info
   • Verbose
   • Debug
6. Click Save.

Notes:

• Preferences can be changed by clicking the Settings icon .
• When there is no access to storage, the following error message displays:
  

Logging in to Reach Engine Panel Extensions

The Login dialog panel displays after setting your initial preferences, and every time afterwards when accessing the extension. Your username and password are assigned to you via Reach Engine To login:

1. Enter your user name in the User field.
2. Enter your associated password in the Password field.
3. Click LOG IN.
   
   Notes:
   • The login screen varies based on your individual setup, including logo and other branding information.
   • If using OAuth:

     • OAuth detects a valid session

     • OAuth allows two-factor authentication

     • Specific code is needed for:

       • Okta

       • SAML
       • Ping: Users are able to login and interact with Reach Engine per standard Panel supported capabilities when Reach Engine is configured for Ping authentication

         
         

   • Reach Engine will automatically log you out, and display a Keep Alive warning to continue your session.
     • The time before the "Keep Alive" warning displays is dependent on the Reach Engine server logout settings.
     • The Server logout setting is customizable by the client.
       
       
   • Based on the server you are connecting to, the panels stores the last user login. The panel also stores a list of recently connected servers. This is unique across the Adobe applications. 

Working with assets

The Extension Panel is divided into two tabs: Dashboard and Status. When the panel is opened, all assets within your repository are accessible to work with in the desired application. You can use the panel to search for an asset, sort assets, open the asset within the application, or view the status of an asset.

Viewing assets (Dashboard tab)

To view assets on the Dashboard:

1. Select 24 or 60 from the Items per page list menu to select the number of asset thumbnails to view per page.
   

2. Scroll through the assets using the scroll bar on the side, or sort the assets using the panel's sorting functions.

3. Select whether to view assets by List or Tile. 
4. If Tile view, choose the tile size with the slider. 

Sorting assets

Assets can be sorted by several options, and listed according to preferences in the Sort By selection switch. To sort the assets on the Dashboard,

1. Select Date Created, Date Updated, Name, or Relevance from the sort menu:
   • Date Created and Date Updated:
     • sorts the dates by newest to oldest
     • sorts the dates by oldest to newest
   • Name:
     • sorts the names from A-Z
     • sorts the names from Z-A
   • Relevance:
     • sorts the title from most to least relevant
     • sorts the title from least to most relevant
2. Review the assets by using the scroll bar on the right side of the panel.

The table indicates the asset type by icon:

Review by Asset Type

You can review the asset grid and asset list by asset type:

Asset Type and Display Icon

• Timelines
• Videos
• Audio
• Images
• Documents
• Other File Types
• Collection
• Projects
• Markers
• Timeline Clips
• Video Clips

Searching for assets

To search for one or more assets with your Reach Engine repository:

1. Enter the characters (alphanumeric, or special character) in the Search Term field. The asset list updates based on the characters entered.
2. (Optional) click Advanced Search.
3. In the Facets tab, optionally, select a Group from the Group drop-down, and/or select or more asset types:
   • Audio
   • Documents
   • Images
   • Collections
   • Markers
   • Others
   • Projects
   • Timelines
   • Timeline Clips
   • Videos
   • Video Clips
4. (Optional) Select Date Created, Date Updated, Name, or Relevance from the Sort By drop-down list in which to search.
5. Click Sort By to view the assets by Ascending or Descending order,
6. (Optional) Click the Advanced tab.
   1. Search for or select a collection from the Collection drop-down
   2. Enter conditions for the search in the Field and Operator drop-downs.
   3. Click +Condition to add an additional condition for your search.
7. (Optional) Click the Saved tab to run a saved search.
8. Click Search. The results display in the panel, and can be sorted as needed. Sort by
   • Type
   • Name
   • Updated
   • Created
   • Fields in "view settings"
9. Click X in the search field to Cancel the search.
10. Click Reset. The search results are reset.

Note: The View Settings can be set to display metadata in Tiles.

Working with assets

Selecting assets for use

One or more assets can be selected for use. To select one or more assets:

1. Click an asset in the panel. A check mark displays to indicate it's been selected.
2. Continue to select as many assets as needed.
   
3. Click the download button to store the asset in your local folder if configured with cloud storage. The asset will be imported to application and remain in the Reach Engine repository if configured with local storage.

Creating a Collection

A Collection can be created to work with ingested assets. To create a Collection:

1. Click the Action menu
2. Select Create Collection.
3. Type the Collection name.
4. Click Create.

Note: Collections can be created by also selecting an asset to ingest and clicking the Create Collection button (+).

Ingesting assets

To ingest assets into an existing collection:

1. Select the asset or assets to ingest.
2. Click the Action menu
3. Select Ingest Selected Asset. The Ingest Assets panel displays.
4. Select a collection from the drop-down arrow.
   
5. Click Ingest. The Status tab indicates the progress of the asset ingestion.

Ingesting assets from application to collection

The Extensions panel allows you to ingest an asset from the application in which you're working into a collection. For example, in Photoshop, you can ingest an asset from Photoshop into a collection. To use this feature:

1. Select a collection.
2. Click the Action menu
3. Click Ingest asset from (application)
   
4. Select the asset from the panel.
5. Click Ingest. The Status tab displays the progress of the ingest.

Ingesting assets using Metadata Forms

With release 2.7.26, any files used in Adobe applications can be ingested into Reach Engine with metadata using forms. This allows you to ingest, with metadata, any unmanaged asset in your project, composition renders in After Effects, and the source project. To ingest assets using Metadata Forms:

1. Click the Upload button in the panel to perform an ingest.
2. Use the right panel to choose a collection and metadata form to save to the assets.

Viewing assets in a unified collection 

Assets can be viewed in a unified collection.

• If you perform an advanced search and open a collection, the associated assets display. You can then double-click the asset to review the metadata.
• The breadcrumb trail in the top left corner lets you navigate within the collection.
• The assets within the collection can be viewed in either List or Tile view.
• Back arrows return to previous navigation.
• Any asset selected or displayed lets you take action on them.
  

Ingest single assets with metadata

1. Click the Upload button to perform an ingest.
2. Choose a collection and metadata form in the right panel.
3. Click Save to save the assets. 

Ingesting Projects

Adobe project files can be ingested into Reach Engine.

• Photoshop
  • .PSD
• Illustrator
  • .AI
• InDesign
  • .INDD
• AfterEffects
  • .AEP

Note: Ingesting with After Effects

• Previously, the Panel Extension could only ingest Video files
• With release 2.7.0, users can ingest compositions into Reach Engine

Opening assets

To open an asset in the associated application (for example, opening a .jpg in Adobe Photoshop):

1. Select the asset or assets to ingest.
2. Click the Action menu
3. Click Open Selected Asset. The Status tab displays the download progress of the asset. The asset opens when upon successful download.

Showing versions

The Show Versions option allows you to review the version changes of a selected asset. This option only displays when a single asset is selected. To review the versions of an asset.

1. Select the associated asset.
2. Click the Action menu
3. Select Show Version. The Versions panel displays with all versions of the asset, with associated data.
4. Select a version of the asset to save and click Save Current Version.

Additional Action Menu Items

The Action Menu options display based on the application in use. For example, Photoshop will have different action items from After Effects. Following is a breakdown of actions based on application:

Photoshop

• PSD selected
  • Save Project
  • Hide Ingest Asset from Photoshop
• Other image types (TIFF, JPEG, PNG, PDF, etc)
  • Hide Save Project
  • Ingest Asset from Photoshop

Illustrator

• AI selected
  • Save Project
  • Hide Ingest Asset from Photoshop
• Other Image Types (TIFF, PDF, JPEG, etc)
  • Hide Save Project
  • Ingest Asset from Illustrator

InDesign

• INDD selected
  • Save Project
  • Hide Ingest Asset from InDesign (You can only have INDD in InDesign)

After Effects

• AEP selected
  • Save Project
  • Hide Ingest Asset from After Effects
• Created Composition selected
  • Hide Save Project
  • Render Composition and Ingest (Update: Ingest Asset from After Effects)
• Other Video Types (MOV, MXF, MP4, etc)
  • Hide Save Project
  • Ingest Source Asset from After Effects
  • Render Video and Ingest

Reviewing Asset Metadata

Each asset has metadata that can be reviewed. When the asset is selected, the Extensions panel applies any configuration from the local file, similar to Premiere and Prelude. To see the asset metadata detail:

1. Double-click the asset. The asset detail screen displays.
   
   
2. Click the < or > arrows to review additional metadata information for the selected asset.

Metadata Tile and List view

From View Settings, users can search on and select the metadata fields to view on their assets in Tile and List view. The panels columns and tile sizes will update accordingly after the view settings are saved. To chance views, use the selector on the left of each metadata field to change the display order.

Tile View

List View

Reviewing asset status (Status tab)

To review the action status of an asset, click the Status tab. The current status of the selected asset displays with a color bar indicator:

• Completed workflows = Green (100%)
• Executing workflows = Blue (.01 - 99.99%)
• Failed workflows = Red (any %)

## Panels
panels.pathmapping.panel_extension.mac=panel_extension_mac
panels.pathmapping.panel_extension.windows=panel_extension_windows