Sample: Manage metadata field definitions

Use the Metadata Management sample to list and manage the metadata field definitions in your organization.

Note

To create, delete, and edit the field definitions of an organization, you need the Asset Manager Admin role at the organization level.

Before you start

Before you use the Metadata Management sample, make sure you have the following:

• An installed Assets package.
• An installed Identity package.
• A valid Unity ID account.
• Access to your Unity Gaming Services account.
• A Unity Project with the Asset Manager service enabled. Read more about creating a Unity project.
• Access to the Asset Manager service.

Note

Although the Assets package does not depend on the Identity service, the sample uses to control the authentication process.

Install the sample

To install the sample, follow these steps:

1. Open your application project in the Unity Editor.

2. Go to Window > Package Manager > Unity Cloud Assets.

3. Expand the Samples section.

4. Select Import next to Metadata Management.

   

5. After the import process completes, you can see the imported samples under the Assets/Samples/Unity Cloud Assets folder.

   

Run the sample

To run the sample, follow these steps:

1. Go to Assets/Samples/Unity Cloud Assets/<package-version>/Metadata Management/Scenes/MetadataManagementSample.unity and run the scene.

2. Select an organization. The left column displays the list of field definitions from that organization.

   

3. Select a field definition to display its information.

   

Create a new metadata field definition

To create a new field definition, follow these steps:

1. Next to the Field Definitions label, select the ellipsis button (…).

   

2. Select Create.

   

3. Enter a unique ID and a display name for the field definition.

4. Select the type of the field definition.

5. Optionally, enter the accepted values if you selected Selection as the type of the field definition.

6. Select Create.

Edit an existing metadata field definition

To edit an existing field definition, follow these steps:

1. Select an entry in the list.

2. Next to the display name, select the ellipsis button (…).

   

3. Select Edit.

   

4. Enter a new display name for the field.

5. If the field is of the Selection type, update the list of accepted values.

6. Select Update.

Delete an existing metadata field definition

To delete an existing collection, follow these steps:

1. Select an entry in the list.

2. Next to the display name, select the ellipsis button (…).

   

3. Select Delete.

Main components

This section describes the scripts that make up the main components of the Metadata Management sample.

Platform services script

The PlatformServices class handles the initialization and disposal of dependencies necessary for the IAssetRepository interface. Use this class to manage the Unity Cloud services and dependencies in your application.

To open the platform services script, go to your Assets/Samples/Unity Cloud Assets/<package-version>/Shared/Scripts/Services/PlatformServices.cs file.

Use the following classes with the PlatformServices class:

• PlatformServicesInitialization
• PlatformServicesShutdown

These classes use the following standard Unity Monobehaviour methods to run the initialization and shutdown methods:

• Awake()
• Start()
• OnDestroy()

Field definition controller script

To sign in to your application, use the FieldDefinitionController class. This class inherits from the OrganizationController class and uses your ID to grant access to the Collection Management sample. Read more about authentication. The FieldDefinitionController class uses the IOrganizationRepository of the PlatformServices class to retrieve the list of your organizations. The FieldDefinitionController class uses the IAssetRepository of the PlatformServices to retrieve the list of field definitions for the selected organization.

To open the field definition controller script, go to your Assets/Samples/Unity Cloud Assets/<package-version>/MetadataManagement/Scripts/Controllers/Field.cs file.

Metadata management sample script

The Metadata shows you how to do the following:

• Integrate the login flow with the FieldDefinitionController class.
• Retrieve organizations and field definitions from the Asset Manager service.

To open the metadata management sample script, go to your Assets/Samples/Unity Cloud Assets/<package-version>/MetadataManagement/Scripts/MetadataManagementSample.cs file.

Metadata field definition panel

The Metadata field definition panel includes the following components:

• The FieldDefinitionPanelController class displays the information of an IFieldDefinition interface.
• The CreateFieldDefinitionPopupController class displays the necessary fields to create a new field definition.

Shared UI scripts

The UI sample includes a set of UI scripts and prefabs that Unity Cloud Assets samples use. To open shared UI scripts, go to Assets/Samples/Unity Cloud Assets/<package-version>/Shared/Scripts/Controllers.

Troubleshooting

In case of issues with samples, refer to troubleshooting.