Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Tool Configuration

...

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

...

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

...

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

  1. Log into your Opsera instance and navigate to Jobs.

  2. Click + New Jenkins Job.

  3. In the Create New Jenkins Job popup, enter a unique name for the job.

    This name will be fetched in the Tool Job drop-down in the pipeline step.
  4. Job Type - Select SFDC Jobs.

  5. Build Step -Select

    Select the Job Type as SFDC Jobs and Build Step as Salesforce Data Transformer.

    Image Added
  6. Click the Create button to save the new job.

SFDC Configurator Tool Configuration

  1. In a properly configured SFDC Configurator tool, navigate to the Create.
    The new Jenkins job will be successfully created.

Set up SFDC Data Transformer Rules

  1. Navigate to Operations > Tool Registry and choose a configured SFDC configurator tool.

  2. Click Data Transformer Rules tab, and then click the +New SFDC Data Transformer Rules button.

    Image Removed
  3. Fill out In the Create New SFDC Data Transformer Rules form using popup, enter the following informationdetails:

    • Name- Create : Enter a unique name for the rule. This name will be fetched in the Data Transformer Rule drop-down in of the pipeline step configuration.Operation - Select Search & Replace from the drop-down.

    • Component Type - : Select the a component type from the drop-downdropdown.

    • Component Name- Provide : Choose a Filter and apply a Value to it.Search Text - Text 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 - Text : Enter the text to be replaced with.

  4. 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

    Image Removed

    • Upon choosing Exclude as Operation, enter the Tag details.

      Image Added
  1. 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

...

Search & Replace (free text):

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

    Image Removed

Data Transform Pipeline Step Configuration

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

...

Configure Data Transform Step in Pipeline

  1. Open the pipeline for which you want to configure metadata transformer rules.

  2. 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 Jenkins job which was configured in Step 1is configured using the Create Jenkins Job step.

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

    • Data Transformer Rule - : Select the data transformer rule name.

    • Build/Xml Step Info - : Select the “Create Package” stepstep created for create package in the workflow.

...

 Successful completion of Pipeline:

...

Console Log:

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.

...