Skip to content

GroupUserHotelingGuestSettingsGetListRequest

Bases: OCIRequest

Get a list of users and their Hoteling Guest service status (active or not active). The response is either GroupUserHotelingGuestSettingsGetListResponse or ErrorResponse. By default, virtual users and non-virtual users that match the selected search criteria are included in the response when "includeVirtualUsers" is present; otherwise, if "includeVirtualUsers" is absent, then only non-virtual users are returned. The search can be performed using multiple criteria. If search criteria is specified, only the users matching all of the specified search criteria are included in the response. If no search criteria is specified, all results are returned.

Attributes:

service_provider_id (str):

group_id (str):

response_paging_control (ResponsePagingControl):

sort_by_user_last_name (Optional[SortByUserLastName]):

sort_by_user_first_name (Optional[SortByUserFirstName]):

sort_by_user_department (Optional[SortByUserDepartment]):

sort_by_dn (Optional[SortByDn]):

sort_by_extension (Optional[SortByExtension]):

sort_by_service_status (Optional[SortByServiceStatus]):

include_virtual_users (Optional[bool]):

search_criteria_user_last_name (Optional[List[SearchCriteriaUserLastName]]):

search_criteria_user_first_name (Optional[List[SearchCriteriaUserFirstName]]):

search_criteria_user_id (Optional[List[SearchCriteriaUserId]]):

search_criteria_dn (Optional[List[SearchCriteriaDn]]):

search_criteria_extension (Optional[List[SearchCriteriaExtension]]):

search_criteria_email_address (Optional[List[SearchCriteriaEmailAddress]]):

search_criteria_exact_user_department (Optional[SearchCriteriaExactUserDepartment]):

search_criteria_exact_user_in_trunk_group (Optional[SearchCriteriaExactUserInTrunkGroup]):
Source code in src/mercury_ocip/commands/commands.py
@dataclass(kw_only=True)
class GroupUserHotelingGuestSettingsGetListRequest(OCIRequest):
    """Get a list of users and their Hoteling Guest service status (active or not active).
        The response is either GroupUserHotelingGuestSettingsGetListResponse or ErrorResponse.
        By default, virtual users and non-virtual users that match the selected search criteria are included in the response when \"includeVirtualUsers\" is present; otherwise, if \"includeVirtualUsers\" is absent, then only non-virtual users are returned.
        The search can be performed using multiple criteria. If search criteria is specified, only the users matching all of the specified search criteria are included in the response. If no search criteria is specified, all results are returned.

    Attributes:

        service_provider_id (str):

        group_id (str):

        response_paging_control (ResponsePagingControl):

        sort_by_user_last_name (Optional[SortByUserLastName]):

        sort_by_user_first_name (Optional[SortByUserFirstName]):

        sort_by_user_department (Optional[SortByUserDepartment]):

        sort_by_dn (Optional[SortByDn]):

        sort_by_extension (Optional[SortByExtension]):

        sort_by_service_status (Optional[SortByServiceStatus]):

        include_virtual_users (Optional[bool]):

        search_criteria_user_last_name (Optional[List[SearchCriteriaUserLastName]]):

        search_criteria_user_first_name (Optional[List[SearchCriteriaUserFirstName]]):

        search_criteria_user_id (Optional[List[SearchCriteriaUserId]]):

        search_criteria_dn (Optional[List[SearchCriteriaDn]]):

        search_criteria_extension (Optional[List[SearchCriteriaExtension]]):

        search_criteria_email_address (Optional[List[SearchCriteriaEmailAddress]]):

        search_criteria_exact_user_department (Optional[SearchCriteriaExactUserDepartment]):

        search_criteria_exact_user_in_trunk_group (Optional[SearchCriteriaExactUserInTrunkGroup]):

    """

    service_provider_id: str = field(metadata={"alias": "serviceProviderId"})

    group_id: str = field(metadata={"alias": "groupId"})

    response_paging_control: ResponsePagingControl = field(
        metadata={"alias": "responsePagingControl"}
    )

    sort_by_user_last_name: Optional[SortByUserLastName] = field(
        default=None, metadata={"alias": "sortByUserLastName"}
    )

    sort_by_user_first_name: Optional[SortByUserFirstName] = field(
        default=None, metadata={"alias": "sortByUserFirstName"}
    )

    sort_by_user_department: Optional[SortByUserDepartment] = field(
        default=None, metadata={"alias": "sortByUserDepartment"}
    )

    sort_by_dn: Optional[SortByDn] = field(default=None, metadata={"alias": "sortByDn"})

    sort_by_extension: Optional[SortByExtension] = field(
        default=None, metadata={"alias": "sortByExtension"}
    )

    sort_by_service_status: Optional[SortByServiceStatus] = field(
        default=None, metadata={"alias": "sortByServiceStatus"}
    )

    include_virtual_users: Optional[bool] = field(
        default=None, metadata={"alias": "includeVirtualUsers"}
    )

    search_criteria_user_last_name: Optional[List[SearchCriteriaUserLastName]] = field(
        default=None, metadata={"alias": "searchCriteriaUserLastName"}
    )

    search_criteria_user_first_name: Optional[List[SearchCriteriaUserFirstName]] = (
        field(default=None, metadata={"alias": "searchCriteriaUserFirstName"})
    )

    search_criteria_user_id: Optional[List[SearchCriteriaUserId]] = field(
        default=None, metadata={"alias": "searchCriteriaUserId"}
    )

    search_criteria_dn: Optional[List[SearchCriteriaDn]] = field(
        default=None, metadata={"alias": "searchCriteriaDn"}
    )

    search_criteria_extension: Optional[List[SearchCriteriaExtension]] = field(
        default=None, metadata={"alias": "searchCriteriaExtension"}
    )

    search_criteria_email_address: Optional[List[SearchCriteriaEmailAddress]] = field(
        default=None, metadata={"alias": "searchCriteriaEmailAddress"}
    )

    search_criteria_exact_user_department: Optional[
        SearchCriteriaExactUserDepartment
    ] = field(default=None, metadata={"alias": "searchCriteriaExactUserDepartment"})

    search_criteria_exact_user_in_trunk_group: Optional[
        SearchCriteriaExactUserInTrunkGroup
    ] = field(default=None, metadata={"alias": "searchCriteriaExactUserInTrunkGroup"})

