Working with Business Object Profiles

This chapter provides an overview of profiles and discusses how to:

Click to jump to parent topicUnderstanding Profiles

A profile is a PeopleSoft Enterprise Customer Relationship Management (CRM) business tool with multiple uses. Profiles reference data to and from the Customer Data Model (CDM), transactional tables, or user defined profile tables. Use profiles to:

System and User-Defined Profile Data

Customer Relationship Management uses the Customer Data Model as a centralized data storage repository to retain extensive individual and organization information. To maximize system performance, PeopleSoft Marketing and Online Marketing use a subset of the CDM data that is stored in a set of three basic data tables. When additional individual or organization information is needed but not contained in the delivered data tables, PeopleSoft Marketing enables you to define new profiles and profile fields in the language that you want. A system administrator uses PeopleSoft Application Designer to create the corresponding physical tables and fields and then maps them to the requested definitions. Whether data resides in the predefined system tables or your user-defined profile tables, You can use it for all functions by using one or more profiles.

PeopleSoft CRM delivers two profiles with the system, one for individuals and one for organizations. The two delivered profiles are listed with the profile name People under the type Individual and Companies under the type Organization. The Individual: People and Organization: Company profiles cover profile needs related to basic contact data (for example, name, address, company name, and so on). Additionally, each user-defined profile table has a corresponding profile to reference the data that is stored there. Use profiles in combination to access information in any or all tables.

Note. When moving profiles between environments, you should always manually re-create them. Moving profiles using Data Mover is not supported.

Profile Usage

Consider these examples of the various ways to use profiles.

Suppose that your company operates a national chain of pet supply stores and that you are part of the team charged with making your marketing efforts more effective. Your team believes that one way to accomplish this is by targeting current and potential customers with promotions that are specific to the pets they own, and you decide to test it with an online marketing campaign. As part of the campaign, you purchase a list of subscribers to various pet magazines. Using your Individual: People profile, import the subscriber list into your Customer Relationship Management database.

Using your Individual: People profile, you can create a target audience of customers who have an email address on record. Use PeopleSoft Online Marketing to create an online dialog and send that target audience an email broadcast offer. The email directs respondents to a PeopleSoft Online Marketing web page that offers a free gift for each pet in the household. To receive the gift, respondents must enter or update information about each pet.

A few months ago, your company started gathering data on customers' pets. At that time, a user-defined profile was created to store several pieces of information. The web page to which you directed the respondents was created in PeopleSoft Online Marketing using your individual: people and pet profiles. As you created the page, you used several of the profile fields to display questions. As respondents answer the questions, the respondent's profile data is updated in the Customer Relationship Management database in real time.

When the information gathering phase of the dialog is complete, you launch another follow-up email that is targeted to the respondents. This time, you use the individual people and pet profiles to tailor email messages and promotions. While viewing the types of information that are gathered by these profiles, you see that you can differentiate customers by the type of pet they own. Using the Pet type as a search criteria, you create separate emailing lists for Cat, Dog, Rodent, Horse, and Bird. When the results are in, you find that this personalized, targeted approach is far more effective than other marketing efforts and you decide to expand it to your entire customer base.

Note. The People profile is a system profile. While you can make changes to it (for example, changing existing fields or adding new ones), this activity is considered customization.

See Also

PeopleSoft Online Marketing User Guide

PeopleSoft Enterprise Marketing Applications Preface

PeopleSoft Enterprise Performance Management Warehouse PeopleBook

Importing Data into PeopleSoft Enterprise CRM

Click to jump to top of pageClick to jump to parent topicProfile Data in the CDM

PeopleSoft Enterprise CRM Online Marketing enables marketers to define profiles and profile fields that collect customer profile information, online, such as color or brand preference. After the marketers register and activate profiles and profile fields, you can configure profile groups that enable CDM components to access profile data. You can also set up the configurable search to use profile fields as search criteria.

To configure profile data for displaying and updating in CDM components, define a profile group that includes the profile fields and attach the profile group to CDM components. You can also use the Active Analytics Framework (AAF) to define conditions under which the profile data appears.

See Working with Active Analytics Framework.

The More Info page of the Company, Partner Company, and Person components enables you to view and update profile information. Read-only profile data appears on the Summary page of the Company and Partner Company components.

Note. You can specify that the profile group data appears as read-only on the More Info page.

See Also

Configuring Search Pages

