The Documents Screen

This screen gives an overview of all documents in the RavenDB server instance.

Documents listing

The documents are loaded from the database, newest first, and displayed with their ID and Collection name - documents from different collections are striped with different colors:

Figure 1: Documents listing

Information

A Collection in RavenDB is a group of documents sharing the same entity name. It is not a "database table", but rather a logical way of thinking of document groups.

Paging buttons are available above the documents list to allow you to go back and forth through it:

Paging Buttons

Next to that you will find a button allowing you to change the size of the document preview in the listing - from Compact view which only shows the collection name and the document id to Expanded view that will show the data of the document as a JSON string:

Figure 2: Changing the size of the document preview in listing

Either way, hovering over a document will show a tooltip with the document JSON representation:

Figure 3: Data tooltip

Editing a document

By double clicking on a document in the list, or clicking on the pencil icon on it, you get to the document editing screen.

The document ID - a unique key assigned to each document - is shown at the top of the form, and below that the document in its JSON representation is ready to be edited:

Figure 4: Editing a document

RavenDB saves additional data on each document, such as it's Collection association (Raven-Entity-Name), and all that info can be viewed and edited through the metadata tab:

Figure 5: Editing metadata

On the top right corner of this screen you will find several buttons:

  • Search
  • Save changes
  • Reformat Document: will remove empty line and fix indentation
  • Delete Document: to permanently delete the current document, will prompt before doing the delete
  • Refresh: will reload the document from the server
Top Right Corner Buttons

To the right of the form some statistics are shown - the metadata of the current document, formatted, and a list of possible reference found in it. Clicking on a reference will open that document for editing, if it exists in your database.

Document Fig 8

Other options

Back in the main listing screen, at the top right corner of the screen you will find 2 additional buttons:

Mailing List Screen Buttons

Clicking the "Edit document by Id" will pop-up an input box, where you can enter the document ID you wish to edit:

Editing the Document Id

If no document exists in the database for the ID you provide you will be redirected to the Documents tab, otherwise the Document edit page will load with the requested document.

Clicking the "Create a Document" button will open the document editing screen, but this time with empty fields. After providing a unique ID for the document and filling some data for it, clicking on Save will create it on the server.

For a new document created through the Studio the Raven-entity-Name metadata attribute which sets its collection is set by the text before the '/' in the provided ID (with first letter in capital), so the a document with ID "albums/626" will be assigned to the "Albums" collection.

If you have a a multi-tenant database set up, while browsing the documents in the Default Database tenant you will see one or more special documents titled "Sys Doc" with the names of the available tenants. Do not edit or delete this document - doing so might cause you to lose access to that tenant, although the actual data in it is not deleted.

Document Fig 2