Zugriff auf Inhaltsobjekte über Funktionen mit programmgesteuerter Freigabe in ContentDocumentLink

Terminologie

Dokument-Linkerstellung und Inhaltszugriff:

1. Funktion greift auf ihren eigenen Inhalt zu
2. Funktion greift auf den Inhalt eines anderen Benutzers zu

Funktion greift auf ihren eigenen Inhalt zu

services/data/vXX.X/sobjects/ContentVersion

Funktion greift auf den Inhalt eines anderen Benutzers zu

//Create Document
//Note: This example creates the content in Apex
//We could also load content via Data Loader.
ContentVersion cv = new ContentVersion();
cv.Title = 'Test Document';
cv.PathOnClient = 'TestDocument.pdf';
cv.VersionData = Blob.valueOf('Test Content');
cv.IsMajorVersion = true;
Insert cv;
 
//Get Content Documents
Id conDocId = [SELECT ContentDocumentId FROM ContentVersion WHERE Id =:cv.Id].ContentDocumentId;
 
//Create ContentDocumentLink 
ContentDocumentLink cdl = new ContentDocumentLink();
cdl.ContentDocumentId = conDocId;
//Label would contain the user id of the cloud integration user (obtained separately)
cdl.LinkedEntityId = Label.Platform_User_Id;
//V - Viewer permission. C - Collaborator permission. I - Inferred permission
cdl.ShareType = 'V';
Insert cdl;

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

// Purposefully selecting another file NOT owned by the platform integration user
// (Hardcoded platform integration user Id - to be replaced with a more dynamic ID 
// merge in the query)
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;
}

// File Id for download
logger.info("contId: " + JSON.parse(JSON.stringify(contId)));

// Print
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);    
}

Hinweis 1

Hinweis 2

Automatisierte Dokument-Linkerstellung

Beispiel-Auslösercode

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);
    }
}

Überlegungen und Risiken

• Nachdem ein Inhaltsdokument-Link freigegeben wurde, kann er von jeder Funktion aufgerufen werden. Um den Zugriff auf das Dokument in Zukunft zu verhindern, muss seine Freigabe in "ContentDocumentLink" explizit aufgehoben werden. Dieser Ansatz ermöglicht den Zugriff auf das Dokument für alle Funktionen oder keine, da alle Funktionen als Cloud-Integrationsbenutzer ausgeführt werden.
• Die Benutzer-ID des Cloud-Integrationsbenutzers muss manuell ermittelt und in den Apex-Auslöser eingefügt werden. Dazu muss die ID in einer benutzerdefinierten Einstellung, einem benutzerdefinierten Objekt oder einer benutzerdefinierten Bezeichnung gespeichert werden. Alternativ kann sie im Plattform-Cache gespeichert und von dort abgerufen werden. Außerdem kann sich die Benutzer-ID nach einer Organisationsmigration ändern, sodass die Freigaben mit der neuen ID neu erstellt werden müssen.
• Dokumente müssen einzeln freigegeben werden, indem für jedes Dokument eine Datensatzfreigabe erstellt wird. Dies könnte bei einer großen Anzahl von Dokumenten zu Problemen in Bezug auf die Skalierbarkeit führen.