Table of Contents

NT_SET_ROW (225)

Sets the data of the specified row to the specified values.

Parameters

Preforming a set on the local element:

object[] rowDetails = new object[]{1000, "Row 5"};
object[] rowData = new object[] { null, 4, "Main" };
object result = protocol.NotifyProtocol(225, rowDetails, rowData);

if (result != null)
{
    object[] res = (object[])result;

    ////...
}
else
{
    ////...
}
  • rowDetails (object[]): The details specifying the row:
    • rowDetails[0]: table ID.
    • rowDetails[1]: (string) primary key.
    • rowDetails[2]: (DateTime) timestamp (optional).
    • rowDetails[3]: (bool) enableCellActions: When set to true, protocol.Clear and protocol.Leave can be used as cell values, which will clear or preserve the cell content, respectively. (Optional, default: false.)
  • rowData (object[]): The row data to set. In order to preserve the value of a cell, provide a null reference for that cell.

Performing a set on a remote element:

int dmaId = protocol.DataMinerID;
int elementId = protocol.ElementID;
int tableId = 6000;
string primaryKey = "1";
object[] rowDetails = new object[4];

rowDetails[0] = dmaId;
rowDetails[1] = elementId;
rowDetails[2] = tableId;
rowDetails[3] = primaryKey;

object[] rowData = new object[] { null, "test" };
object[] result = (object[]) protocol.NotifyDataMiner(225 /*NT_SET_ROW*/, rowDetails, rowData);
  • rowDetails (object[]): The details specifying the row.
    • rowDetails[0]: (int) DataMiner Agent ID.
    • rowDetails[1]: (string) element ID.
    • rowDetails[2]: (int) table parameter ID.
    • rowDetails[3]: (string) primary key.
  • rowData (object[]): The row data to set. In order to preserve the value of a cell, provide a null reference for that cell.

Return Value

  • (object): In case the call was executed, an object[] is returned. The length of this array equals the length of the rowData array.

Remarks

  • The SLProtocol interface defines a wrapper method "SetRow" for this call. See SLProtocol.SetRow method.
  • On a table with the AutoAdd option with a key that does not exist yet, NT_SET_ROW (225) will ignore protocol.Leave and protocol.Clear values. The "use clear and leave" flag must be set to true.