ContentDocumentLink のプログラム共有を使用した関数によるコンテンツオブジェクトへのアクセス

用語

ドキュメントリンクの作成とコンテンツアクセス

1. 自身のコンテンツにアクセスする関数
2. 他のユーザーのコンテンツにアクセスする関数

自身のコンテンツにアクセスする関数

services/data/vXX.X/sobjects/ContentVersion

他のユーザーのコンテンツにアクセスする関数

//ドキュメントを生成します。
//メモ:この例では Apex でコンテンツを作成します
//データローダを使用してコンテンツをロードすることもできます。
ContentVersion cv = new ContentVersion();
cv.Title = 'Test Document';
cv.PathOnClient = 'TestDocument.pdf';
cv.VersionData = Blob.valueOf('Test Content');
cv.IsMajorVersion = true;
Insert cv;
 
//コンテンツドキュメントを取得します。
Id conDocId = [SELECT ContentDocumentId FROM ContentVersion WHERE Id =:cv.Id].ContentDocumentId;
 
//ContentDocumentLink を作成します。 
ContentDocumentLink cdl = new ContentDocumentLink();
cdl.ContentDocumentId = conDocId;
//ラベルにはクラウドインテグレーションユーザーのユーザー ID (別途取得) が含まれます。
cdl.LinkedEntityId = Label.Platform_User_Id;
//V - 閲覧者権限。C - コラボレータ権限。I - 推定される権限
cdl.ShareType = 'V';
Insert cdl;

SELECT Id, UserName from User WHERE username like 'cloud@00d%'

// プラットフォームインテグレーションユーザーが所有していない別のファイルを意図的に選択します
// (ハードコード化されたプラットフォームインテグレーションユーザー ID。より動的な ID に置き換えられます 
// クエリでマージします)
let contentQuery = "SELECT Id 
                    FROM ContentVersion 
                    WHERE OwnerId != '0055f0000057ROYAA2' 
                    ORDER BY CreatedDate DESC LIMIT 1";
let queryResults = await context.org.dataApi.query(contentQuery);
let contId = "";
for (const downItem of queryResults.records) {
    contId = downItem.fields["Id"];
    break;
}

// ダウンロード用のファイル ID
logger.info("contId: " + JSON.parse(JSON.stringify(contId)));

// 印刷
logger.info("DOWNLOAD LATEST FILE NOT OWNED BY FUNCTIONS USER");

await request
    .get(
        context.org.baseUrl +
        "/services/data/v54.0/sobjects/ContentVersion/" +
        contId +
        "/VersionData"
    )
    .auth(null, null, true, context.org.dataApi.accessToken)
    .on("error", function (err) {
        logger.info("Exception: " + err);
    })
    .pipe(
        fs.createWriteStream("./tempFiles/downFile.csv", { encoding: "utf8" })
    )
    .on("finish", doSomethingAfterDownload);    
}

注意 1

注意 2

ドキュメントリンクの自動作成

サンプルトリガーコード

trigger ContentVersionTrigger on ContentVersion (after insert) {
    ContentVersionTriggerHelper.triggerHelper(
        Trigger.operationType,
        Trigger.new,
        Trigger.oldMap);
}

public with sharing class ContentVersionTriggerHelper {
    public static void triggerHelper(
        System.TriggerOperation operationType,
        List<ContentVersion> newList,
        Map<Id, ContentVersion> oldMap
    ) {
        switch on operationType {
            when AFTER_INSERT{
                List<ContentVersion> docsToProcess = getDocsToShare(newList);
                if(!docsToProcess.isEmpty()){
                    shareWithIntegrationUser(docsToProcess);
                }
            }
        }
    }

    public static List<ContentVersion> getDocsToShare(List<ContentVersion> allDocuments){
        List<ContentVersion> docsToProcess = new List<ContentVersion>();
        for(ContentVersion cVer : allDocuments){
            if(cDoc.OwnerId != Label.Platform_User_Id){
                docsToProcess.add(cVer);
            }
        }
        return docsToProcess;
    } 

    public static void shareWithIntegrationUser(List<ContentVersion> documents){
        List<ContentDocumentLink> shareLinks = new List<ContentDocumentLink>();
        for(ContentVersion cVer : documents){
            ContentDocumentLink cdl = new ContentDocumentLink();
            cdl.ContentDocumentId = cVer.ContentDocumentId;
            cdl.LinkedEntityId = Label.Platform_User_Id;
            cdl.ShareType = 'V';
            shareLinks.add(cdl);
        }
        Database.insert(shareLinks,false);
    }
}

考慮事項とリスク

• コンテンツのドキュメントリンクが共有されると、どの関数からもアクセスできるようになります。今後そのドキュメントにアクセスできないようにするには、ContentDocumentLink からドキュメントの共有を明示的に解除する必要があります。この方法ではすべての関数でドキュメントにアクセスできるか、またはどの関数でもアクセスできなくなります。すべての関数はクラウドインテグレーションユーザーとして実行されるためです。
• クラウドインテグレーションユーザーのユーザー ID を手動で取得し、Apex トリガーに挿入する必要があります。そのためにはカスタム設定、オブジェクト、またはラベルに ID を保存する必要があります。または、プラットフォームキャッシュに保存してアクセスすることもできます。また、組織の移行後にはユーザー ID が変わる可能性があり、その場合は新しい ID で共有を再作成する必要があります。
• ドキュメントはドキュメントごとにレコード共有を作成して個別に共有する必要があります。その際、大量のドキュメントを処理する場合は拡張性の問題が発生する可能性があります。