AgileApps Support Wiki Pre Release

Difference between revisions of "GetStatus"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
 
(9 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();
Logger.info("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();
Logger.info("Status code for 870821896: " + pdsb.getStatusCode()  
Logger.info("Deployment status code: " + pdsb.getStatusCode()  
               + "; status: " + pdsb.getStatus(), "Deploy");
               + "; 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.  

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
StatusBean status = getStatus(String resourceName, String id);
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.

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");
Learn more: ImportStatusBean

Example: Get status for a known deployment

This example returns the status for deployment job #870821896.

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");
Learn more: PackageDeployStatusBean

Example: Get status for all package deployments

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

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");
}