Professional Documents
Culture Documents
Applications Cloud
Using Functional Setup Manager
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by
intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,
modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or
decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to
us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the
following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/
or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation
and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating
system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions
applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in
any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle
Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of
Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and
services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any
loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement
between you and Oracle.
The business names used in this documentation are fictitious, and are not intended to identify any real companies currently or previously in existence.
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/
pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Oracle Applications Cloud
Using Functional Setup Manager
Contents
Preface i
1 Overview 1
Functional Setup Manager: Overview ........................................................................................................................ 1
Who Uses the Functional Setup Manager: Points to Consider .................................................................................. 1
Functional Setup Manager Components: How They Work Together ......................................................................... 1
Functional Setup Manager Work Areas: How They Work Together ........................................................................... 3
Implementation Process: Explained ........................................................................................................................... 3
2 Planning an Implementation 5
Planning Your Implementation: Explained .................................................................................................................. 5
Reviewing Your Subscription: Procedure .................................................................................................................. 5
Entering Promotion Codes: Procedure ...................................................................................................................... 5
Planning Your Implementation: Procedure ................................................................................................................ 5
3 Configuring Offerings 7
Configuring Offerings: Explained ............................................................................................................................... 7
Configuring Offerings: Procedure .............................................................................................................................. 7
Opting into New Features After Upgrade: Explained ................................................................................................. 8
Opting into New Features After Upgrade: Procedure ................................................................................................ 8
Reviewing Opt In History: Explained ......................................................................................................................... 9
Reviewing Opt In History: Procedure ........................................................................................................................ 9
11 Reference 65
Reference: Moving Functional Setup Data Using the Command-Line ...................................................................... 65
Oracle Applications Cloud
Using Functional Setup Manager
Oracle Applications Cloud Preface
Using Functional Setup Manager
Preface
This preface introduces information sources that can help you use the application.
Additional Resources
• Community: Use Oracle Applications Customer Connect to get information from experts at Oracle, the
partner community, and other users.
• Guides and Videos: Go to the Oracle Help Center to find guides and videos.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at Oracle
Accessibility Program .
i
Oracle Applications Cloud Preface
Using Functional Setup Manager
ii
Oracle Applications Cloud Chapter 1
Using Functional Setup Manager Overview
1 Overview
Security Access
The Application Implementation Consultant job role has full access to perform all Functional Setup Manager-related activities.
Other user must include the Functional Setups User role in addition to other roles or privileges needed to perform specific
setup activities.
For more detailed information about security requirements for Functional Setup Manager, refer to the Oracle Applications
Cloud Security Reference for Common Features guide in the All Books for Oracle Cloud page of the Oracle Help Center
(docs.oracle.com).
Related Topics
• Oracle Applications Cloud Security Reference for Common Features
1
Oracle Applications Cloud Chapter 1
Using Functional Setup Manager Overview
Offerings
An offering represents a collection of business processes that are supported by Oracle Applications Cloud. Each subscription
of Oracle Cloud provides license to use one or more offerings and they are the starting point of all implementations. An
offering consists of multiple functional areas and features.
Functional Areas
A functional area represents one or more business subprocesses and activities within its parent offering. It may represent
a core operation of the offering or may represent an optional activity which may or may not be applicable to your business.
When you start to implement an offering by enabling it, core functional areas are enabled automatically. You have a choice
to opt into and enable an optional functional area or to opt out of it. A functional area may be divided into smaller functional
areas creating a hierarchy to help you to decide what to opt into one step at a time. Some of the functional areas may be
applicable to more than one offering. Once you set up a shared functional area, you do not have to set it up again when
implementing another parent offering. However, Oracle recommends that during successive implementation of the other
parents you verify if there are any offering-specific tasks that may still require your attention.
Features
Features are optional business practices or methods applicable to the functional areas. Like functional areas, you can decide
to opt into or opt out of features depending on the requirements of your business processes. Features can be one of three
different types:
• Yes or No: These features allow you either to opt into or to opt out of them and are represented by a single check
box. You select them to opt into or deselect them to opt out.
• Single Choice: These features offer multiple choices but allow you to select only one option. Select the option
applicable to your business processes.
• Multi-Choice: These features offer multiple choices but allow you to select more than one of the choices. Each
choice is presented with a check box. Select all that apply to your business processes by checking the appropriate
choices.
Setup Tasks
Setup tasks represent the work necessary to set up an offering and the business processes and activities that the offering
represents to make them ready for transaction processing. Perform these tasks to enter setup data when you implement an
offering.
Tasks representing setup requirements of the offerings and the functional areas are grouped into task lists and are organized
in a hierarchy. For example, all setup tasks of an offering are grouped into a task list which includes subtask lists that
represent setup of functional areas within the offering. This helps you gain visibility into setup data that are related to each
other, helping you to manage setup.
2
Oracle Applications Cloud Chapter 1
Using Functional Setup Manager Overview
Plan
Identify the offerings you want to implement. Evaluate what functional areas and features to opt into and prepare accordingly
for their setup requirements.
3
Oracle Applications Cloud Chapter 1
Using Functional Setup Manager Overview
For more detailed information, refer to the Planning an Implementation chapter in the Using Functional Setup Manager guide.
Configure
Opt into the offerings, functional areas, and features that best fit your business requirements by enabling them.
For more detailed information, refer to the Configuring Offerings chapter in the Using Functional Setup Manager guide.
Setup
Use setup tasks to enter setup data necessary for your enabled offerings and functional areas. Typically, you set up and verify
your transaction processes in a test environment before starting to transact in a production environment.
For more detailed information, refer to the following chapters in the Using Functional Setup Manager guide:
Deploy
Move your verified setup data from the test environment to a production environment and deploy to all users to start
transaction processing.
For more detailed information, refer to the Exporting and Importing Setup Data chapter in the Using Functional Setup
Manager guide.
Maintain
Update setup data or opt into configuration of the functional areas and features as necessary when your business
requirements change over time.
Related Topics
• Using Functional Setup Manager
4
Oracle Applications Cloud Chapter 2
Using Functional Setup Manager Planning an Implementation
2 Planning an Implementation
To review your Oracle Cloud Applications subscription information, follow these steps:
1. Click Navigator > My Enterprise > Subscriptions work area to go the Review Subscriptions page.
2. Select Subscribed in the Show menu to view your licensed subscriptions or All to view all available subscriptions
for Oracle Cloud Applications.
If you are given a promotion code to activate a functional area or feature of an offering, follow these steps to enter the
promotion code:
1. Click Navigator > My Enterprise > Subscriptions work area to go to the Review Subscriptions page.
2. Click the Enter Promotion Code button.
3. Enter the promotion code in the Enter Promotion Code dialog box and click Save and Close to return to the Review
Subscriptions page.
The promotion code you entered is now listed in the table.
5
Oracle Applications Cloud Chapter 2
Using Functional Setup Manager Planning an Implementation
1. Select Navigator > My Enterprise > Offerings work area to open the Offerings page. You need the Review
Applications Offering privilege.
2. Explore the list and select the offering you want to implement. You can read the offering descriptions.
3. Click Related Documents to access the following information:
◦ Associated Features Report: This report shows the list of functional areas and features associated with the
offering.
◦ Setup Task Lists and Tasks Report: This report shows the list of task lists and tasks that you should complete
to successfully implement the offering.
◦ Related Business Objects Report: This report shows all setup data needed to implement the offering. It
provides a list of all business objects that are associated with the setup tasks belonging to the offering.
◦ Related Enterprise Applications Report: This report shows the list of enterprise applications used by the
functional pages and web services for the offering.
Related Topics
• Configuring Offerings
6
Oracle Applications Cloud Chapter 3
Using Functional Setup Manager Configuring Offerings
3 Configuring Offerings
In some cases, opt-in selection of a functional area or a feature may be locked once enabled due to the business operation it
represents and its selection cannot be changed.
Step-by-Step Process
Enable offerings to modify functionality so that it matches the services you plan to implement.
Enable Offerings
To enable offerings, follow these steps:
1. Select Navigator > My Enterprise > Offerings work area to open the Offerings page. You need the Configure
Oracle Fusion Applications Offering privilege.
2. Select the offering you want to implement.
3. Click Opt In Features button to go to the Opt In page.
4. In the Opt In page, select the Enable check box for the offering.
5. Review functional area hierarchy. Select the Enable check box to opt into functional areas as applicable to your
business operations.
6. Click the Edit icon in the Features column for the functional area you enabled to opt into and enable applicable
features.
◦ Depending on the feature type, a check box for Yes or No features or an Edit icon for single and multiple
choice features is displayed in the Enable column.
7
Oracle Applications Cloud Chapter 3
Using Functional Setup Manager Configuring Offerings
◦ To enable a feature, select the check box for Yes or No types or click Edit and select the appropriate choices
for single and multiple choice features.
7. Click Done when you're finished to return to the Opt In page.
8. Click Done to return to the Offerings page.
Repeat the same steps for each offering you want to implement or if you must change the opt-in configuration of any
functional areas or features of an enabled offering.
Step-by-Step Process
Use the New Features page to review and opt into new functional areas and features.
Opt In
To opt into new functional areas and features, follow these steps.
1. Select Navigator > My Enterprise > New Features to open the New Features page. You need the Review
Applications Offering privilege.
2. Select your enabled offering from the menu to review the new functional areas and features that became available in
the latest revision of the offering.
3. For each new functional area or feature:
8
Oracle Applications Cloud Chapter 3
Using Functional Setup Manager Configuring Offerings
Note: You need the Configure Oracle Fusion Applications Offering privilege to perform this step.
5. Select the Enable check box, or in case of features with multiple choices, select the applicable choices.
6. When you are finished, click Done to return to the New Features page.
Note: Alternatively, click the View History icon corresponding to a specific functional area or feature
from the Opt In page or the Edit Features page. This displays the change history of that specific
functional area or feature respectively.
9
Oracle Applications Cloud Chapter 3
Using Functional Setup Manager Configuring Offerings
10
Oracle Applications Cloud Chapter 4
Using Functional Setup Manager Managing Offering Setup
Functional Areas
When using this method, you start by selecting one of the offerings you enabled. Based on your opt-in configuration, all its
enabled functional areas, which include core and optional functional areas, are automatically displayed in a list to guide you
through the setup tasks. The display order reflects the sequence in which the functional areas should be set up because
setup data of the functional areas listed higher up in the list are usually prerequisite for those shown lower in the list. Any
functional area for which setup is mandatory is marked with an asterisk.
Functional areas that are applicable to more than one of your enabled offerings is marked as shared to allow you to evaluate
whether they were previously set up during the implementation of another offering. Even if a shared functional area was set up
previously, you may still need to evaluate if it requires additional setup data for the offering you are presently implementing.
For some functional areas, Quick Setup may be available to implement its basic functionality quickly. A Quick Setup icon
next to a functional area indicates if Quick Setup is available. You can use this task instead of the setup task list to set up
those functional areas.
Setup Tasks
For each functional area, a sequenced list of tasks representing the setup best practices according to your opt-in
configuration of the features is shown to guide you through optimal implementation requirements. Use the tasks to enter the
setup data they represent. Like functional areas, the display order of the tasks always reflects the sequence in which they
should be performed to address setup data dependencies.
Required Tasks
Only the required setup tasks are shown by default to minimize your setup effort and to make the offering ready for
transactions sooner. However, you can also review the rest of the tasks in the list, which are typically optional or have
predefined default values based on common use cases, and decide whether your implementation must change their default
setup data.
If any setup data is segmented by a specific attribute or scope, you may need to perform the task iteratively. If so, you must
select a qualifying scope value prior to performing the task. You can pick a scope value that was previously selected, select a
11
Oracle Applications Cloud Chapter 4
Using Functional Setup Manager Managing Offering Setup
new scope value, or create a new scope value and then select it. The selected value is a qualifying attribute of the setup data
and therefore, different setup data can be entered for the different scope values.
Note: You cannot perform a task if you do not have the proper security privileges.
Step-by-Step Process
Use the Setup and Maintenance work area to directly implement an entire offering or the functional areas within an offering.
Set Up an Offering
To set up an offering using its functional areas, follow these steps.
1. Select Navigator > Setup and Maintenance work area to open the Setup page. You need the Functional Setups
User role.
2. Select the offering you want to implement.
3. Review the list of functional areas. If a functional area is not listed, you did not enable it when configuring the offering
opt-in. If you have access to configure application offerings, you can click Change Feature Opt In to open the Opt
In page. Follow the steps in the Configuring Offerings: Procedure topic to enable the functional area.
4. If you are setting up this offering for the first time, select the functional areas one at a time in the order they are listed.
If you are making changes to existing setup data, select the applicable functional area.
5. If Quick Setup is available for the functional area, then you can use Quick Setup to enter data instead of using the
related setup tasks. Click the icon and proceed.
Note: You need the Perform Quick Setup privilege to perform this step.
6. Select the first task in the list to open the page where setup data for the task is entered. If you are changing existing
setup data, go directly to the relevant task and select it.
12
Oracle Applications Cloud Chapter 4
Using Functional Setup Manager Managing Offering Setup
Note: You need task-specific privileges to perform this step. Refer to the Oracle Applications Cloud
Security Reference for Common Features guide in the All Books for Oracle Cloud page of the Oracle Help
Center (docs.oracle.com) for more details on task-specific privilege requirements.
7. If the task requires a scope, select a scope value before you proceed. If you previously selected a scope value, then
that value is listed in the Scope column. Make sure it is the correct value and if needed, select a different value. You
can create a new value, select and add an existing value, or select one from the list of previously selected values.
Click Apply and Go to Task when you finished your selection.
Note: Unless you change it, the selected scope value is used for all tasks that use the same scope.
8. Enter setup data. When you finish, close the page, which returns you to the setup task list.
9. Continue to select other tasks from the list as needed and enter setup data for them.
13
Oracle Applications Cloud Chapter 4
Using Functional Setup Manager Managing Offering Setup
14
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
Within the task list hierarchy, the tasks are organized according to prerequisite and dependency requirements of the setup
data that they represent. Oracle recommends that you enter setup data in the same sequence as the tasks to avoid errors
due to missing prerequisite data.
You can, however, modify the task list hierarchy if needed by adding, removing, or reordering its tasks. If you modify the
task list hierarchy, you must consider and maintain prerequisite and dependency requirements. Otherwise your users will
encounter errors when using the implementation project either to enter setup data or to export and import setup data to a
different environment.
Any modification you make to an implementation project's task list is strictly applicable to that implementation project
only and doesn't affect any other projects with similar lists of tasks. Modifications to the task list don't affect setup data
represented by the tasks in the list. Once setup data is entered you cannot identify its source, such as which implementation
project or any other method was used to enter or update the data. Likewise, if you remove a task from an implementation
project, any setup data entered using the task continues to exist in the environment unless you explicitly delete the data using
an appropriate user interface.
15
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
1. Select Navigator > Setup and Maintenance work area to open the Setup page. You need the Manage
Implementation Project privilege.
2. From the Setup page, open the panel drawer and select Manage Implementation Projects to open the Manage
Implementation Projects page.
3. Select Create from the actions menu or click the Create icon.
4. Enter a meaningful name and a brief description to describe your project.
5. Optionally, assign the project to a user and specify a start date.
6. Click Next. All offerings and functional areas that you previously enabled are listed.
7. Select the offering and its functional areas you want to use to generate the task list for this project.
8. Click Save and Open Project when you complete your selection.
9. The default task list for the implementation project is generated based on your offering and functional area selection
in the previous step. You can modify the task list if needed, and begin to assign the tasks to the appropriate users.
Add Tasks
To add setup tasks to an implementation project, follow these steps.
1. Select Navigator > Setup and Maintenance work area to open the Setup page.
2. From the Setup page, open the panel drawer and select Manage Implementation Projects to open the Manage
Implementation Projects page.
3. Open the implementation project you want to modify to view its task list hierarchy.
4. Select the task or task list you want to add the new task after and click the Add icon.
5. In the Add Task Lists and Tasks dialog window, search for the task or the task list you want to add, select it, and
then click Apply. Your selection will be added after the task or the task list you selected in the previous step.
6. Repeat search, select, and apply to add additional tasks or task lists if needed. Click Done when you have finished
to return to the implementation project.
7. Repeat the entire process if you need to add more tasks or task lists at other positions in the implementation task list
hierarchy.
16
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
Reorder Tasks
To reorder setup tasks of an implementation project, follow these steps.
1. Select Navigator > Setup and Maintenance work area to open the Setup page.
2. From the Setup page, open the panel drawer and select Manage Implementation Projects to open the Manage
Implementation Projects page.
3. Open the implementation project you want to modify to view its task list hierarchy.
4. Select the task you want to move.
5. Drag and drop the selected task on the task that you want it to appear after in the hierarchy.
You can follow the same steps to move a task list as well.
Remove Tasks
To remove setup tasks from an implementation project, follow these steps.
1. Select Navigator > Setup and Maintenance work area to open the Setup page.
2. From the Setup page, open the panel drawer and select Manage Implementation Projects to open the Manage
Implementation Projects page.
3. Open the implementation project you want to modify to view its task list hierarchy.
4. Select the task or the task list you want to remove.
5. Click the Remove icon. You are asked to confirm whether you want to remove the selected task or task list. If you
confirm, the task or the task list is removed from the task list hierarchy of the implementation project.
Note: When you remove a task any setup data entered using the task won't be removed.
You can reassign tasks to a different user or specify a new due date at any time.
Note: If you assign a task list to a person, then they are assigned to all of the tasks included in the task list.
17
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
You need the Manage Implementation Project privilege to perform this procedure.
Initial Assignment
To assign setup tasks to functional users for the first time, follow these steps:
1. Click Navigator > Setup and Maintenance work area to go to the Setup page.
2. Select Manage Implementation Projects from the panel drawer.
3. In the Manage Implementation Projects page, open the implementation projects whose tasks you want to assign to
users.
4. Select one or more tasks or task lists from the task list hierarchy.
5. Click Assign Tasks to go to the Assign Tasks window.
6. Search and select one or more users to whom you want to assign your selected tasks or task lists and click Apply.
Selected users are added to the Assigned Users table in the Assign Tasks window.
7. Repeat search, select and apply to add additional users if needed. Click Done when you finish adding to return to
the Assign Tasks window.
8. To assign the same due date to all the assigned users, select the Assign same date check box.
9. To assign a different due date to each assigned user, click the Due Date column in the Assigned Users table and
select a due date for each assigned user.
10. Add notes for your assigned users, if necessary. Click Save and Close to return to the implementation project.
Reassignment
To reassign setup tasks from one user to another, follow these steps:
1. Click Navigator > Setup and Maintenance work area to go to the Setup page.
2. Select Manage Implementation Projects from the panel drawer.
3. Click Overview to go to the Implementation Projects: Overview page.
4. From the Assigned Users table, search and select the implementation project whose assignment you want to
change.
5. Click the Assignment Details tab in the Implementation Project Details region.
6. Search and select the task whose assignment you want to change and click Reassign Tasks to go to the Reassign
Tasks window.
7. Select the user to whom you want to reassign the task from the New User menu.
8. Select a new due date if necessary.
9. Click Save and Close to return to the Implementation Projects: Overview page.
10. Repeat the steps to reassign more tasks if necessary.
Note: You must have the proper security privileges to perform a task.
18
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
Predecessor Tasks
Some setup tasks may represent setup data that are a prerequisite for other setup data. These setup tasks are known as the
predecessor tasks.
Your assigned task list will indicate if any of the tasks has dependency on a predecessor task and will provide the following
information:
Adding Notes
You can add a file, URL, or free-format text as notes to your assigned tasks. These notes are accessible not only to you,
but also to the implementation manager and other assignees if multiple users are assigned to the same task. This helps you
communicate and collaborate with others assignees.
Step-by-Step Process
If you are a user to whom setup tasks from an implementation project have been assigned, then a consolidated list of all your
assigned tasks is presented to you. Use each task from the list to enter setup data that the task represents. If you have a long
19
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
list of assigned tasks, you can also filter the list by due date, task status or implementation project name to find a task more
easily. In addition you can search for a specific task in the list by the task name.
Note: You cannot perform a task if you do not have the proper security privileges.
Note: You need task-specific privileges to perform this step. Refer to the Security Reference Guide for
more details on task-specific privilege requirements.
6. If the task requires a scope, then select a scope value. If you previously selected a scope value then that value is
listed in the Scope column. Verify that the correct scope value is selected and if needed, select a different value by
clicking it. You can Create a new value, Select and Add an existing value, or select one from the list of previously
selected values. Click Apply and Go to Task when you finish your selection.
Note: The selected scope value is used for all tasks that use the same scope unless you change it.
7. Enter the setup data. When you finish, close the page to return to the setup task list.
8. Click the icon in the Status column to change status
9. Click the number in the Notes column to add a note if necessary.
10. Select other tasks from the list and repeat the steps to enter setup data for them.
Assignment by Status
This pie chart shows the statuses of the assigned tasks as percentages of the total number of tasks in the implementation
project. The pie chart also shows the actual number of tasks with the specific status. The task statuses are predefined and
used to indicate the progress. The available statuses are as follows:
• Not Started
• In Progress
• Completed
• Execution Frozen
• Submitted
• Completed with Errors
• Completed with Warnings
20
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
21
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
◦ Click the Assignment Status tab to view the Assignment by Status and the Assignment by Due Date reports.
◦ Click the Assignment Status by Task Lists tab to view the Assignment Status by Task List report.
◦ Click the Resource Status tab to view the Top 5 Assigned Users with Incomplete Tasks by Due Dates and the
Top 5 Task Allocations reports.
22
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
23
Oracle Applications Cloud Chapter 5
Using Functional Setup Manager Managing Setup Using Implementation Projects
24
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
25
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
Step-by-Step Process
Sometimes the setup data you must enter is very simple or similar to existing data which you can duplicate. In such cases,
you can use a CSV file to enter setup data. This procedure explains how to enter setup data using a CSV file.
You need the following privileges to perform this procedure:
• Submit Export Setup Data Process privilege
• Submit Import Setup Data Process privilege
• Task-specific privileges
Refer to the Security Reference Manual for detailed information about task-specific privileges.
Note: The Export to CSV file option is disabled if the task does not support export.
6. Select Create New. You can export all existing setup data represented by the task.
◦ If Scope is supported for the task, you can select appropriate scope values to filter the setup data you want to
export.
◦ You can also download the template without exporting the existing setup data in the environment. To do so,
select the Export only template files check box.
7. Click Submit to start the export process.
8. Select Export to CSV file to see the latest process. Monitor the process until it completes.
9. Select the process once it completes to review the results. Verify that the process completed without any errors
before you download and extract the CSV file.
Note: You may find more than one CSV file if there are more than one business object associated with
the task.
26
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
After you complete making modification to the staged setup data, submit an import process which creates the new setup
configuration by copying setup data from the original and changing the data where applicable based on the modifications you
made.
Once the import process completes, Oracle recommends that you review your new setup configuration to ensure it meets
your requirements. You can also make additional changes to the data of the new setup if needed.
27
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
The following figure illustrates the steps in the copy configuration process.
Create Copy
Edit Staged Import Staged
Configuration
Configuration Configuration
Request
Refer to the Security Reference Manual for detailed information about task-specific privileges.
28
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
a. Click Ready to import in the Status column in the Copy Configuration Requests table when the status
updates.
b. The same set of attributes shown in the previous step is displayed for your final review. You can compare the
values of the source setup with the values of the new setup. Select Edit to make modifications if necessary.
Note: You cannot edit the values after the new setup is created.
c. Click Import to load the staged setup configuration and to return to the Copy Configurations page.
d. The Status column of Copy Configuration Requests table now shows Import in progress. Click the link
to monitor the import process. To get updated information click the Refresh icon.
6. To fix copy setup configuration errors,
a. Click Ready to fix errors in the Status column in the Copy Configuration Requests table.
b. Review the report and identify where the error occurred. The report lists all business objects in the order they
were processed.
• If the error is due to data conflicts such as attempting to create an object that already exists, use Edit
Staged Configuration to fix the error and resubmit the import process.
• Otherwise, report the issue to your help desk indicating the owning product as indicated in the error.
Download and attach the process status details report when reporting the issue.
7. To review the copied setup configuration,
a. When the import process completes successfully, the Status column is set to Ready to review. Use the link
to review the copied setup configuration. You can select the Go to Task icon for each setup task displayed to
verify accuracy of the setup data.
Use this method of managing setup data cautiously, as it does not give you visibility to the setup data dependencies and
recommended sequence of performing tasks. This may cause you to experience errors.
1. Click Navigator > Setup and Maintenance work area to go to the Setup page.
2. Select Search from the panel drawer to go to the Search page.
29
Oracle Applications Cloud Chapter 6
Using Functional Setup Manager Managing Setup Using Alternative Processes
3. Enter a string that matches the complete or partial name of the task and click Search.
The string is matched with the names of tasks, lists and business objects by default.
4. Click the Tasks, Task Lists, Business Objects link to change the matching criteria. Select the criteria from the
available options and click Done.
5. From the search results,
◦ If you matched with task, click the link in the Name column to go to the page for entering the setup data it
represents.
◦ If you matched with task list or business object name, click the link in the Name column to go to a list of tasks
that are associated with the task list or business object. Follow the actions in the previous step to manage the
setup data of each task in the list.
◦ If you matched with functional area, click the link in the Name column to go to a list of the parent offerings of
the functional area. Select the applicable offering to find the list of tasks in the task region. Follow the actions
in the previous step to manage the setup data of each task in the list.
◦ If you matched with offering name, click the link in the Name column to go to the offering. Follow the actions
in Managing Offering Setup: Procedure to manage the setup data of the offering.
Related Topics
• Setting Up Offerings: Procedure
30
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
You can export and import setup data for your implementation depending on your business needs using any of the methods
described here. You must import the setup data in the same way that you export it.
• Export and import an entire offering or any of its functional areas. This method is recommended when you want to
make sure all the setup data for an offering or functional area is migrated as it currently configured.
• Export and import an implementation project that contains a modified configuration or list of tasks. Use an
implementation project as the source for exporting setup data when you require modifications to the list of tasks or
the list of objects you want to export setup data for.
In the case of an offering or functional area, setup data is exported only for the tasks relevant to the features that are enabled
for implementation in the offering or functional area. Unlike the case of export an offering or functional area, an implementation
project may also include tasks for an entire offering or a functional area but the list of tasks may have been modified to
specific needs by adding or removing some of the tasks.
Note: Check with the product owner to validate if a task supports CSV export or import that you may require.
31
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
You can generate the setup export and import definition implicitly or explicitly:
• A configuration package is created implicitly when you export setup data for an entire offering or any functional area.
• A configuration package is created explicitly when you export setup data based on an implementation project. This
method enables further modification of the configuration packages.
You generate the setup export and import definition by selecting an implementation project and creating a configuration
package. The tasks and their associated business objects in the selected implementation project define the setup export
and import definition for the configuration package. In addition, the sequence of the tasks in the implementation project
determines the export and import sequence.
The tasks and their associated business objects in the selected configuration (offering, functional area or implementation
project) define the setup export and import definition for the configuration package. In addition, the sequence of the tasks in
the implementation project determines the export and import sequence.
Once a configuration package is exported, the setup export and import definition is locked and cannot be changed. You
cannot change the add or remove tasks and their associated business objects, change their export and import sequence, or
change the scope value selection. However, you can create a new configuration package with such modifications at any time.
The application assigns the lowest import sequence number to the business objects associated to the first task and increases
the sequence number for the successive tasks.
Note: When you create an implementation project and modify the list of tasks, you must consider the
dependencies between the setup data. It is strongly recommended that you have no more than one offering in
an implementation project. This ensures that import and export of the setup data is straightforward and that the
export and import sequence is correct.
Note: You can change the default import sequence when creating your configuration package if you are fully
aware that such changes do not result in data dependency failures during import.
The following business objects are exceptions to the default task-based sequence rule and they are always exported and
imported before any other business objects in this sequence:
32
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
Application Reference Data Set FND_ APP_ REFERENCE_ DATA_ SET_ ASSIGNMENT
Assignment
33
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
Note: The definition of the configuration package is unchanged once you create it. Therefore you
can change the feature selection for your configuration and it will not impact the existing configuration
packages.
2. Then, Functional Setup Manager identifies all business objects associated to the tasks within such configuration and
assign them a sequence for the purpose of export or import their setup data. This sequence is congruent to the task
sequence used to enter the setup data for such configuration.
3. The application assigns the lowest import sequence number to the business objects associated to the first task and
increases the sequence number for the successive tasks.
4. Functional Setup Manager processes the business objects in the list based on the import sequence. Functional
Setup Manager identifies the service associated to the business object, invokes the service to export the setup data
and returns the results. The business object is then marked as processed and Functional Setup Manager continues
with the next business object in the list. If no service is available, then the business object is marked as requiring
manual data loading and continues with the next business object in the list.
5. The setup data of some business objects may be processed by the same service, and hence the service exports
the setup data for all the relevant business objects that shares it. Because the service takes care of all the relevant
setup data at once, it only must be invoked once during the process; therefore, Functional Setup Manager marks as
processed and with the same result, any other business objects sharing the same service.
6. All the scope parameters defined for the configuration being exported are passed to each service in the list when
invoked. Each service handles and uses only the scope parameters relevant to its logic and exports the setup data.
7. Finally, after completing the list, Functional Setup Manager consolidates the setup data returned by each service into
a compressed file known as the configuration package file. Functional Setup Manager also consolidates all the errors
returned by the services while processing the setup data and generates the appropriate summary report.
34
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
ensure all your configuration setup data is migrated but you do not have to perform prior or during the import
necessarily.
Depending on the method used to import the setup data, you first have to upload the configuration package file created by
the export process prior to initiate the import process. During the import, this file is read to identify all the business objects
which setup data is included in it. Once the import process is initiated, it warns users to perform the task recommended
performing prior to import. Once user decides to continue, Functional Setup Manager starts invoking the business object
services based on the import sequence assigned to the business objects in such configuration and processes the setup data
as follows:
• Setup data records that exist in the configuration package but do not exist in the target environment are inserted.
• For setup data records that exist in both the configuration package and the target environment,
◦ If the attribute values are different, then import updates the record in the target environment with the values
from the configuration package.
◦ If the attribute values are the same, then import leaves the record unchanged.
• Setup data records that exist in the target environment but do not exist in the configuration package, are untouched
in the target environment. Importing data does not delete any existing data.
When required, the import process pauses, giving you the appropriate information and suggested actions. Resume the
import process after taking the appropriate actions.
• If a setup import process paused due to errors encountered, then review the errors and take appropriate actions to
correct the data or fix the issue, and then resume the process. The process resumes processing data for the failed
object. However, you have the option to skip the failed object and continue processing data for the next business
object in the list.
• If a setup import process paused due to a manual task to be performed outside of the application, then you perform
the task and resume the paused process.
The import setup data process continues until all the services for importing the setup data are complete or user has stopped
or canceled the process. Services perform an update and insert operation. That is, existing rows that are identical to the data
being imported are ignored, existing rows that have differences are updated, and new rows are inserted. Each service is
invoked once and imports all the setup data for the relevant business objects that share it. Any dependencies that may exist
between the business objects that share a business object service are taken care and resolved by the service itself.
35
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
Note: If a user creates a row in source, then creates the same row in target, and later uses export or import to
move the data, the import may fail due to conflicting alternate keys for the same row.
Note: Only a configuration package file that contains data verified in the test instance should be
imported into the production instance.
2. Use comparison reports to review potential setup changes before submitting the import process.
◦Importing data into a target (production) instance will insert and update rows, but it will not delete any existing
data. Use comparison reports between source (test) and target (production) configuration packages to identify
data that only exists in the target (production) instance, and use the appropriate setup task to delete any data
if and when necessary.
3. Perform tasks marked for pre-import.
4. Submit the import process:
◦ Load the necessary data manually when the import process pauses on a specific business object indicating
manual import pending before resuming the process. Business objects that pause during an import process
have downstream dependencies which may fail if manual actions are not taken at the appropriate time.
◦ Use export and import process status details (looking at the UI, reports, and logs) to review any errors and
either fix the data in source and re-import, or report any unexpected behavior to My Oracle Support.
36
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
Note: To refresh the test instance completely with both the setup and transactional data from the
production instance, always use a reverse production-to-test process to synchronize the test to
production instances before performing incremental setup in the test instance.
• Create the implementation project with the appropriate tasks for the configuration you want to migrate.
• Make sure that all prerequisite data for your configuration is available in the environment where you are planning
to migrate the setup data. For example, If you require a legal entity to exist before you migrate the setup data for a
business unit configuration and the prerequisite setup data does not exist, consider to adding it to the configuration
package you use to import.
• The sequence of the tasks and therefore the business objects in your configuration should align with the business
object dependencies and prerequisites. Oracle delivered task lists have been designed with this in mind to avoid
errors while running import.
• You may also refine the scope of the data you want to export or import while creating your configuration package by
defining the scope selection. Be aware that scope selection is not available to all business objects. Check that the
business object service supports it. Check the application documentation or verify it from the application at the time
you are defining your configuration package. A select and add icon is enabled on the scope table once you select
the corresponding business object.
• During an incremental migration, all the setup data in the configuration package is processed inserting all new data
records and updating existing setup data records according to service logic. No data is removed during the import
process unless otherwise specified by the service. Consult the application release notes to review any exceptions on
handling the setup data by the service.
37
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
38
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
China Ledger Option Enterprise Financial Data Export Options Management for China
China Depreciation Method Formula Enterprise Financial Data Export Options Management for China
China Financial Information Option Enterprise Financial Data Export Options Management for China
China Golden Tax Miscellaneous Option Golden Tax Administration for China
China Value Added Tax Invoice Option Golden Tax Administration for China
39
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
4 Financials Financials
9 CRM Marketing
10 CRM Sales
11 Procurement Procurement
40
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
When does export or import show errors at the data level as opposed
to the system level?
An error at the business object level occurs if the setup export and import web services cannot start. For example, if a service
cannot be found in the specified location where it is registered or access is denied to the service then the application raises
an error. In general, errors occur at the system level. However, data level errors may also occur depending on how the web
services are designed.
Why did the export process not raise any errors when it did not
export any data?
Sometimes no data exports for a business object even though the process completes successfully without any errors. This
happens when only Oracle Fusion Applications predefined setup data exists in the business object. Setup export and import
41
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
exclude Oracle Fusion Applications predefined setup data. A message indicating that no rows were processed and no failures
occurred during export displays when the export process completes.
A child or dependent business object can have one and only one parent, while a parent business object may have multiple
children.
42
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
What happens when I resume the import setup data process without
loading the requested data?
Errors may occur later while importing setup data for other objects that depend on the business object you suppose to
manually import data for. However, if the setup data already exists in the environment due to was previously imported, you
can resume the process without any issues.
Can I run the Import Setup Data process without pausing and obtain
a report of all errors at the end?
Yes. To do so, make sure to unmark the option Pause each time an error occurs when submitting or resuming the Import
Setup Data process. After the process finishes, review the process results to get the error details. The import processes all
the business objects but it may still pause with status User Action Required if any business object requires manual import.
You can identify what objects require prior manual data import, if any, and force the process to run without pausing for
manual import. To do so, navigate to the Pause for External Import step when submitting the import setup data process,
then identify all business objects marked for pause and deselect them.
43
Oracle Applications Cloud Chapter 7
Using Functional Setup Manager Exporting and Importing Setup Data: Overview
44
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
Export and import offering setup data processes are initiated from the Setup and Maintenance work area.
Export
During export, appropriate setup data will be identified as follows:
• When you export setup data for an offering, the export definition will include setup data for all enabled functional
areas and relevant features in the offering.
• When you export setup data for a single functional area within an offering, the export definition will only include setup
data for that functional area and relevant features.
Import
During import, a configuration package created by the export process is uploaded. All setup data contained in the
configuration package is imported into the environment you initiate the setup data import from.
Similarly to the export process, you can import setup data for an entire offering or a specific functional area. The offering
and functional area must already enabled for implementation before you can import setup data for it. However, the feature
selection may or may not be selected. To ensure enabling of that the same functionality that existed in the environment where
the setup data was exported from for the corresponding offering or functional area, use the option to import the feature
selection at the time of importing the setup data. You must use a configuration package file that contains the setup data for
the appropriate offering or functional area. You also have the option to compare the setup data prior to import to identify what
setup data modifications will happen if the setup data is imported. You can also compare the setup data after it has been
imported (rather than prior to import) in order to ensure that no differences exist. One you initiate the import process, you can
monitor its progress and check its status from the Export Offering page. Once the process is complete you can review the
reports. Similarly, use the Import Offering Setup Data page to upload and import previously exported setup data.
45
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
Video
Watch: This video tutorial shows you how to export offering setup data from your application instance for future importing into
another environment. The content of this video is also covered in text topics.
Step-by-Step Process
You can export setup data for an offering or functional area that you already completed setting up.
a. Select the business object from the Business Objects table and then click the Add button.
b. Search and select the value you want to filter the data and click Apply.
c. Repeat the step above to add additional values as needed, otherwise, select Done.
6. Click Submit to start the export process.
7. Monitor the process until it completes. Select Export from the Actions menu. The latest process will be shown at the
beginning of the list.
8. Click the process link once it completes to review the results.
9. Review the list of Post-Export Tasks for any task of the selected offering for which setup data is not migrated by the
export process. If applicable, you need to perform those manually in the target environment.
10. Download the Zip file and use it to import the setup data in the target environment where the implementation is
migrated.
11. If the setup data of any of the functional areas change in the future, you can migrate the setup data of the specific
functional area rather than the entire offering. Select the appropriate functional area and then in the Actions menu for
the functional area, select Export > Create New.
12. As the default all existing setup data represented by the tasks of the selected functional area is exported. Follow the
same steps described previously for the offering to export data for the functional area.
46
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
Step-by-Step Process
You can import setup data for an offering or functional area.
47
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
e. After reviewing all the discrepancies, select Continue to Import to start the import process. Otherwise, select
Cancel Process from the Actions to cancel the process.
11. If any setup data is required during import, the process pauses with the status of Waiting for manual import.
a. Click the status to review the details of what setup data is required.
b. Enter the appropriate setup data by performing the task. Click Go to Tasks.
c. Once you entered the setup data for all of the relevant tasks, return to the Import Offering Data Results page
and resume the process.
d. Confirm you entered the data and the process will resume.
12. Continue monitoring the process until it completes. Click the status once the process completes.
13. Verify that the process completed successfully. If there are any post-import tasks reported, make sure that the
corresponding setup data is entered before making the offering available to the end users.
14. If the process completed with errors, review the status details for each of the failing business objects and take the
appropriate action.
48
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
5. Open the Status menu and select In progress to filter the contents of the Object Details table on the Export and
Import process results page.
The name of the business object currently being processed is displayed.
49
Oracle Applications Cloud Chapter 8
Using Functional Setup Manager Exporting and Importing Offering Setup Data
50
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
• Exclude some of the business objects from the configuration you selected to export setup data for.
You should limit to use this option when the corresponding setup data is already available in the target instance and
therefore no data dependency issues appear during import.
• Change the default import sequence of the business objects
It's strongly recommended that you limit using this option when you need to correct a data dependency issue and
you fully understand the data relationships between the business objects of your configuration.
• Filter the setup data to export
Export
During export, appropriate setup data is identified based on the tasks in the implementation project used as source for
the configuration package. The setup data in the configuration package is a snapshot of the data in the source application
instance at the time of export. Once export completes, you can download the configuration package file as a zipped archive
of multiple XML files, move it to the target application instance, and upload and import it. After exporting the setup data
you may continue entering new or modifying existing setup data for your configuration. Since the configuration package
is a snapshot of the setup data taken at the time export is initiated, you may need to take another snapshot of the same
configuration or set of data later. Although you can always create a different configuration package, Functional Setup
Manager provides you the ability to take another snapshot of the setup data using the same modified export and import
definition by exporting the configuration package multiple times and creating multiple versions. While the export definition
remains the same in each version, the setup data can be different if you modified the data in the time period between the
different runs of the export process. Since each version of the configuration package has a snapshot of the data in the source
instance, you can compare and analyze various versions of the configuration package to see how the setup data changed.
Import
During import, you first upload a configuration package created by the export process and then import the setup data. All
setup data contained in the configuration package is imported into the environment you initiate the setup data import from.
In the target application instance, the setup import process inserts all new data from the source configuration package that
51
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
does not already exist, and update any existing data with changes from the source. Setup data that exists in the target
instance but not in source will remain unchanged.
Note: Business objects that are used as scope parameters for data filtering do not appear when creating a
configuration package for an offering or functional area.
52
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
Example
Receivable data may be filtered by subledger, (subledger may have been defined as the scope parameter for receivable
data). Even if subledger is not associated with any tasks in the Receivables configuration you selected to export, you have the
option to filter receivables data associated to certain subledgers during export. You find the subledger business object listed
as scope parameter even though subledger data does not exported.
Step-by-Step Process
You can export setup data for an implementation project that you already completed setting up.
1. Sign in to the environment where the setup data to export is available and select Navigator > Setup and
Maintenance work area to open the Setup page. You need the Application Implementation Consultant role to
export setup data.
2. From the Setup page, open the panel drawer and select Manage Configuration Packages to open the Manage
Configuration Packages page.
3. From the Actions menu on the Manage Configuration Packages page, select Create New.
4. From the Name list of values under the Source Implementation Project, select the implementation project that
contains the setup data to be exported. The Basic Information section contains information that you can modify as
needed.
5. Click Next. As the default all existing setup data represented by the tasks of the selected implementation project is
exported.
53
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
6. Optionally, if scope is supported, then you can select the appropriate scope values to filter the exported setup data.
a. Select the business object from the Business Objects table and then click the Add button on the Scope
table..
b. Search and select the value you want to filter the data and click Apply. Click Done when you finished.
c. Repeat the steps above for additional business objects you want to use as a parameter to filter setup data.
7. Submit the process to export the setup data. However, you can optionally, and only when strictly required, change
the import sequence of the business object or exclude business objects from export.
a. Select the business object and click the Import Sequence attribute until it becomes editable. Enter a unique
value for the import sequence. Move out of the field and dismiss the warning after confirming you are aware of
the impact.
b. Select the business object and click the Export attribute until it becomes editable. Deselect the Export check
box. Move out of the field and dismiss the warning after confirming you are aware of the impact.
c. Repeat the same step for any other object as needed.
8. Click Next to continue. As the default, the process runs as soon as it's submitted, however, you can also schedule it
at a specific time.
9. Click Submit to start the export process. A warning message displays indicating that the configuration package
definition can no longer be modified after submitted. Click Yes to continue. The new configuration package will be
listed at the beginning of the table.
10. Monitor the process until it completes. Click Refresh on the Import and Export Processes table to refresh the
process status.
11. Once it completes successfully, download the setup data file. Select the export process, click Download and then
select Download Configuration Package. Save the file.
12. Review the results details for any required post-export task:
a. Select the export process, and click the status. The Export and Import Process Results page opens.
b. From the Status menu, select Manual Export Pending. The tasks whose setup data is not migrated by the
export process is listed and you need to plan to perform those manually in the target environment.
13. If setup data in the implementation project changes in the future, you can export the setup data using the same
configuration package, rather than creating another, as long as the setup data scope does not change.
a. Select the appropriate configuration package and then select Export Setup Data.
b. Monitor the process following the same steps described previously.
54
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
Step-by-Step Process
You can import setup data for an implementation project.
55
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
c. If successful, check for post import tasks, by opening the Status menu and select Data Loading Pending.
The tasks whose setup data is not migrated by the import process are listed and you must plan to perform
those manually in the environment.
d. If completed with errors, open the Status menu and select Completed with Errors. Review the status details
of the corresponding objects and take the appropriate corrective action. Once you fix the errors, you can
resubmit the import process again.
How can I view and print any errors generated by an import or export
process?
Download and then view or print the Export Results Report or the Import Results Report for the relevant process.
56
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
How can I cancel an export or import offering setup data process that
I submitted?
Select the process you want to cancel and click Cancel Process. Once you confirm to cancel the process, it completes
processing the business object that already started and does not process the remaining business objects. The process status
is changed to Canceled and you are not able to resume the process.
57
Oracle Applications Cloud Chapter 9
Using Functional Setup Manager Exporting and Importing Setup Data for Implementation
Projects
The name of the business object currently being processed displays in the table.
For an offering based export or import process initiated from the Setup page:
The name of the business object currently being processed displays in the table.
58
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
You can use Setup data comparison to learn how data for a given implementation has changed over time. For instance:
• Prior to importing the setup data into the production environment, you would want to identify the setup data changes
that may occur if the new configuration is imported, to prevent undesirable overwrites. To do so, compare the setup
data prior to importing and based on the results, decide whether to import the new configuration or not.
• In other cases, you may also want to compare the setup data to identify the changes made over time, to identify the
potential causes of your application's new behavior or an issue.
• An implementation may have been done in phases and some of the original configuration modified. You can track
the changes over time through different versions of the same configuration package, or different configuration
packages.
Once you identify the setup data differences or discrepancies, you can decide how to resolve them. You can import the setup
data from the configuration package into the environment if the implementation matches what is in the configuration package.
You can also resolve the discrepancies for a given record or business object by editing the setup data through the relevant
task.
The setup data comparison functionality helps you speed up the process of identifying the differences among one or multiple
business objects relevant to a configuration. The comparison identifies which records are common to either configuration
packages' alternate key matching. The report shows any data differences in the records with matching alternate keys. If
alternate keys are not defined for the business object, then the entire data record is compared in the report.
Note: Alternate key definition depends on the specific design of the business objects owning product or
product family, and is not controlled by the application.
You can compare setup data for an offering, functional area or between two different configuration packages or two versions
of the same configuration package generated for an implementation project.
Comparison always requires two sources of the same configuration to compare setup data. However, if you want to compare
setup data before import while submitting an import offering setup data process, you need not explicitly specify the sources.
The comparison takes the configuration package for import as one source and the environment where you are importing the
setup data as the second source.
59
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
• Identifies the business objects that contain setup data in each source (configuration package or version).
• Identifies the business objects common to both sources. The setup data for business objects that are not common
to both sources is not compared.
• For each of the common business objects, the data records are compared by using the alternate keys and classified
in 3 categories:
◦ A record in which alternate key values match in both sources are classified as a common record.
◦ A record in source 1 without a match in source 2 is marked as a discrepancy and reported to exist Only in
source 1.
◦ A record in source 2 without a match in source 1 is marked as a discrepancy and reported to exist Only in
source 2.
Note: If no alternate keys are defined for the business object or if the alternate key is not unique, then the
entire record is compared.
• Then identifies the discrepancies in the common records by comparing each attribute value of the common data
records:
◦ If one or more of the attribute values differ, a discrepancy is reported and classified as In Both With
Mismatch. This indicates that the setup data that was updated.
◦ If all the attribute values match between both sources, there is no discrepancy and the record is classified as
identical.
60
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
1. Click Navigator > Setup and Maintenance work area to open the Setup page.
2. Select the offering whose setup data you want to compare.
3. Select Compare Setup Data > Create New from the Actions menu for the offering or functional area.
4. Select the configuration package that contains the prior setup data version you want to compare against the setup
data currently available in the environment. If the configuration package is not available in the environment, click
Upload new to upload it.
Note: An error message appears if the selected configuration package does not contain setup data for
the corresponding offering or functional area.
5. Optionally, you can edit the default process name for easy identification.
6. Click Submit to initiate the process. Dismiss the confirmation message.
7. Monitor the process progress until it completes. Select Compare Setup Data from the Actions menu. The latest
process appears first.
8. Once it completes, you can select the process name to view the complete results.
◦Select the Only in Configuration 1 column to determine which records do not exist in the environment
and therefore, must be created in the production if this configuration package is imported. Select the
corresponding business object to review.
◦ Select the In Both with Mismatch column to review the records that exist in both the configuration package
and the environment, but have different attribute values. Select the corresponding business object to review.
The report contains two rows for each matching record: The first row shows the values from the configuration
package and the second row shows the values from the environment. Values are only presented for the
attributes with discrepancies, so they can be easily identified.
◦ Select the Only in Configuration 2 column to determine which records exist only in the environment and not
in the configuration package. The import process does not delete any records and therefore these records
remain untouched in the environment. Select the corresponding business object to review.
9. Review the discrepancies and decide whether or not to make modifications to the current setup data in the
environment according to your business needs.
61
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
Step-by-Step Process
To compare setup data of an existing configuration package with data in a current environment, export the setup data for the
current environment into a new configuration package or a new version prior to initiate the comparison.
You need the Application Implementation Consultant role to export setup data.
1. Click Navigator > Setup and Maintenance work area to open the Setup page.
2. Select Manage Export and Import Processes from the panel drawer in the Setup and Maintenance work area.
3. Verify that both configuration packages are available and then select Compare on the Export and Import Processes
page. You can also compare two available versions of the same configuration package.
4. You can view an existing comparison or create a new one from the Comparison Process page.
5. To create a new comparison, select Create and select the two configuration packages for comparison. Make sure
to select the correct Process Dates.
6. Name the comparison process for easy identification, select Submit, and then refresh the Comparison Process
page to monitor the progress of the comparison until it completes. You can view the process results while it is in
process by selecting the In Process status message.
7. Once the process is complete you can select the process name to view the complete results.
62
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
8. The comparison results are displayed. The two configuration package names appear in the Compared Configuration
Packages region. The objects with setup data discrepancies are listed by default.
a. Select the Only in Source 1 column to determine which records do not exist in the configuration package
selected as source. Select the corresponding business object to review.
b. Select the In Both with Mismatch column to review the records that exist in both sources but have different
attribute values. Select the corresponding business object to review. The report contains two rows for each
matching record: the first row shows the values from the first source and the second row shows the values
from the second source. Values are only presented for the attributes with discrepancies, so they can be easily
identified.
c. Select the Only in Source 2 column to determine which records only exist in the configuration package
selected as source 2. Select the corresponding business object to review.
9. You can click Download to download the report. Once you finish reviewing the discrepancies, you can decide which
configuration package to use, or what data to modify in the current environment.
63
Oracle Applications Cloud Chapter 10
Using Functional Setup Manager Comparing Setup Data
64
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
11 Reference
1. Set up prerequisites
2. Export data from the source
3. Import data on the target
To gather the implementation codes using Oracle Fusion Functional Setup Manager:
1. Sign in to Oracle Fusion Applications with a user account that is provisioned with the necessary role, such as the
predefined Application Implementation Consultant role. Contact your security administrator for details.
2. From the Administration menu in the work area of Oracle Fusion Applications, select Setup and Maintenance.
3. In the Tasks pane, under the Implementations group, click Manage Implementation Projects.
4. Click an implementation project name in the Search Results. The Implementation Project page is displayed.
5. In the Basic Information section, copy the value for the Code field. Make sure to perform steps 4 and 5 for each
project you want to export.
6. Ensure all the Managed Servers are started in the environment.
65
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
(UNIX) ATGPF_ORACLE_HOME/fsm/scripts
(Windows) ATGPF_ORACLE_HOME\fsm\scripts
ATGPF_ORACLE_HOME is located under the fusionapps Oracle Fusion Middleware home directory
(FA_MW_HOME).
3. Enter fsmConfigurationPackageExport.sh (for UNIX) or fsmConfigurationPackageExport.cmd (for Windows), using
the following syntax:
fsmConfigurationPackageExport
commonDomainInternalUrl=http://host.domain:port
jdbcUrl=jdbc:oracle:thin:@DB_host_name.domain/sid
fusionRuntimeSchema=fusion_runtime
fusionRuntimeSchemaPasswordFile=USER_HOME/fusionRuntimeSchemaPassword.txt
fsmUsername=user
fsmPasswordFile=USER_HOME/fusionRuntimeSchemaPassword.txt
implementationProjectCode=IMPLEMENTATION_PROJECT_CODE_TO_EXPORT
configurationPackageFile=USER_HOME/cp.zip
logFile=USER_HOME/log_file
jpsConfig=COMMON_DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml
mwHomeLoc=MW_HOME
atgpfHomeLoc=ATGPF_ORACLE_HOME
[pollingInterval=interval]
[pollingLimit=limit]
66
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
67
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
1. For either UNIX or Windows, at an operating system command prompt, navigate to the location of the
fsmConfigurationPackageImport executable:
(UNIX) ATGPF_ORACLE_HOME/fsm/scripts
(Windows) ATGPF_ORACLE_HOME\fsm\scripts
ATGPF_ORACLE_HOME is located under the fusionapps Oracle Fusion Middleware home directory
(FA_MW_HOME).
2. Enter fsmConfigurationPackageImport.sh (for UNIX) or fsmConfigurationPackageImport.cmd (for Windows), using
the following syntax:
fsmConfigurationPackageImport
commonDomainInternalUrl=http://host.domain:port
jdbcUrl=jdbc:oracle:thin:@DB_host_name.domain/sid
fusionRuntimeSchema=fusion_runtime
fusionRuntimeSchemaPasswordFile=USER_HOME/fusionRuntimeSchemaPassword.txt
fsmUsername=FUSION
fsmPasswordFile=USER_HOME/fusionRuntimeSchemaPassword.txt
configurationPackageFile=USER_HOME/cp.zip
logFile=USER_HOME/cpImport.log
68
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
jpsConfig=COMMON_DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml
mwHomeLoc=MW_HOME
atgpfHomeLoc=ATGPF_ORACLE_HOME
69
Oracle Applications Cloud Chapter 11
Using Functional Setup Manager Reference
70