Ian province abbreviation patch - issue 724
[civicrm-core.git] / api / v3 / examples / Job / Create.php
CommitLineData
6a488035 1<?php
50fb255d 2/**
a828d7b8 3 * Test Generated example demonstrating the Job.create API.
50fb255d 4 *
50fb255d 5 * @return array
6 * API result array
7 */
8function job_create_example() {
9 $params = array(
10 'sequential' => 1,
11 'name' => 'API_Test_Job',
12 'description' => 'A long description written by hand in cursive',
13 'run_frequency' => 'Daily',
14 'api_entity' => 'ApiTestEntity',
15 'api_action' => 'apitestaction',
16 'parameters' => 'Semi-formal explanation of runtime job parameters',
17 'is_active' => 1,
18 );
6a488035 19
50fb255d 20 try{
a828d7b8 21 $result = civicrm_api3('Job', 'create', $params);
50fb255d 22 }
23 catch (CiviCRM_API3_Exception $e) {
24 // Handle error here.
25 $errorMessage = $e->getMessage();
26 $errorCode = $e->getErrorCode();
27 $errorData = $e->getExtraParams();
28 return array(
29 'error' => $errorMessage,
30 'error_code' => $errorCode,
31 'error_data' => $errorData,
32 );
33 }
34
35 return $result;
6a488035
TO
36}
37
fb32de45 38/**
50fb255d 39 * Function returns array of result expected from previous function.
40 *
41 * @return array
42 * API result array
6a488035 43 */
50fb255d 44function job_create_expectedresult() {
6a488035 45
53ca8fd7 46 $expectedResult = array(
50fb255d 47 'is_error' => 0,
48 'version' => 3,
49 'count' => 1,
50 'id' => 29,
51 'values' => array(
53ca8fd7 52 '0' => array(
50fb255d 53 'id' => '29',
54 'domain_id' => '1',
55 'run_frequency' => 'Daily',
56 'last_run' => '',
57 'name' => 'API_Test_Job',
58 'description' => 'A long description written by hand in cursive',
59 'api_entity' => 'ApiTestEntity',
60 'api_action' => 'apitestaction',
61 'parameters' => 'Semi-formal explanation of runtime job parameters',
62 'is_active' => '1',
63 ),
6a488035 64 ),
50fb255d 65 );
6a488035 66
fb32de45 67 return $expectedResult;
6a488035
TO
68}
69
a828d7b8 70/*
50fb255d 71* This example has been generated from the API test suite.
a828d7b8
CW
72* The test that created it is called "testCreate"
73* and can be found at:
69d79249 74* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/JobTest.php
6a488035
TO
75*
76* You can see the outcome of the API tests at
69d79249 77* https://test.civicrm.org/job/CiviCRM-master-git/
6a488035
TO
78*
79* To Learn about the API read
69d79249 80* http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
6a488035 81*
69d79249 82* Browse the api on your own site with the api explorer
41d4d31f 83* http://MYSITE.ORG/path/to/civicrm/api
6a488035
TO
84*
85* Read more about testing here
86* http://wiki.civicrm.org/confluence/display/CRM/Testing
87*
88* API Standards documentation:
89* http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
49f8272d 90*/