Request - Fix documentation to indicate that partID in component loaders requires full url rather than numeric value

[campmlc]

Help us understand your request (check below):

• search or data request (help with SQL or provide the specific fields you are trying to retrieve for your collection)
• add a new Github user to the Arctos Users team
• a new barcode series
• a new term for data entry or management
• a change or new report or label
• update to an Agent (split, merge, or other type of change)
• bulkload changes (to Agents, Identifiers, etc that are not already available as a bulkloading tool)
• new feature or otherwise a good idea to make Arctos even better
• quarantine taxon name and suggested replacement (please supply links)
• other

Describe what you're trying to do
PartID is used in a variety of component loaders and tools (eg Catalog Record Part Edit). For most (all?) of the component loaders such as Part ID bulkload, it appears that the full url is required, but the tool documentation does not make this clear. Many older Arctos tools only provide/display the numeric value. This request is to update the documentation for Part Attribute Bulkload and other other similar tools that use PID as an optional or required field (e.g. loan item bulkload), to use consistent language for this term clearly specifying that the field requires the full part ID url.

[DerekSikes]

I support this! I recently had a citations bulkload fail because I provided the publication ID alone and not the full URL. All loader documentation could benefit from clear language that states the full URL string is needed as the ID.

[ebraker]

2025-02-25 Documentation committee: I'm tagging @dustymc to update the Definitions and Documentation tables for various component loaders using Part ID and Publication ID to indicate 'full URL required'

[dustymc]

This is in the template with a reference to https://handbook.arctosdb.org/documentation/developer-guide.html#identifier-convention

[ebraker]

I think @campmlc maybe meant (?) in the Definitions and documentation tables on the upload csv pages, but I could be wrong!:

[campmlc]

Yes, @ebraker @dustymc I did mean the definitions and documentation tables on the upload csv pages for the tool itself. When we are using any tool, we are relying on the documentation provided in the UI interface for the tool page instructions. I imagine this is also the issue @DerekSikes is referring to for a similar situation in the publication bulkloader. This request is for all component loaders that require a full url in any field to explicitly state that requirement in the tool documentation on the csv upload page.
This includes partID across all tools, and apparently also publication ID.

From original request:
PartID is used in a variety of component loaders and tools (eg Catalog Record Part Edit). For most (all?) of the component loaders such as Part ID bulkload, it appears that the full url is required, but the tool documentation does not make this clear. Many older Arctos tools only provide/display the numeric value. This request is to update the documentation for Part Attribute Bulkload and other other similar tools that use PID as an optional or required field (e.g. loan item bulkload), to use consistent language for this term clearly specifying that the field requires the full part ID url.