Salesforce Community getContentAsPDF()

Ursachenforschung kann in manchen Fällen nicht nur zeitintensiv, sondern auch nervenraubend sein. Insbesondere dann, wenn sich die zu testende Funktion innerhalb eines komplexen Konstruktes befindet. Mit der folgenden Beschreibung kann ich vielleicht dem einen oder anderen Entwickler eine Menge Streß ersparen ;-)

Funktion:
Generierung einer PDF Datei per Button (aus einer VisualForce Seite heraus). Anschließend wird die PDF Datei als Attachment an einen Datensatz angehängt.

Ausgangslage:
Die oben beschriebene Funktion ist ein Teil eines in der Org installierten Managed Packages. Sie wird von einem Salesforce Community User ausgelöst. Weitere Informationen dazu gibt es in meinem letzten Beitrag Salesforce Community URL Settings.

Problem:
Kein Attachment nach der Funktionsausführung im System verfügbar.
Die folgende Fehlerseite erscheint:

Ursache identifizieren:
Als erstes fange ich an, die Logs auszuwerten. Da die im managed Package implementierten Debug-Ausgaben in der Test-Org nicht erscheinen, muss ich

1. dem Hersteller des managed Packages den Zugriff auf die Test-Org erlauben 
2. um mich anschließend über den Hersteller-Zugriff (Hersteller-org des Managed Packages > Tab "Subscriber Organizations") in der Test-Org einzuloggen. 

Erst jetzt kann ich Debug-Ausgaben im Log-Bereich für den Community User konfigurieren.

Mit dem Community User einen Test gemacht...
Im "Hersteller-Log" erscheinen deutlich mehr Informationen. Doch in Bezug auf die Attachment-Generierung geht das System sehr sparsam mit Informationen um.

Nur "SYSTEM_MODE_EXIT | true"???
Mehr bekomme ich leider nicht.

Nach vielen weiteren Tests unter anderem mit dem aktivierten und deaktivierten Critical Update "PageReference getContent() and getContentAsPDF() Methods Treated as Callouts" bin ich zum Ergebnis gekommen, dass die Referenzierung der PDF Seite innerhalb des Managed Packages für einen Community User nicht korrekt funktioniert.

Ursache:
pdfPage.getContentAsPDF() funktioniert nicht, weil das System die pdfPage nicht findet (obwohl die PDF Generierung innerhalb des Managed Packages läuft).

Lösung:
Für Community Benutzer wird der absolute Pfad bei der Initialisierung der PDF Seite verwendet.
Die beiden folgenden Funktionen sind etwas ausführlicher Beschrieben im letzten Beitrag:

• isCommunityUser()
• communitySiteURL()

PageReference pdfPage;
        // absolute URL only for Community User
        if(isCommunityUser()){

            String serverUrl = communitySiteURL();  
            // remove last slash
            if(serverUrl != ''){
                if(serverUrl.right(1) == '/'){
                    serverUrl = serverUrl.substringBeforeLast('/');
                }
            }
            pdfPage = new PageReference(serverUrl + '/apex/sf42_quotefx__QFX_pdf');
        }else{
            pdfPage = Page.QFX_pdf;
        }

Zusatzinfo: Initialisierung der PDF Seite außerhalb des Managed Packages funktioniert reibungslos:

pdfPage = Page.sf42_praefix__QFX_pdf;