Home > DemandTools for AppExchange Modules > DemandTools Maintenance Modules > Reassign Ownership - Mass Transfer of Objects/Sub Objects

Reassign Ownership - Mass Transfer of Objects/Sub Objects

New in DemandTools 2.2!

Capabilities & Features:

  • Ability to reassign the ownership of any object in Salesforce, with options to also reassign all or specific related sub objects
  • Only reassign sub objects that matched to previous parent object owner or all sub objects (regardless of the previous owner)
  • Use conditions based on any field to specify a subset of objects to be reassigned
  • Read in a file of specific Object ID's/Owner ID's to be reassigned
  • Ability to use multiple/complex "Match Conditions" to reassign objects to multiple owners at the same time
  • Randomly distribute a group of objects to multiple owners
  • Realign all sub objects to match parent object owner only (do not reassign parent)
  • Create Tasks and/or Summary Events to track ownership changes on the parent object
  • Scheduleable through Windows Scheduled Tasks

Common Uses:

  • Mass transfer Accounts to a new owner
  • Redistribute Accounts based on territories
  • Realign all or selected sub objects beneath an Account or other parent object ONLY updating records where the sub object owner DOES NOT currently match the parent owner

Compatible Data Sources ("Use Keys From File"):

  • .xls
  • .xlsx (Excel 2007)
  • .csv
  • .mdb (Access)
  • .udl

Quick Links

Screen 1:  Objects to Reassign

Step 1.  Select Object to Reassign Ownership

Any object can be selected for reassignment.  Pick the object from the list and click "Use Object".

Step 2.  Specifying Where Conditions or Using Object Keys from File

Subset which particular records will be reassigned.  There are 2 ways to do this:

1.  Use Where Condition:  For example, find all Accounts where the Owner Alias = Laurie.


 
Conditions are used when subsetting which objects will be updated, exported, and/or searched, depending on the module.  In most cases the option to use all objects or specify conditions on which object(s) to use will be available.

 

When "Use Conditions" is selected the conditions area is no longer greyed out and open for criteria specification.



Step 1.  Select the Field to Base a Condition On

Step 2.  Select the Operator

  • Available operators will change based on the type of field selected.
  • "!=" represents "not equal to".
  • When using dates, operators will include "Today", "Yesterday", etc.".

Step 3.  Specify a Value(s)

  • Text Fields:  Type in the value.  Multiple values for the same field are to be separated by commas.  Commas are translated as "or".  For example, "ma,nh,me" will be translated to "ma or nh or me".  Note:  values entered are not case sensitive.
  • Picklists:  Select the value from the specified list.  Multiple values can be selected and will be translated as "or".
    • Valid picklist values are shown (as defined in Salesforce.com).  Right click on a list of picklist values to "Add a Value".  This is used to add a value not currently in the picklist and make it available for use in the criteria. The value is added for the purpose of selection and will not be added to the actual picklist in Salesforce.
    • Right click on a list of picklist values to "Filter List" to subset a long picklist based on a search string to quickly find a value(s).
  • Dates:  The current date will default in the value window. Click the arrow on the right to access a calendar and select a specific date.


    • To isolate a specific day regardless of time when dealing with a Date/Time field (i.e. created date), specify 2 conditions, greater than the day before and less than the day after.  This is not necessary when using an operator such as "Today" or "Yesterday".

Step 4.  Add Condition(s)

  • Select "Add Condition" to add the condition to the list of current conditions.
  • By default all conditions are and'd together.  To create "or" groups see Step 5.
  • To delete one condition from the list, click the box to the left to highlight the condition and press the delete key on the keyboard.

Step 5.  Creating "OR Groups" (this option is not applicable to all modules)

  • To create "or" groups, check the "Expert Mode" checkbox.
  • Change the "OR Group" number for specific conditions (click on the number on the right and adjust up or down).  All conditions WITHIN a group are and'd and BETWEEN groups are or'd.  For example:


    Reads as:

    (MailingState=ma AND LeadSource=External Referral) OR (MailingState=ny AND LeadSource= Trade Show)
  • Unchecking the "Expert Mode" checkbox will cause all conditions to be and'd once again.


2.  Use Keys from File:  Read in a file of specific Object ID's/Owner ID's to be reassigned.

