Skip to content

UserConsolidatedAddRequest22

Bases: OCIRequest

The response is either SuccessResponse or ErrorResponse.

 In AS Data Mode:
   The group user limit will be increased by one if needed.

   The group will be added if it does not exist and if the command is executed by a Service
   Provider level administrator or above. If the group needs to be created, the
   groupProperties element must be set or the request will fail.
   The groupProperties element will be ignored if the group already exists.

   If the domain has not been assigned to the group, it will be added to group if the
   command is executed by a Service provider level administrator or above.
   If the domain has not been assigned to the service provider, it will be added to the
   service provider if the command is executed by a Provisioning level administrator or
   above. The command will fail otherwise.

   If the phoneNumber has not been assigned to the group and addPhoneNumberToGroup is set
   to true, it will be added to group if the command is executed by a service provider
   administrator or above and the number is already assigned to the service provider. The
   command will fail otherwise.

   The password is not required if external authentication is enabled.
   Alternate user ids can be added by a group level administrator or above.

   When sharedCallAppearanceAccessDeviceEndpoint element is included and the Shared Call
   Appearance is not included in the service/service pack of the request or in the
   "new user template", the request will fail.

   The userService/servicePack will be authorized to the group if it has not been
   authorized to the group if the command is executed by a Service Provider level
   administrator or above. The command will fail otherwise.
   The authorizedQuantity will be set to unlimited if not present.

   When thirdPartyVoiceMail elements are included and the Third Party Voice Mail Support
   service is not included in the service/service pack of the request or in the
   "new user template", the request will fail.

   When sipAuthenticationData element is included and the Authentication service is not
   included in the service/service pack of the request or in the "new user template",
   the request will fail.


 In XS data mode:
   only the System level administrator has the authorization level to execute the command.
   The group will be added if it does not exist. If the group needs to be created, the
   groupProperties element must be set or the request will fail.
   The groupProperties element will be ignored if the group already exists.

   If the phoneNumber has not been assigned to the group, it will be added to group and
   service provider if needed.

   When sharedCallAppearanceAccessDeviceEndpoint element is included and the Shared
   Call Appearance is not included in the service/service pack of the request, the request
   will fail.

 The following elements are ignored in XS data mode:
   addPhoneNumberToGroup
   nameDialingName
   alternateUserId
   passcode
   trunkAddressing
   thirdPartyVoiceMailServerSelection
   thirdPartyVoiceMailServerUserServer
   thirdPartyVoiceMailServerMailboxIdType
   thirdPartyVoiceMailMailboxURL
   sipAuthenticationData
   isPlace

Attributes:

service_provider_id (Optional[str]):

group_id (Optional[str]):

group_external_id (Optional[str]):

group_properties (Optional[ConsolidatedGroupProperties]):

user_id (str):

user_external_id (Optional[str]):

user_person_id (Optional[str]):

add_phone_number_to_group (Optional[bool]):

last_name (str):

first_name (str):

calling_line_id_last_name (str):

calling_line_id_first_name (str):

name_dialing_name (Optional[NameDialingName]):

hiragana_last_name (Optional[str]):

hiragana_first_name (Optional[str]):

phone_number (Optional[str]):

alternate_user_id (Optional[List[AlternateUserIdEntry]]):

extension (Optional[str]):

calling_line_id_phone_number (Optional[str]):

password (Optional[str]):

passcode (Optional[str]):

department (Optional[DepartmentKey]):

language (Optional[str]):

time_zone (Optional[str]):

alias (Optional[List[str]]):

access_device_endpoint (Optional[ConsolidatedAccessDeviceMultipleIdentityEndpointAndContactAdd22]):

trunk_addressing (Optional[TrunkAddressingMultipleContactAdd]):

shared_call_appearance_access_device_endpoint (Optional[List[ConsolidatedSharedCallAppearanceAccessDeviceMultipleIdentityEndpointAdd22]]):

title (Optional[str]):

pager_phone_number (Optional[str]):

mobile_phone_number (Optional[str]):

email_address (Optional[str]):

yahoo_id (Optional[str]):

address_location (Optional[str]):

