Dataset Items

What is an Item?

An Item represents the raw data for a record held within Orgvue. It is the most granular unit of information held in a dataset, and supports a number of security rules. These rules can be based on item property values or property existence for example. Items are not exactly equivalent to dataset nodes, as they lack generated properties (including properties derived from building the dataset hierarchy) and calculated properties (those calculated by evaluating Gizmo expressions).

Updating Items in a dataset

Orgvue's "Sync import" endpoint is a lightweight way of interacting with data in a dataset, that does not perform any calculations. You must provide a payload containing a list of Item actions (CRUD operations) that Orgvue then processes per-action. Each action in the list is described in terms of raw value changes to be made.

[
  {
    "_action": "create",
    "EmployeeID": "P1222",
    "ManagerId": "P522",
    "StartDate": "2022-01-02",
    "Salary": 34500,
    "PositionTitle": "Consultant",
    "Grade": 4
  },
]