Salesforce App updaten naar versie 1.5 of hoger
- Paul van der Koore
- Jeffrey Rijdes
Inhoudsopgave
Vanaf deze versie is het mogelijk om in Salesforce direct een proces met DocuFlow op te starten.
Update proces Salesforce App
Er zijn twee manieren om de Salesforce App te updaten:
Na het updaten van de Salesforce App moet je een aantal instellingen wijzigen in Salesforce, een uitleg daarover staat hier: instellingen wijzigen in Salesforce.
Het instellen van een knop om een DocuFlow proces direct vanuit Salesforce te starten staat hier beschreven: Aanmaken van een DocuFlow knop (button).
Updaten via de App Exchange pagina van Salesforce
Ga naar https://login.salesforce.com/packaging/installPackage.apexp?p0=04tMI0000006yhRYAQ (versie 2.1) en installeer de nieuwste versie.
Updaten via een update-link
Klik op de URL die je hebt ontvangen om de update te installeren, log daarna in met je Salesforce account.
Klik op Install for all Users en vervolgens op Upgrade.
Er opent een pop-up. Vink het selectievakje van “Yes, grant access to these third-party web sites” en klik vervolgens op Continue.
De update wordt uitgevoerd, wacht tot onderstaande scherm verschijnt en klik op Done.
De Saleforce App is succesvol geüpdatet.
Instellingen wijzigen in Salesforce (page layouts)
Om de DocuFlow buttons aan te kunnen maken moet de standaard page layout (default page layout) worden toegewezen voor alle gebruikers. Hieronder staat het proces uitgeschreven.
Ga in Salesforce linksboven naar je Apps en ga naar DocuFlow Buttons.
Op deze pagina staan alle reeds aangemaakte DocuBuilder buttons weergegeven. Klik rechtsboven in op de Setup-knop en daarna op Edit Object.
Ga in het linker menu naar Page Layouts, je ziet hier nu de DocuFlow Button Layout v2 staan. Deze gaan we als standaard toewijzen door rechtsboven op Page Layout Assignments te klikken.
Klik op Edit assignment.
Selecteer alle profielen (houdt CNTRL of SHIFT ingedrukt om alles meerdere profielen te selecteren), wijzig de Page Layout To Use naar DocuFlow Button Layout v2. Klik vervolgens op Save.
Ga zoals in Stap 1 beschreven weer naar de DocuFlow Buttons. Open hier een bestaande button of voeg een nieuwe button toe, je ziet dan onderstaande scherm waar nu ook de DocuFlow instellingen staan.
Salesforce is nu helemaal gereed om DocuFlow processen direct op te starten. De uitleg om een DocuFlow button aan te maken staat hieronder beschreven.
Aanmaken van een DocuFlow knop (button)
Om een DocuFlow proces te starten vanuit Salesforce moet er eerst in DocuFlow een Get-step worden toegevoegd. In deze Get-step wordt het Record opgehaald van de pagina waar de knop komt te staan.
Bijvoorbeeld: als de knop op een Opportunity pagina staat en je drukt op deze knop, dan haalt DocuFlow enkel die Opportunity (Record) op.
Get-Step aanmaken in DocuFlow
Open de DocuFlow applicatie en ga naar het proces waar de Get-Step toegevoegd moet worden.
Klik op het configuratie tabblad en ga naar Stappen. Meer uitleg over de processtappen vind je hier: Stappen .
Voeg een nieuwe stap toe aan het proces met onderstaande velden
Stap naam: geef hier de naam van de stap. Bijvoorbeeld: “Ophalen Salesforce Record“.
Stap type: ophalen bestanden
Klik op de nieuw aangemaakte stap en druk op Wijzigen.
We gaan de processtap inrichten. Vul de velden in zoals hieronder aangegeven. Belangrijk is om het Link Id te onthouden, deze is straks nodig voor de inrichting in Salesforce.
Uitvoeringsmode: handmatig
Gecreëerde status onderdeel: Nieuw
Creëer document als 'alleen lezen': uitgevinkt
Invoegen duplicaten toegestaan: uitgevinkt
Item uniqueness check: External system unique indentifier
Job action on success: Keep minimum data
Plugin: Salesforce Retriever
Uitvoering: Generate items
Automatisch naar volgende stap: selecteer hier de processtap (uitleg: Stap 2. Aanmaken processtap met een Processtep (Voorbeeld eenvoudig mailen) )
Klik op Configuratie plugin en stel de plugin als volgt in. De {@Id} zorgt ervoor dat het Record van de pagina waar de DocuFlow knop staat wordt opgehaald en in een tag wordt gezet dit in het proces kan worden gebruikt (tag: stepId)
Druk op Ok en daarna ook op Ok om de Get-Step op te slaan. Ga nu verder met het aanmaken van de knop
Button toevoegen in Salesforce
Ga in Salesforce linksboven naar je Apps en ga naar DocuFlow Buttons.
Klik rechtsboven op New.
Er opent een pop-up met velden die je als volgt dient in te stellen
Name: naam van de knop
Object type: waar deze knop moet komen te staan
Description: omschrijving wat de knop doet
Module: DocuFlow
Button configuration: leeg
Step Id: het Link Id van de Get-step die je hebt aangemaakt
Klik op Save. De knop wordt nu toegevoegd aan het Object.
Indien je nog niet eerder een DocuFlow of DocuBuilder knop op dit object hebt toegevoegd kan het zijn dat je de object pagina (Opportunity in dit voorbeeld) nog moet aanpassen.
Ga naar de desbetreffende objectpagina.
Klik rechtsboven op de Setup-knop en vervolgens op Edit Page.
Zoek aan de linkerkant naar DocuFlow en sleep het component DocuFlow naar de gewenste positie op het scherm. Druk daarna op Save.
Afhankelijk van de instellingen in Salesforce kan het zijn dat je de aangepaste pagina nog moet publiceren naar alle gebruikers, dit doe je door op Activation te klikken naast de Save-knop.
De knop staat nu bij het gewenste object. Als je op deze knop drukt wordt het proces (de Get-Step) in DocuFlow opgestart.
Het kan zijn dat je nog toestemming moet geven als de eerste keer op de knop wordt gedrukt, je krijgt dan een dergelijk scherm te zien. Klik op Allow om toestemming te geven.