When you publish
a study, a new folder is created to hold the data selected for publication. But what if the data in the original study changes? How do you refresh the data in the published study?
Note that refreshing
data is different from reloading
data. Refreshing data applies specifically to published
studies. Reloading data refers to the process of updating study data from source files in the pipeline root. For details on reloading, see Import, Export, and Reload a Study
To refresh a dataset in the published study, follow the same instructions for refreshing an ancillary study. For details, see Ancillary Studies
If you want the published specimen data to reflect any changes/updates in the source study, the published study can be set to refresh automatically each day. If you want the published specimen data to remain static, you can specify that a one-time snapshot be made.
You can set the refresh behavior either when you create the published study
or after it has been created. To change the refresh behavior after the creation of the published study: go to the published study folder, click the Manage
tab, and click the View Settings
button. On the Published Study Settings
page, use the Refresh Specimens
checkbox to indicate whether or not specimens are refreshed nightly.
The specimen refresh occurs as a part of system maintenance, which by default occurs at 2am. To set a different time of day, go to Admin > Site > Admin Console
, click System Maintenance
, choose a new time from the drop-down list, and click the Save
Specimen Refresh: User Credentials
LabKey Server refreshes the specimen data using the security credentials of the user who last modified the specimen refresh settings. The user who initiated the study publication is the initial "modified by" user. If this user is no longer able to refresh specimens (for example, they leave the research organization or their security credentials fall below folder administrator), then subsequent specimen refreshes will fail. In this situation, a different user with at least folder admin permissions in the published study should update the specimen refresh settings:
- Login as (or impersonate) a user with at least folder permissions
- Navigate to the published study folder
- Go to the Published Study Settings page by clicking the Manage tab and then clicking View Settings
- To perform specimen snapshot updates, LabKey Server uses the account identified in the Modified By field
- Click Update to update the Modified By field
- This will change the Modified By field to the current logged in user. LabKey Server will perform future specimen refreshes under this user account.