Table of Contents

Method SetParametersIndex

Namespace
Skyline.DataMiner.Scripting
Assembly
SLManagedScripting.dll

SetParametersIndex(int[], int[], int[], object[], DateTime[])

Sets the value of cells in tables, identified by their 1-based row and column position, with the specified values.
Note that this method should not be used. Using SetParametersIndexByKey(int[], string[], int[], object[], DateTime[]) instead is highly recommended.

object SetParametersIndex(int[] ids, int[] iXs, int[] iYs, object[] values, DateTime[] timeInfos)

Parameters

ids int[]

The IDs of the table parameters.

iXs int[]

The 1-based positions of the rows.

iYs int[]

The 1-based positions of the columns.

values object[]

The values to set.

timeInfos DateTime[]

Timestamps.

Returns

object

This method call can return an unsigned integer error code, e.g. when the size of the ids array does not match the size of the values array. Otherwise a uint[] is returned that has the same size as the ids array containing the HRESULT value.At each position, this array contains the result value as would be returned when performing a SetParameterIndex call on the individual cell.In case the value in the array is 262730 (0x0004024AL), this indicates the cell value changed.

Remarks

  • Prior to DataMiner 10.2.7 (RN 33198), the SetParametersIndex method cannot be used to update a single cell. In case a single cell must be updated, use the SetParameterIndex method instead. In cases where you dynamically set a number of cells, make sure to check the number of cells that will need to be updated. In case multiple cells need to be updated, use the SetParametersIndex method. If a single cell needs to be updated, use the SetParameterIndex method.
  • This method should only be used in case multiple distinct cells need to be set(e.g., cells in different tables). When appropriate, use the SetRow, FillArray, FillArrayNoDelete, NotifyProtocol type 220 call, etc.to set multiple cells belonging to the same row, column or table, respectively.
  • This method acts as a wrapper for a NotifyProtocol type 121 NT_PUT_PARAMETER_INDEX call.
  • Feature introduced in DataMiner version 8.0.3.
  • From DataMiner 10.2.9 onwards (RN 33849), if the DateTime.Kind property of an entry of timeInfos is unspecified, the timestamp of that entry will be handled as local time.
  • The sets are processed in the order that they appear within the provided arrays.

SetParametersIndex(int[], int[], int[], object[])

Sets the value of cells in tables, identified by their 1-based row and column position, with the specified values.
Note that this method should not be used. Using SetParametersIndexByKey(int[], string[], int[], object[]) instead is highly recommended.

object SetParametersIndex(int[] ids, int[] iXs, int[] iYs, object[] values)

Parameters

ids int[]

The IDs of the table parameters.

iXs int[]

The 1-based positions of the rows.

iYs int[]

The 1-based positions of the columns.

values object[]

The values to set.

Returns

object

This method call can return an unsigned integer error code, e.g. when the size of the ids array does not match the size of the values array.Otherwise a uint[] is returned that has the same size as the ids array containing the HRESULT value.At each position, this array contains the result value as would be returned when performing a SetParameterIndex call on the individual cell.In case the value in the array is 262730 (0x0004024AL), this indicates the cell value changed.

Remarks

  • Prior to DataMiner 10.2.7 (RN 33198), the SetParametersIndex method cannot be used to update a single cell. In case a single cell must be updated, use the SetParameterIndex method instead. In cases where you dynamically set a number of cells, make sure to check the number of cells that will need to be updated. In case multiple cells need to be updated, use the SetParametersIndex method. If a single cell needs to be updated, use the SetParameterIndex method.
  • This method should only be used in case multiple distinct cells need to be set (e.g., cells in different tables). When appropriate, use the SetRow, FillArray, FillArrayNoDelete, NotifyProtocol type 220 call, etc.to set multiple cells belonging to the same row, column or table, respectively.
  • This method acts as a wrapper for a NotifyProtocol type 121 NT_PUT_PARAMETER_INDEX call.
  • Feature introduced in DataMiner version 8.0.3.
  • The sets are processed in the order that they appear within the provided arrays.