Dynamics 365定制:在实体的列表界面添加按钮

2021-07-24 更新：2021-07-24

先上效果图

将实体 Order 添加到我专门用来定制的解决方案 RibbonEditor，只需要添加实体的元数据即可，不需要添加所有资产，也就是保持【Include entity metadata】选中，而取消选中【Add All Assets】. 点击【Finish】按钮。

首先下载开发工具 [RIBBON WORKBENCH](Develop 1 Ltd | Ribbon Workbench for Dynamics 365 & Dynamics CRM). 下载后是一个解决方案的压缩包。然后我们将这个解决方案导入到我们的CRM中。导入后如下图

打开后会提示导入解决方案，所以操作前需要提前准备好解决方案。

选择后导入

拖动 Toolbox 中的 Button 到需要显示按钮的地方
在 COMMANDS 后面点加号，新增命令
1. 点击 Add Action 选中 JavaScript Action
2. 指定 Libary及 Function Name
填写按钮描述信息
自定义按钮图标【ModernImage的属性，而这个属性需要添加类型为svg的图片】
点击 Publish 按钮发布

notice

记得一定要点击新增按钮，设置其Command属性，否则按钮不会显示

无参命令

有参命令

https://docs.microsoft.com/en-us/powerapps/developer/model-driven-apps/pass-data-page-parameter-ribbon-actions

测试权限

通过为按钮添加命令，再为命令添加规则，控制按钮是否显示。

通过JS控制按钮是否显示，这里一般通过查询用户角色

sfdhl_sample_hello.js

//console.log('hello.js');

// 控制权限按钮是否显示
function px() {
    const publisher = Xrm.Page.getAttribute("sfdhl_publisher").getValue();
    return '人民邮电出版社' === publisher;
}

// 列表页面按钮
function hello() {
    alert('click btn1');
}

function welcome(formContext) {

    console.log(formContext);

    var bookName = formContext.getAttribute("sfdhl_name").getValue();
   
    Xrm.Navigation.openAlertDialog({ text: `${bookName}` });

    // 修改页面值
    formContext.getAttribute("sfdhl_description").setValue("https://www.contoso.com");


    //dialog();
    //contextInfo();
    //pageData();
    control();
    format();
}

function format() {
    const x = Xrm.Page.getAttribute('sfdhl_publication_time').getFormat();
    console.error(x);
}

function control() {
    // 禁用字段
    Xrm.Page.getControl("sfdhl_name").setDisabled(true);
    Xrm.Page.getControl("sfdhl_publisher").setDisabled(true);
}

function pageData() {
    const entity = Xrm.Page.data.entity;

    // 所有页面元素
    console.error(entity.attributes);
    console.error(entity.getEntityName);

    //console.error(entity.getEntitySetName);
    console.error(entity.getId());
}

function contextInfo() {
    const pageContext = Xrm.Page.context;
    console.error(pageContext.getUserId());
    console.error(pageContext.getUserName());
    //Array
    console.error(pageContext.getUserRoles());
    //console.log(pageContext.getUser());
    console.error(pageContext.getClientUrl());

    // 获取用户当前语言代码
    console.error(pageContext.getUserLcid());
}

function dialog() {
    //var alertStrings = { confirmButtonLabel: "Yes", text: "操作成功!", title: "提示" };
    //var alertOptions = { height: 120, width: 260 };
    //Xrm.Navigation.openAlertDialog(alertStrings, alertOptions);

    Xrm.Navigation.openErrorDialog({ message: "操作失败！"})
}

|阅读量()