Session: How to Get and Modify Entity Metadata

When a document is downloaded from the server, it contains various metadata information like ID or current change-vector. This information is stored in a session and is available for each entity using the getMetadataFor method from the advanced session operations.

Get the Metadata

session.advanced.getMetadataFor(entity);

Example

const employee = await session.load("employees/1-A");
const metadata = session.advanced.getMetadataFor(employee);

Modify the Metadata

After getting the metadata from session.advanced.getMetadataFor() you can modify it.

Example I

const user = new User();
user.name = "Idan";

await session.store(user);

const metadata = session.advanced.getMetadataFor(user);
metadata["Permissions"] = "READ_ONLY";
await session.saveChanges();

Example II

const user = await session.load("users/1-A");
const metadata = session.advanced.getMetadataFor(user);
metadata["Permissions"] = "READ_AND_WRITE";
await session.saveChanges();