Click on "Use Keys from File" tab to bring up the "Select File" window:

  1. Select the file from PC.  Supported files include xls, xlsx (excel 2007), csv, mdb and udl.
  2. For xls, xlsx or mdb files, also need to select the appropriate worksheet or table.  Highlight and click "Select".
    • The number of records loaded will appear on the left in red, i.e. 2245 Records Loaded.
  3. Select the field that contains the Object ID from the input file.  Click the arrow on the left to access fields in the spreadsheet.
  4. Optionally select the field that contains the new OwnerID from the input file.
    • Only OwnerID's can be selected (Owner Alias or Owner Name are not allowed).
    • If OwnerID's are selected, an option to "Reassign to owner given in key input file" will be activated on the "Final Use Match" in screen #2.  This option will need to be selected to use the OwnerIDs from the file.
    • Leave the field selection as "Select OwnerID Field" if you do NOT wish to assign the new owner based on OwnerID in the input file.  In this case, the new Owners will be selected in Screen #2.

Step 3.  Fields to Display in Final Output

Before processing changes, a confirmation grid is displayed with fields selected from the object being updated, as well as the option to show fields from related tables.



 Click "Next" in the bottom right hand corner to move to Screen 2.

Screen 2:  Reassignment Constraints

Step 1.  Reassignment Match Conditions

Specify new ownership assignments for records specified in Screen 1.

1.  Add Matching Step (optional)

Further subset the records and assign to different owners using "Match Conditions".  Click this box to create matching steps to assign specific records to specific users.  Multiple Match Steps can be created.

Match Steps are evaluated in order.  Once a record matches in a step it is no longer evaluated in subsequent steps.

  1. Matching steps will have the default name "Match #", can optionally type in a specific name.
  2. Click "Add Match Condition" to create conditions
    • "Clear Mapping" will clear all current conditions within a match step
    • To delete just one condition click the "box" to the left of the condition, highlight the row and select "delete" on your keyboard
  3. Select the Salesforce field to base the condition on
  4. Select the Constraint (i.e. equals, not equals, greater than, contains, starts with etc.)
    • Available constraints will vary based on the type of field selected
    • "Zip Code Range" is available for selecting ranges of zip codes
  5. Specify a value(s)
    • Multiple text values can be separated with a comma (i.e. ma,ny,nj - will be interpreted as "ma" or "ny" or "nj")
    • A calendar will be displayed for date values
    • Valid picklist values will be displayed for picklists and multi select picklists
    • For Zip Code Ranges enter #####-##### (i.e. 10000-11000)
  6. Can create "OR Groups" by changing the "OR Group" number
    • By default all conditions are and'd together if "OR Groups" are not defined
  7. Reassign To:  Owner
    • Select from a list of active Salesforce owners to assign this group of objects to
    • "Filter" allows you to search the full list of owners to quickly locate a specific owner
  8. Reassign To:  Distributed Owners
    • Click "Select Owners" to randomly assign records in this group to multiple owners

    • Click "Add User" to add users to the list
    • Either type in specific percentages, or click "Redistribute" to evenly distribute across all users in the list.

9.  Can "Move" steps up or down, or "Delete" an entire step by clicking on the specific step on the left and selecting the appropriate button.

2.  Use Final Match

All records not found in "Matching Steps" assigned to an owner(s) in "Final Use Match".  If no "Matching Steps" defined ALL records will be reassigned based on selections in this step.

3.  Final Reassignment Options

  1. Reassign to:
    • Select from a list of active users to assign objects to
    • "Filter" allows you to search the full list of owners to quickly locate a specific owner
  2. Distributed Owners:
    • Click "Select Owners" to randomly assign records to multiple owners
  3. Reassign to owner given in key input file
    • Will be activated if "Use Keys from File" selected in Screen 1 and OwnerID selected in "Optional Field for Owner ID"
  4. Current User (Inactive users ignored)
    • Select this option IF YOU ONLY WANT TO REASSIGN THE SELECTED SUB OBJECTS TO MATCH THE CURRENT PRIMARY OBJECT OWNER (object selected in Screen 1 for reassignment).
      • Primary objects WILL NOT be reassigned
      • Only the selected sub objects whose ownership DOES NOT CURRENTLY MATCH the primary object owner will be reassigned
      • "All Objects" must be selected for the sub objects to be reassigned in the next step "Reassign Sub Objects"
      • i.e. Reassign all Contacts owners to match Account owners, only updating the Contact Owners when they currently DO NOT MATCH the Account owner.
  5. Do Not Reassign
    • Used if you only want to reassign based on the specific "Match Conditions" defined.  All non matching records will not be reassigned.

Step 2.  Reassign Options

Pick and choose which sub objects should be reassigned.  Optionally create tasks and/or Summary events to track the changes.

 

1.  Reassign Sub Objects

