To ease the process of adding resources and resource teams to your
system, you can import them from a spreadsheet. The information in the
spreadsheet can come from an external system, such as an Active Directory store
or other Lightweight Directory Access Protocol (LDAP) providers, or you can
manually create a spreadsheet as long as it meets the requirements discussed in
the following sections.
Use the import feature to:
- Add new resource teams as parent teams or within a team hierarchy
- Add new resources
- Add resources to resource teams
- Assign skills and job functions to resources
- Assign a resource's manager
- Add skills and job functions to the system
- Add other attributes such as department, business unit, type, and
title group to the system
- Assign new skills to existing resources
- Assign a job function to an existing resource who is not already
assigned an existing job function
- Assign new resource teams to existing resources
Steps for Importing Resources
Use these basic steps to import resources:
- In
Application Administrator,
click the
Resources icon on the Administrator portal, and then click
Import/Export.
- Export a resource spreadsheet template. For details, refer to
Export Resources Page.
- Add data to the spreadsheet using the information in:
- Select the
Import tab, and then import the spreadsheet.
- Review the import log. For details, refer to
Import Log.
Spreadsheet Requirements
The spreadsheet used to import resource teams and resources must
adhere to certain requirements:
- Only files of type .xls can be imported. If you have
an .xlsx file or any other type of spreadsheet file, you must convert it to
.xls.
- The spreadsheet must contain exactly two sheets: one called
Resources and one called Teams.
- Use care when adding data to the spreadsheet. In some cases, such
as resource names, rows are skipped if data already exists in the system. In
other cases, such as skills, new entries are added if data is similar but not
identical. For example, "C++ (Level 1)" and "C++ (Lvl 1)" are considered
separate skills.
Tip: The easiest way to prepare a spreadsheet is to first
perform an export. You can use the empty spreadsheet as a starting point for
meeting the following requirements.
Preparing the Resources Sheet
Each column represents a resource attribute. The information in this
section describes the relationships between those attributes, as well as
guidance on which are required, which are used for uniqueness checking, and
data rules.
Each row represents a resource. Each resource may have multiple rows,
depending on the number of teams the resource is assigned to.
Use the following information to prepare the
Resources page of the spreadsheet.
Note: Rows that contain invalid date are skipped during the import
process. Review the log for details regarding skipped rows.
- Required Columns for Resources
- Resource Name
For
SBM
User types, the resource name must be identical to that in the
SBM
user account.
- Type
Must be either User or
SBM
User.
- Login ID
For resources set as
SBM
User types, you must provide a login ID that matches the user's
SBM
login ID.
- Uniqueness Checking
A combination of the following columns are used to determine if a
resource already exists:
- Resource Name
- Type
- Login ID (for
SBM
User types only)
If row data is not unique for these columns, a new resource is
added.
For identical matches, resources are not added, but new attributes
can be assigned to the resource if they were not already assigned to the
resource.
- Manager Information for Resources
- If the manager is not already a resource, you must add the
manager as a row and import it with the resource.
- You must indicate whether the manager type is User or
SBM
User.
- For managers set as
SBM
User types, you must provide a name and login ID that matches those in
SBM.
- Importing Team Assignments for Resources
- Importing Attributes
- If a resource attribute in the spreadsheet row does not exist
in the system, it is added and assigned to the resource. If the attribute in
the spreadsheet row exists in the system, it is assigned to the resource.
- Skills and job functions require a level, which must be
specified in parentheses after the skill or job function name. A space is
required between the skill name and the parenthesis. For example, a job
function might be "C++ (Senior)."
- You can only specify one job function per row.
- You can add multiple skills for a resource by separating them
with commas. For example, "C++ (Senior), Java (Advanced)."
- You can only specify one department, business unit, type, and
title group per row. All of these attributes are optional.
- Data Rules
- Data matching is case-insensitive. For example, USER, User, and
user in the
Type column is always interpreted as User.
- Data in the
Start Date and
End Date columns must be in MM/DD/YYYY format.
Preparing the Teams Sheet
Resource teams must exist in the system or be imported with resources
before they can be assigned to resources during an import.
Columns represent general resource team settings: name, description,
and parent. Each row represents a single resource team.
Use the following information to prepare the
Teams page of the spreadsheet.
- Team Name
Required for imports.
- Description
Optional for imports. The import process does not update the
description for existing resource teams, however.
- Parent
If no parent is specified, the resource team is added at the top
of the team hierarchy. To import a resource team as a child, add the parent
team by name to this row. Separate hierarchy levels with a foward slash (/) as
follows:
parent/child/child
The Team Name and Parent columns are used for uniqueness checking. If
data does not match existing resource team records for both columns, a new team
is added. If row data exactly matches existing data for both columns, the row
is skipped.
Copyright © 2007–2015 Serena Software, Inc. All rights reserved.