salesforce开发之 文件系统浅析

2022-08-03 22:42:54 浏览数 (1)

序号

内容

一

对象结构、关系

二

Classic的附件、Lighting的附件

三

外部系统与SF文件系统的交互

一．对象结构，关系

Salesforce的文件系统依赖于对象，每个对象的每一条记录下都可以关联若干个附件，主要由通过三个标准对象组成sfdc附件系统：

ContentVersion

ContentDocument

ContentDocumentLink

ContentVersion：

使用 ContentVersion 对象用于创建、查询、更新salesforce文件或 Salesforce 文件的特定版本。

字段

描述

ContentLocation

文档的来源。有效值为： S 文档位于 Salesforce 中。标签是Salesforce。(常用) E 文档位于 Salesforce 之外。标签是外部。 L 文档位于社交网络上，可通过社交客户服务访问。

PathOnClient

文档的完整路径(客户端路径)。指定包含路径扩展名的完整路径，以便文档在“预览”选项卡中可见。

Title

文件名

VersionData

可以包括格式正确的 HTML 或纯文本。当通过接口方式上传或下载文档时，它应该是 base64 编码（EncodingUtil.base64Decode）或解码（EncodingUtil.base64Encode）。内容字段中纯文本中的任何特殊字符都必须进行转义。转义特殊字符content.escapeHtml4()

ContentDocumentId

Lookup字段存放ContentDocument的ID。若未设置则自动生成。

开发文档ContentVersion

ContentDocument：

ContentVersion的父对象，使用ContentDocument对象用于检索、查询、更新和删除库或 Salesforce 文件中文档的最新版本

开发文档ContentDocument

ContentDocumentLink：

用于与对象与ContentDocument的关联。

字段

描述

ContentDocumentId

Lookup字段存放ContentDocument的ID。

LinkedEntityId

Lookup字段存放主对象的ID。

ShareType

必需。授予库中共享文件的用户的权限。这是由用户在库中已有的权限决定的。 V：用户可以显式查看但不能编辑文件。 C：用户可以显式查看和编辑文件。 I：用户的权限由相关记录决定。

Visibility

AllUsers：该文件可供所有有权查看该文件的用户使用。 InternalUsers： 该文件仅供有权查看该文件的内部用户使用。 SharedUsers：仅用于与用户共享的文件，并且仅当组织默认启用了私有组织范围共享时才可用。

二．clssic的附件、Lighting的附件

VF:

代码语言：javascript复制
<apex:page controller="FileUploadController" showHeader="false" sidebar="false" >
 <apex:form >
 <apex:pagemessages />
 <apex:pageBlock >
 <apex:pageBlockSection columns="4">
 <apex:inputFile value="{!csvFileBody}" filename="{!csvAsString}"/>
 <apex:commandButton value="Import file" action="{!importFile}"/>
 </apex:pageBlockSection>
 </apex:pageBlock>
 </apex:form>
</apex:page>
public class FileUploadController {
 public transient Blob csvFileBody{get;set;}
 public String csvAsString{get;set;}
 public String oppId{get;set;}
 public FileUploadController(){
 oppId = ApexPages.currentPage().getParameters().get('oppId');
}
 public void importFile(){
 ContentVersion contentVersion_1 = new ContentVersion();
 contentVersion_1.Title = csvAsString;
 contentVersion_1.PathOnClient = csvAsString;
 contentVersion_1.VersionData = csvFileBody;
 insert contentVersion_1;
 List<ContentVersion> list_version = SELECT contentdocumentid,ownerid FROM ContentVersion WHERE id =: contentVersion_1.Id;
 ContentDocumentLink link = new ContentDocumentLink();
 link.ContentDocumentId = list_version0.contentdocumentid;
 link.LinkedEntityId = oppId;
 link.ShareType = 'V';
 insert link;
}
}

因为VF页面最大允许内存135K，如果上传一个超过135K的文件，页面会崩溃。所以Blob对象加上transient瞬态关键字修饰可避免此问题。将变量声明为瞬态变量可以减小视图状态大小。

