---
title: "system.opchda.insert"
description: "Insert values on the OPC-HDA server."
---

# system.opchda.insert

> Insert values on the OPC-HDA server.

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

## Description
## Client Permission Restrictions
[Permission Type](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties): 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.
Any| `value` | The value to insert.
Any| `date` | The date to insert.
Integer| `quality` | The quality to insert.

### Returns
**QualityCode** - The result of the insert. See [Scripting Object Reference](../../reference-pages/scripting-object-reference/scripting-object-reference.md#qualitycode).
### Scope
Gateway, Vision Client, Perspective Session

## 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)
```