1.4.6 • Published 7 days ago

@janus-idp/backstage-scaffolder-backend-module-servicenow-dynamic v1.4.6

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
7 days ago

ServiceNow actions for Backstage

This plugin provides Backstage template actions for ServiceNow.

The following actions are currently supported in this plugin:

Prerequisites

Installation

Run the following command to install the action package in your Backstage project:

yarn workspace backend add @janus-idp/backstage-scaffolder-backend-module-servicenow

Installing the action on the legacy backend

Register the ServiceNow actions by modifying the packages/backend/src/plugins/scaffolder.ts file from your project with the following changes:

/* highlight-add-next-line */
import { createServiceNowActions } from '@janus-idp/backstage-scaffolder-backend-module-servicenow';

export default async function createPlugin(
  env: PluginEnvironment,
): Promise<Router> {
  // ...

  /* highlight-add-next-line */
  const actions = [
    ...builtInActions,
    ...createServiceNowActions({ config: env.config }),
  ];

  return await createRouter({
    actions,
    logger: env.logger,
    config: env.config,
    database: env.database,
    reader: env.reader,
    catalogClient,
    identity: env.identity,
  });
}

Installing the action on the new backend

Add the following to your packages/backend/src/index.ts file:

const backend = createBackend();

// Add the following line
backend.add(
  import('@janus-idp/backstage-scaffolder-backend-module-servicenow/alpha'),
);

backend.start();

Configuration

Update the app-config.yaml file to include the following config:

servicenow:
  # The base url of the ServiceNow instance.
  baseUrl: ${SERVICENOW_BASE_URL}
  # The username to use for authentication.
  username: ${SERVICENOW_USERNAME}
  # The password to use for authentication.
  password: ${SERVICENOW_PASSWORD}

Usage

Action : servicenow:now:table:createRecord

Request Type: POST

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table in which to save the record
requestBodyRecord<PropertyKey, unknown>NoField name and the associated value for each parameter to define in the specified record
sysparmDisplayValueenum("true", "false", "all")NoReturn field display values (true), actual values (false), or both (all) (default: false)
sysparmExcludeReferenceLinkbooleanNoTrue to exclude Table API links for reference fields (default: false)
sysparmFieldsstring[]NoAn array of fields to return in the response
sysparmInputDisplayValuebooleanNoSet field values using their display value (true) or actual value (false) (default: false)
sysparmSuppressAutoSysFieldbooleanNoTrue to suppress auto generation of system fields (default: false)
sysparmViewstringNoRender the response according to the specified UI view (overridden by sysparm_fields)

Output

NameTypeDescription
resultRecord<PropertyKey, unknown>The response body of the request

Action : servicenow:now:table:deleteRecord

Request Type: DELETE

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table in which to delete the record
sysIdstringYesUnique identifier of the record to delete
sysparmQueryNoDomainbooleanNoTrue to access data across domains if authorized (default: false)

Action : servicenow:now:table:modifyRecord

Request Type: PUT

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table in which to modify the record
sysIdstringYesUnique identifier of the record to modify
requestBodyRecord<PropertyKey, unknown>NoField name and the associated value for each parameter to define in the specified record
sysparmDisplayValueenum("true", "false", "all")NoReturn field display values (true), actual values (false), or both (all) (default: false)
sysparmExcludeReferenceLinkbooleanNoTrue to exclude Table API links for reference fields (default: false)
sysparmFieldsstring[]NoAn array of fields to return in the response
sysparmInputDisplayValuebooleanNoSet field values using their display value (true) or actual value (false) (default: false)
sysparmSuppressAutoSysFieldbooleanNoTrue to suppress auto generation of system fields (default: false)
sysparmViewstringNoRender the response according to the specified UI view (overridden by sysparm_fields)
sysparmQueryNoDomainbooleanNoTrue to access data across domains if authorized (default: false)

Output

NameTypeDescription
resultRecord<PropertyKey, unknown>The response body of the request

Action : servicenow:now:table:retrieveRecord

Request Type: GET

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table from which to retrieve the record
sysIdstringYesUnique identifier of the record to retrieve
sysparmDisplayValueenum("true", "false", "all")NoReturn field display values (true), actual values (false), or both (all) (default: false)
sysparmExcludeReferenceLinkbooleanNoTrue to exclude Table API links for reference fields (default: false)
sysparmFieldsstring[]NoAn array of fields to return in the response
sysparmViewstringNoRender the response according to the specified UI view (overridden by sysparm_fields)
sysparmQueryNoDomainbooleanNoTrue to access data across domains if authorized (default: false)

Output

NameTypeDescription
resultRecord<PropertyKey, unknown>The response body of the request

Action : servicenow:now:table:retrieveRecords

Request Type: GET

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table from which to retrieve the records
sysparmQuerystringNoAn encoded query string used to filter the results
sysparmDisplayValueenum("true", "false", "all")NoReturn field display values (true), actual values (false), or both (all) (default: false)
sysparmExcludeReferenceLinkbooleanNoTrue to exclude Table API links for reference fields (default: false)
sysparmSuppressPaginationHeaderbooleanNoTrue to suppress pagination header (default: false)
sysparmFieldsstring[]NoAn array of fields to return in the response
sysparmLimitintNoThe maximum number of results returned per page (default: 10,000)
sysparmViewstringNoRender the response according to the specified UI view (overridden by sysparm_fields)
sysparmQueryCategorystringNoName of the query category (read replica category) to use for queries
sysparmQueryNoDomainbooleanNoTrue to access data across domains if authorized (default: false)
sysparmNoCountbooleanNoDo not execute a select count(*) on table (default: false)

Output

NameTypeDescription
resultRecord<PropertyKey, unknown>The response body of the request

Action : servicenow:now:table:updateRecord

Request Type: PATCH

Input

Parameter NameTypeRequiredDescription
tableNamestringYesName of the table in which to update the record
sysIdstringYesUnique identifier of the record to update
requestBodyRecord<PropertyKey, unknown>NoField name and the associated value for each parameter to define in the specified record
sysparmDisplayValueenum("true", "false", "all")NoReturn field display values (true), actual values (false), or both (all) (default: false)
sysparmExcludeReferenceLinkbooleanNoTrue to exclude Table API links for reference fields (default: false)
sysparmFieldsstring[]NoAn array of fields to return in the response
sysparmInputDisplayValuebooleanNoSet field values using their display value (true) or actual value (false) (default: false)
sysparmSuppressAutoSysFieldbooleanNoTrue to suppress auto generation of system fields (default: false)
sysparmViewstringNoRender the response according to the specified UI view (overridden by sysparm_fields)
sysparmQueryNoDomainbooleanNoTrue to access data across domains if authorized (default: false)

Output

NameTypeDescription
resultRecord<PropertyKey, unknown>The response body of the request
1.4.6

7 days ago

1.4.5

7 days ago

1.4.4

8 days ago

1.4.3

9 days ago

1.4.2

9 days ago

1.4.1

14 days ago

1.4.0

24 days ago

1.3.11

29 days ago

1.3.10

1 month ago

1.3.9

1 month ago

1.3.8

1 month ago

1.3.7

1 month ago

1.3.6

1 month ago

1.3.5

2 months ago

1.3.4

2 months ago

1.3.3

2 months ago

1.3.2

3 months ago

1.3.1

3 months ago

1.3.0

3 months ago

1.2.9

4 months ago

1.2.8

4 months ago

1.2.7

5 months ago

1.2.6

5 months ago