Skip to Content
Technical Articles
Author's profile photo Indrajit Ghosh

Document Generation – A complete Guide Including Troubleshoot

Hello Reader,

How are you doing today? Seems you are trying to make your day better by enhancing your personal knowledge repository with the typical SuccessFactor Document generation functionality.

Well, that was my intention when I started working on this specific stuff. A nice one indeed, I must say.

So on a fine sunny bright morning I was asked to implement the document generation functionality for my clients. I had no head and tail of the matter. So I started exploring and got plenty of documents over SAP help sites, KBA’s and blogs. All were pretty good and vivid as per their standard, but was beyond my reach. I was even more confused while actually started implementing. My idea was access some transactions, create templates, give authorization and then start generating the actual documents leveraging the templates. I was confused over, Configuration UI, Document Generation Types, Groups and Look up screens and in the application stage and Transporting of the forms. Finally after when I build the functionality and it started working after numerous stumbling, I thought of writing an exhaustive document on this. So let’s start from the Start.

What is HR Documents or HR Letters?

One of the basic requirements for Human Resource Management is to generate different written documents on demand or timely basis. Those are sometimes called “employment letters”, “employer letters” or “personnel letters”. Human resource (HR) letters are an important form of communication between an employer and employee or to a third party like Embassy, or Landlord or others. Letters are also required notify an employee of a promotion, recognizing an employee for superior performance etc.

What is Document Generation in SF?

Document Generation is a functionality of SF to allow authorized personnel (Employee/HR Admin) to get system generated HR Letters in some pre-defined format. Hence saving time spend on manual effort and approval process.

Is that all on Document Generation in SF?

Well not really, document generation can also be used for:

  1. Email Notification to SuccessFactors Workflow for “CC” role participants
  2. Benefits Confirmation Statements
  3. Print Form functionality

What are the pre-basic formalities?

Enable Document Generation on Provisioning.

Activate Document Generation in “Employee Central Settings”

Provide access to Manage Configuring Document setting via “Role Based Permission”

Set the permissions in Manage Document Generation Templates. Only templates of the category Document Generation will appear in the list. Initially select “All” to appears all templates that you are going to generate

 

 

MetaData Object Configuration:

Document Generation functionality is a part of SuccessFacor Meta Data Framework Enhancement. So, as with all MetaData Framework objects, this functionally also needed a look up screen and a Configuration UI.

Both the look up screen and Configuration UI can be created manually or can be used the standard objects provided by SuccessFactors. Different options are available in Document Generation Implementation Guide book.

To go with standard approach, as recommended, following steps to perform:

3. Access Manage Data and check the availability below standard of              look up screen. If not available create the look up screen with below            details

What if I do not, set UI and try to design templates?

Transection “Manage Document Template” will not get any screen to display and will throw an error

Create Templates based on business Requirement:

Now we are all set to create actual templates required for different business scenarios. Most common few scenarios are Experience Letter, Embassy Letter, Promotion Letters and Personal Information change Workflow attachments etc.

Types of Templates:

Three types or Categories of Templates possible to generate 1) Document Generation, 2) Benefit Confirmation and 3) Work flow Templates

Templates Generation Steps:

