id, path, source_system

Definition

The source’s name, its file, and the ID of a contract in the adapter catalogue. The IDs are the names under contracts: in catalog.yaml, and obs.available_yaml_adapters() lists all 114.

Name the file and its contract separately

This source fragment is taken from the claims configuration in the command and setup reference:

- id: cases
  path: claims_ops.csv
  source_system: generic

cases names this configured source. claims_ops.csv is the input file, resolved relative to the configuration. generic selects the adapter contract; it is not inferred from the filename.

Find a valid contract ID

Read the IDs under contracts: in catalog.yaml, or call obs.available_yaml_adapters() through the Python API. Complete the source's required role, grain, authority and mapping declarations using the configuration example, then validate it. Renaming the source does not change its contract.