Share via

2.5.1 Creating a SharePoint Document Library File from the Client Console

  • Article

This use case describes the simplest way to create a file using the protocols covered in this system. The actor in this case is the user who is creating the text file hello.txt in a Windows SharePoint Services document library. The text file contains the text "hello". For details regarding a scenario of this type, see the example Create File from Client in section 3.4.

Create file from client computer

Figure 4: Create file from client computer

Preconditions

  • The user has read/write access permissions to an existing SharePoint document library called http://server/site/doclib.

  • The user is logged on to a client computer running the Windows 7 operating system<1> with an authenticated Windows session, and can access the Windows SharePoint Services site containing the document library.

  • From a command prompt window, the user types the following command:

    echo hello >\\server\site\doclib\hello.txt

Main Flow

  1. The user types the echo command and presses Enter.

  2. The Windows SharePoint Services front-end web server authenticates the user.

  3. Windows SharePoint Services finds the location of the document library and verifies that the user has the appropriate access permissions.

  4. Windows SharePoint Services creates an empty file in the document library and confirms successful creation of the file back to the client.

  5. The client updates the file properties and the file contents.

Error Scenarios

  • The user does not have the appropriate access permissions: The client notifies the user that access is denied.

  • The client cannot connect to the Windows SharePoint Services front-end web server: The client notifies the user of the connection error.

  • The client cannot update the file properties or file contents: The client notifies the user of the file write properties or file contents write error.