address (Optional[StreetAddress]):

network_class_of_service (Optional[str]):

user_service (Optional[List[ConsolidatedUserServiceAssignment]]):

service_pack (Optional[List[ConsolidatedServicePackAssignment]]):

third_party_voice_mail_server_selection (Optional[str]):

third_party_voice_mail_server_user_server (Optional[Nillable[str]]):

third_party_voice_mail_server_mailbox_id_type (Optional[str]):

third_party_voice_mail_mailbox_url (Optional[Nillable[str]]):

sip_authentication_data (Optional[SIPAuthenticationUserNamePassword]):

is_place (Optional[bool]):
Source code in src/mercury_ocip_fast/commands/commands.py
105987
105988
105989
105990
105991
105992
105993
105994
105995
105996
105997
105998
105999
106000
106001
106002
106003
106004
106005
106006
106007
106008
106009
106010
106011
106012
106013
106014
106015
106016
106017
106018
106019
106020
106021
106022
106023
106024
106025
106026
106027
106028
106029
106030
106031
106032
106033
106034
106035
106036
106037
106038
106039
106040
106041
106042
106043
106044
106045
106046
106047
106048
106049
106050
106051
106052
106053
106054
106055
106056
106057
106058
106059
106060
106061
106062
106063
106064
106065
106066
106067
106068
106069
106070
106071
106072
106073
106074
106075
106076
106077
106078
106079
106080
106081
106082
106083
106084
106085
106086
106087
106088
106089
106090
106091
106092
106093
106094
106095
106096
106097
106098
106099
106100
106101
106102
106103
106104
106105
106106
106107
106108
106109
106110
106111
106112
106113
106114
106115
106116
106117
106118
106119
106120
106121
106122
106123
106124
106125
106126
106127
106128
106129
106130
106131
106132
106133
106134
106135
106136
106137
106138
106139
106140
106141
106142
106143
106144
106145
106146
106147
106148
106149
106150
106151
106152
106153
106154
106155
106156
106157
106158
106159
106160
106161
106162
106163
106164
106165
106166
106167
106168
106169
106170
106171
106172
106173
106174
106175
106176
106177
106178
106179
106180
106181
106182
106183
106184
106185
106186
106187
106188
106189
106190
106191
106192
106193
106194
106195
106196
106197
106198
106199
106200
106201
106202
106203
106204
106205
106206
106207
106208
106209
106210
106211
106212
106213
106214
106215
106216
106217
106218
106219
106220
106221
106222
106223
106224
106225
106226
106227
106228
106229
106230
106231
106232
106233
106234
106235
106236
106237
106238
106239
106240
106241
106242
106243
106244
106245
106246
106247
106248
106249
106250
106251
106252
106253
106254
106255
106256
106257
106258
106259
106260
106261
106262
106263
106264
106265
106266
106267
106268
106269
106270
106271
106272
106273
106274
106275
106276
106277
106278
106279
106280
106281
106282
106283
106284
106285
106286
106287
106288
106289
106290
106291
106292
106293
106294
106295
106296
106297
106298
106299
106300
106301
106302
106303
106304
106305
@dataclass(kw_only=True)
class UserConsolidatedAddRequest22(OCIRequest):
    """The response is either SuccessResponse or ErrorResponse.

         In AS Data Mode:
           The group user limit will be increased by one if needed.

           The group will be added if it does not exist and if the command is executed by a Service
           Provider level administrator or above. If the group needs to be created, the
           groupProperties element must be set or the request will fail.
           The groupProperties element will be ignored if the group already exists.

           If the domain has not been assigned to the group, it will be added to group if the
           command is executed by a Service provider level administrator or above.
           If the domain has not been assigned to the service provider, it will be added to the
           service provider if the command is executed by a Provisioning level administrator or
           above. The command will fail otherwise.

           If the phoneNumber has not been assigned to the group and addPhoneNumberToGroup is set
           to true, it will be added to group if the command is executed by a service provider
           administrator or above and the number is already assigned to the service provider. The
           command will fail otherwise.

           The password is not required if external authentication is enabled.
           Alternate user ids can be added by a group level administrator or above.

           When sharedCallAppearanceAccessDeviceEndpoint element is included and the Shared Call
           Appearance is not included in the service/service pack of the request or in the
           \"new user template\", the request will fail.

           The userService/servicePack will be authorized to the group if it has not been
           authorized to the group if the command is executed by a Service Provider level
           administrator or above. The command will fail otherwise.
           The authorizedQuantity will be set to unlimited if not present.

           When thirdPartyVoiceMail elements are included and the Third Party Voice Mail Support
           service is not included in the service/service pack of the request or in the
           \"new user template\", the request will fail.

           When sipAuthenticationData element is included and the Authentication service is not
           included in the service/service pack of the request or in the \"new user template\",
           the request will fail.


         In XS data mode:
           only the System level administrator has the authorization level to execute the command.
           The group will be added if it does not exist. If the group needs to be created, the
           groupProperties element must be set or the request will fail.
           The groupProperties element will be ignored if the group already exists.

           If the phoneNumber has not been assigned to the group, it will be added to group and
           service provider if needed.

           When sharedCallAppearanceAccessDeviceEndpoint element is included and the Shared
           Call Appearance is not included in the service/service pack of the request, the request
           will fail.

         The following elements are ignored in XS data mode:
           addPhoneNumberToGroup
           nameDialingName
           alternateUserId
           passcode
           trunkAddressing
           thirdPartyVoiceMailServerSelection
           thirdPartyVoiceMailServerUserServer
           thirdPartyVoiceMailServerMailboxIdType
           thirdPartyVoiceMailMailboxURL
           sipAuthenticationData
           isPlace

    Attributes:

        service_provider_id (Optional[str]):

        group_id (Optional[str]):

        group_external_id (Optional[str]):

        group_properties (Optional[ConsolidatedGroupProperties]):

        user_id (str):

        user_external_id (Optional[str]):

        user_person_id (Optional[str]):

        add_phone_number_to_group (Optional[bool]):

        last_name (str):

        first_name (str):

        calling_line_id_last_name (str):

        calling_line_id_first_name (str):

        name_dialing_name (Optional[NameDialingName]):

        hiragana_last_name (Optional[str]):

        hiragana_first_name (Optional[str]):

        phone_number (Optional[str]):

        alternate_user_id (Optional[List[AlternateUserIdEntry]]):

        extension (Optional[str]):

        calling_line_id_phone_number (Optional[str]):

        password (Optional[str]):

        passcode (Optional[str]):

        department (Optional[DepartmentKey]):

        language (Optional[str]):

        time_zone (Optional[str]):

        alias (Optional[List[str]]):

        access_device_endpoint (Optional[ConsolidatedAccessDeviceMultipleIdentityEndpointAndContactAdd22]):

        trunk_addressing (Optional[TrunkAddressingMultipleContactAdd]):

        shared_call_appearance_access_device_endpoint (Optional[List[ConsolidatedSharedCallAppearanceAccessDeviceMultipleIdentityEndpointAdd22]]):

        title (Optional[str]):

        pager_phone_number (Optional[str]):

        mobile_phone_number (Optional[str]):

        email_address (Optional[str]):

        yahoo_id (Optional[str]):

        address_location (Optional[str]):

        address (Optional[StreetAddress]):

        network_class_of_service (Optional[str]):

        user_service (Optional[List[ConsolidatedUserServiceAssignment]]):

        service_pack (Optional[List[ConsolidatedServicePackAssignment]]):

        third_party_voice_mail_server_selection (Optional[str]):

        third_party_voice_mail_server_user_server (Optional[Nillable[str]]):

        third_party_voice_mail_server_mailbox_id_type (Optional[str]):

        third_party_voice_mail_mailbox_url (Optional[Nillable[str]]):

        sip_authentication_data (Optional[SIPAuthenticationUserNamePassword]):

        is_place (Optional[bool]):

    """

    service_provider_id: Optional[str] = field(
        default=None, metadata={"alias": "serviceProviderId"}
    )

    group_id: Optional[str] = field(default=None, metadata={"alias": "groupId"})

    group_external_id: Optional[str] = field(
        default=None, metadata={"alias": "groupExternalId"}
    )

    group_properties: Optional[ConsolidatedGroupProperties] = field(
        default=None, metadata={"alias": "groupProperties"}
    )

    user_id: str = field(metadata={"alias": "userId"})

    user_external_id: Optional[str] = field(
        default=None, metadata={"alias": "userExternalId"}
    )

    user_person_id: Optional[str] = field(
        default=None, metadata={"alias": "userPersonId"}
    )

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

    last_name: str = field(metadata={"alias": "lastName"})

    first_name: str = field(metadata={"alias": "firstName"})

    calling_line_id_last_name: str = field(metadata={"alias": "callingLineIdLastName"})

    calling_line_id_first_name: str = field(
        metadata={"alias": "callingLineIdFirstName"}
    )

    name_dialing_name: Optional[NameDialingName] = field(
        default=None, metadata={"alias": "nameDialingName"}
    )

    hiragana_last_name: Optional[str] = field(
        default=None, metadata={"alias": "hiraganaLastName"}
    )

    hiragana_first_name: Optional[str] = field(
        default=None, metadata={"alias": "hiraganaFirstName"}
    )

    phone_number: Optional[str] = field(default=None, metadata={"alias": "phoneNumber"})

    alternate_user_id: Optional[List[AlternateUserIdEntry]] = field(
        default=None, metadata={"alias": "alternateUserId"}
    )

    extension: Optional[str] = field(default=None, metadata={"alias": "extension"})

    calling_line_id_phone_number: Optional[str] = field(
        default=None, metadata={"alias": "callingLineIdPhoneNumber"}
    )

    password: Optional[str] = field(default=None, metadata={"alias": "password"})

    passcode: Optional[str] = field(default=None, metadata={"alias": "passcode"})

    department: Optional[DepartmentKey] = field(
        default=None, metadata={"alias": "department"}
    )

    language: Optional[str] = field(default=None, metadata={"alias": "language"})

    time_zone: Optional[str] = field(default=None, metadata={"alias": "timeZone"})

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

    access_device_endpoint: Optional[
        ConsolidatedAccessDeviceMultipleIdentityEndpointAndContactAdd22
    ] = field(default=None, metadata={"alias": "accessDeviceEndpoint"})

    trunk_addressing: Optional[TrunkAddressingMultipleContactAdd] = field(
        default=None, metadata={"alias": "trunkAddressing"}
    )

    shared_call_appearance_access_device_endpoint: Optional[
        List[ConsolidatedSharedCallAppearanceAccessDeviceMultipleIdentityEndpointAdd22]
    ] = field(
        default=None, metadata={"alias": "sharedCallAppearanceAccessDeviceEndpoint"}
    )

    title: Optional[str] = field(default=None, metadata={"alias": "title"})

    pager_phone_number: Optional[str] = field(
        default=None, metadata={"alias": "pagerPhoneNumber"}
    )

    mobile_phone_number: Optional[str] = field(
        default=None, metadata={"alias": "mobilePhoneNumber"}
    )

    email_address: Optional[str] = field(
        default=None, metadata={"alias": "emailAddress"}
    )

    yahoo_id: Optional[str] = field(default=None, metadata={"alias": "yahooId"})

    address_location: Optional[str] = field(
        default=None, metadata={"alias": "addressLocation"}
    )

    address: Optional[StreetAddress] = field(
        default=None, metadata={"alias": "address"}
    )

    network_class_of_service: Optional[str] = field(
        default=None, metadata={"alias": "networkClassOfService"}
    )

    user_service: Optional[List[ConsolidatedUserServiceAssignment]] = field(
        default=None, metadata={"alias": "userService"}
    )

    service_pack: Optional[List[ConsolidatedServicePackAssignment]] = field(
        default=None, metadata={"alias": "servicePack"}
    )

    third_party_voice_mail_server_selection: Optional[str] = field(
        default=None, metadata={"alias": "thirdPartyVoiceMailServerSelection"}
    )

    third_party_voice_mail_server_user_server: Optional[Nillable[str]] = field(
        default=None, metadata={"alias": "thirdPartyVoiceMailServerUserServer"}
    )

    third_party_voice_mail_server_mailbox_id_type: Optional[str] = field(
        default=None, metadata={"alias": "thirdPartyVoiceMailServerMailboxIdType"}
    )

    third_party_voice_mail_mailbox_url: Optional[Nillable[str]] = field(
        default=None, metadata={"alias": "thirdPartyVoiceMailMailboxURL"}
    )

    sip_authentication_data: Optional[SIPAuthenticationUserNamePassword] = field(
        default=None, metadata={"alias": "sipAuthenticationData"}
    )

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

    def __post_init__(self):
        nillable_fields = [
            "third_party_voice_mail_server_user_server",
            "third_party_voice_mail_mailbox_url",
        ]
        for field_name in nillable_fields:
            value = getattr(self, field_name)
            if value == "" or value == "None":
                object.__setattr__(self, field_name, OCINil)

