Edit a mapplet in the Mapplet Designer. To edit a mapplet, open the mapplet from the Explore page.
When you edit a mapplet, the Mapplet Designer validates the transformation logic. If a mapplet is valid for mappings in or outside of advanced mode when you save it, Data Integration deploys the changes to each mapping and mapplet that uses the mapplet.
For example, if the mapplet is valid both in and outside of advanced mode and you change the interface of the mapplet so that it's only valid outside of advanced mode, Data Integration deploys the changes to all mappings that use the mapplet.
Use caution when you edit mapplets that are used in mappings and other mapplets. If you edit the mapplet interface, mappings and mapplets that use the mapplet will have validation errors. To resolve the validation errors, you must synchronize the mapplet to get the latest changes. If you do not synchronize the mapplet and you run the task, the task fails.
When you synchronize a mapplet, the updates might cause validation errors in other transformations in the mapping or mapplet. To see the assets that use the mapplet, in the Mapplet Designer, open the Actions menu and select Show Dependencies.
You cannot edit a mapplet in a Mapplet transformation, and you cannot edit a mapplet that you imported from PowerCenter.
Changes that affect dependencies
Changes to a mapplet might affect the mappings and mapplets that use the mapplet.
The following changes to a mapplet do not affect the assets that use the mapplet:
•Change transformation names, except for Input and Output transformation names, or change transformation descriptions or properties.
•Add or remove transformations in the mapplet, as long as you do not change the mapplet type from active to passive or from passive to active.
The following changes to a mapplet change the interface of the mapplet and affect the assets that use the mapplet:
•Add or remove transformations that change the mapplet type from active to passive or from passive to active.
•Change the data type, precision, or scale of a connected input or output field.
•Change the name of an Input or Output transformation.
•Add or remove input or output fields.
•Add or remove Input or Output transformations.
Synchronizing a mapplet
If you update the interface of a mapplet after it has been added to a Mapplet transformation, the mapplet becomes out of sync with the assets that use it. You must synchronize the mapplet to deploy the changes.
Mappings and mapplets that use the mapplet are invalid until the mapplet is synchronized. If you run a mapping task that includes a changed mapplet, the task fails.
You can't synchronize a mapplet that you imported into Data Integration from PowerCenter or SAP.
To synchronize a mapplet from the Mapplet Designer, perform the following steps:
1Open the Actions menu and select Synchronize.
2Select the assets to update with the changes and click Update selected dependencies.
You can also synchronize the mapplet with a Mapplet transformation that uses the mapplet on the Mapplet tab of the transformation.
When you synchronize a mapplet, the changes might cause validation errors in other transformations. To see the mappings or mapplets that use the mapplet, click Actions > Show dependencies.