User Manual

B-Fabric is the tool to work with at the Functional Genomics Center Zurich. B-Fabric comprises all the major functionality needed to run and work with a core facility.
Among others, it is used to apply and manage User Lab projects. The management of a User Lab project includes the management of users (project members) as well as the management of the data produced in the project. B-Fabric allows storing, annotating, and search for scientific data. To become acquainted with the system, please have a look at the QuickGuides below.



FAQ

QuickGuide Proteomics

User Management

Project Management

Order Management

Users may order fee-based services at FGCZ. B-Fabric helps to manage the entire process of a order process including the submission of the order, the provision and download of the results, and the accounting of the service. Depending on the services, an order can be executed with or without the requirement of a project.

Sample Management

Create Sample: How to create a sample.
Edit Samples: This feature allows you to edit samples in tabular form. You can edit one or more samples of your context project, clone existing samples, or create new samples. This operation consists of two steps:
Move Sample: A sample can be moved to another project if it is not (transitively) assigned to any resource. In this case, the sample will be moved together with all child samples.

Plate Management

Data Import and Annotation

To import data into B-Fabric, the corresponding resources (≈files) have to be described and annotated. This is done by assigning them to a Sample. The Sample contains the information about the source material of the measurement that produced the data to import.

Instrument Reservations

Instrument reservation manages access to instruments and because each instrument has its own constrains and requirements it is assigned a default setting upon creation.
For further information for customizing the instrument reservation refer Instrument Reservation Setting provided below..
Customize Instrument's Reservation: Instrument Reservation Setting.
Create Instrument Reservation: How to create an instrument reservation.
Instrument Reservation Shifting: How to create shift instrument reservations.

Data Analysis and Processing

To analyze data, the needed resources (≈files) have to be selected and in case of certain analysis application assembled into an Experiment Definition. Creating such an experimetn definition allows to gather the needed resources and enrich them with parameters.

Data Download

The B-Fabric Download Manager allows to download single resources as well as entire workunits.
A requirement for using the B-Fabric Download Manager is a working installation of Java.
  1. How to download single resources
  2. How to download entire workunits
The B-Fabric Download Manager supports resume of downloads when stopped by the user or network interruptions. Moreover, it checks the checksums of the downloaded files to ensure that downloaded files are not corrupt. Note that the B-Fabric Download Manager is a Java Rich Internet Application based on Java Web Start, which only requires that Java is installed on the local machine.

If you are using Mac OS X, please be aware of this additional Apple security setting for third party applications.

Resource Basket

The resource basket allows collecting resources for later use as input resources to invoke an application. The resource basket is associated with a user and is persisted in the database. The following operations are supported:
Following types of objects are searchable via (Lucene) index: Projects, Samples, Workunits, Resources, Datasets etc. By clicking on on the corresponding header menu items, the corresponding objects of that type are listed. In case of projects, all projects the current user is member of are listed. Note that all objects are linked together. For instance, using the corresponding menu links of the show project screen, you can get easily to all samples, workunits, datasets etc. belonging to that project. This is also true for other types of objects. be aware that the column filters in data tables are usually based on "contains" semantics.

Feedbacks

Annotation Management

Users annotate their experimental data by using attribute vocabularies. These vocabularies can be extended by the users. Newly added annotations are then reviewed and released by FGCZ experts.

Email Management

Agenda

The Agenda Tool allows employees to manage and communicate their absences.
  • Events
    • An event is half-day slot that can be associated with different event types, e.g. business trip or vacation.
    • Events can either be user-specific or public. Public events are "Public Holiday", "Group Meeting" or "Retreat".
    • Events can be edited and deleted before their end date is passed. After the end date has passed more than a week, the event can only be edited and deleted by a user with admin rights.
    • A repeating event is an event that occurs in a given interval (weekly, bi-weekly, etc.) until the defined end date is reached.
      • Delete Repeating Events: When deleting a repeating event, the system asks whether to:
        • DELETE THIS EVENT: Just delete the selected event.
        • DELETE ALL FOLLOWING: Delete the selected event and all following events in the series.
        • DELETE ALL EVENTS: Delete the entire event series.
    • When creating an event, you can optionally send an email to absences at fgcz.ethz.ch and to selected colleagues to inform them about the absence. Here you can also select previously defined mail groups as recipients.
      • Mail groups can be created/updated via the menu "Admin > Common data > Mail Groups".
  • Vacation Credits
    • The vacation credits specify the amount of vacation days for a specific user. Every employee has a number of vacation days depending on her/his employment degree. The new vacation credits are granted using the formula "deployment degree x 25 days".
    • When the FGCZ coordinator closes the agenda year (see Admin section below), the vacation credits are created for the corresponding year and the unused vacation credits from the last year are transferred implicitly.
  • Event Types
    • The event type specifies the kind of event (Sickness, Vacation, etc.). The type determines whether the event duration takes vacation days from the user, etc.
    • A user with the role coordinator can add and edit event types, e.g., change the color of an event type.
  • Admin: The admin area is visible for users with the role agendaManager. This page contains the following functions:
    • Close Agenda Year: Usually at the beginning of a new year, the past agenda year can be closed in the sense that the unused vacation credits of the past year are taken over for the current year and all employees receive a vacation credit for the current year. The number of credited days is based on the employment degree of each employee. Therefore, every employee as well as the secretary should check whether all entered employment degrees are still valid (i.e. reflecting the current degree of employment).
    • Set Accounted Days: This function is needed once after the migration to compute and set the accounted days for all vacation events. Of this function can be rerun later ant any time, e.g. if a public holiday event was forgotten and added later on. In this case, the re-computation is required to avoid that too much vacation days are counted for an event.
    • Employees: Gives an overview of total credited and taken vacation days.
  • Hints for FGCZ employees: Please enter all your missing events and credits before the end of the corresponding year. To ensure a correct computation of credits, please go your login details and check whether your employment degree is still valid. If not, please update it.
  • Troubleshooting: To avoid that the generated PDF files for the overview and vacation reports are opened within your web browser, please check ensure that browser settings for PDF are not set to "Preview (in Firefox)". The preview of the agenda overview report in the browser takes a lot of time. Instead open the PDF files with an application of your choice.

Miscellaneous


Events

Any entity having a start date/time and end date/time is considered an event and the following shows available types of bfabric events.
  • Event: Formerly known as agenda event.
  • Instrument Reservation
  • Meeting
Every type of event has a dedicated scheduler in addition to standard forms.