You can invoke the process to create or update a Rule Occurrence (RO) with a score for the selected data elements based on profiling results from CDGC.
To invoke the Process Selected Data Elements process, you can use one of the following options:
You must pass the following input parameters while invoking the process using the web browser and the Run Using option:
•In_Catalog_Source: The name of the catalog source that the data element for which the RO is being created or updated belongs to.
•In_Dataset: The name of the dataset that the data element for which the RO is being created belongs to.
•In_Target: This value defines the ideal level of quality that should be achieved. If the score is greater than or equal to the Target, the Score status is set to Good.
•In_Threshold: The minimum threshold of acceptability below which the data is considered as incorrect. If the score is greater than or equal to the Threshold and lesser than the Target, the Score status is set to Acceptable. If the score is lesser than the Threshold, the Score status is set to Not Acceptable.
•In_Criticality: Parameter that defines the criticality level, which can be Low, Medium, or High, used to prioritize and classify the RO.
•In_Data_Elements: A list of Data Element names for which you want to create or update the RO. To ensure a smooth operation, avoid creating an RO for more than eight data elements at a time.
Publish and run the guide
A guide provides step-by-step prompts that help users review, enter, or confirm data visually, reducing manual entry errors. This guide simplifies rule occurrence creation by leading users through dataset and data element selection and configuration.
1Open the Uniqueness Rule Occurrence Guide guide.
2On the Start tab of the Start step, ensure that the Run As field is set to Current User.
3Save and publish the guide.
4On the Actions menu, click Run. Alternatively, you can copy the execution URL from the Properties Detail dialog box to run the guide.
5On the Select Dataset page, select the dataset that contains the data elements for which you want to create rule occurrences, and click Next.
6On the next screen, select one or more profiled Data Elements and click Next.
Note: To ensure a smooth operation, avoid creating rule occurrences for more than eight data elements at a time.
7Enter values for the Threshold, Target, and Criticality fields.
Note: For Threshold and Target, you can enter only numeric values, limited to two decimal places. If you enter an invalid value, such as a negative number, an error occurs.
8Click Run.
The process will create or update rule occurrences for the selected data elements. The process might take some time depending on the number of data elements selected.
The next screen displays a summary list of the newly created or updated rule occurrences. Any errors that occurred during creation or update will also be shown in the table. For each rule occurrence, the table provides details, such as the linked Data Element and its ID, the rule occurrence name and ID, the link to it in CDGC, and other relevant information.
9Click Done.
If you encounter an error stating that this guide session is no longer available and cannot be used, click OK, and then click Run at the bottom. A new screen will appear displaying the results, which are accurate despite the session error.
You can also use the embed code to embed the guide into an HTML document of a third-party application.
Run the process by passing inputs from the Process Designer
Pass input in the JSON or XML format through the Run Using option of the process.
1Open the Process Selected Data Elements process and click Actions > Run Using.
2Click New Input, enter a name for the process input, and click Save.
The payload is populated in the Process Input section.
3From the Encoding list, select JSON.
4Enter the input field values for the process as shown in the following snippet:
{ "In_Catalog_Source": "<Catalog Source Name>", "In_Dataset": "<Dataset Name>", "In_Target": "<Target value>", "In_Threshold": "<Threshold value>", "In_Criticality": "<Criticality value>", "In_Data_Elements": "<First Data Element Name>,<Second Data Element Name>" }
You can enter multiple data elements separated by commas. To ensure a smooth operation, avoid creating rule occurrences for more than eight data elements at a time.
5Validate, save, and run the process.
Run the process by passing inputs from a web browser
When you pass input values in the service URL and run the process in a web browser, you will receive information about the created or updated rule occurrences.
1Open the Process Selected Data Elements process and click Actions > Properties Detail > Copy Service URL.
2Open a text editor and add the input fields and values to the service URL as shown in the following format:
<Cloud Application Integration POD URL>/active-bpel/public/rt/<API_name>?In_Catalog_Source=<Catalog Source Name>&In_Dataset=<Dataset Name>&In_Target=<Target value>&In_Threshold=<Threshold value>&In_Criticality=<Criticality level>&In_Data_Elements=<Data Elements separated by %2C>
Here, <Cloud Application Integration POD URL>/active-bpel/public/rt/<API_name> is the service URL that you copied in step one.
Note: The data elements must be separated by %2C, which represents a comma. For example, to pass BusinessID and Country as Data Elements, set the value of In_Data_Elements to BusinessID%2CCountry. To ensure a smooth operation, avoid creating rule occurrences for more than eight data elements at a time.
3Open a browser and paste the service URL.
The process runs and returns the information about the created or updated rule occurrences.
Note: When you run the process by sending a request through the web browser, the response includes a rule occurrence link that might contain "\" characters. You must remove the "\" characters before using the link.