PCF SmartButton Control

Overview

The PCF SmartButton control provides dynamic, configurable buttons based on Dataverse settings. This control allows you to create flexible, context-aware buttons that can be used for custom actions and navigation in your Power Apps forms.

Features

The PCF SmartButton control includes the following features:

Installation

Prerequisites

• A Power Platform environment with Dataverse
• Solution Import permissions

Install steps

1. Download the solution from the releases page.
2. Choose the appropriate solution package:
   • Managed Solution: For production environments (recommended)
   • Unmanaged Solution: For development environments
3. Import the Solution into your environment.

Configuration

Button Configuration Table

After installation, create records in the Button Configuration table with the following fields:

Dynamic Values and Tokens

All text fields (Label, Tooltip, URL, Visibility Expression, and Action Script) support dynamic tokens:

Configuration Examples

Basic Navigation Button

To create a simple button that navigates to a website:

Name: View Website
Table Name: contact
Button Label: Visit Website
Button Tooltip: Go to {websiteurl}
Button Position: 1
Button Icon: Globe
Visibility Expression: {websiteurl}
URL: {websiteurl}
Show as: Button

Action Button with Custom Script

To create a button that executes JavaScript:

Name: Create Related Case
Table Name: account
Button Label: Create Case
Button Icon: Add
Button Position: 2
Visibility Expression: true
Action Script:
var entityFormOptions = { entityName: "incident", formId: "your-form-id" }; entityFormOptions["formParameters"] = { "customerid": "{accountid}" }; Xrm.Navigation.openForm(entityFormOptions);
Show as: Button

Advanced Usage

Filtering Buttons by Control

To display buttons only on specific control instances:

1. Add the SmartButton control to your form.
2. Open the control properties.
3. Set a filter expression in the "Button Configuration Filter" property (e.g., contains(theia_name,'Control 2')).

This ensures that only buttons matching the filter will appear on that specific control instance.

Visibility Expressions

Use JavaScript expressions to determine when a button should be visible:

Action Scripts

Examples of common action script scenarios:

var accountid = "{accountid}";
var name = "{name}";
// Open a record
Xrm.Navigation.openForm({entityName: "account", entityId: accountid});

// Show a notification
Xrm.App.addGlobalNotification({
  type: 1, // INFO
  message: "Processing "+name+"...",
  level: 1
});

// Retrieve related record data
var id = "{parentcustomerid.id}";
const parentcustomer = await Xrm.WebApi.retrieveRecord("account", id);

Troubleshooting

Common Issues

Related topics

• Power Apps Component Framework Overview
• PCF SmartButton GitHub Repository
• Fluent UI Icons Reference