Manage Apps
Create new apps
New apps can be created through one of the following three modes:
-
Default app
-
Use app template
-
Upload app
Default app
Select Default App to create a new app with the most commonly used features. Contents and further functions can be added to the app afterwards. For more information, see configuration of apps.
The template for the default app is located in map.apps data directory (default-app-4.zip).
The app can be modified there or replaced by other apps so that they are used as default apps.
|
Publish apps
Apps can have various states:
-
Draft
-
Edited
-
Verified
-
Published
-
Deprecated
Users can only view and start published apps. Administrators and editors have access to all apps.
If map.apps is used in combination with map.apps User Management , security.manager or ArcGIS Online/Portal for ArcGIS, access to released apps can be restricted to certain roles. As a result, the app is only visible in the app overview after prior registration (in addition to the freely available apps).
Follow these steps to protect an app:
-
Open the app publication dialog and set the app’s state to published:
-
Step forward to the sharing screen and check the roles the app is usable for:
-
Complete the dialog and save the app.
The app is now protected and invisible for non-authenticated users. Users can click Login in the app overview to sign in. After authentication, all public (non-protected) apps and all apps accessible for the user are shown. Protected apps can be launched directly, because the user is already logged in.
When opening an app directly with the app’s URL, a login dialog is shown. After a successful verification, the app is started.
To display user information as well as the logout-button inside the app, you have to add the bundle authentication to the app configuration.
|
Role-based Authorization
Due to security reasons, an administrator/editor can only authorize apps for roles he owns himself.
|
Delete apps
An administrator or editor can delete apps in map.apps Manager. These apps are removed from the database and cannot be restored. Set an app to the "Deprecated" state to make it no longer accessible without deleting it.
| If an app is registered as an element in ArcGIS Online/Portal for ArcGIS, this element is removed when the app is deleted. |
Export apps
Apps can be exported as a zip file. In this file, all data of the app (including for example images or CSS files) is stored. Export an app to upload it as an app template, archive it or share it with others.
Registration of apps in ArcGIS Online or Portal for ArcGIS
Using map.apps Manager, an app can be registered as portal item. Title, description and preview image are copied from the app metadata to the portal item. The map.apps dialog contains a link to the corresponding portal element. The used portal instance can be defined in the configuration.
When creating a portal element, a login to the portal is necessary. This step is not necessary if map.apps is connected to the user management of the portal (see Integrated Named User Login). Portal authentication can also be activated in the dialog. This means that users must log in using their portal identity when starting the app.
The status of the portal registration is represented by the following symbols in map.apps Manager:
App is not registered |
no symbol |
App is registered as Portal Item |
|
App is registered as Portal Item, portal user management is active (OAuth) |
|
| The appearance in the app overview does not update if the registration is removed in the manual configuration or the element is removed directly in ArcGIS Online or Portal for ArcGIS. Open the Portal Registration dialog to update the status. |
Setting bundle versions for apps
Bundles used in an app must be used in compatible versions. Make sure that all product bundles correspond to either line 3 or line 4.
The "Manage product version in selected apps" tool lets you change the versions of all bundles used for a product (such as map.apps or a product extension) at the same time. To do this, you must first select the product and the corresponding version.
In addition to selecting the minimum version, one of the following update guidelines can be selected:
| Choice | Description |
|---|---|
No updates |
The app is only compatible with the exact version specified. |
Bugfixes |
The app is compatible with all bugfix versions starting with the defined version. |
Minor Updates |
The app is compatible with all minor versions from the defined version onwards. |
|
Manual definition of bundle versions
The versions of bundles used can also be defined in the Manual Configuration.
The bundle name must be separated from the version by a The map.apps system is configured independently of the versions of individual bundles.
This is defined in the app.json
|
Export for native app
The Export for native app tool lets you export any app, including all resources, as a zip file. The app configuration and the bundles used in the app are analyzed and made available for download. Compared to the Export App tool, these results can be used as a basis for creating a native app.
To export all required JavaScript files, the tool integrates all AMD modules of the configured bundles.
If an app uses its own bundles, it must be ensured that these have been optimized and that a dependencies.json file exists.
Use the appropriate input field to add further modules or files.
Use absolute URLs in an app, because the use of protocol-relative URLs like //www.example.com in native apps can lead to problems.
JavaScript files are sometimes loaded during the runtime of an app.
When exporting in map.apps Manager, these are not determined in advance and are therefore not integrated into the zip file.
The missing files can either be added manually in the expert settings or loaded in separate bundles.
If the bundles map-preload-2D and map-preload-3D are added to the app, the files are already loaded at the start of the app and also integrated into the zip file during export.