Maintaining Apps & Content Settings

Activating a Full-page App License

Abstract

This section describes configuration steps for an Infinite Application Licensed Admin to add access to a Full-page App License for the current tenant.

To add a Business Partner Application,

1. Select Full-page App from the Integration Type dropdown list.

2. Select Activate new license. This opens the Activate Full-page App License page.

   Figure 133. Select Full-page App and select Activate new license

   

   Figure 134. Activate Full-page App License page

   

3. Select the applicable Full-page app that was uploaded to the Infinite BrassRing Platform from the Full-page Apps dropdown list. The Activate Full-page App License page opens with the information for the selected Full-page App.

   Figure 135. Select Full-page app from Full-page Apps dropdown list

   

   Figure 136. Activate Full-page App license Title and Description fields

   

4. Enter a title label and description for the Full-page app in the Title and Description fields.

   Note

   The Title is an optional step, the user can use the default value already in place for the Title field. When the name is changed in the Title field (also known as the label for the application) and then saved, the Application Launcher navigation bar displays the new Full-page app title.

   Figure 137. New title displays on the Application Launcher navigation bar

   

   When a description is entered in the Description field, it displays in the Description column on the Apps & Content landing page.

   Description column on the Apps & Content landing page

   

5. The Landing page field contains the URL for that client. Before Selecting Submit, verify that the landing page URL is correct for this client.

   To verify on the Full-page App Edit page,

   1. Place your cursor in the Landing page field and scroll to the end of the URL address inside the field to view the entire URL address.

      Note

      For the Landing page field, Refer to the Business Partner enablement in the Infinite BrassRing Platform located at Introduction to validate and confirm if the partner solution supports multi tenancy by keeping the default URL or if the URL needs to be updated for this client.

6. Select Activate to activate the selected Full-page app or Cancel to exit without saving. Upon successful completion, the enabled application page displays.

   Figure 138. Successfully enabled Full-page application

   

   Note

   The application is now recognized as a valid client and is immediately available to the client in the Gatekeeper system. Any changes that are made in any of these fields will only affect this client.

7. Select the Back link to navigate back to the Apps & content landing page. The newly enabled Business Partner application will be shown in the list of applications.

   Figure 139. Newly enabled Business Partner app in list of applications
   Once a user is fully set up,

8. Refresh the page.

9. Select the Application Launcher icon to launch the Application Launcher navigation bar. The new enabled application will display just prior to the Amin application icon on the Infinite BrassRing Platform navigation bar.

   Note

   The person who adds the application in the Infinite BrassRing Platform will see the application right away in the Application Launcher navigation bar and is also licensed for the application automatically in Gatekeeper.

   Figure 140. New Business Partner application available on Infinite BrassRing Platform navigation bar

   

   Once the Full-page app has been added,

10. Provision (give license to) the users to have access to the application using the User Management process.

11. Follow the steps in the Manage Users, Add New User Process Steps section of this guide to add new users for the application.

    Once the User Management, Add New User function has been completed,

12. Cross check the application to make sure all the user provisioning requirements have been met. They will see the full-app in the app launcher

Creating a Full-page Application

Abstract

This section describes configuration steps for an Infinite Application Licensed Admin to create a Full-page Application for the current tenant.

The Create Full-page App feature allows users to create a Full-page App with the User Interface (UI) instead of uploading a .csv zip file using the “Upload apps & content function”.

The given fields allow users to adjust their settings just as they would using the .csv zip file upload method in “Upload apps & content”.

Table 68. Create Application Sections and Fields

To create a Full-page App,

1. From the Apps & Content page, select Full-page from the Add field dropdown list.

2. Select Create. This opens the Create Application page.

   Figure 144. Select Full-page app and select Create

   

   Figure 145. Create Application page

   

3. Enter the application ID in the ID field.

   Note

   This is the Identifier of the new application, which is required to be unique.

4. In the [Features] section, select the Render app in iframe checkbox. The Include Styles attribute checkbox then becomes visible.

   Note

   Features is the way the application is integrated within the Infinite BrassRing Platform (for example, the “Render app in iframe” which has an “Include Styles” attribute). The new application will have Infinite BrassRing Platform styles available, if chosen.

   Figure 146. Features section

   

5. In the Landing page field, enter the URL to be displayed after a user selects the application tile.

   To change the App icon image,

6. In the [App Icon] section, select Click to select or Select file and select and image to upload an icon image. The [Open] dialog window opens.

   Note

   The maximum image size 80px (height) x 20px (width). The format must be *.png.

   Figure 147. App Icon section - Select Click to select or Select file

   

   In the [Open] dialog window,

7. Navigate to and select the new image you wish to use to replace the existing icon.

8. Select Open. The new icon image now displays in the App Icon section.

9. Select Create to save changes or Cancel to exit without saving.

   In the [Features] section,

