...
Depending on the project need, portals can be driven dynamically from Views or statically from Tables. When choosing consider:
By design, Tables are not public. Therefore, Portal Tables must be explicitly whitelisted by governance and someone on the leadership team in order to make them public. This is required any time the schema changes or values are added.
Files are only available to bulk download through Views. (Bulk download feature not exposed in the web UI in Tables).
There is potentially a performance hit in Views (in dispute; has not been fully tested) if there are varying access permissions across the set of files and many facets.
External content that the portal renders within the site must be hyperlinked "https". Links out can be http or https.
Removing facets can improve performance (maybe?). If you set a facet in a Table or View, it will be displayed in the portal.
Sharing settings on Tables
Make Public - Anyone on the web, Can View. To surface Tables in the portal that are in project with restricted sharing settings, Tables must be explicitly whitelisted {document process to whitelist} by governance and someone on the leadership team. This is required any time the schema changes or values are added.
A change to ACL could disrupt visibility although, whitelist status is still maintained in the back-end.
Jira
Portal development coordination is tracked in the Community Portals Jira project. Create an appropriate Epic within your own project (for the computational oncology, systems biology, or neurodegenerative research teams, this should be in the SCIENCE project) to track the overall project. It is the job of the respective portal product manager to triage issues to the engineering team (Alina, Michael and Jay) appropriately. ‘backlog’ label is required to be visible to engineering team and product manager.
...
Fill out the 1-pager for product and design and submit a Jira in the PORTALS project for review.
Open a Jira to task the design team with the creation of relevant wire frames. Designers will implement logo and color scheme. Depending on the level of customization or needs for external parties, a complete wireframe may not be required. This is at the discretion of the design team, so don’t plan on not having one unless confirmed with Ljubomir Bradic (Unlicensed) .
A Synapse Project drives the backend of the portal. Make a project (e.g. PEC).
Open a Jira issue with PORTALS to (e.g. PEC) create required infrastructure. This creates an empty AWS bucket.
Implement design in the staging site by opening a Jira issue with PORTALS (e.g. PEC)
{TODO:determine what is required to make these connections} Create Table/View architecture
All data View
If you want to surface data entities in the portal,
Publications
Tool to scrape Pubmed for relevant publications using grant or pubmed id as input
People
Study
Set schema - note "hint text" is tracked in Confluence page and must be manually set by web developer
General notes about table schemas and column types
Simple markdown (links, bullets, bold, etc) is supported in underlying tables, but you will need to specify which columns have markdown in the schema
if you need to link to multiple synapse IDs, separate the list with commas
...