11.6.14 Editing Links

This section includes tests targeted at linked objects and the dialog box that displays information about linked objects.

Whenever possible, each test case should be performed under the following conditions:

The client application document is new.

The client application document has been obtained by opening a previously saved client application document.

The link in the client application document is not synchronized with the server application document object to which it refers.

Automatic Updating has been selected in the client application instance.

Manual Updating has been selected in the client application instance.

The client application, its document, server application, and its document are each in separate directories.

11.6.14.1 Editing Links when the Client Application Contains No Linked Objects Test Case Cli-24

Precondition

The client application contains no linked objects.

Postcondition

The Edit Links command should appear disabled.

11.6.14.2 Editing Links when the Client Application Has Linked Objects Test Case Cli-25

Precondition

The client application document contains linked objects.

Procedure

In the client application, open a document containing a linked object or create a new document and Paste Link an object into it.

Postcondition

The Edit Links command should be enabled.

11.6.14.3 Editing Links When No Server Applications Are Running Test Case Cli-26

Precondition

A client application is open with a document which contains the linked object.

No instance of the server application is running.

The document to which the link refers is available.

Procedure

1.Activate the Edit Link Properties... command.

The Link Properties dialog box is displayed.

2.In the dialog box, select the button used for opening the linked item in its editor (usually labeled Edit).

Postcondition

The Link Properties dialog box should be closed.

The document to which the link refers should be opened in a newly launched instance of the appropriate server application.

The appearance of the object in the client application instance should be synchronized with the server application document object to which it is linked.

11.6.14.4 Editing Links by Activating a Currently Running Server Application Instance Test Case Cli-27

Precondition

In the client application instance, a document containing a link is open.

The document to which the link refers is open in at least one currently running instance of the server application.

Procedure

1.Choose the Edit Link Properties... command.

2.In the dialog box, select the button used for opening the linked item in its editor (Edit).

Postcondition

The Link Properties dialog box should be closed.

The instance of the server application, that has the document to which the link refers, is open should be activated.

The object in the client application instance should be the same as the server application item to which it is linked.

The Postcondition for link activation should be in effect.

11.6.14.5 Editing Links Unsuccessfully Test Case Cli-28

Precondition

In the client application instance, a document containing a linked object is open.

One or more of the following two conditions exists. Either the linked object's server application is unavailable or the document to which the link refers is unavailable. It is necessary to test for each case.

Procedure

1.Choose Edit Links ... to display the Link Properties dialog box.

2.In the dialog box, select the button used for opening the linked item in its editor (Edit).

Postcondition

An Attempt to open the link for editing should fail.

The Links dialog box should not disappear. The Links dialog box should allow the user to repair the broken link.

11.6.14.6 Changing the Properties of Linked Objects Test Case Cli-29

Precondition

In the client application instance, a document containing a link is open.

Procedure

1.Choose the Edit Links command.

2.In the Link Properties dialog box, make one or more changes (such as changing Update from automatic to manual).

3.In the dialog box, select the button used for opening the linked item in its editor.

Postcondition

The changes made in the dialog box should be accepted, just as if the OK button had been pressed.

11.6.14.7 Validating Information in a Client Application Link Properties Dialog Box Test Case Cli-30

Precondition

A client application contains linked and embedded objects.

Procedure

Choose the Edit Links command.

Postcondition

The client application displays a Link Properties dialog box that lists all of the linked objects in the document, but none of the embedded objects. For information on the Link Properties dialog box, see Chapter 3, "The OLE User Interface."

11.6.14.8 Manually Updating a Link When a Server Application Document is Open Test Case Cli-31

Precondition

The server application allows linking of its objects.

The client application creates the linked object for automatic updating. It does not change the update option for the linked object; automatic is the default.

Procedure

1.Open a server application document and select an item to copy to the clipboard.

2.Choose Edit Copy to copy the item.

3.In the client application instance, choose Edit Paste Link to create a linked object.

4.In the client application instance, display the Link Properties dialog box.

5.Select the Manual Option.

6.Select OK to accept changes.

7.In the server application instance, make changes to the item to which the client application document is linked.

Changes made to the item in the server application instance should not change the appearance of the item in the client application document.

8.In the client application instance, choose Edit Links to display the Link Properties dialog box.

9.Choose the button used to force updating (Update Now).

Postcondition

All changes made to the item in the server application instance should be reflected in the appearance of the item in the client application document.

Similar Test Cases

Repeat the procedure, selecting Cancel in step 9. The item in the client application document should revert back to its state from before the Link Properties dialog box was displayed.

The client application, its document, the server application, and its document are all in separate directories.

After each test, save the client application document and reopen it to see if the changes were properly saved and activation of the saved item works correctly.

11.6.14.9 Disconnecting a Linked Object from its Source Test Case Cli-32

After each test, save the client application document and reopen it to see if the changes were properly saved and activation of the saved object works as expected.

Precondition

A client application document contains a linked object.

Procedure

1.Choose Edit Link Properties to display the Link Properties dialog box.

2.Select the button used to disconnect a link from the item to which it refers (usually labeled Cancel Link).

The buttons used for opening a link for editing should be disabled.

The buttons Update Now and Cancel link should be disabled.

3.Choose OK.

Postcondition

The object is converted to a static object and double-clicking the object should not cause an error. The client application should inform the user that it is a static object.

Similar Test Case

Repeat the above procedure; select Cancel if the unlinking can be canceled. The unlinking should be canceled and the object should behave as a normal linked object.

11.6.14.10 Changing a Link Using the Link Properties Dialog Box Test Case Cli-33

After each test, save the client application document and reopen it to see if the changes were properly saved and that activating the saved item works as expected.

Precondition

A client application document contains a link to an object in a server application document.

Procedure

1.Change the name of the server application document containing the object to which the client application document is linked.

Activating the link should fail.

Opening the link for editing using the Link Properties dialog box should fail.

Updating the link's presentation using the Link Properties dialog box should fail.

2.Choose Edit Link Properties to display the Link Properties dialog box.

3.Select the Change Link button. In the new change link dialog box, select the new file name.

4.Select OK.

Postcondition

The Link Properties dialog box closes.

The link should now be re-connected to the newly named server application document, and link activation and updating behave as expected.