代码语言：javascript复制
Lighting Aura:
<div>
 <center>
 <aura:iteration items="{!v.uploadedFiles}" var="item" indexVar="index">
 <tr class="slds-hint-parent">
 <th data-label="" scope="row">
 <ui:outputText value="{!item.name}"></ui:outputText>
 </th>
 </tr>
 </aura:iteration>
 <lightning:fileUpload label="" multiple="true"   
 accept="{!v.accept}" recordId="{!v.recordId}"   
 onuploadfinished="{!c.UploadFinished}" /> 
 </center>
</div>
UploadFinished : function(component, event, helper) {  
 var recordId = component.get("v.recordId");
 var fNameList=event.getParam("files");  
 var toastEvent = $A.get("e.force:showToast");
}

LWC：

网上有很多。不赘述啦。

四 与外部系统的交互

上传方法示例：从外部接口获取文件内容（字符串）

EncodingUtil.base64Decode转码base64 转成blob类型放在 contentVersion VersionData字段中

设置文件名，客户端路径等属性

代码语言：javascript复制
Inert ContentVersion后，生成ContentDocumentLink与对象链接起来
 public static void generateContentFile(string objectId, String fileName, Blob contentData) {
 ContentVersion conVer = new ContentVersion();
 conVer.ContentLocation = 'S';
 conVer.PathOnClient = fileName;
 conVer.Title = fileName;
 conVer.VersionData = contentData;
 insert conVer;
 Id conDoc = [SELECT ContentDocumentId FROM ContentVersion WHERE Id = :conVer.Id].ContentDocumentId;
 ContentDocumentLink conDocLink = New ContentDocumentLink();
 conDocLink.LinkedEntityId = objectId;
 conDocLink.ContentDocumentId = conDoc;
 conDocLink.shareType = 'V';
 insert conDocLink;
    }

下载：生成公开地址链接 ：

在ContentVersion触发器里自动关联ContentDistribution对象

在文件生成时自动创建下载链接

代码语言：javascript复制
trigger ContentVersionTrigger on ContentVersion (after insert) 
{
 if (trigger.isAfter && trigger.isInsert) 
    {
 List<ContentDistribution> itemList = new List<ContentDistribution>();
 for (ContentVersion cv : trigger.new) 
        {
 ContentDistribution newItem = new ContentDistribution();
 newItem.Name = cv.Title;
 newItem.ContentVersionId = cv.Id;
 newItem.PreferencesAllowViewInBrowser= true;
 newItem.PreferencesLinkLatestVersion=true;
 newItem.PreferencesNotifyOnVisit=false;
 newItem.PreferencesPasswordRequired=false;
 newItem.PreferencesAllowOriginalDownload= true;
 itemList.add(newItem);
        }
 INSERT itemList;
    }
}
代码语言：javascript复制
 public static ContentDistribution createContentDistribution(Id contentVersionId, String ContentName, Boolean ifDownLoad) {
 ContentDistribution newDist = new ContentDistribution();
 newDist.ContentVersionId = id.valueOf(contentVersionId);
 newDist.Name = ContentName;
 newDist.PreferencesAllowViewInBrowser = true;
 newDist.PreferencesLinkLatestVersion = true;
 newDist.PreferencesNotifyOnVisit = false;
 newDist.PreferencesPasswordRequired = false;
 newDist.PreferencesAllowPDFDownload = false;
 newDist.PreferencesAllowOriginalDownload = ifDownLoad;
 return newDist;
 ContentDistribution newItem = createContentDistribution(cv.id,cv.Title,true);
 insertList.add(newItem);
 distributionList = [SELECT Id,DistributionPublicUrl, PdfDownloadUrl, ContentDownloadUrl,ContentVersionId,PreferencesAllowOriginalDownload FROM ContentDistribution WHERE ContentVersionId IN: cvIdList];

生成DistributionPublicUrl链接传递给外部系统即可。（预览/下载）

云服务器文件 salesforce

0 人点赞