Get the value of the ScreenName parameter. Checked to ensure that it only returns none, solicit, or require.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

user_screen_name_conf

Approve a user

Switches:

-user_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_user__registered_user_p, acs_user__ban_approve

Ban a user

Switches:

-user_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_user__registered_user_p, acs_user__ban_approve

Change the membership state of a user.

Switches:

-user_id (required)

-state (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authenticate

Sets (or resets) the portraif for current user to the one specified.

Switches:

-user_id (required)

user_id of user whose portrait we want to set.

-description (optional)

A caption for the portrait.

-filename (optional)

Original filename of the portrait. Used to guess the mimetype if an explicit one is not specified.

-mime_type (optional)

mimetype of the portrait. If missing, filename will be used to guess one.

-file (required)

Actual file containing the portrait

Returns:

item_id of the new content item

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_admin_merge_MergeUserInfo, auth_authenticate, demote_promote_a_user

Delete a user

Switches:

-user_id (required)

-permanent (optional, boolean)

If provided the user will be deleted permanently from the database. Otherwise the user state will merely be set to "deleted".

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authenticate, auth_create_user, auth_password_change, auth_password_reset, acs_subsite_expose_bug_1144, acs_subsite_test_email_confirmation

Demotes an ACS user to a person/party. This will fail if other tables have content referencing the users table. It is probably best for tables created in other packages to reference persons, parties, or acs_objects instead. This proc could be extended with an option to find all referenced tables and remove rows referencing this user.

Switches:

-user_id (optional)

the user_id in the acs system that should be demoted.

-delete_portrait (optional, boolean)

Delete the portrait of the user

Error:

An error is thrown if user_id is not in the users table.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Erases portrait of a user

Switches:

-user_id (required)

user_id of user whose portrait we want to delete

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authenticate, demote_promote_a_user

Flush all caches for specified user. This makes sense when we really want all user information to be flushed. Finer-grained procs exist and should be used when is clear what we want to delete.

Switches:

-user_id (required)

Author:

Peter Marklund

See Also:

• acs_user::flush_user_info
• acs_user::flush_portrait
• person::flush_cache

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_confirm_email, demote_promote_a_user

Flush only info coming from acs_user::get_user_info proc. This includes also lookup by username, because username and authority_id might also have changed.

Switches:

-user_id (required)

See Also:

• acs_user::get_user_info

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Get all information about a user, together with related person, party and object information. In case only user-specific information was needed, probably a better alternative could be acs_user::get_person_info.

The attributes returned are all those retrieved by person::get and acs_user::get_person_info.

Switches:

-user_id (optional)

User id to retrieve. Defaults to currently connected user.

-authority_id (optional)

if user_id was not specified, but a username was given, this proc will try to retrieve a user_id from username and authority. If authority_id is left blank, will default to the local authority.

-username (optional)

if specified and no user_id was give, will be used to retrieve user_id from the authority. If no user_id and no username were specified, proc will default to currently connected user.

-element (optional)

If specified, only this element in the dict will be returned. If an array was specified, This function will contain only this element.

-array (optional)

The name of an array into which you want the information put. This parameter is not mandatory, and the actual suggested way to retrieve information from this proc is to just set a variable from the return value and use it as a dict.

-include_bio (optional, boolean)

Options:

-include_bio

Whether to include the bio in the user information. This flag is deprecated and bio will be now always returned.

Returns:

dict or a single string value if the -element parameter was specified.

Author:

Lars Pind <lars@collaboraid.biz>

See Also:

• acs_user::get_person_info
• person::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_create_user, auth_password_reset, auth_authentication_implementations, sync_actions, sync_snapshot, sync_batch_ims_test, ad_proc_change_state_member

Returns user_id from authority and username. Returns the empty string if no user found.

Switches:

-authority_id (optional)

The authority. Defaults to local authority.

-username (required)

The username of the user you're trying to find.

Returns:

user_id of the user, or the empty string if no user found.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authenticate, auth_create_user, auth_password_reset

Get a particular element from the basic information about a user returned by acs_user::get. Throws an error if the element does not exist. It is recommended to use use acs_user::get instead. This function will be probably deprecated after the release of 5.10.

Switches:

-user_id (optional)

-authority_id (optional)

-username (optional)

-element (required)

Options:

-user_id

The user_id of the user to get the bio for. Leave blank for current user.

-element

Which element you want to retrieve.

Returns:

The element asked for.

See Also:

• acs_user::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_confirm_email

Return the image_id of the portrait of a user, if it does not exist, return 0

Switches:

-user_id (required)

user_id of the user for whom we need the portrait

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_admin_merge_MergeUserInfo, auth_authenticate

Returns the user_id from a screen_name, or empty string if no user found. Searches all users, including banned, deleted, unapproved, etc.

Switches:

-screen_name (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Extracts user information. Differently from acs_user::get this proc won't return generic party information.

Switches:

-user_id (required)

-element (optional)

if specified, only value with this key in the dict will be returned.

Returns:

dict or a single string value if the -element parameter was specified.

See Also:

• acs_user::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authenticate, auth_email_on_password_change, sync_actions, sync_batch_ims_test, acs_subsite_test_email_confirmation, demote_promote_a_user

Promotes a person/party to an ACS user.

Switches:

-person_id (optional)

the person_id in the acs system that should be promoted to a user.

-authority_id (optional)

the authority that will be used for the user.

-username (optional)

the username to be used for this user. Defaults to the person's email

-password (optional)

the password to be used for this user. Defaults to a randomly generated password.

-locale (optional)

locale to be used in user preferences. Defaults to the site-wide locale is taken.

Returns:

The user_id of the person promoted to user

Error:

An error is thrown if the username is already in use, or the person_id has no email address, or if person_id is not in the persons table.

See Also:

• acs_user::get_by_username

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Return 1 if the specified user (defaults to logged-in user) is a registered user and 0 otherwise. A registered user is a user who is in the view registered_users and this is primarily true for any user who is approved and has a verified e-mail.

Switches:

-user_id (optional)

The id of the user to check.

Author:

Malte Sussdorff <malte.sussdorff@cognovis.de>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth__delete_local_account, acs_user__registered_user_p, acs_user__ban_approve

Reject a user

Switches:

-user_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Return 1 if the specified user (defaults to logged-in user) is site-wide administrator and 0 otherwise.

Switches:

-user_id (optional)

The id of the user to check for admin privilege.

Author:

Peter Marklund

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Unapprove a user

Switches:

-user_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Update information about a user. Feel free to expand this with more switches later as needed, as long as they're optional.

Switches:

-user_id (required)

The ID of the user to edit

-authority_id (optional)

-username (optional)

-screen_name (optional)

-password_question (optional)

-password_answer (optional)

-email_verified_p (optional)

Options:

-authority_id

Authority

-username

Username

-screen_name

The new screen_name for the user

-password_question

The new password_question for the user

-password_answer

The new password_question for the user

-email_verified_p

Whether the email address has been verified

Author:

Lars Pind <lars@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authentication_implementations, demote_promote_a_user

Get a list of approved members of the given party.

Switches:

-party_id (required)

The id of the party to get members for

-object_type (optional)

Restrict to only members of this object type. For example, if you are only interested in users, set to "user".

Author:

Peter Marklund

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Return the parties email. This function will be probably deprecated in the future: please use the new generic party API.

Switches:

-party_id (required)

Returns:

the parties email.

See Also:

• party::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

community_cc_procs, person_procs_test

Flush the party cache

Switches:

-party_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns party information. Will also retrieve whether this party is also a person, a group, a user or a registered user and in this case also extra information belonging in referenced table will be extracted.

Switches:

-party_id (optional)

id of the party

-email (optional)

if specified and no party_id is given, party lookup will happen by email.

-element (optional)

if specified, only this attribute will be returned from the whole dict.

Returns:

dict containing party information, or an empty dict if no party was found. A string if 'element' was specified.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_subsite_test_email_confirmation

Return the party_id of the party with the given email. Uses a lowercase comparison as we don't allow for parties to have emails that only differ in case. Returns empty string if no party found.

Switches:

-email (required)

Returns:

party_id

Partial Call Graph (max 5 caller/called nodes):

Testcases:

acs_mail_lite_inbound_procs_check, community_cc_procs, party_procs_test

Return the party_id of the party with the given email. Uses a lowercase comparison as we don't allow for parties to have emails that only differ in case. Returns empty string if no party found.

Switches:

-email (required)

Returns:

party_id

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Gets the party name of the provided party_id

Switches:

-party_id (optional)

The party_id to get the name from.

-email (optional)

The email of the party

Returns:

The party name

Authors:

Miguel Marin <miguelmarin@viaro.net>

Viaro Networks www.viaro.net

Malte Sussdorff <malte.sussdorff@cognovis.de>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Creates a party of this type by calling the .new function for the package associated with the given party_type. This function will fail if there is no package.

There are now several ways to create a party of a given type. You can use this Tcl API with or without a form from the form system, or you can directly use the PL/SQL API for the party type.

Examples:

    # OPTION 1: Create the party using the Tcl Procedure. Useful if the
    # only attribute you need to specify is the party name

    db_transaction {
        set party_id [party::new -email "joe@foo.com" $party_type]
    }


    # OPTION 2: Create the party using the Tcl API with a templating
    # form. Useful when there are multiple attributes to specify for the
    # party

    template::form create add_party
    template::element create add_party email -value "joe@foo.com"

    db_transaction {
        set party_id [party::new -form_id add_party $party_type ]
    }

    # OPTION 3: Create the party using the PL/SQL package automatically
    # created for it

    # creating the new party
    set party_id [db_exec_plsql add_party "
      begin
        :1 := ${party_type}.new (email => 'joe@foo.com');
      end;
    "]

    

Switches:

-form_id (optional)

The form id from templating form system (see example above)

-variable_prefix (optional)

-creation_user (optional)

-creation_ip (optional)

-party_id (optional)

-context_id (optional)

-email (optional)

The email of this party. Note that if email is specified explicitly, this value will be used even if there is a email attribute in the form specified by form_id.

Parameters:

party_type (required)

The type of party we are creating

Returns:

party_id of the newly created party

Author:

Oumi Mehrotra <oumi@arsdigita.com>

Created:

2001-02-08

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Switches:

-object_id (required)

object_id which is checked if it is a party

Returns:

true if object_id is a party

Author:

Malte Sussdorff

Created:

2007-01-26

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

creates multirow datasource containing party types starting with the $start_with party type. The datasource has columns that are identical to the relation_types_allowed_to_group_multirow, which is why the columns are broadly named "object_*" instead of "party_*". A common template can be used for generating select widgets etc. for both this datasource and the relation_types_allowed_to_groups_multirow datasource. All subtypes of $start_with are returned, but the "valid_p" column in the datasource indicates whether the type is a valid one for $group_id. Includes fields that are useful for presentation in a hierarchical select widget:

• object_type
• object_type_enc - encoded object type
• indent - an HTML indentation string
• pretty_name - pretty name of object type
• valid_p - 1 or 0 depending on whether the type is valid

Switches:

-datasource_name (optional, defaults to "object_types")

-start_with (optional, defaults to "party")

-rel_type (optional, defaults to "membership_rel")

- if unspecified, then membership_rel is used

Author:

Oumi Mehrotra <oumi@arsdigita.com>

Created:

2000-02-07

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Update information about a party.

Switches:

-party_id (required)

The ID of the party to edit

-email (optional)

The new email for the party

-url (optional)

The new URL for the party

Author:

Lars Pind <lars@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

auth_authentication_implementations, party_procs_test

delete a person

Switches:

-person_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Flush all caches for specified person. This makes sense when we really want all person information to be flushed. Finer-grained procs exist and should be used when is clear what we want to delete.

Switches:

-person_id (required)

See Also:

• person::flush_person_info
• party::flush_cache

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Flush only info coming from person::get_person_info proc.

Switches:

-person_id (required)

See Also:

• person::get_person_info

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Get person information together with inherited party and object one. If person-only information is what you need, probably a better choice would be person::get_person_info.

Switches:

-person_id (required)

-element (optional)

if specified, only value in dict with this key will be returned.

Returns:

a dict or a single string value if -element was specified.

See Also:

• person::get_person_info
• party::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test, process_objects_csv

Get the value of the user's bio(graphy) field.

Switches:

-person_id (optional)

-exists_var (optional)

Options:

-person_id

The person_id of the person to get the bio for. Leave blank for currently logged-in user.

-exists_var

The name of a variable in the caller's namespace, which will be set to 1 if the bio column is not null. Leave blank if you're not interested in this information.

Returns:

The bio of the user as a text string.

Author:

Lars Pind <lars@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Extracts person information. Differently from person::get this proc won't return generic party information.

Switches:

-person_id (required)

-element (optional)

if specified, only value in dict with this key will be returned.

Returns:

a dict or a single string value if -element was specified.

See Also:

• person::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

demote_promote_a_user

Extracts person information. Differently from person::get this proc won't return generic party information.

Switches:

-person_id (required)

See Also:

• person::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Return the name of a person.

Switches:

-person_id (optional)

-email (optional)

See Also:

• party::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Flush the person::name cache. Deprecated: please use suggested alternative.

Switches:

-person_id (required)

-email (optional)

See Also:

• person::flush_person_info

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

create a new person

Switches:

-first_names (required)

-last_name (required)

-email (optional)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Is this party a person?

Switches:

-party_id (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Update person information.

Switches:

-person_id (required)

-first_names (optional)

-last_name (optional)

-bio (optional)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

person_procs_test

Update the bio for a person. Deprecated: please use person::update as now supports optional parameters.

Switches:

-person_id (required)

The ID of the person to edit bio for

-bio (required)

The new bio for the person

Author:

Lars Pind <lars@collaboraid.biz>

See Also:

• person::update

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.