# Object management

Object management makes it possible to manage Objecten API objects inside Valtimo.

## Dependencies

In order to use Object management, the Object management module needs to be added as a dependency.

### Backend

The samples below assume the [valtimo-dependency-versions](/fundamentals/getting-started/modules/core/valtimo-dependency-versions.md) module is used. If not, please specify the artifact version as well.

#### Maven dependency:

```xml

<dependencies>
  <dependency>
    <groupId>com.ritense.valtimo</groupId>
    <artifactId>object-management</artifactId>
    <version>${valtimo_version}</version>
  </dependency>
</dependencies>
```

#### Gradle dependency:

```kotlin
dependencies {
    implementation("com.ritense.valtimo:object-management")
}
```

### Frontend

Two packages are required to make use of Object management.

The object-management package makes it possible to manage objecttypen from the Objecttypen API directly in Valtimo:

`@valtimo/object-management`

The object package makes it possible to view, create, update and delete objects from the Objecten API directly in Valtimo:

`@valtimo/object`.

Both dependencies contain a module that has to be added to the `app.module.ts`:

```ts
imports: [
    ...
    ObjectModule,
    ObjectManagementModule
]
```

#### Menu items

Object management is disabled by default. After including the packages, the menu items are not yet visible. Some additional steps are required.

**Enable the feature toggle**

```json
{
  featureToggles: {
    enableObjectManagement: true
  }
}
```

**Include object-management to the Valtimo menu**

The object routing needs to be added to the menu in the environment file:

```json
{
  roles: [
    ROLE_ADMIN
  ],
  title: 'Objects',
  iconClass: 'icon mdi mdi-archive',
  sequence: 3,
  includeFunction: IncludeFunction.ObjectManagementEnabled
}
```

**Include objects to the Valtimo menu**

The object-management routing needs to be added to the menu in the environment file:

```json
{
  roles: [
    ROLE_ADMIN
  ],
  title: 'Admin',
  iconClass: 'icon mdi mdi-tune',
  sequence: 6,
  children: [
    {
      link: [
        '/object-management'
      ],
      title: 'Objects',
      sequence: 1
    }
  ]
}
```

## Suppressing the outbox

Object management configurations support a `suppressOutbox` property that prevents outbox messages from being created during object API calls. This is useful for read-heavy integrations where outbox overhead is unnecessary.

Set `suppressOutbox` to `true` in the object management JSON configuration:

```json
{
    "title": "my-objects",
    "objectenApiPluginConfigurationId": "...",
    "objecttypenApiPluginConfigurationId": "...",
    "objecttypeId": "...",
    "suppressOutbox": true
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.valtimo.nl/fundamentals/getting-started/modules/zgw/object-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.