纷享销客开发者手册 纷享销客开发者手册
  • 自定义 APL 代码
  • 自定义 PWC 代码
  • 自定义组件(PC端)
  • 自定义组件(小程序)
  • 自定义插件(PC端)
  • 自定义插件(小程序)
  • 第三方集成插件(H5)
  • API(PC端)
  • API(小程序)
  • Fx DevTools
更新日志
  • 自定义组件(PC端)
  • 自定义组件(小程序)
  • 自定义插件(PC端)
  • 自定义插件(小程序)
  • 第三方集成插件(H5)
  • API(PC端)
  • API(小程序)
  • Fx DevTools
更新日志
  • 业务对象数据操作

    • fetch_describe
    • fetch_data
    • fetch_email_templates
    • fill_email_template
    • format_field_value
    • 业务对象界面操作

    • 媒体操作

    • 应用操作

    • 组织架构

    • 租户自定义

    • 辅助

    • 使用第三方库

    目录

    formatfieldvalue

    # FxUI.objectApi.format_field_value(fieldDescribe, value, fullValue)

    # 功能描述

    该方法允许您将某种类型字段的值解析成可读的内容。

    # 参数

    参数 说明 类型 可选值 默认值
    fieldDescribe 字段的描述信息(必填) Object — —
    value 字段对应的值 * — —
    fullValue 字段对应的所有值 string — —

    # value 和 fullValue

    假设有一个apiName为field_lookup__c的字段,该字段的类型为 object_reference。

    该字段的数据存储为:

    var fieldData = {
        field_lookup__c: '5f2bb8364e6e300001824a37',
        field_lookup__c__r: 'lookup对象的名称'
    }
    

    我们不难发现,这个字段的存储涉及两个参数,有的字段甚至涉及3个参数。对于该api而言,fieldData.field_lookup__c 就是 value,fieldData 就是 fullValue。

    后面的用法会展示一个完整的示例。

    # 代码示例

    const field = {
        api_name: 'field_lookup__c',
        type: object_reference,
        label: '关联客户',
        ...
    }
    const data = {
        field_lookup__c: '5f2bb8364e6e300001824a37',
        field_lookup__c__r: '某某公司'
    }
    const value = FxUI.objectApi.format_field_value(field, data[field.field_lookup__c], data);
    
    console.log(value); // 某某公司
    

    # 使用技巧

    大多数情况下,我们无法判别该字段存储的参数到底有几个,不如我们直接把获取到的所有data作为fullValue传入api中,例如:

    const field = {
        api_name: 'field_lookup__c',
        type: object_reference,
        label: '关联客户',
        ...
    }
    const data = {
        field_lookup__c: '5f2bb8364e6e300001824a37',
        field_lookup__c__r: '某某公司',
    
        //以下为其他字段的值
        name: '离开家的撒',
        _id: '23zd323asdf33333asddx2333s3',
        field1__c: '233',
        field1__c: '233',
        field1__c: '233',
        ...
    }
    const value = FxUI.objectApi.format_field_value(field, data[field.field_lookup__c], data);
    
    console.log(value); // 某某公司
    
    fill_email_template
    addObject

    ← fill_email_template addObject→

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式