Importe un formulaire KoboToolbox via fichier local (XLS/JSON) ou via l'API REST KoboToolbox. Retourne un tibble annoté avec les métadonnées du formulaire. Compatible avec KoboToolbox et KoBoCAT.
Utilisation
import_kobo(
source,
uid = NULL,
token = Sys.getenv("KOBO_TOKEN"),
format = c("xls", "json"),
langue = "French (fr)",
verbose = TRUE
)Arguments
- source
character — Chemin vers un fichier XLS/JSON local, ou URL de base de l'API (ex: "https://kf.kobotoolbox.org").
- uid
character ou NULL — Identifiant unique du formulaire (requis si source = URL API). Défaut : NULL.
- token
character — Jeton d'authentification API. Peut aussi être défini via la variable d'environnement
KOBO_TOKEN. Défaut :Sys.getenv("KOBO_TOKEN").- format
character — Format du fichier local : "xls" ou "json". Ignoré si source est une URL. Défaut : "xls".
- langue
character — Code langue pour les labels multilingues (ex: "French (fr)", "English (en)"). Défaut : "French (fr)".
- verbose
logical — Afficher les messages. Défaut : TRUE.
Valeur de retour
Un tibble avec les colonnes du formulaire. L'attribut
attr(., "metadonnees_kobo") contient le dictionnaire des variables.
Exemples
if (FALSE) { # \dontrun{
# Import depuis fichier XLS local
donnees <- import_kobo(source = "data/enquete_2024.xls")
# Import depuis API KoboToolbox
Sys.setenv(KOBO_TOKEN = "mon_token_secret")
donnees <- import_kobo(
source = "https://kf.kobotoolbox.org",
uid = "aXmNk7pQrS",
langue = "French (fr)"
)
} # }