Accesso all'oggetto Contenuto da parte delle funzioni utilizzando la condivisione programmatica in ContentDocumentLink

Terminologia

Creazione del collegamento al documento e accesso al contenuto

1. Funzione che accede al proprio contenuto
2. Funzione che accede al contenuto di un altro utente

Funzione che accede al proprio contenuto

services/data/vXX.X/sobjects/ContentVersion

Funzione che accede al contenuto di un altro utente

//Creare il documento
//Nota: in questo esempio, il contenuto viene creato in Apex
//In alternativa, è possibile caricare il contenuto tramite 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;
 
//Ottenere i documenti contenuto
Id conDocId = [SELECT ContentDocumentId FROM ContentVersion WHERE Id =:cv.Id].ContentDocumentId;
 
//Creare ContentDocumentLink 
ContentDocumentLink cdl = new ContentDocumentLink();
cdl.ContentDocumentId = conDocId;
//L'etichetta contiene l'ID utente dell'utente integrazione Cloud (ottenuta separatamente)
cdl.LinkedEntityId = Label.Platform_User_Id;
//V - Autorizzazione Visualizzatore. C - Autorizzazione Collaboratore. I - Autorizzazione implicita
cdl.ShareType = 'V';
Insert cdl;

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

// Selezione intenzionale di un altro file NON di proprietà dell'utente integrazione piattaforma
// (Id dell'utente integrazione piattaforma hardcoded, da sostituire con un ID più dinamico 
// unire nella 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;
}

// ID file per il download
logger.info("contId: " + JSON.parse(JSON.stringify(contId)));

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

Nota 1

Nota 2

Creazione automatica del link al documento

Esempio di codice trigger

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

Considerazioni e rischi

• Una volta che un collegamento a un documento di contenuto è condiviso, è possibile accedervi da qualsiasi funzione. Per impedire l'accesso al documento in futuro, la condivisione deve essere esplicitamente annullata da ContentDocumentLink. Questo approccio consente l'accesso al documento a tutte le funzioni o a nessuna, perché tutte le funzioni vengono eseguite come utente integrazione Cloud
• L'ID utente dell'utente integrazione Cloud deve essere ottenuto manualmente e iniettato nel trigger Apex. Pertanto, è necessario memorizzare l'ID in un'impostazione, un oggetto o un'etichetta personalizzati. Oppure, è possibile memorizzarlo e accedervi dalla cache della piattaforma. Inoltre, l'ID utente potrebbe cambiare dopo una migrazione dell'organizzazione; in questo caso, sarà necessario ripetere le condivisioni con il nuovo ID.
• I documenti devono essere condivisi individualmente, creando una condivisione del record per ogni documento. Ciò potrebbe creare problemi di scalabilità, in caso si debba gestire un gran numero di documenti.