---
title: "system.opchda.insert"
description: "Insert values on the OPC-HDA server if the given item ID does not exist."
---

# system.opchda.insert

> Insert values on the OPC-HDA server if the given item ID does not exist.

This function is used in **Python Scripting**.

## Description
## Client Permission Restrictions
[Permission Type](projects\project-properties\project-properties.md#client---permissions): OPC Server Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
`system.opchda.insert(serverName, itemId, value, date, quality)`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|String |`serverName` | The name of the defined OPC-HDA server.|
|String| `itemId`| The item ID to perform the operation on.|
|Object |`value` |The value to insert.|
|Object|`date`| The date to insert.|
|int |`quality`| The quality to insert.|
### Returns
**QualityCode** - The result of the insert.
### Scope
All

## Code Examples
```python title="Example #1"
# This will insert the value for May 28th, 2014 at 5:42:33.
  
date = system.date.getDate(2014, 4, 28)
datetime = system.date.setTime(date, 5, 42, 33)
system.opchda.insert("MyHistoryServer", "MyItemId", 42.5, datetime, 192)
```