BC GEOGRAPHIC WAREHOUSE DATA PUBLICATION
When data is published to the BC Geographic Warehouse, it will undergo a standardized publication process to ensure adherence to government data standards for quality and consistency. DataBC’s Data Standards are a helpful resource to reference as you prepare your data for publishing.
The workflows described below will guide you through the steps and requirements when working with DataBC to publish data in the BCGW.
This page is written in the context that you have reviewed the documentation as listed below.
AUDIENCE | |||
---|---|---|---|
Data Publishers | Business Analysts | Business Managers | Application Administrators |
Table of Contents
Documentation Review
The first step in the process is to review the following documentation:
- Before You Start
- BCDC Standards and Guidelines
- BCGW Standards and Guidelines
- Common Data Standards and Guidelines
- Data Governance
- Open Data
Getting Started
Wondering if your data is ready for publishing in the BC Geographic Warehouse, or what you need to do to prepare for the publication process? The following table describes some key considerations you’ll need to think about before initiating a request to publish your data.
Consideration | Additional Details |
---|---|
Have you read and do you understand the information provided in the Documentation Review section? | Please open a ticket with the Data Systems & Services request system if you have additional questions not addressed in our documentation. |
Has the Data Custodian approved the publication of this dataset for your business area? | Data Custodians are responsible for ensuring the business area has resources to support the management of the data throughout its lifecycle. |
Is the source data in a production state and ready for publishing? | When data is ready for production, it has a finalized data model, has been QA/QC’d by the business area, and is populated with publication-ready data. If you are unsure or need advice, open a ticket with the Data Systems & Services request system. |
Have you completed the Dataset Model file? | The Dataset Model describes your source data structure (fields, data type, data length, column comments). |
For spatial datasets: Do you have GIS staff available to support the creation of layer files and QA/QC throughout the publication process? | For business areas without GIS support, this service can often be provided by GeoBC. |
Do you have a Data Manager identified who will be responsible for the day-to-day maintenance of the source data? | The business area must have an assigned Data Manager for the data, throughout it’s lifecycle. |
Who will use the data? | This can be one or more of: Public, Government, Business BCeID |
Does your business area have other data published in the BC Data Catalogue? | If not, DataBC can set up your organization in the BC Data Catalogue, with approval from the Data Custodian. |
Does your business area have a defined BC Data Catalogue editor that will create and maintain the metadata throughout its lifecycle? | If not, please open a ticket with the Data Systems & Services request system. |
How will your data be licensed when published? | See Licences |
Are there legislative constraints that will have an impact on the publication date for the data? |
Data Publication
Once you’re ready to publish your data, please review the workflow below, then open a ticket with the Data Systems & Services request system. Once submitted, you will receive an automated email confirmation of your request.
DataBC will work to prioritize your request into a four-week work cycle, at which point you will receive a notification in your Data Systems and Services (DATABC) ticket confirming your availability to work with us. We aim to provide about two weeks notice prior to the initial project scoping meeting.
Week 1: Project Scoping / Technical Sessions
Required attendees:
- Client data manager(s)
- GIS staff (if different from the client data manager)
- Database Administrator (if source data is in an operational database)
Project Scoping - 1 Hour
The Project Scoping meeting allows DataBC’s Data Architects to get to know you and your data, understand the business requirements and project scope.
The team will review the data publication process with you and discuss any additional requirements that may be needed to successfully publish your data and configure access for end-users, e.g., BCGW Test database access, BC Data Catalogue editor access.
Discussion in this session will focus on:
- Details of the request to publish data
- Access to the source data
- Security for the data
- Data Distribution
- Data Licensing
- Size of the data and expected growth
- Frequency of updates to the data
- BC Data Catalogue metadata requirements
- Layer file requirements
- Technical or time constraints
At the end of this session, it will be determined which of DataBC’s data publication platforms is most appropriate for your data and user needs; BC Data Catalogue, BC Geographic Warehouse, or BC’s MapHub.
Technical Session - 1 Hour
The technical session will focus on a review of the data model submitted by the client and DataBC’s access to the source data, including:
- Description of the dataset(s)
- Dataset naming
- Column naming
- Column data types
- Column descriptions
- Data model for related database views (if applicable)
- Access to source data (operational database, BCGW Staging Area)
Week 2: Test Deployment
During this phase, DataBC will:
- Deploy the data as modelled into the BCGW Test database
- Create the replication script and populate the BCGW Test database object(s)
- Notify the client via the DATABC ticket when the data has been successfully deployed and populated in BCGW Test
Data Access Configuration
Once the client data manager has been notified that the data is available in BCGW Test, they will:
- Draft the new BC Data Catalogue metadata record(s), describing the dataset in full detail, referring to Making Useful Metadata
- For spatial datasets, client will create the layer file(s) based on the Layer File Presentation standards, sourced to BCGW Test
Week 3: Client Review
During the Client Review period, DataBC is available to meet if/when needed to assist in the data review, answer client questions, address concerns, and/or accommodate change requests where feasible.
The client is expected to review the data in BCGW Test, for example:
- Column naming and order
- Data accuracy – attributes and geometry are as expected
- Data completeness – data is a full representation of what is supplied in the source data, e.g., record count
Access Configuration: Layer Presentation
The client will then submit the layer (.lyr) file via the DATABC ticket. DataBC will then review and load the layer file into iMapBC Test and send the link to the client for review via the DATABC ticket.
Access Configuration: Metadata
The client will finalize the BC Data Catalogue metadata record(s) content and set the record to PENDING PUBLISH.
Change Requests
Any required changes to the data model as deployed or the layer presentation should be requested via the DATABC ticket as soon as possible during the client review period. This will allow for DataBC to make adjustments and re-deploy updates without impact to production deployment scheduling.
Please note that the depending on the scope of the change request, DataBC may be able to accommodate changes during the team’s four week work cycle. Significant changes will likely need to be scoped out as a new project.
Week 4: Production Deployment
DataBC will deploy the data to BCGW Production and finalize access configurations, including:
- Publication of the BC Data Catalogue metadata record(s)
- Creation of DataBC’s standard BC Geographic Warehouse data resource in the BC Data Catalogue record
- Data distribution configuration for the BC Geographic Warehouse data resource
- Publication of the layer presentation in the Layer Library, production iMapBC
Client Production Review
Client will review production deployments, including:
- Dataset(s) in the BC Geographic Warehouse
- Layer presentation(s) in iMapBC and the Layer Library
- Ability to download the data via the BC Geographic Warehouse data resource in the BC Data Catalogue record (where applicable)
Post-Production
Public Web Services
For publicly available data, the related Web-based services are created and become available for use on the Thursday after production deployment is complete in the BC Geographic Warehouse, iMapBC, and the BC Data Catalogue. These include:
- WMS
- KML
- ArcGIS Online Feature Layer
DataBC will create the related BC Data Catalogue resources for these services, once they are available.
Additional Considerations
Data Security: Application Access
- DataBC’s standard WMS services should be used for application access.
- DataBC may consider providing a database proxy account where the client has supplied a reasonable explanation as to why standard web services cannot be used.
Data Security: Named User Data
Requirements for Named User access:
- Data is highly secure, and cannot be shared across government, and
- Data is required to be accessible beyond the client business area (e.g., branch), but only by specific named users
Access Configuration:
- DataBC will configure database access based on a list of users provided by the client at the time of publication
- Client will supply the name of a Delegator, who will approve the addition or removal of users
- The Delegator will request any future additions or removal of users via the NRM IT Portal
- Client will determine whether access is required for:
- Secure iMapBC
- Data distribution (download)
Data Licensing
All data publications with public access are encouraged to complete an Open Data Assessment and Checklist to determine which licence is appropriate for the data.
Do you still have questions for DataBC about the data publication process? If so, please open a ticket with the Data Systems & Services request system