Skip to content

Commit 8113e79

Browse files
committed
Merge branch 'main' into feature/linter-adjustments
# Conflicts: # data/plugins.json # docs/build/reference/customtask/DistinctBy.md # docs/build/reference/customtask/Pivot.md # docs/build/reference/customtask/Scheduler.md # docs/build/reference/customtask/SearchAddresses.md # docs/build/reference/customtask/Unpivot.md # docs/build/reference/customtask/clearDataset.md # docs/build/reference/customtask/cmem_plugin_llm-CreateEmbeddings.md # docs/build/reference/customtask/cmem_plugin_llm-ExecuteInstructions.md # docs/build/reference/customtask/cmem_plugin_office365-Download.md # docs/build/reference/customtask/cmem_plugin_office365-List.md # docs/build/reference/customtask/cmem_plugin_office365-Upload.md # docs/build/reference/customtask/cmem_plugin_reason-plugin_reason-ReasonPlugin.md # docs/build/reference/customtask/cmem_plugin_reason-plugin_validate-ValidatePlugin.md # docs/build/reference/customtask/cmem_plugin_salesforce-workflow-operations-SobjectCreate.md # docs/build/reference/customtask/cmem_plugin_shapes-plugin_shapes-ShapesPlugin.md # docs/build/reference/customtask/cmem_plugin_wfreports_get_report.md # docs/build/reference/customtask/downloadFile.md # docs/build/reference/customtask/sparqlSelectOperator.md # docs/build/reference/customtask/sparqlUpdateOperator.md # docs/build/reference/customtask/xsltOperator.md # docs/build/reference/dataset/Hive.md # docs/build/reference/dataset/Jdbc.md # docs/build/reference/dataset/alignment.md # docs/build/reference/dataset/avro.md # docs/build/reference/dataset/csv.md # docs/build/reference/dataset/eccencaDataPlatform.md # docs/build/reference/dataset/file.md # docs/build/reference/dataset/inMemory.md # docs/build/reference/dataset/multiCsv.md # docs/build/reference/dataset/neo4j.md # docs/build/reference/dataset/orc.md # docs/build/reference/dataset/parquet.md # docs/build/reference/dataset/sparqlEndpoint.md # docs/build/reference/dataset/sqlEndpoint.md # docs/build/reference/transformer/Combine/zip.md # docs/build/reference/transformer/Date/compareDates.md # docs/build/reference/transformer/Filter/removeDefaultStopWords.md # docs/build/reference/transformer/Filter/removeRemoteStopWords.md # docs/build/reference/transformer/Geo/RetrieveCoordinates.md # docs/build/reference/transformer/Geo/RetrieveLatitude.md # docs/build/reference/transformer/Geo/RetrieveLongitude.md # docs/build/reference/transformer/Linguistic/NYSIIS.md # docs/build/reference/transformer/Linguistic/metaphone.md # docs/build/reference/transformer/Linguistic/soundex.md # docs/build/reference/transformer/Numeric/numOperation.md # docs/build/reference/transformer/Numeric/numReduce.md # docs/build/reference/transformer/Parser/GeoCoordinateParser.md # docs/build/reference/transformer/Parser/GeoLocationParser.md # docs/build/reference/transformer/Replace/excelMap.md # docs/build/reference/transformer/Uncategorized/cmem_plugin_currencies-transform.md # docs/build/reference/transformer/index.md # docs/deploy-and-configure/configuration/explore/dataplatform/application-full.md # docs/deploy-and-configure/configuration/explore/dataplatform/application-oauth-full.md # docs/deploy-and-configure/configuration/explore/dataplatform/application-virtuoso-full.md # docs/develop/marketplace-packages/index.md # docs/explore-and-author/graph-exploration/building-a-customized-user-interface/datatype-reference/index.md # docs/explore-and-author/graph-exploration/building-a-customized-user-interface/property-shapes/index.md # docs/release-notes/corporate-memory-24-2/index.md
2 parents e4612f2 + 06b0e7c commit 8113e79

431 files changed

Lines changed: 9281 additions & 3123 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Taskfile.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ version: '3'
55