Responses

Bases: OCIResponse

Source code in src/mercury_ocip_fast/commands/base_command.py
class SuccessResponse(OCIResponse):
    pass

Bases: OCIResponse

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

Example Usage

from mercury_ocip_fast.client import Client
from mercury_ocip_fast.commands import UserConsolidatedAddRequest22

client = Client()

command = UserConsolidatedAddRequest22(
    service_provider_id=...,
    group_id=...,
    group_external_id=...,
    group_properties=...,
    user_id=...,
    user_external_id=...,
    user_person_id=...,
    add_phone_number_to_group=...,
    last_name=...,
    first_name=...,
    calling_line_id_last_name=...,
    calling_line_id_first_name=...,
    name_dialing_name=...,
    hiragana_last_name=...,
    hiragana_first_name=...,
    phone_number=...,
    alternate_user_id=...,
    extension=...,
    calling_line_id_phone_number=...,
    password=...,
    passcode=...,
    department=...,
    language=...,
    time_zone=...,
    alias=...,
    access_device_endpoint=...,
    trunk_addressing=...,
    shared_call_appearance_access_device_endpoint=...,
    title=...,
    pager_phone_number=...,
    mobile_phone_number=...,
    email_address=...,
    yahoo_id=...,
    address_location=...,
    address=...,
    network_class_of_service=...,
    user_service=...,
    service_pack=...,
    third_party_voice_mail_server_selection=...,
    third_party_voice_mail_server_user_server=...,
    third_party_voice_mail_server_mailbox_id_type=...,
    third_party_voice_mail_mailbox_url=...,
    sip_authentication_data=...,
    is_place=...,
)

