get_uid_list: Get the Index of an...

In lsteinmann/idaifieldR: Importing Data from Field Desktop / iDAI.field into R

Get the Index of an idaifield_docs/idaifield_resources-list

Description

All resources in the project databases in iDAI.field / Field Desktop are stored and referenced with their Universally Unique Identifier (UUID) in the relations fields. Therefore, for many purposes a lookup-table needs to be provided in order to get to the actual identifiers of the resources referenced. Single UUIDs or vectors of UUIDs can be replaced individually using replace_uid() from this package.

This function is also good for a quick overview / a list of all the resources that exist along with their identifiers and short descriptions and can be used to select the resources along their respective Categories (e.g. Pottery, Layer etc., formerly named "type"). Please note that in any case the internal names of everything will be used. If you relabeled Trench to Schnitt in your language-configuration, the name will still be Trench here. None of these functions have any respect for language settings of a project configuration, i.e. the front end languages of valuelists and fields are not displayed, and instead their background names are used. You can see these in the project configuration settings.

Usage

get_uid_list(
  idaifield_docs,
  verbose = FALSE,
  gather_trenches = FALSE,
  remove_config_names = TRUE,
  find_layers = FALSE,
  language = "all"
)

Arguments

idaifield_docs	An object as returned by get_idaifield_docs()
verbose	TRUE or FALSE. Defaults to FALSE. TRUE returns a list including identifier and shortDescription which is more convenient to read, and FALSE returns only UUID, category (former: type) and basic relations, which is sufficient for internal use.
gather_trenches	defaults to FALSE. If TRUE, adds another column that records the Place each corresponding Trench and its sub-resources lie within. (Useful for grouping the finds of several trenches, but will only work if the project database is organized accordingly.)
remove_config_names	TRUE/FALSE: Should the name of the project be removed from field names of the configuration? (Default is TRUE.) (Should e.g.: test:amount be renamed to amount, see remove_config_names().)
find_layers	TRUE/FALSE. Default is FALSE. If TRUE, adds another column with the 'Layer' (see getOption("idaifield_categories")$layers, can be modified) in which a resource is contained recursively. That means that even if it does not immediately lie within this layer, but is contained by one or several other resources in said layer, a new column ("liesWithinLayer") will still show the layer. Example: A sample "A" in Find "001" from layer "Layer1" will usually have "001" as the value in "liesWithin". With find_layers, there will be another column called "liesWithinLayer" which contains "Layer1" for both sample "A" and Find "001".
language	The short name (e.g. "en", "de", "fr") of the language that is preferred for the fields. Special value "all" (the default) can be used to return a concatenated string of all available languages. gather_languages() will select other available languages in alphabetical order if the selected language is not available.

Value

a data.frame with identifiers and corresponding UUIDs along with the category (former: type), basic relations and depending on settings place, shortDescription and "liesWithinLayer" of each element

See Also

• Superseded by get_field_index(), which queries the database directly.

• find_layer() is used when find_layers = TRUE to search for the containing layer-resource recursively.

Examples

## Not run: 
connection <- connect_idaifield(serverip = "127.0.0.1",
                                user = "R", pwd = "hallo")
idaifield_docs <- get_idaifield_docs(connection = connection,
                                     projectname = "rtest")

uidlist <- get_uid_list(idaifield_docs, verbose = TRUE)

## End(Not run)

lsteinmann/idaifieldR documentation built on April 3, 2025, 2:06 p.m.