Exporting and importing from a ZAPP file

Edit online

What is a ZAPP file?

A ZAPP file is a .yaml or .json file that specifies options for a Z APPlication (ZAPP) development environment. ZAPP files have several uses and functions, one of which is to define property group options in an IBM® Developer for z/OS® or IBM Developer for z/OS on VS Code development environment. For a full description of ZAPP files and how to define property group options in them, see Configure your applications with ZAPP files in the IBM Developer for z/OS on VS Code documentation.

Before Developer for z/OS can make use of the options in a ZAPP file, it must import them into a property group. The import operation occurs automatically when you load a z/OS project that contains a ZAPP file into the workspace. You can also export property groups into ZAPP files. This topic explains how the product imports ZAPP files, and how to export property groups to ZAPP files.

Note:
If you attempt to edit the ZAPP file and encounter any issues with the Eclipse YAML editor, you can open a bug report at https://github.com/eclipse-wildwebdeveloper/wildwebdeveloper.

How ZAPP files are imported into the workspace

A ZAPP file that is in a local or remote z/OS project generates a property group automatically. A common use case illustrates this process:

  1. Add a Git repository that contains a ZAPP file to the Git Repositories view. For instructions, see Adding a Repository.
  2. Use the Create a z/OS Project menu action to add the repository to the z/OS Projects view. For instructions, see Creating a z/OS project from a Git repository.
    Important: The project must have only one ZAPP file in the root folder of the project.
  3. A read-only local property group is generated and added to the Property Group Manager.
A property group imported from a ZAPP file

Exporting to a ZAPP file

  1. In the Property Group Manager, right-click a local or remote property group and select Generate ZAPP.
    Generate ZAPP file from Property Groups window
  2. In the Generate ZAPP file from Property Groups window, click Browse to navigate to a project to save the ZAPP file in. Select the project that you want to apply the property group options to.
  3. From the file extension list, choose .yaml or .json. The file name must be zapp and cannot be altered.
  4. Click OK. The ZAPP file is generated and added to the project. The product also generates a copy of the property group and adds it to the Property Group Manager.
    z/OS Projects view with a generated ZAPP file and Property Group Manager with a read-only property group
    Tip: In the generated property group, all fields that were populated from the ZAPP file are read-only. If you need to update any of the read-only fields, you must update them in the ZAPP file. The product keeps the ZAPP file and the generated property group in sync.All other property group options can be changed in the property group editor.