Environment Specific Extensions Activity Guide - 042024
Environment Specific Extensions Activity Guide - 042024
Activity Guide
Table of Contents
Table of Contents 1
About our Activities 2
Extensions: Environment Specific Activity 3
Create a Liberty Lux subfolder and install the Liberty Lux Customers process from the
Process Library. 3
In the Liberty Lux Customer connection component, replace the hard-coded username,
password, and database name with a placeholder. 3
Define the extensions for your component in the extension dialog and save the process. 5
Test the process in test mode, providing extension values. 6
Package and Deploy the Process to the target environment(s). 9
Set the extension values in the environment(s) and execute the process 12
Copyrights & Trademarks 17
Version History 18
1
About our Activities
This guide has essential activities to help you learn. It is a chance to reach a goal using
the Boomi platform by following step-by-step instructions. By completing these activities
in a learning setting, you'll gain experience to apply these skills in your situation.
Description
In this activity, a developer from Liberty Lux Bangkok has finished building a process to
load customer data to be used by the marketing team. You install the process from the
process library and create its environment-specific extensions for test and production.
Please follow the steps below.
2
Extensions: Environment Specific Activity
Create a Liberty Lux subfolder and install the Liberty Lux Customers
process from the Process Library.
1. Navigate to Component Explorer and create a folder for your process called Liberty
Lux.
Note: Unsure how to Install a Process from the Process Library? Check out Install a
Process from the Process Library.
1. Open the Build page's database connection component (Liberty Lux Customer).
3
2. Set the User Name, Password, and Database Name to ***SET AS EXTENSION
*** and select SAVE and CLOSE.
Note: Your password will show "Click to Set" until you type it in. After that, it will change
to "Encrypted."
4
Define the extensions for your component in the extension dialog and
save the process.
1. In the Build canvas, select the Extensions icon to specify your extensions.
Note: Because the process only has one connection component it is the only accessible
connection.
5
3. Save the Process.
Note: Please disregard any messages saying that no modifications were made.
2. Select the Test Atom Cloud as the Atom and expand Test Extensions.
6
3. Select Liberty Lux Customer from the Connection drop-down. Uncheck each Use
connection component value, and enter the following:
Extendable Test
Properties
User LLCustomerTest
Password LLCustomerTest
DB Name LLCustomerTest
7
4. Select OK. Remember the goal of this activity is to connect to the database.
Note: The connection component has placeholders, and the User, Password, and
Database Names are set in the extension dialog. The procedure would fail at the
Database Connector shape if you had not set the extensions in the extension dialog.
8
5. Test the process in Test Mode by inputting the extension values provided in the
tables below.
User LLCustomer
Password LLCustomer
DB Name LLCustomer
User LLCustomerTest
Password LLCustomerTest
DB Name LLCustomerTest
This step is performed to check the production User Name, Password, and DB name
are proper and functional.
Package and Deploy the Process to the target environment(s).
Note: Not sure how to Package and Deploy? Check out How to Package and Deploy a
Process.
9
2. Deploy your process with the following details:
10
Note: During deployment, Boomi verifies your account for available connection
licenses. If you lack the required licenses, an error message will pop up. You'll need to
undeploy a process to reclaim your license count.
3. To deploy the process to the Production Environment, go to the Actions menu and
select Deploy to Different Environment.
11
Set the extension values in the environment(s) and execute the
process
12
3. Select Environment Extensions.
4. Select the connection Liberty Lux Customer and uncheck each Use Connection
Component Values box. Enter the following and select OK.
User LLCustomerTest
Password LLCustomerTest
DB Name LLCustomerTest
13
5. Repeat steps 1 to 4 in this section to set these values by selecting Production.
User LLCustomer
Password LLCustomer
DB Name LLCustomer
14
6. Navigate to Process Reporting.
7. Run the process by selecting Execute Process. You can run the process in both
the Production and Test Environments.
Your process should run successfully.
15
This concludes the activity. If you still have trouble comprehending extensions, try
repeating the steps in Set the extension values in the environment(s), appending a 1 to
one of the values, and then run the process section. You should receive an error similar
to the one shown below.
16
Copyrights & Trademarks
This guide contains proprietary information protected by copyright and/or other legal grounds. The
software described in this guide is furnished under a software license, service agreement, or
nondisclosure agreement. This software may be used or copied only in accordance with the terms of the
applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any
means, electronic or mechanical, including photocopying and recording for any purpose without the
written permission of Boomi, LP (“Boomi”).
The information in this document is provided in connection with Boomi products. No license, express or
implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in
connection with the sale of Boomi products and/or services. EXCEPT AS SET FORTH IN THE TERMS
AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, BOOMI
(TOGETHER WITH BOOMI TOPCO, LP AND ITS DIRECT AND INDIRECT SUBSIDIARIES) ASSUMES
NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY
WARRANTIES RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. IN NO EVENT SHALL BOOMI OR ITS AFFILIATES BE LIABLE FOR ANY
DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES
(INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS
INTERRUPTION OR LOSS OF, DAMAGE TO, OR CORRUPTION OF DATA OR INFORMATION)
ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT OR INFORMATION, EVEN IF
PARTIES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Boomi makes no
representations or warranties with respect to the accuracy or completeness of the contents of this
document and reserves the right to make changes to specifications and product descriptions in its sole
and absolute discretion at any time without notice. Boomi does not make any commitment to update the
information contained in this document.
If you have any questions regarding your potential use of this material, contact:
Boomi, LP
Trademarks
Copyright © 2024 Boomi, LP. All rights reserved. Boomi, the Boomi 'b' logo or astronaut logo,
AtomSphere, Atom, Molecule, and AtomSphere Integration Cloud are trademarks of Boomi, LP and/or its
affiliates in the United States and/or other countries. Other trademarks and trade names may be used in
this document to refer to either the entities claiming the marks and names or their products.
17
Version History
Version Summary
18