Setting Extension Values

When a Process is defined with Extensions and deployed, you need to set values for those Extensions for the Process to use when it executes.

In this article:

Deployment

When a Process configured with Extensions is deployed, you can set the values to be used when the Process is executed. Extension values are set from the Atom Management screen. Depending on whether your AtomSphere Account has Environments enabled, Extensions values are set either at the Atom- or Environment-level.

You must deploy the Process for the Extensions to be available. Only Extensions defined in the current Process deployment version are available to be set.

Remember if your Process contains child Processes, any Extensions to be used in the child Processes must be defined in the parent Process.

Atom Level Extensions

When Environments are disabled in your AtomSphere Account, Extensions are set at the Atom level. The Extension values will be applied to any Process configured with the given Extension definition that is attached to that particular Atom.

To set Atom-level Extensions:

1. Go to Manage >> Atom Management.
2. Select the Atom from the list on the left.
3. Click Atom Extensions.
4. Configure the Extension values.
5. Click OK when finished.

Environment Level Extensions

When Environments are enabled in your AtomSphere Account, Extensions are set at the Environment level. Environment-level Extensions allow you to manage Extension values for all Processes attached and deployed to a given Environment. This enables you to configure things like Connection settings globally instead of having to configure the same Connection Extensions values for each attached Process. The available Environment level Extensions are an aggregated list of the unique Extensions defined within all Processes attached to that Environment.

To set Environment-level Extensions:

1. Go to Manage >> Atom Management.
2. Select the Environment from the list on the left.
3. Click Environment Extensions.
4. Configure the Extension values.
5. Click OK when finished.

Important Notes

• Schedule Extensions are still set per Process per Atom.
• If you attach and deploy a new Process to the Environment, you do not need to configure values for any Extensions that have already been defined; the Process will automatically use the previously defined values for the Environment.
• If you deploy a Process version that contains a new Extension definition, you will need to configure a value for that Extension.
• If you attach a new Atom to the Environment, you must re-enter and save all Password type Connection Extensions. This is because the AtomSphere platform does not store your sensitive password information for security purposes.

Attach and deploy all Processes to a given Environment before configuring Extension values.

Test Mode

To assist with testing, you can configure values for Connection and Process Property Extensions when executing the Process in Test Mode.

To set Test Mode Extensions:

1. Open a Process.
2. Toggle into Test Mode.
3. Choose New Test or Retry a Test
4. Choose an Atom from the list.
5. Click on the Test Extensions dropdown.
6. Configure the Extension values.
7. Click Run Test when finished to execute the Process.

Test Mode Extension values are "remembered" per Atom. That means if you reopen the Process at a later time and select the same Atom, you do not need to reconfigure the Extensions. However you will need to configure the Extensions for each Process. For example, if you have two Processes that use the same FTP Connection component, you will need to configure the same FTP settings for that Connection when running each Process in Test Mode.

Configuring Extension Values

Connection Settings

To set a Connection Setting Extension:

1. Click the Connection Settings tab.
2. Select a Connection from the drop down.
3. Uncheck the "Use Default?" box and enter a value for each field. If "Use Default?" is checked, the Process will use the values configured in the underlying Connection component.
4. Click OK when finished.

Schedules

To set a Schedule Extension:

1. Click the Schedules tab.
2. Configure the schedule.
3. Click OK when finished.

Process Properties

To set a Process Property Extension:

1. Click the Process Properties tab.
2. Enter a value for each Property.
3. Click OK when finished.

Object Definition and Data Map Extensions

The Data Map Extensions are used with Widgets and are only settable via the Widget wizard. See Widget End User Experience for more information.

Cross Reference Table Extensions

The Cross Reference Table Extensions are used with Widgets and are only settable via the Widget wizard. See Widget End User Experience for more information.

Setting a password extension locally using JMXTerm

You will need the account id, and your atom must be running.

On the machine where the atom is running:

1. Download jmxterm "uber" jar from http://wiki.cyclopsgroup.org/jmxterm
2. run it using java -jar jmxterm<number>-uber.jar
3. type "jvms" to get the list of running jvms (your atom will be one of these - com.install4j.runtime.Launcher start com.boomi.launcher.Launcher)
4. issue an "open" command with the jvm pid number
5. issue the command "bean com.boomi.container.services:type=OverridesAdminService"
6. issue the command "run queryAvailableValues <account-id>" (So with accountid myaccount it would look like run queryAvailableValues myaccount)
   This command will show you all available field overrides. If there's an error, you may have to save your overrides from the platform ui one time.
7. find the setting you want to override and record the connectionId and fieldId.
8. issue the command "run setEncryptedOverrideValue <account-id> <connectionId> <fieldId> <plaintext pw>" using the connectionId and fieldId (not names) you recorded in the previous step.

---

See Also:

• Environments