The application editor lets you edit a custom application after it’s installed. You can rename the application, change its capabilities, and add, change, duplicate, or delete its object types. Your changes save together as one new version of the application’s configuration package.

Prerequisites

  • Only administrators can open the editor.
  • The editor opens only applications created with the New application configuration steps. Marketplace applications, their extensions, and applications built from package JSON can’t be edited here.
Warning

Your work stays in the browser tab until you finish; nothing is stored on the server before that. Leaving the page asks Discard this wizard?, while reloading or closing the tab triggers the browser’s own warning instead. Either one discards your work.

Open the application editor

Open the application editor from:

  • The application’s overview page: On the header, click Edit application.
  • The package list: Go to Settings > Packages > Resources. Open the actions menu of the application’s package and select Edit in wizard.

Edit your application

The editor uses the same four steps as New application: Application details, Object types, Capabilities, and Review & save. Application details and Capabilities work exactly as described there.

  • Object types: Select an object type to change any of its seven tabs (see New object type for what each sets). Add one with + Add object type, or Duplicate an existing one; duplicating works the same way as in New application. When you edit a saved object type, features the editor doesn’t offer stay as they are. See Delete or restore an object type for removing one.

On the Object types step, the list on the left marks each type:

MarkerWhat it means
(none)A saved object type without changes.
ChangedA saved object type with unsaved changes.
NewAn object type that isn’t saved yet.
Will be removedA saved object type marked for deletion. The row is struck through.

Select a row to open its tabs on the right.

Change or remove an icon

The application and every object type share the same Icon field, with the same upload rules as in Upload a custom icon. Changes stay local to the editor until you save: a new upload doesn’t overwrite the previous icon, and removing the icon falls back to the default.

Delete or restore an object type

  1. Select the object type and click Delete, then confirm Delete ‹name›?. The object type is marked Will be removed; a banner confirms nothing is deleted until you save.
  2. To keep the object type after all, click Restore in the banner.

A new object type that isn’t saved yet is removed immediately after you confirm Remove ‹name›?. Click Undo in the toast to bring it back.

Danger

Saving a deletion also deletes its objects, and you can’t undo it from the editor. The review step shows how many are affected and asks you to confirm before saving.

Review and save your changes

  1. Go to the Review & save step.
  2. Check the changes:
    • Application definition shows “No changes”, or “Changed:” followed by the changed fields.
    • Object types groups the object types into New, Changed (with the areas that changed), and To delete. Without object type changes, it shows “No object type changes”.
    • References removed with a removed object type lists references that disappeared with a removed new object type.
  3. Click Save changes. When the changes delete data, the Save and delete data? dialog repeats the affected counts first; click Save and delete to continue, or Cancel to go back.

If the editor finds problems, each one lists with a Fix link that opens the object type and tab to fix; an object type whose page would be empty links to its Attributes tab, and a missing translation is reported the same way.

Save changes stays unavailable in three cases:

  • Problems remain in the list.
  • You haven’t changed anything.
  • Your edits match the saved version.

Changes that delete data

When saving would delete or detach existing data, a red banner titled These changes delete data lists every effect.

Line in the bannerWhat causes it
”‹type›: ‹n› objects will be deleted”You deleted an object type that has objects.
”‹type› › ‹attribute›: ‹n› values will be lost”You removed an attribute that objects of that type have filled in.
”‹type›: ‹n› objects sit under a parent that is no longer allowed”You changed where the object type can be placed, and existing objects sit under a parent type that is no longer allowed.
”‹type› › ‹relation›: ‹n› relations will be removed”You removed a relation or a related object type that existing objects use.

After you save

The review screen shows “Saving ‹name›…” while Dawiso installs the new version. A clean install opens the application automatically; with warnings, you see “‹name› was saved.” and the warnings, with an Open application button. The other states reuse the same actions as New application, except that a failed installation also offers Run the installation again, which retries the same draft version without losing your changes. Back to editing keeps your changes too, so you can fix them and save again.

When someone else changed the application

Saving shows a conflict dialog when another version was saved while you were editing, or when the package has a draft version that’s still installing or was created in Settings > Packages and never installed. A draft whose installation failed doesn’t trigger this, since saving replaces it.

  • Click Reload to load the latest version. Your unsaved changes are discarded.
  • Click Cancel to close the dialog and return to the application definition.

Limitations

Locked once installed

  • Value type of an installed attribute: It’s locked, with a lock icon and the message “The value type can’t be changed once the attribute exists — the values objects already hold would no longer fit it.” To change it, remove the attribute and add a new one.
  • Installed relations: The object type at the other end is locked, and an installed relation can’t be swapped for another relation type. Its names stay editable. Deselecting or removing an installed relation asks first, because objects lose the relations of this kind they already have. If the object type at the other end was deleted from its own application, the Relations tab shows the target as “Removed object type” until you remove the relation.

Structural limits

  • Object type order: The editor keeps object types in their saved order and can’t reorder them.
  • The application itself: The editor can’t delete the application.
  • Package name: Renaming the application changes its name in Dawiso, but the package in Settings > Packages > Resources keeps its original name.

Troubleshooting

Instead of the editor, you see “This application can’t be edited in the wizard” and the Open Settings › Packages button. The message names one of these reasons:

Reason shownWhat it means
”Its package wasn’t created by the application wizard.”The application was built another way, so the editor can’t rebuild it.
”Its package has a draft version that is still being installed or is waiting in Settings › Packages. Wait for the installation to finish, or install or discard the draft in Settings › Packages, then reload this page.”A draft version of the package is still being installed, or someone created a draft in Settings > Packages that was never installed. Discard the draft if you no longer need it. A draft whose installation failed doesn’t block the editor.
”Its package was changed outside the wizard, so the wizard can’t rebuild it safely.”The package was edited after New application created it. The editor doesn’t open it, so it can’t overwrite those changes.
”Its package refers to an icon, colour or type that no longer exists.”Something the application uses, such as an icon or an attribute type, was deleted.
”Its package has never been installed.”The package has no installed version yet.