Professional Documents
Culture Documents
Use Oracle Visual Builder Add-In For Excel To Create Purchase Requisitions
Use Oracle Visual Builder Add-In For Excel To Create Purchase Requisitions
JANUARY 7, 2022
DISCLAIMER
The following is intended to outline our general product direction. It is intended for information
purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in making purchasing decisions. The
development, release, and timing of any features or functionality described for Oracle’s products
remains at the sole discretion of Oracle.
2 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Table of Contents
Introduction .................................................................................................. 5
Hide Projects Descriptive Flexfields in the Requisition Distributions Table Layout .................... 25
Reconfigure the Fields in the Requisition Header & Lines Worksheet ....................................... 26
3 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Cancel Specific Requisition Lines/Cancel Requisition ................................................................ 36
References for the Oracle Visual Builder Add-in for Excel ........................ 39
4 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
INTRODUCTION
For any procurement organization in a company, creating purchase requisitions to procure goods
and services is a core business process. Oracle Fusion Self Service Procurement Cloud supports
various modes of creation of purchase requisitions. Here's is the list of purchase requisition
creation modes, with their primary use cases, that we support:
o System Integration
• User-friendly Excel interface to interact with the Purchase Requisitions REST API.
5 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
• Robust error reporting and handling at the excel spreadsheet layer
The Oracle Visual Builder Add-in for Excel feature integrates MS Excel spreadsheets with REST services to retrieve, analyze, and edit
data using REST services.
After the Add-in is configured to the REST service for a business entity, it can be efficiently used to download data for the entity and
perform operations such as create, update, and delete on the data using MS Excel. You can perform any custom operations supported
by the REST API as per business needs.
Requisition Headers & Form over Table • Download and View requisition header and lines
Lines Layout • Add/Update header and line level descriptive flexfields information
• Create/Update requisition header and lines in a single upload
• Delete requisition lines from a requisition
• Perform custom operations
• Add/Update header and line level descriptive flexfields information
• Create/Update requisition header and lines in a single upload
• Delete requisition lines from a requisition
• Perform these custom operations:
• Create default distributions for a requisition
• Calculate tax and derive charge accounts
• Submit requisitions for approval
• Cancel requisitions
6 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
• Cancel individual requisition lines
Requisition Table Layout • View all distributions across lines for the requisition
Distributions • Create/Update/Delete distributions for one or more lines
• Update distribution descriptive flexfields information
• Update projects descriptive flexfields information
Security
Add-in Options
You can perform configuration and data operations using the different menu options available on the Add-in template. In this section,
we introduce the options and their function.
This screenshot highlights the different buttons/tabs available on the Add-in template.
7 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 2 Oracle Visual Builder Add-in menu options.
• Designer (1): Opens the Layout Designer Pane (1A) that has multiple tabs:
– Query Tab (1B): You can use the Query tab to set data filters based on multiple attributes before downloading data. It can also be
used to apply REST finders.
– Form Tab (1C): Displays options to add, edit, and delete form fields.
– Table Tab (1D): Displays options to add, edit, and delete table fields.
• Download Data (2): Downloads Data for the object(s) in the spreadsheet.
• Table Row Changes (3): Displays options to Create (Insert Rows), Update (Mark as changed), Delete (Mark for Delete), and
Perform custom action (Mark for Action) menu options.
• Upload Changes (4): Uploads the changes to the data to the application.
• Form Row Changes (5): Displays options to Create Form Row and Perform custom action (Mark for Action) menu options.
Applicable to Form-Over-Table Layouts only.
8 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
HOW YOU CAN CONFIGURE THE EXCEL ADD-IN
Advanced Menu
4. On the Service Configuration dialog window, provide the service host name. For example: https://hostname.oraclecloud.com
Figure 3 Configure the cloud instance service host using Advanced menu.
Manage Catalogs
2. On the Manage Business Object Catalogs dialog window, click purchaseRequisitions, and then click the Edit icon.
3. On the Business Object Catalog Editor dialog window, provide the service host name. For example:
https://hostname.oraclecloud.com
4. Click Done.
9 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 4 Configure the service host using Manage Catalogs
Note: You can't show or hide individual descriptive flexfields. When you enable descriptive flexfields context, global segments,
Context, and context sensitive segments will be shown in the same order. This order cannot be changed either.
2. On the Manage Business Object Catalog dialog box, click the purchaseRequisitions catalog name.
4. In the Web Address field, provide the Purchase Requisition REST endpoint URL. For example:
https://hostname.oraclecloud.com/fscmRestApi/resources/latest/purchaseRequisitions/describe
5. Click OK.
10 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 5 Refresh purchase requisitions business object definition using Manage Catalogs
You can follow these steps to check the descriptive flexfields in your Oracle Fusion Web Application:
a. Procurement offering
2. Click POR_REQUISITION_HEADERS.
3. To check the requisition header descriptive flexfields, click the Edit icon.
• Context Sensitive Segments: Different sensitive segments based on the Territory selected
11 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 6 Context segment setup for requisition headers descriptive flexfields in the application.
For our example, descriptive flexfields for the requisition header will be represented by the Context Segment Territory.
To add header descriptive flexfields to the form layout, follow these steps:
12 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 7 Select Add icon for Form in Layout Designer to manage form fields
5. On the Form Field Manager window, select Territory. When Territory is selected as a field, the requisition header descriptive
flexfields will be added to the form layout.
13 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 8 Select the requisition headers descriptive flexfields context segment from available fields.
6. Click Done.
14 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 9 Requisition header descriptive flexfields displayed in the form layout.
After you redraw the layout, all the enabled global segments, context segment, and context sensitive segments related to the
requisition headers will be displayed in the form layout. When you create the requisition, based on the selected context value,
corresponding context sensitive segments will be either exposed or hidden.
15 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 10 Context sensitive segments expand based on the selected context.
You can follow these steps to check the descriptive flexfields in your Oracle Fusion Web Application:
a. Procurement offering
2. Click POR_REQUISITION_LINES.
3. To check the requisition lines descriptive flexfields, click the Edit icon.
• Context Sensitive Segments: Different sensitive segments based on the Country selected
16 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 11 Global segments and Context segment setup for requisition lines descriptive flexfields in the application.
Figure 12 Context segment setup for requisition lines descriptive flexfields in the application.
For our example, descriptive flexfields for the requisition lines will be represented by the Context Segment Country.
To add line descriptive flexfields to the table layout, follow these steps:
17 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
3. On the Layout Designer, click the Table tab.
Figure 13 Select Add icon for Table in Layout Designer to manage table columns.
5. On the Table Column Manager window, select Country. When Country is selected as a field, the requisition line descriptive
flexfields will be added to the table layout.
18 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 14 Select the requisition line descriptive flexfields context segment from available fields.
6. Click Done.
After you redraw the layout, all the enabled global segments, context segment, and context sensitive segments related to the
requisition line will be displayed in the table layout. When you create the requisition, based on the selected context value,
corresponding context sensitive segments will be made updatable.
19 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 15 Requisition lines descriptive flexfields displayed in the table layout.
In a table layout, the superset of all possible context sensitive segments for all possible context values will be displayed in the table.
Only a subset of them are relevant to each line depending on the current context value for that line. Fields will be shown as read-only
dynamically to indicate which segments are applicable to the current line based on the context selected.
• If the value of "Country" is null/empty, none of the context sensitive segments are applicable.
20 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 16 Context sensitive segments are editable based on the selected context.
You can follow these steps to check the descriptive flexfields in your Oracle Fusion Web Application:
a. Procurement offering
2. Click POR_REQ_DISTRIBUTIONS.
3. To check the requisition distributions descriptive flexfields, click the Edit icon.
• Context Sensitive Segments: Different sensitive segments based on the Region selected
21 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 17 Context segment setup for requisition distributions descriptive flexfields in the application.
In this case, Descriptive flexfields for the Requisition Distributions will be represented by the Context Segment Region.
To add distribution descriptive flexfields to the table layout, follow these steps:
22 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 18 Select Add icon for Table in Layout Designer to manage columns.
5. On the Table Column Manager window, select Region. When Region is selected as a field, the requisition distributions
descriptive flexfields will be added to the table layout.
23 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 19 Select the requisition distributions descriptive flexfields context segment from available fields.
6. Click Done.
24 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 20 Requisition distributions descriptive flexfields displayed in the table layout.
After you redraw the layout, all the enabled global segments, context segment, and context sensitive segments related to requisition
distribution will be displayed in the table layout. When you create the requisition, based on the selected context value, corresponding
context sensitive segments will be made updatable.
5. On the Table Column Manager window, deselect the Context Value check box.
25 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 21 Deselect the Context Value check box to hide the projects fields
6. Click Done.
Note: You need to perform these steps every time you refresh business object catalog.
4. On the Form, click Requisitioning BU Id field and then click the Edit icon.
5. On the Business Object Field Editor window, deselect these check boxes: Required for create, Editable on update, and Editable
on create.
6. Click Done.
Similarly, you need to reconfigure these fields and select the Required for create check box to make them required during requisition
entry.
26 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
On the Requisition Header Form:
• Requisition BU
• Description
• Entered by Email
• Line Number
• Destination Type
• Deliver-to Organization
• Requester Email
For example: We have listed the steps to reconfigure the Requisition BU field on the Requisition Header & Lines worksheet in the
Excel template. You can follow these steps to reconfigure other fields.
4. On the Form, click Requisitioning BU field and then click the Edit icon.
5. On the Business Object Field Editor window, select the Required for create check box.
6. Click Done.
27 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
BUSINESS USE CASES
In this section, we will see how you can use the Visual Builder Add-in for Excel based template to accomplish different business
functions in the areas of managing requisition data.
2. To enable requisition header information entry, click Form Row Changes and then click Create Form Row.
3. Enter the header information as needed. The required fields are indicated by * and highlighted in red.
28 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 23 Required fields are highlighted in red.
4. To create a row in the table for requisition line entry, click Table Row Changes and then click Insert Rows.
29 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 25 Enter requisition line information in table row.
6. To add more lines, you can keep entering data in new lines and the Add-in automatically marks them for Create. To copy/serial fill
data, you can use Excel features such as drag and drop.
7. To create the requisition, click Upload Changes. On upload, the requisition with lines will be created. Status of the data is
indicated at the row level and details can also be viewed in the Status section of the spreadsheet.
30 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 26 Upload changes to save data to the application.
31 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
8. To create distributions, follow these steps:
b. On the Choose an action to perform on the form row dialog box, to add a default distribution for each line in the
requisition, click Create Default Distributions.
c. On completion of the action, click Download Data for the requisition by entering the requisition number and then to check
the created distributions, open the Requisition Distributions worksheet.
Tip: Alternatively, to create distributions, open the Requisition Distributions worksheet and enter one or more distributions per line by
entering the line number in each row and click Upload Changes.
a. In the Requisition Distributions worksheet, select POR: Requisition in the Context Value field for each distribution row.
b. In the Project Number field, search and select the desired project from the available projects for the requisitioning BU.
c. To enter the remaining projects descriptive flexfields, search and select the desired values, and click Upload Changes.
32 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 29 Projects descriptive flexfields displayed in the table layout.
b. To see the available custom actions on the row, click Perform Action.
3. Enter the Requisition Number of the incomplete requisition that you want to update when prompted.
33 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 30 Download data for a specific requisition by providing requisition number.
4. On the Table Row Changes menu, mark lines for operations such as update and delete.
34 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 31 Use Table Row Changes menu to mark lines for changes.
5. Click Upload Changes. On uploading the changes, status is indicated by the Add-in for each action.
35 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Cancel Specific Requisition Lines/Cancel Requisition
Scenario: You want to cancel requisition lines from the submitted requisition or cancel the requisition.
3. Enter the requisition number of the submitted requisition that you want to update when prompted.
4. To cancel specific requisition lines, enter cancel reason for the lines. This marks the line for cancelation as indicated by the
Change column of the table.
5. To perform the cancel action, Click Upload Changes. The status of the operation is indicated in the Status panel as well as at the
line level.
36 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 34 Confirmation on successful cancelation of lines.
4. Click OK. The cancel operation is performed, and status displayed in the status panel as well on the Perform action dialog box. To
see the updated status, you can download data for the requisition and confirm.
37 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
Figure 35 Confirmation on successful cancelation of requisition using header action.
• Projects descriptive flexfields in Requisition Distributions worksheet work only when the requisition header is uploaded. It’s
recommended to not remove Requisitioning BU Id field from the Requisition Header & Lines worksheet.
• When you click Upload Changes after correcting data for errors related to descriptive flexfields and projects descriptive flexfields,
the add-in sometimes incorrectly shows "This row has been modified by another user. Please download before editing." error
message, even if the requisition is not modified by another user. This is a known limitation. To avoid this error message, you must
first download data before uploading it to fix such errors.
• Several columns at every level are hidden by default. Using the Designer, you can modify the template to tailor to your
organizational requirements. The modifications include but are not restricted to:
– Hide/Show fields
38 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
– Marking fields as mandatory
• You can also release these templates for end users to do data entry using the Publish feature of the Oracle Visual Builder Excel
Add-in.
• Publishing creates a copy of the workbook with the option to hide design tools. If hidden, the worksheet protection turned on for
each worksheet with a layout thereby locking the layouts. The design tools do not appear in the Oracle Visual Builder tab of the
Excel ribbon (Designer, Delete Layout, and Publish buttons).
– https://www.oracle.com/downloads/cloud/visual-builder-addin-downloads.html
– https://docs.oracle.com/en/cloud/paas/app-builder-cloud/visual-builder-excel/toc.htm
– https://docs.oracle.com/en/cloud/paas/app-builder-cloud/tutorial-excel-add-in/index.html
• Documentation guide for end user to manage data using Oracle Visual Builder Add-in for Excel
– https://docs.oracle.com/en/cloud/paas/app-builder-cloud/visual-builder-excel-data/
– https://docs.oracle.com/en/cloud/paas/app-builder-cloud/visual-builder-excel/troubleshooting-excel-workbooks.html#GUID-
36A1EF56-F1C0-4F41-8952-B17294A37BE0
39 Using Oracle Visual Builder Add-in for Excel to Create Purchase Requisitions
ORACLE CORPORATION
Worldwide Headquarters
500 Oracle Parkway, Redwood Shores, CA 94065 USA
Worldwide Inquiries
TELE + 1.650.506.7000 + 1.800.ORACLE1
FAX + 1.650.506.7200
oracle.com
CONNECT WITH US
Call +1.800.ORACLE1 or visit oracle.com. Outside North America, find your local office at oracle.com/contact.
Copyright © 2022, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the contents hereof are
subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed
orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any
liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be
reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission.
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. 0122
Using Oracle Visual Builder Add-in For Excel to Create Purchase Requisitions
June 2021