MakeSystemEntity

Method clears an existing entity's owner and updates the ACL on the server.

This method is affected by versioning. See the versioning documentation for more information.

Service	Operation
globalEntity	MAKE_SYSTEM_ENTITY

Usage

http://localhost:3000

C#

string entityId = "a-entity-id";
int version = 2;
ACL jsonEntityAcl = new ACL(ACL.Access.Read);
SuccessCallback successCallback = (response, cbObject) =>
{
    Debug.Log(string.Format("Success | {0}", response));
};
FailureCallback failureCallback = (status, code, error, cbObject) =>
{
    Debug.Log(string.Format("Failed | {0}  {1}  {2}", status, code, error));
};

_bc.GlobalEntityService.MakeSystemEntity(entityId, version, jsonEntityAcl, successCallback, failureCallback);

C++

const char *entityId = "a-entity-id";
int version = 2;
const char *jsonEntityAcl = "{\"other\":1}";

_bc->getGlobalEntityService()->makeSystemEntity(entityId, version, jsonEntityAcl, this);

Objective-C

NSString *entityId = @"a-entity-id";
int version = 2;
NSString * jsonEntityAcl = [ACL getAclJson:Read];
BCCompletionBlock successBlock;      // define callback
BCErrorCompletionBlock failureBlock; // define callback

[[_bc globalEntityService] makeSystemEntity:entityId
                    version:version
              jsonEntityAcl:jsonEntityAcl
            completionBlock:successBlock
       errorCompletionBlock:failureBlock
                   cbObject:nil];

Java

String entityId = "a-entity-id";
int version = 2;
String jsonEntityAcl = "{\"other\":1}";
this; // implements IServerCallback

_bc.getGlobalEntityService().makeSystemEntity(entityId, version, jsonEntityAcl, this);

public void serverCallback(ServiceName serviceName, ServiceOperation serviceOperation, JSONObject jsonData)
{
    System.out.print(String.format("Success | %s", jsonData.toString()));
}
public void serverError(ServiceName serviceName, ServiceOperation serviceOperation, int statusCode, int reasonCode, String jsonError)
{
    System.out.print(String.format("Failed | %d %d %s", statusCode,  reasonCode, jsonError.toString()));
}

JavaScript

var entityId = "a-entity-id";
var version = 2;
var jsonEntityAcl = {
    "other": 1
};

_bc.globalEntity.makeSystemEntity(entityId, version, jsonEntityAcl, result =>
{
    var status = result.status;
    console.log(status + " : " + JSON.stringify(result, null, 2));
});

Dart

var  entityId = "a-entity-id";
var  version = 2;
var  jsonEntityAcl = {
    "other": 1
};

ServerResponse result = await _bc.globalEntityService.makeSystemEntity(entityId:entityId, version:version, jsonEntityAcl:jsonEntityAcl);

if (result.statusCode == 200) {
    print("Success");
} else {
    print("Failed ${result.error['status_message'] ?? result.error}");
}

Cloud Code

var entityId = "a-entity-id";
var version = 2;
var jsonEntityAcl = {
    "other": 1
};
var globalEntityProxy = bridge.getGlobalEntityServiceProxy();

var postResult = globalEntityProxy.makeSystemEntity(entityId, version, jsonEntityAcl);
if (postResult.status == 200) {
    // Success!
}

Raw

{
    "service": "globalEntity",
    "operation": "MAKE_SYSTEM_ENTITY",
    "data": {
        "entityId": "the-entity-id",
        "version": 2,
        "acl": {
            "other": 1
        }
    }
}

JSON Response

{
    "status": 200,
    "data": {
        "gameId": "123456",
        "entityId": "14281c38-abf6-4ca2-8436-b2bdwas8d5a9a",
        "ownerId": null,
        "entityType": "test",
        "entityIndexedId" : "indexTest",
        "version": 1,
        "data": {
            "testData": 1234
        },
        "acl": {
            "other": 1
        },
        "expiresAt": 1449861422588,
        "timeToLive": 34567,
        "createdAt": 1449861388021,
        "updatedAt": 1449861388021
    }
}

Common Error Code

Status Codes

Code	Name	Description
40344	ENTITY_VERSION_MISMATCH	The version passed in does not match the version of the entity on the server
40531	ACL_NOT_READABLE	The acl passed does not the minimum permissions required for system entities (readable/other)

Method Parameters

Parameter	Description
entityId	The id of the entity to update
version	The version of the entity to update. Use -1 to indicate the newest version
jsonEntityAcl	The entity's Access Control List as json.