Child pages
  • Launchpad - Administrator Guide 2.0
Skip to end of metadata
Go to start of metadata


Launchpad - Access your external tools

Create your own set of apps to access external systems from within your intranet

See the documentation for your Release

Table of Contents

Confluence compatibility

Plugin5.75.85.95.106.0...6.126.136.14Data Center
Release 2.0(error)(error)(error)(tick)(tick)...(tick)(tick)(tick)(tick)
Release 1.6(error)(error)(error)(tick)(tick)...(error)(error)(error)(tick)
Release 1.5(error)(error)(error)(tick)(tick)...(error)(error)(error)(tick)

Admin Configuration

Within the General Configuration of Confluence please locate the section "Launchpad"


The administration view offers two views

Configuration
SettingsConfigure general settings

App Label

Manage app labels

Categories

Manage app categories

App Management

Including 3 tabs with further settings

AppsCreate, edit and remove apps
Suggested appsPublish suggested apps

Manage Apps

This view lists all the apps that have previously been defined. This is the place to add, edit or remove apps.

Above and below the table

 

Select all

Selects all apps for bulk edit view.

Edit

Opens the bulk edit view for the selected apps. The button is disabled if no app is selected.

Create new App

Opens the create new app view.

Table

Bulk editIf checked, the app will be taken for bulk edit action.
IconThe icon of the app
TitleA short name to identify the app, shown to the user.
LinkThe URL where the external app is located. This can be any external or internal link. At this point, local applications cannot be linked, though.
CategoriesEach app can be assigned to one or more categories. Especially useful if you offer a large number of apps.
App LabelEach app can be assigned to one or more labels. Especially useful if you offer a large number of apps.
recommendedA tick icon shows if the app is marked as a recommended app for some or all users.
mandatoryA tick icon shows if the app is marked as a mandatory app for some or all users.
Visibility RestrictedA tick icon shows if the app is marked to be only visible if the user profile matches a custom criteria (the column is only visible if at least one app has a restricted visibility)
ActionsClick these icons to edit or delete an app. Once deleted, the app cannot be restored. You'll have to add it again.

 

 

Defining categories for apps

 

Switch to "Launchpad Configuration" and select the tab "Categories" to define as many categories as you need for sorting your apps. The more apps you offer, the more categories you should define to make it easier for users to find what's important for them.

To delete a category, simply click the trashcan icon. A deleted category cannot be restored and has to be added again, if you deleted it by mistake.

You may also define sub categories, this let's you sort your apps even better!

Defining labels for apps

 

Switch to the tab "App Label" to define as many labels as you need for labeling your apps. Labels can be used to show special use cases for apps (e.g. "mobile"). One label can be displayed on the app tile.

To delete a label, simply click the trashcan icon. A deleted label cannot be restored and has to be added again, if you deleted it by mistake.

Additional Settings

 

Display Settings



Link to LaunchpadIf your theme shows the standard Confluence application header, you'll find a new item "Launchpad" there. But maybe you already placed a list of apps or the users' favorite apps as macro on your dashboard or have other reasons for not wanting this link to show up there. In this case you'll find a checkbox on the "Settings" tab. Simply uncheck it, and the item inside the application header is gone.
Suggest AppLet your users suggest apps and configure which admins should be notified about it in order to check and publish the suggested app.
App detailsIf you want new apps to be highlighted in principle in the Launchpad check the "mark as new" checkbox. You can decide per app if you want to use this feature.

You may add a custom attribute to your app to provide further information.

Configuration for profile based content

See Personalizing apps

 


Create / Edit Apps

 

App Details

URLThe URL where the external app is located. This can be any external or internal link. At this point, local applications cannot be linked, though.
TitleThe displayed title of your app.
Short descriptionA short description to provide further information for your app
Custom FieldThe given custom field (in this case "Abteilung")
Tile PictureThe image icon of your app.
LabelsEach app can be assigned to one or more categories. Especially useful if you offer a large number of apps.
One of the Label can be displayed for users in the app view, just select on label by clicking on it.
ContactAn optional information to tell users who to contact, if they have questions or problems with the app.
CategoryEach app can be assigned to one or more categories. Especially useful if you offer a large number of apps.

Visibility

