Manual Validation

Your WOPI integration can be tested using the steps outlined in Using the validator application to validate your WOPI implementation. However, the validator app will not be able to test the complete end-to-end experience. You must run the following tests manually to verify the integration works correctly.

Please download the Testing document and fill it in as you perform your testing. After both the validator and manual tests are both 100% passing, please provide Microsoft with a link to your validator app, your test account information and manual test results document. Microsoft will complete a final test pass before launch.

Please contact Microsoft for directions to set the Office for iOS apps into a test mode that can be used for testing the below scenarios.

Note

  • “Company app/application” refers to your app.

  • “Company service” refers to your service.

  • Where it refers to “Office”, please substitute Word, Excel and PowerPoint app. The tests should be re-run against each Office application.

  • Please note the version of the Office app you tested against. This information can be found under Settings ‣ [App] ‣ Version

1 - Open from company app - first install

This test verifies the flow of using Office for the first time from the Company app. Repeat for each supported file type and each Office app.

  1. Start with a fresh install of Company app. Ensure Office is not installed.

  2. Boot up company app and login.

RESULT: General promotion for Office should be shown the first time after upgrading the company app.

  1. Browse to a supported file type

RESULT: “Open with Microsoft [app]” promotion, drawing attention to control and enabling open with Office once per first open for each supported file type. “Open with Microsoft [app]” should be top choice if multiple choices are available. If a list is not shown, Office should be the default app for opening the file.

  1. Activate control to open in Office

RESULT: User should be sent to app store page for the corresponding app.

  1. Install the Office app.

  2. After installation, go back to the Company app and activate the control to open in Office again.

RESULT: Office should start. User should be prompted for credentials to Company Service.

  1. Enter credentials for company service.

RESULT: File should open in read only mode.

  1. Click Sign In and sign in with a free Microsoft Account.

RESULT: File should open in edit mode if user is a consumer and read-only mode if the user is a commercial user.

  1. Make changes (you will need to sign in with a subscription account for testing commercial user)

  2. Click Back (<-)

  3. Click Open

RESULT: Confirm company service is shown as a place.

2 - Open from Office for iOS - fresh install

This test verifies the flow of using Company Service for the first time from Office.

  1. Launch a fresh install of Office.

  2. Go through the First Run Experience.

  3. Skip Sign In.

  4. Go to Open ‣ Add a Place

RESULT: Company service shows up. Verify the name and icon of your service.

  1. Select your Company Service.

  2. Enter credentials.

RESULT: Root folder should show.

  1. Browse around the folder structure in your service.

RESULT: Browse works as expected.

  1. Open a file from Browse.

RESULT: File should open in read-only mode.

  1. Click Sign In and sign in with a free Microsoft Account.

RESULT: File should open in edit mode if user is a consumer and read-only mode if the user is a commercial user.

  1. Make changes (you will need to sign in with a subscription account for testing commercial user).

  2. Click Back (<-).

  3. Click Open.

RESULT: File should have the previously saved changes. Ensure changes are being saved on Company service.

3 - Open from company app - repeat usage

Repeat test 1 except with company service already added (i.e. from previous usage).

4 - Open from Office for iOS - repeat usage

Repeat test 2 except with company service already added (i.e. from previous usage).

5 - Save as/duplicate

Verify ability to duplicate a file to Company Service, both by adding a new place and using an existing place.

A screenshot that shows the document actions in |Office iOS|.

Figure 3 A screenshot that shows the document actions in Office for iOS.

6 - Create new [name]

Verify ability to create a new file saved to Company Service, both by adding a new place and using an existing place.

7 - Verify licensing

Verify editing a file for a commercial user requires O365 subscription or else it opens read only.

Important

Go to Settings ‣ [Microsoft App] ‣ Reset Word ‣ Delete Sign-In Credentials and restart Office before doing this test.

8 - OAuth login page

Verify there is a link to the company’s privacy statement on the company’s login page when the user adds the company service as a place.

Verify login page fits in window for various iPad and iPhone sizes.

9 - Verify file properties

Verify file properties from Recent and from opened file. When opening the properties from the Recent tab or the Open tab, the fields Author, Created, Modified By and Company will be empty.

Screenshot that shows document properties in Office.

Figure 4 Properties view from Recent

A screenshot that shows the document properties within the opened file.

Figure 5 Properties view from within a document

10 - Change passwords

This test verifies the flow of using Company Service after the user changed passwords.

Note

This test changes based on how the Company Service handles authentication and refresh/access tokens. If you invalidate the access and refresh token after the user changes password, run this test. You can adapt this test to ensure the Office app is handling refresh and access tokens correctly.

  1. Launch a fresh install of Office.

  2. Go through the First Run Experience.

  3. Skip Sign In.

  4. Go to Open ‣ Add a Place

  5. Select your Company Service.

  6. Enter credentials.

  7. Browse around the folder structure in your service.

  8. Open a file from Browse.

  9. Click sign in and sign in with a free Microsoft Account.

  10. Make changes (you will need to sign in with a subscription account for testing commercial user)

  11. Click Back

  12. On the Company Service app, change the password of the user.

  13. Open the Office for iOS app and browse to the Company Service and open a file.

RESULT: You should be prompted to enter credentials again.