Data Warehouse Knowledge Base
Data Warehouse Knowledge Base
Breadcrumbs

Managing Data Collection Assets

This page covers the process for adding and editing Data Collection assets in the FEWS NET Data Warehouse (FDW). 

Data Collection assets can be added in two primary formats: 

  • Uploaded files: You can upload files of any type and size directly to the Data Collection.

  • External links: You can add links to externally hosted resources, such as a website or Google Doc.

Where to add and manage Data Collection assets

You can add, view, and edit assets from several screens in FDW: 

  • Data Entry > Add a new Data Collection: Add assets alongside a new Data Collection. 

  • Data Entry > Manage Data Collection Assets: Add, view, and edit assets for existing Data Collections. 

  • Data Processing > Display or edit an existing Data Collection: View the asset count for existing Data Collections. 

    • Select a Data Collection from the table to add, view, and edit assets from the Change Data Collection screen. 

Access to the Manage Data Collection assets screen is limited. Contact the Hub to discuss permissions.

Add Data Collection assets

You can add a Data Collection asset from the Add a new Data Collection, Manage Data Collection assets, or Change Data Collection screens.

From the Add Data Collection asset screen, complete the following fields:

Collection: Auto-populates when working from the Add Data Collection or Change Data Collection screen. When using Manage Data Collection Assets, search for the Data Collection name.

Display Name: Provide a name or title for the asset (optional). The display name will be visible in FDW as well as on the Data Source detail page in the FEWS NET Data Explorer.

Description: Provide extra information or detail (optional).

Uploaded File: If the asset is a file, select it for upload.

External URL: If the asset is a URL, paste it into the text field.

File Format: Select the file format of the asset.

Usage Policy: Assign a Usage Policy for the asset (optional). The asset will default to the Usage Policy of the Data Source Document.

The following Data Usage Policies are available within the FEWS NET Data Platform:

  • Public: Data labeled under this usage policy are available to all users, including those with and without access to the FEWS NET Data Warehouse or Data Explorer.

  • FEWS NET Only: Data labeled under this usage policy are available to internal Project staff only.

  • Restricted: Data labeled under this usage policy are only available to users who have been granted specific permission by a system administrator.

  • Early Warning Analysis Only: Data labeled under this usage policy are only available for use in Early Warning analysis.

Best practice is to include as much information as possible about the Data Collection asset. This includes a display name/title, description, and file format. The more metadata that is added for a Data Collection asset, the more use it has as part of FEWS NET’s inventory.

Edit Data Collection assets

You can edit a Data Collection asset from the Manage Data Collection Assets or Change Data Collection screens.

Manage Data Collection Assets

  1. Go to Data Entry > Manage Data Collection Assets. 

  2. Use the search and filter options to find the asset in the table.

  3. Select the Data Collection name to open the edit screen.  

Change Data Collection

  1. Go to Data Processing > Display or Edit a Data Collection.

  2. Use the search and filter options to find the Data Collection in the table.

  3. Select the Data Collection name to open the edit screen.

  4. Scroll down to the Data Collection Assets section.

  5. Make changes directly on the screen or use the pencil icon to open the Change Data Collection Asset screen.

Editing assets will overwrite the previous file or information. If you want to add a new version of a file, consider adding a new asset instead of editing an existing one.

View Data Collection assets

You can review the Data Collection assets for a given Data Collection in FDW from the Manage Data Collection Assets or Change Data Collection screens.

Manage Data Collection Assets

  1. Go to Data Entry > Manage Data Collection Assets. 

  2. Use the search and filter options to find the asset in the table.

Change Data Collection

  1. Go to Data Processing > Display or Edit a Data Collection.

  2. Use the search and filter options to find the Data Collection in the table. The Asset Count is included as the rightmost column of the results table. 

  3. Select the Data Collection name to open the edit screen.

  4. Scroll down to the Data Collection Assets section.

Permissions & Usage Policy 

By default, access to uploaded Data Collection assets follow the permissions of the Data Collection, which are typically set at the Data Source Document level. 

You can also select a Usage Policy for an individual Data Collection asset. For example, if the Data Source Document is Public, you can still restrict access to one or more of its assets. 

When adding a link as an asset, you must also consider any permissions that are set on the hosting platform. For example, a Google Document could have restricted access or it could be open to anyone with the link.

If the document is stored in a restricted Google Drive folder but should be made publicly accessible as an asset, consider downloading a copy and uploading it directly to FDW.