Partial Runs

A partial run is when only one section of a workspace executes. One way to do this is to disable objects in the canvas to just run certain enabled parts. Another method is to use a tool called Partial Runs, which is represented by pop-up options when a workspace runs with caching turned on.

The technique you use will depend on how large the workspace is, and how much of it you need to run. You may use one method or the other - or you may use both!

Disabled Objects

If designed correctly, a large workspace should be made up of small sections. Isolating a section (or part of a section) for testing is possible by disabling connections to all other components.

An object (connection or feature type) is disabled by right-clicking it and choosing the option to Disable (or selecting it and using the shortcut Ctrl+E):

A disabled connection is inoperative as if deleted, and no features will pass through. Transformers and feature types can also be disabled. Even a reader/writer can be disabled through the Navigator window.

Here an author has disabled two connections (both from the Tester:Passed port) and two feature types:

With that setup, the top part of the workspace will operate up until (and including) the Tester. The bottom portion will not run at all. No data will emerge from the disabled feature types, and the Tester will not pass any data to it.

With caching turned on, the author can inspect part of the workspace without having to run the entire translation. This feature is a significant advantage when (like here) the disabled section takes up most of the overall processing time.

Feature Caching

When caching is turned on, running a translation causes data to cache at every part of the workspace. In subsequent runs, those caches can be used instead of having to re-run entire sections of the workspace.

Here, for example, a workspace has been run with caching turned on:

Now the author makes a change to the AreaCalculator parameters:

Notice that the caches change color (to yellow) on the AreaCalculator and subsequent transformers. This color denotes that caches are stale; their data contents no longer match what the workspace would produce.

To get the new results, the author must re-run the workspace. However, they do not have to re-run the entire workspace; they can start the workspace at the point of change - the AreaCalculator:

Run From This causes the workspace to run from that point only, using data cached up until that point. Notice how hovering over the option highlights all "downstream" transformers. They are the only ones that will run. That makes the translation quicker.

The other option is Run To This. The author could use that option on the writer feature type and get much the same effect:

...but notice how the second branch from the StatisticsCalculator does not get highlighted. It will not run. That shows how you can avoid running a particular section of workspace, in much the same way as if that connection had been disabled.