OrgChart Now Help Guide

Table of Contents

SuccessFactors Configuration

Audience

Audience: Administrators

Overview

OrgChart Now can import data directly from SAP SuccessFactors via the ODATA REST API.

In order to connect to SuccessFactors in OrgChart Now, you must have the following information provided by your SuccessFactors System Administrator.

  • Server

  • User ID

  • Password

  • Org Code

Connecting to SuccessFactors
  1. Log in to OrgChart.

  2. Select More > Chart Settings .

  3. Click on the Excel icon (under the Main Data Source heading), and then double-click on the SuccessFactors icon.

    successFactorsconnector.png
  4. Enter the Server, User ID, Password, and Org Code provided by your SuccessFactors System Administrator.

  5. Enter "User" in the Resource Table textbox (under the Configure SuccessFactors Connection header).

    Note

    Note: The User Resource Table integrates best with OrgChart Now. While it is possible to use a different Resource Table, it may lead to integration problems and is not recommended.

  6. Enter the SupervisorID (as it is labeled in your SuccessFactors data configuration) in the SupervisorID textbox. This information is derived from whichever table contains the hierarchy information (typically the Managers table).

    Note

    Note: Reference the Chart Settings: Mapping panel to to determine what OrgChart will set as the label for the hierarchy field in an alternative setup.

  7. Enter Query Parameters. If you do not know your SuccessFactor's data configuration (i.e., the tables and picklists from your SuccessFactor's instance), please contact your SuccessFactors support rep.

    successfactorscharts.png

    Note

    Note: Your SuccessFactors data configuration might require the $orderby=userId Query Param. The $orderby=userId Query Param ensures that OrgChart Now does not interpret the SuccessFactors data incorrectly.

Picklist Mapping

Picklist Mapping is a Merge Connector that updates your data.

If the data query (configured in steps 1-7) returns unexpected values for certain fields, you must create a Picklist Mapping that tells OrgChart Now how to convert picklist values into labels. For example, if your query for Employee Status returns "500," instead of "Active," you must provide the proper Picklist Mapping to return the desired value.

To create a Picklist Mapping:

  1. Click on the Plus.png icon under the Merge Data heading, and then double-click on the SuccessFactors icon.

  2. Enter the Server, UserID, Password, and Org Code provided by your SuccessFactors System Administrator.

  3. Type "Picklist" in the Resource Table textbox, and then click on Save. The Picklist Mapping box appears.

  4. Enter the Query Params. Query Params vary depending upon your SuccessFactors data configuration. Consult your SuccessFactors System Administrator for the Picklist ID's.

  5. Enter the Picklist Mapping for the SuccessFactors fields which returned unexpected values in the initial query. For example, {'ecEmailType':'emailType'}. The mapping block structure will have key/value pairs.

    1. Each Key is a Picklist ID from the prior step.

    2. Each Value is the corresponding OrgChart Field Name.

    Successfactors_picklist_merge.png

    Note

    Note: Your Picklist Mapping depends upon your SuccessFactors data configuration. Consult your SuccessFactors System Administrator for the relevant Picklist Mapping.

  6. Click Save, and then click Refresh.