66
vars:
77
PUBLIC_BRANCH: published
8-
CURRENT_VERSION: 25.3
8+
CURRENT_VERSION: 26.1
99
MATERIAL_TAG: 9.6.14
1010
MATERIAL_INSIDER_TAG: 9.6.14-insiders-4.53.16
1111

data/plugins.json

Lines changed: 278 additions & 117 deletions
Large diffs are not rendered by default.

docs/automate/cmemc-command-line-interface/command-reference/admin/acl/index.md

Lines changed: 63 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,25 +6,29 @@ tags:
66
- Security
77
- cmemc
88
---
9-
109
# admin acl Command Group
11-
1210
<!-- This file was generated - DO NOT CHANGE IT MANUALLY -->
1311

1412
List, create, delete and modify and review access conditions.
1513

1614
With this command group, you can manage and inspect access conditions in eccenca Corporate Memory. Access conditions are identified by a URL. They grant access to knowledge graphs or actions to user or groups.
1715

16+
1817
## admin acl list
1918

2019
List access conditions.
2120

2221
```shell-session title="Usage"
23-
cmemc admin acl list [OPTIONS]
22+
$ cmemc admin acl list [OPTIONS]
2423
```
2524

25+
26+
27+
2628
This command retrieves and lists all access conditions, which are manageable by the current account.
2729

30+
31+
2832
??? info "Options"
2933
```text
3034

@@ -41,12 +45,18 @@ This command retrieves and lists all access conditions, which are manageable by
4145
Inspect an access condition.
4246

4347
```shell-session title="Usage"
44-
cmemc admin acl inspect [OPTIONS] ACCESS_CONDITION_ID
48+
$ cmemc admin acl inspect [OPTIONS] ACCESS_CONDITION_ID
4549
```
4650

51+
52+
53+
4754
!!! note
4855
access conditions can be listed by using the `acl list` command.
4956

57+
58+
59+
5060
??? info "Options"
5161
```text
5262

@@ -58,9 +68,12 @@ cmemc admin acl inspect [OPTIONS] ACCESS_CONDITION_ID
5868
Create an access condition.
5969

6070
```shell-session title="Usage"
61-
cmemc admin acl create [OPTIONS]
71+
$ cmemc admin acl create [OPTIONS]
6272
```
6373

74+
75+
76+
6477
With this command, new access conditions can be created.
6578

6679
An access condition captures information about WHO gets access to WHAT. In order to specify WHO gets access, use the ``--user`` and / or ``--group`` options. In order to specify WHAT an account get access to, use the ``--read-graph``, ``--write-graph`` and ``--action`` options.`
@@ -72,10 +85,14 @@ A special case are dynamic access conditions, based on a SPARQL query: Here you
7285
!!! note
7386
Queries for dynamic access conditions are copied into the ACL, so changing the query in the query catalog does not change it in the access condition.
7487

88+
7589
```shell-session title="Example"
76-
cmemc admin acl create --group local-users --write-graph https://example.org/
90+
$ cmemc admin acl create --group local-users --write-graph https://example.org/
7791
```
7892

93+
94+
95+
7996
??? info "Options"
8097
```text
8198

@@ -118,11 +135,16 @@ cmemc admin acl create --group local-users --write-graph https://example.org/
118135
Update an access condition.
119136

120137
```shell-session title="Usage"
121-
cmemc admin acl update [OPTIONS] ACCESS_CONDITION_ID
138+
$ cmemc admin acl update [OPTIONS] ACCESS_CONDITION_ID
122139
```
123140

141+
142+
143+
124144
Given an access condition URL, you can change specific options to new values.
125145

146+
147+
126148
??? info "Options"
127149
```text
128150

@@ -161,17 +183,24 @@ Given an access condition URL, you can change specific options to new values.
161183
Delete access conditions.
162184

163185
```shell-session title="Usage"
164-
cmemc admin acl delete [OPTIONS] [ACCESS_CONDITION_IDS]...
186+
$ cmemc admin acl delete [OPTIONS] [ACCESS_CONDITION_IDS]...
165187
```
166188

189+
190+
191+
167192
This command deletes existing access conditions from the account.
168193

169194
!!! warning
170195
Access conditions will be deleted without prompting.
171196

197+
172198
!!! note
173199
Access conditions can be listed by using the `admin acl list` command.
174200

201+
202+
203+
175204
??? info "Options"
176205
```text
177206