So basic plan for Document generation should be:

  1. Get all your template requirement (e.g. – Experience Letter, Personal Information Change Information)
  2. Categorize them as per standard Category of templates (Benefit Confirmation, Document Generation or workflow)
  3. Further drill down above items to group them based on diversity of requirement if necessary (e.g. – Group for Country1, Group for Country 2) in the form of Template groups
  4. Finalize the template Design (Includes the Graphics to be used, alignments, header, Parameters (e.g. Name, Legal Entity etc. variables) to be used, Footer

Once you are done with your planning, Access Transection  “Manage Document Template” and click on Create New and create the object in sequence as comes in the drop down

Please note that Group is an optional item and can be skipped in case your requirement is not that complex and can be handled without devising templates categories in to groups.

Now, your plan is ready and it’s time to apply them in system

  1. Create new “Document Generation Group” and provide below inputs, all fields are self-explanatory

  1. Create new “Document Generation Group” and provide below inputs.

 

 

Email Subject and Workflow Group needs to be populated, when you are activating email sending facility or you are selecting a category as workflow template

Template content is the actual form and designs this as per requirement and visibility requested. Hover on the wizard items to know the functionality of every item. Any parameter or place holder or parameter can be added by clicking on . Once you add a parameter you need to map this in the “Manage Document Template Mapping” section, which I will explain later.

3.  Create new “Email Settings for Document Generation Template”, .you can send the email to distribution list keeping the Related Personnel of the employees in “To” or “CC” list

 

The last configuration step for Document generation Template is “Manage Document Template Mapping”

Select a template created with Placeholder and provide below details for the placeholder

Please remember, your document template will not be available till you are not mapping the placeholders with proper value and then saving them

Generating Documents:

Now you have created the templates, it’s time to see how it works or generate the actual documents. Here is how:

  • Access Transection “Generate Document
  • Provide below details to generate the document
  • Then click on “Generate and Email“, to email the document as attachment to the email group set before keeping the employee in “To” list or click on “Download” to download the PDF on your system
  • An email will look like below:
  • Alternatively, you can access employee profile of any employee and Take Action and select generate document 
  • On the pop up select the template details and generate the documents 
  • Mass Document generation
  • Access Transection  “Mass Generate Documents” and provide the input to mass generate the Documents 

 

Workflow Document Templates

Workflow document templates can be used to customize workflow CC notifications. Steps involved:

  1. Create a Document Generation Group
  2. Create a Document Template of Category “Workflow” and Group of as created instep 1
  3. Assign the Document Generation Group, to the workflow CC list employee
  4. When workflow get approved, the document generate email will be triggered to the CC role user

 

Benefits Confirmation Statement:

Document generation template can be used to generate benefits confirmation statements. Steps involved:

  1. Create a Document Generation Group
  2. Create a Document Template of Category “Benefits Confirmation Statement” and Group of as created instep 1
  3. Access Transection “Benefits Admin Overview” and create a new “Benefits Confirmation Statement”, and select the template created at step 1
  4. Benefit confirmation statement is a summary of benefit selections, dependents or beneficiaries information, cost or contribution information and more. This statement can be triggered any time after the enrollment process. It can be printed and used during discussions with HR admins or managers as evidence to employee’s benefits selections. Typically, the benefit confirmation statement is generated after completing the enrollment process. The benefit confirmation statement can be viewed in the Benefit Overview tab under Current Benefits. This is also displayed when an employee has successfully completed the open enrollments process
  5. It is recommended to use the standard Benefit Confirmation template provided by SuccessFactors

 

Print Form

Moving Document Generation Templates from One Instance to Another (Dev to QA)

There are three ways to do this

1.    Instance Synchronization

–       This process will not work if the template contains Image or Placeholders. Resolution is that remove the placeholders and images from source system and do an instance synchronization and then include those again manually in both source and Target

2.    Export and Import

–       This process will not work if the template contains local Images. To get rid of this remove the images, then export from development and then import into quality, else just change the backend XML by removing the image section from the source and upload the image after importing the data into target system

3.    Manual Creation

–       Create the template in the target system and copy the template content and paste in the backend

 

Some useful KBA’s

2716682 – Instance Sync: Document Generation Sync completed with errors

2610219 – Application error while trying to generate a document

2089552 – Printing: Logos or Images Not Appearing in the PDF Printout of a Form – Platform

2699796 – How to check the users who received a mass generated document

To end for now:

I tried to make this blog as exhaustive as possible. Unfortunately still many related things left behind, like Why Configuration UI is required, Parameters of Configuration UI and possible modifications, Template Placeholders type and scope, more elaboration on the movement for the document between instances, Print Form details. Will discuss on them in future when I will join you again to share our views on a new knowledge treasure from vast SuccessFactor sea.

 

Till then, Muccho Gracious for reading, Adios Amegos.

Assigned Tags

      17 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Dubraska Valeri
      Dubraska Valeri

      Hello Indrajit Ghosh , thanks for the post.

      In the work letters can you have some input information ? As for example, indicate to whom the letter is addressed

       

      Author's profile photo baladeba behera
      baladeba behera

      Nice Doc, Indrajit.

      Author's profile photo Rob Greenway
      Rob Greenway

      Indrajit,

      Do you know if it is possible to use Document Generation templates for Alerts?  i.e. when scheduled job triggers an alert.  The rule that triggers an Alert has a WF but it also has a set alert.message.

      Author's profile photo Prudvinath R Potha
      Prudvinath R Potha

      Hi Rob,

      As of now, we can't use for Alerts & Notifications

      Best Regards,

      Prudvinath Reddy

       

      Author's profile photo Niladri Bihari Nayak
      Niladri Bihari Nayak

      Nice article indeed.  Is there a way where we can configure digital signature where it will automatically capture signature once we generate a letter in EC?

      Regards,

      Niladri

      Author's profile photo Anand Athanur
      Anand Athanur

      Nice writeup, Indrajit. If you have a standard sales demo, then steps 1 thru 3 should already be done.

      Thanks.

      Andy

      Author's profile photo Nicolas De La Cuesta
      Nicolas De La Cuesta

      Hello Indrajit Ghosh , thanks for the post.

      Does document generation allow mass printing?

      Thanks,

       

      Author's profile photo Jesse22 Kellerman
      Jesse22 Kellerman

      Thanks for your post. I use SAP in all my companies. I am the owner of https://carhampt.com

      Author's profile photo Niladri Bihari Nayak
      Niladri Bihari Nayak

      Nice blog.

      Is it possible to generate a unique QR Code for each document?

       

      Regards,

      Niladri

      Author's profile photo Paulo Costa
      Paulo Costa

      Hello Indrajit Ghosh,

      Is it possible to generate a barcode in the document?

      Thanks in advanced.

      Best Regards.

      Paulo Costa

      Author's profile photo Duy Tran
      Duy Tran

      Thank you for your sharing, but i have a question:

      Afer i run mass generate documents and access Execution Manager to dowload the PDF of user who is satisfied the rule but i can not see any button or function to dowload it. Can you show me?

       

      Author's profile photo Daniel Nantes Santos
      Daniel Nantes Santos

      Can I send this document to the manager only? Or for a specific email?

      Author's profile photo Paramesh Vunnam
      Paramesh Vunnam

      You Can't send it to manager. If the logged in person has access to generate the report , he can share himself via email notification.

      Author's profile photo Prasad CHANDRASHEKHAR Sule
      Prasad CHANDRASHEKHAR Sule

      Hi,

      Thanks for the informative blog.
      Can you please advice me if we can create check box  (Tick box) for those employees, with whom we send particular documents/letters
      We want to send some letter / documents to the employees but need to track from the system only.
      If so can you guide me how to create check box for the same.

      Regards
      S. Prasad
      9833452249

      Author's profile photo Antonette Venter
      Antonette Venter

      Great blog Indrajit,

      Is there an API in SF that we can use to generate and download these documents via OData?

      Regards

      Antonette

      Author's profile photo Carrie Veitch
      Carrie Veitch

      Just wondering if anyone can help...

      We have made a number of our Document Templates inactive, however they are still showing in the list available to our admin teams, how do we stop the inactive templates from being available to use and download?

      Thanks

      Author's profile photo Valeria Maria Criscuolo
      Valeria Maria Criscuolo

      Hi,

      anyone knws if is it possible to customize the body of the email (with attached the generated document) sent to employees and Job owner when do you mass create documents?

       

      Thanks in advance

      Regards

      Valeria