The purpose of this user guide is to provide end-users with a reference on how to use the Oracle Eloqua Asset Dependency Manager application.
The Asset Dependency Manager application allows marketers to manage and clear dependencies of Oracle Eloqua assets like Contact Field, Account Field, Campaign, Landing Page, Form, Email, Segments, etc. The application provides the following capabilities:
NOTE: The Appendix section below details the assets and their corresponding dependent assets that are supported for dependency elimination by the Asset Dependency Manager application.
To launch the Asset Dependency Manager app:
After having logged into an Oracle Eloqua instance click on the cloud icon and select “Asset Dependency Manager” by portQii.
The following page will load in another browser tab.
The following actions can be taken by the user from the home page of Asset Dependency Manager application
The following describes the different sections of the package page.
1. Navigation panel
2. Package description panel
3. Package Asset Details
Assets Included in Package: Lists out all the assets that is part of the package whose dependencies will be managed.
Actions:
User can change the default actions settings which are predefined in the Admin Page at the package level. Any changes done to default actions at the package level will not reflect in the Admin Page.
Steps to Override Default Actions at the package level as follows:
Click on Override Admin Default Actions to change the admin settings
Click on yes to override the actions
Choose Click here to Override Default Actions button
On click of the button there comes a popup window which contains
Show Assets from Package: On toggle of this button, displays the asset combinations only which are added into the package
Apply Bulk Asset Action: This option provides user to set all Asset Action to none or to admin actions at once.
Note: Apply Bulk Asset Action will be applied not only on the assets added to the package, but on all the asset combinations
Clear all asset actions:
Re-apply default admin actions:
User can still override the default actions even after performing Mange All Dependencyor Mange Dependency. Once the overridden actions are saved the application performs the Manage All Dependency again to apply new actions which are been set at the package level.
To clear dependencies of an asset in the Oracle Eloqua platform a package needs to be created inside the Asset Dependency Manager app. These dependencies for the asset(s) are managed through specific actions that a user can choose to take on the dependency. Once the actions are defined, the package is processed to remove the dependencies.
1. Click the New Package button from the home page of Asset Dependency Manager.
2. Fill out the Package Name and Description and click the Save button.
Clicking on the “Save” button will complete this process.
If there is a requirement to update the Package Name or Package Description at this stage, clicking on Update button will enable that capability.
There are multiple ways for users to be able to add an asset for deployment to a target Oracle Eloqua instance:
Click on the Asset Type drop down to choose the type of asset to lookup. Then choose to type the name of the asset, full or partial or modified date or modified by. Click on Search to get the list of assets.
The results will be filtered and shown in the grid directly below the search area.
Clicking on ‘+’ infront of the asset will only add that particular asset into the package.
Clicking on ‘Add All’ will add the first 25 search results into the package.
NOTE: The application ONLY loads 5 assets at a time. To load the next 5 assets, click the “Next” button that appears with the table view control at the bottom of the list.
Click on the folder icon and select the asset type. Click on search to get the folders for the selected asset type.
Once the folders are displayed, click on ‘+’ to expand the folder. Select the required asset inside the folder and click on ‘include selected’ to add the asset into the package.
Click on ‘View Child’ for an asset that is included in the package. All the child assets are displayed.
‘Include selected’ will add only the selected asset whereas ‘Include All’ will add all the first level child assets into the package. Note that the Asset Dependency Manager app doesn’t support dependency management for all the assets. Refer to the link to view the list of Supported and Unsupported asset list.
Note: Clicking on ‘+’ for any child asset will display it’s child assets. The tree structure can lead to the nth level child asset.
Once the assets are added into the package, the status of the assets will be New.
Click on the Save button once the assets have been added to the package.
NOTE: If the package is not saved, manage dependency process cannot be initiated.
The status of the assets will change to Saved on the package upon the user clicking Save button.
Users can also remove an asset form the deployment package by clicking the Delete option available in the menu in the Action column.
Create a New Package to Clear Account Field Dependencies
Defining Account Fields for Managing Dependencies
1. To search for an Account Field – Select Account Field from Asset Type drop-down list, type the Asset Name to be searched from Eloqua.
2. Add the Required Account fields to the package by clicking on + sign
3. Once added to the package User should save the asset for Managing dependencies.
4. Users can either click on Manage All Dependencies if the Default Actions are already set in Admin Page or else can do Mange Dependency to set the Action for each Dependencies and save.
On Manage Dependency a new Window Opens * with the actions to set, User can change the Default Actions set in the Admin page.
*Action Settings for Asset Dependencies after doing Manage Dependency.
5.Once actions are set the user can select:
On Select of Cruise Control Users can choose to Manage and Clear or Manage and Delete
Dependencies Cleared with Completed State
Create a New Package to Clear Custom Object & its Field Dependencies
Defining Custom Object Fields for Managing Dependencies
3. To add Custom Objects Fields, click on + Sign which in-turn shows a popup with the list of Custom Object Fields select the field to be added to the package and click on Add To Package. The field gets added to the package.
This interface has been updated with two new buttons, and looks like this now:
The ‘Add all fields’ button now makes it easy to add all the fields at once. Without this button, we were to add each field one-by-one, and life seemed meaningless.
The ‘Add CDO’ button adds a CDO and all its fields with a single click.
4. Once added to the package User should save the asset for Managing dependencies
5. User can either click on Manage All Dependencies if the Default Actions are already set in Admin Page or else can-do Mange Dependency to set the Action for each Dependencies and save
On Manage Dependency a new Window Opens * with the actions to set, User can change the Default Actions set in the Admin page.
Action Settings for Asset Dependencies after doing Mange Dependency
6. Once actions are set user can select
On Select of Cruise Control Users can choose Manage and Clear or Manage and Delete
Dependencies Cleared with Completed State.
Creating packages is the first step in using Asset Dependency Manager. We have now added File Upload as a new way to create packages. This feature allows us to upload a file (.csv) with all the asset details in bulk. We can upload details of up to 3,000 assets in a single file at a time. ADM uses this file to automatically create packages for us – it creates a maximum of 30 packages.
Each asset type has a limit, more on limits in a last section of this page.
Here’s how to use this feature:
Click on “New Package from File” button.
Download the sample .csv file from the link – and populate it with asset details.
Click on the ‘Browse’ button to upload the populated file.
*Note: CSV files without predefined headers can fail to upload.
Enter the package name and the package description
* Note: Package name is a mandatory field.
* Check ‘Include Archived Assets’ checkbox if one or more assets in the .csv are archived
ADM will create multiple packages with the given package name prefixed to each package.
Click on the Upload button to upload the file
Notification emails typically have three CSV files attached to them.
*Note: more on limits in the admin section.
Once the file is uploaded, the packages are listed on the ADM homepage.
NOTE : The upper limits are set based on empirical observations. Asset types like Account Field and Contact Filed can have thousands of dependencies – for this reason they are limited to a low number. On the other hand, campaigns have a few hundred dependencies, and we can include more of them in each package.
Create a New Package to Clear Field Merge Dependencies with ADM
Defining Field Merge for Managing Dependencies
1. Search for a Field Merge: Select Field Merge from the Asset Type drop-down list; type the Asset Name that needs to be searched.
2. Click on the + icon to add the asset to the package.
1.Click on Save to save the package.
2. Clicking on Manage All Dependencies will take the default asset action set in the Admin page.
Clicking on Manage Dependency will allow us to set the action for each dependency, one-by-one. Clicking on Manage Dependency opens a new window:
Once the action is set on the admin page for the dependency, we can select what happens to the asset:
Mange and Clear & Mange and Delete options are available only with Cruise Control switched on.
Look for the Completed status on the top and the number of dependencies cleared.
Enhancements to the Dynamic Content Feature
Admin Configuration
Default asset actions can now be set to Remove or Replace for an asset and its dependencies in the Admin Page
Create a New Package to Clear Dynamic Content Dependencies
Asset Dependency Manager
Defining Dynamic Content for Managing Dependencies
1. Search for Dynamic Content: Select Dynamic Content from the Asset Type drop-down list; type the asset Name that needs to be searched
2. Click on the + icon to add the asset to the package.
Click on Save to save the package.
Clicking on Manage All Dependencies will take the default asset action set on the Admin page.
Clicking on Manage Dependency will allow us to set the action for each dependency, one by one. Clicking on Manage Dependency opens a new window:
Once the action is set on the admin page for the dependency, we can select what happens to the asset:
Mange and Clear & Mange and Delete options are available only with Cruise Control switched on.
Look for the Completed status on the top and the number of dependencies cleared.
Email alerts on product updates, new product announcements, special promotions and more!