---
apiVersion: v1
kind: ConfigMap
metadata:
  labels:
    funktion.fabric8.io/kind: Connector
  name: servicenow
data:
  deployment.yml: |
    ---
    apiVersion: extensions/v1beta1
    kind: Deployment
    metadata:
      labels:
        funktion.fabric8.io/kind: Subscription
        connector: servicenow
    spec:
      replicas: 1
      template:
        metadata:
          labels:
            funktion.fabric8.io/kind: Subscription
            connector: servicenow
        spec:
          containers:
          - image: funktion/connector-servicenow:${project.version}
            name: connector
  schema.yml: |
    ---
    component:
      kind: component
      scheme: servicenow
      syntax: servicenow:instanceName
      title: ServiceNow
      description: The servicenow component is used to integrate Camel with ServiceNow cloud services.
      label: api,cloud,management
      deprecated: false
      async: false
      producerOnly: true
      javaType: org.apache.camel.component.servicenow.ServiceNowComponent
      groupId: org.apache.camel
      artifactId: camel-servicenow
      version: 2.18.3
    componentProperties:
      configuration:
        kind: property
        type: object
        javaType: org.apache.camel.component.servicenow.ServiceNowConfiguration
        deprecated: false
        secret: false
        description: The ServiceNow default configuration
        order: 0
      apiUrl:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The ServiceNow REST API url
        order: 1
      userName:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: ServiceNow user account name
        order: 2
      password:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: ServiceNow account password
        order: 3
      oauthClientId:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: OAuth2 ClientID
        order: 4
      oauthClientSecret:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: OAuth2 ClientSecret
        order: 5
      oauthTokenUrl:
        kind: property
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: OAuth token Url
        order: 6
    properties:
      instanceName:
        kind: path
        group: producer
        required: true
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The ServiceNow instance name
        order: 0
      display:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        enum:
        - false
        - true
        - all
        deprecated: false
        secret: false
        defaultValue: true
        description: Set this parameter to true to return only scorecards where the indicator Display field is selected. Set this parameter to all to return scorecards with any Display field value. This parameter is true by default.
        order: 1
      displayValue:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        enum:
        - false
        - true
        - all
        deprecated: false
        secret: false
        defaultValue: false
        description: 'Return the display value (true) actual value (false) or both (all)
          for reference fields (default: false)'
        order: 2
      excludeReferenceLink:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: 'True to exclude Table API links for reference fields (default: false)'
        order: 3
      favorites:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return only scorecards that are favorites of the querying user.
        order: 4
      includeAggregates:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to always return all available aggregates for an indicator including when an aggregate has already been applied. If a value is not specified this parameter defaults to false and returns no aggregates.
        order: 5
      includeAvailableAggregates:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return all available aggregates for an indicator when no aggregate has been applied. If a value is not specified this parameter defaults to false and returns no aggregates.
        order: 6
      includeAvailableBreakdowns:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return all available breakdowns for an indicator. If a value is not specified this parameter defaults to false and returns no breakdowns.
        order: 7
      includeScoreNotes:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return all notes associated with the score. The note element contains the note text as well as the author and timestamp when the note was added.
        order: 8
      includeScores:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return all scores for a scorecard. If a value is not specified this parameter defaults to false and returns only the most recent score value.
        order: 9
      inputDisplayValue:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: 'True to set raw value of input fields (default: false)'
        order: 10
      key:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return only scorecards for key indicators.
        order: 11
      models:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        prefix: model.
        multiValue: true
        deprecated: false
        secret: false
        description: Defines both request and response models
        order: 12
      perPage:
        kind: parameter
        group: producer
        type: integer
        javaType: java.lang.Integer
        deprecated: false
        secret: false
        defaultValue: "10"
        description: Enter the maximum number of scorecards each query can return. By default this value is 10 and the maximum is 100.
        order: 13
      release:
        kind: parameter
        group: producer
        type: string
        javaType: org.apache.camel.component.servicenow.ServiceNowRelease
        enum:
        - FUJI
        - GENEVA
        - HELSINKI
        deprecated: false
        secret: false
        defaultValue: HELSINKI
        description: The ServiceNow release to target default to Helsinki See https://docs.servicenow.com
        order: 14
      requestModels:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        prefix: request-model.
        multiValue: true
        deprecated: false
        secret: false
        description: Defines the request model
        order: 15
      resource:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The default resource can be overridden by header CamelServiceNowResource
        order: 16
      responseModels:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        prefix: response-model.
        multiValue: true
        deprecated: false
        secret: false
        description: Defines the response model
        order: 17
      sortBy:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        enum:
        - value
        - change
        - changeperc
        - gap
        - gapperc
        - duedate
        - name
        - order
        - default
        - group
        - indicator_group
        - frequency
        - target
        - date
        - trend
        - bullet
        - direction
        deprecated: false
        secret: false
        description: Specify the value to use when sorting results. By default queries sort records by value.
        order: 18
      sortDir:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        enum:
        - asc
        - desc
        deprecated: false
        secret: false
        description: Specify the sort direction ascending or descending. By default queries sort records in descending order. Use sysparm_sortdir=asc to sort in ascending order.
        order: 19
      suppressAutoSysField:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: 'True to suppress auto generation of system fields (default: false)'
        order: 20
      suppressPaginationHeader:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this value to true to remove the Link header from the response. The Link header allows you to request additional pages of data when the number of records matching your query exceeds the query limit
        order: 21
      table:
        kind: parameter
        group: producer
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The default table can be overridden by header CamelServiceNowTable
        order: 22
      target:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Set this parameter to true to return only scorecards that have a target.
        order: 23
      topLevelOnly:
        kind: parameter
        group: producer
        type: boolean
        javaType: java.lang.Boolean
        deprecated: false
        secret: false
        description: Gets only those categories whose parent is a catalog.
        order: 24
      apiVersion:
        kind: parameter
        group: advanced
        label: advanced
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The ServiceNow REST API version default latest
        order: 25
      httpClientPolicy:
        kind: parameter
        group: advanced
        label: advanced
        type: object
        javaType: org.apache.cxf.transports.http.configuration.HTTPClientPolicy
        deprecated: false
        secret: false
        description: To configure http-client
        order: 26
      mapper:
        kind: parameter
        group: advanced
        label: advanced
        type: object
        javaType: com.fasterxml.jackson.databind.ObjectMapper
        deprecated: false
        secret: false
        description: Sets Jackson's ObjectMapper to use for request/reply
        order: 27
      proxyAuthorizationPolicy:
        kind: parameter
        group: advanced
        label: advanced
        type: object
        javaType: org.apache.cxf.configuration.security.ProxyAuthorizationPolicy
        deprecated: false
        secret: false
        description: To configure proxy authentication
        order: 28
      synchronous:
        kind: parameter
        group: advanced
        label: advanced
        type: boolean
        javaType: boolean
        deprecated: false
        secret: false
        defaultValue: false
        description: Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported).
        order: 29
      proxyHost:
        kind: parameter
        group: proxy
        label: proxy
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The proxy host name
        order: 30
      proxyPort:
        kind: parameter
        group: proxy
        label: proxy
        type: integer
        javaType: java.lang.Integer
        deprecated: false
        secret: false
        description: The proxy port number
        order: 31
      apiUrl:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: The ServiceNow REST API url
        order: 32
      oauthClientId:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: true
        description: OAuth2 ClientID
        order: 33
      oauthClientSecret:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: true
        description: OAuth2 ClientSecret
        order: 34
      oauthTokenUrl:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: true
        description: OAuth token Url
        order: 35
      password:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: true
        description: ServiceNow account password MUST be provided
        order: 36
      proxyPassword:
        kind: parameter
        group: security
        label: proxy,security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: Password for proxy authentication
        order: 37
      proxyUserName:
        kind: parameter
        group: security
        label: proxy,security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: false
        description: Username for proxy authentication
        order: 38
      sslContextParameters:
        kind: parameter
        group: security
        label: security
        type: object
        javaType: org.apache.camel.util.jsse.SSLContextParameters
        deprecated: false
        secret: false
        description: To configure security using SSLContextParameters. See http://camel.apache.org/camel-configuration-utilities.html
        order: 39
      userName:
        kind: parameter
        group: security
        label: security
        type: string
        javaType: java.lang.String
        deprecated: false
        secret: true
        description: ServiceNow user account name MUST be provided
        order: 40
  documentation.adoc: |
    [[ServiceNow-ServiceNowComponent]]
    ServiceNow Component
    ~~~~~~~~~~~~~~~~~~~~

    *Available as of Camel 2.18*

    The ServiceNow component provides access to ServiceNow platform through their REST API.

    NOTE: From Camel 2.18.1 the component supports multiple version of ServiceNow platform with default to Helsinki. Supported version are <<ServiceNow-Fuji>> and <<ServiceNow-Helsinki>>


    Maven users will need to add the following dependency to their pom.xml
    for this component:

    [source,java]
    -------------------------------------------------
        <dependency>
            <groupId>org.apache.camel</groupId>
            <artifactId>camel-servicenow</artifactId>
            <version>${camel-version}</version>
        </dependency>
    -------------------------------------------------

    [[ServiceNow-URIformat]]
    URI format
    ^^^^^^^^^^

    [source,java]
    ---------------------------------------
        servicenow://instanceName?[options]
    ---------------------------------------

    [[ServiceNow-Options]]
    Options
    ^^^^^^^


    // component options: START
    The ServiceNow component supports 7 options which are listed below.



    {% raw %}
    [width="100%",cols="2,1m,7",options="header"]
    |=======================================================================
    | Name | Java Type | Description
    | configuration | ServiceNowConfiguration | The ServiceNow default configuration
    | apiUrl | String | The ServiceNow REST API url
    | userName | String | ServiceNow user account name
    | password | String | ServiceNow account password
    | oauthClientId | String | OAuth2 ClientID
    | oauthClientSecret | String | OAuth2 ClientSecret
    | oauthTokenUrl | String | OAuth token Url
    |=======================================================================
    {% endraw %}
    // component options: END


    // endpoint options: START
    The ServiceNow component supports 41 endpoint options which are listed below:

    {% raw %}
    [width="100%",cols="2,1,1m,1m,5",options="header"]
    |=======================================================================
    | Name | Group | Default | Java Type | Description
    | instanceName | producer |  | String | *Required* The ServiceNow instance name
    | display | producer | true | String | Set this parameter to true to return only scorecards where the indicator Display field is selected. Set this parameter to all to return scorecards with any Display field value. This parameter is true by default.
    | displayValue | producer | false | String | Return the display value (true) actual value (false) or both (all) for reference fields (default: false)
    | excludeReferenceLink | producer |  | Boolean | True to exclude Table API links for reference fields (default: false)
    | favorites | producer |  | Boolean | Set this parameter to true to return only scorecards that are favorites of the querying user.
    | includeAggregates | producer |  | Boolean | Set this parameter to true to always return all available aggregates for an indicator including when an aggregate has already been applied. If a value is not specified this parameter defaults to false and returns no aggregates.
    | includeAvailableAggregates | producer |  | Boolean | Set this parameter to true to return all available aggregates for an indicator when no aggregate has been applied. If a value is not specified this parameter defaults to false and returns no aggregates.
    | includeAvailableBreakdowns | producer |  | Boolean | Set this parameter to true to return all available breakdowns for an indicator. If a value is not specified this parameter defaults to false and returns no breakdowns.
    | includeScoreNotes | producer |  | Boolean | Set this parameter to true to return all notes associated with the score. The note element contains the note text as well as the author and timestamp when the note was added.
    | includeScores | producer |  | Boolean | Set this parameter to true to return all scores for a scorecard. If a value is not specified this parameter defaults to false and returns only the most recent score value.
    | inputDisplayValue | producer |  | Boolean | True to set raw value of input fields (default: false)
    | key | producer |  | Boolean | Set this parameter to true to return only scorecards for key indicators.
    | models | producer |  | String | Defines both request and response models
    | perPage | producer | 10 | Integer | Enter the maximum number of scorecards each query can return. By default this value is 10 and the maximum is 100.
    | release | producer | HELSINKI | ServiceNowRelease | The ServiceNow release to target default to Helsinki See https://docs.servicenow.com
    | requestModels | producer |  | String | Defines the request model
    | resource | producer |  | String | The default resource can be overridden by header CamelServiceNowResource
    | responseModels | producer |  | String | Defines the response model
    | sortBy | producer |  | String | Specify the value to use when sorting results. By default queries sort records by value.
    | sortDir | producer |  | String | Specify the sort direction ascending or descending. By default queries sort records in descending order. Use sysparm_sortdir=asc to sort in ascending order.
    | suppressAutoSysField | producer |  | Boolean | True to suppress auto generation of system fields (default: false)
    | suppressPaginationHeader | producer |  | Boolean | Set this value to true to remove the Link header from the response. The Link header allows you to request additional pages of data when the number of records matching your query exceeds the query limit
    | table | producer |  | String | The default table can be overridden by header CamelServiceNowTable
    | target | producer |  | Boolean | Set this parameter to true to return only scorecards that have a target.
    | topLevelOnly | producer |  | Boolean | Gets only those categories whose parent is a catalog.
    | apiVersion | advanced |  | String | The ServiceNow REST API version default latest
    | httpClientPolicy | advanced |  | HTTPClientPolicy | To configure http-client
    | mapper | advanced |  | ObjectMapper | Sets Jackson's ObjectMapper to use for request/reply
    | proxyAuthorizationPolicy | advanced |  | ProxyAuthorizationPolicy | To configure proxy authentication
    | synchronous | advanced | false | boolean | Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported).
    | proxyHost | proxy |  | String | The proxy host name
    | proxyPort | proxy |  | Integer | The proxy port number
    | apiUrl | security |  | String | The ServiceNow REST API url
    | oauthClientId | security |  | String | OAuth2 ClientID
    | oauthClientSecret | security |  | String | OAuth2 ClientSecret
    | oauthTokenUrl | security |  | String | OAuth token Url
    | password | security |  | String | ServiceNow account password MUST be provided
    | proxyPassword | security |  | String | Password for proxy authentication
    | proxyUserName | security |  | String | Username for proxy authentication
    | sslContextParameters | security |  | SSLContextParameters | To configure security using SSLContextParameters. See http://camel.apache.org/camel-configuration-utilities.html
    | userName | security |  | String | ServiceNow user account name MUST be provided
    |=======================================================================
    {% endraw %}
    // endpoint options: END



    [[ServiceNow-Headers]]
    Headers
    ^^^^^^^

    [width="100%",cols="10%,10%,10%,10%,60%",options="header",]
    |===
    |Name |Type |ServiceNow API Parameter |Endpoint option |Description
    |CamelServiceNowResource |String | - | - | The resource to access
    |CamelServiceNowAction |String | - | - | The action to perform
    |CamelServiceNowActionSubject | - | - | String |The subject to which the action should be applied
    |CamelServiceNowModel |Class | - | - | The data model
    |CamelServiceNowRequestModel |Class | - | - | The request data model
    |CamelServiceNowResponseModel |Class | - | - | The response data model
    |CamelServiceNowOffsetNext | - | - | - | -
    |CamelServiceNowOffsetPrev | - | - | - | -
    |CamelServiceNowOffsetFirst | - | - | - | -
    |CamelServiceNowOffsetLast | - | - | - | -
    |CamelServiceNowContentType | - | - | - | -
    |CamelServiceNowContentEncoding | - | - | - | -
    |CamelServiceNowContentMeta | - | - | - | -
    |CamelServiceNowSysId |String | sys_id | - | -
    |CamelServiceNowUserSysId |String | user_sysid | - | -
    |CamelServiceNowUserId |String | user_id | - | -
    |CamelServiceNowCartItemId |String | cart_item_id | - | -
    |CamelServiceNowFileName |String | file_name | - | -
    |CamelServiceNowTable |String | table_name | - | -
    |CamelServiceNowTableSysId |String | table_sys_id | - | -
    |CamelServiceNowEncryptionContext | String | encryption_context | - | -
    |CamelServiceNowCategory | String | sysparm_category  | - | -
    |CamelServiceNowType |String | sysparm_type | - | -
    |CamelServiceNowCatalog | String | sysparm_catalog | - | -
    |CamelServiceNowQuery |String | sysparm_query | - | -
    |CamelServiceNowDisplayValue |String | sysparm_display_value | displayValue  | -
    |CamelServiceNowInputDisplayValue |Boolean | sysparm_input_display_value | inputDisplayValue  | -
    |CamelServiceNowExcludeReferenceLink |Boolean | sysparm_exclude_reference_link | excludeReferenceLink  | -
    |CamelServiceNowFields |String | sysparm_fields | - | -
    |CamelServiceNowLimit |Integer | sysparm_limit | - | -
    |CamelServiceNowText | String | sysparm_text | - | -
    |CamelServiceNowOffset | Integer | sysparm_offset | - | -
    |CamelServiceNowView |String | sysparm_view | - | -
    |CamelServiceNowSuppressAutoSysField |Boolean | sysparm_suppress_auto_sys_field | suppressAutoSysField | -
    |CamelServiceNowSuppressPaginationHeader | Booleab | sysparm_suppress_pagination_header | suppressPaginationHeader | -
    |CamelServiceNowMinFields |String | sysparm_min_fields | - | -
    |CamelServiceNowMaxFields |String | sysparm_max_fields | - | -
    |CamelServiceNowSumFields |String | sysparm_sum_fields | - | -
    |CamelServiceNowAvgFields |String | sysparm_avg_fields | - | -
    |CamelServiceNowCount |Boolean | sysparm_count | - | -
    |CamelServiceGroupBy |String | sysparm_group_by | - | -
    |CamelServiceOrderBy |String | sysparm_order_by | - | -
    |CamelServiceHaving |String | sysparm_having | - | -
    |CamelServiceNowUUID |String | sysparm_uuid | - | -
    |CamelServiceNowBreakdown| String| sysparm_breakdown | - | -
    |CamelServiceNowIncludeScores| Boolean | sysparm_include_scores | includeScores | -
    |CamelServiceNowIncludeScoreNotes | Boolean | sysparm_include_score_notes | includeScoreNotes | -
    |CamelServiceNowIncludeAggregates | Boolean | sysparm_include_aggregates | includeAggregates | -
    |CamelServiceNowIncludeAvailableBreakdowns | Boolean | sysparm_include_available_breakdowns | includeAvailableBreakdowns | -
    |CamelServiceNowIncludeAvailableAggregates | Boolean | sysparm_include_available_aggregates | includeAvailableAggregates | -
    |CamelServiceNowFavorites | Boolean | sysparm_favorites | favorites | -
    |CamelServiceNowKey  | Boolean | sysparm_key | key | -
    |CamelServiceNowTarget | Boolean | sysparm_target | target | -
    |CamelServiceNowDisplay | String | sysparm_display | display | -
    |CamelServiceNowPerPage | Integer | sysparm_per_page | perPage | -
    |CamelServiceNowSortBy | String | sysparm_sortby | sortBy | -
    |CamelServiceNowSortDir | String | sysparm_sortdit | sortDir | -
    |CamelServiceNowContains | String | sysparm_contains | - | -
    |CamelServiceNowTags | String | sysparm_tags | - | -
    |CamelServiceNowPage | String | sysparm_page | - | -
    |CamelServiceNowElementsFilter | String | sysparm_elements_filter | - | -
    |CamelServiceNowBreakdownRelation | String | sysparm_breakdown_relation | - | -
    |CamelServiceNowDataSource | String | sysparm_data_source | - | -
    |CamelServiceNowTopLevelOnly | Boolean | sysparm_top_level_only | topLevelOnly | -
    |CamelServiceNowApiVersion | String | - | - | The REST API version
    |CamelServiceNowResponseMeta | Map | - | - | Meta data provided along with a response
    |===

    [[ServiceNow-Fuji]]
    [cols="10%a,10%a,10%a,70%a", options="header"]
    .API Mapping
    |===
    | CamelServiceNowResource | CamelServiceNowAction | Method | API URI
    1.5+<.^|TABLE
    | RETRIEVE | GET | /api/now/v1/table/{table_name}/{sys_id}
    | CREATE | POST | /api/now/v1/table/{table_name}
    | MODIFY | PUT | /api/now/v1/table/{table_name}/{sys_id}
    | DELETE | DELETE | /api/now/v1/table/{table_name}/{sys_id}
    | UPDATE | PATCH | /api/now/v1/table/{table_name}/{sys_id}

    | AGGREGATE
    | RETRIEVE | GET | /api/now/v1/stats/{table_name}

    1.2+<.^|IMPORT
    | RETRIEVE | GET | /api/now/import/{table_name}/{sys_id}
    | CREATE | POST | /api/now/import/{table_name}
    |===

    NOTE: link:http://wiki.servicenow.com/index.php?title=REST_API#Available_APIs[Fuji REST API Documentation]

    [[ServiceNow-Helsinki]]
    [cols="10%a,10%a,10%a,10%a,60%a", options="header"]
    .API Mapping
    |===
    | CamelServiceNowResource | CamelServiceNowAction | CamelServiceNowActionSubject | Method | API URI
    1.5+<.^|TABLE
    | RETRIEVE | | GET | /api/now/v1/table/{table_name}/{sys_id}
    | CREATE | | POST | /api/now/v1/table/{table_name}
    | MODIFY | | PUT | /api/now/v1/table/{table_name}/{sys_id}
    | DELETE | | DELETE | /api/now/v1/table/{table_name}/{sys_id}
    | UPDATE | | PATCH | /api/now/v1/table/{table_name}/{sys_id}

    | AGGREGATE
    | RETRIEVE | | GET | /api/now/v1/stats/{table_name}

    1.2+<.^|IMPORT
    | RETRIEVE | | GET | /api/now/import/{table_name}/{sys_id}
    | CREATE | | POST | /api/now/import/{table_name}

    1.4+<.^|ATTACHMENT
    | RETRIEVE | | GET | /api/now/api/now/attachment/{sys_id}
    | CONTENT | | GET | /api/now/attachment/{sys_id}/file
    | UPLOAD | | POST | /api/now/api/now/attachment/file
    | DELETE | | DELETE | /api/now/attachment/{sys_id}

    | SCORECARDS
    | RETRIEVE | PERFORMANCE_ANALYTICS | GET | /api/now/pa/scorecards

    1.2+<.^|MISC
    | RETRIEVE | USER_ROLE_INHERITANCE | GET | /api/global/user_role_inheritance
    | CREATE | IDENTIFY_RECONCILE | POST | /api/now/identifyreconcile

    1.2+<.^|SERVICE_CATALOG
    | RETRIEVE | | GET | /sn_sc/servicecatalog/catalogs/{sys_id}
    | RETRIEVE | CATEGORIES |  GET | /sn_sc/servicecatalog/catalogs/{sys_id}/categories

    1.5+<.^|SERVICE_CATALOG_ITEMS
    | RETRIEVE | | GET | /sn_sc/servicecatalog/items/{sys_id}
    | RETRIEVE | SUBMIT_GUIDE | POST | /sn_sc/servicecatalog/items/{sys_id}/submit_guide
    | RETRIEVE | CHECKOUT_GUIDE | POST | /sn_sc/servicecatalog/items/{sys_id}/checkout_guide
    | CREATE | SUBJECT_CART | POST | /sn_sc/servicecatalog/items/{sys_id}/add_to_cart
    | CREATE | SUBJECT_PRODUCER | POST | /sn_sc/servicecatalog/items/{sys_id}/submit_producer

    1.6+<.^|SERVICE_CATALOG_CARTS
    | RETRIEVE | | GET | /sn_sc/servicecatalog/cart
    | RETRIEVE | DELIVERY_ADDRESS | GET | /sn_sc/servicecatalog/cart/delivery_address/{user_id}
    | RETRIEVE | CHECKOUT | POST | /sn_sc/servicecatalog/cart/checkout
    | UPDATE | | POST | /sn_sc/servicecatalog/cart/{cart_item_id}
    | UPDATE | CHECKOUT | POST | /sn_sc/servicecatalog/cart/submit_order
    | DELETE | | DELETE | /sn_sc/servicecatalog/cart/{sys_id}/empty

    | SERVICE_CATALOG_CATEGORIES
    | RETRIEVE | | GET | /sn_sc/servicecatalog/categories/{sys_id}

    |===

    NOTE: https://docs.servicenow.com/bundle/helsinki-servicenow-platform/page/integrate/inbound-rest/reference/r_RESTResources.html[Helsinki REST API Documentation]

    [[ServiceNow-Usageexamples]]
    Usage examples:
    ^^^^^^^^^^^^^^^
     
    {% raw %}
    [source,java]
    .Retrieve 10 Incidents
    -------------------------------------------------------------------------------------------------------------------
    context.addRoutes(new RouteBuilder() {
        public void configure() {
           from("direct:servicenow")
               .to("servicenow:{{env:SERVICENOW_INSTANCE}}"
                   + "?userName={{env:SERVICENOW_USERNAME}}"
                   + "&password={{env:SERVICENOW_PASSWORD}}"
                   + "&oauthClientId={{env:SERVICENOW_OAUTH2_CLIENT_ID}}"
                   + "&oauthClientSecret={{env:SERVICENOW_OAUTH2_CLIENT_SECRET}}"
               .to("mock:servicenow");
        }
    }); 

    FluentProducerTemplate.on(context)
        .withHeader(ServiceNowConstants.RESOURCE, "table")
        .withHeader(ServiceNowConstants.ACTION, ServiceNowConstants.ACTION_RETRIEVE)
        .withHeader(ServiceNowConstants.SYSPARM_LIMIT.getId(), "10")
        .withHeader(ServiceNowConstants.TABLE, "incident")
        .withHeader(ServiceNowConstants.MODEL, Incident.class)
        .to("direct:servicenow")
        .send();
    -------------------------------------------------------------------------------------------------------------------
    {% endraw %}
