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

语法: 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); // 某某公司