pull_remote: pull_remote

In odkr: 'Open Data Kit' ('ODK') R API

Description

Pull ODK forms from remote ODK Aggregate via ODK Briefcase

Usage

pull_remote(target = "", briefcase = "odkBriefcase_latest", id, to = "",
  from = "", username, password)

Arguments

target	Path to directory of ODK Briefcase .jar file. Directory path should match directory path used when calling get_briefcase(). If ODK Briefcase .jar file was downloaded manually from https://opendatakit.org, target should match the directory path where .jar file has been downloaded into.
briefcase	Filename of the downloaded ODK Briefcase .jar file. Default is odkBriefcase_latest to match the default filename used by get_briefcase(). If ODK Briefcase .jar file was downloaded manually from https://opendatakit.org, filename should match the default filename used by Open Data Kit which is usually "ODK Briefcase vX.Y.Z Production.jar" where vX.Y.Z is the version number
id	Form ID of form to be pulled
to	Destination directory for pulled ODK forms
from	URL of remote ODK Aggregate server
username	Username for account in remote ODK Aggregate server from which forms are to be pulled
password	Password for account in remote ODK Aggregate server from which forms are to be pulled

Value

Folder in destination directory named "ODK Briefcase Storage" containing forms pulled from remote ODK Aggregate server

Examples

  # Use latest ODK Briefcase (version 1.8,0) and connect to a test
  # remote ODK Aggregate server from ONA (https://ona.io); pulled forms to
  # be saved in default location at current working directory
  ## Not run: 
  dirPath <- tempdir()
  get_briefcase(destination = dirPath)
  pull_remote(target = dirPath,
              id = "stakeholders",
              from = "https://ona.io/validtrial",
              to = dirPath,
              username = "validtrial",
              password = "zEF-STN-5ze-qom")
  
## End(Not run)

odkr documentation built on Feb. 11, 2018, 3:10 p.m.