DigitalStepSearch

trendminer_interface.objects.DigitalStepSearch

Bases: SavedItemBase

Digital step search work organizer object

name class-attribute instance-attribute

name: str = name

description class-attribute instance-attribute

description: str = description

folder class-attribute instance-attribute

folder: Folder | None = folder

identifier property

identifier: str

UUID of the saved object

created_at property

created_at: Timestamp | None

Timestamp the object was created at

Can be None for items created before item creation date tracking was implemented in TrendMiner.

last_modified property

last_modified: Timestamp

Timestamp the object was last modified

last_used property

last_used: Timestamp

Timestamp the object was last used

last_modified_by property

last_modified_by: User

User that last modified the object

owner property

owner: User

User that owns the object

shared property

shared: bool

Whether the object is shared with other users

favorite property

favorite: bool

Whether the object is marked as a favorite by the owner

version property

version: int

Version number of the object, incremented on each modification

definition instance-attribute

definition: DigitalStepSearchDefinition

update

update() -> Self

Update the saved item in TrendMiner to match the current instance state

delete

delete() -> None

Permanently delete the saved item in TrendMiner

move

move(folder: Folder) -> None

Move the item to a folder

Parameters:

Name	Type	Description	Default
folder	Folder	The folder to move the item to	required

Notes

Moving an item to another user's folder will not transfer the ownership and may lead to unexpected behavior. Use the client.work.transfer method instead.

get_folder_path

get_folder_path(include_home=False) -> list[Folder]

Get the location in the work organizer

Starts from, but does not include, the user's home folder. Does not include the object itself.

Parameters:

Name	Type	Description	Default
include_home	bool	Whether to include the user's home folder as the first element of the returned list. If False (default), the list starts from the first folder after the home folder.	False

Returns:

Type	Description
list[Folder]	List of folders leading up to this item

get_permissions

get_permissions() -> list[
    tuple[User | UserGroup, WorkSharePermission]
]

Get the sharing settings of the object

Returns:

Name	Type	Description
sharing	list[tuple[User | UserGroup, WorkSharePermission]]	A list of tuples, each containing a user or user group that the object is shared with and the corresponding permission ("read", "write", or "manage").

add_permission

add_permission(
    subject: User | UserGroup,
    permission: WorkSharePermission,
) -> Self

Share the object with a user or user group

Parameters:

Name	Type	Description	Default
subject	User or UserGroup	The user or user group to share the object with	required
permission	str	The permission to share with. Can be "read", "write", or "manage"	required

Returns:

Name	Type	Description
self	SavedItemBase	The object itself, after being shared with the user or user group. Practically, only the shared property may have changed.

remove_permission

remove_permission(subject: User | UserGroup) -> Self

Remove sharing of the object with a user or user group

Parameters:

Name	Type	Description	Default
subject	User or UserGroup	The user or user group to remove sharing with	required

Returns:

Name	Type	Description
self	SavedItemBase	The object itself, after removing sharing with the user or user group. Practically, only the shared property may have changed.