Search and Replace Documentation

Description: Utilize Jenkins Job and SFDC Configurator Data Transformer Rules to apply Search & Replace Rules, transforming data in the pipeline.

Jenkins Tool Configuration

1. In a properly configured Jenkins tool, navigate to the Jobs tab and click the +New Jenkins Job button.

   

2. Fill out the Create New Jenkins Job form using the following information:

   • Name - Provide a unique name for the job. This name will be fetched in the Tool Job drop-down in the pipeline step.

   • Job Type - Select SFDC Jobs.

   • Build Step -Select Salesforce Data Transformer.

3. Click the Create button to save the new job.

SFDC Configurator Tool Configuration

1. In a properly configured SFDC Configurator tool, navigate to the Data Transformer Rules tab and click the +New SFDC Data Transformer Rules button.

   

2. Fill out the Create New SFDC Data Transformer Rules form using the following information:

   • Name - Create a name for the rule. This name will be fetched in the Data Transformer Rule drop-down in pipeline step configuration.

   • Operation - Select Search & Replace from the drop-down.

   • Component Type - Select the component type from the drop-down.

   • Component Name - Provide a Filter and apply a Value to it.

   • Search Text - Text to search which will be replaced

   • Replace Text - Text to be replaced with

     

3. Click the Create button to save the new rule.

Operation cases:

• Exclude:

  • Operation as “Exclude” plus any filter combination of the word will be excluded

    

• Search & Replace with Tag filters:

  • This field is only applicable for components which are of Xml format. The flag to decide whether or not to show field, will be decided at the time of selecting Component Type.

    Also the tag needs to be provided with the hierarchial structure. i.e. For WorkflowAlerts to scan through senderAddress we should give Workflow.alerts.senderAddress
    For eg: It’s applicable for CustomField, but not for ApexClass

    

• Search & Replace (free text):

  • The word with given combination will be searched throughout and replaced

    

Data Transform Pipeline Step Configuration

1. In the data transformer step with a configured Jenkins Tool, provide the following selections:

   • Jenkins Tool - Select the jenkins tool containing the configured SFDC Job with Salesforce Data Transformer Build.

   • Jenkins Job Type - Select Opsera Managed Job.

   • Tool Job - Select the jenkins job which was configured in Step 1

   • Specify Salesforce Credentials - Select the SFDC Configurator tool containing the data transformer rule(s) added.

   • Data Transformer Rule - Select the data transformer rule.

   • Build/Xml Step Info - Select the “Create Package” step

 Successful completion of Pipeline:

Console Log: