Marc Kupietz | 6ddece4 | 2023-12-18 17:02:36 +0100 | [diff] [blame] | 1 | % Generated by roxygen2: do not edit by hand |
| 2 | % Please edit documentation in R/textMetadata.R |
| 3 | \name{textMetadata,KorAPConnection-method} |
| 4 | \alias{textMetadata,KorAPConnection-method} |
| 5 | \alias{textMetadata} |
| 6 | \title{Retrieve metadata for a text, identified by its sigle (id)} |
| 7 | \usage{ |
| 8 | \S4method{textMetadata}{KorAPConnection}(kco, textSigle, verbose = kco@verbose) |
| 9 | } |
| 10 | \arguments{ |
| 11 | \item{kco}{\code{\link[=KorAPConnection]{KorAPConnection()}} object (obtained e.g. from \code{new("KorAPConnection")})} |
| 12 | |
| 13 | \item{textSigle}{unique text id (concatenation of corpus, document and text ids, separated by \code{/}, e.g. ) or vector thereof} |
| 14 | |
| 15 | \item{verbose}{logical. If \code{TRUE}, additional diagnostics are printed. Defaults to \code{kco@verbose}.} |
| 16 | } |
| 17 | \value{ |
Marc Kupietz | 3687a8c | 2024-01-24 16:18:36 +0100 | [diff] [blame^] | 18 | Tibble with columns for each metadata property. In case of errors, such as non-existing texts/sigles, the tibble will also contain a column called \code{errors}. |
| 19 | If there are metadata columns you cannot make sense of, please ignore them. The function simply returns all the metadata it gets from the server. |
Marc Kupietz | 6ddece4 | 2023-12-18 17:02:36 +0100 | [diff] [blame] | 20 | } |
| 21 | \description{ |
| 22 | Retrieves metadata for a text, identified by its sigle (id) using the corresponding KorAP API |
| 23 | (see \href{https://github.com/KorAP/Kustvakt/wiki/Service:-Metadata-Retrieval}{Kustvakt Wiki}). |
| 24 | } |
| 25 | \examples{ |
| 26 | \dontrun{ |
| 27 | new("KorAPConnection") \%>\% textMetadata(c("WUD17/A97/08542", "WUD17/B96/57558", "WUD17/A97/08541")) |
| 28 | } |
| 29 | |
| 30 | } |