Setting up chained distributed transfers

The information in this topic is applicable only for on-premises deployments.

You then create a distributed transfer on the chicago server that sends any bug request for Superior Side Chairs that is transferred into the Acme East Bug Tracking form to the Acme Canada Bug Tracking form on the toronto server.

The following figure shows an example of a chained distributed transfer.

Chained distributed transfer example

To set up a chained distributed transfer

1. Perform these tasks:
   • Create the Acme West Bug Tracking form on the sanfrancisco server.
   • Create the Acme East Bug Tracking form on the chicago server.
   • Create the Acme Canada Bug Tracking form on the toronto server.
   • Add basic distributed fields to the forms.
     See Adding-and-deleting-distributed-fields.
   • Add distributed mappings and filters to the sanfrancisco and chicago servers according to the procedures in Distributed-operation-use-cases.
2. Create a distributed mapping between the chicago and toronto servers to transfer bug requests for Superior Side Chairs from the Acme West Bug Tracking form to the Acme Canada Bug Tracking form with ownership:
   1. In Developer Studio, select File > New > Distributed Mapping.
   2. Select the From (chicago ) server, and click Finish.
   3. In the Distributed Mapping editor, fill in the Basic panel as shown below:
      Distributed Mapping editor — Basic panel for chicago server
      
   4. Fill in the Options panel as shown below:
      Distributed Mapping editor — Options panel
      
   5. In the Transfer to Target panel, click Auto Map.
   6. In the Auto Map dialog box, select Match IDs, and click OK.
   7. In the Return from Target panel, click Auto Map.
   8. In the Auto Map dialog box, select Match IDs, click OK, and then select File > Save.
   9. In the Save Distributed Mapping As dialog box, enter Acme E to C Bug Track, then click OK.
3. Create a filter with a DSO Transfer action on the From server:
   1. In Developer Studio, select File > New > Filter.
   2. Select the From (chicago ) server, and click Finish.
   3. In the Associated Forms panel of the Filter editor, click Add.
   4. In the Form Selector, select the Acme East Bug Tracking form, and click OK.
   5. In the Execution Options panel, set the options shown in the following figure:
      Filter editor — Execution Options panel
      
   6. In the Run If Qualification panel, click the ellipsis button.

   7. In the Expression editor, enter the following qualification, then click OK:

      'Product' LIKE "S%"

      The qualification states that the filter action should be executed when the product name on the Acme East Bug Tracking form begins with the letter S.

   8. Right-click the If Actions panel, and select Add Action > DSO.
   9. In the Type list in the DSO panel, select Transfer.
   10. Select Override Loop Detection, and select File > Save.
       See Avoiding-infinite-loops.
   11. In the Save Filter As dialog box, enter a name for the filter, such as Acme E to C Bug Track, and click OK.
4. Test the chained distributed mapping by creating some requests for Prize Desks, Choice Desk Chairs, and Superior Side Chairs in the Acme West Bug Tracking form (sanfrancisco).
   Requests for both types of chairs should be transferred to the Acme East Bug Tracking form (chicago). Requests for Superior Side Chairs should then be transferred to the Acme Canada Bug Tracking form (toronto).