Edit metadata

After creating your use case with an existing or new backing Project, you can modify the metadata that helps define your use case. This metadata can be found in your use case overview page and includes the use case name, description, owners, and status.

Example of use case metadata

Name

Change the name of your use case by clicking on the use case name at the top of the page and editing within the text field.

Rename use case name

Description

Change the description of your use case by clicking on the description at the top of the page and editing within the text field. As a builder, you can use this field to document the use case, describing its purpose and any relevant information that will help with maintenance over time.

You can also add a description to each application in the use case by clicking into the application page and editing the description field.

Edit use case description

Documentation

You can view and edit use case documentation using Markdown language. Expand the documentation section by selecting Show documentation > Edit.

View use case documentation

In the Markdown editor, use the Write tab to input or update the use case documentation, and the Preview tab to view your changes before saving them.

Edit use case documentation

To edit use case documentation, you must have case editor or owner role and edit rights on the project cover page as use case documentation is stored on the backing project cover page.

Owners

There are two types of owners that you can assign to your use case: Technical and Business. Both can be assigned to an individual user or a group.

Technical owner: The technical owner is generally the application builder who is developing the use case.
- The user who created the use case is the default technical owner of the use case.
Business owner: The business owner is typically a user who tracks workflow progress and financial details of a use case.
- There is no default user assigned as a business owner to your use case.

Use case with an assigned technical owner

To change the owners of your use case, hover over the name or empty field and select the pencil icon. This will open a search dropdown where you can scroll through or search for available users or groups.

Use case with both an assigned technical and business owner

Status

You can assign your use case a status related to its operation status:

Active: Published and operating within your Foundry instance.
Experimental: In-progress and not actively published.
Deprecated: No longer in operation.

To change the status of our use case from Experimental to Active, select the status dropdown, choose Active, then click Change status.

Use case statuses

If you change a use case status to Active while the use case has object types or action types in Experimental or Deprecated status, a warning sign will appear near the status dropdown and in the top left sidebar indicating a disparity between resource and use case statuses. We generally do not recommend creating this discrepancy.