Click the "Use" box next to the sub objects to be reassigned.  All sub objects, including custom objects are available for selection.  By default certain sub objects are prechecked, but these can be unchecked if desired and additional objects checked.

For Accounts prechecked sub objects include:

There is also an option to "Match Parent Owner" or "All Objects" when deciding which specific objects should be reassigned.  Click in the box to access a pulldown menu with the "All Objects" option.

2.  Task Creation

Optionally, completed Tasks can be created on the Master Object to track the ownership changes that were made.

Note:  If Field Tracking is enabled in Salesforce for the Owner Field (where available) the ownership change will also be tracked in the History related list.  This however, just tracks the change of ownership for the Master Object itself.





3.  Summary Event Creation

Optionally, Events can be created for the user running Reassign Ownership summarizing the ownership changes that were made.  These Events can also be emailed to the user.

  • Default setting is NOT to create Events or send an email
  • Events are "Assigned To" the user who ran the Reassign Ownership
  • Subject will be "Owner Reassignment Completed"
  • Description will include Summary Counts of objects and sub objects reassigned, broken down by Matching Step
  • If the email option was selected, the email will be sent to the user that ran the Reassignment and will contain the contents of the Description field from the Event


Screen 3:  Confirmation

Review and confirm objects to be reassigned, and ultimately process your reassignments

Prior to processing the update a confirmation screen is presented indicating which records will be updated, the current owner, the "Fields to Display on Final Output" from Screen 1, the step the record matched in, and the new owner.

  • To access the complete record in Salesforce, select the "View" button.  This will bring up the record in it's entirety
  • Can sort the entire grid by any field displayed in the grid by clicking on the field heading
  • The results can be grouped by any field(s), entire groups checked/unchecked for processing, individual items can be unchecked
  • A "Distribution Report" can be displayed to summarize the counts of objects and sub objects to be reassigned and to whom
  • The entire grid can also be exported for external analysis
  • The reassign scenario can be saved for later recall, processing and/or scheduling
  1. Use:  By default all objects are checked.  Individual items can be unchecked as desired
  2. Current Owner:  Displays the current owner name.  This is included in the grid regardless of whether it was selected as a field to show on Screen 1
  3. Fields to Show on Final Output:  All fields selected on Screen 1 are displayed
  4. Match Step:  Displays the Match Step a record fell into from Screen 2
  5. New Owner:  Display who the new owner will be based on the criteria specified in Screen 2
  6. Scroll Bar:  Ability to scroll through the list of matches
  7. Grid Control:
    • Check/Uncheck All: Check or uncheck all records in the grid
      • Only checked items will be processed when "Update Records" is selected
    • Fit Grid:  All columns will be resized to fit the grid
    • Show Groups:  Check this box to group the results by a particular column(s)
      • Drag a column header(s) to the top of the screen to group by columns

      • May want to group by "Match Step" to see which records matched in which step
      • Once grouped, entire groups can be checked or unchecked for processing by right clicking on a group header

    • Export Grid Data: Export the Confirmation screen to an xls spreadsheet for external review

    8.  Information:

    • Counts of Objects Found (all objects downloaded) and Objects to Change (checked objects)
    • Object Distribution Report:  Click this button to get a count breakdown of the total objects to be reassigned
      • Provides a pop-up box displaying counts by new owner including how many sub objects will be reassigned

      • The "Total X objects the will have a new owner" may be less than the "Total X objects selected to update" if some of the objects selected are ALREADY owned by the proposed new owner.  These objects will not be updated, however, if "All Objects" is selected for sub object reassignment then all sub objects that do not currently match the Parent Owner will be reassigned

    9.  Update Records:  Select this button to process the reassignments.
  10.  Load/Save/Clear Scenario:  These buttons are provided on all 3 Reassign Ownership screens

    • Save your full scenarios for future recall and/or scheduling through Windows Scheduled Tasks
    • Load a previously saved scenario
    • Clear all selections on all 3 screens and start over

Restore Files

  • Created for the primary object and all sub objects that had at least one record reassigned
  • Contain the object id and old owner id
  • File type (xls, csv, xlsx etc) will be based on the "Default Restore File Extension" selected in the DemandTools options menu
  • If the old owners need to be restored you can use MassEffect and map the old owner back

See also

MassImpact - Multi-table and Formula based data Manipulation
MassEffect - ETL for Salesforce
MassChange - Single Table Data Manipulation
MassChange Batch
ZipFix - Reverse Engineer Existing Zip Codes
MassBackup - Backup to local .MDB database
Restore Files
Using Conditions