Managing Campaigns

A campaign is analogous to a funded research program composed of multiple projects, investigators, and organizations working collaboratively to share, analyze, and disseminate scientific results. Members of campaigns can share their project data files and assign read-only or read-write access permissions for collaborators to view or interact with those shared files.

Create a New Campaign

Follow these steps to create a new campaign composed of multiple projects shared among its members:

  1. Navigate to the campaign field view by clicking the feed icon feed_icon on the left hand side of the page.
  2. Select Campaigns.
  3. In the campaigns view, select the green icon create_new_icon to make a new campaign.
  4. Type in a name for the campaign.

Refer to Campaign Settings for more on how to set-up sharing and collaboration settings for the campaign.

Note

For more information on how to organize and manage campaigns, please see Axiom Data Science’s Best Practices for Data Management.

Campaign About View

Each campaign has an About tab with built-in fields for the campaign profile, membership, usage statistics, and relevant links. The About page is visible to all campaign members regardless of their permissions level. However, only campaign owners can edit it.

To edit the About page, follow these steps:

  1. Select About in the campaign view, just below the campaign name.
  2. Click the edit icon pencil_icon to the right of the About page.
  3. Click in the About text box to add or edit the overview narrative.
  4. Click Add a link and insert the name and URL. Click Save when done editing the links.
  5. Click Stop editing in the upper right hand corner to save the changes you have made.

Campaign Metadata

Campaign-level metadata consists of metadata pertaining to a collection of project datasets as a whole, in contrast to item-specific folder- or file-level metadata within a project. Campaign metadata contains a broad-level overview for a research program, and it provides a mechanism to associate individual project resources to an interdisciplinary effort. The campaign metadata content is largely descriptive of the campaign and contains references to the associated research projects.

To edit your campaign metadata, follow these steps:

  1. From the campaign view, click on the white down arrow down_arrow_icon next to Settings.
  2. Select View campaign metadata from the dropdown list.
  3. The metadata editor will launch, displaying your campaign metadata.

Note

Refer to the metadata editor documentation for more information.

Campaign Settings

The campaign settings can be managed by selecting Settings in the campaign view, found beneath the campaign name. You are only able to make changes to campaign settings for which you are the owner. Campaign members cannot make changes to the campaign settings.

Rename a Campaign

To rename a campaign, follow these steps:

  1. Select Settings in the campaign view, just below the campaign name.
  2. Click inside the Name text box.
  3. Type in your edits and click Save.

Campaign Visibility

The campaign can be made visible to every user of the RW (Public) or restricted to only certain members (Private). Public campaigns are read-access; they can be seen and have files downloaded by all RW members. As read-access, these campaigns are not editable by RW users unless they are owners of the campaign. Private campaigns can be seen and have files downloaded only by members assigned to that campaign.

To change the visibility settings for your campaign, follow these steps:

  1. Select Settings in the campaigns view, found just beneath the campaign name.
  2. In the Visibility options box, toggle the setting to Private (campaign is only visible to members) or Public (campaign is visible to everyone).

Tip

When you create a new campaign, the default visibility setting is public. You will need to change the visibility settings to make it private.

Campaign Members

You can add members to your campaign and assign their access permission. Using access permissions, you can grant the campaign collaborators read-only or read-write access. There can be multiples of each member type assigned to a campaign (e.g., a campaign can have more than one owner and members):

  • owner_icon Owners can grant access permissions for the campaign and control all of the campaign settings.
  • member_icon Members can view all project contents within a campaign, including files and metadata, but don’t have control of the campaign permissions.
  • view_icon Viewers can view the project files and metadata, but cannot contribute to the project.

To set the campaign’s member permissions:

  1. Select Settings in the campaign view beneath the project name.
  2. In the Members option box, click Find a Person.
  3. Type the name of the RW user.
  4. Find the person in the user list that appears.
  5. Click the appropriate icon to assign permissions to that person, either as an owner or member.
  6. Hit the green Close button.

Note

The user will then receive an invite notification (the envelop icon envelope_icon in the top right). They will be able to view the campaign immediately.

Editing Member Permissions

To edit the campaign’s member permissions, follow these steps:

  1. Select Settings in the campaign view beneath the project name.
  2. In the Members option box, find the name of RW user for which permission will be changed.
  3. Click the appropriate icon to change permissions for that user. To entirely remove membership access, click the Remove icon.

Tip

You are not allowed to remove owner permissions for yourself. All campaigns must have at least one person who can edit the project.

Manage Member Roles

Each member of a campaign is assigned a role that indicates how they can interact with the campaign: owner, contributor, or viewer. Member roles can be viewed or reassigned by campaign owners under as described above.

Member can: Owner Contributor Viewer
See the campaign in their project list
See the campaigns’s contents
Add or remove files  
Edit the campaign’s metadata  
Add or remove campaign members    
Assign or change member roles    
Associate a campaign with a project to campaigns    
Delete the campaign and all its contents    

Note

When viewing a campaign, you can see your member status in the top right corner of the window, just under your name.

Inviting a New Workspace User to a Campaign

New users can be added to the Workspace from any project, campaign, or organization. The instructions below describe how to invite a new member to a campaign who is not already a Workspace user. You can invite a new user from any campaign of which you are an owner.

To add a new member to the Workspace, follow these steps and review the video below:

  1. Click on the feed icon feed_icon on the left-hand side of the window and select Campaigns.
  2. Click on the name of your campaign.
  3. Select Settings near the top of the page, just under the campaign title.
  4. First, check to ensure the person is not already an RW member. Use the Find a person dialog to search for existing RW members. If their name does not appear, then they are not a current RW member.
  5. To add a new member, click the + to the right of the “Find a person” search box.
  6. In the “Add Members” page click the envelope icon envelope_icon in the upper right.
  7. Enter the email address for the new member you want to invite. More than one member can be invited by entering additional email addresses each on a new line.
  8. You can preview the invite email that will be sent by clicking Preview invitation.
  9. Click Send.

Note

The user will then receive an invite notification (the envelop icon envelope_icon in the top right). They must first accept the invitation before being able to view the campaign.

add_user_campaign_gif

Note

Once you have invited a new member, that person must create a Workspace account to join the project. The account should be created using the same email address used for the invitation, otherwise they will not have access to the project.

New users may be prompted to enter an access code to create their account. If you are a program administrator and don’t know your access code, contact us at support@researchworkspace.com for assistance.

Delete a Campaign

If you are the owner of a campaign, you can delete it by following these steps:

  1. Click on the white down arrow down_arrow_icon next to Settings.
  2. Select Delete campaign from the dropdown list.
  3. Confirm that you want to delete the campaign by selecting Delete in the popup window that appears.

Warning

Deleting a campaign will remove the project as well as all its files and any metadata. There is no going back, so be sure that you want to take this action!