Attributes

Overview

In this chapter, you will create attributes that can be configured from inside your tenant. Attributes allow your users to set variables without requiring direct access to your Extend app's code.

Objectives

By the end of this chapter, you will be able to:

Create an attribute in App Builder.

Configure an attribute value from your tenant.

Use an attribute value in a PMD file.

Attributes

Attributes let you configure app-level, tenant-specific variables that your Workday Extend app can access during runtime. You can use attribute values in the presentation and orchestration components of your app.

Creating an Attribute

You can add attributes from the App Components Panel in App Builder, or you can use the Console on the Extend Developer Site. App attributes are saved in App Hub.

To assign tenant-specific values to the attributes, use the App Manager report on the tenant. Each time you add or update app attributes on the Console, you must enable the attributes for update through App Manager.

By default, the attribute value applies to all tenant environments. You can also choose to assign different attribute values for each environment where the app is deployed.

Using Attributes

To reference a tenant-specific attribute value in your app, use the

attrstore

predefined variable. The

attrstore

variable contains all app-level attributes defined on the Console. An app attribute automatically resolves its value based on the environment the app runs in.

This example text widget assumes that you have created the

leadTester

attribute on the Console and that you have assigned a value in App Manager:

{
  "type": "text",
  "label": "Assigned lead tester in this environment",
  "value": "<% attrstore.leadTester %>"
}