Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: change default permissions to new standard (RDU-48) #1180

Merged
merged 16 commits into from
Oct 30, 2024
12 changes: 6 additions & 6 deletions docs/excel2xml-module.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,8 +86,8 @@ Then, the root element is created, which represents the `<knora>` tag of the XML
As first children of `<knora>`, some standard permissions are added. At the end, please carefully check the permissions
of the finished XML file to ensure that they meet your requirements, and adapt them if necessary.

The standard permission of a resource is `res-default`, and of a property `prop-default`. If you don't specify it
otherwise, all resources and properties get these permissions.
The standard permission is `open`.
jnussbaum marked this conversation as resolved.
Show resolved Hide resolved
If you don't specify it otherwise, all resources and properties get this permission.

With `excel2xml`, it is not possible to create resources/properties that don't have permissions, because they would be
invisible for all users except project admins and system admins. [Read more about permissions
Expand Down Expand Up @@ -224,7 +224,7 @@ Here's how the docstrings assist you:
#### Fine-Tuning With the `PropertyElement`

There are two possibilities how to create a property: The value can be passed as it is, or as a `PropertyElement`. If it
is passed as it is, the `permissions` are assumed to be `prop-default`, texts are assumed to be encoded as `utf8`, and
is passed as it is, the `permissions` are assumed to be `open`, texts are assumed to be encoded as `utf8`, and
the value won't have a comment:

```python
Expand All @@ -233,7 +233,7 @@ make_text_prop(":testproperty", "first text")

```xml
<text-prop name=":testproperty">
<text encoding="utf8" permissions="prop-default">first text</text>
<text encoding="utf8" permissions="open">first text</text>
</text-prop>
```

Expand All @@ -244,7 +244,7 @@ make_text_prop(
":testproperty",
PropertyElement(
value="first text",
permissions="prop-restricted",
permissions="restricted",
encoding="xml",
comment="some comment"
)
Expand All @@ -253,7 +253,7 @@ make_text_prop(

```xml
<text-prop name=":testproperty">
<text encoding="xml" permissions="prop-restricted" comment="some comment">first text</text>
<text encoding="xml" permissions="restricted" comment="some comment">first text</text>
</text-prop>
```

Expand Down
2 changes: 1 addition & 1 deletion docs/file-formats/excel2xml.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@ Some notes:
`LinkObj`, and `Region`.
- The columns `ark`, `iri`, and `creation_date` are only used for DaSCH internal data migration.
- If `file` is provided, but no `file permissions`, an attempt will be started to deduce them from the resource
permissions (`res-default` → `prop-default` and `res-restricted` → `prop-restricted`). If this attempt is not
permissions. If this attempt is not
successful, a `BaseError` will be raised.
Loading
Loading