Opsera’s Meta Data Transformer Rules enables you to perform actions on metadata while transforming them in a pipeline workflow.
The types of operations supported are:
Search and Replace: Searches for a text and replaces it with the desired text.
Exclude: Excludes a specific text during data transformation.
Workflow
The workflow entails building a Jenkins job that will be used to create the data transformer rule. The text that needs to be searched for and replaced is then defined, successfully configuring an SFDC transformer rule. You can directly define the settings of the rule in the workflow phase called "Data Transformer Step." You can get further details by looking at the related console logs after the pipeline has finished running.
In this Section:
Create Jenkins Job
Set up SFDC Data Transformer Rules
Configure Data Transform step in pipeline
View Logs
Create Jenkins Job
Log into your Opsera instance and navigate to Jobs.
Click + New Jenkins Job.
In the Create New Jenkins Job popup, enter a unique name for the job. Select the Job Type as SFDC Jobs and Build Step as Salesforce Data Transformer.
Click Create.
The new Jenkins job will be successfully created.
Set up SFDC Data Transformer Rules
Navigate to Operations > Tool Registry and choose a configured SFDC configurator tool.
Click Data Transformer Rules tab, and then click the +New SFDC Data Transformer Rules.
In the Create New SFDC Data Transformer Rules popup, enter the following details:
Name: Enter a unique name for the rule. This name will be fetched in the Data Transformer Rule drop-down of the pipeline step configuration.
Component Type: Select a component type from the dropdown.
Component Name: Choose a filter and enter the value. For example, you can define the filter to Contain the text CH_AddMemberInTeam.
Operation: You can choose Search & Replace or Exclude from the dropdown.
Upon choosing Search and Replace, enter the following:
(a) Search Text: Enter the text to search which will be replaced.
(b) Replace Text: Enter the text to be replaced with.
Upon choosing Exclude as Operation, enter the Tag details.
Click Create.
The Data transformer rule will be saved.
Note
You can perform the Search & Replace with Tag filters. This is applicable for components with XML format. The tag needs to be provided with the hierarchical structure.
Example: For WorkflowAlerts to scan through senderAddress, the tag name must be Workflow.alerts.senderAddress
Configure Data Transform Step in Pipeline
Open the pipeline for which you want to configure metadata transformer rules.
Click the gear icon on the Data Transformer Step, and define the following fields:
Jenkins Tool: Select a Jenkins tool that contains the configured SFDC Job with Salesforce Data Transformer Build.
Jenkins Job Type : Select Opsera Managed Job.
Tool Job: Select the Jenkins job which is configured using the Create Jenkins Job step.
Specify Salesforce Credentials: Select the SFDC Configurator tool containing the added data transformer rule(s).
Data Transformer Rule: Select the data transformer rule name.
Build/Xml Step Info: Select the step created for create package in the workflow.
View Logs
Upon successful running of a Pipeline, you can view the Pipeline logs and Console logs to learn more about the pipeline status.
To view Pipeline Logs, open the pipeline and click Summary.
You can also view console logs for a specific step in a pipeline. Open a pipeline log and click Console Output under Actions, and view the logs under Console Log tab.
