This page last changed on Feb 09, 2010 by edawson.

This page contains instructions on user profile settings.

On this page:

Users can change their own account settings such as passwords, watches, email and display settings. These include the user avatar and profile image.

To view your user profile, log into Crucible, and click the User Menu (labelled with your username) at the top of the screen, then select 'Settings'.

Screenshot: User Menu Settings

Click 'Save'
Always click the 'Save' button after making any changes.

You can change Crucible settings such as password, notifications and display settings.

To change these settings, log into Crucible and click the User Menu (labelled with your username) at the top of the screen, then select 'Settings'.

Display Settings Tab

The options in this tab allow you to amend the display settings.

Length of tag list Default is 'Medium'. The option to show the list of tags for a file. This can be changed to show none ('Hide') or all ('Long').
Show hidden directories Default is 'No'. Do not show the hidden directories within any folder lists.
Show empty directories Default is 'Yes'. The option to see any empty directories within any folder lists.
File History View Mode Default is 'Logical'.
In Subversion repositories, Crucible is able to show all operations on a single logical file spread across a number of physical paths - i.e. operations in different branches. When this is set to 'Logical', Crucible will show all the operations across all branches. In 'Physical' mode, only the operations related to the physical path whose history is being viewed are shown.
Timezone Default is the time zone of the Crucible server.

Changelog

Changesets per page The default is 30 per page. You can also choose 5; 10; 50; or 100.
Maximum files shown in a changeset Default is 5. You can also choose 10; 20; or 'Show All'.
Always expand changesets in streams Default is 'Yes'. If you choose 'No', then changesets in streams will be contracted.
Show my activity on dashboard Default is 'Yes'. If you choose 'No', then your activity will not appear on the dashboard.

Diff View

Diff mode Default is 'Unified'. Can be changed to 'Side-by-side' to change the way diffs are viewed.
Line wrapping Default is 'None' i.e. long lines will never word-wrap. 'Soft' is when long lines will word-wrap.
Highlighting Colours
The default colour scheme uses bright colours for highlighting diffs in the code. If you prefer more muted colours, select 'Classic (muted)'.
Context lines Default is '3'. You can also choose 'No Context'; 20; 100; or 'Full Context'.

Source View

Default annotation mode Default is 'Age'. You can also select 'Author' or 'None'.
Tab width Default is '8'. Can be changed to any value between one and ten.

IDE Connector

Enable IDE icons Description.
Port Number Description.

Profile and Email Tab

The settings in this tab allow you to change your email address and your display name.

Display Name Name displayed for the user currently logged in.
Email Address The address all email notifications will be sent to.
Email Format Default is text. Can be changed to be sent as HTML.
Send Watch Emails
Default is 'Immediately'. Can be changed to 'Daily' to receive a digest.

Change Password Tab

Option to be able to change your password if required.

The passwords are case sensitive.

Author Mapping Tab

The 'Author mapping' tab allows you to make an association between you (as a logged-in user in Crucible) and an author in each repository.

This is only necessary if the name of the user within Crucible is different to the name within the repository. Crucible will by default check to see whether the usernames match.

Watches Tab

Add a 'watch' on the Browse, File History or Changelog page
By adding a 'watch', you can ask to receive emails about changes made to the repository. To add a watch, click on the icon at the top right of any Browse, File History or Changelog page.

The 'Watches' tab in your Profile allows you to change the frequency at which the 'watch' emails are sent.

  • 'Immediately' - the email is sent every time a change is made.
  • 'Daily' - you will receive a daily email detailing these changes.

The default is 'Immediately'.

The option to add a watch may only be available if the administrator has enabled watches for the repository.

Reviews Tab

If the SMTP server is set up, then you will receive emails when different actions occur within Crucible.

You can change the options described below, to specify the stages at which emails will be sent.

Reviews Page View

Reviews page view Default is 'One file visible'. Can also be set to 'All files visible'.

Auto-mark files as 'read'

Auto-mark files as read Default is 'Yes'. Can also be set to 'No'.

Review Notifications Events

The following options can be set to 'Immediate', 'Batch', or 'No':

State change Default is 'Immediate'. A Crucible review moves through different states e.g: 'Draft', 'Under Review'. An email is sent when the state changes.
Comment added Default is 'Immediate'. An email is sent when a comment is added to a review.
Participant finished Default is 'Immediate'. An email is sent (to the Moderator only) when any reviewer has completed their review.
General message Default is 'Immediate'. An email is sent when a reviewer is added or removed from a review, after it has gone into the 'Under Review' state.
File revision added Default is 'Immediate'.

The following options can be set to 'Yes' or 'No':

Uncomplete review if defect is raised Default is 'Yes'. This allows reviews to be resurrected automatically to deal with new code or defects. Can also be set to 'No'.
Uncomplete review if revision is added Default is 'Yes'. This allows reviews to be resurrected automatically to deal with new code or defects. Can also be set to 'No'.
My actions Default is 'No'. If set to 'Yes', an email is sent every time you perform an action on a review.

Customising Your User Avatar

If your administrator has enabled an external avatar server (e.g. Gravatar ), you can upload an avatar image of your choice. Note that your login name to the external server must be the email address that is specified in your user profile.


Document generated by Confluence on Feb 23, 2010 02:04