Chilkat Online Tools

PureBasic / Salesforce Platform APIs / Tooling Run Tests Sync

Back to Collection Items

IncludeFile "CkJsonArray.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkJsonObject.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    ; Use this online tool to generate code from sample JSON: Generate Code to Create JSON

    ; The following JSON is sent in the request body.

    ; [
    ;   {
    ;     "className": "YourClassName",
    ;     "testMethods": [
    ;       "testMethod1",
    ;       "testMethod2",
    ;       "testMethod3"
    ;     ]
    ;   },
    ;   {
    ;     "maxFailedTests": "2"
    ;   }
    ; ]

    jarr.i = CkJsonArray::ckCreate()
    If jarr.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonArray::ckAddObjectAt(jarr,-1)
    jsonObj_1.i = CkJsonArray::ckObjectAt(jarr,CkJsonArray::ckSize(jarr) - 1)
    CkJsonObject::ckUpdateString(jsonObj_1,"className","YourClassName")
    CkJsonObject::ckUpdateString(jsonObj_1,"testMethods[0]","testMethod1")
    CkJsonObject::ckUpdateString(jsonObj_1,"testMethods[1]","testMethod2")
    CkJsonObject::ckUpdateString(jsonObj_1,"testMethods[2]","testMethod3")
    CkJsonObject::ckDispose(jsonObj_1)

    CkJsonArray::ckAddObjectAt(jarr,-1)
    jsonObj_1 = CkJsonArray::ckObjectAt(jarr,CkJsonArray::ckSize(jarr) - 1)
    CkJsonObject::ckUpdateString(jsonObj_1,"maxFailedTests","2")
    CkJsonObject::ckDispose(jsonObj_1)

    ; Adds the "Authorization: Bearer <access_token>" header.
    CkHttp::setCkAuthToken(http, "<access_token>")
    CkHttp::ckSetRequestHeader(http,"Content-Type","application/json")

    sbRequestBody.i = CkStringBuilder::ckCreate()
    If sbRequestBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonArray::ckEmitSb(jarr,sbRequestBody)

    resp.i = CkHttpResponse::ckCreate()
    If resp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkHttp::ckHttpSb(http,"POST","https://domain.com/services/data/v{{version}}/tooling/runTestsSynchronous",sbRequestBody,"utf-8","application/json",resp)
    If success = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonArray::ckDispose(jarr)
        CkStringBuilder::ckDispose(sbRequestBody)
        CkHttpResponse::ckDispose(resp)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)

    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttp::ckDispose(http)
        CkJsonArray::ckDispose(jarr)
        CkStringBuilder::ckDispose(sbRequestBody)
        CkHttpResponse::ckDispose(resp)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "apexLogId": "07L4H00000SpGroUAF",
    ;   "codeCoverage": [
    ;     {
    ;       "id": "01q4H000000WjD8QAK",
    ;       "locationsNotCovered": [
    ;         {},
    ;         {}
    ;       ],
    ;       "name": "StateTrigger",
    ;       "namespace": null,
    ;       "numLocations": 2,
    ;       "numLocationsNotCovered": 2,
    ;       "type": "Trigger"
    ;     },
    ;     {
    ;       "id": "01q58000000RLTyAAO",
    ;       "locationsNotCovered": [
    ;         {},
    ;         {},
    ;         {}
    ;       ],
    ;       "name": "RestrictContactByName",
    ;       "namespace": null,
    ;       "numLocations": 3,
    ;       "numLocationsNotCovered": 3,
    ;       "type": "Trigger"
    ;     },
    ;     {
    ;       "id": "01q58000000RLBhAAO",
    ;       "locationsNotCovered": [
    ;         {},
    ;         {},
    ;         {},
    ;         {},
    ;         {},
    ;         {}
    ;       ],
    ;       "name": "ClosedOpportunityTrigger",
    ;       "namespace": null,
    ;       "numLocations": 6,
    ;       "numLocationsNotCovered": 6,
    ;       "type": "Trigger"
    ;     },
    ;     {
    ;       "id": "01p4H000009PEFIQA4",
    ;       "locationsNotCovered": [
    ;         {},
    ;         {}
    ;       ],
    ;       "name": "PrepareSandbox",
    ;       "namespace": null,
    ;       "numLocations": 22,
    ;       "numLocationsNotCovered": 2,
    ;       "type": "Class"
    ;     }
    ;   ],
    ;   "codeCoverageWarnings": [
    ;     {
    ;       "id": "01q4H000000WjD8QAK",
    ;       "message": "Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required",
    ;       "name": "StateTrigger",
    ;       "namespace": null
    ;     },
    ;     {
    ;       "id": "01q58000000RLTyAAO",
    ;       "message": "Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required",
    ;       "name": "RestrictContactByName",
    ;       "namespace": null
    ;     },
    ;     {
    ;       "id": "01q58000000RLBhAAO",
    ;       "message": "Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required",
    ;       "name": "ClosedOpportunityTrigger",
    ;       "namespace": null
    ;     },
    ;     {
    ;       "id": "01q4H000000WjD8QAK",
    ;       "message": "Average test coverage across all Apex Classes and Triggers is 60%, at least 75% test coverage is required.",
    ;       "name": null,
    ;       "namespace": ""
    ;     }
    ;   ],
    ;   "failures": [
    ;   ],
    ;   "flowCoverage": [
    ;   ],
    ;   "flowCoverageWarnings": [
    ;   ],
    ;   "numFailures": 0,
    ;   "numTestsRun": 1,
    ;   "successes": [
    ;     {
    ;       "id": "01p4H00000A0zYxQAJ",
    ;       "methodName": "runApexClass_should_work",
    ;       "name": "PrepareSandboxTest",
    ;       "namespace": null,
    ;       "seeAllData": false,
    ;       "time": 1088
    ;     }
    ;   ],
    ;   "totalTime": 1261
    ; }

    ; Sample code for parsing the JSON response...
    ; Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    id.s
    name.s
    namespace.s
    numLocations.i
    numLocationsNotCovered.i
    v_type.s
    j.i
    count_j.i
    message.s
    methodName.s
    seeAllData.i
    time.i

    apexLogId.s = CkJsonObject::ckStringOf(jResp,"apexLogId")
    numFailures.i = CkJsonObject::ckIntOf(jResp,"numFailures")
    numTestsRun.i = CkJsonObject::ckIntOf(jResp,"numTestsRun")
    totalTime.i = CkJsonObject::ckIntOf(jResp,"totalTime")
    i.i = 0
    count_i.i = CkJsonObject::ckSizeOfArray(jResp,"codeCoverage")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        id = CkJsonObject::ckStringOf(jResp,"codeCoverage[i].id")
        name = CkJsonObject::ckStringOf(jResp,"codeCoverage[i].name")
        namespace = CkJsonObject::ckStringOf(jResp,"codeCoverage[i].namespace")
        numLocations = CkJsonObject::ckIntOf(jResp,"codeCoverage[i].numLocations")
        numLocationsNotCovered = CkJsonObject::ckIntOf(jResp,"codeCoverage[i].numLocationsNotCovered")
        v_type = CkJsonObject::ckStringOf(jResp,"codeCoverage[i].type")
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"codeCoverage[i].locationsNotCovered")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            j = j + 1
        Wend
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"codeCoverageWarnings")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        id = CkJsonObject::ckStringOf(jResp,"codeCoverageWarnings[i].id")
        message = CkJsonObject::ckStringOf(jResp,"codeCoverageWarnings[i].message")
        name = CkJsonObject::ckStringOf(jResp,"codeCoverageWarnings[i].name")
        namespace = CkJsonObject::ckStringOf(jResp,"codeCoverageWarnings[i].namespace")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"failures")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"flowCoverage")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"flowCoverageWarnings")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"successes")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        id = CkJsonObject::ckStringOf(jResp,"successes[i].id")
        methodName = CkJsonObject::ckStringOf(jResp,"successes[i].methodName")
        name = CkJsonObject::ckStringOf(jResp,"successes[i].name")
        namespace = CkJsonObject::ckStringOf(jResp,"successes[i].namespace")
        seeAllData = CkJsonObject::ckBoolOf(jResp,"successes[i].seeAllData")
        time = CkJsonObject::ckIntOf(jResp,"successes[i].time")
        i = i + 1
    Wend


    CkHttp::ckDispose(http)
    CkJsonArray::ckDispose(jarr)
    CkStringBuilder::ckDispose(sbRequestBody)
    CkHttpResponse::ckDispose(resp)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: application/json"
	-d '[
    {
        "className": "YourClassName",
        "testMethods": [
            "testMethod1",
            "testMethod2",
            "testMethod3"
        ]
    },
    {
        "maxFailedTests": "2"
    }
]

