Semantic Tracing Resource Changes

Published 2014-10-28 | (Compatible with SDK 5.1 and 2014 models)

A user can develop a TV App using the (including Samsung SDK Library APIs or 3rd party web services). The user can trace changes of resources that he/she used in an application. The user can identify the changed resource quickly and decide whether or not it will be applied to the TV App, by tracking the resource that has evolved and changed continuously during the TV App development or after its deployment.

A user can develop a TV App using the (including Samsung SDK Library APIs or 3rd party web services). The user can trace changes of resources that he/she used in an application. The user can identify the changed resource quickly and decide whether or not it will be applied to the TV App, by tracking the resource that has evolved and changed continuously during the TV App development or after its deployment.

For this, the developer can subscribe to the interested resource, and check the changes using the resource description document (web document). The developer can check the changes through e-mail notification or a manual status refresh. The IDE provides the following functions for resource change tracking.

  • Subscribe and UnSubscribe : The developer can manually subscribe/unsubscribe the changes of the interested resource. Then, the resource changes are notified to him/her.
  • Notification Policy : The developer can register/cancel the notification policy for receiving the resource changes.
  • Change History View : The viewer support to display the details of resource changes subscribed by the developer.
  • Change Comparison View : The viewer provides to compare the changes by version, regarding the resource subscribed by the developer.

Subscribe and UnSubscribe

The resources (including Samsung SDK Library APIs or 3rd party web services) used by all JS or HTML files in the project can be traced.

To this end, the resources used by all JS or HTML files in the project should be subscribed or unsubscribed to using the following procedure.

Figure : Subscribe Popup Menu

  1. First of all, right-click the project to which the developer wants to subscribe resource changes. Select ‘Trace resource > Subscribe’ pop-up menu.

  2. Select the check box of the service to subscribe to the Samsung API services displayed on the Samsung APIs table.

  3. Once the service to subscribe to is selected, click the ‘OK’ button to complete the subscription application. If a subscription is requested and registered in the server, the server will trace the resource changes.

    Figure : Subscribe Dialog

Notification Policy

The developer can manually set the method to check changes of the resources in which subscription is registered.

The setting method can be a periodical e-mail notification, manual refresh, or automatic refresh. The method can be set as described below.

Figure : Notification Policy Icon

  1. Click the ‘Notification Policy’ icon to register the notification policy. Then, the ‘Notification Policy’ pop-up window will appear.

  2. To receive the tracking results of the resource changes via e-mail, select the check box on the ‘Notification Policy’ window and input the e-mail address. This option can be selected together with ③.

  3. To refresh automatically when running the IDE tool, select the ‘Automatic refresh’ check box. This option can be selected together with ②.

  4. Select a notification interval for ② and ③. The interval can be daily, weekly, or monthly.

  5. Click the ‘Apply’ button to complete settings. The ‘Notification Policy’ setting will be saved in the remote server, and the change detail will be notified or refreshed at a defined interval from today.

    Figure : Notification Policy Dialog

Change History View

The developer can manually check the content of the subscribed and registered resource by clicking the ‘Refresh Resource Changes’ icon on the upper tool menu bar.

  1. Click the ‘Refresh Resource Changes’ icon on the upper tool menu bar and check the results in ‘Change History View’.

    Figure : Change History View

  2. ‘Change History View’ shows the resource change history by resource version in a tree structure, and the tree structure can be expanded by project or service. The result will be displayed on ‘Change History View’ when the ‘Refresh Resource Changes’ icon is clicked or the ‘Automatic refresh’ check box is selected from Notification Policy.

  3. Click the ‘Project’ button menu on the right upper side of ‘Change History View’ to display changes in tracking results by project.

  4. Click the ‘Service’ button menu on the right upper side of ‘Change History View’ to display changes in tracking results by service.

  5. Confirm resource id in Properties View for the resource comparison in Change Comparison View.

    Figure : Change History Sort

  6. When the version of the resource is clicked, which is displayed as the result on ‘Change History View’, the web document describing the resource will be displayed for the developer, as in ⑥.

  7. The resource description document will be displayed as an image in ‘Resource Document Dialog’. Click the ‘Close’ button to complete the function.

    Figure : Change History Sort

Change Comparison View

he developer can compare the changes of the registered resource by version.

That is, description documents with a different version for the same resource can be compared, as described below.

  1. A list of subscribed resource documents will be displayed in the combo box located on the left-side window of ‘Change Comparison View’. All lists are shown in the name of {resource id + change date}. The resource id can be confirmed in the step 5 of ‘Change History’.

  2. Select the resource version to compare with the version selected from the left side combo box, which is located on the right-side of ‘Change Comparison View’.

    Figure : Change Comparison View

  3. The resource documents selected from each combo box will be displayed on the below viewer.

  4. When the ‘▶’ button is clicked between two windows, the changes on the right-side resource document will be displayed in color, based on the left-size resource document.

  5. When the ‘●’ button is clicked between two windows, the resource documents on both sides will be restored to the original documents.

  6. When the ‘◀’ button is clicked between two windows, the changes on the left-side resource document will be displayed in color, based on the right-side resource document.

    Figure : Resource Document Comparison

  7. Figure below is the screen that shows the results of executing the ④ function. The result of ⑥ will be displayed in color on the left-side window.

    Figure : Resource Document Comparison Result

For more information

  1. How to Use (Video Tutorial) : For a user’s better understanding, video tutorials how to use this tool are found here.