@sonisoft/now-sdk-ext-cli 5.2.0 → 5.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +279 -73
- package/dist/commands/flow/definition.d.ts +31 -0
- package/dist/commands/flow/definition.d.ts.map +1 -0
- package/dist/commands/flow/definition.js +166 -0
- package/dist/commands/flow/definition.js.map +1 -0
- package/dist/commands/transaction/kill.d.ts +12 -0
- package/dist/commands/transaction/kill.d.ts.map +1 -0
- package/dist/commands/transaction/kill.js +48 -0
- package/dist/commands/transaction/kill.js.map +1 -0
- package/dist/commands/transaction/list.d.ts +20 -0
- package/dist/commands/transaction/list.d.ts.map +1 -0
- package/dist/commands/transaction/list.js +64 -0
- package/dist/commands/transaction/list.js.map +1 -0
- package/dist/services/flow-display.service.d.ts +30 -1
- package/dist/services/flow-display.service.d.ts.map +1 -1
- package/dist/services/flow-display.service.js +134 -0
- package/dist/services/flow-display.service.js.map +1 -1
- package/dist/services/transaction-display.service.d.ts +5 -0
- package/dist/services/transaction-display.service.d.ts.map +1 -0
- package/dist/services/transaction-display.service.js +33 -0
- package/dist/services/transaction-display.service.js.map +1 -0
- package/oclif.manifest.json +420 -1
- package/package.json +7 -4
package/README.md
CHANGED
|
@@ -95,6 +95,7 @@ Execute individual ATF tests or entire test suites with detailed results, perfec
|
|
|
95
95
|
- [Query & Search](#query--search)
|
|
96
96
|
- [Aggregate & Analytics](#aggregate--analytics)
|
|
97
97
|
- [Instance Health Check](#instance-health-check)
|
|
98
|
+
- [Cluster Transactions](#cluster-transactions)
|
|
98
99
|
- [Flow Designer](#flow-designer-operations)
|
|
99
100
|
- [Bulk Operations](#bulk-record-operations)
|
|
100
101
|
- [All Commands](#-commands)
|
|
@@ -474,6 +475,23 @@ nex health check --json --auth dev
|
|
|
474
475
|
- Operational counts (open incidents, changes, problems)
|
|
475
476
|
- Color-coded status indicators
|
|
476
477
|
|
|
478
|
+
### Cluster Transactions
|
|
479
|
+
|
|
480
|
+
Discover active transactions from all responding ServiceNow cluster nodes, then submit a request for one exact transaction when necessary.
|
|
481
|
+
|
|
482
|
+
```bash
|
|
483
|
+
# List active transactions
|
|
484
|
+
nex transaction list --auth dev
|
|
485
|
+
|
|
486
|
+
# Return complete, untruncated records as JSON
|
|
487
|
+
nex transaction list --json --auth dev
|
|
488
|
+
|
|
489
|
+
# Submit a kill request for one deliberately selected transaction
|
|
490
|
+
nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
> **Warning:** A kill request aborts real work. Only pass an identifier you deliberately selected from a current `nex transaction list` result. Platform acceptance does not mean the transaction has cleared immediately; run a separate later list to confirm.
|
|
494
|
+
|
|
477
495
|
### Flow Designer Operations
|
|
478
496
|
|
|
479
497
|
Execute and manage Flow Designer flows, subflows, and actions from the CLI.
|
|
@@ -505,6 +523,19 @@ nex flow cancel --context-id ctx-abc123 --reason "No longer needed" --auth dev
|
|
|
505
523
|
|
|
506
524
|
# Send a message to a waiting flow (e.g., approval)
|
|
507
525
|
nex flow message --context-id ctx-abc123 --message approved --payload '{"approver":"admin"}' --auth dev
|
|
526
|
+
|
|
527
|
+
# Read a flow's design-time definition (nothing is executed; no context is created)
|
|
528
|
+
nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
|
|
529
|
+
|
|
530
|
+
# Read a subflow definition
|
|
531
|
+
nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
|
|
532
|
+
|
|
533
|
+
# Read a custom action definition with its ordered steps
|
|
534
|
+
nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
|
|
535
|
+
|
|
536
|
+
# Redirect the full JSON definition to a file, or pipe it into another tool
|
|
537
|
+
nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
|
|
538
|
+
nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
|
|
508
539
|
```
|
|
509
540
|
|
|
510
541
|
**Features:**
|
|
@@ -512,6 +543,8 @@ nex flow message --context-id ctx-abc123 --message approved --payload '{"approve
|
|
|
512
543
|
- Foreground (wait) or background execution modes
|
|
513
544
|
- Query flow context status, outputs, and errors
|
|
514
545
|
- Cancel running flows and send messages to paused flows
|
|
546
|
+
- Read design-time definitions of flows, subflows, and actions — read-only, and
|
|
547
|
+
distinct from `flow details`, which reports on one past execution
|
|
515
548
|
- JSON output for automation and CI/CD
|
|
516
549
|
|
|
517
550
|
### Bulk Record Operations
|
|
@@ -582,6 +615,9 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
|
|
|
582
615
|
* [Check only version and stuck jobs](#check-only-version-and-stuck-jobs)
|
|
583
616
|
* [Health check with custom stuck job threshold (60 minutes)](#health-check-with-custom-stuck-job-threshold-60-minutes)
|
|
584
617
|
* [JSON output for monitoring/alerting](#json-output-for-monitoringalerting)
|
|
618
|
+
* [List active transactions](#list-active-transactions)
|
|
619
|
+
* [Return complete, untruncated records as JSON](#return-complete-untruncated-records-as-json)
|
|
620
|
+
* [Submit a kill request for one deliberately selected transaction](#submit-a-kill-request-for-one-deliberately-selected-transaction)
|
|
585
621
|
* [Execute a flow in foreground (waits for completion)](#execute-a-flow-in-foreground-waits-for-completion)
|
|
586
622
|
* [Execute with inputs](#execute-with-inputs)
|
|
587
623
|
* [Execute a subflow](#execute-a-subflow)
|
|
@@ -591,6 +627,10 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
|
|
|
591
627
|
* [Check for errors](#check-for-errors)
|
|
592
628
|
* [Cancel a running flow](#cancel-a-running-flow)
|
|
593
629
|
* [Send a message to a waiting flow (e.g., approval)](#send-a-message-to-a-waiting-flow-eg-approval)
|
|
630
|
+
* [Read a flow's design-time definition (nothing is executed; no context is created)](#read-a-flows-design-time-definition-nothing-is-executed-no-context-is-created)
|
|
631
|
+
* [Read a subflow definition](#read-a-subflow-definition)
|
|
632
|
+
* [Read a custom action definition with its ordered steps](#read-a-custom-action-definition-with-its-ordered-steps)
|
|
633
|
+
* [Redirect the full JSON definition to a file, or pipe it into another tool](#redirect-the-full-json-definition-to-a-file-or-pipe-it-into-another-tool)
|
|
594
634
|
* [Dry-run: preview which records would be updated (safe default)](#dry-run-preview-which-records-would-be-updated-safe-default)
|
|
595
635
|
* [Confirm bulk update (actually modifies records)](#confirm-bulk-update-actually-modifies-records)
|
|
596
636
|
* [Dry-run: preview which records would be deleted](#dry-run-preview-which-records-would-be-deleted)
|
|
@@ -689,7 +729,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
|
|
|
689
729
|
$ nex COMMAND
|
|
690
730
|
running command...
|
|
691
731
|
$ nex (--version)
|
|
692
|
-
@sonisoft/now-sdk-ext-cli/5.
|
|
732
|
+
@sonisoft/now-sdk-ext-cli/5.4.0 linux-x64 node-v26.5.0
|
|
693
733
|
$ nex --help [COMMAND]
|
|
694
734
|
USAGE
|
|
695
735
|
$ nex COMMAND
|
|
@@ -749,6 +789,7 @@ rather than silently denying nothing.
|
|
|
749
789
|
* [`nex flow action`](#nex-flow-action)
|
|
750
790
|
* [`nex flow cancel`](#nex-flow-cancel)
|
|
751
791
|
* [`nex flow copy`](#nex-flow-copy)
|
|
792
|
+
* [`nex flow definition`](#nex-flow-definition)
|
|
752
793
|
* [`nex flow details`](#nex-flow-details)
|
|
753
794
|
* [`nex flow error`](#nex-flow-error)
|
|
754
795
|
* [`nex flow logs`](#nex-flow-logs)
|
|
@@ -798,6 +839,8 @@ rather than silently denying nothing.
|
|
|
798
839
|
* [`nex task comment`](#nex-task-comment)
|
|
799
840
|
* [`nex task find`](#nex-task-find)
|
|
800
841
|
* [`nex task resolve`](#nex-task-resolve)
|
|
842
|
+
* [`nex transaction kill`](#nex-transaction-kill)
|
|
843
|
+
* [`nex transaction list`](#nex-transaction-list)
|
|
801
844
|
* [`nex update-set`](#nex-update-set)
|
|
802
845
|
* [`nex update-set clone`](#nex-update-set-clone)
|
|
803
846
|
* [`nex update-set create`](#nex-update-set-create)
|
|
@@ -862,7 +905,7 @@ EXAMPLES
|
|
|
862
905
|
$ nex aggregate count --table incident --query "active=true" --json --auth dev
|
|
863
906
|
```
|
|
864
907
|
|
|
865
|
-
_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
908
|
+
_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/count.ts)_
|
|
866
909
|
|
|
867
910
|
## `nex aggregate group`
|
|
868
911
|
|
|
@@ -930,7 +973,7 @@ EXAMPLES
|
|
|
930
973
|
$ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
|
|
931
974
|
```
|
|
932
975
|
|
|
933
|
-
_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
976
|
+
_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/group.ts)_
|
|
934
977
|
|
|
935
978
|
## `nex aggregate query`
|
|
936
979
|
|
|
@@ -993,7 +1036,7 @@ EXAMPLES
|
|
|
993
1036
|
$ nex aggregate query --table incident --sum reassignment_count --json --auth dev
|
|
994
1037
|
```
|
|
995
1038
|
|
|
996
|
-
_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1039
|
+
_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/query.ts)_
|
|
997
1040
|
|
|
998
1041
|
## `nex app`
|
|
999
1042
|
|
|
@@ -1056,7 +1099,7 @@ EXAMPLES
|
|
|
1056
1099
|
$ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
|
|
1057
1100
|
```
|
|
1058
1101
|
|
|
1059
|
-
_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1102
|
+
_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/index.ts)_
|
|
1060
1103
|
|
|
1061
1104
|
## `nex app install`
|
|
1062
1105
|
|
|
@@ -1124,7 +1167,7 @@ EXAMPLES
|
|
|
1124
1167
|
$ nex app install -b -d ./apps.json -a dev-instance --log-level debug
|
|
1125
1168
|
```
|
|
1126
1169
|
|
|
1127
|
-
_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1170
|
+
_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/install.ts)_
|
|
1128
1171
|
|
|
1129
1172
|
## `nex app repo-install`
|
|
1130
1173
|
|
|
@@ -1209,7 +1252,7 @@ EXAMPLES
|
|
|
1209
1252
|
$ nex app repo-install -s x_my_app -a dev-instance --log-level debug
|
|
1210
1253
|
```
|
|
1211
1254
|
|
|
1212
|
-
_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1255
|
+
_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/repo-install.ts)_
|
|
1213
1256
|
|
|
1214
1257
|
## `nex app repo-list`
|
|
1215
1258
|
|
|
@@ -1284,7 +1327,7 @@ EXAMPLES
|
|
|
1284
1327
|
$ nex app repo-list -a dev-instance
|
|
1285
1328
|
```
|
|
1286
1329
|
|
|
1287
|
-
_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1330
|
+
_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/repo-list.ts)_
|
|
1288
1331
|
|
|
1289
1332
|
## `nex app uninstall`
|
|
1290
1333
|
|
|
@@ -1346,7 +1389,7 @@ EXAMPLES
|
|
|
1346
1389
|
$ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
|
|
1347
1390
|
```
|
|
1348
1391
|
|
|
1349
|
-
_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1392
|
+
_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/uninstall.ts)_
|
|
1350
1393
|
|
|
1351
1394
|
## `nex atf`
|
|
1352
1395
|
|
|
@@ -1429,7 +1472,7 @@ EXAMPLES
|
|
|
1429
1472
|
$ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
|
|
1430
1473
|
```
|
|
1431
1474
|
|
|
1432
|
-
_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1475
|
+
_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/atf/index.ts)_
|
|
1433
1476
|
|
|
1434
1477
|
## `nex attachment get`
|
|
1435
1478
|
|
|
@@ -1472,7 +1515,7 @@ EXAMPLES
|
|
|
1472
1515
|
$ nex attachment get -s att123 --json --auth dev
|
|
1473
1516
|
```
|
|
1474
1517
|
|
|
1475
|
-
_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1518
|
+
_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/get.ts)_
|
|
1476
1519
|
|
|
1477
1520
|
## `nex attachment list`
|
|
1478
1521
|
|
|
@@ -1517,7 +1560,7 @@ EXAMPLES
|
|
|
1517
1560
|
$ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
|
|
1518
1561
|
```
|
|
1519
1562
|
|
|
1520
|
-
_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1563
|
+
_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/list.ts)_
|
|
1521
1564
|
|
|
1522
1565
|
## `nex attachment upload`
|
|
1523
1566
|
|
|
@@ -1564,7 +1607,7 @@ EXAMPLES
|
|
|
1564
1607
|
$ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
|
|
1565
1608
|
```
|
|
1566
1609
|
|
|
1567
|
-
_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1610
|
+
_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/upload.ts)_
|
|
1568
1611
|
|
|
1569
1612
|
## `nex auth delete [ALIAS]`
|
|
1570
1613
|
|
|
@@ -1599,7 +1642,7 @@ EXAMPLES
|
|
|
1599
1642
|
$ nex auth delete --all
|
|
1600
1643
|
```
|
|
1601
1644
|
|
|
1602
|
-
_See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1645
|
+
_See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/delete.ts)_
|
|
1603
1646
|
|
|
1604
1647
|
## `nex auth doctor`
|
|
1605
1648
|
|
|
@@ -1627,7 +1670,7 @@ EXAMPLES
|
|
|
1627
1670
|
$ nex auth doctor --json
|
|
1628
1671
|
```
|
|
1629
1672
|
|
|
1630
|
-
_See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1673
|
+
_See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/doctor.ts)_
|
|
1631
1674
|
|
|
1632
1675
|
## `nex auth list`
|
|
1633
1676
|
|
|
@@ -1660,7 +1703,7 @@ EXAMPLES
|
|
|
1660
1703
|
$ nex auth list --json
|
|
1661
1704
|
```
|
|
1662
1705
|
|
|
1663
|
-
_See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1706
|
+
_See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/list.ts)_
|
|
1664
1707
|
|
|
1665
1708
|
## `nex auth use ALIAS`
|
|
1666
1709
|
|
|
@@ -1688,7 +1731,7 @@ EXAMPLES
|
|
|
1688
1731
|
$ nex auth use dev206299
|
|
1689
1732
|
```
|
|
1690
1733
|
|
|
1691
|
-
_See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1734
|
+
_See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/use.ts)_
|
|
1692
1735
|
|
|
1693
1736
|
## `nex autocomplete [SHELL]`
|
|
1694
1737
|
|
|
@@ -1763,7 +1806,7 @@ EXAMPLES
|
|
|
1763
1806
|
$ nex batch create --file ./records.json --no-transaction --auth dev
|
|
1764
1807
|
```
|
|
1765
1808
|
|
|
1766
|
-
_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1809
|
+
_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/batch/create.ts)_
|
|
1767
1810
|
|
|
1768
1811
|
## `nex batch update`
|
|
1769
1812
|
|
|
@@ -1807,7 +1850,7 @@ EXAMPLES
|
|
|
1807
1850
|
$ nex batch update --file ./updates.json --stop-on-error --auth dev
|
|
1808
1851
|
```
|
|
1809
1852
|
|
|
1810
|
-
_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1853
|
+
_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/batch/update.ts)_
|
|
1811
1854
|
|
|
1812
1855
|
## `nex bulk delete`
|
|
1813
1856
|
|
|
@@ -1871,7 +1914,7 @@ EXAMPLES
|
|
|
1871
1914
|
$ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
|
|
1872
1915
|
```
|
|
1873
1916
|
|
|
1874
|
-
_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1917
|
+
_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/bulk/delete.ts)_
|
|
1875
1918
|
|
|
1876
1919
|
## `nex bulk update`
|
|
1877
1920
|
|
|
@@ -1940,7 +1983,7 @@ EXAMPLES
|
|
|
1940
1983
|
$ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
|
|
1941
1984
|
```
|
|
1942
1985
|
|
|
1943
|
-
_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
1986
|
+
_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/bulk/update.ts)_
|
|
1944
1987
|
|
|
1945
1988
|
## `nex exec SCOPE [FILE]`
|
|
1946
1989
|
|
|
@@ -2070,7 +2113,7 @@ EXAMPLES
|
|
|
2070
2113
|
$ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
|
|
2071
2114
|
```
|
|
2072
2115
|
|
|
2073
|
-
_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2116
|
+
_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/exec/index.ts)_
|
|
2074
2117
|
|
|
2075
2118
|
## `nex flow action`
|
|
2076
2119
|
|
|
@@ -2124,7 +2167,7 @@ EXAMPLES
|
|
|
2124
2167
|
'{"table":"incident","values":{"short_description":"Test"}}' --auth dev
|
|
2125
2168
|
```
|
|
2126
2169
|
|
|
2127
|
-
_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2170
|
+
_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/action.ts)_
|
|
2128
2171
|
|
|
2129
2172
|
## `nex flow cancel`
|
|
2130
2173
|
|
|
@@ -2171,7 +2214,7 @@ EXAMPLES
|
|
|
2171
2214
|
$ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
|
|
2172
2215
|
```
|
|
2173
2216
|
|
|
2174
|
-
_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2217
|
+
_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/cancel.ts)_
|
|
2175
2218
|
|
|
2176
2219
|
## `nex flow copy`
|
|
2177
2220
|
|
|
@@ -2236,7 +2279,80 @@ EXAMPLES
|
|
|
2236
2279
|
dev
|
|
2237
2280
|
```
|
|
2238
2281
|
|
|
2239
|
-
_See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2282
|
+
_See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/copy.ts)_
|
|
2283
|
+
|
|
2284
|
+
## `nex flow definition`
|
|
2285
|
+
|
|
2286
|
+
Retrieve the read-only design-time definition of a flow, subflow, or action.
|
|
2287
|
+
|
|
2288
|
+
```
|
|
2289
|
+
USAGE
|
|
2290
|
+
$ nex flow definition -i <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
|
|
2291
|
+
<value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t flow|subflow|action] [--scope
|
|
2292
|
+
<value>]
|
|
2293
|
+
|
|
2294
|
+
FLAGS
|
|
2295
|
+
-a, --auth=<value> Auth alias to use.
|
|
2296
|
+
-i, --sys-id=<value> (required) sys_id of the flow, subflow, or action to retrieve
|
|
2297
|
+
-j, --json Output the complete typed result as JSON
|
|
2298
|
+
-t, --type=<option> [default: flow] Artifact type to retrieve. Must match what the sys_id actually is.
|
|
2299
|
+
<options: flow|subflow|action>
|
|
2300
|
+
--scope=<value> Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the
|
|
2301
|
+
artifact's own scope when omitted.
|
|
2302
|
+
|
|
2303
|
+
GLOBAL FLAGS
|
|
2304
|
+
--cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
|
|
2305
|
+
sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
|
|
2306
|
+
--deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
|
|
2307
|
+
--deny-write Refuse any change to instance data for this invocation.
|
|
2308
|
+
--log-dir=<value> Directory to write log files to. Implies --log-file.
|
|
2309
|
+
--log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
|
|
2310
|
+
(~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
|
|
2311
|
+
stderr only.
|
|
2312
|
+
--log-level=<option> [default: info] Specify level for logging.
|
|
2313
|
+
<options: debug|warn|error|info|trace>
|
|
2314
|
+
--read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
|
|
2315
|
+
unaffected.
|
|
2316
|
+
|
|
2317
|
+
DESCRIPTION
|
|
2318
|
+
Retrieve the read-only design-time definition of a flow, subflow, or action.
|
|
2319
|
+
|
|
2320
|
+
Returns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and
|
|
2321
|
+
outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or
|
|
2322
|
+
required.
|
|
2323
|
+
|
|
2324
|
+
This is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.
|
|
2325
|
+
|
|
2326
|
+
The type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different
|
|
2327
|
+
type fails with a type_mismatch rather than being relabelled.
|
|
2328
|
+
|
|
2329
|
+
With --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow
|
|
2330
|
+
payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts
|
|
2331
|
+
and input values are never printed or logged.
|
|
2332
|
+
|
|
2333
|
+
EXAMPLES
|
|
2334
|
+
Summarise a flow definition
|
|
2335
|
+
|
|
2336
|
+
$ nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
|
|
2337
|
+
|
|
2338
|
+
Retrieve a subflow definition
|
|
2339
|
+
|
|
2340
|
+
$ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
|
|
2341
|
+
|
|
2342
|
+
Retrieve a custom action definition with its ordered steps
|
|
2343
|
+
|
|
2344
|
+
$ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
|
|
2345
|
+
|
|
2346
|
+
Redirect the full JSON definition to a file
|
|
2347
|
+
|
|
2348
|
+
$ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
|
|
2349
|
+
|
|
2350
|
+
Pipe the JSON definition into another tool
|
|
2351
|
+
|
|
2352
|
+
$ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
|
|
2353
|
+
```
|
|
2354
|
+
|
|
2355
|
+
_See code: [src/commands/flow/definition.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/definition.ts)_
|
|
2240
2356
|
|
|
2241
2357
|
## `nex flow details`
|
|
2242
2358
|
|
|
@@ -2297,7 +2413,7 @@ EXAMPLES
|
|
|
2297
2413
|
$ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
|
|
2298
2414
|
```
|
|
2299
2415
|
|
|
2300
|
-
_See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2416
|
+
_See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/details.ts)_
|
|
2301
2417
|
|
|
2302
2418
|
## `nex flow error`
|
|
2303
2419
|
|
|
@@ -2339,7 +2455,7 @@ EXAMPLES
|
|
|
2339
2455
|
$ nex flow error --context-id abc123def456 --auth dev
|
|
2340
2456
|
```
|
|
2341
2457
|
|
|
2342
|
-
_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2458
|
+
_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/error.ts)_
|
|
2343
2459
|
|
|
2344
2460
|
## `nex flow logs`
|
|
2345
2461
|
|
|
@@ -2397,7 +2513,7 @@ EXAMPLES
|
|
|
2397
2513
|
$ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
|
|
2398
2514
|
```
|
|
2399
2515
|
|
|
2400
|
-
_See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2516
|
+
_See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/logs.ts)_
|
|
2401
2517
|
|
|
2402
2518
|
## `nex flow message`
|
|
2403
2519
|
|
|
@@ -2447,7 +2563,7 @@ EXAMPLES
|
|
|
2447
2563
|
$ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
|
|
2448
2564
|
```
|
|
2449
2565
|
|
|
2450
|
-
_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2566
|
+
_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/message.ts)_
|
|
2451
2567
|
|
|
2452
2568
|
## `nex flow outputs`
|
|
2453
2569
|
|
|
@@ -2493,7 +2609,7 @@ EXAMPLES
|
|
|
2493
2609
|
$ nex flow outputs --context-id abc123def456 --json --auth dev
|
|
2494
2610
|
```
|
|
2495
2611
|
|
|
2496
|
-
_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2612
|
+
_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/outputs.ts)_
|
|
2497
2613
|
|
|
2498
2614
|
## `nex flow run`
|
|
2499
2615
|
|
|
@@ -2559,7 +2675,7 @@ EXAMPLES
|
|
|
2559
2675
|
$ nex flow run --name global.my_flow --mode background --auth dev
|
|
2560
2676
|
```
|
|
2561
2677
|
|
|
2562
|
-
_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2678
|
+
_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/run.ts)_
|
|
2563
2679
|
|
|
2564
2680
|
## `nex flow status`
|
|
2565
2681
|
|
|
@@ -2603,7 +2719,7 @@ EXAMPLES
|
|
|
2603
2719
|
$ nex flow status --context-id abc123def456 --auth dev
|
|
2604
2720
|
```
|
|
2605
2721
|
|
|
2606
|
-
_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2722
|
+
_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/status.ts)_
|
|
2607
2723
|
|
|
2608
2724
|
## `nex flow subflow`
|
|
2609
2725
|
|
|
@@ -2663,7 +2779,7 @@ EXAMPLES
|
|
|
2663
2779
|
$ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
|
|
2664
2780
|
```
|
|
2665
2781
|
|
|
2666
|
-
_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2782
|
+
_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/subflow.ts)_
|
|
2667
2783
|
|
|
2668
2784
|
## `nex flow test`
|
|
2669
2785
|
|
|
@@ -2726,7 +2842,7 @@ EXAMPLES
|
|
|
2726
2842
|
$ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
|
|
2727
2843
|
```
|
|
2728
2844
|
|
|
2729
|
-
_See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2845
|
+
_See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/test.ts)_
|
|
2730
2846
|
|
|
2731
2847
|
## `nex health check`
|
|
2732
2848
|
|
|
@@ -2796,7 +2912,7 @@ EXAMPLES
|
|
|
2796
2912
|
$ nex health check --json --auth dev
|
|
2797
2913
|
```
|
|
2798
2914
|
|
|
2799
|
-
_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
2915
|
+
_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/health/check.ts)_
|
|
2800
2916
|
|
|
2801
2917
|
## `nex help [COMMAND]`
|
|
2802
2918
|
|
|
@@ -2932,7 +3048,7 @@ EXAMPLES
|
|
|
2932
3048
|
$ nex log --no-color --auth dev-instance
|
|
2933
3049
|
```
|
|
2934
3050
|
|
|
2935
|
-
_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3051
|
+
_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/log/index.ts)_
|
|
2936
3052
|
|
|
2937
3053
|
## `nex plugins`
|
|
2938
3054
|
|
|
@@ -3254,7 +3370,7 @@ EXAMPLES
|
|
|
3254
3370
|
NEX_POLICY_DENY=all nex policy status
|
|
3255
3371
|
```
|
|
3256
3372
|
|
|
3257
|
-
_See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3373
|
+
_See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/policy/status.ts)_
|
|
3258
3374
|
|
|
3259
3375
|
## `nex query`
|
|
3260
3376
|
|
|
@@ -3317,7 +3433,7 @@ EXAMPLES
|
|
|
3317
3433
|
$ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
|
|
3318
3434
|
```
|
|
3319
3435
|
|
|
3320
|
-
_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3436
|
+
_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/index.ts)_
|
|
3321
3437
|
|
|
3322
3438
|
## `nex query app`
|
|
3323
3439
|
|
|
@@ -3370,7 +3486,7 @@ EXAMPLES
|
|
|
3370
3486
|
$ nex query app --search "HR" --active --auth dev
|
|
3371
3487
|
```
|
|
3372
3488
|
|
|
3373
|
-
_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3489
|
+
_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/app.ts)_
|
|
3374
3490
|
|
|
3375
3491
|
## `nex query columns`
|
|
3376
3492
|
|
|
@@ -3425,7 +3541,7 @@ EXAMPLES
|
|
|
3425
3541
|
$ nex query columns --table incident --json --auth dev
|
|
3426
3542
|
```
|
|
3427
3543
|
|
|
3428
|
-
_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3544
|
+
_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/columns.ts)_
|
|
3429
3545
|
|
|
3430
3546
|
## `nex query syslog`
|
|
3431
3547
|
|
|
@@ -3482,7 +3598,7 @@ EXAMPLES
|
|
|
3482
3598
|
$ nex query syslog --query "sourceLIKEincident" --json --auth dev
|
|
3483
3599
|
```
|
|
3484
3600
|
|
|
3485
|
-
_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3601
|
+
_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/syslog.ts)_
|
|
3486
3602
|
|
|
3487
3603
|
## `nex schema`
|
|
3488
3604
|
|
|
@@ -3541,7 +3657,7 @@ EXAMPLES
|
|
|
3541
3657
|
$ nex schema --table incident --include-choices --include-relationships --auth dev
|
|
3542
3658
|
```
|
|
3543
3659
|
|
|
3544
|
-
_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3660
|
+
_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/index.ts)_
|
|
3545
3661
|
|
|
3546
3662
|
## `nex schema field`
|
|
3547
3663
|
|
|
@@ -3588,7 +3704,7 @@ EXAMPLES
|
|
|
3588
3704
|
$ nex schema field --table incident --field priority --json --auth dev
|
|
3589
3705
|
```
|
|
3590
3706
|
|
|
3591
|
-
_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3707
|
+
_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/field.ts)_
|
|
3592
3708
|
|
|
3593
3709
|
## `nex schema validate-catalog`
|
|
3594
3710
|
|
|
@@ -3634,7 +3750,7 @@ EXAMPLES
|
|
|
3634
3750
|
$ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
|
|
3635
3751
|
```
|
|
3636
3752
|
|
|
3637
|
-
_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3753
|
+
_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/validate-catalog.ts)_
|
|
3638
3754
|
|
|
3639
3755
|
## `nex scope`
|
|
3640
3756
|
|
|
@@ -3681,7 +3797,7 @@ EXAMPLES
|
|
|
3681
3797
|
$ nex scope -l --json --auth dev
|
|
3682
3798
|
```
|
|
3683
3799
|
|
|
3684
|
-
_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3800
|
+
_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/scope/index.ts)_
|
|
3685
3801
|
|
|
3686
3802
|
## `nex scope set`
|
|
3687
3803
|
|
|
@@ -3724,7 +3840,7 @@ EXAMPLES
|
|
|
3724
3840
|
$ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
|
|
3725
3841
|
```
|
|
3726
3842
|
|
|
3727
|
-
_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3843
|
+
_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/scope/set.ts)_
|
|
3728
3844
|
|
|
3729
3845
|
## `nex script-sync pull`
|
|
3730
3846
|
|
|
@@ -3784,7 +3900,7 @@ EXAMPLES
|
|
|
3784
3900
|
$ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
|
|
3785
3901
|
```
|
|
3786
3902
|
|
|
3787
|
-
_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3903
|
+
_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/pull.ts)_
|
|
3788
3904
|
|
|
3789
3905
|
## `nex script-sync push`
|
|
3790
3906
|
|
|
@@ -3845,7 +3961,7 @@ EXAMPLES
|
|
|
3845
3961
|
$ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
|
|
3846
3962
|
```
|
|
3847
3963
|
|
|
3848
|
-
_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
3964
|
+
_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/push.ts)_
|
|
3849
3965
|
|
|
3850
3966
|
## `nex script-sync sync`
|
|
3851
3967
|
|
|
@@ -3904,7 +4020,7 @@ EXAMPLES
|
|
|
3904
4020
|
$ nex script-sync sync -d ./scripts --json --auth dev-instance
|
|
3905
4021
|
```
|
|
3906
4022
|
|
|
3907
|
-
_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4023
|
+
_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/sync.ts)_
|
|
3908
4024
|
|
|
3909
4025
|
## `nex search`
|
|
3910
4026
|
|
|
@@ -3971,7 +4087,7 @@ EXAMPLES
|
|
|
3971
4087
|
$ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
|
|
3972
4088
|
```
|
|
3973
4089
|
|
|
3974
|
-
_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4090
|
+
_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/index.ts)_
|
|
3975
4091
|
|
|
3976
4092
|
## `nex search add-table`
|
|
3977
4093
|
|
|
@@ -4031,7 +4147,7 @@ EXAMPLES
|
|
|
4031
4147
|
dev-instance
|
|
4032
4148
|
```
|
|
4033
4149
|
|
|
4034
|
-
_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4150
|
+
_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/add-table.ts)_
|
|
4035
4151
|
|
|
4036
4152
|
## `nex search groups`
|
|
4037
4153
|
|
|
@@ -4080,7 +4196,7 @@ EXAMPLES
|
|
|
4080
4196
|
$ nex search groups --json --auth dev-instance
|
|
4081
4197
|
```
|
|
4082
4198
|
|
|
4083
|
-
_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4199
|
+
_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/groups.ts)_
|
|
4084
4200
|
|
|
4085
4201
|
## `nex search tables`
|
|
4086
4202
|
|
|
@@ -4131,7 +4247,7 @@ EXAMPLES
|
|
|
4131
4247
|
$ nex search tables --search-group "Business Rules" --json --auth dev-instance
|
|
4132
4248
|
```
|
|
4133
4249
|
|
|
4134
|
-
_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4250
|
+
_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/tables.ts)_
|
|
4135
4251
|
|
|
4136
4252
|
## `nex store install`
|
|
4137
4253
|
|
|
@@ -4184,7 +4300,7 @@ EXAMPLES
|
|
|
4184
4300
|
$ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
|
|
4185
4301
|
```
|
|
4186
4302
|
|
|
4187
|
-
_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4303
|
+
_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/install.ts)_
|
|
4188
4304
|
|
|
4189
4305
|
## `nex store search`
|
|
4190
4306
|
|
|
@@ -4235,7 +4351,7 @@ EXAMPLES
|
|
|
4235
4351
|
$ nex store search --tab updates --limit 10 --auth dev
|
|
4236
4352
|
```
|
|
4237
4353
|
|
|
4238
|
-
_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4354
|
+
_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/search.ts)_
|
|
4239
4355
|
|
|
4240
4356
|
## `nex store update`
|
|
4241
4357
|
|
|
@@ -4287,7 +4403,7 @@ EXAMPLES
|
|
|
4287
4403
|
$ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
|
|
4288
4404
|
```
|
|
4289
4405
|
|
|
4290
|
-
_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4406
|
+
_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/update.ts)_
|
|
4291
4407
|
|
|
4292
4408
|
## `nex store validate`
|
|
4293
4409
|
|
|
@@ -4326,7 +4442,7 @@ EXAMPLES
|
|
|
4326
4442
|
$ nex store validate --file ./batch-definition.json --auth dev
|
|
4327
4443
|
```
|
|
4328
4444
|
|
|
4329
|
-
_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4445
|
+
_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/validate.ts)_
|
|
4330
4446
|
|
|
4331
4447
|
## `nex task approve`
|
|
4332
4448
|
|
|
@@ -4377,7 +4493,7 @@ EXAMPLES
|
|
|
4377
4493
|
$ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
|
|
4378
4494
|
```
|
|
4379
4495
|
|
|
4380
|
-
_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4496
|
+
_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/approve.ts)_
|
|
4381
4497
|
|
|
4382
4498
|
## `nex task assign`
|
|
4383
4499
|
|
|
@@ -4438,7 +4554,7 @@ EXAMPLES
|
|
|
4438
4554
|
$ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
|
|
4439
4555
|
```
|
|
4440
4556
|
|
|
4441
|
-
_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4557
|
+
_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/assign.ts)_
|
|
4442
4558
|
|
|
4443
4559
|
## `nex task close`
|
|
4444
4560
|
|
|
@@ -4492,7 +4608,7 @@ EXAMPLES
|
|
|
4492
4608
|
$ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
|
|
4493
4609
|
```
|
|
4494
4610
|
|
|
4495
|
-
_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4611
|
+
_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/close.ts)_
|
|
4496
4612
|
|
|
4497
4613
|
## `nex task comment`
|
|
4498
4614
|
|
|
@@ -4552,7 +4668,7 @@ EXAMPLES
|
|
|
4552
4668
|
$ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
|
|
4553
4669
|
```
|
|
4554
4670
|
|
|
4555
|
-
_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4671
|
+
_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/comment.ts)_
|
|
4556
4672
|
|
|
4557
4673
|
## `nex task find`
|
|
4558
4674
|
|
|
@@ -4608,7 +4724,7 @@ EXAMPLES
|
|
|
4608
4724
|
$ nex task find -n INC0010001 --json --auth dev
|
|
4609
4725
|
```
|
|
4610
4726
|
|
|
4611
|
-
_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4727
|
+
_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/find.ts)_
|
|
4612
4728
|
|
|
4613
4729
|
## `nex task resolve`
|
|
4614
4730
|
|
|
@@ -4662,7 +4778,97 @@ EXAMPLES
|
|
|
4662
4778
|
$ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
|
|
4663
4779
|
```
|
|
4664
4780
|
|
|
4665
|
-
_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4781
|
+
_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/resolve.ts)_
|
|
4782
|
+
|
|
4783
|
+
## `nex transaction kill`
|
|
4784
|
+
|
|
4785
|
+
Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
|
|
4786
|
+
|
|
4787
|
+
```
|
|
4788
|
+
USAGE
|
|
4789
|
+
$ nex transaction kill -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
|
|
4790
|
+
<value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm]
|
|
4791
|
+
|
|
4792
|
+
FLAGS
|
|
4793
|
+
-a, --auth=<value> Auth alias to use.
|
|
4794
|
+
-t, --transaction-id=<value> (required) Exact 32-character hexadecimal sys_id from `nex transaction list`.
|
|
4795
|
+
--confirm Confirm submission of the kill request.
|
|
4796
|
+
|
|
4797
|
+
GLOBAL FLAGS
|
|
4798
|
+
--cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
|
|
4799
|
+
sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
|
|
4800
|
+
--deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
|
|
4801
|
+
--deny-write Refuse any change to instance data for this invocation.
|
|
4802
|
+
--json Format output as json.
|
|
4803
|
+
--log-dir=<value> Directory to write log files to. Implies --log-file.
|
|
4804
|
+
--log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
|
|
4805
|
+
(~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
|
|
4806
|
+
stderr only.
|
|
4807
|
+
--log-level=<option> [default: info] Specify level for logging.
|
|
4808
|
+
<options: debug|warn|error|info|trace>
|
|
4809
|
+
--read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
|
|
4810
|
+
unaffected.
|
|
4811
|
+
|
|
4812
|
+
DESCRIPTION
|
|
4813
|
+
Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
|
|
4814
|
+
|
|
4815
|
+
Only pass an identifier you deliberately selected from `nex transaction list`. Killing another user's transaction
|
|
4816
|
+
aborts their work.
|
|
4817
|
+
|
|
4818
|
+
EXAMPLES
|
|
4819
|
+
$ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
|
|
4820
|
+
|
|
4821
|
+
$ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --json --auth dev
|
|
4822
|
+
```
|
|
4823
|
+
|
|
4824
|
+
_See code: [src/commands/transaction/kill.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/transaction/kill.ts)_
|
|
4825
|
+
|
|
4826
|
+
## `nex transaction list`
|
|
4827
|
+
|
|
4828
|
+
List active transactions from all responding ServiceNow cluster nodes.
|
|
4829
|
+
|
|
4830
|
+
```
|
|
4831
|
+
USAGE
|
|
4832
|
+
$ nex transaction list [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
|
|
4833
|
+
[--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [--poll-interval-ms <value>] [-q
|
|
4834
|
+
<value>] [--timeout-ms <value>]
|
|
4835
|
+
|
|
4836
|
+
FLAGS
|
|
4837
|
+
-a, --auth=<value> Auth alias to use.
|
|
4838
|
+
-l, --limit=<value> Maximum transactions to return. Core default: 1000.
|
|
4839
|
+
-q, --query=<value> Encoded query used to filter transactions. Core default: none.
|
|
4840
|
+
--poll-interval-ms=<value> Interval between collection status polls. Core default: 1000.
|
|
4841
|
+
--timeout-ms=<value> Collection timeout in milliseconds. Core default: 60000.
|
|
4842
|
+
|
|
4843
|
+
GLOBAL FLAGS
|
|
4844
|
+
--cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
|
|
4845
|
+
sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
|
|
4846
|
+
--deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
|
|
4847
|
+
--deny-write Refuse any change to instance data for this invocation.
|
|
4848
|
+
--json Format output as json.
|
|
4849
|
+
--log-dir=<value> Directory to write log files to. Implies --log-file.
|
|
4850
|
+
--log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
|
|
4851
|
+
(~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
|
|
4852
|
+
stderr only.
|
|
4853
|
+
--log-level=<option> [default: info] Specify level for logging.
|
|
4854
|
+
<options: debug|warn|error|info|trace>
|
|
4855
|
+
--read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
|
|
4856
|
+
unaffected.
|
|
4857
|
+
|
|
4858
|
+
DESCRIPTION
|
|
4859
|
+
List active transactions from all responding ServiceNow cluster nodes.
|
|
4860
|
+
|
|
4861
|
+
EXAMPLES
|
|
4862
|
+
$ nex transaction list --auth dev
|
|
4863
|
+
|
|
4864
|
+
$ nex transaction list --json --auth dev
|
|
4865
|
+
|
|
4866
|
+
$ nex transaction list --query "user=admin" --limit 50 --auth dev
|
|
4867
|
+
|
|
4868
|
+
$ nex transaction list --timeout-ms 120000 --poll-interval-ms 2000 --auth dev
|
|
4869
|
+
```
|
|
4870
|
+
|
|
4871
|
+
_See code: [src/commands/transaction/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/transaction/list.ts)_
|
|
4666
4872
|
|
|
4667
4873
|
## `nex update-set`
|
|
4668
4874
|
|
|
@@ -4710,7 +4916,7 @@ EXAMPLES
|
|
|
4710
4916
|
$ nex update-set --json --auth dev-instance
|
|
4711
4917
|
```
|
|
4712
4918
|
|
|
4713
|
-
_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4919
|
+
_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/index.ts)_
|
|
4714
4920
|
|
|
4715
4921
|
## `nex update-set clone`
|
|
4716
4922
|
|
|
@@ -4754,7 +4960,7 @@ EXAMPLES
|
|
|
4754
4960
|
$ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
|
|
4755
4961
|
```
|
|
4756
4962
|
|
|
4757
|
-
_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
4963
|
+
_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/clone.ts)_
|
|
4758
4964
|
|
|
4759
4965
|
## `nex update-set create`
|
|
4760
4966
|
|
|
@@ -4803,7 +5009,7 @@ EXAMPLES
|
|
|
4803
5009
|
$ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
|
|
4804
5010
|
```
|
|
4805
5011
|
|
|
4806
|
-
_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5012
|
+
_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/create.ts)_
|
|
4807
5013
|
|
|
4808
5014
|
## `nex update-set current`
|
|
4809
5015
|
|
|
@@ -4850,7 +5056,7 @@ EXAMPLES
|
|
|
4850
5056
|
$ nex update-set current --json --auth dev-instance
|
|
4851
5057
|
```
|
|
4852
5058
|
|
|
4853
|
-
_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5059
|
+
_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/current.ts)_
|
|
4854
5060
|
|
|
4855
5061
|
## `nex update-set inspect`
|
|
4856
5062
|
|
|
@@ -4893,7 +5099,7 @@ EXAMPLES
|
|
|
4893
5099
|
$ nex update-set inspect --sys-id us-001 --json --auth dev-instance
|
|
4894
5100
|
```
|
|
4895
5101
|
|
|
4896
|
-
_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5102
|
+
_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/inspect.ts)_
|
|
4897
5103
|
|
|
4898
5104
|
## `nex update-set move`
|
|
4899
5105
|
|
|
@@ -4943,7 +5149,7 @@ EXAMPLES
|
|
|
4943
5149
|
$ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
|
|
4944
5150
|
```
|
|
4945
5151
|
|
|
4946
|
-
_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5152
|
+
_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/move.ts)_
|
|
4947
5153
|
|
|
4948
5154
|
## `nex workflow create`
|
|
4949
5155
|
|
|
@@ -4986,7 +5192,7 @@ EXAMPLES
|
|
|
4986
5192
|
$ nex workflow create -s ./workflow.json --json --auth dev
|
|
4987
5193
|
```
|
|
4988
5194
|
|
|
4989
|
-
_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5195
|
+
_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/workflow/create.ts)_
|
|
4990
5196
|
|
|
4991
5197
|
## `nex workflow publish`
|
|
4992
5198
|
|
|
@@ -5030,7 +5236,7 @@ EXAMPLES
|
|
|
5030
5236
|
$ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
|
|
5031
5237
|
```
|
|
5032
5238
|
|
|
5033
|
-
_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5239
|
+
_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/workflow/publish.ts)_
|
|
5034
5240
|
|
|
5035
5241
|
## `nex xml export`
|
|
5036
5242
|
|
|
@@ -5088,7 +5294,7 @@ EXAMPLES
|
|
|
5088
5294
|
$ nex xml export --table sys_script --sys-id abc123 --json --auth dev
|
|
5089
5295
|
```
|
|
5090
5296
|
|
|
5091
|
-
_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5297
|
+
_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/xml/export.ts)_
|
|
5092
5298
|
|
|
5093
5299
|
## `nex xml import`
|
|
5094
5300
|
|
|
@@ -5140,7 +5346,7 @@ EXAMPLES
|
|
|
5140
5346
|
$ nex xml import --file ./records.xml --table incident --json --auth dev
|
|
5141
5347
|
```
|
|
5142
5348
|
|
|
5143
|
-
_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.
|
|
5349
|
+
_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/xml/import.ts)_
|
|
5144
5350
|
<!-- commandsstop -->
|
|
5145
5351
|
|
|
5146
5352
|
---
|