or

{
    "tests": [
        {
            "className": "YourClassName",
            "testMethods": [
                "testMethod1",
                "testMethod2",
                "testMethod3"
            ]
        }
    ],
    "maxFailedTests": "integer value",
    "testLevel": "TestLevel enum value",
    "skipCodeCoverage": "boolean value"
}'
https://domain.com/services/data/v{{version}}/tooling/runTestsSynchronous

Postman Collection Item JSON

{
  "name": "Tooling Run Tests Sync",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "name": "Content-Type",
        "type": "text",
        "value": "application/json"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "[\n    {\n        \"className\": \"YourClassName\",\n        \"testMethods\": [\n            \"testMethod1\",\n            \"testMethod2\",\n            \"testMethod3\"\n        ]\n    },\n    {\n        \"maxFailedTests\": \"2\"\n    }\n]\n\nor\n\n{\n    \"tests\": [\n        {\n            \"className\": \"YourClassName\",\n            \"testMethods\": [\n                \"testMethod1\",\n                \"testMethod2\",\n                \"testMethod3\"\n            ]\n        }\n    ],\n    \"maxFailedTests\": \"integer value\",\n    \"testLevel\": \"TestLevel enum value\",\n    \"skipCodeCoverage\": \"boolean value\"\n}\n",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "{{_endpoint}}/services/data/v{{version}}/tooling/runTestsSynchronous",
      "host": [
        "{{_endpoint}}"
      ],
      "path": [
        "services",
        "data",
        "v{{version}}",
        "tooling",
        "runTestsSynchronous"
      ]
    },
    "description": "Runs one or more methods within one or more Apex classes, using the asynchronous test execution mechanism. In the request body, you can specify test class names and IDs, suite names and IDs, the maximum number of failed tests to allow, and the test level, as comma-separated lists or as an array. You can also indicate whether to opt out of collecting code coverage information during the test run (available in API version 43.0 and later)."
  },
  "response": [
    {
      "name": "Tooling Run Tests Sync",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"tests\": [\n        {\n            \"className\": \"PrepareSandboxTest\",\n            \"testMethods\": [\n                \"runApexClass_should_work\"\n            ]\n        }\n    ],\n    \"maxFailedTests\": \"1\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{_endpoint}}/services/data/v{{version}}/tooling/runTestsSynchronous",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "tooling",
            "runTestsSynchronous"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Date",
          "value": "Mon, 11 Dec 2023 09:59:37 GMT"
        },
        {
          "key": "Strict-Transport-Security",
          "value": "max-age=63072000; includeSubDomains"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "X-Robots-Tag",
          "value": "none"
        },
        {
          "key": "Cache-Control",
          "value": "no-cache,must-revalidate,max-age=0,no-store,private"
        },
        {
          "key": "Sforce-Limit-Info",
          "value": "api-usage=246/15000"
        },
        {
          "key": "Content-Type",
          "value": "application/json;charset=UTF-8"
        },
        {
          "key": "Vary",
          "value": "Accept-Encoding"
        },
        {
          "key": "Content-Encoding",
          "value": "gzip"
        },
        {
          "key": "Transfer-Encoding",
          "value": "chunked"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"apexLogId\": \"07L4H00000SpGroUAF\",\n    \"codeCoverage\": [\n        {\n            \"id\": \"01q4H000000WjD8QAK\",\n            \"locationsNotCovered\": [\n                {},\n                {}\n            ],\n            \"name\": \"StateTrigger\",\n            \"namespace\": null,\n            \"numLocations\": 2,\n            \"numLocationsNotCovered\": 2,\n            \"type\": \"Trigger\"\n        },\n        {\n            \"id\": \"01q58000000RLTyAAO\",\n            \"locationsNotCovered\": [\n                {},\n                {},\n                {}\n            ],\n            \"name\": \"RestrictContactByName\",\n            \"namespace\": null,\n            \"numLocations\": 3,\n            \"numLocationsNotCovered\": 3,\n            \"type\": \"Trigger\"\n        },\n        {\n            \"id\": \"01q58000000RLBhAAO\",\n            \"locationsNotCovered\": [\n                {},\n                {},\n                {},\n                {},\n                {},\n                {}\n            ],\n            \"name\": \"ClosedOpportunityTrigger\",\n            \"namespace\": null,\n            \"numLocations\": 6,\n            \"numLocationsNotCovered\": 6,\n            \"type\": \"Trigger\"\n        },\n        {\n            \"id\": \"01p4H000009PEFIQA4\",\n            \"locationsNotCovered\": [\n                {},\n                {}\n            ],\n            \"name\": \"PrepareSandbox\",\n            \"namespace\": null,\n            \"numLocations\": 22,\n            \"numLocationsNotCovered\": 2,\n            \"type\": \"Class\"\n        }\n    ],\n    \"codeCoverageWarnings\": [\n        {\n            \"id\": \"01q4H000000WjD8QAK\",\n            \"message\": \"Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required\",\n            \"name\": \"StateTrigger\",\n            \"namespace\": null\n        },\n        {\n            \"id\": \"01q58000000RLTyAAO\",\n            \"message\": \"Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required\",\n            \"name\": \"RestrictContactByName\",\n            \"namespace\": null\n        },\n        {\n            \"id\": \"01q58000000RLBhAAO\",\n            \"message\": \"Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required\",\n            \"name\": \"ClosedOpportunityTrigger\",\n            \"namespace\": null\n        },\n        {\n            \"id\": \"01q4H000000WjD8QAK\",\n            \"message\": \"Average test coverage across all Apex Classes and Triggers is 60%, at least 75% test coverage is required.\",\n            \"name\": null,\n            \"namespace\": \"\"\n        }\n    ],\n    \"failures\": [],\n    \"flowCoverage\": [],\n    \"flowCoverageWarnings\": [],\n    \"numFailures\": 0,\n    \"numTestsRun\": 1,\n    \"successes\": [\n        {\n            \"id\": \"01p4H00000A0zYxQAJ\",\n            \"methodName\": \"runApexClass_should_work\",\n            \"name\": \"PrepareSandboxTest\",\n            \"namespace\": null,\n            \"seeAllData\": false,\n            \"time\": 1088\n        }\n    ],\n    \"totalTime\": 1261\n}"
    }
  ]
}