10. Select one or both of the following check boxes.

    1. Side navigation disabled

       (If selected, the application won't have a hamburger menu on the top left corner.)

    2. Image border disabled

       (If selected, the application will not have the space between browser window and the white page background (which shows that branding image).

    Figure 148. Features section

    

11. In the Translation field, select the language you want to use for the application from the dropdown list.

    Figure 149. Translation field

    

12. In the Title field, enter the Title for the application in the selected language (to be displayed in the [App launcher], and the [Apps and Content] list).

13. In the Description field, enter the description for the application in the selected language (to be displayed in the [Apps and Content] list).

14. Select Create to create a Full-page app or Cancel to exit without saving.

Activating an In-page App

Abstract

This section describes configuration steps for an Infinite Application Licensed Admin to add access to an In-page App for the current tenant.

On the Apps & Content page,

1. Select In-page from the Integration Type drop-down list.

2. Select Activate new license. This opens the Activate In-page App License page.

   Figure 150. Select In-page App and select Activate new license

   

   Figure 151. Activate In-page App License page

   

3. Select the Business Partner application from the In-page App dropdown list. The Activate In-page App License page re-displays with the Title and Description fields pre-populated and Placement Dashboard Spot options available to select.

   Figure 152. Activate In-page App License page, In-page App selection

   

4. To overwrite the default title and default description of an application for the current tenant, enter an application title in the Title field and a description in the Description field.

   Note

   Currently overwriting the Title and Description is supported for English only. The Title and Description will be displayed in the Apps & Content list.

   Scenario,

   If, and only if, a portlet based partner application requires additional values that are unique/specific to the Infinite BrassRing Platform Tenant the portlet application is being enabled to, there might be additional boxes to fill out.

   Note

   In this case, values MUST be entered into those fields.

   When and/if this happens, the partner application documentation must contain further help and/or guidance for filling those values in correctly.

   The following SampleUtcApiTestApp Application figure shows an example of one additional attribute for testing this concept.

   Figure 153. SampleUtcApiTestApp Application

   

5. Select one of the following Dashboard Spot option choices:

   • Dashboard Spot 1

   • Dashboard Spot 2

   • Dashboard Spot 3

   • Dashboard Spot 4

   • Disabled for all spots (This option will remove enablement for the selected application from the Home page view.)

   Figure 154. Activate In-page App License page, Select Dashboard Spot

   

6. Select Activate to activate the application or Cancel to exit out of the Activate, In-page App process.

   Note

   If more than one In-page App is available for selection, the user can select the additional In-page App from the In-page App dropdown list and make the applicable changes to that In-page App.

Placement of the Portlets

Abstract

This section describes the placement of portlets on the Home page as Spots.

Portlets are ordered in columns. The actual number of columns depends on the width of the screen (breakpoints) a minimum of 1 and a maximum of 4.

The placement of the portlets are as follows, assuming the user has access to the (LayoutPortlet) portlet which renders all 4 content spots.

Spot 1 → Spot 2 → Spot 3 → Spot 4

Note

The portlets will be placed either next to each other in one row, or 2/3 rows based on the user's browser page width.

Spot 1

Spot 2

Spot 3

Spot 4

Following are the four possible column variations with 4 content spots:

Figure 158. 1 Column

Figure 159. 2 Columns

Figure 160. 3 Columns

Figure 161. 4 Columns

How to Deactivate a Business Partner App License from the Tenant

Abstract

This section describes configuration steps for an Infinite Application Licensed Admin to Deactivate a Business Partner App License for the current tenant.

To Deactivate an application license from the client,

1. Navigate to the Apps & content landing page and select the link of the application you wish to delete from the list of applications.

2. Once on the application page, select Deactivate license to deactivate the license for that tenant. A message verification window opens with the prompt Are you sure you want to deactivate the license for the Full-page App Partner Home (<appname>)? Any customization will be permanently lost..

   Figure 162. Deactivate application license

   

   Figure 163. Deactivate App License? message

   

3. Select Deactivate license. The application license is then removed from the client.

   Important

   The application is not deactivated, only the license is deactivated.

4. Check the application list on the Apps & content landing page to verify it is no longer on the list and removed from the tenant.

Deleting In-page and Full-page Apps

Abstract

This section describes configuration steps for an Infinite Admin or Business Partner to Delete both In-page and Full-page Business Partner apps. Only the user who imported the application is allowed to the delete it.

The Delete app feature allows for the removal of unneeded In-page and Full-page Business Partner Apps. This feature can only be performed by the admin of the application and within the client that was used to create/upload the application. Upon deletion, the content of the deleted Business Partner apps will immediately be deleted from the Infinite BrassRing Platform environment; however, the definition of the application will still exist in Gatekeeper as DELETED_<appname>_<date>. The Gatekeeper team will periodically remove these application definitions in a later times.

Note

Deleted applications are no longer visible in the Infinite BrassRing Platform, and all client licenses are deactivated.

To delete an app,

1. Navigate to the Apps & content landing page and select the link of the application you wish to delete.

2. Once on the application page, select Delete app to delete the In-page or Full-page app. A message verification window opens with the prompt “Are you sure you want to permanently delete the Full-page App creating automated test (<appname>)? All customer licenses will be permanently deactivated.”.

3. Select Delete app to continue with deletion of the Business Partner In-page or Full-page app.

   Figure 164. Delete application

   

   Figure 165. Delete App? message