Versions Compared

Old Version 8

changes.mady.by.user Vinod.G

Saved on

compared with

New Version Current

changes.mady.by.user Akshat Mathur

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • Automatics API can be created using following two custom annotations:
    1. @AutomaticsApi
  • @AutomaticsApiParam

...

    1. - Used to declare

...

    1. Automatics API
    2. @AutomaticsApiParam - Used to declare Automatics API Parameters

Below is the example which showcase the code of Automatics API.

@AutomaticsApi(category = AutomaticsApiCategory.TUNE_CHANNEL, applicableFor = {
        ApplicableFor.RDKV, }, description = "Tune to particular IP channel", name = "TUNE_TO_PARTICULAR_IPCHANNEL", returntype = "String")
    public static ResponseObject tuneToAnIpChannelAndCheckAV(AutomaticsTapApi tapEnv, Dut device,
        @AutomaticsApiParam(name = "channelNo", description = "Channel Number", defaultOptions = "120,121") String channel No,
        @AutomaticsApiParam(name = "streamType", description = "Stream Type", defaultOptions = "HD, SD") String stream Type) {
{
    //code to perform
}

    1. @AutomaticsApi: It

      2. is

    2. 's a custom annotation need to be written at the very beginning of the function definition as shown in example.

      3. so

    3. So, whenever an API is called the below defined function will be executed. This annotation takes below mentioned parameter values:

      4. category

      1.  category: Automatics API category for which the API is created.

      5. applicable

      1.  applicable for: For which environment the API is applicable, such as RDKB, RDKC, RDKV.

      2.  description: A short description of what the API actually does.

      3.  name: Name of the API. Whatever name is defined over here will be seen as the API name in the Automatics UI under the available method section during TC automation.

      4.  returntype: Datatype of the response which is going to be returned by the API.

    6. @AutomaticsApiParam:
      7.  It is
    7. It's a custom annotation using which we can take a parameter value from user from the automatics UI.
      This annotation takes below mentioned parameter values:

      1. description: A short description of what this parameter is used for.

      2. name: Name of the parameter. Whatever name is defined over here will be seen as the API parameter with an input box in the input configuration of the API.

      3. default options: It will be seen as a value suggestion in the input box of the parameter. Multiple values can be added using comma.

  2. Trigger the Jenkins pipeline for creating the rdkb-utils JAR.
    1. Open relatable URL.
      1. RDK_B Test utils : https://code.rdkcentral.com/r/admin/repos/rdk/tools/automatics/rdkb-test-utils
      2. RDK_B Tests:  https://code.rdkcentral.com/r/admin/repos/rdk/tools/automatics/rdkb-tests
    2. Click on "Build with parameters"
    3. Select "RDKB-UTILS" as profile.
    4. Click on "Build" button.

 3.Jenkins Builds for API Scan.

...

Description

...

Job

...

https://rdkauto14.ccp.xcal.tv:8443/view/AUTOMATICS%20UTILS%20DEPLOYMENT/job/AUTOMATICS_API_SCAN_FOR_AUTOMATICS_UTILS/

...

  • Once the API development is done changes need be merged.