SAP Knowledge Base Article - Public

2144428 - Top 10 reasons Forms Are Not Transferring to New Manager or Failed to Route to Manager - Performance Management

Symptom

  • Forms stuck with wrong person.
  • Why are documents not transferring to new manager?
  • Forms appear to be stuck with "System System". (This is the user account all automated transactions are logged against. Typically it is not physically with "system" but actually still with the inactive user or old manager.)
  • Most often forms fail to transfer to a new manager, but many of the points below apply equally as well to forms failing to route to other users in the route map.

Note:

  • Please refer to our Guided Answers tree to get help in troubleshooting Document Transfer issues when making a change in the subject's Manager, Matrix Manager or HR Rep.
  • If the issue is not with Managers but with other users, refer to KBA 2078700 - Top 10 Reasons Forms Failed to Route to Next Step, Forms Did Not Move or Moved to Wrong User or Step
  • If the problem is the opposite, where forms moved when it was not expected, see KBA 2078153 Form Transferred When it Shouldn't

Environment

SAP SuccessFactors Performance Management

Resolution

Issues in the Check tool

Check tool has been enhanced with a Document Transfer Check, if there are any issues identified, that means that there are Document Transfer and Change Engine jobs blocked, and this could prevent the forms from being properly transferred in the affected environment. In order to correct the scenario and prevent inconsistency in Document Transfer, if an issue in this is identified in the check tool, it is necessary to run the quick fix.

As from 2205 Release, the Check tool has been enhanced to idenfiy blocked jobs caused by RBP refresh rules and auto correct them. However, if the jobs were blocked by any other reason, such as DC outage, Integration failed, them still will be required to manually run the quick fix.

