Permissions: Access to the Apps page is controlled through the Apps Hub Developer and Apps Hub Publisher privileges. Developers build applications, assign files, and deploy, test, and launch them. Publishers publish applications to the Apps Hub and manage each application's viewer permissions.

Custom Shiny analytical applications are built, published, and managed from the Apps page in the Statistical Computing Environment (SCE). The SCE supports Shiny applications built in either R or Python, enabling developers to create interactive dashboards and visualizations that connect to elluminate data stores.

Applications are hosted and delivered through Posit Connect and published to the Apps Hub, where authorized users can discover and launch them. Launched applications display data scoped to each user's elluminate privileges, including data store access and data blinding, without changes to the application code. For the viewer experience, refer to the Access Published Applications in the Apps Hub article. 

Access the Apps Page

1. Open the SCE from the Platform Menu under Data Mapping & Computing.

   

2. Select the Apps tab. The Apps page opens.

The Applications page displays each application's Name, Description, Files, Type, Deployment Status, and App Status, along with the available actions. Applications exist in a Development state and a Published state.

Create an Application

1. On the Apps page, click + New App. The Create Application window opens. Enter an App Name, optionally enter a Description, select Shiny for R or Shiny for Python as the App Type, and click Create App. The application is created in the Development state with zero assigned files.

   

2. Write the application programs in the SCE Editor, as with other SCE programs. Any file type except .sas files can be assigned to an application, including R and Python programs, JSON files, logos, and design files.
3. Assign files to the application using Push to App, represented by the share icon (a right-pointing arrow in a square). The Push to App window opens, listing the selected files with their versions and folder paths. Select one or more applications to push to, and click Push.

• From the Editor, click the Push to App icon for an open program.
• From the Browser, select multiple files, right-click, and select Push to App.

• From the Browser, right-click a folder and select Push to App to push all files in the folder and its subfolders in a single action.

  Note: Pushed files replace the file versions already assigned to the selected application.

  

• From the Browser, right-click a parent folder and select Push to App to push all files in the folder and its subfolders in a single action.

Important: Files must be in Production status to be pushed to an application. Files in Development or Review status cannot be pushed.

Note: Push to App assigns files to an application in the SCE. Publish, on the Apps page, makes a deployed application visible in the Apps Hub.

Tip: To update an application, push only the changed files and redeploy. The assigned files can be at different versions.

Manage Applications

The Apps page provides the following actions for each application:

• Deploy: The cloud icon deploys the assigned file package. A live deployment log displays progress and status while required packages are installed.
• Launch: The rocket icon opens the application within the SCE so developers can test a deployed application, including applications in the Development state.
• Publish: The paper plane icon publishes the application, making it visible in the Apps Hub to its assigned viewers.
• Revert: The circular arrow icon reverts the application to its previously deployed version. 
• Files: Click the file count in the Files column to open the Assigned Files panel, which lists each file's name, folder path, version, and push details. Files can be removed individually or via multi-select.
• Three-dot menu: Provides access to Configuration and Runtime Logs.

Configure Application Permissions

1. From the application's three-dot menu, select Configuration. The Configure Application window opens with two tabs: Settings, for the application's name, description, and type, and Permissions.

1. On the Permissions tab, under Viewer Access, assign individual users on the Users tab or entire groups on the Groups tab. Only users and groups with viewer permission can access and view the published application in the Apps Hub.

1. Click Save Configuration. A confirmation message displays.

View Runtime Logs

A runtime log is generated each time an application is launched. From the three-dot menu, select Runtime Logs to open the Runtime Logs panel, which lists each log with the user who generated it and the date and time. Click a log to view or download it, including any errors, for troubleshooting. Program-related errors require updating the program, pushing it to the application again, and redeploying.