@@ -190,6 +219,9 @@ Export access conditions to a JSON file.
190219
$ cmemc admin acl export [OPTIONS] [ACCESS_CONDITION_IDS]...
191220
```
192221

222+
223+
224+
193225
Access conditions can be exported based on IDs, filters, or all at once. The exported JSON can be imported back using the `acl import` command.
194226

195227
By default, uses template-based file naming with the current date and connection name. You can override this by specifying an explicit output file path with `--output-file`.
@@ -198,18 +230,24 @@ By default, uses template-based file naming with the current date and connection
198230
$ cmemc admin acl export --all
199231
```
200232

233+
201234
```shell-session title="Example"
202235
$ cmemc admin acl export --all --output-file acls.json
203236
```
204237

238+
205239
```shell-session title="Example"
206240
$ cmemc admin acl export --filter group local-users
207241
```
208242

243+
209244
```shell-session title="Example"
210245
$ cmemc admin acl export :my-acl-iri
211246
```
212247

248+
249+
250+
213251
??? info "Options"
214252
```text
215253

@@ -241,21 +279,28 @@ $ cmemc admin acl export :my-acl-iri
241279
Import access conditions from a JSON file.
242280

243281
```shell-session title="Usage"
244-
cmemc admin acl import [OPTIONS] INPUT_FILE
282+
$ cmemc admin acl import [OPTIONS] INPUT_FILE
245283
```
246284

285+
286+
287+
247288
This command imports access conditions from a JSON file that was created using the `acl export` command.
248289

249290
If `--replace` is specified, existing access conditions with matching IRIs will be deleted before importing. Otherwise, the import will skip if an access condition with the same IRI already exists.
250291

251292
```shell-session title="Example"
252-
cmemc admin acl import acls.json
293+
$ cmemc admin acl import acls.json
253294
```
254295

296+
255297
```shell-session title="Example"
256-
cmemc admin acl import --replace acls.json
298+
$ cmemc admin acl import --replace acls.json
257299
```
258300

301+
302+
303+
259304
??? info "Options"
260305
```text
261306

@@ -268,16 +313,22 @@ cmemc admin acl import --replace acls.json
268313
Review grants for a given account.
269314

270315
```shell-session title="Usage"
271-
cmemc admin acl review [OPTIONS] USER
316+
$ cmemc admin acl review [OPTIONS] USER
272317
```
273318

319+
320+
321+
274322
This command has two working modes: (1) You can review the access conditions of an actual account, (2) You can review the access conditions of an imaginary account with a set of freely added groups (what-if-scenario).
275323

276324
The output of the command is a list of grants the account has based on your input and all access conditions loaded in the store. In addition to that, some metadata of the account is shown.
277325

326+
327+
278328
??? info "Options"
279329
```text
280330

281331
--raw Outputs raw JSON.
282332
--group TEXT Add groups to the review request (what-if-scenario).
283333
```
334+

docs/automate/cmemc-command-line-interface/command-reference/admin/client/index.md

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,7 @@ tags:
77
- Security
88
- cmemc
99
---
10-
1110
# admin client Command Group
12-
1311
<!-- This file was generated - DO NOT CHANGE IT MANUALLY -->
1412

1513
List client accounts, get or generate client account secrets.
@@ -20,19 +18,26 @@ Client accounts are identified by a client ID which is unique in the scope of th
2018

2119
In case your Corporate Memory deployment does not use the default deployment layout, the following additional config variables can be used in your connection configuration: ``KEYCLOAK_BASE_URI`` defaults to `{`CMEM_BASE_URI`}/auth` and locates your Keycloak deployment; ``KEYCLOAK_REALM_ID`` defaults to `cmem` and identifies the used realm.
2220

21+
2322
## admin client list
2423

2524
List client accounts.
2625

2726
```shell-session title="Usage"
28-
cmemc admin client list [OPTIONS]
27+
$ cmemc admin client list [OPTIONS]
2928
```
3029