Note: You should evaluate all options where the behavior described is similar to what you are reporting, as you might actually have a number of causes.
  • For example if you have 50 forms stuck with wrong person that did not move you might have some not moved because they were in Get Feedback at the time.
  • Maybe an admin did a manual import on another day and forgot to set correct transfer options to match your template causing some not to move (and they didn't even notice their mistake). Then you also inactivated a manager before transferring the employee forms, and finally some forms simply were never even with the manager to begin with (remembering manager transfer options only apply if the form is with the actual manager at that time.)
  • So although a report shows 50 forms have not moved as expected, it is quite possible there are multiple reasons as to why they did not move as opposed to 1 single system issue that impacted all 50 at the same time.

As it possible for forms not to move for the following reasons we recommend that the admin run reports periodically to identify any that became an exception in auto-routing that you determine need to be moved.

Are your forms created by the scheduler tool "Scheduled Mass Create Forms"?  If so please also read the main scheduler solution along with this solution.

Trigger Events for Document Transfers

There are a number of areas in the product that can trigger a document transfer.

It is good to understand what events can trigger a valid transfer to begin with in case another admin is triggering one of these events:

  1. A manual change is executed via Admin tools > Manage Users > Documents Transfer
  2. Automated FTP employee file import. With this option your transfer options are configured at the time the FTP process was setup and will not change until requested.
  3. Manual employee file import. With this option, since it is possible for the user to use different settings on every import, differing results may occur.
  4. Company Change Engine: In addition to the standard manager changes that can trigger document transfers, the employee change engine can also be configured to execute a documents transfer on other triggers such as: Jobcode Change and Location Change.

Change Engine

  • Behavior = All forms will lock to old manager while enabled at the time the manager transfer is applied.
  • The most common cause is because you froze the form using the Change Engine. Note once locked a form will not unlock. Turning change engine off after forms are locked will NOT unlock them. A workaround to unlock forms locked to the old manager is to resave the route map from admin tools. Click here for more info on Change Engine.

Invalid Values in Matrix Manager, Custom Manager or Second Manager Columns

  • Behavior = Random and ongoing failures. Can result in large numbers of forms not moving as expected in any predictable logic. This is preventable by ensuring only valid usernames exist in these columns.
  • Quite often we find the client has a C Step as first step and this is often where the form gets stuck.
  • When you check the route map, it says the manager has successfully updated in the future steps, but the form has stayed with the old manager in the C Step, and that old manager can not move it.
    • Customers are often diligent in ensuring that all your usernames in your MANAGER column are correct in each import, but many clients fail to be as diligent in maintaining correct and accurate values in the other manager columns that exist > MATRIX_MANAGER, CUSTOM_MANAGER. if you are not updating these columns and have usernames of people who are no longer valid, then this will cause failures and forms will not move for those records. If a person is set as the custom manager of many people then this can affect many forms.
    • Note: If multiple people all have the same invalid matrix or custom manager username in these columns then large groups could be impacted.

Form Template Level Transfer Options Conflict with Import Settings

  • Behavior = For any import done none of the forms will correctly transfer. If you are performing both manual employee imports and automated FTP imports then some might transfer correctly while others fail.
    Typically that is because the manual import settings were not quite right.Your Form template transfer settings must match same setting in the FTP daily import.
    Also if doing manual imports the transfer options needed to be correct to match your actual template transfer options. Routing - Troubleshooting Document Transfer Options
  • Support should review with you if all your templates, ftp user import, and manual imports have the right settings for document transfers.
  • Note that changing your transfer options in the template or import AFTER you already performed the import will not fix existing forms that are stuck.
  • You will now need to transfer employee back to old manager, and transfer them back to new manager to trigger proper transfers. (or rock the forms as explained below)

Form Not Actually in the Inbox of Manager

  • Behavior = No forms transfer as expected or only some forms transfer whereas others transfer fine depending on what transfer rule is in play.
  • Do you realize that the "Inbox Manager Transfer." option only applies IF and WHEN the form is actually with that manager in their inbox at the time of the transaction?  Routing - Troubleshooting Document Transfer Options

Invalid or Inactive Manager

  • Behavior = Random failures. Impossible to define any logical cause as to why some fail to move and others are ok since this is a data issue. Preventable by ensuring all data changes are properly ordered.

    Typically these are created by improper transfer options as outlined above.

  • An Invalid manager is a person who cannot log into the system. If you as an employee do not have an ACTIVE manager, then you cannot log into the system. If you cannot log into the system our system knows this and will therefore skip you in the route map. Similarly, if you as a manager have a manager above you who is INACTIVE, then you also can't login to the system so we will not transfer a document to you.

  • Major issues that occur when data changes are not done in the correct order are:

  1. New manager not in the system at the time the employees data row is processed. (even though the new managers record is in the file it was not entered first but later in tile)
  2. Old manager is set to inactive in the file before you transferred the the forms to new manager. Now forms are stuck with the inactive manager.
  3. You must structure all employee imports and data changes in a logical order. See here for more information
    1. Are you using multiple import files for new employees and deactivating old employees? (recommended options)
    2. Or are you doing it in 1 file and if so are you ensuring it is ordered in 3 sections?
  4. You resolve these types of scenarios manually by reactivating any users. Also if it is in old managers inbox you can either temporarily make them manager again, or manually route form to a previous step at which time the old manager will be removed and corrected to new manager. (sometimes referred to rocking the form to trigger role updates).

Failed to make user employee changes in correct order

  • Behavior = Random and ongoing failures. Can result in large numbers of forms not moving as expected in any predictable logic. This is preventable with proper approach to data changes.

  • Forms can get stuck with old user and show as "System" when not making correct data changes. Your data changes must occur in proper order to prevent forms from being stuck with the system.
  • You resolve these types of scenarios manually by reactivating any users. Also if it is in old managers inbox you can either temporarily make them manager again, or manually route form to a previous step at which time the old manager will be removed and corrected to new manager. (sometimes referred to rocking the form to trigger role updates).

Timing Conflict Between Automated Imports + Scheduler Launch

Form in Get Feedback Status

  • Behavior = Random failures as its impossible to predict who will have a form in the Get Feedback status at the time a manager change might be imported. Not preventable when using this feature.

  • If a form is in a "Get Feedback" step with a person outside of the standard routing map, then the document will remain with that person and NOT transfer. The person that currently holds the form needs to be identified and asked to send the form back to the old manager. Only then can the old manager send the form on to the next step, which may or may not be to the new manager depending on your routing map and the transfer options used in the transfer. 

  • Does your template have get feedback enabled? If it does then this will likely be a cause for some forms.

Unsupported Manager Role 

  1. Behavior = Consistent failure for forms for a specific role not to change, typically at the step that manager role is in the route map.
  2. In the SuccessFactors application the term "Manager" as it relates to "Manager Transfers" only applies to EM, EX, EH.It does NOT apply to other manager roles such as second level manager (EMM), or other manager roles. (EH EA EC etc.)
  3. For these other manager roles forms will remain with them as the system treats them like any regular person. If you want to transfer a document for these people you will manually need to route it using the routing tool in Admin Tools.

Form Locked at Time of Transfer:

  • Two possible scenarios that can happen to prevent a transfer are when the form is actually open and being edited by someone else.
  • Obviously if by chance someone is working on a form at the same time your FTP or manual user import is done, then those forms will be skipped.
  • This is not a common cause, but can explain why some every now and then didn't move. We have no tools or ways to show if a form was locked at the time.
  1. Is an admin performing employee changes at a time when others are likely to be in the system?
  2. Can you change your automated FTP import time to later at night?

Form Template Public Flag

  • Make sure that Template Flag is set to Public. Check this in admin tools on the form template settings.
  • Private forms remain with the original manager and will not be transferred with any Public forms.
  • This flag has no impact on the route map however, if there is any EM steps in the route map that have not been completed, these EM steps will reference and route to the new manager at that time.

Manager Transfer Performed for Enterprise Client Using Manage Users or Document Transfer With Form in Signature Step

  • Known issue where client uses Manage Users or document transfer option to update manager record for a form that is in signature step.
    Followed by the recipient of the form rejecting the form backwards. The result is the form gets stuck with new manager who has no send button.

  • Note: Enterprise clients should not even use "Manage user" option in admin tools. This link is typically only enabled for PE clients.(PMT-8442)
  • Can be resolved by rocking the form backwards and forwards.

    Required fields should not be problem as a required field is applied only for that role if the form is in their inbox. Therefore if a form is not in the inbox of the role that is required to provide those details then enforcement rules will not apply keeping a form stuck.

Rocking a Form - Moving the Form

  • If your forms for any of the above reasons are not currently with the correct person the most common way to resolve these are by using admin tools and manually moving the form back 1 step.
  • This causes the system to evaluate the employee data, new managers, route steps, and roles in your form and refreshing the form to reflect the current state of all these variables.
  • Now with the form, people and data in the right state you can move the form back to where you need it.
  • This is the best, safest and fastest option for admins to manage these exceptions (even if a few hundred develop over time). There is no option Support has to do this automatically for you.

Optimize Your Setup

If your process is causing too many forms to fail to move, then we recommend possible changes to how you manage your Manager Transfer and also adjusting your form template and user import settings to ensure they have optimal settings.

Keywords

sf, success factors, PMGM, PM, route, form, document, map, not transferring, stuck, old manager, hide, visibility, automatic, transfer, options, enroute, inbox, collaborative, c-step, entry, exit, change engine, hris sync, template, PMT-8849 , KBA , csg_q , LOD-SF-PM-MAP , Routing, Route Maps & Workflows , LOD-SF-PM , Performance Management , Problem

Product

SAP SuccessFactors Performance & Goals all versions