Working with Active Analytics Framework

Click to jump to top of pageClick to jump to parent topicCommon Elements Used in this Chapter

This section lists common elements used in this chapter and discusses profile data in the customer data model (CDM).

Profile Field

A specific bit of information that is captured about the customer. For example, contact lens customers of an optical supply seller might have profile fields for the preferred color, preferred type (extended wear or daily wear), brand preference, optometrist, prescription, date of last purchase, and care kit provided. Profile fields are keyed by BO_ID.

Profile Group

An arbitrary collection of profile fields for display purposes. For example, the optical supply seller might have a profile group for contact lens information, eyeglass information, and sunglass information.

Condition

Information that controls when the profile group is displayed. After you set up profile groups, you can define the conditions for displaying and updating a profile group in a component. A read-only profile summary appears on the primary page for every component that meets the conditions, and a profile information page for updating profiles is added to the component.

For example, the condition for displaying the Contact Lens Info profile group in the Consumer component is that the consumer either previously purchased contact lenses or has requested contact lens information.

Click to jump to parent topicSpecifying a Profile Prefix

This section discusses how to specify a profile prefix.

Click to jump to top of pageClick to jump to parent topicPage Used to Specify a Profile Prefix

Page Name

Definition Name

Navigation

Usage

Profile Setup

RA_PROFILE_SETUP

Set Up CRM, Common Definitions, Profile Management, Profile Setup

Specify a profile record prefix for manually mapped user-defined profile records (tables).

Click to jump to top of pageClick to jump to parent topicSpecifying a Profile Record Prefix

Access the Profile Setup page (Set Up CRM, Common Definitions, Profile Management, Profile Setup).

Designate a profile record prefix to use with user-defined profile records (tables). The prefix must follow the standard PeopleSoft record prefix standards. Only tables with the profile record prefix are available on the Profile Registration page.

Click to jump to parent topicCreating a Profile Request

This section provides an overview of profile requests and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Profile Requests

A profile request consists of instructions that you or a system administrator use to create a new database table and fields. Your request conveys the type of information that you need and how to use it. The profile is not available for use until you register and activate it. To assist with the communication process of marketer's requests and fulfillment or rejection of those requests by the system administrator, workflow is delivered. Marketing analysts can request profiles, and when they are set to a status of Requested, the person in the defined role of Dialog Administrator receives a worklist notification. When the request is either completed and activated, or rejected, the marketing administrator receives a worklist notification.

Creation of profiles should always follow thoughtful design of campaign objectives and strategy. Before beginning to define a profile request, determine who you want to contact (your target audience), what information you want to display, what new information you want to collect, and what existing information you want to update. Profile creation requires a thorough knowledge of your Customer Relationship Management database (to ensure that you are not creating a duplicate profile or profile field) and involves a collaboration between the marketer and the system administrator.

