Skip to main content

Update records

Updates the value of records by selected criteria

Function UpdateRecords(Val Table, Val ValueStructure, Val Filters = "", Val Connection = "", Val Tls = "") Export

ParameterCLI optionTypeRequiredDescription
Table--tableString✔Table name
ValueStructure--valuesStructure Of KeyAndValue✔Values structure: Key > field, Value > field value
Filters--filterArray of Structure✖Filters array. See GetRecordsFilterStrucutre
Connection--dbcString, Arbitrary✖Connection or connection string
Tls--tlsStructure Of KeyAndValue✖TLS settings, if necessary. See GetTlsSettings

Returns: Map Of KeyAndValue - Result of query execution


tip

Record data is specified as an array of structures of the following type:
{'Field name 1': {'Type': 'Value'}, 'Field name 2': {'Type': 'Value'},...}

List of available types is described on the initial page of the MSSQL library documentation


1C:Enterprise/OneScript code example
    Address  = "127.0.0.1";
    Login    = "SA";
    Password = "12we...";
    Base     = "test_data";

    TLSSettings      = OPI_MSSQL.GetTlsSettings(True);
    ConnectionString = OPI_MSSQL.GenerateConnectionString(Address, Base, Login, Password);

    Table = "test_data";

    FieldsStructure = New Structure;
    FieldsStructure.Insert("ip_address", New Structure("VARCHAR", "127.0.0.1"));

    Filters = New Array;

    FilterStructure = New Structure;

    FilterStructure.Insert("field", "gender");
    FilterStructure.Insert("type" , "=");
    FilterStructure.Insert("value", New Structure("NVARCHAR", "Male"));
    FilterStructure.Insert("raw"  , False);

    Filters.Add(FilterStructure);

    // When using the connection string, a new connection is initialised,
    // which will be closed after the function is executed.
    // If several operations are performed, it is desirable to use one connection,
    // previously created by the CreateConnection function()
    Result = OPI_MSSQL.UpdateRecords(Table, FieldsStructure, FilterStructure, ConnectionString, TLSSettings);
    # JSON data can also be passed as a path to a .json file
    
    oint mssql UpdateRecords \
     --table "test_data" \
     --values "{'ip_address':{'VARCHAR':'127.0.0.1'}}" \
     --filter "{'field':'gender','type':'=','value':{'NVARCHAR':'Male'},'raw':false}" \
     --dbc "Server=127.0.0.1;Database=***;User Id=SA;Password=***;" \
     --tls "{'use_tls':true,'accept_invalid_certs':true}"
Result
{
 "result": true
}