11.6.1 Closing a Document - Client Application Tests

From the user's perspective, the client application must terminate all active conversations related to the objects in the document between client and server applications. The client application should also prompt the user to update any changes to the object when saving the document.

From the developer's perspective, the client application should check for any active conversations for the objects in the document to be closed. The application should prompt the user to update the objects, using data provided by the server application(s). If an update is required, the client application should call OleUpdate to get the data from the servers and call OleRelease to release all the objects. This will close all of the active conversations.

The client application should also call OleRevokeClientDoc to revoke the document being closed.

11.6.1.1 Closing a Client Application Document after Starting an Edit Session in the Server Application Test Case Cli-13

Precondition

The client application and multiple server applications contain embedded objects. The server applications are started from the client application by invoking Edit on the associated embedded objects.

Procedure

1.Change an object in one of the server applications.

2.Choose File Close in the client application to close the document.

Postcondition

The client application should prompt to update and save the latest copies of objects. If the document has not been named, the client application will prompt for a valid name.

All of the server application's documents that were invoked by the client application should be closed.

Any server application documents that was opened by a user should not be closed.

Similar Test Case

Try this test with different types of embedded objects.

11.6.1.2 Closing a Client Application Document Containing Linked Objects Test Case Cli-14

Precondition

A client application is open with linked objects. There is at least one linked server application document with an open link and one linked object that does not have an open link to its document.

Procedure

1.For the object that does not have an open link, open its container document with the server application and modify it.

Save the document. The object in the client application should remain unmodified.

2.Choose File Close to close the document.

Postcondition

The linked objects should not be closed.

The client application should prompt the user to update and save the latest copies of the objects. If the user chooses to update the objects, the client application should update the objects and save them to document.

Similar Test Cases

Try this test and establish the link conversation by double-clicking the object and choosing Edit Paste Link while the server application is running.

Try closing the client application document when it has a connection to the server application and the server application is blocked or busy. (Use SRTEST.EXE if necessary.)