--- category: [Platform and Product Extensions/Workday Extend, Platform and Product Extensions, Administration & Integrations, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Integration] keyword: [Extend, App Builder, Model Components, Extend Business Objects, MCBO, Model Component Business Objects, Business Objects, Model BO] nav: wcp_docs parent_url: /wcp_docs/ title: Add Business Objects in Visual Mode layout: subsection --- ### Prerequisites Create or open a Workday Extend app in App Builder. ### Context Business objects: - Extend Workday’s single object model to create new objects. - Persist and store app data. ### Steps 1. In App Builder, click the Add button next to Business Objects in the components panel. 2. Provide a Name for the business object. The name must begin with an uppercase alphabetic character (A–Z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters. 3. Use the toggle switch in the upper right of the interface to ensure that App Builder is in Visual mode. 4. Use the Business Object tab to provide fundamental information about your component. As you complete this tab, consider:
Option Description
NameYou can edit the name you provided earlier.
Label(Optional) Provide a label that succinctly describes the nature of the business object.

If you specify a label, it must be unique for each model component type within an app.

If you don't specify a label, Workday displays the name in the tenant.

Default Collection NameProvide a name for Extend to use as an identifier for REST API resource to access all instances of the business object. Workday recommends that you use a pluralization of your object. Example: charities.
Default Collection LabelProvide a label for Extend to use as the unfiltered report data source for the business object. Workday recommends that you prefix the business object with All and then pluralize it. Example: All Charities.
Default Security DomainsSelect the default security domains that control access to the business object. Each business object requires at least 1 default security domain. You can only use the names of security domains defined in the same app.

5. The Fields tab displays the fields that you've created for your business object. As you add a new field, on the Properties and Security tabs, consider:
Option Description
NameProvide a name for the field. The name must begin with a lowercase alphabetic character (a–z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters.
LabelProvide a label that succinctly indicates the purpose of the field.
TypeSpecify of the type of data that the field contains. These types are available:
  • TEXT
  • RICH_TEXT
  • DECIMAL
  • BOOLEAN
  • INTEGER
  • DATE
  • CURRENCY
  • SINGLE_INSTANCE
Enable Reference IDApplies to text fields only. Enable this toggle to designate this field as the Reference ID of the business object. When you mark a field as the Reference ID, the field is required and you can't delete it. You can only configure this attribute once for each business object.
Enable as Display NameApplies to text and single instance fields only. Enable this toggle to use the contents of this field to set the display value of the business object. You can only configure this attribute once for each business object.
Enable for PurgeSpecify whether you want to enable your app to support the purging of the instance field data.
DecimalsApplies to decimal fields only. Specify the number of decimal places that the number uses. The allowed range is 1–5.

Note: Once your app has been promoted, you can only increase the number of decimal places. You can't decrease it.

PrecisionApplies to date fields only. Specify how precise the date is. These options are available:
  • Millisecond
  • Second
  • Minute
  • Hour
  • Day
  • Month
  • Year
Filter Targets/Relates ToApplies to single instance fields only. Select a target business object defined in the same app or a target Workday-delivered business object.
Enable Security by TargetApplies to single instance fields only. Enable this toggle to delegate contextual security to the instance of the target business object in addition to the security it applies to the Extend business object. You can only configure this attribute once for each business object.
Default Security DomainsThe default security domains that control access to the business object.
Security DomainsSpecify security domains to override the default security domains defined at the business object level. You can only use the names of security domains defined in the same app.

6. The Derived Fields tab displays the fields that you've created for your business object. As you add a new field, on the Properties and Security tabs, consider:
Option Description
NameProvide a name for the field. The name must begin with a lowercase alphabetic character (a–z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters.
LabelProvide a label that succinctly indicates the purpose of the field.
TypeSpecify of the type of data that the field contains. These types are available:
  • TEXT
  • DECIMAL
  • BOOLEAN
  • INTEGER
  • DATE

Note: Extend doesn't support the CURRENCY or SINGLE_INSTANCE field types for derived fields.

DecimalsApplies to decimal fields only. Specify the number of decimal places that the number uses. The allowed range is 1–5.

Note: Once your app has been promoted, you can only increase the number of decimal places. You can't decrease it.

DateApplies to date fields only. Specify how precise the date is. These options are available:
  • Millisecond
  • Second
  • Minute
  • Hour
  • Day
  • Month
  • Year
ExpressionEnter an expression to define the content in the field. See Reference: Derived Fields.
Default Security DomainsThe default security domains that control access to the business object.
Security DomainsSpecify security domains to override the default security domains defined at the business object level. You can only use the names of security domains defined in the same app.

7. The Relationships tab displays the 1-to-1 relationships between business objects, attachment objects, and Workday-delivered targets. Click Add Relationship to define the properties of a new relationship. Click an existing relationship to edit its properties. You can create relationships: - Between your app's business objects and attachment objects, in any direction. - From your app's business objects and attachment objects to Workday-delivered targets. ### Related Information [Reference: Limits on Model Components](/wcp_docs/GUID-7d78b63a-766a-449c-839c-f7080e7e67aa.html) [Reference: Business Object API Requests](/wcp_docs/xml1559763881756.html) [Reference: Model Component Attributes](/wcp_docs/hod1558556125085.html) [Reference: Targets for Referencing Workday Business Objects](/wcp_docs/qwm1559767719386.html) [Reference: Workday-Delivered vs. Workday Extend Business Objects](/wcp_docs/rze1614126465976.html) [Reference: Allowed Updates After Extend App Promotion](/wcp_docs/haf1635898070118.html)