response = client.command(command)

print(response)

Example 2 with Raw Command

from mercury_ocip_fast.client import Client

client = Client()

response = client.raw_command("UserConsolidatedAddRequest22",
    service_provider_id=...,
    group_id=...,
    group_external_id=...,
    group_properties=...,
    user_id=...,
    user_external_id=...,
    user_person_id=...,
    add_phone_number_to_group=...,
    last_name=...,
    first_name=...,
    calling_line_id_last_name=...,
    calling_line_id_first_name=...,
    name_dialing_name=...,
    hiragana_last_name=...,
    hiragana_first_name=...,
    phone_number=...,
    alternate_user_id=...,
    extension=...,
    calling_line_id_phone_number=...,
    password=...,
    passcode=...,
    department=...,
    language=...,
    time_zone=...,
    alias=...,
    access_device_endpoint=...,
    trunk_addressing=...,
    shared_call_appearance_access_device_endpoint=...,
    title=...,
    pager_phone_number=...,
    mobile_phone_number=...,
    email_address=...,
    yahoo_id=...,
    address_location=...,
    address=...,
    network_class_of_service=...,
    user_service=...,
    service_pack=...,
    third_party_voice_mail_server_selection=...,
    third_party_voice_mail_server_user_server=...,
    third_party_voice_mail_server_mailbox_id_type=...,
    third_party_voice_mail_mailbox_url=...,
    sip_authentication_data=...,
    is_place=...,
)

print(response)