Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

This page provides a high-level overview of how to copy or delete your CommCare

...

applications(s).

...

Table of Contents
stylenone

Copy an Application

...

Copy an Application

...

You can make a copy of an existing application within the same project space or to a different project space. 1. To do this, access the application you would like to copy by clicking on the "Application" option on the ribbon menu, found

Permissions Required

We want to make sure that project spaces are protected in receiving copied applications only from approved users.

As such, to copy an application, you will need to have Web Users permissions to manage Apps (see below) in the project that you are copying the application to. If the project space that you are copying to uses locations, you will need to have Locations configured as well.

...

These can be selected either through the pre-existing Role Configurations or by setting up a new Role Configuration under “Add Role.”

Instructions

  • Click “Applications” at the top of the page.

...

  • Select the specific application

...

  • you would like to copy. 

...

    ...

    • In the upper lefthand corner, select the ⚙ gear icon to proceed to the Application Settings page.

    ...

    • Select the 'Actions' tab.

    ...

    • Fill in the following information

      • Copy this app to project*

    ...

      • : Type or select the project space you’d like to copy the application

    ...

      • . This can include your current project space. As a reminder, you will need to have Admin permissions in the project space you

    ...

      • are copying to.

    ...

    ...

      • Name*

    ...

      • : Give the Application a new default name before copying.

    ...

      • Copy Version: When copying an app, you can chose the version to be copied

    ...

      • . This can include teh most current version.

      • Copy as Linked Application: This will create an application that can be updated from changes to this application. This requires your app to have at least one released version.

    • Finally, click the Copy button. Clicking the button will bring you to the same/new project space, into the newly made copy of the application where you can proceed with building your application. 

    ...

    Copy an Application to a Different Server [Advanced]

    In some cases, users may want to copy an application between servers. This includes if you want to copy your application from the CommCare cloud platform to a locally hosted platform.

    Multiexcerpt include macro
    macro_uuid846f10d6-3459-462c-8ce9-b12bb0b90265
    nameTechnical Documentation
    templateDataeJyLjgUAARUAuQ==
    page[Internal] CommCare Public ManagementCommCare Help Site Design Guidance
    addpanelfalse
    If you need to transfer an application between servers (for example, if you are a developer running CommCare HQ locally, or have a second instance of CommCare HQ running elsewhere):

    Expand
    titleClick to expand for full instructions
    1. On the server containing the app you want to copy, go to the URL: http://[SERVER ADDRESS]/a/[PROJECT NAME]/apps/source/<APP_ID>.  For example: https://www.commcarehq.org/a/demo/apps/source/071abeb39a1039df30613c494caa9bc3

    2. You should see a block of JSON-formatted text. Right click to save this page as a file with .json extension.

    3. On the new server, go to the following URL http://[SERVER ADDRESS]/a/[PROJECT NAME]/apps/import_app/.

    4. Add an application name, and upload the app json file downloaded above.

    5. Click Import Application.

    Image Modified

    ...

    Important to Note:

    • This will not copy users and groups.

    • This will not copy organization structure or levels.

    • This will not copy user fields. 

    • This will not copy lookup tables (aka fixtures).

    • This will not copy multimedia from the app. Use the bulk multimedia download/upload to move multimedia.

    • This will not copy feature flags, although it will copy over any feature-flagged content in the application (e.g., advanced modules), which may behave unexpectedly if the domain being copied to does not have the correct flags enabled.

    Delete an Application

    You can delete an existing application if you do not need it anymore.

    1. To do this, access Access the application you would like to delete by clicking on the "Application" option on the ribbon menu, found at the top of the page, and then click on the specific application name. 

    ...

    4. Immediately after deleting, you will be returned to the current project space's dashboard. At the top of the screen, there will be a notification that you successfully deleted the application with an option to 'Undo'.

    ...