Parameters:

Version:

• 15.4.5

Source:

• api/js/Operations.js, line 383

See:

• Entity
• Sorting
• Condition
• Conditions
• PaginationRequest

Returns:

Type

operation/js/api/Operation

Examples

Creates and performs Operation which reads multiple records of the Employee entity restricted by the given Condition.

require([
    'operation/js/api/Conditions',
    'operation/js/api/Operator'
], function(Conditions, Operator) {
    var employee = Abcs.Entities().findById('my.custom.bop.Employee');
    var firstName = employee.getProperty('firstName');
    var condition = Conditions.SIMPLE(firstName, Operator.EQUALS, 'Martin');
    var operation = Abcs.Operations().read({
        entity: employee,
        condition: condition
    });

    operation.perform().then(function(operationResult) {
        if (operationResult.isSuccess()) {
            // Insert code you want to perform after records are fetched
        }
    }).catch(function(operationResult) {
        if (operationResult.isFailure()) {
            // Insert code you want to perform if fetching of records failed
        }
    });
});

Creates and performs Operation reading records of the Employee entity sorted by their firstname in ascending order.

require([
    'operation/js/api/Sorting'
], function(Sorting) {
    var employee = Abcs.Entities().findById('my.custom.bop.Employee');
    var firstName = employee.getProperty('firstName');
    var operation = Abcs.Operations().read({
        entity: employee,
        sortBy: Sorting.ascending(firstName)
    });

    operation.perform().then(function(operationResult) {
        // Insert code for Success/Failure handling
    });
});

Fetch second page (assuming page is 15 records) of employees with firstname 'Martin'.

require([
    'operation/js/api/Conditions',
    'operation/js/api/Operator',
    'operation/js/api/PaginationRequest'
], function(
        Conditions,
        Operator
        PaginationRequest
) {
    var employee = Abcs.Entities().findById('my.custom.bop.Employee');
    var firstName = employee.getProperty('firstName');
    var condition = Conditions.SIMPLE(firstName, Operator.EQUALS, 'Martin');
    var pagination = PaginationRequest.createStandard({
        offset: 15,
        pageSize: 15
    });
    var operation = Abcs.Operations().read({
        entity: employee,
        condition: condition,
        pagination: pagination
    });

    operation.perform().then(function(operationResult) {
        // Insert code for Success/Failure handling
    });
});

Fetch all employee records and expand reference to Department so that it don't contain just ID but instead the whole department record is embedded.

require([
    'operation/js/api/ExpandableReference'
], function(
        ExpandableReference
) {
    // Creates an expandable reference for all relations between Employee and Department entities
    var employee = Abcs.Entities().findById('my.custom.bop.Employee');
    var department = Abcs.Entities().findById('my.custom.bop.Department');
    var deptRef = ExpandableReference.create(department);

    var operation = Abcs.Operations().read({
        entity: employee,
        expand: deptRef
    });

    operation.perform().then(function(operationResult) {
        // Insert code for Success/Failure handling
        // Result will contain main data with Employees and also each Employee will have Department record embedded
    });
});

(static) update(params) → {operation/js/api/Operation}

stable API

var employee = Abcs.Entities().findById('my.custom.bop.Employee');
var operation = Abcs.Operations().update({
    entity: employee,
    record: {
        firstName: 'Martin',
        lastName: 'Janicek',
        age: 29
    }
});

operation.perform().then(function(operationResult) {
    if (operationResult.isSuccess()) {
        // Insert code you want to perform after record being updated
    }
}).catch(function(operationResult) {
    if (operationResult.isFailure()) {
        // Insert code you want to perform if record update failed
    }
});