Difference between revisions of "GetStatus"

From AgileApps Support Wiki
imported>Aeric
 
imported>Aeric
 
(10 intermediate revisions by the same user not shown)
Line 13: Line 13:


;Parameters:
;Parameters:
:;resourceName:A string that specifies the kind of job to be checked.<br/>Possible values, defined in the {{constants}} class, are:
:;resourceName:A string that specifies the kind of job to be checked.<br/>Possible values, defined in the {{^Constants}} class, are:
:::<tt>STATUS.PACKAGE_DEPLOY</tt><br/><tt>STATUS.IMPORT</tt>
:::<tt>STATUS.PACKAGE_DEPLOY</tt><br/><tt>STATUS.IMPORT</tt>
<!--<br/><tt>STATUS.EXPORT</tt>-->
<!--<br/><tt>STATUS.EXPORT</tt>-->
Line 25: Line 25:
This example returns the status for import job #974326842, where the import job ID is returned by the REST  [[REST API:bulk Resource|bulk upload]] resource or the Java [[Java API:Data Import#importData|importData]] API.
This example returns the status for import job #974326842, where the import job ID is returned by the REST  [[REST API:bulk Resource|bulk upload]] resource or the Java [[Java API:Data Import#importData|importData]] API.
:<syntaxhighlight lang="java" enclose="div">
:<syntaxhighlight lang="java" enclose="div">
import com.platform.api.beans.*;
import com.platform.api.*;
import com.platform.beans.*;
import static com.platform.api.CONSTANTS.*;
import static com.platform.api.CONSTANTS.*;
import static com.platform.api.Functions.*;
  ...
  ...
StatusBean sb = getStatus(STATUS.IMPORT, "974326842");
StatusBean sb = getStatus(CONSTANTS.STATUS.IMPORT, "974326842");
ImportStatusBean isb = (ImportStatusBean)sb.getObject();
ImportStatusBean isb = (ImportStatusBean)sb.getObject();
Functions.debug("Status code for 974326842: " + i.getStatusCode()  
Logger.info("Import status code: " + isb.getStatusCode()  
               + "; status: " +i.getStatus());
               + "; status: " +isb.getStatus(), "Import");
</syntaxhighlight>
</syntaxhighlight>


Line 39: Line 41:
This example returns the status for deployment job #870821896.
This example returns the status for deployment job #870821896.
:<syntaxhighlight lang="java" enclose="div">
:<syntaxhighlight lang="java" enclose="div">
import com.platform.api.beans.*;
import com.platform.api.*;
import com.platform.beans.*;
import static com.platform.api.CONSTANTS.*;
import static com.platform.api.CONSTANTS.*;
...
import static com.platform.api.Functions.*;
StatusBean sb = getStatus(STATUS.PACKAGE_DEPLOY, "870821896");
...
StatusBean sb = getStatus(CONSTANTS.STATUS.PACKAGE_DEPLOY, "870821896");
PackageDeployStatusBean pdsb = (PackageDeployStatusBean)sb.getObject();
PackageDeployStatusBean pdsb = (PackageDeployStatusBean)sb.getObject();
Functions.debug("Status code for 870821896: " + pdsb.getStatusCode()  
Logger.info("Deployment status code: " + pdsb.getStatusCode()  
               + "; status: " + pdsb.getStatus());
               + "; status: " + pdsb.getStatus(), "Deploy");
</syntaxhighlight>
</syntaxhighlight>


:''Learn more:'' [{{DOCHOST}}/javadocs/com/platform/beans/PackageDeployStatusBean.html PackageDeployStatusBean]
:''Learn more:'' [{{DOCHOST}}/javadocs/com/platform/beans/PackageDeployStatusBean.html PackageDeployStatusBean]
 
===Example: Get status for all package deployments===
===Example: Get status for all package deployments===
This example returns the status for all package deployments since the platform was installed.  
This example returns the status for all package deployments since the platform was installed.  
Line 59: Line 63:
     StatusBean status = (StatusBean)statusBean;
     StatusBean status = (StatusBean)statusBean;
     PackageDeployStatusBean pdsb = (PackageDeployStatusBean)status.getObject();
     PackageDeployStatusBean pdsb = (PackageDeployStatusBean)status.getObject();
     Functions.debug("Status code for: " + pdsb.getRecordId()  
     Logger.info("Status code for: " + pdsb.getRecordId()  
                   + "; status:" + pdsb.getStatus());
                   + "; status:" + pdsb.getStatus(), "Deploy");
}
}
</syntaxhighlight>
</syntaxhighlight>

Latest revision as of 00:42, 22 February 2014

getStatus API

Returns the status of jobs submitted to the scheduler by these operations:

  • Data import
  • Package deployment
Syntax
<syntaxhighlight lang="java" enclose="div">

StatusBean status = getStatus(String resourceName, String id); </syntaxhighlight>

Parameters
resourceName
A string that specifies the kind of job to be checked.
Possible values, defined in the CONSTANTS class, are:
STATUS.PACKAGE_DEPLOY
STATUS.IMPORT
id
The ID of the job.
Returns
StatusBean object

Example: Get status for an import

This example returns the status for import job #974326842, where the import job ID is returned by the REST bulk upload resource or the Java importData API.

<syntaxhighlight lang="java" enclose="div">

import com.platform.api.*; import com.platform.beans.*; import static com.platform.api.CONSTANTS.*; import static com.platform.api.Functions.*;

...

StatusBean sb = getStatus(CONSTANTS.STATUS.IMPORT, "974326842"); ImportStatusBean isb = (ImportStatusBean)sb.getObject(); Logger.info("Import status code: " + isb.getStatusCode()

             + "; status: " +isb.getStatus(), "Import");

</syntaxhighlight>

Learn more: ImportStatusBean

Example: Get status for a known deployment

This example returns the status for deployment job #870821896.

<syntaxhighlight lang="java" enclose="div">

import com.platform.api.*; import com.platform.beans.*; import static com.platform.api.CONSTANTS.*; import static com.platform.api.Functions.*;

...

StatusBean sb = getStatus(CONSTANTS.STATUS.PACKAGE_DEPLOY, "870821896"); PackageDeployStatusBean pdsb = (PackageDeployStatusBean)sb.getObject(); Logger.info("Deployment status code: " + pdsb.getStatusCode()

             + "; status: " + pdsb.getStatus(), "Deploy");

</syntaxhighlight>

Learn more: PackageDeployStatusBean

Example: Get status for all package deployments

This example returns the status for all package deployments since the platform was installed.

<syntaxhighlight lang="java" enclose="div">

CollectionBean cb = searchStatus(STATUS.PACKAGE_DEPLOY, "id, status", ""); List list = (List)cb.getObject(); for(Object statusBean : list ) {

   StatusBean status = (StatusBean)statusBean;
   PackageDeployStatusBean pdsb = (PackageDeployStatusBean)status.getObject();
   Logger.info("Status code for: " + pdsb.getRecordId() 
                 + "; status:" + pdsb.getStatus(), "Deploy");

} </syntaxhighlight>