Responses

Bases: OCIDataResponse

Response to the GroupUserHotelingGuestSettingsGetListRequest. Contains a table with column headings: "User Id", "Last Name", "First Name", "Hiragana Last Name", and "Hiragana First Name", "Phone Number", "Extension", "Department", "In Trunk Group", "Email Address", "Is Active". "Is Active" is "true" or "false". "Phone Number" is presented in the E164 format.

Attributes:

user_hoteling_guest_table (OCITable):
Source code in src/mercury_ocip/commands/commands.py
@dataclass(kw_only=True)
class GroupUserHotelingGuestSettingsGetListResponse(OCIDataResponse):
    """Response to the GroupUserHotelingGuestSettingsGetListRequest.
        Contains a table with column headings: \"User Id\", \"Last Name\", \"First Name\",
        \"Hiragana Last Name\", and \"Hiragana First Name\", \"Phone Number\",
        \"Extension\", \"Department\", \"In Trunk Group\", \"Email Address\", \"Is Active\".
        \"Is Active\" is \"true\" or \"false\".
        \"Phone Number\" is presented in the E164 format.

    Attributes:

        user_hoteling_guest_table (OCITable):

    """

    user_hoteling_guest_table: OCITable = field(
        metadata={"alias": "userHotelingGuestTable"}
    )

Bases: OCIResponse

Source code in src/mercury_ocip/commands/base_command.py
class ErrorResponse(OCIResponse):
    errorCode: Optional[int] = None
    summary: str
    summaryEnglish: str
    detail: Optional[str] = None

Example Usage

from mercury_ocip.client import Client
from mercury_ocip.commands import GroupUserHotelingGuestSettingsGetListRequest

client = Client()

command = GroupUserHotelingGuestSettingsGetListRequest(
    service_provider_id=...,
    group_id=...,
    response_paging_control=...,
    sort_by_user_last_name=...,
    sort_by_user_first_name=...,
    sort_by_user_department=...,
    sort_by_dn=...,
    sort_by_extension=...,
    sort_by_service_status=...,
    include_virtual_users=...,
    search_criteria_user_last_name=...,
    search_criteria_user_first_name=...,
    search_criteria_user_id=...,
    search_criteria_dn=...,
    search_criteria_extension=...,
    search_criteria_email_address=...,
    search_criteria_exact_user_department=...,
    search_criteria_exact_user_in_trunk_group=...,
)

response = client.command(command)

print(response)

Example 2 with Raw Command

from mercury_ocip.client import Client

client = Client()

response = client.raw_command("GroupUserHotelingGuestSettingsGetListRequest",
    service_provider_id=...,
    group_id=...,
    response_paging_control=...,
    sort_by_user_last_name=...,
    sort_by_user_first_name=...,
    sort_by_user_department=...,
    sort_by_dn=...,
    sort_by_extension=...,
    sort_by_service_status=...,
    include_virtual_users=...,
    search_criteria_user_last_name=...,
    search_criteria_user_first_name=...,
    search_criteria_user_id=...,
    search_criteria_dn=...,
    search_criteria_extension=...,
    search_criteria_email_address=...,
    search_criteria_exact_user_department=...,
    search_criteria_exact_user_in_trunk_group=...,
)

print(response)