Destinations

Purpose
The Destinations options is used to create and manage the destinations where the product instances should be delivered to.

	Note
	This option is available only if the user is logged in and has the right to edit the destinations for their organization.

To be able to regularly receive data instances of a certain product, the user has to:

1. Click and select Destinations: create a destination. A destination is a communication channel able to deliver data to a location accessible to the user. It can use common protocols such as FTP, SFTP, e-mail. Destinations are shared among users belonging to one organization.
2. Click and select Search products: look up the products that you want to receive.
3. After the search products are listed, use the check-boxes to select all products and click the Subscribe selected button to subscribe to products, i.e. specify that these products should be sent to a specific destination.

Destinations

After selecting the Destinations, the list of specified destinations will be displayed.
Destination is a specification of method and place where the product instance may be delivered. Products that you have subscribed to can be delivered to you by e-mail or by FTP-upload to a file system directory on a FTP server you have access to and a valid FTP account for.

The following information is listed about the destinations:

• Destination name: the specified destination name
• URI: URI description of the destination

It is possible to limit the display of the destination - this is useful if you have a lot of destinations. Do one of the following:

• Name: Enter a part of the name. Only destinations where the name includes the specified string will be listed.
• Search all fields: Enter a string that you are looking for. Only destinations where the name or the URI includes the specified string will be listed.

Depending on the privileges of your user account you may be able to edit destination (create new ones, modify or delete existing ones).

View list of subscribed products

It is possible to display the list of products and packages that are subscribed to the given destination. Do the following:

1. Click in the Actions column of the given destination.
2. The Subscribed products page will be displayed, listing all products that are currently subscribed for this destination.
   
3. It is not possible to add new subscriptions from this page, however you can delete unwanted subscriptions:
   • delete a single subscription: Click next to the unwanted subscription.
   • delete several subscriptions: Click the checkbox in front of each unwanted subscription and then click the Delete selected items button.

Modify destination properties

Users who have editing privileges can change the specified destinations:

To edit an existing destination:

1. Click in the Actions column of the given destination. The Destination Properties page will be displayed.
2. Make the required changes.
3. Click Save.

Delete destination

To delete an existing destination:

1. In the Actions column of the given destination click the More button and select the Delete option.
2. You will be prompted to confirm the deletion on a separate page showing the name of the destination. Click Delete to confirm.

Copy destination

It is possible to create a copy of the selected destination - this is useful if the new destination is quite similar to an existing one, therefore you will not have to enter each single destination property.

1. In the Actions column of the given destination click the More button and select the Copy option.
2. A dialog showing the copied destination properties will be displayed.
3. Name: Assign a name to the destination (by default the name is name of copied destination_copy.
4. Change the properties that should be different in this new destination.
5. Click Save.

Resend product instances

Sometimes you may want to repeat the sending of certain product instances: for example you have deleted some older product instances and then realized that you need them again. It is possible to send all product instances from the specified period to the same destination again.
Do the following:

1. In the Actions column of the given destination click the More button and select the Reship option.
2. The Product reshipment dialog will be displayed:
   
3. From and To: Specify the period from which you need the product instances.
4. Click Reship.

Display statistics

It is possible to display statistics of a destination, i.e. to list messages and files that were transmitted via this communication channel.

1. In the Actions column of the given destination click the More button and select the Show statistics option.
2. In the displayed dialog specify the time interval from which the statistics should be displayed.
3. Click Load.
   

Stop or start destination

In certain cases you may decide that communication channel to a destination needs to be stopped:

• In the Actions column of the given destination click the More button and select the Stop option. A stopped destination will be displayed in grey font.
• To start the channel again, click the More button and select the Start option.
  Users may starting and stop their communication channels only if this feature is enabled by the system administrator.