Note. If you have purchased PeopleSoft Online Marketing, you cannot use the following characters in profiles being used for Online Marketing documents: ampersand (&), apostrophe or single quote ('), double quote (“), greater than (>), less than (<), or period (.).

Click to jump to top of pageClick to jump to parent topicPages Used to Create a Profile Request

Page Name

Definition Name

Navigation

Usage

Profiles

RA_PROFILE_SUMM

Set Up CRM, Common Definitions, Profile Management, Profile Definitions

View summary information about all of your profiles and to access an existing profile or create a new profile.

Profile

RA_PROFILE_DTL

  • Click the profile name on the Profiles page to edit an existing profile.

  • Click the Add a New Profile button on the Profiles page to define a new profile.

Define basic information about the profile.

Profile Fields - Field Summary

RA_ATTRIBUTE_SUMM

Select the Profile Fields tab on the Profile page.

Add new fields to a profile, or view existing profile fields.

Profile Fields - Field Detail

RA_ATTRIBUTE_DTL

Click the Field Detail link on the Profile Fields - Field Summary page.

Define a new profile field or edit an existing profile field.

Click to jump to top of pageClick to jump to parent topicDefining Basic Profile Information

Access the Profile page (click the profile name on the Profiles page to edit an existing profile or click the Add a New Profile button on the Profiles page to define a new profile).

Group Type

Select Individuals when the profile information refers to persons.

Select Organizations when the profile information refers to organizational data.

Category

Shows the category to which the profile belongs.

Status

Select In Design while you are defining your profile request.

Select Requested to lock the profile design. Setting the status to Requested notifies your administrator that the profile design is complete. The administrator can manage approval and connect the profile to the database.

Select Activated to indicate that the profile fields have been mapped and the required profile table has been created.

Select Rejected to indicate that the profile design has been rejected by your system administrator.

Select Update to edit an activated profile.

Note. As long as the status of a profile is In Design, your ability to edit and make changes is unlimited. A status of Requested or Rejected allows you to delete any profile field that is in a status of In Design. When the profile status is set to Activated, your ability to change or edit the profile is limited. For example, when a profile is activated you cannot delete a field. Likewise, you cannot delete field choices, but you can inactivate them.

Profile Name

Enter a name for the profile.

Note. If you have purchased PeopleSoft Online Marketing, you cannot use the following characters in profile names used for Online Marketing documents: ampersand (&), apostrophe or single quote ('), double quote (“), greater than (>), less than (<), or period (.).

Rows

Row selection determines how many unique rows of data you can enter into the profile table for each contact. You can define profiles as either one row or many rows. After a profile is requested, you cannot change the row selection.

Select Many Rows to allow multiple rows of data per contact.

Select One Row to allow only one row of data per contact.

For example, suppose that you use a one-row table to store information about whether your customer is a pet owner and how many pets your customer owns. If you want to store the names of the pets, you must allow for the possibility that your customer has more than one dog or cat. To record the names of multiple pets, you must use a Many Row table.

Note. Profiles defined as Many Rows can be used only for audience selection. They cannot be used in online documents by PeopleSoft Online Marketing.

Profile Can Be Updated

Select this check box if the profile is available for update (for example, by customers changing their information on an Online Marketing web page form). If you mark profiles to not allow updates, the profile fields cannot be marked as questions.

Click to jump to top of pageClick to jump to parent topicAdding and Editing Profile Fields

Access the Profile Fields - Field Summary page (select the Profile Fields tab on the Profiles page).

Note. Click a column heading to change the sort order of the column.

Field Detail

Click to access the Profile Fields - Field Detail page where you defined the field.

Order

Displays the order in which profile fields appear when the profile is used. The order affects the display only, and users are free to select the fields in any order desired.

Name

Click the field name to access the profile field detail.

Use Type

Defines how to use the new fields. Values are:

  • Choose Many: Defines a choice field that allows the respondent to select more than one response from a list of options.

  • Choose One: Defines a choice field that allows the respondent to select only one response from a list of options.

  • Choose One (with rating): Defines a choice field that allows the respondent to select only one response from a list of options and assigns a numeric value to the choice. Also, specifies a numeric value associated with the choices. These values are to be used in the generated results.

  • Date: Defines an entry field for a date.

  • Decimal: Defines an entry field for numbers that allows decimal positions. An example is a currency entry.

  • File: Defines an entry field for uploaded files.

  • Integer: Defines an entry field for numbers that do not allow decimal positions. An example is a response to the question: How many children do you have?

  • Map to Existing Field: Defines a choice field that relies on a prompt table for response options. Prompt tables are useful when the response options are numerous. For example, you can use a prompt table field for state and country responses. Some common prompt tables (such as state and country) already exist within the system. If a prompt table does not exist, your system administrator will have to build it.

    Note. The Map to Existing Field field value is used for audience selection and data import only. PeopleSoft Online Marketing cannot use it in the creation of online documents. The Map to Existing Field field values cannot be included on profile tables with any other type of field. It is recommended that they reference a view rather than a system or profile table.

  • Text: Defines an entry field that allows the respondent to enter a free-form text response. You must specify a field length. The maximum field length must be less than 254 characters.

    Note. PeopleSoft Online Marketing users can use a document text field (created within a PeopleSoft Online Marketing document) to capture text entries that are greater than 254 characters. Refer to the PeopleSoft Enterprise CRM 9.1 Online Marketing PeopleBook for complete information.

  • Text Block: Defines an entry field that allows the respondent to enter a free-form text response. You must specify a field length. The maximum field length must be less than 32,700 characters.

  • Time: Defines an entry field to receive a response in a time format.

  • Yes/No: Defines a choice field for which the responses are either yes or no.

Parent Name

Use this drop-down field to specify a relationship among field choices (for example, you could specify that a field named College is the parent of a Department field, and the Department field is in turn the parent of a field named Major). You can define three levels of hierarchy using this field; it appears only for fields of type Choose One and Choose One with Rating.

Note. This dynamic enumeration functionality applies only to Basic and Custom profile fields used with Online Marketing.

Field Status

Displays the current status of the profile field and always depends on the status of the profile. Values are In Design, Active, and Update.

Click to jump to top of pageClick to jump to parent topicDefining Field Detail

Access the Profile Fields - Field Detail page (click the Field Detail link on the Profile Fields page).

Name

Enter a name for the field.

Field Status

Displays the current status of the profile field and always depends on the status of the profile. Values are In Design, Active, and Update.

You can alter the profile field value when the field status is In Design or Update. When a profile is activated, all profile field statuses change to Active. To alter a profile field value, change the status of the profile to Update, then change the profile field status to Update.

Use Type

The use type value that you selected when you added the new field appears as the default value. Until the profile is activated, select a new option to change the field type.

Profile Question

Select to make this field available for use in a web document or email blast.

Description

Enter a description of the field. The description appears on the Profile Fields - Field Summary page.

Question

If the profile field is specified as a profile question (the Profile Question check box is selected), enter a question that is designed to elicit a desired response. For example, if the value for the profile field is Number of Pets, your question might be: “How many pets are in your household?”

The following fields appear only with certain use types.

Order

Indicates the order in which you want the response options to appear. Change the order by changing the number in this field. Save the page to make the changes effective.

Choices

Enter the choice values for the profile field question. The value that you enter appears where the profile is used.

Rating

When Choose One (with Rating) is selected as the use type, enter a rating value for each option. Rating values are measured from the smallest numerical value to the highest. For example, a rating of 1 is less than a rating of 5.

Map to Field

When Map to Existing Field is selected as the use type, select the underlying prompt table.

Note. If the prompt table is unknown or does not exist, this field can be left blank. If the prompt table does not exist, a system administrator must build it before the profile is activated.

Length

When Text or Text Block is selected as the use type, enter a text field length. The maximum field length for the Text use type must be less than 254 characters. The maximum field length for the Text Block use type is less than 32,700 characters.

Click to jump to top of pageClick to jump to parent topicModifying Active Profiles

You can make the following changes to activated profiles:

Note. After a profile is inserted into a PeopleSoft Online Marketing document, changes to the profile do not affect the document unless the profile is deleted from the document and then reinserted.

Profile changes are not required to be applied to all documents. In fact, situations will occur in which you will not want to change a document. For example, you can insert a profile into two or more documents if you intend to offer different choices to a particular question. By modifying the choices on the profile, you can insert the version with the appropriate choices into the different documents.

With the exception of adding a new profile field, you can easily modify active profiles without having to resubmit your profile request.

Making Changes That Do Not Require a New Request

Changes to existing fields do not affect the underlying profile table. Rather, these changes affect what is called the metadata.

To make changes that do not require a new request (changes to the metadata):

  1. Change the status of the profile to Update.

  2. On the Profile Fields - Field Summary page, click the field that you want to modify.

    This enables you to access the Profile Fields - Field Detail page, where you must change the Status field to Update.

  3. Make the change.

    For example, to add a new choice to the Choose Many field value, click one of the Add buttons in the Choice column. To eliminate a choice, select the Inactivate check box beside the choice that you want to eliminate. You can also select or deselect the Profile Question check box to change whether a field appears as a question, or change the text of a question.

  4. Return to the Profile page, change the profile status to Activated and save the profile.

Adding a New Profile Field

Adding a new profile field requires a change to the profile table and can be completed by you or by the administrator, depending on your organization's requirements.

To add a new profile field to an existing profile:

  1. Change the status of the profile to Update.

  2. On the Profile Fields - Field Summary page, select the use type for the field that you want to add and click the Add a New Field button.

  3. Enter the field information and save the page.

  4. Return to the Profile page, change the profile status to Requested, , and save the profile.

Click to jump to parent topicRegistering a Profile

When a profile request is set to a status of Requested, it becomes available for registration and activation. Registration is the process of mapping the profile fields to a profile table (record) and then making the profile available for use. Registration is a simple matter of linking the profile to the profile table and activating the profile.

Note. Map to Existing Field field value types rely on an underlying prompt table for field values.

Choose Many field value types rely on a child table for field values.

If you have purchased PeopleSoft Online Marketing, the following characters cannot be used in profiles being used for Online Marketing documents: ampersand (&), apostrophe or single quote ('), double quote (“), greater than (>), less than (<), or period (.).

Critical Information for System Administrators

System administrators who are responsible for creating profile tables should become fully familiar with PeopleSoft Application Designer. To ensure proper interaction between PeopleSoft Marketing and Online Marketing, you must follow specific record and view design parameters.

See Enterprise PeopleTools 8.50 PeopleBook: PeopleSoft Application Designer Developers Guide

This table lists information that applies to profile table fields that are created using PeopleSoft Application Designer:

Profile Field Type

PeopleTools Field Type

Notes

Choose Many

NA

Separate child table is needed. No new fields are required for the profile record.

Choose One

Char (254)

 

Choose One with Rating

Number (18,0)

Must be signed.

Date

Date

 

Decimal

Number (18,4)

Must be signed.

File

Char (254)

 

Integer

Number (18,0)

Must be signed.

Map Field Choice to Prompt

Char (x)

Map Field Choice to Prompt fields cannot be included in profile tables with any other type of field. Oracle recommends that you create a view for this data rather than a profile table. The field that is referenced determines the PeopleTools field type. See the section related to building views in the PeopleSoft Application Designer documentation.

Text

Char (X)

X represents the desired field length as defined in the profile definition request .

Text Block

Long Character

 

Time

Time

 

Yes/No

Char (1)

 

The following information applies to profile tables (records) created using PeopleSoft Application Designer:

Profile records must follow a standard naming convention (<recprefix>_<profileName>) that uses the record prefix that is designated on the Profile Setup page. For example, if the record prefix is OMP, and your profile record relates to pets, you might use the name OMP_PETS.

Note. Unless the system administrator decides to create a custom tablespace for profile tables, use the RALARGE tablespace.

Click to jump to top of pageClick to jump to parent topicPages Used to Register a Profile

Page Name

Definition Name

Navigation

Usage

Profiles

RA_PROFILE_DTL

Set Up CRM, Common Definitions, Profile Management, Profile Registration, Profiles

View the profiles that are registered.

Profile Registration - Profile Fields - Field Summary

RA_ATTRIBUTE_SUMM

  • Click a Profile Name link on the Profile page.

  • Click the Field Summary link on the Profile Fields - Field Detail page.

Enter or view summary information about profile fields.

Profile Registration - Profile Fields - Field Detail

RA_ATTRIBUTE_DTL

Click the Field Detail link on the Profile Fields - Field Summary page.

Enter or view detailed information about profile fields.

Click to jump to top of pageClick to jump to parent topicViewing Registered Profiles

Access the Profiles page (Set Up CRM, Common Definitions, Profile Management, Profile Registration, Profiles).

This page enables you to view all the profiles that are defined to the system. Click a profile name to view or modify profile detail.

Click to jump to top of pageClick to jump to parent topicReviewing the Profile Request

Access the Profile Registration - Profile page (Set Up CRM, Common Definitions, Profile Management, Profile Registration, Profiles) then click a profile name.

Status

Select Activated when the profile registration is complete. This makes the profile available for use.

Select Rejected when the profile request is unacceptable and must be redefined or discarded.

Select Requested when the profile has not been registered and activated.

Note. If the profile was automatically created, and reactivation requires changes to the record (table), the profile status is changed to Activating until the necessary processing is complete.

Create Profile Automatically

Select to generate the profile record to use to store the profile information automatically.

Create/Map profile Manually

Select to map the profile and the record where the profile information is stored manually.

The record must be created in the application designer in advance. If this option is selected, specify the record in the Record Name field.

Record Name

Select the record (table) that was created for this profile.

Click to jump to top of pageClick to jump to parent topicMapping Field References

Access the Profile Registration - Profile Fields page (click a Profile Name link on the Profile page, then select the Profile Fields tab).

Note. The Profile Fields pages of profiles that were automatically created (and thus, automatically mapped) do not display the Record Name and Field Name columns on the Profile Fields grid.

Name

Displays the profile field name.

Record Name

Confirm the profile table record name. If the profile field is a Choose Many or Text Block use type, select the correct child record. If the profile field is a Map to Existing Field use type, confirm that the Map to Field field on the Profile Fields - Field Detail page is set to the appropriate prompt table record name.

Field Name

Select the profile record field name that corresponds to the profile field name.

Delete

Click to remove a profile field.

Note. Fields cannot be deleted from an activated profile. After a profile is activated, you can update field details, but the changes affect profile use only from the time of the change forward.

Completing the Activation Process

When the profile fields are matched to the profile table (registered), return to the Profile Registration - Profile page, set the profile status to Activated, and save the page to activate the profile.

Click to jump to parent topicSetting Up Profile Groups

This section discusses how to set up profile groups.

Click to jump to top of pageClick to jump to parent topicPages Used to Set Up Profile Groups

Page Name

Definition Name

Navigation

Usage

Define Profile Group

RA_PRFL_DEF_PG1

Set Up CRM, Common Definitions, Profile Management, Profile Groups, Define Profile Group

Define profile groups.

Define Profile Group - Add Profile Field

RA_PRFL_FLD_SEC

Click the Add Profile Field button on the Define Profile Group page.

Select profile fields to add to a profile group.

Assign Profile Group Display - Assign Profile Group Display

RA_CMPT_PRFL_PG

Set Up CRM, Common Definitions, Profile Management, Profile Groups, Assign Profile Group Display

Assign profile groups to a CDM component.

Optionally, assign Profile Group Display - Edit Condition

RA_CND_BLD_PG

Click the Edit Condition button next to a profile group on the Assign Profile Group Display - Assign Profile Group Display page.

Specify the conditions under which the profile group fields appear on the More Info or Summary page or leave blank.

Click to jump to top of pageClick to jump to parent topicDefining Profile Groups

Access the Define Profile Group page (Set Up CRM, Common Definitions, Profile Management, Profile Groups, Define Profile Group).

Note. You can select only profile fields in activated profiles for profile groups.

You cannot add profile fields from the basic tables or many row profiles to profile groups.

Click to jump to top of pageClick to jump to parent topicSelecting Profile Fields

Access the Define Profile Group - Add Profile Field page (click the Add Profile Field button on the Define Profile Group page).

Select a profile to view the fields that it contains. Select one or more fields and click Apply. You must apply the fields to the profile before saving the profile.

Click to jump to top of pageClick to jump to parent topicAssigning Profile Groups to CDM Components

Access the Assign Profile Group Display page (Set Up CRM, Common Definitions, Profile Management, Profile Groups, Assign Profile Group Display).

Note. The fields in the Profile Groups for Summary Page region are available for the Company and Partner Company components only.

Add

Click to add a profile group to the component.

Click the Edit Condition button to define the conditions under which the profile appears.

Click to jump to top of pageClick to jump to parent topicSpecifying Conditions

Access the Assign Profile Group Display - Edit Condition page (click the Edit Condition button next to a profile group on the Assign Profile Group Display - Assign Profile Group Display page).

Click a condition that is listed in the Conditions region to view and edit the condition.

Switch to Advanced Mode

Click to specify complex conditions.

Note. Terms are programmatically created as profile fields are activated, except for the type Choose Many. You can use most profile terms anywhere AAF is used.

See Also

Working with Active Analytics Framework

Click to jump to parent topicViewing and Updating Profile Data

This section discusses how to view and update profile data information.

Click to jump to top of pageClick to jump to parent topicPages Used to View and Update Profile Data

Page Name

Definition Name

Navigation

Usage

Company - More Info

Partner Company - More Info

Person - More Info

RD_PROFILE

  • Customers CRM, Search Company, Company, More Info

  • Customers CRM, Search Person, Person, More Info

  • Partners CRM, Search Partner Company, Partner Company, More Info

View and update profile information.

Company - Summary

RD_COMPANY_SUMMARY

Customers CRM, Search Company, Company, Summary

View profile information for a company.

Partner Company - Summary

RD_PARTNER_SUMMARY

Partners CRM, Search Partner Company, Partner Company, Summary

View profile information for a partner company.

Click to jump to top of pageClick to jump to parent topicViewing and Updating Profile Information

Access the More Info page for a company (Customers CRM, Search Company, Company, More Info), person (Customers CRM, Search Person, Person, More Info), or partner company (Partners CRM, Search Partner Company, Partner Company, More Info).

Click to jump to parent topicInserting and Updating Rows in Profiles

This section describes how to insert and update rows in single row and multi row profiles. The individuals whose profiles are updated are based on the audience that is selected. You can view a profile change history by opening a completed profile update.

Only user created (custom) profiles in the Individual folder with a status of Activated that the current user is authorized to access can be updated. You will only be able to view a preview row count with static audiences.

Click to jump to top of pageClick to jump to parent topicPage Used to Insert and Update Rows in Profiles

Page Name

Definition Name

Navigation

Usage

Manage Profile Updates

RA_PROF_UPD

Marketing, Manage Profile Updates

Insert and update rows in single row and multi row profiles.

Click to jump to top of pageClick to jump to parent topicManaging Profile Updates

Access the Manage Profile Updates page (Marketing, Manage Profile Updates).

Profile Update Name

Enter a descriptive name for the profile update.

Description

Enter a description for the profile update.

Status

The current profile status.

Profile

Select from a list of the current custom profiles. The prompt displays only profiles in the Individual category with the status of Activated; the People profile and any AAF or Organization profiles are not displayed. Further, only profiles that the current user is authorized to access are displayed in the profile prompt.

Audience

Only authorized audiences are displayed in the Audience prompt. Additionally, you can only transfer to the audience (using the transfer icon next to the prompt) if the user is authorized. If the user is not authorized, then an error message is displayed.

Single Row Profile Updates

The following items refer to both single row and multi row profile updates.

Profile Field Values

Select the profile field, then enter the value to which you want to change it. If a row currently exists for a person, then that row will be updated; if a row does not currently exist, then a new row with the field values set will be inserted.

If you only want to update existing rows, you can select an audience where single rows currently exist (so the processing will be updated only upon execution).

Add Profile Field Value

Click this button to add another profile field value row.

Multi Row Profile Updates

When the selected profile is a multi row profile, an additional scroll area appears on the Manage Profile Updates page, allowing the entry of selection criteria (that is, allowing users to determine which multi-row profile rows will be inserted or updated).

Selection Criteria

Select the profile field and operator and enter the value to which you want to change it. The first and last fields in this group box are open and closed brackets, necessary only if you want to group criteria. If you include an open bracket, you must include a corresponding closed bracket.

For each selection criterion after the first, an AND/OR/WITH field appears. This field is required only if you include two or more selection criteria, and does not appear otherwise.

Row Not Found Action

If you select Insert new row if existing row not found and no matching existing row is found, then the values in the selection criteria and in the Profile field values sections will be used to insert a new row. Values in the selection criteria will be eligible for inserts only you have used the operators ‘is equal to’ or ‘is equal to current date’ while setting selection criteria.

If you select No action if existing row not found, then no new rows will be inserted if no matching existing row is found.

Existing rows are updated regardless of the value selected for this field.

Executing the Profile Update

Use the Execute Profile Updates section to specify the validations you want the system to perform when you click the Execute button. In all cases, the following validations occur:

Execute

Click this button to perform the specified profile update.

Preview Count

If this option is selected, a row count is displayed showing how many rows will be updated if the update were performed, but the profile table is not actually updated. A count of the total number of rows that would be updated , the total number of rows that would be inserted and the total number of users whose profile row(s) would be changed is displayed in the Generation Log field.

You can only use this option for static audiences.

Date, Time

Enter a date and time to submit the update. If this option is selected and the Execute button is clicked, then the job status is displayed and the user can choose to view more details from the Process Monitor.

Now

Select this option to submit the job immediately. The status details are shown and the Generation Log is updated with the actual details (number of rows updated, number inserted, and number of Person profiles updated or inserted) after the job is completed.

State Changes for Profile Updater

The following table shows the states through which a profile can progress when an update is performed.

From State

To State

State Processing

In Design

Queued

This status change occurs automatically when you click the Execute button to process either Now or for a future date.

Queued

Processing

The update is in process.

Processing

Completed

This status change occurs by the Application Engine Profile Updater process when the update completes successfully. When the profile update is in this state, no changes are allowed to the profile update (page is display only).

Processing

Failed

This status change occurs by the Application Engine Profile Updater process when the update completes but is not successful. When the profile update is in this state, the only change that the user can make is to change Status back to In Design.

Processing

Aborted

This status change occurs by the Application Engine Profile Updater process when the process ends unexpectedly. When the profile update is in this state, only change that can be made by the user is to change Status back to In Design.

Completed

None

When the profile update is in this state, no changes are allowed to it (page is display only).

Failed

In Design

This status change can be manually made by the user. It is required before the process can be run again.

Aborted

In Design

This status change can be manually made by the user. It is required before the process can be run again.