30+
31+
32+
3133
Outputs a list of client accounts, which can be used to get an overview as well as a reference for the other commands of the `admin client` command group.
3234

3335
!!! note
3436
The list command only outputs clients which have a client secret.
3537

38+
39+
40+
3641
??? info "Options"
3742
```text
3843

@@ -46,11 +51,16 @@ Outputs a list of client accounts, which can be used to get an overview as well
4651
Get or generate a new secret for a client account.
4752

4853
```shell-session title="Usage"
49-
cmemc admin client secret [OPTIONS] CLIENT_ID
54+
$ cmemc admin client secret [OPTIONS] CLIENT_ID
5055
```
5156

57+
58+
59+
5260
This command retrieves or generates a new secret for a client account from a realm.
5361

62+
63+
5464
??? info "Options"
5565
```text
5666

@@ -63,10 +73,15 @@ This command retrieves or generates a new secret for a client account from a rea
6373
Open clients in the browser.
6474

6575
```shell-session title="Usage"
66-
cmemc admin client open [CLIENT_IDS]...
76+
$ cmemc admin client open [CLIENT_IDS]...
6777
```
6878

79+
80+
81+
6982
With this command, you can open a client in the keycloak web interface in your browser.
7083

7184
The command accepts multiple client IDs which results in opening multiple browser tabs.
7285

86+
87+

docs/automate/cmemc-command-line-interface/command-reference/admin/index.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,33 +5,38 @@ icon: material/key-link
55
tags:
66
- cmemc
77
---
8-
98
# admin Command Group
10-
119
<!-- This file was generated - DO NOT CHANGE IT MANUALLY -->
1210

1311
Import bootstrap data, backup/restore workspace or get status.
1412

1513
This command group consists of commands for setting up and configuring eccenca Corporate Memory.
1614

15+
1716
## admin status
1817

1918
Output health and version information.
2019

2120
```shell-session title="Usage"
22-
cmemc admin status [OPTIONS]
21+
$ cmemc admin status [OPTIONS]
2322
```
2423

24+
25+
26+
2527
This command outputs version and health information of the selected deployment. If the version information cannot be retrieved, UNKNOWN is shown.
2628

2729
Additionally, this command informs you in one of these cases: (1) A warning, if the target version of your cmemc client is newer than the version of your backend. (2) A warning, if the ShapeCatalog has a different version than your Explore component. (3) An error, if your Corporate Memory license is expired (grace period). (4) A warning, if your Graph DB license will expire in less than a month.
2830

2931
To get status information of all configured deployments use this command in combination with parallel.
3032

3133
```shell-session title="Example"
32-
cmemc config list | parallel --ctag cmemc -c {} admin status
34+
$ cmemc config list | parallel --ctag cmemc -c {} admin status
3335
```
3436

37+
38+
39+
3540
??? info "Options"
3641
```text
3742

@@ -61,17 +66,23 @@ cmemc config list | parallel --ctag cmemc -c {} admin status
6166
Fetch and output an access token.
6267

6368
```shell-session title="Usage"
64-
cmemc admin token [OPTIONS]
69+
$ cmemc admin token [OPTIONS]
6570
```
6671

72+
73+
74+
6775
This command can be used to check for correct authentication as well as to use the token with wget / curl or similar standard tools:
6876

6977
```shell-session title="Example"
70-
curl -H "Authorization: Bearer $(cmemc -c my admin token)" $(cmemc -c my config get DP_API_ENDPOINT)/api/custom/slug
78+
$ curl -H "Authorization: Bearer $(cmemc -c my admin token)" $(cmemc -c my config get DP_API_ENDPOINT)/api/custom/slug
7179
```
7280

81+
7382
Please be aware that this command can reveal secrets which you might not want to be present in log files or on the screen.
7483

84+
85+
7586
??? info "Options"
7687
```text
7788

@@ -83,3 +94,4 @@ Please be aware that this command can reveal secrets which you might not want to
8394
--ttl Output information about the lifetime of the access token. In
8495
combination with --raw, it outputs the TTL in seconds.
8596
```
97+

0 commit comments

Comments
 (0)