Skip to main content

Benchling_Api

Node​

Node Description​

Reads Benchling data.

Uploads tabular output from user-defined function to Ganymede data lake.

Node Attributes​

  • output_table_results

Notes​

Usage requires configuration of a Benchling application in the relevant Benchling tenant.

Prior to usage, the secrets below must be configured in your Ganymede environment. More information on acquiring these credentials can be found here.

  • benchling_url: URL for Benchling tenant; has form https://<tenant>.benchling.com
  • benchling_app_client_id: Client_ID; has form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  • benchling_client_secret: Client_Secret; has form cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Secrets can be configured by clicking on your username in the upper-right hand of the Ganymede application, then selecting Environment Settings and navigating to the Secrets tab. If you need assistance, please don't hesitate to reach out to Ganymede.

In the execute function, returning NodeReturn(tables_to_upload={'results': df}) would render the DataFrame df in the Flow Editor if Table Head visualization is enabled.

User-Defined Python​

Reads Benchling data based on input parameter. This node should be used in conjunction with the Input_Param node.

Parameters​

  • benchling_context : BenchlingContext
    • Benchling context variable, which stores Benchling connection information
  • ganymede_context : GanymedeContext
    • Ganymede context variable, which stores flow run metadata

Returns​

NodeReturn Object containing data to store in data lake and/or file storage

Notes​

Documentation for the Benchling API can be found here: https://benchling.com/api/reference