Tutorials

From BCOeditor Wiki
Revision as of 21:08, 21 September 2022 by Twang9 (talk | contribs) (→‎Build a BCO)
Jump to navigation Jump to search

Register for a portal account

Before building a BioCompute Object (BCO), please register an account first by following the listed steps:

  1. Go to Log in on the header:
    Log in 22.09.png
  2. Click on Sign up, and complete the requested information, including First and Last name, email, username, and password. Once finished, click on SIGN UP FOR PORTAL ACCOUNT.
  3. An activation email from object.biocompute@gmail.com should be sent to your entered email address. Click on the activation link from the email within 10 minutes to activate your BioCompute Portal account. Once activated, a new window should prompt open and indicate the activation status.
  4. Login to the Portal account using your username and password by clicking on SIGN IN.

Account information

Under Account, personal/account information can be modified. In addition, the users are able to change passwords, add servers, and edit Groups and Permissions.

  1. After logging in, go to Account on the header:
    Account 22.09.png
  2. On the Account page, account details can be changed and the user can choose to make the information publicly by checking Public.
  3. To change passwords and modify Databases, Groups, and Permissions, click on the drop-down arrow on the right for each section.

Search for a draft and existing BCO

  1. Click on Objects on the header:
    Objects1——22.09.png
  2. Select a server by clicking on the dropdown arrow:
    Objects2 22.09.png
  3. Select Search Type. Three search types are available, My BCOs, Prefix Search, and Search BCO_ID. Once a Search Type is selected, the SEARCH button will lite up.
    Objects3.png
  4. Enter the search term in the blank field. This function is only available when doing a search by Prefix Search and Search BCO_ID to achieve a precise search. All BCO Accessions are clickable which will direct to the BCO.
    Object3.png

Build a BCO

  1. Click on Builder on the header:
    Builder1 22.09.png
    Each domain can be expanded by clicking on the expand arrow.
  2. Before creating a BCO, an eTag needs to be generated. To do so, click on the expand arrow in Object Information section, then click GENERATE ETAG. Do not worry about Object ID, it will auto-generate when saving the BCO draft.
    Builder2 22.09.png
  3. To begin filling out the BCO, click on Provenance Domain to expand the section. Fill out the information as needed. Red boxes are required fields, yellow boxes are recommended fields, and plain boxes are optional fields.
    Builder3 22.09.png
  4. For information to fill out each domain, please go to Provenance Domain, Usability Domain, Extension Domain, Description Domain, Execution Domain, I/O Domain, Parametric Domain, and Error Domain. Or, click on the question mark icon on each domain for more information.
  5. User can also view/edit the BCO in JSON by clicking on either TREE VIEW JSON or RAW JSON VIEW.
    Builder4 22.09.png
    Builder5 treeview.png
    Builder6 JSON.png
  6. A BCO draft can be saved at any time of editing. In order to save a draft, go to the top of the page, and click on SAVING AND PUBLISHING.
SAVE1 22.09.png
  1. To save the draft properly, first choose a server to save the draft. Then the BCO prefix field will show up. Enter a specific BCO prefix based on user groups and permissions. The default prefix is BCO, which can be used by all users. Click on CREATE NEW DRAFT. If the entered prefix is not correct, an error message will pop up saying “Create Draft Failed” with a specific reason. Otherwise, the message will say “Create Draft Success”. Click OK on the message to return to the builder page.
  2. Once the new draft is created, the Builder page will refresh and generate an Object ID, which will show in the Object Information section. Continue to edit the BCO as needed.
  3. Once finish editing or need to save the draft again, go back to the top of the page, click on SAVING AND PUBLISHING, then click SAVE CURRENT DRAFT. A pop-up window will show up and indicate the draft is saved successfully.
  4. Before publishing the draft, users need to validate the draft first. To do this, click on SAVING AND PUBLISHING. Choose Display Validation, then VALIDATE DRAFT. A new window will pop up with validation results.
    Validation.png
  5. If validation results show ‘“number_of_errors”: 0’, this means the draft has passed validation and it’s ready to publish. Go back to the Builder screen, now the PUBLISH DRAFT button should show up, click on it to publish the draft.
    Publish.png
  6. If any errors were detected during validation, then correct those errors based on the validation results. Revalidation is needed before publishing.
  7. Other options on the Builder page include DOWNLOAD DRAFT in JSON format and DELETE DRAFT permanently.