Create a Results Query in Certify Results API

With Certify Results API, you can create a results query that will be used to retrieve Certify results, processes, and attributes.

Before you begin this process, you must have completed the following:

  • Registered your Certify databases in the Worksoft Management Studio. For more information, see Registering Certify Databases for Certify Results API.
  • Created a token in Certify Results API in order to access the API and to create results queries. For more information, see Generating a Token in Certify Results API.

To create a results query in Certify Results API:

  1. Open Certify Results API on your Certify Services server with the following URL address:

    http://<servername>/CertifyResultsAPI

  2. Using your Worksoft Management Studio credentials, enter your credentials and click Login.

    Certify Results API opens.

  3. Click the Main Menu button and select Query.

    The Create/Modify Query tab opens.

  4. In the Query Name field, type in the name for your query.
  5. In the Project Name field, type in the name of the project you want to query.
  6. In the Results Folder Name field, type in the project name and results folder you want to query.

    Examples:

    <Project Name> - includes all result folders in the under <Project>

    <Project Name>/<Parent Folder Name>/<Child Folder Name> - includes all <Child Folder> and its sub folders

  7. If needed, in the State Date and End Date fields, click the Calendar icon to select the dates.
  8. If needed, select the number of days for the query.
  9. If you want to select a log process, select the Include Log Process option.
  10. Select the Status options that you want to include in your query:
  11. Passed
  12. Failed
  13. Aborted
  14. Skipped
  15. Click Save Query.

    A message appears saying that your query was saved.

    After you have saved your query, a query ID is assigned to the query. You will need this ID when you retrieve Certify results with Certify Results API Swagger. For more information, see Retrieving Certify Results from a Saved Query ID with Certify Results API Swagger.

Managing Queries

To manage your queries, click the Manage Queries tab.

To copy a query, click the Copy Token to Clipboard button.

To edit a query, click the Edit button.

To delete a query, click the Delete button.

 

Related Topics Link IconRelated Topics