"Recommended app" settingsA tick icon shows if the app is marked as a recommended app for some or all users.
"Mandatory app" settingsA tick icon shows if the app is marked as a mandatory app for some or all users.
"Visibility" settingsA tick icon shows if the app is marked to be only visible if the user profile matches a custom criteria (the column is only visible if at least one app has a restricted visibility)
Mark as newIf checked users will get a notification about the app and it will be display in the "new apps" section in the Launchpad Portal


Bulk edit apps

You are able to select several apps in the overview and change them all at once.

  1. Select the to be edited apps
  2. Click the edit button on top or bottom of the table

After clicking the edit button, the bulk edit view appears.

On top there's a list of the selected apps. By clicking "Change selection" you can change them.
(warning) When clicking the "Change selection" button, your values filled in bulk edit view will be lost

You can set the values like you do for a single app. Some fields (like "Title" and "Link") are hidden.

Every input has a further checkbox on the left.
(warning) The values are only set for the selected apps, if the checkbox is checked.

If all apps share the same value for a field, it will be pre-filled with this value.


Personalizing apps (only available with the Linchpin Manager Plugin)

You may define mandatory and recommended apps, as well as configuring visibility of apps according to profile values.

Especially if you have a large number of users and apps, it's common that not all apps are equally important for every user. That's why we added the possibility to define recommend and mandatory apps, as well as general visibility only to certain users, based on their profile information. The first step to do this is to define, which profile fields are relevant. You can define up to three fields.

In a second step you define for each app, in which cases it should be shown as a recommended, mandatory app or if this app should only be visible for specific users. If you haven't configured any profile fields or leave them empty, the app will be recommended, mandatory or visible for every user.

In our example, all users who are member of the department "Marketing" will automatically have this app added to their "myApps" section (Mandatory app). Besides this, the app itself will be only visible if you are working in this or the financial department. Other users cannot see this app at the Launchpad.

You can use wildcards and logical operators for more complex filtering arguments. Please refer to the page Useful admin information for more information.

 

 

Translate apps (only available with the Linchpin Manager Plugin)

You can add a translation for each app and its app title, URL and description. 

If you have a valid Linchpin Manager license, the single app configuration gives you the opportunity to translate certain app details (title, description, URL). Based on an user's locale, the app will be shown in the matching language, if a translation is available. If not, the default data will be used.

Open local applications (only available with IE) 

(lightbulb) This is not an official Launchpad feature. We do not support any changes within the Windows registry! Changes are done at own risk!

It is possible to open locale applications when using the Internet Explorer.

You have to create a registry file with the shown structure (in this case it's a MS Word example).

  1. Open a text editor, e.g. Notepad ++
  2. Insert the strcuture as shown above (remember to change "MS Word", "ms-word" and the URL depending on your application)
  3. Save as a registry file (".reg")
  4. Open file (you should receive a notification, that the registry has been changed)
  5. For testing: Open IE and enter e.g. ms-word://
    → Application opens
  6. Create or Edit Launchpad App and insert e.g. ms-word:// as URL

Remove Completely

To remove all plugin data you have to execute the following SQL commands after uninstall (written for PSQL)

DROP TABLE "AO_2D0959_USER_BOOKMARK";
DROP TABLE "AO_2D0959_APP_TO_APP_LABEL";
DROP TABLE "AO_2D0959_USER_APP_ORDER";
DROP TABLE "AO_2D0959_APP_CATEGORY";
DROP TABLE "AO_2D0959_APP_LABEL";
DROP TABLE "AO_2D0959_CATEGORY";
DROP TABLE "AO_2D0959_FILTER_ENTITY";
DROP TABLE "AO_2D0959_APP";
DELETE FROM bandana WHERE bandanacontext LIKE 'net.seibertmedia.confluence.appcenter%';
DELETE FROM bandana WHERE bandanakey LIKE 'net.seibertmedia.confluence.appcenter%';
DELETE FROM bandana WHERE bandanakey = 'AO_2D0959_#';

(question) Furthermore you might have a look at this article from Atlassian How to reset all Confluence plugins back to their default state through the database

Problems with PostgreSQL

We noticed problems on installation with some upgrade tasks. If you are facing errors using the app after an update to 2.0 please try set a dark feature that might fix this.

To do so, follow these instructions

  • open "<BASE_URL>/admin/darkfeatures.action"
  • add the following key: "linchpin-launchpad.psql-fix-disabled"
  • re-install the app
  • No labels