From dbcf2725707be7b01ee8dfcb15caeee5f2af40e3 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 15:36:26 -0500 Subject: [PATCH 01/42] Remove RForcecom Dependency Remove RForcecom from roxygen documentation and from the Suggests packages. Later we may need to remove from vignettes. Closes #101 --- DESCRIPTION | 6 ++---- NEWS.md | 3 ++- R/compatibility.R | 22 +++++++++++----------- man-roxygen/session.R | 2 +- man/rforcecom.bulkAction.Rd | 2 +- man/rforcecom.bulkQuery.Rd | 4 ++-- man/rforcecom.create.Rd | 4 ++-- man/rforcecom.delete.Rd | 4 ++-- man/rforcecom.getObjectDescription.Rd | 4 ++-- man/rforcecom.getServerTimestamp.Rd | 4 ++-- man/rforcecom.login.Rd | 2 +- man/rforcecom.query.Rd | 4 ++-- man/rforcecom.retrieve.Rd | 4 ++-- man/rforcecom.search.Rd | 4 ++-- man/rforcecom.update.Rd | 4 ++-- man/rforcecom.upsert.Rd | 4 ++-- 16 files changed, 38 insertions(+), 39 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 40a279e9..202971f5 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: salesforcer Title: An Implementation of 'Salesforce' APIs Using Tidy Principles Version: 0.2.2.9000 -Date: 2020-09-12 +Date: 2021-07-03 Description: Functions connecting to the 'Salesforce' Platform APIs (REST, SOAP, Bulk 1.0, Bulk 2.0, Metadata, Reports and Dashboards) . @@ -52,13 +52,11 @@ Suggests: here, microbenchmark, ggplot2, - sessioninfo, - RForcecom + sessioninfo VignetteBuilder: knitr ByteCompile: true Encoding: UTF-8 Language: en-US -LazyData: true Roxygen: list(markdown = TRUE) RoxygenNote: 7.1.1 diff --git a/NEWS.md b/NEWS.md index 3733cbcb..275bfea7 100644 --- a/NEWS.md +++ b/NEWS.md @@ -2,7 +2,8 @@ ### Dependencies - * None yet. + * Remove references to RForcecom after it was removed from CRAN on 6/9/2021 (#101) + * Remove LazyData option in DESCRIPTION since `data()` is not utilized. ### Features diff --git a/R/compatibility.R b/R/compatibility.R index f5e6a865..467affa4 100644 --- a/R/compatibility.R +++ b/R/compatibility.R @@ -21,7 +21,7 @@ # limitations under the License. #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.login}} +#' \code{RForcecom::rforcecom.login} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -61,7 +61,7 @@ rforcecom.login <- function(username, password, loginURL="https://login.salesfor } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.getServerTimestamp}} +#' \code{RForcecom::rforcecom.getServerTimestamp} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -79,7 +79,7 @@ rforcecom.getServerTimestamp <- function(session){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.getObjectDescription}} +#' \code{RForcecom::rforcecom.getObjectDescription} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -104,7 +104,7 @@ rforcecom.getObjectDescription <- function(session, objectName){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.create}} +#' \code{RForcecom::rforcecom.create} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -130,7 +130,7 @@ rforcecom.create <- function(session, objectName, fields){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.retrieve}} +#' \code{RForcecom::rforcecom.retrieve} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -195,7 +195,7 @@ rforcecom.retrieve <- function(session, objectName, } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.update}} +#' \code{RForcecom::rforcecom.update} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -218,7 +218,7 @@ rforcecom.update <- function(session, objectName, id, fields){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.delete}} +#' \code{RForcecom::rforcecom.delete} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -238,7 +238,7 @@ rforcecom.delete <- function(session, objectName, id){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.upsert}} +#' \code{RForcecom::rforcecom.upsert} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -266,7 +266,7 @@ rforcecom.upsert <- function(session, objectName, } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.search}} +#' \code{RForcecom::rforcecom.search} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -284,7 +284,7 @@ rforcecom.search <- function(session, queryString){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.query}} +#' \code{RForcecom::rforcecom.query} #' #' @description #' `r lifecycle::badge("soft-deprecated")` @@ -303,7 +303,7 @@ rforcecom.query <- function(session, soqlQuery, queryAll=FALSE){ } #' The \code{salesforcer} backwards compatible version of -#' \code{\link[RForcecom]{rforcecom.bulkQuery}} +#' \code{RForcecom::rforcecom.bulkQuery} #' #' @description #' `r lifecycle::badge("soft-deprecated")` diff --git a/man-roxygen/session.R b/man-roxygen/session.R index 9460c0b7..fa3a7d0d 100644 --- a/man-roxygen/session.R +++ b/man-roxygen/session.R @@ -1,6 +1,6 @@ #' @param session \code{list}; a list containing \code{"sessionID"}, #' \code{"instanceURL"}, and \code{"apiVersion"} as returned by -#' \code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +#' \code{RForcecom::rforcecom.login}. This argument is ignored in all #' backward compatible calls because the authorization credentials are stored #' in an environment internal to the salesforcer package, so it is no longer #' necessary to pass the session in each function call. diff --git a/man/rforcecom.bulkAction.Rd b/man/rforcecom.bulkAction.Rd index d7509bc2..e9ff2067 100644 --- a/man/rforcecom.bulkAction.Rd +++ b/man/rforcecom.bulkAction.Rd @@ -21,7 +21,7 @@ rforcecom.bulkAction( \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.bulkQuery.Rd b/man/rforcecom.bulkQuery.Rd index e6c44ce9..329ac934 100644 --- a/man/rforcecom.bulkQuery.Rd +++ b/man/rforcecom.bulkQuery.Rd @@ -3,7 +3,7 @@ \name{rforcecom.bulkQuery} \alias{rforcecom.bulkQuery} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.bulkQuery}}} +\code{RForcecom::rforcecom.bulkQuery}} \usage{ rforcecom.bulkQuery( session, @@ -17,7 +17,7 @@ rforcecom.bulkQuery( \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.create.Rd b/man/rforcecom.create.Rd index d39409bc..c26ea288 100644 --- a/man/rforcecom.create.Rd +++ b/man/rforcecom.create.Rd @@ -3,14 +3,14 @@ \name{rforcecom.create} \alias{rforcecom.create} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.create}}} +\code{RForcecom::rforcecom.create}} \usage{ rforcecom.create(session, objectName, fields) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.delete.Rd b/man/rforcecom.delete.Rd index f5573023..085051ed 100644 --- a/man/rforcecom.delete.Rd +++ b/man/rforcecom.delete.Rd @@ -3,14 +3,14 @@ \name{rforcecom.delete} \alias{rforcecom.delete} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.delete}}} +\code{RForcecom::rforcecom.delete}} \usage{ rforcecom.delete(session, objectName, id) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.getObjectDescription.Rd b/man/rforcecom.getObjectDescription.Rd index 764c83ca..c3b3c8c0 100644 --- a/man/rforcecom.getObjectDescription.Rd +++ b/man/rforcecom.getObjectDescription.Rd @@ -3,14 +3,14 @@ \name{rforcecom.getObjectDescription} \alias{rforcecom.getObjectDescription} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.getObjectDescription}}} +\code{RForcecom::rforcecom.getObjectDescription}} \usage{ rforcecom.getObjectDescription(session, objectName) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.getServerTimestamp.Rd b/man/rforcecom.getServerTimestamp.Rd index 6cf504cd..efa72eec 100644 --- a/man/rforcecom.getServerTimestamp.Rd +++ b/man/rforcecom.getServerTimestamp.Rd @@ -3,14 +3,14 @@ \name{rforcecom.getServerTimestamp} \alias{rforcecom.getServerTimestamp} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.getServerTimestamp}}} +\code{RForcecom::rforcecom.getServerTimestamp}} \usage{ rforcecom.getServerTimestamp(session) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.login.Rd b/man/rforcecom.login.Rd index 627667e2..a44360d6 100644 --- a/man/rforcecom.login.Rd +++ b/man/rforcecom.login.Rd @@ -3,7 +3,7 @@ \name{rforcecom.login} \alias{rforcecom.login} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.login}}} +\code{RForcecom::rforcecom.login}} \usage{ rforcecom.login( username, diff --git a/man/rforcecom.query.Rd b/man/rforcecom.query.Rd index da499a38..18c42f0c 100644 --- a/man/rforcecom.query.Rd +++ b/man/rforcecom.query.Rd @@ -3,14 +3,14 @@ \name{rforcecom.query} \alias{rforcecom.query} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.query}}} +\code{RForcecom::rforcecom.query}} \usage{ rforcecom.query(session, soqlQuery, queryAll = FALSE) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.retrieve.Rd b/man/rforcecom.retrieve.Rd index 732bcb09..701e2dc1 100644 --- a/man/rforcecom.retrieve.Rd +++ b/man/rforcecom.retrieve.Rd @@ -3,7 +3,7 @@ \name{rforcecom.retrieve} \alias{rforcecom.retrieve} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.retrieve}}} +\code{RForcecom::rforcecom.retrieve}} \usage{ rforcecom.retrieve( session, @@ -20,7 +20,7 @@ rforcecom.retrieve( \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.search.Rd b/man/rforcecom.search.Rd index c97d9e56..8ab73500 100644 --- a/man/rforcecom.search.Rd +++ b/man/rforcecom.search.Rd @@ -3,14 +3,14 @@ \name{rforcecom.search} \alias{rforcecom.search} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.search}}} +\code{RForcecom::rforcecom.search}} \usage{ rforcecom.search(session, queryString) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.update.Rd b/man/rforcecom.update.Rd index 0d96ad4e..778cf150 100644 --- a/man/rforcecom.update.Rd +++ b/man/rforcecom.update.Rd @@ -3,14 +3,14 @@ \name{rforcecom.update} \alias{rforcecom.update} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.update}}} +\code{RForcecom::rforcecom.update}} \usage{ rforcecom.update(session, objectName, id, fields) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} diff --git a/man/rforcecom.upsert.Rd b/man/rforcecom.upsert.Rd index 0d866970..9ad6a809 100644 --- a/man/rforcecom.upsert.Rd +++ b/man/rforcecom.upsert.Rd @@ -3,14 +3,14 @@ \name{rforcecom.upsert} \alias{rforcecom.upsert} \title{The \code{salesforcer} backwards compatible version of -\code{\link[RForcecom]{rforcecom.upsert}}} +\code{RForcecom::rforcecom.upsert}} \usage{ rforcecom.upsert(session, objectName, externalIdField, externalId, fields) } \arguments{ \item{session}{\code{list}; a list containing \code{"sessionID"}, \code{"instanceURL"}, and \code{"apiVersion"} as returned by -\code{\link[RForcecom]{rforcecom.login}}. This argument is ignored in all +\code{RForcecom::rforcecom.login}. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} From bdb294168e4a850fb302549b61ffeb0ae28aac0e Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 15:38:26 -0500 Subject: [PATCH 02/42] Remove RForcecom Dependency Remove RForcecom from roxygen documentation and from the Suggests packages. Later we may need to remove from vignettes. Closes #97 --- NEWS.md | 3 ++- R/auth.R | 34 +++++++++++++++++++++++++++++----- man/sf_auth.Rd | 38 +++++++++++++++++++++++++++++++++----- 3 files changed, 64 insertions(+), 11 deletions(-) diff --git a/NEWS.md b/NEWS.md index 275bfea7..f1ecf10d 100644 --- a/NEWS.md +++ b/NEWS.md @@ -7,7 +7,8 @@ ### Features - * None yet. + * Improve documentation to retrieve the access token or session ID after + authentication (#97) ### Bug fixes diff --git a/R/auth.R b/R/auth.R index 8ee3091c..3d3d13f6 100644 --- a/R/auth.R +++ b/R/auth.R @@ -34,7 +34,7 @@ #' @description #' `r lifecycle::badge("stable")` #' -#' Log in using Basic (Username-Password) or OAuth 2.0 authenticaion. OAuth does +#' Log in using Basic (Username-Password) or OAuth 2.0 authentication. OAuth does #' not require sharing passwords, but will require authorizing \code{salesforcer} #' as a connected app to view and manage your organization. You will be directed to #' a web browser, asked to sign in to your Salesforce account, and to grant \code{salesforcer} @@ -58,6 +58,31 @@ #' @param cache \code{logical} or \code{character}; TRUE means to cache using #' the default cache file \code{.httr-oauth-salesforcer}, FALSE means do not #' cache. A string means use the specified path as the cache file. +#' @return \code{list} invisibly that contains 4 elements detailing the authentication state +#' @note The \code{link{sf_auth}} function invisibly returns the following +#' 4 pieces of information which can be reused in other operations: +#' \describe{ +#' \item{auth_method}{ +#' \code{character}; One of two options 'Basic' or 'OAuth'. If a username, +#' password, and security token were supplied, then this would result in +#' 'Basic' authentication. +#' } +#' \item{token}{ +#' \code{Token2.0}; The object returned by \code{\link[httr]{oauth2.0_token}}. +#' This value is \code{NULL} if \code{auth_method='Basic'}. +#' } +#' \item{session_id}{ +#' \code{character}; A unique ID associated with this user session. The session +#' ID is obtained from the X-SFDC-Session header fetched with SOAP API's login() +#' call. This value is \code{NULL} if \code{auth_method='OAuth'}. +#' } +#' \item{instance_url}{ +#' \code{character}; The domain address of the server that your Salesforce org +#' is on and where subsequent API calls will be directed to. For example, +#' \code{https://na21.salesforce.com} refers to an org located on the 'NA21' +#' server instance located in Chicago, USA / Washington DC, USA per this +#' Knowledge Article: \url{https://help.salesforce.com/articleView?id=000314281}. +#' } #' @template verbose #' @examples #' \dontrun{ @@ -66,15 +91,14 @@ #' password = "test_password", #' security_token = "test_token") #' -#' # log in using OAuth 2.0 -#' # Via brower or refresh of .httr-oauth-salesforcer +#' # log in using OAuth 2.0 (via browser or cached .httr-oauth-salesforcer) #' sf_auth() #' #' # log in to a Sandbox environment #' # Via brower or refresh of .httr-oauth-salesforcer #' sf_auth(login_url = "https://test.salesforce.com") #' -#' # Save token and log in using it +#' # Save token to disk and log in using it #' saveRDS(salesforcer_state()$token, "token.rds") #' sf_auth(token = "token.rds") #' } @@ -368,7 +392,7 @@ token_available <- function(verbose = TRUE) { #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export -sf_access_token <- function(verbose = FALSE) { +sf_access_token <- function(verbose = TRUE) { if (!token_available(verbose = verbose)) return(NULL) .state$token$credentials$access_token } diff --git a/man/sf_auth.Rd b/man/sf_auth.Rd index 5d1a03b5..8d206f7f 100644 --- a/man/sf_auth.Rd +++ b/man/sf_auth.Rd @@ -45,16 +45,45 @@ detail for each API call, which is useful for debugging. More specifically, when set to \code{TRUE} the URL, header, and body will be printed for each request, along with additional diagnostic information where available.} } +\value{ +\code{list} invisibly that contains 4 elements detailing the authentication state +} \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} -Log in using Basic (Username-Password) or OAuth 2.0 authenticaion. OAuth does +Log in using Basic (Username-Password) or OAuth 2.0 authentication. OAuth does not require sharing passwords, but will require authorizing \code{salesforcer} as a connected app to view and manage your organization. You will be directed to a web browser, asked to sign in to your Salesforce account, and to grant \code{salesforcer} permission to operate on your behalf. By default, these user credentials are cached in a file named \code{.httr-oauth-salesforcer} in the current working directory. } +\note{ +The \code{link{sf_auth}} function invisibly returns the following +4 pieces of information which can be reused in other operations: +\describe{ +\item{auth_method}{ +\code{character}; One of two options 'Basic' or 'OAuth'. If a username, +password, and security token were supplied, then this would result in +'Basic' authentication. +} +\item{token}{ +\code{Token2.0}; The object returned by \code{\link[httr]{oauth2.0_token}}. +This value is \code{NULL} if \code{auth_method='Basic'}. +} +\item{session_id}{ +\code{character}; A unique ID associated with this user session. The session +ID is obtained from the X-SFDC-Session header fetched with SOAP API's login() +call. This value is \code{NULL} if \code{auth_method='OAuth'}. +} +\item{instance_url}{ +\code{character}; The domain address of the server that your Salesforce org +is on and where subsequent API calls will be directed to. For example, +\code{https://na21.salesforce.com} refers to an org located on the 'NA21' +server instance located in Chicago, USA / Washington DC, USA per this +Knowledge Article: \url{https://help.salesforce.com/articleView?id=000314281}. +} +} \examples{ \dontrun{ # log in using basic authentication (username-password) @@ -62,15 +91,14 @@ sf_auth(username = "test@gmail.com", password = "test_password", security_token = "test_token") -# log in using OAuth 2.0 -# Via brower or refresh of .httr-oauth-salesforcer +# log in using OAuth 2.0 (via browser or cached .httr-oauth-salesforcer) sf_auth() # log in to a Sandbox environment # Via brower or refresh of .httr-oauth-salesforcer sf_auth(login_url = "https://test.salesforce.com") -# Save token and log in using it +# Save token to disk and log in using it saveRDS(salesforcer_state()$token, "token.rds") sf_auth(token = "token.rds") } From c0db731a82c854e9e19fd57816a8eee4438cff8f Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 15:39:53 -0500 Subject: [PATCH 03/42] Fix Bug in Parsing OwnerChangeOptions Closes #94 --- NEWS.md | 4 ++-- R/utils-xml.R | 26 ++++++++++++++++++++------ tests/testthat/test-soap.R | 11 ++++++++++- 3 files changed, 32 insertions(+), 9 deletions(-) diff --git a/NEWS.md b/NEWS.md index f1ecf10d..e29d0d1d 100644 --- a/NEWS.md +++ b/NEWS.md @@ -3,7 +3,7 @@ ### Dependencies * Remove references to RForcecom after it was removed from CRAN on 6/9/2021 (#101) - * Remove LazyData option in DESCRIPTION since `data()` is not utilized. + * Remove LazyData option in DESCRIPTION since `data()` is not utilized ### Features @@ -12,7 +12,7 @@ ### Bug fixes - * None yet. + * Fixed the format of the `OwnerChangeOptions` header so it is accepted (#94) --- diff --git a/R/utils-xml.R b/R/utils-xml.R index 12269d53..4d83c64c 100644 --- a/R/utils-xml.R +++ b/R/utils-xml.R @@ -138,12 +138,26 @@ make_soap_xml_skeleton <- function(soap_headers=list(), metadata_ns=FALSE){ if(length(soap_headers)>0){ for(i in 1:length(soap_headers)){ - opt_node <- newXMLNode(paste0(ns_prefix, ":", names(soap_headers)[i]), - parent=header_node) - for(j in 1:length(soap_headers[[i]])){ - this_node <- newXMLNode(paste0(ns_prefix, ":", names(soap_headers[[i]])[j]), - as.character(soap_headers[[i]][[j]]), - parent=opt_node) + option_name <- names(soap_headers)[i] + opt_node <- newXMLNode(paste0(ns_prefix, ":", option_name), parent=header_node) + # process OwnerChangeOptions differently because it can be a list of multiple + # different options all put under the OwnerChangeOptions node + if (option_name == "OwnerChangeOptions"){ + options_spec <- soap_headers[[i]]$options + for(j in 1:length(options_spec)){ + this_node <- newXMLNode(paste0(ns_prefix, ":", "options"), parent=opt_node) + for(k in 1:length(options_spec[[j]])){ + this_node2 <- newXMLNode(paste0(ns_prefix, ":", names(options_spec[[j]])[k]), + as.character(options_spec[[j]][[k]]), + parent=this_node) + } + } + } else { + for(j in 1:length(soap_headers[[i]])){ + this_node <- newXMLNode(paste0(ns_prefix, ":", names(soap_headers[[i]])[j]), + as.character(soap_headers[[i]][[j]]), + parent=opt_node) + } } } } diff --git a/tests/testthat/test-soap.R b/tests/testthat/test-soap.R index 82b4e89a..4fbc2b94 100644 --- a/tests/testthat/test-soap.R +++ b/tests/testthat/test-soap.R @@ -102,7 +102,16 @@ test_that("testing SOAP API Functionality", { mutate(FirstName = "TestTest") # sf_update ------------------------------------------------------------------ - updated_records <- sf_update(queried_records, object_name=object, api_type="SOAP") + updated_records <- sf_update( + queried_records, object_name=object, api_type="SOAP", + # test syntax for this control argument alongside the function + OwnerChangeOptions = list( + options = list( + list(execute = TRUE, type = "TransferNotesAndAttachments"), + list(execute = TRUE, type = "TransferOpenActivities") + ) + ), + ) expect_is(updated_records, "tbl_df") expect_equal(names(updated_records), c("id", "success")) expect_equal(nrow(updated_records), n) From 9cdbd2d1f672917956f87ae9fbc9b41ae504acde Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 15:40:41 -0500 Subject: [PATCH 04/42] Update Display of Lifecycle tags in Documentation --- man/rforcecom.bulkAction.Rd | 2 +- man/rforcecom.bulkQuery.Rd | 2 +- man/rforcecom.create.Rd | 2 +- man/rforcecom.delete.Rd | 2 +- man/rforcecom.getObjectDescription.Rd | 2 +- man/rforcecom.getServerTimestamp.Rd | 2 +- man/rforcecom.login.Rd | 2 +- man/rforcecom.query.Rd | 2 +- man/rforcecom.retrieve.Rd | 2 +- man/rforcecom.search.Rd | 2 +- man/rforcecom.update.Rd | 2 +- man/rforcecom.upsert.Rd | 2 +- man/sf_access_token.Rd | 2 +- man/sf_analytics_notification_create.Rd | 2 +- man/sf_analytics_notification_delete.Rd | 2 +- man/sf_analytics_notification_describe.Rd | 2 +- man/sf_analytics_notification_update.Rd | 2 +- man/sf_analytics_notifications_limits.Rd | 2 +- man/sf_analytics_notifications_list.Rd | 2 +- man/sf_convert_lead.Rd | 2 +- man/sf_copy_report.Rd | 2 +- man/sf_create.Rd | 2 +- man/sf_create_attachment.Rd | 2 +- man/sf_create_metadata.Rd | 2 +- man/sf_create_report.Rd | 2 +- man/sf_dashboard_components_describe.Rd | 2 +- man/sf_dashboard_copy.Rd | 2 +- man/sf_dashboard_delete.Rd | 2 +- man/sf_dashboard_describe.Rd | 2 +- man/sf_dashboard_filter_operators_list.Rd | 2 +- man/sf_dashboard_filter_options_analysis.Rd | 2 +- man/sf_dashboard_refresh.Rd | 2 +- man/sf_dashboard_results.Rd | 2 +- man/sf_dashboard_set_sticky_filter.Rd | 2 +- man/sf_dashboard_status.Rd | 2 +- man/sf_dashboard_update.Rd | 2 +- man/sf_dashboards_list.Rd | 2 +- man/sf_delete.Rd | 2 +- man/sf_delete_attachment.Rd | 2 +- man/sf_delete_metadata.Rd | 2 +- man/sf_delete_report.Rd | 2 +- man/sf_delete_report_instance.Rd | 2 +- man/sf_describe_metadata.Rd | 2 +- man/sf_describe_object_fields.Rd | 2 +- man/sf_describe_objects.Rd | 2 +- man/sf_describe_report.Rd | 2 +- man/sf_describe_report_type.Rd | 2 +- man/sf_download_attachment.Rd | 2 +- man/sf_empty_recycle_bin.Rd | 2 +- man/sf_execute_report.Rd | 2 +- man/sf_find_duplicates.Rd | 2 +- man/sf_find_duplicates_by_id.Rd | 2 +- man/sf_get_dashboard_data.Rd | 2 +- man/sf_get_deleted.Rd | 2 +- man/sf_get_report_instance_results.Rd | 2 +- man/sf_get_updated.Rd | 2 +- man/sf_list_api_limits.Rd | 2 +- man/sf_list_metadata.Rd | 2 +- man/sf_list_objects.Rd | 2 +- man/sf_list_report_fields.Rd | 2 +- man/sf_list_report_filter_operators.Rd | 2 +- man/sf_list_report_instances.Rd | 2 +- man/sf_list_report_types.Rd | 2 +- man/sf_list_reports.Rd | 2 +- man/sf_list_resources.Rd | 2 +- man/sf_list_rest_api_versions.Rd | 2 +- man/sf_merge.Rd | 2 +- man/sf_query.Rd | 2 +- man/sf_query_report.Rd | 2 +- man/sf_read_metadata.Rd | 2 +- man/sf_rename_metadata.Rd | 2 +- man/sf_report_folder_children.Rd | 2 +- man/sf_report_folder_create.Rd | 2 +- man/sf_report_folder_delete.Rd | 2 +- man/sf_report_folder_describe.Rd | 2 +- man/sf_report_folder_share_delete.Rd | 2 +- man/sf_report_folder_share_describe.Rd | 2 +- man/sf_report_folder_share_recipients.Rd | 2 +- man/sf_report_folder_share_update.Rd | 2 +- man/sf_report_folder_shares_add.Rd | 2 +- man/sf_report_folder_shares_list.Rd | 2 +- man/sf_report_folder_shares_update.Rd | 2 +- man/sf_report_folder_update.Rd | 2 +- man/sf_report_folders_list.Rd | 2 +- man/sf_reset_password.Rd | 2 +- man/sf_retrieve.Rd | 2 +- man/sf_retrieve_metadata.Rd | 2 +- man/sf_retrieve_metadata_check_status.Rd | 2 +- man/sf_run_bulk_operation.Rd | 2 +- man/sf_run_bulk_query.Rd | 2 +- man/sf_run_report.Rd | 2 +- man/sf_search.Rd | 2 +- man/sf_server_timestamp.Rd | 2 +- man/sf_set_password.Rd | 2 +- man/sf_undelete.Rd | 2 +- man/sf_update.Rd | 2 +- man/sf_update_attachment.Rd | 2 +- man/sf_update_metadata.Rd | 2 +- man/sf_update_report.Rd | 2 +- man/sf_upsert.Rd | 2 +- man/sf_upsert_metadata.Rd | 2 +- man/sf_user_info.Rd | 2 +- 102 files changed, 102 insertions(+), 102 deletions(-) diff --git a/man/rforcecom.bulkAction.Rd b/man/rforcecom.bulkAction.Rd index e9ff2067..9c1c3ea2 100644 --- a/man/rforcecom.bulkAction.Rd +++ b/man/rforcecom.bulkAction.Rd @@ -54,7 +54,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} of the results of the bulk job } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} This function is a convenience wrapper for submitting bulk API jobs } diff --git a/man/rforcecom.bulkQuery.Rd b/man/rforcecom.bulkQuery.Rd index 329ac934..1e2450c4 100644 --- a/man/rforcecom.bulkQuery.Rd +++ b/man/rforcecom.bulkQuery.Rd @@ -41,5 +41,5 @@ along with additional diagnostic information where available.} A \code{data.frame} of the recordset returned by query } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.create.Rd b/man/rforcecom.create.Rd index c26ea288..e0db5450 100644 --- a/man/rforcecom.create.Rd +++ b/man/rforcecom.create.Rd @@ -24,5 +24,5 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} \code{data.frame} containing the id and success indicator of the record creation process } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.delete.Rd b/man/rforcecom.delete.Rd index 085051ed..031d365a 100644 --- a/man/rforcecom.delete.Rd +++ b/man/rforcecom.delete.Rd @@ -24,5 +24,5 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} \code{NULL} if successful otherwise the function errors out } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.getObjectDescription.Rd b/man/rforcecom.getObjectDescription.Rd index c3b3c8c0..33628494 100644 --- a/man/rforcecom.getObjectDescription.Rd +++ b/man/rforcecom.getObjectDescription.Rd @@ -22,7 +22,7 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} Object descriptions } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } \note{ This function returns a data.frame with one row per field for an object. diff --git a/man/rforcecom.getServerTimestamp.Rd b/man/rforcecom.getServerTimestamp.Rd index efa72eec..2cb5483b 100644 --- a/man/rforcecom.getServerTimestamp.Rd +++ b/man/rforcecom.getServerTimestamp.Rd @@ -16,5 +16,5 @@ in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.} } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.login.Rd b/man/rforcecom.login.Rd index a44360d6..0c063fde 100644 --- a/man/rforcecom.login.Rd +++ b/man/rforcecom.login.Rd @@ -27,5 +27,5 @@ rforcecom.login( \item{apiVersion}{API Version.} } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.query.Rd b/man/rforcecom.query.Rd index 18c42f0c..1d199411 100644 --- a/man/rforcecom.query.Rd +++ b/man/rforcecom.query.Rd @@ -25,5 +25,5 @@ deleted and archived records (available only when querying Task and Event record Result dataset. } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.retrieve.Rd b/man/rforcecom.retrieve.Rd index 701e2dc1..3538d336 100644 --- a/man/rforcecom.retrieve.Rd +++ b/man/rforcecom.retrieve.Rd @@ -48,5 +48,5 @@ list in first. This parameter works when order parameter has been set. (Default: FALSE)} } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.search.Rd b/man/rforcecom.search.Rd index 8ab73500..53fa634e 100644 --- a/man/rforcecom.search.Rd +++ b/man/rforcecom.search.Rd @@ -18,5 +18,5 @@ necessary to pass the session in each function call.} \item{queryString}{Query strings to search. (ex: "United", "Electoronics")} } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.update.Rd b/man/rforcecom.update.Rd index 778cf150..ed57d26c 100644 --- a/man/rforcecom.update.Rd +++ b/man/rforcecom.update.Rd @@ -26,5 +26,5 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} \code{NULL} if successful otherwise the function errors out } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/rforcecom.upsert.Rd b/man/rforcecom.upsert.Rd index 9ad6a809..3f6129ba 100644 --- a/man/rforcecom.upsert.Rd +++ b/man/rforcecom.upsert.Rd @@ -28,5 +28,5 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} \code{NULL} if successful otherwise the function errors out } \description{ -\ifelse{html}{\figure{lifecycle-soft-deprecated.svg}{options: alt='Soft-deprecated lifecycle'}}{\strong{Soft-deprecated}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#soft-deprecated}{\figure{lifecycle-soft-deprecated.svg}{options: alt='[Soft-deprecated]'}}}{\strong{[Soft-deprecated]}} } diff --git a/man/sf_access_token.Rd b/man/sf_access_token.Rd index 6aca5a43..75c883c4 100644 --- a/man/sf_access_token.Rd +++ b/man/sf_access_token.Rd @@ -4,7 +4,7 @@ \alias{sf_access_token} \title{Return access_token attribute of OAuth 2.0 Token} \usage{ -sf_access_token(verbose = FALSE) +sf_access_token(verbose = TRUE) } \arguments{ \item{verbose}{\code{logical}; an indicator of whether to print additional diff --git a/man/sf_analytics_notification_create.Rd b/man/sf_analytics_notification_create.Rd index dff3fd6d..beb33c02 100644 --- a/man/sf_analytics_notification_create.Rd +++ b/man/sf_analytics_notification_create.Rd @@ -17,5 +17,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_analytics_notification_delete.Rd b/man/sf_analytics_notification_delete.Rd index f655f3d7..e2236ddc 100644 --- a/man/sf_analytics_notification_delete.Rd +++ b/man/sf_analytics_notification_delete.Rd @@ -14,5 +14,5 @@ analytics notification. It will start with \code{"0Au"}.} \code{logical} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_analytics_notification_describe.Rd b/man/sf_analytics_notification_describe.Rd index 1c1a18f5..e5355558 100644 --- a/man/sf_analytics_notification_describe.Rd +++ b/man/sf_analytics_notification_describe.Rd @@ -14,5 +14,5 @@ analytics notification. It will start with \code{"0Au"}.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_analytics_notification_update.Rd b/man/sf_analytics_notification_update.Rd index dc297efe..fa7c130d 100644 --- a/man/sf_analytics_notification_update.Rd +++ b/man/sf_analytics_notification_update.Rd @@ -20,5 +20,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_analytics_notifications_limits.Rd b/man/sf_analytics_notifications_limits.Rd index d79e5c3d..f62239b2 100644 --- a/man/sf_analytics_notifications_limits.Rd +++ b/man/sf_analytics_notifications_limits.Rd @@ -29,5 +29,5 @@ reference Ids start with "0FK").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_analytics_notifications_list.Rd b/man/sf_analytics_notifications_list.Rd index 4903c04c..8a21e9d8 100644 --- a/man/sf_analytics_notifications_list.Rd +++ b/man/sf_analytics_notifications_list.Rd @@ -34,5 +34,5 @@ reference Ids start with "0FK").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_convert_lead.Rd b/man/sf_convert_lead.Rd index e08c5234..73385b16 100644 --- a/man/sf_convert_lead.Rd +++ b/man/sf_convert_lead.Rd @@ -45,7 +45,7 @@ along with additional diagnostic information where available.} \code{tbl_df} with details of the converted record } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Converts Leads each into an Account, Contact, as well as (optionally) an Opportunity. } diff --git a/man/sf_copy_report.Rd b/man/sf_copy_report.Rd index d54e9162..f8fee54d 100644 --- a/man/sf_copy_report.Rd +++ b/man/sf_copy_report.Rd @@ -32,7 +32,7 @@ joined metadata.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Creates a copy of a custom, standard, or public report by sending a POST request to the Report List resource. diff --git a/man/sf_create.Rd b/man/sf_create.Rd index a04043a3..80877562 100644 --- a/man/sf_create.Rd +++ b/man/sf_create.Rd @@ -54,7 +54,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Adds one or more new records to your organization’s data. } diff --git a/man/sf_create_attachment.Rd b/man/sf_create_attachment.Rd index 7fcae9ae..a223bfb8 100644 --- a/man/sf_create_attachment.Rd +++ b/man/sf_create_attachment.Rd @@ -45,7 +45,7 @@ along with additional diagnostic information where available.} \code{tbl_df} with details of the created records } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function will allow you to create attachments (and other blob data, such as Documents) by supplying file paths (absolute or relative) to media that you diff --git a/man/sf_create_metadata.Rd b/man/sf_create_metadata.Rd index a5f7fa33..48566488 100644 --- a/man/sf_create_metadata.Rd +++ b/man/sf_create_metadata.Rd @@ -37,7 +37,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} containing the creation result for each submitted metadata component } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a list of Metadata components and sends them to Salesforce for creation diff --git a/man/sf_create_report.Rd b/man/sf_create_report.Rd index cbce7fe3..d756095c 100644 --- a/man/sf_create_report.Rd +++ b/man/sf_create_report.Rd @@ -43,7 +43,7 @@ joined metadata.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Create a new report using a POST request. To create a report, you only have to specify a name and report type to create a new report; all other metadata properties diff --git a/man/sf_dashboard_components_describe.Rd b/man/sf_dashboard_components_describe.Rd index f6b0a7cc..a22dc9f2 100644 --- a/man/sf_dashboard_components_describe.Rd +++ b/man/sf_dashboard_components_describe.Rd @@ -17,5 +17,5 @@ dashboard component.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_copy.Rd b/man/sf_dashboard_copy.Rd index cef8d2df..cefd7c68 100644 --- a/man/sf_dashboard_copy.Rd +++ b/man/sf_dashboard_copy.Rd @@ -17,5 +17,5 @@ analytics folder (it will start with "00l").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_delete.Rd b/man/sf_dashboard_delete.Rd index dc262fab..f496e2be 100644 --- a/man/sf_dashboard_delete.Rd +++ b/man/sf_dashboard_delete.Rd @@ -14,5 +14,5 @@ dashboard. It will start with \code{"01Z"}.} \code{logical} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_describe.Rd b/man/sf_dashboard_describe.Rd index 43ddc7c5..9abe8dd4 100644 --- a/man/sf_dashboard_describe.Rd +++ b/man/sf_dashboard_describe.Rd @@ -22,7 +22,7 @@ along with additional diagnostic information where available.} \code{list} or \code{tbl_df} depending on the value of argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Returns metadata for the specified dashboard, including dashboard components, filters, layout, and the running user. diff --git a/man/sf_dashboard_filter_operators_list.Rd b/man/sf_dashboard_filter_operators_list.Rd index 6d90e41c..d77455e3 100644 --- a/man/sf_dashboard_filter_operators_list.Rd +++ b/man/sf_dashboard_filter_operators_list.Rd @@ -10,5 +10,5 @@ sf_dashboard_filter_operators_list() \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_filter_options_analysis.Rd b/man/sf_dashboard_filter_options_analysis.Rd index 1ab3addb..56d97acf 100644 --- a/man/sf_dashboard_filter_options_analysis.Rd +++ b/man/sf_dashboard_filter_options_analysis.Rd @@ -25,5 +25,5 @@ Each object has these properties:...} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_refresh.Rd b/man/sf_dashboard_refresh.Rd index d1d4bb50..82d96b1d 100644 --- a/man/sf_dashboard_refresh.Rd +++ b/man/sf_dashboard_refresh.Rd @@ -19,5 +19,5 @@ from the dashboard metadata using \link{sf_dashboard_describe}.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_results.Rd b/man/sf_dashboard_results.Rd index 095857e3..966eda55 100644 --- a/man/sf_dashboard_results.Rd +++ b/man/sf_dashboard_results.Rd @@ -28,7 +28,7 @@ from the dashboard metadata using \link{sf_dashboard_describe}.} \code{tbl_df} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function allows for pulling specific data from a dashboard. There is a convenience function (\link{sf_get_dashboard_data}) to get the dashboard data diff --git a/man/sf_dashboard_set_sticky_filter.Rd b/man/sf_dashboard_set_sticky_filter.Rd index ab830c82..9d1a164b 100644 --- a/man/sf_dashboard_set_sticky_filter.Rd +++ b/man/sf_dashboard_set_sticky_filter.Rd @@ -22,7 +22,7 @@ from the dashboard metadata using \link{sf_dashboard_describe}.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Set a default filter value which gets applied to a dashboard when you open it. The default filter value you specify only applies to you (other people diff --git a/man/sf_dashboard_status.Rd b/man/sf_dashboard_status.Rd index ef54c353..49463da4 100644 --- a/man/sf_dashboard_status.Rd +++ b/man/sf_dashboard_status.Rd @@ -28,5 +28,5 @@ from the dashboard metadata using \link{sf_dashboard_describe}.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboard_update.Rd b/man/sf_dashboard_update.Rd index e407a6b5..d9127908 100644 --- a/man/sf_dashboard_update.Rd +++ b/man/sf_dashboard_update.Rd @@ -20,5 +20,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_dashboards_list.Rd b/man/sf_dashboards_list.Rd index 1454dfff..17bf3ede 100644 --- a/man/sf_dashboards_list.Rd +++ b/man/sf_dashboards_list.Rd @@ -19,7 +19,7 @@ along with additional diagnostic information where available.} \code{list} or \code{tbl_df} depending on the value of argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Returns a list of recently used dashboards } diff --git a/man/sf_delete.Rd b/man/sf_delete.Rd index 3781aba6..21b63d21 100644 --- a/man/sf_delete.Rd +++ b/man/sf_delete.Rd @@ -53,7 +53,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Deletes one or more records from your organization’s data. } diff --git a/man/sf_delete_attachment.Rd b/man/sf_delete_attachment.Rd index 0c55d148..ed8e2ca8 100644 --- a/man/sf_delete_attachment.Rd +++ b/man/sf_delete_attachment.Rd @@ -36,7 +36,7 @@ along with additional diagnostic information where available.} \code{tbl_df} with details of the deleted records } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function is a wrapper around \code{\link{sf_delete}} that accepts a list of Ids and assumes that they are in the Attachment object and should be deleted. diff --git a/man/sf_delete_metadata.Rd b/man/sf_delete_metadata.Rd index a87c0f6e..5bc61fb1 100644 --- a/man/sf_delete_metadata.Rd +++ b/man/sf_delete_metadata.Rd @@ -36,7 +36,7 @@ along with additional diagnostic information where available.} A \code{data.frame} containing the creation result for each submitted metadata component } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a request of named elements in Salesforce and deletes them. } diff --git a/man/sf_delete_report.Rd b/man/sf_delete_report.Rd index 8987aab5..aaa2e6e0 100644 --- a/man/sf_delete_report.Rd +++ b/man/sf_delete_report.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} will return \code{TRUE} if successful in deleting the report. } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Delete a report by sending a DELETE request to the Report resource. Deleted reports are moved to the Recycle Bin. diff --git a/man/sf_delete_report_instance.Rd b/man/sf_delete_report_instance.Rd index 4cc8ee66..4d55f3fa 100644 --- a/man/sf_delete_report_instance.Rd +++ b/man/sf_delete_report_instance.Rd @@ -24,7 +24,7 @@ along with additional diagnostic information where available.} will return \code{TRUE} if successful in deleting the report instance. } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} If the given report instance has a status of \code{Success} or \code{Error}, delete the report instance. diff --git a/man/sf_describe_metadata.Rd b/man/sf_describe_metadata.Rd index 470af7c8..5eede609 100644 --- a/man/sf_describe_metadata.Rd +++ b/man/sf_describe_metadata.Rd @@ -16,7 +16,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function returns details about the organization metadata } diff --git a/man/sf_describe_object_fields.Rd b/man/sf_describe_object_fields.Rd index 7eff2c3c..5879f1f5 100644 --- a/man/sf_describe_object_fields.Rd +++ b/man/sf_describe_object_fields.Rd @@ -14,7 +14,7 @@ function is operating against (e.g. "Account", "Contact", "CustomObject__c").} A \code{tbl_df} containing one row per field for the requested object. } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} This function takes the name of an object in Salesforce and returns a description of the fields on that object by returning a tibble with one row per field. diff --git a/man/sf_describe_objects.Rd b/man/sf_describe_objects.Rd index acaed377..68083e0d 100644 --- a/man/sf_describe_objects.Rd +++ b/man/sf_describe_objects.Rd @@ -35,7 +35,7 @@ along with additional diagnostic information where available.} \code{list} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Describes the individual metadata for the specified object. } diff --git a/man/sf_describe_report.Rd b/man/sf_describe_report.Rd index ee50d674..74134b7c 100644 --- a/man/sf_describe_report.Rd +++ b/man/sf_describe_report.Rd @@ -25,7 +25,7 @@ along with additional diagnostic information where available.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Retrieves report, report type, and related metadata for a tabular, summary, or matrix report. diff --git a/man/sf_describe_report_type.Rd b/man/sf_describe_report_type.Rd index 2206f4ba..8ab7dccb 100644 --- a/man/sf_describe_report_type.Rd +++ b/man/sf_describe_report_type.Rd @@ -30,7 +30,7 @@ joined metadata.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Return metadata about a report type. } diff --git a/man/sf_download_attachment.Rd b/man/sf_download_attachment.Rd index ca4bec25..6112f6ca 100644 --- a/man/sf_download_attachment.Rd +++ b/man/sf_download_attachment.Rd @@ -38,7 +38,7 @@ to the current directory.} content } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} This function will allow you to download an attachment to disk based on the attachment body, file name, and path. diff --git a/man/sf_empty_recycle_bin.Rd b/man/sf_empty_recycle_bin.Rd index 486a7106..6c046b99 100644 --- a/man/sf_empty_recycle_bin.Rd +++ b/man/sf_empty_recycle_bin.Rd @@ -24,7 +24,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Delete records from the recycle bin immediately and permanently. } diff --git a/man/sf_execute_report.Rd b/man/sf_execute_report.Rd index 46fa4c2f..ec260fc8 100644 --- a/man/sf_execute_report.Rd +++ b/man/sf_execute_report.Rd @@ -84,7 +84,7 @@ which means that the content from the API is converted from JSON to a list with no other post-processing. } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Get summary data with or without details by running a report synchronously or asynchronously through the API. When you run a report, the API returns data diff --git a/man/sf_find_duplicates.Rd b/man/sf_find_duplicates.Rd index f50e3577..fb62865d 100644 --- a/man/sf_find_duplicates.Rd +++ b/man/sf_find_duplicates.Rd @@ -40,7 +40,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records found to be duplicates by the match rules } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Performs rule-based searches for duplicate records. } diff --git a/man/sf_find_duplicates_by_id.Rd b/man/sf_find_duplicates_by_id.Rd index d8b825c2..6453eac6 100644 --- a/man/sf_find_duplicates_by_id.Rd +++ b/man/sf_find_duplicates_by_id.Rd @@ -36,7 +36,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records found to be duplicates by the match rules } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Performs rule-based searches for duplicate records. } diff --git a/man/sf_get_dashboard_data.Rd b/man/sf_get_dashboard_data.Rd index a37a953f..5f6b4119 100644 --- a/man/sf_get_dashboard_data.Rd +++ b/man/sf_get_dashboard_data.Rd @@ -28,5 +28,5 @@ from the dashboard metadata using \link{sf_dashboard_describe}.} \code{tbl_df} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_get_deleted.Rd b/man/sf_get_deleted.Rd index eb972b8c..d01f4e6c 100644 --- a/man/sf_get_deleted.Rd +++ b/man/sf_get_deleted.Rd @@ -22,7 +22,7 @@ set to \code{TRUE} the URL, header, and body will be printed for each request, along with additional diagnostic information where available.} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Retrieves the list of individual records that have been deleted within the given timespan for the specified object. diff --git a/man/sf_get_report_instance_results.Rd b/man/sf_get_report_instance_results.Rd index 5638dbee..8e6f456a 100644 --- a/man/sf_get_report_instance_results.Rd +++ b/man/sf_get_report_instance_results.Rd @@ -59,7 +59,7 @@ along with additional diagnostic information where available.} data from the "T!T" entry in the fact map. } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Retrieves results for an instance of a report run asynchronously with or without filters. Depending on your asynchronous report run request, data can be at the diff --git a/man/sf_get_updated.Rd b/man/sf_get_updated.Rd index dcf11d29..f24182af 100644 --- a/man/sf_get_updated.Rd +++ b/man/sf_get_updated.Rd @@ -22,7 +22,7 @@ set to \code{TRUE} the URL, header, and body will be printed for each request, along with additional diagnostic information where available.} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Retrieves the list of individual records that have been inserted or updated within the given timespan in the specified object. diff --git a/man/sf_list_api_limits.Rd b/man/sf_list_api_limits.Rd index dd20d898..cbbca56d 100644 --- a/man/sf_list_api_limits.Rd +++ b/man/sf_list_api_limits.Rd @@ -10,7 +10,7 @@ sf_list_api_limits() \code{list} } \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} Lists information about limits in your org. } diff --git a/man/sf_list_metadata.Rd b/man/sf_list_metadata.Rd index 6643b804..44507c5f 100644 --- a/man/sf_list_metadata.Rd +++ b/man/sf_list_metadata.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} A \code{tbl_dfs} containing the queried metadata types } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a query of metadata types and returns a summary of all objects in salesforce of the requested types diff --git a/man/sf_list_objects.Rd b/man/sf_list_objects.Rd index 59ee307d..bf7e7b41 100644 --- a/man/sf_list_objects.Rd +++ b/man/sf_list_objects.Rd @@ -10,7 +10,7 @@ sf_list_objects() \code{list} } \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} Lists the available objects and their metadata for your organization’s data. } diff --git a/man/sf_list_report_fields.Rd b/man/sf_list_report_fields.Rd index edf4fc29..111b0dc9 100644 --- a/man/sf_list_report_fields.Rd +++ b/man/sf_list_report_fields.Rd @@ -35,7 +35,7 @@ along with additional diagnostic information where available.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} The Report Fields resource returns report fields available for specified reports. Use the resource to determine the best fields for use in dashboard filters by diff --git a/man/sf_list_report_filter_operators.Rd b/man/sf_list_report_filter_operators.Rd index 3948309b..e8921f69 100644 --- a/man/sf_list_report_filter_operators.Rd +++ b/man/sf_list_report_filter_operators.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Use the Filter Operators API to get information about which filter operators are available for reports and dashboards. The Filter Operators API is available in diff --git a/man/sf_list_report_instances.Rd b/man/sf_list_report_instances.Rd index a6754401..29745559 100644 --- a/man/sf_list_report_instances.Rd +++ b/man/sf_list_report_instances.Rd @@ -23,7 +23,7 @@ along with additional diagnostic information where available.} argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Returns a list of instances for a report that you requested to be run asynchronously. Each item in the list is treated as a separate instance of the report run with diff --git a/man/sf_list_report_types.Rd b/man/sf_list_report_types.Rd index 91c6bbb3..1f0bf9d0 100644 --- a/man/sf_list_report_types.Rd +++ b/man/sf_list_report_types.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Return a list of report types. } diff --git a/man/sf_list_reports.Rd b/man/sf_list_reports.Rd index ab0dd086..1d85a29e 100644 --- a/man/sf_list_reports.Rd +++ b/man/sf_list_reports.Rd @@ -28,7 +28,7 @@ along with additional diagnostic information where available.} argument \code{as_tbl} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Displays a list of full list of reports based on the \code{Report} object. If \code{recent} is up to 200 tabular, matrix, or summary reports that you diff --git a/man/sf_list_resources.Rd b/man/sf_list_resources.Rd index 524b3bf7..a7a02183 100644 --- a/man/sf_list_resources.Rd +++ b/man/sf_list_resources.Rd @@ -10,7 +10,7 @@ sf_list_resources() \code{list} } \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} Lists available resources for the specified API version, including resource name and URI. diff --git a/man/sf_list_rest_api_versions.Rd b/man/sf_list_rest_api_versions.Rd index dbdbe316..0398a742 100644 --- a/man/sf_list_rest_api_versions.Rd +++ b/man/sf_list_rest_api_versions.Rd @@ -10,7 +10,7 @@ sf_list_rest_api_versions() \code{list} } \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} Lists summary information about each Salesforce version currently available, including the version, label, and a link to each version\'s root diff --git a/man/sf_merge.Rd b/man/sf_merge.Rd index 4f7dc1cf..a97980c3 100644 --- a/man/sf_merge.Rd +++ b/man/sf_merge.Rd @@ -51,7 +51,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function combines records of the same object type into one of the records, known as the master record. The other records, known as the victim records, will diff --git a/man/sf_query.Rd b/man/sf_query.Rd index 47cd981d..b5c35d97 100644 --- a/man/sf_query.Rd +++ b/man/sf_query.Rd @@ -79,7 +79,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Executes a query against the specified object and returns data that matches the specified criteria. diff --git a/man/sf_query_report.Rd b/man/sf_query_report.Rd index 7a4b68cd..2dbf7701 100644 --- a/man/sf_query_report.Rd +++ b/man/sf_query_report.Rd @@ -38,7 +38,7 @@ along with additional diagnostic information where available.} \code{tbl_df} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Run a report without creating a new report or changing the existing one by making a POST request to the query resource. This allows you to get report data diff --git a/man/sf_read_metadata.Rd b/man/sf_read_metadata.Rd index ee3f44cf..e552b0c7 100644 --- a/man/sf_read_metadata.Rd +++ b/man/sf_read_metadata.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} A \code{list} containing a response for each requested object } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a request of named elements in Salesforce and returns their metadata diff --git a/man/sf_rename_metadata.Rd b/man/sf_rename_metadata.Rd index 95be4816..b28aeca1 100644 --- a/man/sf_rename_metadata.Rd +++ b/man/sf_rename_metadata.Rd @@ -24,7 +24,7 @@ along with additional diagnostic information where available.} A \code{data.frame} containing the creation result for each submitted metadata component } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes an old and new name for a metadata element in Salesforce and applies the new name diff --git a/man/sf_report_folder_children.Rd b/man/sf_report_folder_children.Rd index c212f621..96d14fa9 100644 --- a/man/sf_report_folder_children.Rd +++ b/man/sf_report_folder_children.Rd @@ -16,5 +16,5 @@ page returns. Default is 10.} \item{page}{\code{integer}; integer that indicates which page of results to return.} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_create.Rd b/man/sf_report_folder_create.Rd index 351e635a..e33685fb 100644 --- a/man/sf_report_folder_create.Rd +++ b/man/sf_report_folder_create.Rd @@ -17,5 +17,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_delete.Rd b/man/sf_report_folder_delete.Rd index de5882b5..107de64d 100644 --- a/man/sf_report_folder_delete.Rd +++ b/man/sf_report_folder_delete.Rd @@ -14,5 +14,5 @@ analytics folder (it will start with "00l").} \code{logical} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_describe.Rd b/man/sf_report_folder_describe.Rd index e4914ec2..b7db38b3 100644 --- a/man/sf_report_folder_describe.Rd +++ b/man/sf_report_folder_describe.Rd @@ -14,5 +14,5 @@ analytics folder (it will start with "00l").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_share_delete.Rd b/man/sf_report_folder_share_delete.Rd index 92c29093..87cac864 100644 --- a/man/sf_report_folder_share_delete.Rd +++ b/man/sf_report_folder_share_delete.Rd @@ -17,5 +17,5 @@ analytics folder share (it will start with "004").} \code{logical} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_share_describe.Rd b/man/sf_report_folder_share_describe.Rd index 2f868fea..a5921d8a 100644 --- a/man/sf_report_folder_share_describe.Rd +++ b/man/sf_report_folder_share_describe.Rd @@ -17,5 +17,5 @@ analytics folder share (it will start with "004").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_share_recipients.Rd b/man/sf_report_folder_share_recipients.Rd index f7ab2a04..272c00eb 100644 --- a/man/sf_report_folder_share_recipients.Rd +++ b/man/sf_report_folder_share_recipients.Rd @@ -27,5 +27,5 @@ Default is "" (no restriction).} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_share_update.Rd b/man/sf_report_folder_share_update.Rd index a5b6c49e..b8e4eb75 100644 --- a/man/sf_report_folder_share_update.Rd +++ b/man/sf_report_folder_share_update.Rd @@ -23,5 +23,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_shares_add.Rd b/man/sf_report_folder_shares_add.Rd index 536cedec..b3bba886 100644 --- a/man/sf_report_folder_shares_add.Rd +++ b/man/sf_report_folder_shares_add.Rd @@ -20,7 +20,7 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Creates new shares and appends them to the existing share list for the folder. } diff --git a/man/sf_report_folder_shares_list.Rd b/man/sf_report_folder_shares_list.Rd index 0ca1d15e..81180aee 100644 --- a/man/sf_report_folder_shares_list.Rd +++ b/man/sf_report_folder_shares_list.Rd @@ -14,5 +14,5 @@ analytics folder (it will start with "00l").} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folder_shares_update.Rd b/man/sf_report_folder_shares_update.Rd index 1cee7db0..6acfc6f2 100644 --- a/man/sf_report_folder_shares_update.Rd +++ b/man/sf_report_folder_shares_update.Rd @@ -20,7 +20,7 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Creates new shares to replace the existing shares in the share list for the folder. } diff --git a/man/sf_report_folder_update.Rd b/man/sf_report_folder_update.Rd index e1fd6efe..1646f535 100644 --- a/man/sf_report_folder_update.Rd +++ b/man/sf_report_folder_update.Rd @@ -20,5 +20,5 @@ user-friendly format.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_report_folders_list.Rd b/man/sf_report_folders_list.Rd index 439a972f..bfe13f70 100644 --- a/man/sf_report_folders_list.Rd +++ b/man/sf_report_folders_list.Rd @@ -10,5 +10,5 @@ sf_report_folders_list() \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} } diff --git a/man/sf_reset_password.Rd b/man/sf_reset_password.Rd index 357f27e2..6a1c92c9 100644 --- a/man/sf_reset_password.Rd +++ b/man/sf_reset_password.Rd @@ -24,7 +24,7 @@ along with additional diagnostic information where available.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Changes a user’s password to a temporary, system-generated value. } diff --git a/man/sf_retrieve.Rd b/man/sf_retrieve.Rd index a5a4ae95..9b3ca2f0 100644 --- a/man/sf_retrieve.Rd +++ b/man/sf_retrieve.Rd @@ -52,7 +52,7 @@ along with additional diagnostic information where available.} \code{tibble} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Retrieves one or more new records to your organization’s data. } diff --git a/man/sf_retrieve_metadata.Rd b/man/sf_retrieve_metadata.Rd index d9216159..b40c9f6b 100644 --- a/man/sf_retrieve_metadata.Rd +++ b/man/sf_retrieve_metadata.Rd @@ -35,7 +35,7 @@ along with additional diagnostic information where available.} A \code{list} of details from the created retrieve request } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function makes a request to retrieve metadata as a package XML files that can be modified and later diff --git a/man/sf_retrieve_metadata_check_status.Rd b/man/sf_retrieve_metadata_check_status.Rd index 7edbb0bd..c7705d1f 100644 --- a/man/sf_retrieve_metadata_check_status.Rd +++ b/man/sf_retrieve_metadata_check_status.Rd @@ -30,7 +30,7 @@ along with additional diagnostic information where available.} A \code{list} of the response } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function returns details about an initiated retrieveMetadata request and saves the results into a zip file diff --git a/man/sf_run_bulk_operation.Rd b/man/sf_run_bulk_operation.Rd index b5e9f00b..2c9a271f 100644 --- a/man/sf_run_bulk_operation.Rd +++ b/man/sf_run_bulk_operation.Rd @@ -89,7 +89,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} of the results of the bulk job } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} This function is a convenience wrapper for submitting bulk API jobs } diff --git a/man/sf_run_bulk_query.Rd b/man/sf_run_bulk_query.Rd index 926069de..99c4d594 100644 --- a/man/sf_run_bulk_query.Rd +++ b/man/sf_run_bulk_query.Rd @@ -86,7 +86,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} of the recordset returned by the query } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} This function is a convenience wrapper for submitting and retrieving query API jobs from the Bulk 1.0 and Bulk 2.0 APIs. diff --git a/man/sf_run_report.Rd b/man/sf_run_report.Rd index 838a9a6b..f2aa2e1d 100644 --- a/man/sf_run_report.Rd +++ b/man/sf_run_report.Rd @@ -72,7 +72,7 @@ along with additional diagnostic information where available.} \code{tbl_df} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function is a convenience wrapper for retrieving the data from a report. By default, it executes an asynchronous report and waits for the detailed data diff --git a/man/sf_search.Rd b/man/sf_search.Rd index a5033aab..0a465683 100644 --- a/man/sf_search.Rd +++ b/man/sf_search.Rd @@ -47,7 +47,7 @@ if it is not supplied directly.} \code{tibble} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Searches for records in your organization’s data. } diff --git a/man/sf_server_timestamp.Rd b/man/sf_server_timestamp.Rd index 2890b674..27a7d8df 100644 --- a/man/sf_server_timestamp.Rd +++ b/man/sf_server_timestamp.Rd @@ -10,7 +10,7 @@ sf_server_timestamp() \code{POSIXct} formatted timestamp } \description{ -\ifelse{html}{\out{Stable lifecycle}}{\strong{Stable}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#stable}{\figure{lifecycle-stable.svg}{options: alt='[Stable]'}}}{\strong{[Stable]}} Retrieves the current system timestamp from the API. } diff --git a/man/sf_set_password.Rd b/man/sf_set_password.Rd index e5145345..72327216 100644 --- a/man/sf_set_password.Rd +++ b/man/sf_set_password.Rd @@ -21,7 +21,7 @@ along with additional diagnostic information where available.} \code{list} } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Sets the specified user’s password to the specified value. } diff --git a/man/sf_undelete.Rd b/man/sf_undelete.Rd index 25462f48..999e7023 100644 --- a/man/sf_undelete.Rd +++ b/man/sf_undelete.Rd @@ -36,7 +36,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Undeletes records from the Recycle Bin. } diff --git a/man/sf_update.Rd b/man/sf_update.Rd index de92f3ad..177a9833 100644 --- a/man/sf_update.Rd +++ b/man/sf_update.Rd @@ -54,7 +54,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Updates one or more records to your organization’s data. } diff --git a/man/sf_update_attachment.Rd b/man/sf_update_attachment.Rd index b67adb64..b65cdafc 100644 --- a/man/sf_update_attachment.Rd +++ b/man/sf_update_attachment.Rd @@ -45,7 +45,7 @@ along with additional diagnostic information where available.} \code{tbl_df} with details of the created records } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function will allow you to update attachments (and other blob data, such as Documents) by providing the Id of the attachment record and the file paths diff --git a/man/sf_update_metadata.Rd b/man/sf_update_metadata.Rd index 3f22f5ed..3328140a 100644 --- a/man/sf_update_metadata.Rd +++ b/man/sf_update_metadata.Rd @@ -37,7 +37,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} containing the creation result for each submitted metadata component } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a list of Metadata components and sends them to Salesforce to update an object that already exists diff --git a/man/sf_update_report.Rd b/man/sf_update_report.Rd index 9ec1e8d9..2ae7751e 100644 --- a/man/sf_update_report.Rd +++ b/man/sf_update_report.Rd @@ -32,7 +32,7 @@ joined metadata.} } } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} Save changes to a report by sending a PATCH request to the Report resource. Note that saving a report deletes any running async report jobs because they diff --git a/man/sf_upsert.Rd b/man/sf_upsert.Rd index c2147f8c..a337a9b6 100644 --- a/man/sf_upsert.Rd +++ b/man/sf_upsert.Rd @@ -59,7 +59,7 @@ along with additional diagnostic information where available.} \code{tbl_df} of records with success indicator } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Upserts one or more new records to your organization’s data. } diff --git a/man/sf_upsert_metadata.Rd b/man/sf_upsert_metadata.Rd index d02f1114..eb216675 100644 --- a/man/sf_upsert_metadata.Rd +++ b/man/sf_upsert_metadata.Rd @@ -37,7 +37,7 @@ along with additional diagnostic information where available.} A \code{tbl_df} containing the creation result for each submitted metadata component } \description{ -\ifelse{html}{\out{Experimental lifecycle}}{\strong{Experimental}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#experimental}{\figure{lifecycle-experimental.svg}{options: alt='[Experimental]'}}}{\strong{[Experimental]}} This function takes a list of Metadata components and sends them to Salesforce for creation or update if the object already exists diff --git a/man/sf_user_info.Rd b/man/sf_user_info.Rd index a79b5529..19f4e6a8 100644 --- a/man/sf_user_info.Rd +++ b/man/sf_user_info.Rd @@ -20,7 +20,7 @@ along with additional diagnostic information where available.} \code{list} } \description{ -\ifelse{html}{\out{Maturing lifecycle}}{\strong{Maturing}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#maturing}{\figure{lifecycle-maturing.svg}{options: alt='[Maturing]'}}}{\strong{[Maturing]}} Retrieves personal information for the user associated with the current session. } From f415b4938fa1a13fd68dd6cebab0f6ea79a0700d Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 16:30:01 -0500 Subject: [PATCH 05/42] Allow guess_types in sf_run_report and fix date and datetime column bug Salesforce returns dates and datetimes in UTC but sometimes as YYYY-MM-DD or MM/DD/YYYY in the case of reports, so we will convert using the anytime package rather than trusting type_convert()'s behavior. Allow users to pass guess_types directly to sf_run_report() in case they still want to do that and parse the character strings on their own Closes #93 --- DESCRIPTION | 1 + NAMESPACE | 3 +++ R/analytics-report.R | 13 ++++++++++++- R/utils-query.R | 28 ++++++++++++++++++++------- man/sf_guess_cols.Rd | 2 +- man/sf_run_report.Rd | 46 ++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 84 insertions(+), 9 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 202971f5..cefa6138 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -32,6 +32,7 @@ Imports: tibble (>= 3.0.3), readr (>= 1.3.1), lubridate (>= 1.7.8), + anytime (>= 0.3.9), rlang (>= 0.4.7), httr (>= 1.4.1), curl (>= 4.3), diff --git a/NAMESPACE b/NAMESPACE index e48f0f02..af1e28a1 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -282,6 +282,8 @@ importFrom(XML,xmlSApply) importFrom(XML,xmlSize) importFrom(XML,xmlToList) importFrom(XML,xmlValue) +importFrom(anytime,anydate) +importFrom(anytime,anytime) importFrom(base64enc,base64encode) importFrom(curl,form_data) importFrom(curl,form_file) @@ -359,6 +361,7 @@ importFrom(purrr,transpose) importFrom(readr,col_character) importFrom(readr,col_guess) importFrom(readr,cols) +importFrom(readr,locale) importFrom(readr,parse_datetime) importFrom(readr,read_csv) importFrom(readr,type_convert) diff --git a/R/analytics-report.R b/R/analytics-report.R index 408c8d8e..ddcdde73 100644 --- a/R/analytics-report.R +++ b/R/analytics-report.R @@ -962,6 +962,9 @@ sf_get_report_instance_results <- function(report_id, #' report finish running so that data can be obtained. Otherwise, return the #' report instance details which can be used to retrieve the results when the #' async report has finished. +#' @template guess_types +#' @template bind_using_character_cols +#' @template fact_map_key #' @template verbose #' @return \code{tbl_df} #' @family Report functions @@ -1017,6 +1020,9 @@ sf_run_report <- function(report_id, interval_seconds = 3, max_attempts = 200, wait_for_results = TRUE, + guess_types = TRUE, + bind_using_character_cols = FALSE, + fact_map_key = "T!T", verbose = FALSE){ # build out the body of the request based on the inputted arguments by starting @@ -1090,7 +1096,9 @@ sf_run_report <- function(report_id, results <- sf_execute_report(report_id, async = async, - report_metadata = request_body, + report_metadata = request_body, + guess_types = guess_types, + bind_using_character_cols = bind_using_character_cols, verbose = verbose) # request the report results (still wait if async is specified) @@ -1123,6 +1131,9 @@ sf_run_report <- function(report_id, } results <- sf_get_report_instance_results(report_id, results$id, + guess_types = guess_types, + bind_using_character_cols = bind_using_character_cols, + fact_map_key = "T!T", verbose = verbose) } } diff --git a/R/utils-query.R b/R/utils-query.R index 4acdb5ab..28e46ee0 100644 --- a/R/utils-query.R +++ b/R/utils-query.R @@ -733,12 +733,13 @@ sf_reorder_cols <- function(df){ contains(".")) } -#' Reorder resultset columns to prioritize \code{sObject} and \code{Id} +#' Parse resultset columns to a known datatype in R #' #' This function accepts a \code{tbl_df} with columns rearranged. #' #' @importFrom dplyr mutate across -#' @importFrom readr type_convert cols col_guess +#' @importFrom anytime anytime anydate +#' @importFrom readr type_convert cols col_guess locale #' @param df \code{tbl_df}; the data frame to rearrange columns in #' @return \code{tbl_df} the formatted data frame #' @note This function is meant to be used internally. Only use when debugging. @@ -746,19 +747,32 @@ sf_reorder_cols <- function(df){ #' @export sf_guess_cols <- function(df, guess_types=TRUE, dataType=NULL){ if(guess_types){ - if(is.null(dataType) || any(is.na(dataType)) || (length(dataType)== 0)){ + if(is.null(dataType) || any(is.na(dataType)) || (length(dataType) == 0)){ df <- df %>% - type_convert(col_types = cols(.default = col_guess())) + type_convert(col_types = cols(.default = col_guess()), locale=locale(tz="UTC")) } else { col_spec <- sf_build_cols_spec(dataType) - # if numeric but contains Salesforce "-" then preemptively change to NA + # if numeric Salesforce will flag N/A as "-" so we need to preemptively change to NA + # TODO: Does it use "-" for NA or zero? Or both? if(grepl('i|n', col_spec)){ numeric_col_idx <- which(strsplit(col_spec, split=character(0))[[1]] %in% c("i", "n")) df <- df %>% mutate(across(all_of(numeric_col_idx), ~ifelse(.x == "-", NA_character_, .x))) } - df <- df %>% - type_convert(col_types = col_spec) + # Salesforce returns dates and datetimes in UTC but sometimes as YYYY-MM-DD + # or MM/DD/YYYY in the case of reports, so we will convert using the + # anytime package rather than trusting type_convert's behavior + if(grepl('D', col_spec)){ + date_col_idx <- which(strsplit(col_spec, split=character(0))[[1]] == "D") + df <- df %>% + mutate(across(all_of(date_col_idx), ~as.character(anydate(.x, tz="UTC", asUTC=TRUE)))) + } + if(grepl('T', col_spec)){ + datetime_col_idx <- which(strsplit(col_spec, split=character(0))[[1]] == "T") + df <- df %>% + mutate(across(all_of(datetime_col_idx), ~as.character(anytime(.x, tz="UTC", asUTC=TRUE)))) + } + df <- df %>% type_convert(col_types = col_spec, locale=locale(tz="UTC")) } } return(df) diff --git a/man/sf_guess_cols.Rd b/man/sf_guess_cols.Rd index 61589fcd..b60d1ab6 100644 --- a/man/sf_guess_cols.Rd +++ b/man/sf_guess_cols.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/utils-query.R \name{sf_guess_cols} \alias{sf_guess_cols} -\title{Reorder resultset columns to prioritize \code{sObject} and \code{Id}} +\title{Parse resultset columns to a known datatype in R} \usage{ sf_guess_cols(df, guess_types = TRUE, dataType = NULL) } diff --git a/man/sf_run_report.Rd b/man/sf_run_report.Rd index f2aa2e1d..edfbfc14 100644 --- a/man/sf_run_report.Rd +++ b/man/sf_run_report.Rd @@ -15,6 +15,9 @@ sf_run_report( interval_seconds = 3, max_attempts = 200, wait_for_results = TRUE, + guess_types = TRUE, + bind_using_character_cols = FALSE, + fact_map_key = "T!T", verbose = FALSE ) } @@ -63,6 +66,26 @@ report finish running so that data can be obtained. Otherwise, return the report instance details which can be used to retrieve the results when the async report has finished.} +\item{guess_types}{\code{logical}; indicating whether or not to use \code{col_guess()} +to try and cast the data returned in the recordset. If \code{TRUE} then +\code{col_guess()} is used, if \code{FALSE} then all fields will be returned +as character. This is helpful when \code{col_guess()} will mangle field values +in Salesforce that you'd like to preserve during translation into a \code{tbl_df}, +like numeric looking values that must be preserved as strings ("48.0").} + +\item{bind_using_character_cols}{\code{logical}; an indicator of whether to +cast the data to all character columns to ensure that \code{\link[dplyr:bind]{bind_rows}} +does not fail because two paginated recordsets have differing datatypes for the +same column. Set this to \code{TRUE} rarely, typically only when having this +set to \code{FALSE} returns an error or you want all columns in the data to be +character.} + +\item{fact_map_key}{\code{character}; string providing an index into each +section of a fact map, from which you can access summary and detailed data. +The pattern for the fact map keys varies by report format so it is important +to know what the \code{reportFormat} property of the target report is. See the +note below for more details.} + \item{verbose}{\code{logical}; an indicator of whether to print additional detail for each API call, which is useful for debugging. More specifically, when set to \code{TRUE} the URL, header, and body will be printed for each request, @@ -88,6 +111,29 @@ without total rows and given options to filter, and select the Top N as function arguments rather than forcing the user to create an entire list of \code{reportMetadata}. } +\note{ +Below are the fact map key patterns for three report types: +\describe{ +\item{TABULAR}{\code{T!T}: The grand total of a report. Both record data +values and the grand total are represented by this key.} +\item{SUMMARY}{\code{!T}: T refers to the row grand total.} +\item{MATRIX}{\code{!.}} +} + +Each item in a row or column grouping is numbered starting with 0. Here are +some examples of fact map keys: + +\describe{ +\item{0!T}{The first item in the first-level grouping.} +\item{1!T}{The second item in the first-level grouping.} +\item{0_0!T}{The first item in the first-level grouping and the first item +in the second-level grouping.} +\item{0_1!T}{The first item in the first-level grouping and the second item +in the second-level grouping.} +} +} \section{Salesforce Documentation}{ \itemize{ From 275c38f850a89854484ef71812f3597b62cc43c7 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 17:15:20 -0500 Subject: [PATCH 06/42] Fix bug where datetime fields break Bulk 2.0 recordsets Fix the casting of all common columns between the different record sets by ensuring that only one class is selected after identifying it with the class() function. Allow users to specify the `combine_record_types` argument directly in higher level functions like `sf_upsert()` and have it passed through if the API is set to "Bulk 2.0" Closes #95 --- R/bulk-operation.R | 27 +++++++++++++++++++-------- R/utils-query.R | 4 ++-- man-roxygen/combine_record_types.R | 3 +++ man-roxygen/record_types.R | 2 ++ man/sf_get_job_records_bulk.Rd | 6 +++--- man/sf_run_bulk_operation.Rd | 11 +++++++++++ 6 files changed, 40 insertions(+), 13 deletions(-) create mode 100644 man-roxygen/combine_record_types.R create mode 100644 man-roxygen/record_types.R diff --git a/R/bulk-operation.R b/R/bulk-operation.R index c2ce0558..5c060501 100644 --- a/R/bulk-operation.R +++ b/R/bulk-operation.R @@ -1160,11 +1160,8 @@ sf_batch_details_bulk <- function(job_id, batch_id, #' #' @template job_id #' @template api_type -#' @param record_types \code{character}; one or more types of records to retrieve from -#' the results of running the specified job -#' @param combine_record_types \code{logical}; indicating for Bulk 2.0 jobs whether the -#' successfulResults, failedResults, and unprocessedRecords should be stacked -#' together by binding the rows. +#' @template record_types +#' @template combine_record_types #' @template verbose #' @return A \code{tbl_df} or \code{list} of \code{tbl_df}, formatted by Salesforce, #' with information containing the success or failure or certain rows in a submitted job @@ -1187,7 +1184,7 @@ sf_get_job_records_bulk <- function(job_id, record_types = c("successfulResults", "failedResults", "unprocessedRecords"), - combine_record_types = TRUE, + combine_record_types = TRUE, verbose = FALSE){ api_type <- match.arg(api_type) if(api_type == "Bulk 1.0"){ @@ -1256,11 +1253,13 @@ sf_get_job_records_bulk_v2 <- function(job_id, # First, determine the column datatypes from the data.frame with most rows base_class_df <- records[[head(which.max(sapply(records, nrow)), 1)]] # Second, convert the datatypes for any data.frames with zero rows + # From StackOverflow post here: https://stackoverflow.com/a/47800157/5258043 + # distributed under the CC BY-SA 3.0 license terms. for (i in 1:length(records)){ if(nrow(records[[i]]) == 0){ common <- names(records[[i]])[names(records[[i]]) %in% names(base_class_df)] records[[i]][common] <- lapply(common, function(x) { - match.fun(paste0("as.", class(base_class_df[[x]])))(records[[i]][[x]]) + match.fun(paste0("as.", class(base_class_df[[x]])[1]))(records[[i]][[x]]) }) } } @@ -1292,6 +1291,8 @@ sf_get_job_records_bulk_v2 <- function(job_id, #' @template max_attempts #' @param wait_for_results \code{logical}; indicating whether to wait for the operation to complete #' so that the batch results of individual records can be obtained +#' @template record_types +#' @template combine_record_types #' @template control #' @param ... other arguments passed on to \code{\link{sf_control}} or \code{\link{sf_create_job_bulk}} #' to specify the \code{content_type}, \code{concurrency_mode}, and/or \code{column_delimiter}. @@ -1322,6 +1323,10 @@ sf_run_bulk_operation <- function(input_data, interval_seconds = 3, max_attempts = 200, wait_for_results = TRUE, + record_types = c("successfulResults", + "failedResults", + "unprocessedRecords"), + combine_record_types = TRUE, control = list(...), ..., verbose = FALSE){ @@ -1392,7 +1397,13 @@ sf_run_bulk_operation <- function(input_data, message("Function's Time Limit Exceeded. Aborting Job Now") res <- sf_abort_job_bulk(job_info$id, api_type = api_type, verbose = verbose) } else { - res <- sf_get_job_records_bulk(job_info$id, api_type = api_type, verbose = verbose) + res <- sf_get_job_records_bulk( + job_info$id, + api_type = api_type, + record_types = record_types, + combine_record_types = combine_record_types, + verbose = verbose + ) # For Bulk 2.0 jobs -> INVALIDJOBSTATE: Closing already Completed Job not allowed if(api_type == "Bulk 1.0"){ close_job_info <- sf_close_job_bulk(job_info$id, api_type = api_type, verbose = verbose) diff --git a/R/utils-query.R b/R/utils-query.R index 28e46ee0..fe764204 100644 --- a/R/utils-query.R +++ b/R/utils-query.R @@ -759,8 +759,8 @@ sf_guess_cols <- function(df, guess_types=TRUE, dataType=NULL){ df <- df %>% mutate(across(all_of(numeric_col_idx), ~ifelse(.x == "-", NA_character_, .x))) } - # Salesforce returns dates and datetimes in UTC but sometimes as YYYY-MM-DD - # or MM/DD/YYYY in the case of reports, so we will convert using the + # Salesforce returns dates and datetimes in UTC but sometimes as YYYY-MM-DD + # or MM/DD/YYYY in the case of reports, so we will convert using the # anytime package rather than trusting type_convert's behavior if(grepl('D', col_spec)){ date_col_idx <- which(strsplit(col_spec, split=character(0))[[1]] == "D") diff --git a/man-roxygen/combine_record_types.R b/man-roxygen/combine_record_types.R new file mode 100644 index 00000000..276b3ba5 --- /dev/null +++ b/man-roxygen/combine_record_types.R @@ -0,0 +1,3 @@ +#' @param combine_record_types \code{logical}; indicating for Bulk 2.0 jobs whether the +#' successfulResults, failedResults, and unprocessedRecords should be stacked +#' together by binding the rows diff --git a/man-roxygen/record_types.R b/man-roxygen/record_types.R new file mode 100644 index 00000000..eab9f30c --- /dev/null +++ b/man-roxygen/record_types.R @@ -0,0 +1,2 @@ +#' @param record_types \code{character}; one or more types of records to retrieve +#' from the results of running the specified job diff --git a/man/sf_get_job_records_bulk.Rd b/man/sf_get_job_records_bulk.Rd index 8a7050a4..cfcd4fca 100644 --- a/man/sf_get_job_records_bulk.Rd +++ b/man/sf_get_job_records_bulk.Rd @@ -20,12 +20,12 @@ returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} \code{"Bulk 1.0"}, or \code{"Bulk 2.0"} indicating which API to use when making the request.} -\item{record_types}{\code{character}; one or more types of records to retrieve from -the results of running the specified job} +\item{record_types}{\code{character}; one or more types of records to retrieve +from the results of running the specified job} \item{combine_record_types}{\code{logical}; indicating for Bulk 2.0 jobs whether the successfulResults, failedResults, and unprocessedRecords should be stacked -together by binding the rows.} +together by binding the rows} \item{verbose}{\code{logical}; an indicator of whether to print additional detail for each API call, which is useful for debugging. More specifically, when diff --git a/man/sf_run_bulk_operation.Rd b/man/sf_run_bulk_operation.Rd index 2c9a271f..d9567cd5 100644 --- a/man/sf_run_bulk_operation.Rd +++ b/man/sf_run_bulk_operation.Rd @@ -16,6 +16,8 @@ sf_run_bulk_operation( interval_seconds = 3, max_attempts = 200, wait_for_results = TRUE, + record_types = c("successfulResults", "failedResults", "unprocessedRecords"), + combine_record_types = TRUE, control = list(...), ..., verbose = FALSE @@ -32,6 +34,8 @@ sf_bulk_operation( interval_seconds = 3, max_attempts = 200, wait_for_results = TRUE, + record_types = c("successfulResults", "failedResults", "unprocessedRecords"), + combine_record_types = TRUE, control = list(...), ..., verbose = FALSE @@ -73,6 +77,13 @@ completion before stopping.} \item{wait_for_results}{\code{logical}; indicating whether to wait for the operation to complete so that the batch results of individual records can be obtained} +\item{record_types}{\code{character}; one or more types of records to retrieve +from the results of running the specified job} + +\item{combine_record_types}{\code{logical}; indicating for Bulk 2.0 jobs whether the +successfulResults, failedResults, and unprocessedRecords should be stacked +together by binding the rows} + \item{control}{\code{list}; a list of parameters for controlling the behavior of the API call being used. For more information of what parameters are available look at the documentation for \code{\link{sf_control}}.} From f6c5a51c71e8f6f57a93f0fbc84968852dce8cbd Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 17:20:53 -0500 Subject: [PATCH 07/42] Update NEWS.md with new bug fixes --- NEWS.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/NEWS.md b/NEWS.md index e29d0d1d..199750b4 100644 --- a/NEWS.md +++ b/NEWS.md @@ -12,7 +12,11 @@ ### Bug fixes - * Fixed the format of the `OwnerChangeOptions` header so it is accepted (#94) + * Generalize the date and datetime parsing mechanism, such that, reports with + date and datetime fields are not returned as NA (#93) + * Fix the format of the `OwnerChangeOptions` header so it is accepted (#94) + * Fix bug that caused Bulk 2.0 calls to crash when the results had datetime + fields in the recordset (#95) --- From dbd9a096a9a8a72a22a34bb42003189ce3a66a48 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 17:25:44 -0500 Subject: [PATCH 08/42] Fix roxygen syntax error in in sf_auth documentation --- R/auth.R | 5 +++-- man/sf_auth.Rd | 1 + 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/R/auth.R b/R/auth.R index 3d3d13f6..2071f64c 100644 --- a/R/auth.R +++ b/R/auth.R @@ -58,9 +58,10 @@ #' @param cache \code{logical} or \code{character}; TRUE means to cache using #' the default cache file \code{.httr-oauth-salesforcer}, FALSE means do not #' cache. A string means use the specified path as the cache file. +#' @template verbose #' @return \code{list} invisibly that contains 4 elements detailing the authentication state #' @note The \code{link{sf_auth}} function invisibly returns the following -#' 4 pieces of information which can be reused in other operations: +#' 4 pieces of information which can be reused in other operations: #' \describe{ #' \item{auth_method}{ #' \code{character}; One of two options 'Basic' or 'OAuth'. If a username, @@ -83,7 +84,7 @@ #' server instance located in Chicago, USA / Washington DC, USA per this #' Knowledge Article: \url{https://help.salesforce.com/articleView?id=000314281}. #' } -#' @template verbose +#' } #' @examples #' \dontrun{ #' # log in using basic authentication (username-password) diff --git a/man/sf_auth.Rd b/man/sf_auth.Rd index 8d206f7f..4efd7285 100644 --- a/man/sf_auth.Rd +++ b/man/sf_auth.Rd @@ -84,6 +84,7 @@ server instance located in Chicago, USA / Washington DC, USA per this Knowledge Article: \url{https://help.salesforce.com/articleView?id=000314281}. } } +} \examples{ \dontrun{ # log in using basic authentication (username-password) From 7c7e5e55b2a6c702fd921436a659caf6afcdedf7 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 18:17:30 -0500 Subject: [PATCH 09/42] Further remove RForcecom references to pass build --- tests/testthat.R | 1 - tests/testthat/test-compatibility.R | 2 + vignettes/transitioning-from-RForcecom.Rmd | 64 +++++++++++----------- 3 files changed, 33 insertions(+), 34 deletions(-) diff --git a/tests/testthat.R b/tests/testthat.R index 255168ea..7ce48f5b 100644 --- a/tests/testthat.R +++ b/tests/testthat.R @@ -1,5 +1,4 @@ library(testthat) -library(RForcecom) library(dplyr) library(salesforcer) diff --git a/tests/testthat/test-compatibility.R b/tests/testthat/test-compatibility.R index 97f89f86..92706c97 100644 --- a/tests/testthat/test-compatibility.R +++ b/tests/testthat/test-compatibility.R @@ -2,6 +2,8 @@ context("RForcecom Compatibility") setup(options(lifecycle_verbosity = "quiet")) +skip("Not running due to RForcecom being pulled from CRAN.") + test_that("testing rforcecom.login compatibility", { username <- Sys.getenv("SALESFORCER_USERNAME") diff --git a/vignettes/transitioning-from-RForcecom.Rmd b/vignettes/transitioning-from-RForcecom.Rmd index bbdf4b94..2f33fdf8 100644 --- a/vignettes/transitioning-from-RForcecom.Rmd +++ b/vignettes/transitioning-from-RForcecom.Rmd @@ -1,7 +1,7 @@ --- title: "Transitioning from RForcecom" author: "Steven M. Mortimer" -date: "2018-03-12" +date: "2021-07-03" output: rmarkdown::html_vignette: toc: true @@ -25,11 +25,18 @@ options(tibble.print_min = 5L, tibble.print_max = 5L) ``` While writing the {salesforcer} package we were keenly aware that many folks -are already using the {RForcecom} package to connect to Salesforce. In order +were already using the {RForcecom} package to connect to Salesforce. In order to foster adoption and switching between the packages {salesforcer} replicates the functionality of many {RForcecom} functions so that you will only need to swap -out `library(RForcecom)` for `library(salesforcer)` and still have your production -tested scripts perform as usual. +out `library(RForcecom)` for `library(salesforcer)` and still have +production scripts perform as expected. + +## RForcecom removed from CRAN + +As of June 9, 2021, the {RForcecom} package was removed from CRAN. You can still +use by installing from the archive, but we strongly recommend using +{salesforcer}. All of the functions in {RForcecom} have been further optimized +within {salesforcer}. ## Authentication @@ -53,11 +60,8 @@ sf_auth(username = username, ```{r, warning=FALSE} # the RForcecom way -session1 <- RForcecom::rforcecom.login(username, paste0(password, security_token), - apiVersion=getOption("salesforcer.api_version")) -session1['sessionID'] <- "{MASKED}" -session1 - +# RForcecom::rforcecom.login(username, paste0(password, security_token), +# apiVersion=getOption("salesforcer.api_version")) # replicated in salesforcer package session2 <- salesforcer::rforcecom.login(username, paste0(password, security_token), @@ -92,12 +96,11 @@ object <- "Contact" fields <- c(FirstName="Test", LastName="Contact-Create-Compatibility") # the RForcecom way -result1 <- RForcecom::rforcecom.create(session, objectName=object, fields) -result1 +# RForcecom::rforcecom.create(session, objectName=object, fields) # replicated in salesforcer package -result2 <- salesforcer::rforcecom.create(session, objectName=object, fields) -result2 +result <- salesforcer::rforcecom.create(session, objectName=object, fields) +result ``` Here is an example showing the reduction in code of using {salesforcer} if you @@ -108,15 +111,14 @@ n <- 2 new_contacts <- tibble(FirstName = rep("Test", n), LastName = paste0("Contact-Create-", 1:n)) -# the RForcecom way -rforcecom_results <- NULL -for(i in 1:nrow(new_contacts)){ - temp <- RForcecom::rforcecom.create(session, - objectName = "Contact", - fields = unlist(slice(new_contacts,i))) - rforcecom_results <- bind_rows(rforcecom_results, temp) -} -rforcecom_results +# the RForcecom way (requires a loop) +# rforcecom_results <- NULL +# for(i in 1:nrow(new_contacts)){ +# temp <- RForcecom::rforcecom.create(session, +# objectName = "Contact", +# fields = unlist(slice(new_contacts,i))) +# rforcecom_results <- bind_rows(rforcecom_results, temp) +# } # the better way in salesforcer to do multiple records salesforcer_results <- sf_create(new_contacts, object_name="Contact") @@ -132,12 +134,11 @@ result thanks to features of the {readr} package. this_soql <- "SELECT Id, Email FROM Contact LIMIT 5" # the RForcecom way -result1 <- RForcecom::rforcecom.query(session, soqlQuery = this_soql) -result1 +# RForcecom::rforcecom.query(session, soqlQuery = this_soql) # replicated in salesforcer package -result2 <- salesforcer::rforcecom.query(session, soqlQuery = this_soql) -result2 +result <- salesforcer::rforcecom.query(session, soqlQuery = this_soql) +result # the better way in salesforcer to query salesforcer_results <- sf_query(this_soql) @@ -153,15 +154,12 @@ better printing and datatype casting by using tibbles. ```{r, warning=FALSE} # the RForcecom way -result1 <- RForcecom::rforcecom.getObjectDescription(session, objectName='Account') +# RForcecom::rforcecom.getObjectDescription(session, objectName='Account') # backwards compatible in the salesforcer package -result2 <- salesforcer::rforcecom.getObjectDescription(session, objectName='Account') +result <- salesforcer::rforcecom.getObjectDescription(session, objectName='Account') # the better way in salesforcer to get object fields -result3 <- salesforcer::sf_describe_object_fields('Account') -result3 +result2 <- salesforcer::sf_describe_object_fields('Account') +result2 ``` - -In the future more features will be migrated from {RForcecom} to make the -transition as seamless as possible. From 24d82728859eca4736011eb2baec7447fd56e694 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:14:23 -0500 Subject: [PATCH 10/42] In Bulk APIs use all values in column to guess type --- R/bulk-operation.R | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/R/bulk-operation.R b/R/bulk-operation.R index 5c060501..18af2d9a 100644 --- a/R/bulk-operation.R +++ b/R/bulk-operation.R @@ -1088,7 +1088,7 @@ sf_batch_status_bulk <- function(job_id, batch_id, #' This function returns detailed (row-by-row) information on an existing batch #' which has already been submitted to Bulk API Job #' -#' @importFrom readr read_csv +#' @importFrom readr read_csv type_convert cols col_character #' @importFrom httr content #' @importFrom XML xmlToList #' @importFrom dplyr as_tibble @@ -1127,7 +1127,9 @@ sf_batch_details_bulk <- function(job_id, batch_id, content_type <- httr_response$headers$`content-type` if(content_type == 'text/csv' | content_type == 'zip/csv'){ response_text <- content(httr_response, as="text", encoding="UTF-8") - res <- read_csv(response_text) + # required to guess column types by all values in the column, not just first N + res <- read_csv(response_text, col_types = cols(.default = col_character())) + res <- type_convert(res, col_types = cols()) } else if(content_type == 'zip/xml'){ response_parsed <- content(httr_response, as="parsed", type="text/xml", encoding="UTF-8") res <- response_parsed %>% @@ -1214,7 +1216,7 @@ sf_get_job_records_bulk_v1 <- function(job_id, verbose = FALSE){ return(resultset) } -#' @importFrom readr read_csv +#' @importFrom readr read_csv type_convert cols col_character #' @importFrom httr content sf_get_job_records_bulk_v2 <- function(job_id, record_types = c("successfulResults", @@ -1237,7 +1239,9 @@ sf_get_job_records_bulk_v2 <- function(job_id, response_text <- content(httr_response, as="text", encoding="UTF-8") content_type <- httr_response$headers$`content-type` if(grepl('text/csv', content_type)) { - res <- read_csv(response_text) + # required to guess column types by all values in the column, not just first N + res <- read_csv(response_text, col_types = cols(.default = col_character())) + res <- type_convert(res, col_types = cols()) } else { message(sprintf("Unhandled content-type: %s", content_type)) res <- content(httr_response, as="parsed", encoding="UTF-8") From 6b8442fa50b8cae716e3c2924aec6d65b3586e20 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:14:39 -0500 Subject: [PATCH 11/42] Fix deprecated argument name in write_csv --- R/utils.R | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/R/utils.R b/R/utils.R index b9889d23..aa95694b 100644 --- a/R/utils.R +++ b/R/utils.R @@ -84,8 +84,8 @@ merge_null_to_na <- function(x){ #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export -sf_write_csv <- function(x, path){ - write_csv(x=x, path=path, na="#N/A") +sf_write_csv <- function(x, file){ + write_csv(x=x, file=path, na="#N/A") } #' Remove NA Columns Created by Empty Related Entity Values From 4377e0bd8fe1cad0715e766c34070460ae6d2bda Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:14:53 -0500 Subject: [PATCH 12/42] Update possible versions list in tests --- tests/testthat/test-org-utils.R | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/testthat/test-org-utils.R b/tests/testthat/test-org-utils.R index bb235c1d..c5e18e40 100644 --- a/tests/testthat/test-org-utils.R +++ b/tests/testthat/test-org-utils.R @@ -27,7 +27,7 @@ test_that("testing sf_list_rest_api_versions()", { res <- sf_list_rest_api_versions() versions <- sapply(res, function(x){as.integer(x$version)}) expect_is(res, "list") - expect_true(all(20:46 %in% versions)) + expect_true(all(21:52 %in% versions)) }) test_that("testing sf_list_resources()", { From 5e948b920968fe77b0be117397a20cc43f97ff9a Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:15:22 -0500 Subject: [PATCH 13/42] Update Bulk 2.0 grandparent query test --- tests/testthat/test-query.R | 24 +++++++++++------------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/tests/testthat/test-query.R b/tests/testthat/test-query.R index 1dd82c8f..09da794b 100644 --- a/tests/testthat/test-query.R +++ b/tests/testthat/test-query.R @@ -108,8 +108,7 @@ test_that("testing simple SELECT query", { simple_select_soql_wo_compound <- sprintf("SELECT %s FROM Contact", paste0(contact_fields_to_test_wo_compound, collapse=", ")) - bulk2_queried_records <- sf_query(simple_select_soql_wo_compound, - api_type="Bulk 2.0") + bulk2_queried_records <- sf_query(simple_select_soql_wo_compound, api_type="Bulk 2.0") expect_is(bulk2_queried_records, "tbl_df") expect_gt(nrow(bulk2_queried_records), 0) expect_equal(sort(names(bulk2_queried_records)), @@ -171,42 +170,41 @@ test_that("testing child-to-parent-grandparent relationship lookup query", { expect_equal(sort(names(bulk1_queried_records)), sort(relationship_fields)) # Bulk 2.0 API --------------------------------------------------------------- - expect_error(sf_query(relationship_soql, api_type="Bulk 2.0"), - paste0("Failure during batch processing: FeatureNotEnabled : ", - "Cannot serialize value for 'Owner' in CSV format")) + bulk2_queried_records <- sf_query(relationship_soql, api_type="Bulk 2.0") + expect_is(bulk2_queried_records, "tbl_df") + expect_gt(nrow(bulk2_queried_records), 0) + expect_equal(sort(names(bulk2_queried_records)), sort(relationship_fields)) }) test_that("testing parent-to-child nested relationship query", { - nested_soql <- "SELECT Id, - (SELECT Id FROM Contacts) - FROM Account" + relationship_soql <- "SELECT Id, (SELECT Id FROM Contacts) FROM Account" # SOAP API ------------------------------------------------------------------- - soap_queried_records <- sf_query(nested_soql, api_type="SOAP") + soap_queried_records <- sf_query(relationship_soql, api_type="SOAP") expect_is(soap_queried_records, "tbl_df") expect_gt(nrow(soap_queried_records), 0) expect_named(soap_queried_records, c("Id", "Contact.Id")) # REST API ------------------------------------------------------------------- - rest_queried_records <- sf_query(nested_soql, api_type="REST") + rest_queried_records <- sf_query(relationship_soql, api_type="REST") expect_is(rest_queried_records, "tbl_df") expect_gt(nrow(rest_queried_records), 0) expect_named(soap_queried_records, c("Id", "Contact.Id")) # Bulk 1.0 API --------------------------------------------------------------- - expect_error(sf_query(nested_soql, object_name=object, api_type="Bulk 1.0"), + expect_error(sf_query(relationship_soql, object_name=object, api_type="Bulk 1.0"), paste0("INVALID_TYPE_FOR_OPERATION: The root entity of the requested ", "query (Account) does not match the entity of the requested ", "Bulk API Job (Contact)"), fixed=TRUE) - expect_error(sf_query(nested_soql, object_name="Account", api_type="Bulk 1.0"), + expect_error(sf_query(relationship_soql, object_name="Account", api_type="Bulk 1.0"), paste0("FeatureNotEnabled : Aggregate Relationships not supported ", "in Bulk Query with CSV content type")) # Bulk 2.0 API --------------------------------------------------------------- - expect_error(sf_query(nested_soql, api_type="Bulk 2.0"), + expect_error(sf_query(relationship_soql, api_type="Bulk 2.0"), paste0("API_ERROR: Aggregate Relationships not supported ", "in Bulk V2 Query with CSV content type")) }) From f2cf235b7b485976a75fa55d8e1cf8f58fa7b3ac Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:20:54 -0500 Subject: [PATCH 14/42] Document changes because of readr --- NEWS.md | 6 +++++- man/sf_write_csv.Rd | 2 +- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/NEWS.md b/NEWS.md index 199750b4..74f0082f 100644 --- a/NEWS.md +++ b/NEWS.md @@ -2,13 +2,17 @@ ### Dependencies - * Remove references to RForcecom after it was removed from CRAN on 6/9/2021 (#101) + * Remove uses of {RForcecom} after it was removed from CRAN on 6/9/2021 (#101) * Remove LazyData option in DESCRIPTION since `data()` is not utilized + * Change argument in `sf_write_csv()` from `path` to `file` as was done in + {readr} v1.4.0 ### Features * Improve documentation to retrieve the access token or session ID after authentication (#97) + * Improve parsing of Bulk API query recordsets from CSV where all values + in the column will be used to guess the type instead of the first 1000. ### Bug fixes diff --git a/man/sf_write_csv.Rd b/man/sf_write_csv.Rd index 997b697d..ce452757 100644 --- a/man/sf_write_csv.Rd +++ b/man/sf_write_csv.Rd @@ -4,7 +4,7 @@ \alias{sf_write_csv} \title{Write a CSV file in format acceptable to Salesforce APIs} \usage{ -sf_write_csv(x, path) +sf_write_csv(x, file) } \description{ Write a CSV file in format acceptable to Salesforce APIs From 5efa10053e86892ae9a45b2a940b5245eb12469a Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 22:33:35 -0500 Subject: [PATCH 15/42] Fix bug after write_csv change --- R/utils.R | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/R/utils.R b/R/utils.R index aa95694b..e6d569e5 100644 --- a/R/utils.R +++ b/R/utils.R @@ -85,7 +85,7 @@ merge_null_to_na <- function(x){ #' @keywords internal #' @export sf_write_csv <- function(x, file){ - write_csv(x=x, file=path, na="#N/A") + write_csv(x=x, file=file, na="#N/A") } #' Remove NA Columns Created by Empty Related Entity Values From c5ce7823ab5bd7e28c849cb84e59daac2cf2c85d Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 23:20:31 -0500 Subject: [PATCH 16/42] Bump version --- DESCRIPTION | 25 ++++++++++++++++++------- NEWS.md | 2 +- 2 files changed, 19 insertions(+), 8 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index cefa6138..0baf0cc2 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: salesforcer Title: An Implementation of 'Salesforce' APIs Using Tidy Principles -Version: 0.2.2.9000 +Version: 0.2.3 Date: 2021-07-03 Description: Functions connecting to the 'Salesforce' Platform APIs (REST, SOAP, Bulk 1.0, Bulk 2.0, Metadata, Reports and Dashboards) @@ -11,12 +11,23 @@ Description: Functions connecting to the 'Salesforce' Platform APIs (REST, SOAP, API documentation and this package's website for more information, documentation, and examples. -Authors@R: c( - person(c("Steven", "M."), "Mortimer", , "mortimer.steven.m@gmail.com", c("aut", "cre")), - person("Takekatsu", "Hiramura", , "thira@plavox.info", c("ctb")), - person("Jennifer", "Bryan", , "jenny@rstudio.com", c("ctb", "cph")), - person("Joanna", "Zhao", , "joanna.zhao@alumni.ubc.ca", c("ctb", "cph")) - ) +Authors@R: + c(person(given = c("Steven", "M."), + family = "Mortimer", + role = c("aut", "cre"), + email = "mortimer.steven.m@gmail.com"), + person(given = "Takekatsu", + family = "Hiramura", + role = "ctb", + email = "thira@plavox.info"), + person(given = "Jennifer", + family = "Bryan", + role = c("ctb", "cph"), + email = "jenny@rstudio.com"), + person(given = "Joanna", + family = "Zhao", + role = c("ctb", "cph"), + email = "joanna.zhao@alumni.ubc.ca")) License: MIT + file LICENSE URL: https://github.com/StevenMMortimer/salesforcer BugReports: https://github.com/StevenMMortimer/salesforcer/issues diff --git a/NEWS.md b/NEWS.md index 74f0082f..959d9bff 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,4 +1,4 @@ -## salesforcer 0.2.2.9000 +## salesforcer 0.2.3 ### Dependencies From 484bbf1ef609ca979ced68b3f18e9f2e38eea976 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sat, 3 Jul 2021 23:23:59 -0500 Subject: [PATCH 17/42] Bump version in READMEs --- README.Rmd | 2 +- README.md | 2 +- index.Rmd | 2 +- index.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.Rmd b/README.Rmd index 642000ca..c942f15b 100644 --- a/README.Rmd +++ b/README.Rmd @@ -69,7 +69,7 @@ Package features include: ## Installation ```{r, eval = FALSE} -# install the current CRAN version (0.2.2) +# install the current CRAN version (0.2.3) install.packages("salesforcer") # or get the development version on GitHub diff --git a/README.md b/README.md index 1da63b18..3bd6cc53 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ Package features include: ## Installation ``` r -# install the current CRAN version (0.2.2) +# install the current CRAN version (0.2.3) install.packages("salesforcer") # or get the development version on GitHub diff --git a/index.Rmd b/index.Rmd index 47ff2ddb..6a1d3fbd 100644 --- a/index.Rmd +++ b/index.Rmd @@ -70,7 +70,7 @@ Package features include: ## Installation ```{r, eval = FALSE} -# install the current CRAN version (0.2.2) +# install the current CRAN version (0.2.3) install.packages("salesforcer") # or get the development version on GitHub diff --git a/index.md b/index.md index cad9fcf8..34709960 100644 --- a/index.md +++ b/index.md @@ -70,7 +70,7 @@ Package features include: ## Installation ``` r -# install the current CRAN version (0.2.2) +# install the current CRAN version (0.2.3) install.packages("salesforcer") # or get the development version on GitHub From b5da775078af7acf1053cdddf70d43aa3cb1d031 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Sun, 4 Jul 2021 08:25:59 -0500 Subject: [PATCH 18/42] Fix notes from win-builder --- R/attachments.R | 2 +- R/bulk-operation.R | 12 +++---- R/bulk-query.R | 10 +++--- R/create.R | 2 +- R/delete.R | 2 +- R/describe.R | 2 +- R/endpoints-bulk.R | 2 +- R/query.R | 2 +- R/read-metadata.R | 2 +- R/retrieve.R | 2 +- R/search.R | 2 +- R/update.R | 2 +- R/upsert.R | 2 +- R/utils-datatypes.R | 8 ++--- R/utils-org.R | 6 ++-- README.Rmd | 4 +-- README.md | 4 +-- cran-comments.md | 34 +++++++++++-------- docs/articles/supported-queries.html | 4 +-- docs/index.html | 4 +-- docs/reference/sf_auth.html | 2 +- docs/reference/sf_create.html | 2 +- docs/reference/sf_delete.html | 2 +- docs/reference/sf_describe_object_fields.html | 2 +- docs/reference/sf_describe_objects.html | 2 +- docs/reference/sf_download_attachment.html | 2 +- docs/reference/sf_format_date.html | 2 +- docs/reference/sf_format_datetime.html | 2 +- docs/reference/sf_format_time.data.frame.html | 2 +- docs/reference/sf_format_time.list.html | 2 +- docs/reference/sf_get_all_jobs_bulk.html | 4 +-- .../reference/sf_get_all_query_jobs_bulk.html | 4 +-- docs/reference/sf_get_deleted.html | 2 +- docs/reference/sf_get_updated.html | 2 +- docs/reference/sf_list_api_limits.html | 2 +- docs/reference/sf_list_objects.html | 2 +- docs/reference/sf_list_resources.html | 2 +- docs/reference/sf_list_rest_api_versions.html | 2 +- docs/reference/sf_query.html | 2 +- docs/reference/sf_query_bulk_v2.html | 2 +- docs/reference/sf_query_result_bulk.html | 2 +- docs/reference/sf_query_result_bulk_v2.html | 2 +- docs/reference/sf_retrieve.html | 2 +- docs/reference/sf_run_bulk_operation.html | 2 +- docs/reference/sf_run_bulk_query.html | 4 +-- docs/reference/sf_search.html | 2 +- docs/reference/sf_server_timestamp.html | 2 +- docs/reference/sf_update.html | 2 +- docs/reference/sf_upsert.html | 2 +- docs/reference/sf_user_info.html | 2 +- .../validate_get_all_jobs_params.html | 2 +- index.Rmd | 4 +-- index.md | 4 +-- inst/WORDLIST | 1 + man/sf_create.Rd | 2 +- man/sf_delete.Rd | 2 +- man/sf_describe_object_fields.Rd | 2 +- man/sf_describe_objects.Rd | 2 +- man/sf_download_attachment.Rd | 2 +- man/sf_format_date.Rd | 2 +- man/sf_format_datetime.Rd | 2 +- man/sf_format_time.data.frame.Rd | 2 +- man/sf_format_time.list.Rd | 2 +- man/sf_get_all_jobs_bulk.Rd | 4 +-- man/sf_get_all_query_jobs_bulk.Rd | 4 +-- man/sf_get_deleted.Rd | 2 +- man/sf_get_updated.Rd | 2 +- man/sf_query.Rd | 2 +- man/sf_query_bulk_v2.Rd | 2 +- man/sf_query_result_bulk.Rd | 2 +- man/sf_query_result_bulk_v2.Rd | 2 +- man/sf_retrieve.Rd | 2 +- man/sf_run_bulk_operation.Rd | 2 +- man/sf_run_bulk_query.Rd | 4 +-- man/sf_search.Rd | 2 +- man/sf_update.Rd | 2 +- man/sf_upsert.Rd | 2 +- man/sf_user_info.Rd | 2 +- man/validate_get_all_jobs_params.Rd | 2 +- vignettes/supported-queries.Rmd | 4 +-- 80 files changed, 125 insertions(+), 120 deletions(-) diff --git a/R/attachments.R b/R/attachments.R index 52019d5b..65e24d7c 100644 --- a/R/attachments.R +++ b/R/attachments.R @@ -1,7 +1,7 @@ #' Download an Attachment #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' This function will allow you to download an attachment to disk based on the #' attachment body, file name, and path. diff --git a/R/bulk-operation.R b/R/bulk-operation.R index 18af2d9a..bd10159e 100644 --- a/R/bulk-operation.R +++ b/R/bulk-operation.R @@ -370,13 +370,13 @@ sf_get_job_bulk <- function(job_id, #' of the URL query string (i.e. after a question mark ("?") so that the result #' only returns information about jobs that meet that specific criteria. For #' more information, read the note below and/or the Salesforce documentation -#' \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/get_all_jobs.htm}{here}. +#' \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/get_all_jobs.htm}{here}. #' @param next_records_url character (leave as NULL); a string used internally #' by the function to paginate through to more records until complete #' @template api_type #' @template verbose #' @return A \code{tbl_df} of parameters defining the details of all bulk jobs -#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/get_all_jobs.htm} +#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/get_all_jobs.htm} #' @note parameterized_search_list elements that can be set to filter the results: #' \itemize{ #' \item{isPkChunkingEnabled}{A logical either TRUE or FALSE. TRUE only returns @@ -448,13 +448,13 @@ sf_get_all_jobs_bulk <- function(parameterized_search_list = #' of the URL query string (i.e. after a question mark ("?") so that the result #' only returns information about jobs that meet that specific criteria. For #' more information, read the note below and/or the Salesforce documentation -#' \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/query_get_all_jobs.htm}{here}. +#' \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/query_get_all_jobs.htm}{here}. #' @param next_records_url character (leave as NULL); a string used internally #' by the function to paginate through to more records until complete #' @template api_type #' @template verbose #' @return A \code{tbl_df} of parameters defining the details of all bulk jobs -#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/get_all_jobs.htm} +#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/get_all_jobs.htm} #' @note parameterized_search_list elements that can be set to filter the results: #' \itemize{ #' \item{isPkChunkingEnabled}{A logical either TRUE or FALSE. TRUE only returns @@ -925,7 +925,7 @@ sf_create_batches_bulk_v2 <- function(job_id, # encoded content. When job data is uploaded, it is converted to base64. This # conversion can increase the data size by approximately 50%. To account for # the base64 conversion increase, upload data that does not exceed 100 MB. - # https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/upload_job_data.htm + # https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/upload_job_data.htm if(is.null(batch_size)){ data_size <- object.size(input_data) numb_batches <- ceiling((as.numeric(data_size)/(1024^2))/100) # 100MB / (size converted to MB) @@ -1278,7 +1278,7 @@ sf_get_job_records_bulk_v2 <- function(job_id, #' Run Bulk Operation #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' This function is a convenience wrapper for submitting bulk API jobs #' diff --git a/R/bulk-query.R b/R/bulk-query.R index e5945782..85294b25 100644 --- a/R/bulk-query.R +++ b/R/bulk-query.R @@ -75,7 +75,7 @@ sf_submit_query_bulk <- function(job_id, #' @template api_type #' @template verbose #' @return \code{tbl_df}, formatted by Salesforce, containing query results -#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_bulk_query_intro.htm}{Bulk 1.0 documentation} and \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/queries.htm}{Bulk 2.0 documentation} +#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_bulk_query_intro.htm}{Bulk 1.0 documentation} and \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm}{Bulk 2.0 documentation} #' @examples #' \dontrun{ #' my_query <- "SELECT Id, Name FROM Account LIMIT 1000" @@ -217,7 +217,7 @@ sf_query_result_bulk_v1 <- function(job_id, #' @template api_type #' @template verbose #' @return \code{tbl_df}, formatted by Salesforce, containing query results -#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/queries.htm}{Bulk 2.0 documentation} +#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm}{Bulk 2.0 documentation} #' @examples #' \dontrun{ #' my_query <- "SELECT Id, Name FROM Account LIMIT 1000" @@ -449,7 +449,7 @@ sf_query_bulk_v1 <- function(soql, #' @template api_type #' @template verbose #' @return A \code{tbl_df} of the recordset returned by the query -#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/queries.htm}{Bulk 2.0 documentation} +#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm}{Bulk 2.0 documentation} #' @examples #' \dontrun{ #' # select all Ids from Account object (up to 1000) @@ -550,7 +550,7 @@ sf_query_bulk_v2 <- function(soql, #' Run bulk query #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' This function is a convenience wrapper for submitting and retrieving #' query API jobs from the Bulk 1.0 and Bulk 2.0 APIs. @@ -569,7 +569,7 @@ sf_query_bulk_v2 <- function(soql, #' @template api_type #' @template verbose #' @return A \code{tbl_df} of the recordset returned by the query -#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_bulk_query_intro.htm}{Bulk 1.0 documentation} and \href{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/queries.htm}{Bulk 2.0 documentation} +#' @references \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_bulk_query_intro.htm}{Bulk 1.0 documentation} and \href{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm}{Bulk 2.0 documentation} #' @examples #' \dontrun{ #' # select all Ids from Account object (up to 1000) diff --git a/R/create.R b/R/create.R index ae74bad3..ad740c1f 100644 --- a/R/create.R +++ b/R/create.R @@ -1,7 +1,7 @@ #' Create Records #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Adds one or more new records to your organization’s data. #' diff --git a/R/delete.R b/R/delete.R index b994562e..6cb5de5e 100644 --- a/R/delete.R +++ b/R/delete.R @@ -1,7 +1,7 @@ #' Delete Records #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Deletes one or more records from your organization’s data. #' diff --git a/R/describe.R b/R/describe.R index b828a0aa..e601d778 100644 --- a/R/describe.R +++ b/R/describe.R @@ -1,7 +1,7 @@ #' SObject Basic Information #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Describes the individual metadata for the specified object. #' diff --git a/R/endpoints-bulk.R b/R/endpoints-bulk.R index de51af2a..72fcb653 100644 --- a/R/endpoints-bulk.R +++ b/R/endpoints-bulk.R @@ -129,7 +129,7 @@ make_bulk_get_all_query_jobs_url <- function(parameterized_search_list = list(is #' #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/query_get_all_jobs.htm} +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/query_get_all_jobs.htm} #' @export validate_get_all_jobs_params <- function(parameterized_search_list, type="all"){ for (n in names(parameterized_search_list)){ diff --git a/R/query.R b/R/query.R index 30cedcf2..cb0b0a76 100644 --- a/R/query.R +++ b/R/query.R @@ -1,7 +1,7 @@ #' Perform SOQL Query #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Executes a query against the specified object and returns data that matches #' the specified criteria. diff --git a/R/read-metadata.R b/R/read-metadata.R index 3616ea4c..bb5e9ed9 100644 --- a/R/read-metadata.R +++ b/R/read-metadata.R @@ -75,7 +75,7 @@ sf_read_metadata <- function(metadata_type, object_names, verbose=FALSE){ #' Describe Object Fields #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' This function takes the name of an object in Salesforce and returns a description #' of the fields on that object by returning a tibble with one row per field. diff --git a/R/retrieve.R b/R/retrieve.R index 60ef1149..2f7e019f 100644 --- a/R/retrieve.R +++ b/R/retrieve.R @@ -1,7 +1,7 @@ #' Retrieve Records By Id #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Retrieves one or more new records to your organization’s data. #' diff --git a/R/search.R b/R/search.R index 134ba2bb..7073b4e2 100644 --- a/R/search.R +++ b/R/search.R @@ -1,7 +1,7 @@ #' Perform SOSL Search #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Searches for records in your organization’s data. #' diff --git a/R/update.R b/R/update.R index 8d8c41a1..ea7dde07 100644 --- a/R/update.R +++ b/R/update.R @@ -1,7 +1,7 @@ #' Update Records #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Updates one or more records to your organization’s data. #' diff --git a/R/upsert.R b/R/upsert.R index f1b857b3..0bb44a0a 100644 --- a/R/upsert.R +++ b/R/upsert.R @@ -1,7 +1,7 @@ #' Upsert Records #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Upserts one or more new records to your organization’s data. #' diff --git a/R/utils-datatypes.R b/R/utils-datatypes.R index f9f9e7bd..87981cc8 100644 --- a/R/utils-datatypes.R +++ b/R/utils-datatypes.R @@ -3,7 +3,7 @@ #' @note This function is meant to be used internally. Only use when debugging. #' @importFrom lubridate as_datetime #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/datafiles_date_format.htm} +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @export sf_format_datetime <- function(x){ format(as_datetime(x), "%Y-%m-%dT%H:%M:%SZ") @@ -13,7 +13,7 @@ sf_format_datetime <- function(x){ #' #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/datafiles_date_format.htm} +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @export sf_format_date <- function(x){ x <- as_datetime(format(x, "%Y-%m-%d 00:00:00"), tz=Sys.timezone()) @@ -30,7 +30,7 @@ sf_format_time <- function (x, ...) { #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/datafiles_date_format.htm} +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @export sf_format_time.list <- function(x){ lapply(x, FUN=function(xx){ @@ -48,7 +48,7 @@ sf_format_time.list <- function(x){ #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/datafiles_date_format.htm} +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @export sf_format_time.data.frame <- function(x){ x %>% diff --git a/R/utils-org.R b/R/utils-org.R index 1b6038cf..9ef5419b 100644 --- a/R/utils-org.R +++ b/R/utils-org.R @@ -1,7 +1,7 @@ #' Return Current User Info #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Retrieves personal information for the user associated with the current session. #' @@ -775,7 +775,7 @@ sf_merge <- function(master_id, #' Get Deleted Records from a Timeframe #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Retrieves the list of individual records that have been deleted within the given #' timespan for the specified object. @@ -847,7 +847,7 @@ sf_get_deleted <- function(object_name, #' Get Updated Records from a Timeframe #' #' @description -#' `r lifecycle::badge("maturing")` +#' `r lifecycle::badge("stable")` #' #' Retrieves the list of individual records that have been inserted or updated #' within the given timespan in the specified object. diff --git a/README.Rmd b/README.Rmd index c942f15b..a750c302 100644 --- a/README.Rmd +++ b/README.Rmd @@ -18,7 +18,7 @@ options(tibble.print_min = 5L, tibble.print_max = 5L) [![R Build Status](https://github.com/stevenmmortimer/salesforcer/workflows/R-CMD-check/badge.svg)](https://github.com/stevenmmortimer/salesforcer/actions?workflow=R-CMD-check) [![CRAN Status](https://www.r-pkg.org/badges/version/salesforcer)](https://cran.r-project.org/package=salesforcer) -[![Lifecycle: Maturing](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing) +[![Lifecycle: Stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable) [![Monthly Downloads](https://cranlogs.r-pkg.org/badges/last-month/salesforcer)](https://cran.r-project.org/package=salesforcer) [![Coverage Status](https://codecov.io/gh/stevenmmortimer/salesforcer/branch/main/graph/badge.svg)](https://codecov.io/gh/stevenmmortimer/salesforcer?branch=main) @@ -221,7 +221,7 @@ deleted_records For really large operations (inserts, updates, upserts, deletes, and queries) Salesforce provides the [Bulk 1.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_intro.htm) -and [Bulk 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/introduction_bulk_api_2.htm) +and [Bulk 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/introduction_bulk_api_2.htm) APIs. In order to use the Bulk APIs in {salesforcer} you can just add `api_type = "Bulk 1.0"` or `api_type = "Bulk 2.0"` to your functions and the operation will be executed using the Bulk APIs. It's that simple. diff --git a/README.md b/README.md index 3bd6cc53..3404484a 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Status](https://github.com/stevenmmortimer/salesforcer/workflows/R-CMD-check/bad [![CRAN Status](https://www.r-pkg.org/badges/version/salesforcer)](https://cran.r-project.org/package=salesforcer) [![Lifecycle: -Maturing](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing) +Stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable) [![Monthly Downloads](https://cranlogs.r-pkg.org/badges/last-month/salesforcer)](https://cran.r-project.org/package=salesforcer) [![Coverage @@ -242,7 +242,7 @@ For really large operations (inserts, updates, upserts, deletes, and queries) Salesforce provides the [Bulk 1.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_intro.htm) and -[Bulk 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/introduction_bulk_api_2.htm) +[Bulk 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/introduction_bulk_api_2.htm) APIs. In order to use the Bulk APIs in {salesforcer} you can just add `api_type = "Bulk 1.0"` or `api_type = "Bulk 2.0"` to your functions and the operation will be executed using the Bulk APIs. It’s that simple. diff --git a/cran-comments.md b/cran-comments.md index 9581d606..121c3c3f 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -2,21 +2,28 @@ ## Test environments -* local mac OS install, R-release 4.0.2 -* ubuntu 16.04 (on github actions), R-release, R 4.0.2 -* mac OS 10.15.5 (on github actions) R-release, R 4.0.2 -* Microsoft Windows Server 2019 10.0.17763 (on github actions) R-release, R 4.0.2 -* win-builder (R-devel) +* Local Mac OS install, R-release 4.0.2 +* Ubuntu 16.04 (on GitHub Actions), R-release, R 4.0.2 +* Mac OS 10.15.5 (on GitHub Actions) R-release, R 4.0.2 +* Microsoft Windows Server 2019 10.0.17763 (on GitHub Actions) R-release, R 4.0.2 +* win-builder (R-release 4.1.0) ## R CMD check results -checking CRAN incoming feasibility ... NOTE - Maintainer: 'Steven M. Mortimer ' +* checking CRAN incoming feasibility ... NOTE +Maintainer: 'Steven M. Mortimer ' -New maintainer: - Steven M. Mortimer -Old maintainer(s): - Steven M. Mortimer +New submission + +Package was archived on CRAN + +Possibly mis-spelled words in DESCRIPTION: + APIs (2:42, 5:64, 9:16) + JSON (9:59) + +CRAN repository db overrides: + X-CRAN-Comment: Archived on 2021-06-23 as check problems were not + corrected in time. 0 errors v | 0 warnings v | 1 note x @@ -24,7 +31,4 @@ Old maintainer(s): ## revdepcheck results -We checked 0 reverse dependencies, comparing R CMD check results across CRAN and dev versions of this package. - - * We saw 0 new problems - * We failed to check 0 packages +Not done for this version because the prior version was removed from CRAN. diff --git a/docs/articles/supported-queries.html b/docs/articles/supported-queries.html index 551218be..74dd3528 100644 --- a/docs/articles/supported-queries.html +++ b/docs/articles/supported-queries.html @@ -164,7 +164,7 @@

  • Async SOQL
  • Overview of queries in Bulk 1.0 API
    • -
  • Overview of queries in Bulk 2.0 API
    • +
  • Overview of queries in Bulk 2.0 API
    • @@ -488,7 +488,7 @@

  • Do you need a parent-to-child nested relationship query or will a child-to-parent lookup suffice?

    • -

  • Check out Salesforce’s Workbench tool to see how it builds out queries.

    • +

  • Check out Salesforce’s Workbench tool to see how it builds out queries.

  • Double check Salesforce’s SOQL reference guide to see whether your query is supported or limited in some way.

  • Review query unit tests at: https://github.com/StevenMMortimer/salesforcer/blob/main/tests/testthat/test-query.R. These unit tests were written to cover a variety of use cases and to track any changes made between newly released versions of the Salesforce API (typically 4 each year). These tests are an excellent source of examples that may be helpful in troubleshooting your own query.

  • diff --git a/docs/index.html b/docs/index.html index ef4cc8d7..35371273 100644 --- a/docs/index.html +++ b/docs/index.html @@ -304,7 +304,7 @@

    Bulk Operations

    -

    For really large operations (inserts, updates, upserts, deletes, and queries) Salesforce provides the Bulk 1.0 and Bulk 2.0 APIs. In order to use the Bulk APIs in {salesforcer} you can just add api_type = "Bulk 1.0" or api_type = "Bulk 2.0" to your functions and the operation will be executed using the Bulk APIs. It’s that simple.

    +

    For really large operations (inserts, updates, upserts, deletes, and queries) Salesforce provides the Bulk 1.0 and Bulk 2.0 APIs. In order to use the Bulk APIs in {salesforcer} you can just add api_type = "Bulk 1.0" or api_type = "Bulk 2.0" to your functions and the operation will be executed using the Bulk APIs. It’s that simple.

    The benefits of using the Bulk API for larger datasets is that the operation will reduce the number of individual API calls (organization usually have a limit on total calls) and batching the requests in bulk is usually quicker than running thousands of individuals calls when your data is large. Note: the Bulk 2.0 API does NOT guarantee the order of the data submitted is preserved in the output. This means that you must join on other data columns to match up the Ids that are returned in the output with the data you submitted. For this reason, Bulk 2.0 may not be a good solution for creating, updating, or upserting records where you need to keep track of the created Ids. The Bulk 2.0 API would be fine for deleting records where you only need to know which Ids were successfully deleted.

    # create contacts using the Bulk API
 n <- 2
@@ -483,7 +483,7 @@ 
    Dev status
    
 
      
 
    • R Build Status
      • 
 
    • CRAN Status
      • 
-
    • Lifecycle: Maturing
      • 
+
    • Lifecycle: Stable
      • 
 
    • Monthly Downloads
      • 
 
    • Coverage Status
      • 
 
    
diff --git a/docs/reference/sf_auth.html b/docs/reference/sf_auth.html
index 3459aed7..39d85bc6 100644
--- a/docs/reference/sf_auth.html
+++ b/docs/reference/sf_auth.html
@@ -191,7 +191,7 @@ 
    Log in to Salesforce
    -

    Stable lifecycle

    +

    Stable lifecycle

    Log in using Basic (Username-Password) or OAuth 2.0 authenticaion. OAuth does not require sharing passwords, but will require authorizing salesforcer as a connected app to view and manage your organization. You will be directed to diff --git a/docs/reference/sf_create.html b/docs/reference/sf_create.html index a096d5a4..d7ca8a15 100644 --- a/docs/reference/sf_create.html +++ b/docs/reference/sf_create.html @@ -186,7 +186,7 @@

    Create Records

    -

    Maturing lifecycle

    +

    Stable lifecycle

    Adds one or more new records to your organization’s data.

    diff --git a/docs/reference/sf_delete.html b/docs/reference/sf_delete.html index 45cdf8f3..15c7bd38 100644 --- a/docs/reference/sf_delete.html +++ b/docs/reference/sf_delete.html @@ -186,7 +186,7 @@

    Delete Records

    -

    Maturing lifecycle

    +

    Stable lifecycle

    Deletes one or more records from your organization’s data.

    diff --git a/docs/reference/sf_describe_object_fields.html b/docs/reference/sf_describe_object_fields.html index 7f2739a8..d8b73d16 100644 --- a/docs/reference/sf_describe_object_fields.html +++ b/docs/reference/sf_describe_object_fields.html @@ -187,7 +187,7 @@

    Describe Object Fields

    -

    Maturing lifecycle

    +

    Stable lifecycle

    This function takes the name of an object in Salesforce and returns a description of the fields on that object by returning a tibble with one row per field.

    diff --git a/docs/reference/sf_describe_objects.html b/docs/reference/sf_describe_objects.html index a348fd8b..bd084ebc 100644 --- a/docs/reference/sf_describe_objects.html +++ b/docs/reference/sf_describe_objects.html @@ -186,7 +186,7 @@

    SObject Basic Information

    -

    Maturing lifecycle

    +

    Stable lifecycle

    Describes the individual metadata for the specified object.

    diff --git a/docs/reference/sf_download_attachment.html b/docs/reference/sf_download_attachment.html index e7107651..09879c7b 100644 --- a/docs/reference/sf_download_attachment.html +++ b/docs/reference/sf_download_attachment.html @@ -187,7 +187,7 @@

    Download an Attachment

    -

    Maturing lifecycle

    +

    Stable lifecycle

    This function will allow you to download an attachment to disk based on the attachment body, file name, and path.

    diff --git a/docs/reference/sf_format_date.html b/docs/reference/sf_format_date.html index fc1d608d..bc2b1f80 100644 --- a/docs/reference/sf_format_date.html +++ b/docs/reference/sf_format_date.html @@ -196,7 +196,7 @@

    Note

    This function is meant to be used internally. Only use when debugging.

    See also

    -

    https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/datafiles_date_format.htm

    +

    https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm

    -

    Stable lifecycle

    +

    Stable lifecycle

    Lists information about limits in your org.

    diff --git a/docs/reference/sf_list_objects.html b/docs/reference/sf_list_objects.html index 1cb249dc..b871b686 100644 --- a/docs/reference/sf_list_objects.html +++ b/docs/reference/sf_list_objects.html @@ -186,7 +186,7 @@

    List Organization Objects and their Metadata

    -

    Stable lifecycle

    +

    Stable lifecycle

    Lists the available objects and their metadata for your organization’s data.

    diff --git a/docs/reference/sf_list_resources.html b/docs/reference/sf_list_resources.html index a9611def..413b941f 100644 --- a/docs/reference/sf_list_resources.html +++ b/docs/reference/sf_list_resources.html @@ -187,7 +187,7 @@

    List the Resources for an API

    -

    Stable lifecycle

    +

    Stable lifecycle

    Lists available resources for the specified API version, including resource name and URI.

    diff --git a/docs/reference/sf_list_rest_api_versions.html b/docs/reference/sf_list_rest_api_versions.html index 3f94c89c..5923711b 100644 --- a/docs/reference/sf_list_rest_api_versions.html +++ b/docs/reference/sf_list_rest_api_versions.html @@ -187,7 +187,7 @@

    List REST API Versions

    -

    Stable lifecycle

    +

    Stable lifecycle

    Lists summary information about each Salesforce version currently available, including the version, label, and a link to each version\'s root

    diff --git a/docs/reference/sf_query.html b/docs/reference/sf_query.html index 253f9b5e..a339aacb 100644 --- a/docs/reference/sf_query.html +++ b/docs/reference/sf_query.html @@ -187,7 +187,7 @@

    Perform SOQL Query

    -

    Maturing lifecycle

    +

    Stable lifecycle

    Executes a query against the specified object and returns data that matches the specified criteria.

    diff --git a/docs/reference/sf_query_bulk_v2.html b/docs/reference/sf_query_bulk_v2.html index 85646a12..78954c5b 100644 --- a/docs/reference/sf_query_bulk_v2.html +++ b/docs/reference/sf_query_bulk_v2.html @@ -283,7 +283,7 @@

    Value

    A tbl_df of the recordset returned by the query

    References

    -

    Bulk 2.0 documentation

    +

    Bulk 2.0 documentation

    Examples

    if (FALSE) {
diff --git a/docs/reference/sf_query_result_bulk.html b/docs/reference/sf_query_result_bulk.html
index 13ef4a3f..09ae3976 100644
--- a/docs/reference/sf_query_result_bulk.html
+++ b/docs/reference/sf_query_result_bulk.html
@@ -263,7 +263,7 @@ 
    Value
    
     
    tbl_df, formatted by Salesforce, containing query results
    
     
    References
    
 
-    
    Bulk 1.0 documentation and Bulk 2.0 documentation
    
+    
    Bulk 1.0 documentation and Bulk 2.0 documentation
    
 
     
    Examples
    
     
    if (FALSE) {
diff --git a/docs/reference/sf_query_result_bulk_v2.html b/docs/reference/sf_query_result_bulk_v2.html
index 70a57d00..5d4967db 100644
--- a/docs/reference/sf_query_result_bulk_v2.html
+++ b/docs/reference/sf_query_result_bulk_v2.html
@@ -260,7 +260,7 @@ 
    Value
    
     
    tbl_df, formatted by Salesforce, containing query results
    
     
    References
    
 
-    
    Bulk 2.0 documentation
    
+    
    Bulk 2.0 documentation
    
 
     
    Examples
    
     
    if (FALSE) {
diff --git a/docs/reference/sf_retrieve.html b/docs/reference/sf_retrieve.html
index def240de..62a2d930 100644
--- a/docs/reference/sf_retrieve.html
+++ b/docs/reference/sf_retrieve.html
@@ -186,7 +186,7 @@ 
    Retrieve Records By Id
    
     
    
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    Retrieves one or more new records to your organization’s data.
    
     
    
 
diff --git a/docs/reference/sf_run_bulk_operation.html b/docs/reference/sf_run_bulk_operation.html
index a9aa4af1..5cc60765 100644
--- a/docs/reference/sf_run_bulk_operation.html
+++ b/docs/reference/sf_run_bulk_operation.html
@@ -186,7 +186,7 @@ 
    Run Bulk Operation
    
     
    
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    This function is a convenience wrapper for submitting bulk API jobs
    
     
    
 
diff --git a/docs/reference/sf_run_bulk_query.html b/docs/reference/sf_run_bulk_query.html
index 8602dd2f..238ca89b 100644
--- a/docs/reference/sf_run_bulk_query.html
+++ b/docs/reference/sf_run_bulk_query.html
@@ -187,7 +187,7 @@ 
    Run bulk query
    
     
    
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    This function is a convenience wrapper for submitting and retrieving
 query API jobs from the Bulk 1.0 and Bulk 2.0 APIs.
    
     
    
@@ -300,7 +300,7 @@ 
    Value
    
     
    A tbl_df of the recordset returned by the query
    
     
    References
    
 
-    
    Bulk 1.0 documentation and Bulk 2.0 documentation
    
+    
    Bulk 1.0 documentation and Bulk 2.0 documentation
    
 
     
    Examples
    
     
    if (FALSE) {
diff --git a/docs/reference/sf_search.html b/docs/reference/sf_search.html
index 375a353f..9bba0e7b 100644
--- a/docs/reference/sf_search.html
+++ b/docs/reference/sf_search.html
@@ -186,7 +186,7 @@ 
    Perform SOSL Search
    
     
    
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    Searches for records in your organization’s data.
    
     
    
 
diff --git a/docs/reference/sf_server_timestamp.html b/docs/reference/sf_server_timestamp.html
index 7f27aea0..40c304bf 100644
--- a/docs/reference/sf_server_timestamp.html
+++ b/docs/reference/sf_server_timestamp.html
@@ -186,7 +186,7 @@ 
    Salesforce Server Timestamp
    
     
 
     
    
-    
    Stable lifecycle
    
+    
    Stable lifecycle
    
 
    Retrieves the current system timestamp from the API.
    
     
    
 
diff --git a/docs/reference/sf_update.html b/docs/reference/sf_update.html
index ff0b7aa5..6d4b757e 100644
--- a/docs/reference/sf_update.html
+++ b/docs/reference/sf_update.html
@@ -186,7 +186,7 @@ 
    Update Records
    
     
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    Updates one or more records to your organization’s data.
    
     
    
 
diff --git a/docs/reference/sf_upsert.html b/docs/reference/sf_upsert.html
index 8273f869..524caddd 100644
--- a/docs/reference/sf_upsert.html
+++ b/docs/reference/sf_upsert.html
@@ -186,7 +186,7 @@ 
    Upsert Records
    
     
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    Upserts one or more new records to your organization’s data.
    
     
    
 
diff --git a/docs/reference/sf_user_info.html b/docs/reference/sf_user_info.html
index bd1c61bf..551b1267 100644
--- a/docs/reference/sf_user_info.html
+++ b/docs/reference/sf_user_info.html
@@ -186,7 +186,7 @@ 
    Return Current User Info
    
     
 
     
    
-    
    Maturing lifecycle
    
+    
    Stable lifecycle
    
 
    Retrieves personal information for the user associated with the current session.
    
     
    
 
diff --git a/docs/reference/validate_get_all_jobs_params.html b/docs/reference/validate_get_all_jobs_params.html
index 0c282575..2e678a58 100644
--- a/docs/reference/validate_get_all_jobs_params.html
+++ b/docs/reference/validate_get_all_jobs_params.html
@@ -196,7 +196,7 @@ 
    Note
    
     
    This function is meant to be used internally. Only use when debugging.
    
     
    See also
    
 
-    
    https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/query_get_all_jobs.htm
    
+    
    https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/query_get_all_jobs.htm
    
 
   
   
 
@@ -103,7 +103,7 @@
       
      
         
    • 
   
      pkgdown 1.5.1.
      
+  
      Site built with pkgdown 1.6.1.
      
 
      
 
       
diff --git a/docs/CODE_OF_CONDUCT.html b/docs/CODE_OF_CONDUCT.html
index 167b17bc..4e44ada9 100644
--- a/docs/CODE_OF_CONDUCT.html
+++ b/docs/CODE_OF_CONDUCT.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
        
         
      • 
   
        pkgdown 1.5.1.
        
+  
        Site built with pkgdown 1.6.1.
        
 
        
 
       
diff --git a/docs/CONTRIBUTING.html b/docs/CONTRIBUTING.html
index c041904b..694ee1fc 100644
--- a/docs/CONTRIBUTING.html
+++ b/docs/CONTRIBUTING.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
          
         
        • 
   
          usethis::create_from_github("StevenMMortimer/salesforcer", fork = TRUE)
          
 
            
 
          • Install all development dependences with devtools::install_dev_deps(), and then make sure the package passes R CMD check by running devtools::check(). If R CMD check doesn’t pass cleanly, it’s a good idea to ask for help before continuing.
            • 
-
          • Create a Git branch for your pull request (PR). We recommend using usethis::pr_init("brief-description-of-change").
            • 
-
          • Make your changes, commit to git, and then create a PR by running usethis::pr_push(), and following the prompts in your browser. The title of your PR should briefly describe the change. The body of your PR should contain Fixes #issue-number.
            • 
+
          • Create a Git branch for your pull request (PR). We recommend using usethis::pr_init("brief-description-of-change").
            • 
+
          • Make your changes, commit to git, and then create a PR by running usethis::pr_push(), and following the prompts in your browser. The title of your PR should briefly describe the change. The body of your PR should contain Fixes #issue-number.
            • 
 
          • For user-facing changes, add a bullet to the top of NEWS.md (i.e. just below the first header). Follow the style described in https://style.tidyverse.org/news.html.
            • 
 
          
 
@@ -242,7 +242,7 @@ 
          Contents
          
 
 
 
          
-  
          Site built with pkgdown 1.5.1.
          
+  
          Site built with pkgdown 1.6.1.
          
 
          
 
       
diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html
index a59281ba..8646a4f2 100644
--- a/docs/LICENSE-text.html
+++ b/docs/LICENSE-text.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
            
         
          • 
   
            pkgdown 1.5.1.
            
+  
            Site built with pkgdown 1.6.1.
            
 
            
 
       
diff --git a/docs/LICENSE.html b/docs/LICENSE.html
index ef054811..1e2d1d68 100644
--- a/docs/LICENSE.html
+++ b/docs/LICENSE.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
              
         
            • 
   
              pkgdown 1.5.1.
              
+  
              Site built with pkgdown 1.6.1.
              
 
              
 
       
diff --git a/docs/SECURITY.html b/docs/SECURITY.html
index e93199a3..0bb14a38 100644
--- a/docs/SECURITY.html
+++ b/docs/SECURITY.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
                
         
              • 
   
                pkgdown 1.5.1.
                
+  
                Site built with pkgdown 1.6.1.
                
 
                
 
       
diff --git a/docs/SUPPORT.html b/docs/SUPPORT.html
index b55bfd8c..3c50a8da 100644
--- a/docs/SUPPORT.html
+++ b/docs/SUPPORT.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
                  
         
                • 
   
                  pkgdown 1.5.1.
                  
+  
                  Site built with pkgdown 1.6.1.
                  
 
                  
 
       
diff --git a/docs/articles/getting-started.html b/docs/articles/getting-started.html
index bc7422c3..cc533bed 100644
--- a/docs/articles/getting-started.html
+++ b/docs/articles/getting-started.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -54,7 +54,7 @@
       
                    
 
                  • 
   
                    library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
-sf_auth()
                    
+
                    +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
+sf_auth()
                    
 
                    Setting up your own Connected App for OAuth
                    
 
                    Just a note, that it’s not necessary to setup your own Connected App in Salesforce to use OAuth 2.0 authentication. The only difference is that the authentication will be run through the client created and associated with the {salesforcer} package. By using the package client, you will NOT be giving access to Salesforce to anyone, the package is just the medium for you to connect to your own data. If you wanted more control you would specify those options like so:
                    
-
                    options(salesforcer.consumer_key = "012345678901-99thisisatest99connected33app22key")
-options(salesforcer.consumer_secret = "Th1s1sMyConsumerS3cr3t")
+
                    +options(salesforcer.consumer_key = "012345678901-99thisisatest99connected33app22key")
+options(salesforcer.consumer_secret = "Th1s1sMyConsumerS3cr3t")
 
-sf_auth()
                    
+sf_auth()
                    
 
                    Using a proxy connection
                    
 
                    If you are required to connect to Salesforce via proxy you are able to specify all of those parameters as options, as well. For each call via httr these proxy settings will be passed along with the Salesforce authentication.
                    
-
                    options(salesforcer.proxy_url = "64.251.21.73") # IP or a named domain
-options(salesforcer.proxy_port = 8080)
-options(salesforcer.proxy_username = "user")
-options(salesforcer.proxy_password = "pass")
-options(salesforcer.proxy_auth = "ntlm")
+
                    +options(salesforcer.proxy_url = "64.251.21.73") # IP or a named domain
+options(salesforcer.proxy_port = 8080)
+options(salesforcer.proxy_username = "user")
+options(salesforcer.proxy_password = "pass")
+options(salesforcer.proxy_auth = "ntlm")
 
-sf_auth()
                    
+sf_auth()
                    
 
                    After logging in with sf_auth(), you can check your connectivity by looking at the information returned about the current user. It should be information about you!
                    
-
                    # pull down information of person logged in
+
                    +# pull down information of person logged in
 # it's a simple easy call to get started 
 # and confirm a connection to the APIs
-user_info <- sf_user_info()
-sprintf("Organization Id: %s", user_info$organizationId)
+user_info <- sf_user_info()
+sprintf("Organization Id: %s", user_info$organizationId)
 #> [1] "Organization Id: 00D6A0000003dN3UAI"
-sprintf("User Id: %s", user_info$userId)
-#> [1] "User Id: 0056A000000MPRjQAO"
                    
+sprintf("User Id: %s", user_info$userId)
+#> [1] "User Id: 0056A000000MPRjQAO"
                    
 
                    
 
                    
 
                    
 Creating records
                    
 
                    Salesforce has objects and those objects contain records. One default object is the “Contact” object. This example shows how to create two records in the Contact object.
                    
-
                    n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n))
-created_records <- sf_create(new_contacts, "Contact")
-created_records
+
                    +n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n))
+created_records <- sf_create(new_contacts, "Contact")
+created_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdQUAA0 TRUE   
-#> 2 0033s000014AdQVAA0 TRUE
                    
+#> 1 0033s000017uLwmAAE TRUE   
+#> 2 0033s000017uLwnAAE TRUE
                    
 
                    
 
                    
 
                    
 Retrieving records
                    
 
                    Retrieve pulls down a specific set of records and fields. It’s very similar to running a query, but doesn’t use SOQL. Here is an example where we retrieve the data we just created.
                    
-
                    retrieved_records <- sf_retrieve(ids=created_records$id,
-                                 fields=c("FirstName", "LastName"),
-                                 object_name="Contact")
-retrieved_records
+
                    +retrieved_records <- sf_retrieve(ids=created_records$id, 
+                                 fields=c("FirstName", "LastName"), 
+                                 object_name="Contact")
+retrieved_records
 #> # A tibble: 2 x 4
 #>   sObject Id                 FirstName LastName        
 #>   <chr>   <chr>              <chr>     <chr>           
-#> 1 Contact 0033s000014AdQUAA0 Test      Contact-Create-1
-#> 2 Contact 0033s000014AdQVAA0 Test      Contact-Create-2
                    
+#> 1 Contact 0033s000017uLwmAAE Test      Contact-Create-1
+#> 2 Contact 0033s000017uLwnAAE Test      Contact-Create-2
                    
 
                    
 
                    
 
                    
 Querying records
                    
 
                    Salesforce has proprietary form of SQL called SOQL (Salesforce Object Query Language). SOQL is a powerful tool that allows you to return the fields of records in almost any object in Salesforce including Accounts, Contacts, Tasks, Opportunities, even Attachments! Below is an example where we grab the data we just created including Account object information for which the Contact record is associated with.
                    
-
                    my_soql <- sprintf("SELECT Id, 
+
                    +my_soql <- sprintf("SELECT Id, 
                            Account.Name, 
                            FirstName, 
                            LastName 
                     FROM Contact 
-                    WHERE Id in ('%s')",
-                   paste0(created_records$id , collapse="','"))
+                    WHERE Id in ('%s')", 
+                   paste0(created_records$id , collapse="','"))
 
-queried_records <- sf_query(my_soql)
-queried_records
+queried_records <- sf_query(my_soql)
+queried_records
 #> # A tibble: 2 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
-#> 1 0033s000014AdQUAA0 Test      Contact-Create-1
-#> 2 0033s000014AdQVAA0 Test      Contact-Create-2
                    
+#> 1 0033s000017uLwmAAE Test      Contact-Create-1
+#> 2 0033s000017uLwnAAE Test      Contact-Create-2
                    
 
                    NOTE: In the example above, you’ll notice that the "Account.Name" column does not appear in the results. This is because the SOAP and REST APIs only return an empty Account object for the record if there is no relationship to an account ( see #78). There is no reliable way to extract and rebuild the empty columns based on the query string. If there were Account information, an additional column titled "Account.Name" would appear in the results. Note, that the Bulk 1.0 and Bulk 2.0 APIs will return "Account.Name" as a column of all NA values for this query because they return results differently.
                    
 
                    
 
                    
 
                    
 Updating records
                    
 
                    After creating records you can update them using sf_update(). Updating a record requires you to pass the Salesforce Id of the record. Salesforce creates a unique 18-character identifier on each record and uses that to know which record to attach the update information you provide. Simply include a field or column in your update dataset called “Id” and the information will be matched. Here is an example where we update each of the records we created earlier with a new first name called “TestTest”.
                    
-
                    # Update some of those records
-queried_records <- queried_records %>%
-  mutate(FirstName = "TestTest")
+
                    +# Update some of those records
+queried_records <- queried_records %>%
+  mutate(FirstName = "TestTest")
 
-updated_records <- sf_update(queried_records, object_name="Contact")
-updated_records
+updated_records <- sf_update(queried_records, object_name="Contact")
+updated_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdQUAA0 TRUE   
-#> 2 0033s000014AdQVAA0 TRUE
                    
+#> 1 0033s000017uLwmAAE TRUE   
+#> 2 0033s000017uLwnAAE TRUE
                    
 
                    
 
                    
 
                    
 Deleting records
                    
 
                    You can also delete records in Salesforce. The method implements a “soft” delete meaning that the deleted records go to the Recycle Bin which can be emptied or queried against later in the event that the record needed.
                    
-
                    deleted_records <- sf_delete(updated_records$id)
-deleted_records
+
                    +deleted_records <- sf_delete(updated_records$id)
+deleted_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdQUAA0 TRUE   
-#> 2 0033s000014AdQVAA0 TRUE
                    
+#> 1 0033s000017uLwmAAE TRUE   
+#> 2 0033s000017uLwnAAE TRUE
                    
 
                    
 
                    
 
                    
 Upserting records
                    
-
                    Finally, Salesforce has a unique method called “upsert” that allows you to create and/or update records at the same time. More specifically, if the record is not found based an an “External Id” field, then Salesforce will create the record instead of updating one. Below is an example where we create 2 records, then upsert 3, where 2 are matched and updated and one is created. NOTE: You will need to create a custom field on the target object and ensure it is labeled as an “External Id” field. Read more at: http://blog.jeffdouglas.com/2010/05/07/using-exernal-id-fields-in-salesforce/.
                    
-
                    n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n),
-                       My_External_Id__c=letters[1:n])
-created_records <- sf_create(new_contacts, "Contact")
+
                    Finally, Salesforce has a unique method called “upsert” that allows you to create and/or update records at the same time. More specifically, if the record is not found based an an “External Id” field, then Salesforce will create the record instead of updating one. Below is an example where we create 2 records, then upsert 3, where 2 are matched and updated and one is created. NOTE: You will need to create a custom field on the target object and ensure it is labeled as an “External Id” field. Read more at: https://blog.jeffdouglas.com/2010/05/07/using-exernal-id-fields-in-salesforce/.
                    
+
                    +n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n), 
+                       My_External_Id__c=letters[1:n])
+created_records <- sf_create(new_contacts, "Contact")
 
-upserted_contacts <- tibble(FirstName = rep("Test", n),
-                            LastName = paste0("Contact-Upsert-", 1:n),
-                            My_External_Id__c=letters[1:n])
-new_record <- tibble(FirstName = "Test",
-                     LastName = paste0("Contact-Upsert-", n+1),
-                     My_External_Id__c=letters[n+1])
-upserted_contacts <- bind_rows(upserted_contacts, new_record)
+upserted_contacts <- tibble(FirstName = rep("Test", n),
+                            LastName = paste0("Contact-Upsert-", 1:n), 
+                            My_External_Id__c=letters[1:n])
+new_record <- tibble(FirstName = "Test",
+                     LastName = paste0("Contact-Upsert-", n+1), 
+                     My_External_Id__c=letters[n+1])
+upserted_contacts <- bind_rows(upserted_contacts, new_record)
 
-upserted_records <- sf_upsert(input_data=upserted_contacts,
-                              object_name="Contact",
-                              external_id_fieldname="My_External_Id__c")
-upserted_records
+upserted_records <- sf_upsert(input_data=upserted_contacts, 
+                              object_name="Contact", 
+                              external_id_fieldname="My_External_Id__c")
+upserted_records
 #> # A tibble: 3 x 3
 #>   id                 success created
 #>   <chr>              <lgl>   <lgl>  
-#> 1 0033s000014AdQZAA0 TRUE    FALSE  
-#> 2 0033s000014AdQaAAK TRUE    FALSE  
-#> 3 0033s000014AdQeAAK TRUE    TRUE
                    
+#> 1 0033s000017uM3VAAU TRUE    FALSE  
+#> 2 0033s000017uM3WAAU TRUE    FALSE  
+#> 3 0033s000017uM3aAAE TRUE    TRUE
                    
 
                    
 
                    
 
                    
 Check out the Tests
                    
-
                    The {salesforcer} package has quite a bit of unit test coverage to track any changes made between newly released versions of the Salesforce API (typically 4 each year). These tests are an excellent source of examples because they cover most all cases of utilizing the package functions. You can access them here: https://github.com/StevenMMortimer/salesforcer/blob/main/tests/testthat/
                    
+
                    The {salesforcer} package has quite a bit of unit test coverage to track any changes made between newly released versions of the Salesforce API (typically 4 each year). These tests are an excellent source of examples because they cover most all cases of utilizing the package functions. You can access them here: https://github.com/StevenMMortimer/salesforcer/tree/main/tests/testthat/
                    
 
                    
   
                    
 
@@ -307,7 +317,7 @@ 
                    
 
                    
 
 
                    
-  
                    Site built with pkgdown 1.5.1.
                    
+  
                    Site built with pkgdown 1.6.1.
                    
 
                    
 
       
diff --git a/docs/articles/getting-started_files/header-attrs-2.9/header-attrs.js b/docs/articles/getting-started_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/getting-started_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/index.html b/docs/articles/index.html
index 8d5f1f2e..aedf8deb 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                    
 
@@ -103,7 +103,7 @@
       
                      
         
                    • 
   
                      pkgdown 1.5.1.
                      
+  
                      Site built with pkgdown 1.6.1.
                      
 
                      
 
       
diff --git a/docs/articles/passing-control-args.html b/docs/articles/passing-control-args.html
index 2c5f417a..5437dc4f 100644
--- a/docs/articles/passing-control-args.html
+++ b/docs/articles/passing-control-args.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -54,7 +54,7 @@
       
                        
 
                      • 
   
                        The new control argument
                        
 
                        This new feature can be seen in the sf_create (and many other functions) as control=list(...). The dots mean that you can pass any number of controls directly into the function.
                        
 
                        First, authenticate and load any required packages for your analysis.
                        
-
                        library(salesforcer)
-sf_auth()
                        
+
 
                        In the example below, we demonstrate how to create a record, but use the control arguments to prevent its creation from showing up in the Chatter feeds by setting the DisableFeedTrackingHeader.
                        
-
                        new_contact <- c(FirstName = "Jenny",
-                 LastName = "Williams",
-                 Email = "jennyw@gmail.com")
-record1 <- sf_create(new_contact,
-                     object_name = "Contact",
-                     DisableFeedTrackingHeader = list(disableFeedTracking = TRUE))
-record1
+
                        +new_contact <- c(FirstName = "Jenny", 
+                 LastName = "Williams", 
+                 Email = "jennyw@gmail.com")
+record1 <- sf_create(new_contact,
+                     object_name = "Contact",
+                     DisableFeedTrackingHeader = list(disableFeedTracking = TRUE))
+record1
 #> # A tibble: 1 x 2
 #>   success errors    
 #>   <lgl>   <list>    
-#> 1 FALSE   <list [1]>
                        
+#> 1 FALSE   <list [1]>
                        
 
                        You will notice that the argument DisableFeedTrackingHeader can be included right into the function without any documentation existing for it in the sf_create function. This is because the dots (...) allow you to pass over a dozen different control parameters and that documentation would be tedious to create and maintain over multiple functions in the package. However, you will notice in the documentation entry for the control argument there is a link to a function called sf_control which you can use to directly to pass into control or simply to review its documentation of all the possible control parameters and their defaults. This is where you can review the various control options in more detail before trying to set them.
                        
 
                        You may have also noticed that the argument DisableFeedTrackingHeader was formatted as a list with an element inside called disableFeedTracking set to TRUE. This may seem redundant but there are two reasons for this. First, this is exactly how the Salesforce APIs documents these options, which are typically referred to as “headers” because they are passed as a named header of the HTTP request and then the header fields and values are provided for that header. Second, some headers have multiple fields and values so a list is the only way to provide multiple named fields and values under a single header entity.
                        
 
                        
@@ -175,65 +177,68 @@ 
                        
 
                      • runAsCurrentUser - Make sure that sharing rules for the current user are enforced when duplicate rules run by setting this property to true. Use the sharing rules specified in the class for the request by setting this property to false. If no sharing rules are specified, Apex code runs in system context and sharing rules for the current user are not enforced.
                        • 
 
 
                        Specifying these arguments requires a list structure in R, which may seem redundant in some cases, but is necessary to follow in order to build the API request correctly.
                        
-
                        # override the duplicate rules ...
-record2 <- sf_create(new_contact,
-                     object_name = "Contact",
-                     DuplicateRuleHeader = list(allowSave = TRUE,
-                                                includeRecordDetails = FALSE,
-                                                runAsCurrentUser = TRUE))
-record2
+
                        +# override the duplicate rules ...
+record2 <- sf_create(new_contact,
+                     object_name = "Contact",
+                     DuplicateRuleHeader = list(allowSave = TRUE, 
+                                                includeRecordDetails = FALSE, 
+                                                runAsCurrentUser = TRUE))
+record2
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdQjAAK TRUE
+#> 1 0033s000017uM3fAAE TRUE
 
 # ... or succumb to the duplicate rules
-record3 <- sf_create(new_contact,
-                     object_name = "Contact",
-                     DuplicateRuleHeader = list(allowSave = FALSE,
-                                                includeRecordDetails = FALSE,
-                                                runAsCurrentUser = TRUE))
-record3
+record3 <- sf_create(new_contact,
+                     object_name = "Contact",
+                     DuplicateRuleHeader = list(allowSave = FALSE, 
+                                                includeRecordDetails = FALSE, 
+                                                runAsCurrentUser = TRUE))
+record3
 #> # A tibble: 1 x 2
 #>   success errors    
 #>   <lgl>   <list>    
-#> 1 FALSE   <list [1]>
                        
+#> 1 FALSE   <list [1]>
                        
 
                        Per the description above, note that setting allowSave=TRUE will not override rules where the “Action on Create” for a rule is set to “Block”. If the duplicate rule’s action is “Allow” with an alert, then setting allowSave=TRUE means the record will be created with no warning message. If allowSave=FALSE, then the record will be prevented from being created. For additional information on the DuplicateRuleHeader, please see the Salesforce documentation at: https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_header_duplicateruleheader.htm
                        
 
                        Finally, you may notice during your use that only certain control arguments are permitted based on the API. For example, the DuplicateRuleHeader is not implemented in the REST API like it is in the SOAP API. In the example below you should take note of two things:
                        
 
                          
 
                        1. When using the REST API and setting the DuplicateRuleHeader, then you will notice a warning that the header was ignored. You will receive warnings when trying to set any control parameters for an API or operation that does not recognize that particular control.
                          2. 
 
                        2. In this example, you cannot bypass the duplicate rule alert to create the record if using the REST API like you can with the SOAP API.
                          3. 
 
                        
-
                        record4 <- sf_create(new_contact,
-                     object_name = "Contact",
-                     DuplicateRuleHeader = list(allowSave = FALSE,
-                                                includeRecordDetails = FALSE,
-                                                runAsCurrentUser = TRUE),
-                     api_type = "REST")
+
                        +record4 <- sf_create(new_contact,
+                     object_name = "Contact",
+                     DuplicateRuleHeader = list(allowSave = FALSE, 
+                                                includeRecordDetails = FALSE, 
+                                                runAsCurrentUser = TRUE),
+                     api_type = "REST")
 #> Warning: Ignoring the following controls which are not used in the REST API:
 #> DuplicateRuleHeader
-record4
+record4
 #> # A tibble: 1 x 2
 #>   success errors    
 #>   <lgl>   <list>    
-#> 1 FALSE   <list [1]>
                        
+#> 1 FALSE   <list [1]>
                        
 
                        
 
                        
 
                        
 Creating the control argument with sf_control
                        
 
                        If this type of control structure is new to you, take a look at the documentation for the glm and glm.control functions. The way these two functions behave is exactly how functions like sf_create and sf_control work with each other. As demonstrated above you can pass any number of arbitrary controls into the function and they are all gathered up into the control by control = list(...). However, you can specify the control directly like this:
                        
-
                        sf_query("SELECT Id, Name FROM Account LIMIT 1000",
-         object_name = "Account",
-         control = sf_control(QueryOptions = list(batchSize = 200)))
-#> # A tibble: 11 x 2
+
                        +sf_query("SELECT Id, Name FROM Account LIMIT 1000",
+         object_name = "Account",
+         control = sf_control(QueryOptions = list(batchSize = 200)))
+#> # A tibble: 15 x 2
 #>   Id                 Name                                
 #>   <chr>              <chr>                               
 #> 1 0013s00000zFgA6AAK KEEP Test Account With Child Records
 #> 2 0013s00000zFdugAAC KEEP Test Account With Child Records
-#> 3 0016A0000035mJEQAY GenePoint                           
-#> 4 0016A0000035mJCQAY United Oil & Gas, UK                
-#> 5 0016A0000035mJDQAY United Oil & Gas, Singapore         
-#> # … with 6 more rows
                        
+#> 3 0013s000014jF2vAAE Test Account For Performance Test   
+#> 4 0016A0000035mJEQAY GenePoint                           
+#> 5 0016A0000035mJCQAY United Oil & Gas, UK                
+#> # … with 10 more rows
                        
 
                        
 
                        
 
                        
@@ -290,7 +295,7 @@ 
                        
 
                        
 
 
                        
-  
                        Site built with pkgdown 1.5.1.
                        
+  
                        Site built with pkgdown 1.6.1.
                        
 
                        
 
       
diff --git a/docs/articles/passing-control-args_files/header-attrs-2.9/header-attrs.js b/docs/articles/passing-control-args_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/passing-control-args_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/supported-queries.html b/docs/articles/supported-queries.html
index 74dd3528..999da8fc 100644
--- a/docs/articles/supported-queries.html
+++ b/docs/articles/supported-queries.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                        
 
@@ -54,7 +54,7 @@
       
                          
 
                        • 
   
                          Authentication
                          
 
                          First, load the {salesforcer} package and login. There are two ways to authenticate: 1) OAuth 2.0 (SSO) and 2) Basic Username-Password. It is recommended to use OAuth 2.0 so that passwords do not have to be embedded in scripts or environment variables. By default, OAuth 2.0 stores the user’s credentials in a locally cached file entitled “.httr-oauth-salesforcer” in the current working directory and will be refreshed automatically when the session expires.
                          
-
                          library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
-sf_auth()
                          
+
                          +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
+sf_auth()
                          
 
                          
 
                          
 
                          
 Default query behavior
                          
 
                          The default API for the sf_query() function is the REST API because it is both fast and flexible. Every effort has been made so that the format of the results from the REST and SOAP APIs is exactly the same. The only difference will be speed. The REST API uses JSON, which can generally be processed more quickly than XML used in the SOAP API.
                          
-
                          soql <- "SELECT Id,
+
                          +soql <- "SELECT Id,
                 FirstName, 
                 LastName
          FROM Contact
          LIMIT 10"
 
-queried_records <- sf_query(soql) # REST API is the default api_type
-queried_records
+queried_records <- sf_query(soql) # REST API is the default api_type
+queried_records
 #> # A tibble: 10 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
 #> 1 0033s000013wlpjAAA Test      Contact-Create-1
 #> 2 0033s000013wlpkAAA Test      Contact-Create-2
-#> 3 0033s000014AG4HAAW Test      Contact-Create-1
-#> 4 0033s0000149ZoCAAU Test      Contact-Create-1
-#> 5 0033s0000149ZoDAAU Test      Contact-Create-2
+#> 3 0033s000014CRFoAAO Test      Contact-Create-1
+#> 4 0033s000014CRFpAAO Test      Contact-Create-2
+#> 5 0033s000014AG4HAAW Test      Contact-Create-1
 #> # … with 5 more rows
 
-queried_records <- sf_query(soql, api_type = "SOAP")
-queried_records
+queried_records <- sf_query(soql, api_type = "SOAP")
+queried_records
 #> # A tibble: 10 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
 #> 1 0033s000013wlpjAAA Test      Contact-Create-1
 #> 2 0033s000013wlpkAAA Test      Contact-Create-2
-#> 3 0033s000014AG4HAAW Test      Contact-Create-1
-#> 4 0033s0000149ZoCAAU Test      Contact-Create-1
-#> 5 0033s0000149ZoDAAU Test      Contact-Create-2
-#> # … with 5 more rows
                          
+#> 3 0033s000014CRFoAAO Test      Contact-Create-1
+#> 4 0033s000014CRFpAAO Test      Contact-Create-2
+#> 5 0033s000014AG4HAAW Test      Contact-Create-1
+#> # … with 5 more rows
                          
 
                          
 
                          
 
                          
 REST vs. SOAP API query performance test
                          
 
                          Below is a small example to roughly demonstrate the magnitude of the performance difference between the REST and SOAP APIs when querying 1,000 records.
                          
 
                          Setup performance test
                          
-
                          # create a new account 
+
                          +# create a new account 
 # (if replicating, you may or may not have an external id field in your Org)
-prefix <- paste0("APerfTest-", as.integer(runif(1,1,99999)))
-new_account <- sf_create(
-  tibble(
-    Name = "Test Account For Performance Test",
-    My_External_Id__c = prefix,
-    Description = paste0("This is a test account with 1,000 records for ",
-                         "testing the performance differences between the ",
-                         "SOAP and REST APIs.")
-  ),
-  object_name = "Account"
-)
+prefix <- paste0("APerfTest-", as.integer(runif(1,1,99999)))
+new_account <- sf_create(
+  tibble(
+    Name = "Test Account For Performance Test", 
+    My_External_Id__c = prefix,
+    Description = paste0("This is a test account with 1,000 records for ", 
+                         "testing the performance differences between the ", 
+                         "SOAP and REST APIs.")
+  ), 
+  object_name = "Account"
+)
 
 # create and associate a thousand new contacts with that account
 # (again, you may or may not have an external id field in your Org)
-n <- 1000
-prefix <- paste0("CPerfTest-", as.integer(runif(1,1,99999)), "-")
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Query-Vignette", 1:n),
-                       test_number__c = 999.9,
-                       AccountId = rep(new_account$id, n),
-                       My_External_Id__c=paste0(prefix, 1:n))
-new_contacts_res <- sf_create(new_contacts, "Contact", api_type = "Bulk 2.0")
                          
+n <- 1000
+prefix <- paste0("CPerfTest-", as.integer(runif(1,1,99999)), "-")
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Query-Vignette", 1:n), 
+                       test_number__c = 999.9,
+                       AccountId = rep(new_account$id, n),
+                       My_External_Id__c=paste0(prefix, 1:n))
+new_contacts_res <- sf_create(new_contacts, "Contact", api_type = "Bulk 2.0")
                          
 
                          Performance test
                          
-
                          qry <- function(api_type){
-  sf_query(
-    sprintf("SELECT Id, Name, Owner.Id, 
+
                          +qry <- function(api_type){
+  sf_query(
+    sprintf("SELECT Id, Name, Owner.Id, 
                (SELECT Id, LastName, Owner.Id FROM Contacts) 
             FROM Account
-            WHERE Id = '%s'",
-            new_account$id),
-    api_type = api_type
-  )
-}
-res <- microbenchmark::microbenchmark(
-  qry("REST"),
-  qry("SOAP"),
-  times = 5,
-  unit = "s"
-)
-res
+            WHERE Id = '%s'", 
+            new_account$id), 
+    api_type = api_type
+  )
+}
+res <- microbenchmark::microbenchmark(
+  qry("REST"),
+  qry("SOAP"),
+  times = 5, 
+  unit = "s"
+)
+res
 #> Unit: seconds
-#>         expr       min        lq      mean    median        uq      max neval
-#>  qry("REST") 0.5290675 0.5866569 0.7599904 0.8234205 0.8272156 1.033592     5
-#>  qry("SOAP") 2.7185003 2.9724736 3.2149618 3.2690952 3.2703491 3.844390     5
+#>         expr       min        lq      mean    median       uq       max neval
+#>  qry("REST")  2.993883  3.049738  4.115384  3.824167  4.37407  6.335064     5
+#>  qry("SOAP") 16.932824 17.222654 19.531516 18.276266 21.75184 23.473992     5
 
-suppressWarnings(suppressMessages(
-  ggplot2::autoplot(res) +
-    ggplot2::scale_y_continuous(name="Time [seconds]", n.breaks=6)
-))
                          
+suppressWarnings(suppressMessages(
+  ggplot2::autoplot(res) + 
+    ggplot2::scale_y_continuous(name="Time [seconds]", n.breaks=6)
+))
                          
 
                          
 
                          As seen in the limited test above, the REST API can be anywhere from 4-6x faster than the SOAP API for a query on 1,000 contact records associated with a single Account. Breaking up the number of records returned into smaller batches by setting QueryOptions = list(batchSize = 200) typically does not affect this result very much but it also depends on the number of fields in the query. For the REST API the default is 2,000 records per batch with a minimum of 200 and maximum of 2,000. For the SOAP API the default is 500 records per batch. For both APIs it is important to note that there is no guarantee that the requested batch size is the actual batch size. Changes are made as necessary to maximize performance. For example, the SOAP API states “batch size will be no more than 200 if the SOQL statement selects two or more custom fields of type long text”. The REST API mentions that the limit imposed by Salesforce’s app servers is around 20,000 characters which can cause batches to be smaller. In short, it’s generally okay to use the default batch sizes since Salesforce may optimize over your specified batch size anyways.
                          
 
                          
@@ -273,49 +277,51 @@ 
                          
 
                          
 When to use the Bulk APIs for queries
                          
 
                          A general rule of thumb for using the Bulk APIs (Bulk 1.0 and Bulk 2.0) for queries is anytime you need to retrieve more than 10,000 records. The main reasons to not use the Bulk APIs are twofold. First, they do not support complex relationship queries or aggregate queries. If you need to write a nested relationship or aggregate query involving a large number of records you may be tempted to use the REST API. However, it is recommended to perform two or more separate bulk queries that retrieve the records you need and then join or aggregate the results in R.
                          
-
                          # nested relationship query 
+
                          +# nested relationship query 
 # (supposed to return the id and first name of all contacts on each account)
-try(
-  sf_query(
+try(
+  sf_query(
     "SELECT Id, Name, 
       (SELECT Id, FirstName FROM Contacts)
     FROM Account",
-    api_type = "Bulk 2.0"
-  )
-)
-#> Request failed [400]. Retrying in 1.3 seconds...
-#> Request failed [400]. Retrying in 3.9 seconds...
+    api_type = "Bulk 2.0"
+  )
+)
+#> Request failed [400]. Retrying in 1 seconds...
+#> Request failed [400]. Retrying in 2.2 seconds...
 #> Error : API_ERROR: Aggregate Relationships not supported in Bulk V2 Query with CSV content type
 
 # aggregate query
 # (supposed to return the count of contacts per account)
-try(
-  sf_query(
+try(
+  sf_query(
     "SELECT Account.Id, Count(Name) contacts_n
     FROM Contact
-    GROUP BY Account.Id",
-    api_type = "Bulk 2.0"
-  )
-)
-#> Request failed [400]. Retrying in 1.3 seconds...
-#> Request failed [400]. Retrying in 1 seconds...
-#> Error : API_ERROR: Aggregate Relationships not supported in Bulk Query
                          
+    GROUP BY Account.Id",  
+    api_type = "Bulk 2.0"
+  )
+)
+#> Request failed [400]. Retrying in 1.5 seconds...
+#> Request failed [400]. Retrying in 2.1 seconds...
+#> Error : API_ERROR: Aggregate Relationships not supported in Bulk Query
                          
 
                          The two queries above were trying to pull all the contacts for each account and then get a count of how many contacts there are per account. If you have a lot of records, using the REST API to return these results may not be feasible. Even though the Bulk APIs cannot handle the same query, they can pull down massive amounts of data quickly. In this case you can pull down all of the Contact records and all of the Account records and then perform the calculation using dplyr, like so:
                          
-
                          contacts <- sf_query("SELECT Id, FirstName, Account.Id
-                     FROM Contact",
-                     api_type = "Bulk 2.0")
+
                          +contacts <- sf_query("SELECT Id, FirstName, Account.Id
+                     FROM Contact", 
+                     api_type = "Bulk 2.0")
 
-accounts <- sf_query("SELECT Id, Name 
-                     FROM Account",
-                     api_type = "Bulk 2.0")
+accounts <- sf_query("SELECT Id, Name 
+                     FROM Account", 
+                     api_type = "Bulk 2.0")
 
-nested_query_recs <- accounts %>%
-  left_join(contacts %>%
-              rename(`Contact.Id` = Id,
-                     `Contact.FirstName` = FirstName),
-            by = c("Id" = "Account.Id"))
-nested_query_recs
-#> # A tibble: 415 x 4
+nested_query_recs <- accounts %>% 
+  left_join(contacts %>% 
+              rename(`Contact.Id` = Id, 
+                     `Contact.FirstName` = FirstName), 
+            by = c("Id" = "Account.Id"))
+nested_query_recs
+#> # A tibble: 1,515 x 4
 #>   Id              Name                         Contact.Id       Contact.FirstNa…
 #>   <chr>           <chr>                        <chr>            <chr>           
 #> 1 0013s00000zFdu… KEEP Test Account With Chil… 0033s000012Nkzw… KEEP            
@@ -323,70 +329,73 @@ 
                          
 #> 3 0013s00000zFdu… KEEP Test Account With Chil… 0033s000012Nkzy… KEEP            
 #> 4 0013s00000zFdu… KEEP Test Account With Chil… 0033s000012Nkzz… KEEP            
 #> 5 0013s00000zFdu… KEEP Test Account With Chil… 0033s000012Nl00… KEEP            
-#> # … with 410 more rows
+#> # … with 1,510 more rows
 
-aggregate_query_recs <- nested_query_recs %>%
-  group_by(Id) %>%
-  summarize(.groups = 'drop',
-            contacts_n = sum(!is.na(Contact.Id)))
-aggregate_query_recs
-#> # A tibble: 12 x 2
+aggregate_query_recs <- nested_query_recs %>% 
+  group_by(Id) %>%
+  summarize(.groups = 'drop', 
+            contacts_n = sum(!is.na(Contact.Id)))
+aggregate_query_recs
+#> # A tibble: 16 x 2
 #>   Id                 contacts_n
 #>   <chr>                   <int>
 #> 1 0013s00000zFdugAAC        300
 #> 2 0013s00000zFgA6AAK          0
-#> 3 0013s000011JhcyAAC         99
-#> 4 0016A0000035mJ4QAI          2
-#> 5 0016A0000035mJ5QAI          1
-#> # … with 7 more rows
                          
+#> 3 0013s000014jF2HAAU          0
+#> 4 0013s000014jF2vAAE          0
+#> 5 0013s000014jFj6AAE         99
+#> # … with 11 more rows
                          
 
                          The second reason to not use the Bulk APIs is that there is a performance overhead associated with every bulk (asynchronous) job that involves checking the status of the job until it succeeds or fails before retrieving the results.
                          
 
                          The example below is provided so that you can take this code as an example to run your own performance test of queries that return 10K, 100K, 1M+ records to see where the Bulk APIs outperform the REST API.
                          
-
                          qry_compare <- function(api_type){
-  soql <- sprintf("SELECT Id, LastName, Account.Id, Account.Name, Owner.Id
+
                          +qry_compare <- function(api_type){
+  soql <- sprintf("SELECT Id, LastName, Account.Id, Account.Name, Owner.Id
                    FROM Contact
-                   WHERE Account.Id = '%s'",
-                   new_account$id)
-  sf_query(soql, api_type = api_type)
-}
+                   WHERE Account.Id = '%s'", 
+                   new_account$id)
+  sf_query(soql, api_type = api_type)
+}
 
-res <- microbenchmark::microbenchmark(
-  qry_compare("REST"),
-  qry_compare("Bulk 1.0"),
-  qry_compare("Bulk 2.0"),
-  times = 5,
-  unit = "s"
-)
                          
+res <- microbenchmark::microbenchmark(
+  qry_compare("REST"),
+  qry_compare("Bulk 1.0"),
+  qry_compare("Bulk 2.0"),
+  times = 5, 
+  unit = "s"
+)
                          
 
                          Note that the Bulk 1.0 API requires users to specify the target object along with their submitted SOQL. This is because it is needed when creating the bulk job that will manage and execute the query.
                          
-
                          queried_records <- sf_query(soql, api_type = "Bulk 1.0")
+
                          +queried_records <- sf_query(soql, api_type = "Bulk 1.0")
 #> Guessed 'Contact' as the object_name from supplied SOQL.
-#> Please set `object_name` explicitly if this is incorrect because it is required by the Bulk APIs.
                          
+#> Please set `object_name` explicitly if this is incorrect because it is required by the Bulk APIs.
                          
 
                          As you can see above the {salesforcer} package will try to infer the object in the query if not explicitly provided. If it does not guess correctly, then please specify.
                          
 
                          Cleanup after performance tests
                          
 
                          By keeping track of the account ids used in our tests, it is fairly easy to find and delete these test records from our Org to save space.
                          
-
                          # cleanup performance test Contact records ...
-contacts_to_delete <- sf_query(
-  sprintf("SELECT Id 
+
                          +# cleanup performance test Contact records ...
+contacts_to_delete <- sf_query(
+  sprintf("SELECT Id 
           FROM Contact 
           WHERE Account.Id = '%s'",
-          new_account$id)
-)
-sf_delete(contacts_to_delete$Id, "Contact", api_type="Bulk 2.0")
-#> # A tibble: 99 x 4
+          new_account$id)
+)
+sf_delete(contacts_to_delete$Id, "Contact", api_type="Bulk 2.0")
+#> # A tibble: 999 x 4
 #>   Id                 sf__Id             sf__Created sf__Error
 #>   <chr>              <chr>              <lgl>       <lgl>    
-#> 1 0033s000014AdQtAAK 0033s000014AdQtAAK FALSE       NA       
-#> 2 0033s000014AdQuAAK 0033s000014AdQuAAK FALSE       NA       
-#> 3 0033s000014AdQvAAK 0033s000014AdQvAAK FALSE       NA       
-#> 4 0033s000014AdQwAAK 0033s000014AdQwAAK FALSE       NA       
-#> 5 0033s000014AdQxAAK 0033s000014AdQxAAK FALSE       NA       
-#> # … with 94 more rows
+#> 1 0033s000017uM3kAAE 0033s000017uM3kAAE FALSE       NA       
+#> 2 0033s000017uM3lAAE 0033s000017uM3lAAE FALSE       NA       
+#> 3 0033s000017uM3mAAE 0033s000017uM3mAAE FALSE       NA       
+#> 4 0033s000017uM3nAAE 0033s000017uM3nAAE FALSE       NA       
+#> 5 0033s000017uM3oAAE 0033s000017uM3oAAE FALSE       NA       
+#> # … with 994 more rows
 
 # ... and finally delete the account
-sf_delete(new_account$id)
+sf_delete(new_account$id)
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0013s000011JhcyAAC TRUE
                          
+#> 1 0013s000014jG3BAAU TRUE
                          
 
                          
 
                          
 
                          
@@ -396,57 +405,68 @@ 
                          
 
                          
 child-to-parent “lookup” queries
                          
 
                          The first type of relationship query and the most common is child to parent. For example, the Contact object (child) to their parent, the Account object. In order to pull down parent object fields with your child record query, you just need to prefix any fields from the related object by concatenating the name of the object with the field name separated by a period. In the example below we are retrieving all Contact object records that have a relationship to an Account.
                          
-
                          # child-to-parent relationship (e.g. Account.Name from Contact record)
-sf_query(
+
                          +# child-to-parent relationship (e.g. Account.Name from Contact record)
+sf_query(
   "SELECT Id, FirstName, Account.Name
   FROM Contact
   WHERE Account.Id != null"
-)
-#> # A tibble: 315 x 3
+)
+#> # A tibble: 513 x 3
 #>   Id                 FirstName Account.Name                        
 #>   <chr>              <chr>     <chr>                               
-#> 1 0033s000012Nl0rAAC KEEP      KEEP Test Account With Child Records
-#> 2 0033s000012Nl0sAAC KEEP      KEEP Test Account With Child Records
-#> 3 0033s000012Nl0tAAC KEEP      KEEP Test Account With Child Records
-#> 4 0033s000012Nl0uAAC KEEP      KEEP Test Account With Child Records
-#> 5 0033s000012Nl0vAAC KEEP      KEEP Test Account With Child Records
-#> # … with 310 more rows
                          
+#> 1 0033s000012NkzwAAC KEEP      KEEP Test Account With Child Records
+#> 2 0033s000012NkzxAAC KEEP      KEEP Test Account With Child Records
+#> 3 0033s000012NkzyAAC KEEP      KEEP Test Account With Child Records
+#> 4 0033s000012NkzzAAC KEEP      KEEP Test Account With Child Records
+#> 5 0033s000012Nl00AAC KEEP      KEEP Test Account With Child Records
+#> # … with 508 more rows
                          
 
                          Sometimes you may notice that the requested relationship fields do not appear in the query results. This is because the SOAP and REST APIs do not return any related object information if it does not exist on the record and there is no reliable way to extract and rebuild the empty columns based on the query string. In the example below, if there were Account information an additional column titled "Account.Name" would appear in the results.
                          
-
                          # child-to-parent relationship (e.g. Account.Name from Contact record)
-sf_query(
+
                          +# child-to-parent relationship (e.g. Account.Name from Contact record)
+sf_query(
   "SELECT Id, FirstName, Account.Name
   FROM Contact
   WHERE Account.Id = null"
-)
-#> # A tibble: 266 x 2
+)
+#> # A tibble: 1,110 x 2
 #>   Id                 FirstName
 #>   <chr>              <chr>    
 #> 1 0033s000013wlpjAAA Test     
 #> 2 0033s000013wlpkAAA Test     
-#> 3 0033s000014AG4HAAW Test     
-#> 4 0033s0000149ZoCAAU Test     
-#> 5 0033s0000149ZoDAAU Test     
-#> # … with 261 more rows
                          
+#> 3 0033s000014CRFoAAO Test     
+#> 4 0033s000014CRFpAAO Test     
+#> 5 0033s000014AG4HAAW Test     
+#> # … with 1,105 more rows
                          
 
                          Note, that the Bulk 1.0 and Bulk 2.0 APIs will return "Account.Name" as a column of all NA values for this query because they return results differently.
                          
 
                          Finally, one aspect to note is that the Bulk 2.0 API does not support child-to-parent-grandparent relationships as seen in the example below:
                          
-
                          try(
-  sf_query("SELECT Id, FirstName, Account.Owner.Id
-            FROM Contact",
-           api_type = "Bulk 2.0")
-)
-#> Error in sf_query_bulk_v2(soql = soql, object_name = object_name, queryall = queryall,  : 
-#>   Failure during batch processing: FeatureNotEnabled : Cannot serialize value for 'Owner' in CSV format
                          
+
                          +try(
+  sf_query("SELECT Id, FirstName, Account.Owner.Id
+            FROM Contact", 
+           api_type = "Bulk 2.0")
+)
+#> # A tibble: 1,623 x 3
+#>   Id                 FirstName Account.Owner.Id
+#>   <chr>              <chr>     <chr>           
+#> 1 0033s000012Nd60AAC Jenny     <NA>            
+#> 2 0033s000012Nd65AAC Jenny     <NA>            
+#> 3 0033s000012Nd6FAAS Jenny     <NA>            
+#> 4 0033s000012Nd6UAAS Jenny     <NA>            
+#> 5 0033s000012NdARAA0 Jenny     <NA>            
+#> # … with 1,618 more rows
                          
 
                          
 
                          
 
                          
 parent-to-child “nested” queries
                          
 
                          Instead of “looking up” a related field, users can write queries that retrieve the individual records related to a parent. For example, if you would like all of the Accounts and their Contacts you can write the query like so:
                          
-
                          sf_query(
+
                          +sf_query(
   "SELECT Id, Name, 
     (SELECT Id, FirstName FROM Contacts)
   FROM Account"
-)
-#> # A tibble: 316 x 4
+)
+#> # A tibble: 516 x 4
 #>   Id              Name                         Contact.FirstName Contact.Id     
 #>   <chr>           <chr>                        <chr>             <chr>          
 #> 1 0013s00000zFgA… KEEP Test Account With Chil… <NA>              <NA>           
@@ -454,15 +474,16 @@ 
                          
 #> 3 0013s00000zFdu… KEEP Test Account With Chil… KEEP              0033s000012Nkz…
 #> 4 0013s00000zFdu… KEEP Test Account With Chil… KEEP              0033s000012Nkz…
 #> 5 0013s00000zFdu… KEEP Test Account With Chil… KEEP              0033s000012Nkz…
-#> # … with 311 more rows
                          
+#> # … with 511 more rows
                          
 
                          At first glance this query may appear the same as a lookup query on the Contact object that includes the account id and name. However, the small difference is that every Account is included, regardless of whether or not they have a Contact. This can be helpful when you want to ensure a query contains all of the parent records and their child records, if they exist. Also, note that the plural object name is used inside the nested query (“Contacts” instead of “Contact”).
                          
 
                          Finally, a parent-to-child nested query can also contain a child-to-parent lookup relationship within it. Below is an example where the Owner Id on the Contact is included so you can know who is responsible for the Contacts under each Account.
                          
-
                          sf_query(
+
                          +sf_query(
   "SELECT Name, Owner.Id, 
     (SELECT Id, FirstName, Owner.Id FROM Contacts)
    FROM Account"
-)
-#> # A tibble: 316 x 5
+)
+#> # A tibble: 516 x 5
 #>   Name              Contact.FirstName Contact.Id    Contact.Owner.Id Owner.Id   
 #>   <chr>             <chr>             <chr>         <chr>            <chr>      
 #> 1 KEEP Test Accoun… <NA>              <NA>          <NA>             0056A00000…
@@ -470,7 +491,7 @@ 
                          
 #> 3 KEEP Test Accoun… KEEP              0033s000012N… 0056A000000MPRj… 0056A00000…
 #> 4 KEEP Test Accoun… KEEP              0033s000012N… 0056A000000MPRj… 0056A00000…
 #> 5 KEEP Test Accoun… KEEP              0033s000012N… 0056A000000MPRj… 0056A00000…
-#> # … with 311 more rows
                          
+#> # … with 511 more rows
                          
 
                          
 
                          
 
                          
@@ -488,7 +509,7 @@ 
                          
 
                        • Do you need a parent-to-child nested relationship query or will a child-to-parent lookup suffice?
                          • 
 
                        
 
                        • 
-
                      • Check out Salesforce’s Workbench tool to see how it builds out queries.
                        • 
+
                      • Check out Salesforce’s Workbench tool to see how it constructs specific queries that you are debugging. The tool is available at https://workbench.developerforce.com and requires a Salesforce login (the same credentials as you normally would use).
                        • 
 
                      • Double check Salesforce’s SOQL reference guide to see whether your query is supported or limited in some way.
                        • 
 
                      • Review query unit tests at: https://github.com/StevenMMortimer/salesforcer/blob/main/tests/testthat/test-query.R. These unit tests were written to cover a variety of use cases and to track any changes made between newly released versions of the Salesforce API (typically 4 each year). These tests are an excellent source of examples that may be helpful in troubleshooting your own query.
                        • 
 
                      • 
@@ -517,7 +538,7 @@ 
                        
 
 
 
                        
-  
                        Site built with pkgdown 1.5.1.
                        
+  
                        Site built with pkgdown 1.6.1.
                        
 
                        
 
       
diff --git a/docs/articles/supported-queries_files/figure-html/run-performance-test-1.png b/docs/articles/supported-queries_files/figure-html/run-performance-test-1.png
index c92d75fa489c42fadedf50155063efc91421059c..5bcc78e39713b6882f4f3319e862651058452e57 100644
GIT binary patch
literal 33869
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%0AweF
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
cuK{I24maj*F=!~eUJAaB9 :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/transitioning-from-RForcecom.html b/docs/articles/transitioning-from-RForcecom.html
index 80682bcb..097d61bc 100644
--- a/docs/articles/transitioning-from-RForcecom.html
+++ b/docs/articles/transitioning-from-RForcecom.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -54,7 +54,7 @@
       
                          
 
                        • 
   
                          vignettes/transitioning-from-RForcecom.Rmd
       
@@ -141,139 +141,131 @@ 
                          2018-03-12
                          
 
     
     
-
                          While writing the {salesforcer} package we were keenly aware that many folks are already using the {RForcecom} package to connect to Salesforce. In order to foster adoption and switching between the packages {salesforcer} replicates the functionality of many {RForcecom} functions so that you will only need to swap out library(RForcecom) for library(salesforcer) and still have your production tested scripts perform as usual.
                          
+
                          While writing the {salesforcer} package we were keenly aware that many folks were already using the {RForcecom} package to connect to Salesforce. In order to foster adoption and switching between the packages {salesforcer} replicates the functionality of many {RForcecom} functions so that you will only need to swap out library(RForcecom) for library(salesforcer) and still have production scripts perform as expected.
                          
+
                          
+
                          
+RForcecom Removed from CRAN
                          
+
                          As of June 9, 2021, the {RForcecom} package was removed from CRAN. You can still use it by installing from the archive, but we strongly recommend using {salesforcer} instead. The existing functionality in {RForcecom} has been further optimized within {salesforcer} and new functionality has been added too.
                          
+
                          
 
                          
 
                          
 Authentication
                          
 
                          {salesforcer} supports OAuth 2.0 authentication which is preferred, but for backward compatibility provides the username-password authentication routine implemented by {RForcecom}. Here is an example running the function from each of the packages side-by-side and producing the same result.
                          
-
                          # the RForcecom way
-session1 <- RForcecom::rforcecom.login(username, paste0(password, security_token),
-                                       apiVersion=getOption("salesforcer.api_version"))
-session1['sessionID'] <- "{MASKED}"
-session1
-#>                       sessionID                     instanceURL 
-#>                      "{MASKED}" "https://na122.salesforce.com/" 
-#>                      apiVersion 
-#>                          "48.0"
-
+
                          +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
                          
+
                          +# the RForcecom way
+# RForcecom::rforcecom.login(username, paste0(password, security_token), 
+#                            apiVersion=getOption("salesforcer.api_version"))
 # replicated in salesforcer package
-session2 <- salesforcer::rforcecom.login(username,
-                                         paste0(password, security_token),
-                                         apiVersion = getOption("salesforcer.api_version"))
-session2['sessionID'] <- "{MASKED}"
-session2
+session <- salesforcer::rforcecom.login(username, 
+                                         paste0(password, security_token), 
+                                         apiVersion = getOption("salesforcer.api_version"))
+session['sessionID'] <- "{MASKED}"
+session
 #>                       sessionID                     instanceURL 
 #>                      "{MASKED}" "https://na122.salesforce.com/" 
 #>                      apiVersion 
-#>                          "48.0"
                          
+#>                          "52.0"
                          
 
                          Note that we must set the API version here because calls to session will not create a new sessionId and then we are stuck with version 35.0 (the default from RForcecom::rforcecom.login()). Some functions in {salesforcer} implement API calls that are only available after version 35.0.
                          
 
                          
 
                          
 
                          
 CRUD Operations
                          
 
                          “CRUD” operations (Create, Retrieve, Update, Delete) in the {RForcecom} package only operate on one record at a time. One benefit to using the {salesforcer} package is that these operations will accept a named vector (one record) or an entire data.frame or tbl_df of records to churn through. However, rest assured that the replicated functions behave exactly the same way if you are hesitant to making the switch.
                          
-
                          object <- "Contact"
-fields <- c(FirstName="Test", LastName="Contact-Create-Compatibility")
+
                          +object <- "Contact"
+fields <- c(FirstName="Test", LastName="Contact-Create-Compatibility")
 
 # the RForcecom way
-result1 <- RForcecom::rforcecom.create(session, objectName=object, fields)
-result1
-#>                   id success
-#> 1 0033s000014AdSeAAK    true
+# RForcecom::rforcecom.create(session, objectName=object, fields)
 
 # replicated in salesforcer package
-result2 <- salesforcer::rforcecom.create(session, objectName=object, fields)
-result2
+result <- salesforcer::rforcecom.create(session, objectName=object, fields)
+result
 #>                   id success
-#> 1 0033s000014AdSjAAK    TRUE
                          
+#> 1 0033s000017uMJrAAM    TRUE
                          
 
                          Here is an example showing the reduction in code of using {salesforcer} if you would like to create multiple records.
                          
-
                          n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n))
+
                          +n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n))
 
-# the RForcecom way
-rforcecom_results <- NULL
-for(i in 1:nrow(new_contacts)){
-  temp <- RForcecom::rforcecom.create(session,
-                                      objectName = "Contact",
-                                      fields = unlist(slice(new_contacts,i)))
-  rforcecom_results <- bind_rows(rforcecom_results, temp)
-}
-rforcecom_results
-#>                   id success
-#> 1 0033s000014AdPmAAK    true
-#> 2 0033s000014AdSoAAK    true
+# the RForcecom way (requires a loop)
+# rforcecom_results <- NULL
+# for(i in 1:nrow(new_contacts)){
+#   temp <- RForcecom::rforcecom.create(session, 
+#                                       objectName = "Contact", 
+#                                       fields = unlist(slice(new_contacts,i)))
+#   rforcecom_results <- bind_rows(rforcecom_results, temp)
+# }
 
 # the better way in salesforcer to do multiple records
-salesforcer_results <- sf_create(new_contacts, object_name="Contact")
-salesforcer_results
+salesforcer_results <- sf_create(new_contacts, object_name="Contact")
+salesforcer_results
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdStAAK TRUE   
-#> 2 0033s000014AdSuAAK TRUE
                          
+#> 1 0033s000017uMJwAAM TRUE   
+#> 2 0033s000017uMJxAAM TRUE
                          
 
                          
 
                          
 
                          
 Query
                          
 
                          {salesforcer} also has better printing and type-casting when returning query result thanks to features of the {readr} package.
                          
-
                          this_soql <- "SELECT Id, Email FROM Contact LIMIT 5"
+
                          +this_soql <- "SELECT Id, Email FROM Contact LIMIT 5"
 
 # the RForcecom way
-result1 <- RForcecom::rforcecom.query(session, soqlQuery = this_soql)
-result1
-#>                   Id
-#> 1 0033s000013wlpjAAA
-#> 2 0033s000013wlpkAAA
-#> 3 0033s000014AG4HAAW
-#> 4 0033s0000149ZoCAAU
-#> 5 0033s0000149ZoDAAU
+# RForcecom::rforcecom.query(session, soqlQuery = this_soql)
 
 # replicated in salesforcer package
-result2 <- salesforcer::rforcecom.query(session, soqlQuery = this_soql)
-result2
+result <- salesforcer::rforcecom.query(session, soqlQuery = this_soql)
+result
 #> # A tibble: 5 x 1
 #>   Id                
 #>   <chr>             
 #> 1 0033s000013wlpjAAA
 #> 2 0033s000013wlpkAAA
-#> 3 0033s000014AG4HAAW
-#> 4 0033s0000149ZoCAAU
-#> 5 0033s0000149ZoDAAU
+#> 3 0033s000014CRFoAAO
+#> 4 0033s000014CRFpAAO
+#> 5 0033s000014AG4HAAW
 
 # the better way in salesforcer to query
-salesforcer_results <- sf_query(this_soql)
-salesforcer_results
+salesforcer_results <- sf_query(this_soql)
+salesforcer_results
 #> # A tibble: 5 x 1
 #>   Id                
 #>   <chr>             
 #> 1 0033s000013wlpjAAA
 #> 2 0033s000013wlpkAAA
-#> 3 0033s000014AG4HAAW
-#> 4 0033s0000149ZoCAAU
-#> 5 0033s0000149ZoDAAU
                          
+#> 3 0033s000014CRFoAAO
+#> 4 0033s000014CRFpAAO
+#> 5 0033s000014AG4HAAW
                          
 
                          
 
                          
 
                          
 Describe
                          
 
                          The {RForcecom} package has the function rforcecom.getObjectDescription() which returns a data.frame with one row per field on an object. The same function in {salesforcer} is named sf_describe_object_fields() and also has better printing and datatype casting by using tibbles.
                          
-
                          # the RForcecom way
-result1 <- RForcecom::rforcecom.getObjectDescription(session, objectName='Account')
+
                          +# the RForcecom way
+# RForcecom::rforcecom.getObjectDescription(session, objectName='Account')
 
 # backwards compatible in the salesforcer package
-result2 <- salesforcer::rforcecom.getObjectDescription(session, objectName='Account')
+result <- salesforcer::rforcecom.getObjectDescription(session, objectName='Account')
 
 # the better way in salesforcer to get object fields
-result3 <- salesforcer::sf_describe_object_fields('Account')
-result3
+result2 <- salesforcer::sf_describe_object_fields('Account')
+result2
 #> # A tibble: 68 x 39
-#>   aggregatable aiPredictionFie… autoNumber byteLength calculated caseSensitive
-#>   <chr>        <chr>            <chr>      <chr>      <chr>      <chr>        
-#> 1 true         false            false      18         false      false        
-#> 2 false        false            false      0          false      false        
-#> 3 true         false            false      18         false      false        
-#> 4 true         false            false      765        false      false        
-#> 5 true         false            false      120        false      false        
+#>   aggregatable aiPredictionField autoNumber byteLength calculated caseSensitive
+#>   <chr>        <chr>             <chr>      <chr>      <chr>      <chr>        
+#> 1 true         false             false      18         false      false        
+#> 2 false        false             false      0          false      false        
+#> 3 true         false             false      18         false      false        
+#> 4 true         false             false      765        false      false        
+#> 5 true         false             false      765        false      false        
 #> # … with 63 more rows, and 33 more variables: compoundFieldName <chr>,
 #> #   createable <chr>, custom <chr>, defaultedOnCreate <chr>,
 #> #   defaultValue <list>, deprecatedAndHidden <chr>, digits <chr>,
@@ -283,8 +275,7 @@ 
                          
 #> #   picklistValues <list>, polymorphicForeignKey <chr>, precision <chr>,
 #> #   queryByDistance <chr>, referenceTo <chr>, relationshipName <chr>,
 #> #   restrictedPicklist <chr>, scale <chr>, searchPrefilterable <chr>,
-#> #   soapType <chr>, sortable <chr>, type <chr>, unique <chr>, updateable <chr>
                          
-
                          In the future more features will be migrated from {RForcecom} to make the transition as seamless as possible.
                          
+#> #   soapType <chr>, sortable <chr>, type <chr>, unique <chr>, updateable <chr>
                          
 
                          
   
                          
 
@@ -303,7 +294,7 @@ 
                          
 
                          
 
 
                          
-  
                          Site built with pkgdown 1.5.1.
                          
+  
                          Site built with pkgdown 1.6.1.
                          
 
                          
 
       
diff --git a/docs/articles/transitioning-from-RForcecom_files/header-attrs-2.9/header-attrs.js b/docs/articles/transitioning-from-RForcecom_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/transitioning-from-RForcecom_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/working-with-attachments.html b/docs/articles/working-with-attachments.html
index e6b800ef..8dd0db2f 100644
--- a/docs/articles/working-with-attachments.html
+++ b/docs/articles/working-with-attachments.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                          
 
@@ -54,7 +54,7 @@
       
                            
 
                          • 
   
                            Attachments in Salesforce
                            
 
                            Almost all records in Salesforce support attachments. Attachments are just blob data storage for an associated ParentId. A ParentId is the 18-character Salesforcer Id of the record that the attachment belongs to. To get started creating and updating attachments, first, load the {salesforcer} and {dplyr} packages and login, if needed.
                            
-
                            library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
-sf_auth()
                            
+
                            +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
+sf_auth()
                            
 
                            The Attachment data, for example, the attachment’s Id, ParentId, Name, Body, ModifiedDate, and other attributes are stored in the Attachment object, a Standard Object in Salesforce.
                            
 
                            
 
                            
@@ -161,144 +162,151 @@ 
                            
 
                            Uploading local files as Attachments (SOAP and REST)
                            
 
                            When uploading an attachment stored locally (i.e. on your computer), you can provide an absolute or relative path to the current working directory. If the Name column is omitted, then the name of the attachment as it appears in Salesforce will be the same as the base file name and extension. For example, if the path provided is “/Documents/attachments/doc1.pdf”, then the Name field will be set to “doc1.pdf”.
                            
 
                            In the example below, we upload three attachments to two different parent records. Note: Make sure to replace the paths and ParentIds in the example below with file paths that exist on your local machine and Ids of records in your Salesforce org.
                            
-
                            # define the ParentIds where the attachments will be shown in Salesforce
-parent_record_id1 <- "0016A0000035mJ4"
-parent_record_id2 <- "0016A0000035mJ5"
+
                            +# define the ParentIds where the attachments will be shown in Salesforce
+parent_record_id1 <- "0016A0000035mJ4"
+parent_record_id2 <- "0016A0000035mJ5"
 
 # provide the file paths of where the attachments exist locally on your machine
 # in this case we are referencing images included within the salesforcer package, 
 # but any absolute or relative path locally will work
-file_path1 <- system.file("extdata", "cloud.png", package="salesforcer")
-file_path2 <- system.file("extdata", "logo.png", package="salesforcer")
-file_path3 <- system.file("extdata", "old-logo.png", package="salesforcer")
+file_path1 <- system.file("extdata", "cloud.png", package="salesforcer")
+file_path2 <- system.file("extdata", "logo.png", package="salesforcer")
+file_path3 <- system.file("extdata", "old-logo.png", package="salesforcer")
 
 # create a data.frame or tbl_df out of this information
-attachment_details <- tibble(Body = rep(c(file_path1,
-                                          file_path2,
-                                          file_path3),
-                                        times=2),
-                             ParentId = rep(c(parent_record_id1,
-                                              parent_record_id2),
-                                            each=3))
+attachment_details <- tibble(Body = rep(c(file_path1, 
+                                          file_path2, 
+                                          file_path3), 
+                                        times=2),
+                             ParentId = rep(c(parent_record_id1, 
+                                              parent_record_id2), 
+                                            each=3))
 
 # create the attachments!
-result <- sf_create_attachment(attachment_details)
-result
+result <- sf_create_attachment(attachment_details)
+result
 #> # A tibble: 6 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 00P3s00000aFtdrEAC TRUE   
-#> 2 00P3s00000aFteUEAS TRUE   
-#> 3 00P3s00000aFtdDEAS TRUE   
-#> 4 00P3s00000aFteZEAS TRUE   
-#> 5 00P3s00000aFtc7EAC TRUE   
-#> # … with 1 more row
                            
+#> 1 00P3s00000d243PEAQ TRUE   
+#> 2 00P3s00000d243UEAQ TRUE   
+#> 3 00P3s00000d243ZEAQ TRUE   
+#> 4 00P3s00000d243eEAA TRUE   
+#> 5 00P3s00000d243jEAA TRUE   
+#> # … with 1 more row
                            
 
                            
 
                            
 
                            
 Downloading Attachments
                            
 
                            After uploading attachments to Salesforce you can download them by first querying the metadata in the Attachment object. This metadata provides the Id for the blob data attachment for download. A convenience function, sf_download_attachment(), has been created to download attachments quickly. The example below shows how to query the metadata of attachments belonging to particular ParentId.
                            
-
                            # pull down all attachments associated with a particular record
-queried_attachments <- sf_query(sprintf("SELECT Id, Body, Name, ParentId
+
                            +# pull down all attachments associated with a particular record
+queried_attachments <- sf_query(sprintf("SELECT Id, Body, Name, ParentId
                                          FROM Attachment
-                                         WHERE ParentId IN ('%s', '%s')",
-                                         parent_record_id1, parent_record_id2))
-queried_attachments
+                                         WHERE ParentId IN ('%s', '%s')", 
+                                         parent_record_id1, parent_record_id2))
+queried_attachments
 #> # A tibble: 6 x 4
 #>   Id            Body                                     Name      ParentId     
 #>   <chr>         <chr>                                    <chr>     <chr>        
-#> 1 00P3s00000aF… /services/data/v48.0/sobjects/Attachmen… logo.png  0016A0000035…
-#> 2 00P3s00000aF… /services/data/v48.0/sobjects/Attachmen… cloud.png 0016A0000035…
-#> 3 00P3s00000aF… /services/data/v48.0/sobjects/Attachmen… old-logo… 0016A0000035…
-#> 4 00P3s00000aF… /services/data/v48.0/sobjects/Attachmen… cloud.png 0016A0000035…
-#> 5 00P3s00000aF… /services/data/v48.0/sobjects/Attachmen… logo.png  0016A0000035…
-#> # … with 1 more row
                            
+#> 1 00P3s00000d2… /services/data/v52.0/sobjects/Attachmen… cloud.png 0016A0000035…
+#> 2 00P3s00000d2… /services/data/v52.0/sobjects/Attachmen… logo.png  0016A0000035…
+#> 3 00P3s00000d2… /services/data/v52.0/sobjects/Attachmen… old-logo… 0016A0000035…
+#> 4 00P3s00000d2… /services/data/v52.0/sobjects/Attachmen… cloud.png 0016A0000035…
+#> 5 00P3s00000d2… /services/data/v52.0/sobjects/Attachmen… old-logo… 0016A0000035…
+#> # … with 1 more row
                            
 
                            Before downloading the attachments using the Body it is important to consider whether the attachment names are repeated or duplicates. If so, then the attachments with the same exact name will be overwritten on the local filesystem as they are downloaded. To avoid this problem there are two common strategies:
                            
 
                              
 
                            1. Create a new column (e.g. unique_name) that is the concatenation of the Attachment Id and the Attachment’s name which is guaranteed to be unique.
                              2. 
 
                            2. Save the attachments in separate folders for each ParentId record.
                              3. 
 
                            
 
                            As long as the same ParentId record doesn’t name attachments with the same name, then Strategy #2 above will work. In addition, it may help better organize the documents if you are planning to download many and then upload again to Salesforce using the Bulk API as demonstrated later in this script.
                            
-
                            # create a new folder for each ParentId in the dataset
-temp_dir <- tempdir()
-for (pid in unique(queried_attachments$ParentId)){
-  dir.create(file.path(temp_dir, pid), showWarnings = FALSE) # ignore if already exists
-}
+
                            +# create a new folder for each ParentId in the dataset
+temp_dir <- tempdir()
+for (pid in unique(queried_attachments$ParentId)){
+  dir.create(file.path(temp_dir, pid), showWarnings = FALSE) # ignore if already exists
+}
 
 # create a new columns in the queried data so that we can pass this information 
 # on to the function `sf_download_attachment()` that will actually perform the download
-queried_attachments <- queried_attachments %>%
+queried_attachments <- queried_attachments %>% 
   # Strategy 1: Unique file names (ununsed here, but shown as an example)
-  mutate(unique_name = paste(Id, Name, sep='___')) %>%
+  mutate(unique_name = paste(Id, Name, sep='___')) %>% 
   # Strategy 2: Separate folders per parent
-  mutate(Path = file.path(temp_dir, ParentId))
+  mutate(Path = file.path(temp_dir, ParentId))
 
 # download all of the attachments for a single ParentId record to their own folder
-download_result <- mapply(sf_download_attachment,
-                          body = queried_attachments$Body,
-                          name = queried_attachments$Name,
-                          path = queried_attachments$Path)
-download_result
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFteUEAS/Body 
-#>     "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ4QAI/logo.png" 
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFtdrEAC/Body 
-#>    "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ4QAI/cloud.png" 
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFtdDEAS/Body 
-#> "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ4QAI/old-logo.png" 
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFteZEAS/Body 
-#>    "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ5QAI/cloud.png" 
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFtc7EAC/Body 
-#>     "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ5QAI/logo.png" 
-#>                               /services/data/v48.0/sobjects/Attachment/00P3s00000aFteeEAC/Body 
-#> "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//Rtmposi3QP/0016A0000035mJ5QAI/old-logo.png"
                            
+download_result <- mapply(sf_download_attachment, 
+                          body = queried_attachments$Body, 
+                          name = queried_attachments$Name, 
+                          path = queried_attachments$Path)
+download_result
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243PEAQ/Body 
+#>    "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ4QAI/cloud.png" 
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243UEAQ/Body 
+#>     "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ4QAI/logo.png" 
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243ZEAQ/Body 
+#> "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ4QAI/old-logo.png" 
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243eEAA/Body 
+#>    "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ5QAI/cloud.png" 
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243oEAA/Body 
+#> "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ5QAI/old-logo.png" 
+#>                               /services/data/v52.0/sobjects/Attachment/00P3s00000d243jEAA/Body 
+#>     "/var/folders/s2/1mxmzrg52tx7l0pg8lq1320w0000gn/T//RtmpQjcDk6/0016A0000035mJ5QAI/logo.png"
                            
 
                            
 
                            
 
                            
 Updating Attachments
                            
 
                            Once an Attachment record is created, you are still able to update the content and metadata (Name, IsPrivate, and OwnerId) for the record. The sf_update_attachment() function works just like sf_update() except that you will need to include the Body column where the content of the attachment is help. NOTE: If you just want to update the metadata and not the Attachment content itself, you can simply use sf_update() to modify fields other than the Body field on the record.
                            
 
                            The example below demonstrates how to add an attachment to a record, then download it, zip it, re-upload to the record in order to save disk space in your Org.
                            
-
                            # upload a PDF to a particular record as an Attachment
-file_path <- system.file("extdata",
+
                            +# upload a PDF to a particular record as an Attachment
+file_path <- system.file("extdata",
                          "data-wrangling-cheatsheet.pdf",
-                         package = "salesforcer")
-parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
-attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
-create_result <- sf_create_attachment(attachment_details)
+                         package = "salesforcer")
+parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
+attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
+create_result <- sf_create_attachment(attachment_details)
 
 # download, zip, and re-upload the PDF
-pdf_path <- sf_download_attachment(sf_id = create_result$id[1])
-zipped_path <- paste0(pdf_path, ".zip")
-zip(zipped_path, pdf_path, flags = "-qq") # quiet zipping messages
-attachment_details <- tibble(Id = create_result$id, Body = zipped_path)
-sf_update_attachment(attachment_details)
+pdf_path <- sf_download_attachment(sf_id = create_result$id[1])
+zipped_path <- paste0(pdf_path, ".zip")
+zip(zipped_path, pdf_path, flags = "-qq") # quiet zipping messages
+attachment_details <- tibble(Id = create_result$id, Body = zipped_path)
+sf_update_attachment(attachment_details)
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 00P3s00000aFtejEAC TRUE
                            
+#> 1 00P3s00000d243tEAA TRUE
                            
 
                            There is a function sf_delete_attachment(), which simply wraps sf_delete() so feel free to use for clarity in your code that you’re working with attachments use sf_delete().
                            
-
                            sf_delete_attachment(ids = create_result$id)
+
                            +sf_delete_attachment(ids = create_result$id)
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 00P3s00000aFtejEAC TRUE
-# sf_delete(ids = create_result$id) # would also work
                            
+#> 1 00P3s00000d243tEAA TRUE
+# sf_delete(ids = create_result$id) # would also work
                            
 
                            Uploading large batches of attachments using the Bulk API
                            
 
                            The SOAP and REST APIs are good for working with a few attachments at a time. However, the Bulk API can be invoked using api_type=“Bulk 1.0” to automatically take a data.frame or tbl_df of Attachment field data and create a ZIP file with CSV manifest that is required by that API to upload. In the example above, we downloaded the three attachments each belonging to two different parent records. Assuming that I have run that code and the files are in that my computer I can demonstrate that all of them can be uploaded at once using the Bulk 1.0 API.
                            
-
                            # create the attachment metadata required (Name, Body, ParentId)
-attachment_details <- queried_attachments %>%
-  mutate(Body = file.path(Path, Name)) %>%
-  select(Name, Body, ParentId)
                            
-
                            result <- sf_create_attachment(attachment_details, api_type="Bulk 1.0")
-result
+
                            +# create the attachment metadata required (Name, Body, ParentId)
+attachment_details <- queried_attachments %>% 
+  mutate(Body = file.path(Path, Name)) %>% 
+  select(Name, Body, ParentId) 
                            
+
                            +result <- sf_create_attachment(attachment_details, api_type="Bulk 1.0")
+result
 #> # A tibble: 6 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 00P3s00000aFteoEAC TRUE    TRUE    NA   
-#> 2 00P3s00000aFtepEAC TRUE    TRUE    NA   
-#> 3 00P3s00000aFteqEAC TRUE    TRUE    NA   
-#> 4 00P3s00000aFterEAC TRUE    TRUE    NA   
-#> 5 00P3s00000aFtesEAC TRUE    TRUE    NA   
-#> # … with 1 more row
                            
+#> 1 00P3s00000d2443EAA TRUE    TRUE    NA   
+#> 2 00P3s00000d2444EAA TRUE    TRUE    NA   
+#> 3 00P3s00000d2445EAA TRUE    TRUE    NA   
+#> 4 00P3s00000d2446EAA TRUE    TRUE    NA   
+#> 5 00P3s00000d2447EAA TRUE    TRUE    NA   
+#> # … with 1 more row
                            
 
                            NOTE: As of v48.0 (Spring ’20), it does not appear that the Bulk 2.0 API supports working with Attachments, so the Bulk 1.0 API must be used for bulk functionality.
                            
 
                            Finally, you are able to update Attachments with the Bulk API just as shown above in the REST/SOAP API examples.
                            
 
                            
@@ -306,34 +314,36 @@ 
                            
 
                            
 Extending to Documents and Other Blob Data
                            
 
                            The commands for working with Attachments also work for uploading documents and other blob data as well. Documents are just like Attachments in Salesforce except instead of having an associated ParentId they have an associated FolderId where the blob will be associated with upon creation. Here is a brief example of uploading a PDF (“Document”) to a Folder
                            
-
                            # the function supports inserting all types of blob content, just update the 
+
                            +# the function supports inserting all types of blob content, just update the 
 # object_name argument to add the PDF as a Document instead of an Attachment
-document_details <- tibble(Name = "Data Wrangling Cheatsheet - Test 1",
-                           Description = "RStudio cheatsheet covering dplyr and tidyr.",
-                           Body = system.file("extdata",
+document_details <- tibble(Name = "Data Wrangling Cheatsheet - Test 1",
+                           Description = "RStudio cheatsheet covering dplyr and tidyr.",
+                           Body = system.file("extdata", 
                                               "data-wrangling-cheatsheet.pdf",
-                                              package="salesforcer"),
-                           FolderId = "00l6A000001EgIwQAK",
-                           Keywords = "test,cheatsheet,document")
-result <- sf_create_attachment(document_details, object_name = "Document")
-result
+                                              package="salesforcer"),
+                           FolderId = "00l6A000001EgIwQAK",
+                           Keywords = "test,cheatsheet,document")
+result <- sf_create_attachment(document_details, object_name = "Document")
+result
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0153s000001w1rWAAQ TRUE
                            
+#> 1 0153s0000028FzCAAU TRUE
                            
 
                            With Documents, users are also able to save storage by specifying a Url instead of a a file path where the Body content is stored locally. Specifying the Url field will reference the URL instead of uploading into the Salesforce org, thereby saving space if limited in your organization.
                            
-
                            cheatsheet_url <- "https://rstudio.com/wp-content/uploads/2015/02/data-wrangling-cheatsheet.pdf"
-document_details <- tibble(Name = "Data Wrangling Cheatsheet - Test 2",
-                           Description = "RStudio cheatsheet covering dplyr and tidyr.",
-                           Url = cheatsheet_url,
-                           FolderId = "00l6A000001EgIwQAK",
-                           Keywords = "test,cheatsheet,document")
-result <- sf_create_attachment(document_details, object_name = "Document")
-result
+
                            +cheatsheet_url <- "https://rstudio.com/wp-content/uploads/2015/02/data-wrangling-cheatsheet.pdf"
+document_details <- tibble(Name = "Data Wrangling Cheatsheet - Test 2",
+                           Description = "RStudio cheatsheet covering dplyr and tidyr.",
+                           Url = cheatsheet_url,  
+                           FolderId = "00l6A000001EgIwQAK",
+                           Keywords = "test,cheatsheet,document")
+result <- sf_create_attachment(document_details, object_name = "Document")
+result
 #> # A tibble: 1 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0153s000001w1rbAAA TRUE
                            
+#> 1 0153s0000028FzHAAU TRUE
                            
 
                            
 
 
 
                            
-  
                            Site built with pkgdown 1.5.1.
                            
+  
                            Site built with pkgdown 1.6.1.
                            
 
                            
 
       
diff --git a/docs/articles/working-with-attachments_files/header-attrs-2.9/header-attrs.js b/docs/articles/working-with-attachments_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/working-with-attachments_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/working-with-bulk-apis.html b/docs/articles/working-with-bulk-apis.html
index 0e1c47ae..35a3fa5f 100644
--- a/docs/articles/working-with-bulk-apis.html
+++ b/docs/articles/working-with-bulk-apis.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                            
 
@@ -54,7 +54,7 @@
       
                              
 
                            • 
   
                              Using the Bulk API
                              
 
                              First, load the {salesforcer} and {dplyr} packages and login, if needed.
                              
-
                              library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
-sf_auth()
                              
+
                              +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
+sf_auth()
                              
 
                              For really large inserts, updates, deletes, upserts, and queries you can just add api_type = "Bulk 1.0" to most functions to get the benefits of using the Bulk API instead of the SOAP or REST APIs. The change you have to make from using the REST API to the Bulk 1.0 API as simple as adding api_type="Bulk 1.0" to your function arguments. First, let’s build a tbl_df with two new records to be created.
                              
-
                              n <- 4
-prefix <- paste0("Bulk-", as.integer(runif(1,1,100000)), "-")
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n),
-                       My_External_Id__c=paste0(prefix, letters[1:n]))
                              
+
                              +n <- 4
+prefix <- paste0("Bulk-", as.integer(runif(1,1,100000)), "-")
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n),
+                       My_External_Id__c=paste0(prefix, letters[1:n]))
                              
 
                              There are some differences in the way the REST API returns response information vs.  the Bulk 1.0 API. However, the changes in Salesforce are exactly the same for these two calls.
                              
-
                              # REST
-rest_created_records <- sf_create(new_contacts[1:2,],
-                                  object_name="Contact",
-                                  api_type="REST")
-rest_created_records
+
                              +# REST
+rest_created_records <- sf_create(new_contacts[1:2,], 
+                                  object_name="Contact", 
+                                  api_type="REST")
+rest_created_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014AdSaAAK TRUE   
-#> 2 0033s000014AdSbAAK TRUE
+#> 1 0033s000017uMKBAA2 TRUE   
+#> 2 0033s000017uMKCAA2 TRUE
 
 # Bulk
-bulk_created_records <- sf_create(new_contacts[3:4,],
-                                  object_name="Contact",
-                                  api_type="Bulk 1.0")
-bulk_created_records
+bulk_created_records <- sf_create(new_contacts[3:4,], 
+                                  object_name="Contact", 
+                                  api_type="Bulk 1.0")
+bulk_created_records
 #> # A tibble: 2 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 0033s000014AdTDAA0 TRUE    TRUE    NA   
-#> 2 0033s000014AdTEAA0 TRUE    TRUE    NA
                              
+#> 1 0033s000017uMKGAA2 TRUE    TRUE    NA   
+#> 2 0033s000017uMKHAA2 TRUE    TRUE    NA
                              
 
                              
 
                              
 
                              
 A Complete Bulk API Workflow
                              
 
                              To show a more lengthy example of using the Bulk 1.0 API, below is a workflow of that creates 2 records, queries them, and deletes them. This is just an example. Typically, you’d want to use the Bulk APIs over the REST or SOAP APIs when dealing with over 10,000 records.
                              
-
                              object <- "Contact"
-created_records <- sf_create(new_contacts, object_name=object, api_type="Bulk 1.0")
-created_records
+
                              +object <- "Contact"
+created_records <- sf_create(new_contacts, object_name=object, api_type="Bulk 1.0")
+created_records
 #> # A tibble: 2 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 0033s000014AdQWAA0 TRUE    TRUE    NA   
-#> 2 0033s000014AdQXAA0 TRUE    TRUE    NA
+#> 1 0033s000017uMKLAA2 TRUE    TRUE    NA   
+#> 2 0033s000017uMKMAA2 TRUE    TRUE    NA
 
 # query bulk
-my_soql <- sprintf("SELECT Id,
+my_soql <- sprintf("SELECT Id,
                            FirstName, 
                            LastName
                     FROM Contact 
-                    WHERE Id in ('%s')",
-                   paste0(created_records$Id , collapse="','"))
+                    WHERE Id in ('%s')", 
+                   paste0(created_records$Id , collapse="','"))
 
-queried_records <- sf_query(my_soql, object_name=object, api_type="Bulk 1.0")
-queried_records
+queried_records <- sf_query(my_soql, object_name=object, api_type="Bulk 1.0")
+queried_records
 #> # A tibble: 2 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
-#> 1 0033s000014AdQWAA0 Test      Contact-Create-1
-#> 2 0033s000014AdQXAA0 Test      Contact-Create-2
+#> 1 0033s000017uMKLAA2 Test      Contact-Create-1
+#> 2 0033s000017uMKMAA2 Test      Contact-Create-2
 
 # delete bulk
-deleted_records <- sf_delete(queried_records$Id, object_name=object, api_type="Bulk 1.0")
-deleted_records
+deleted_records <- sf_delete(queried_records$Id, object_name=object, api_type="Bulk 1.0")
+deleted_records
 #> # A tibble: 2 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 0033s000014AdQWAA0 TRUE    FALSE   NA   
-#> 2 0033s000014AdQXAA0 TRUE    FALSE   NA
                              
+#> 1 0033s000017uMKLAA2 TRUE    FALSE   NA   
+#> 2 0033s000017uMKMAA2 TRUE    FALSE   NA
                              
 
                              
 
                              
 
                              
@@ -235,65 +239,67 @@ 
                              
 
                              
 Using the Bulk 2.0 API
                              
 
                              Salesforce has more recently introduced the Bulk 2.0 API which is supposed to be faster and have a more consistent JSON/REST based API than the Bulk 1.0 API. In some cases I have noticed that the ordering of the result records will differ from the order of the input data because the data is batched and processed asynchronously. by Salesforce instead of R. However, The Bulk 2.0 API returns every single field that was included in the call so if you have an identifying key your dataset, then it should not be a problem to join on that key with your original data to bring in the newly assigned Salesforce Id that is generated when the record was created in Salesforce. However, I have find it just seems wasteful to transfer all of the field information back after the query and have not found a significant performance improvement between the Bulk 1.0 and Bulk 2.0. Finally, note that the status field names (“Success”, “Created”, “Error”) are different from the Bulk 2.0 API.
                              
-
                              n <- 20
-prefix <- paste0("Bulk-", as.integer(runif(1,1,100000)), "-")
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n),
-                       test_number__c = 1:n,
-                       My_External_Id__c=paste0(prefix, letters[1:n]))
+
                              +n <- 20
+prefix <- paste0("Bulk-", as.integer(runif(1,1,100000)), "-")
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n),
+                       test_number__c = 1:n,
+                       My_External_Id__c=paste0(prefix, letters[1:n]))
 
-created_records_v1 <- sf_create(new_contacts[1:10,],
-                                object_name = "Contact",
-                                api_type = "Bulk 1.0")
-created_records_v1
+created_records_v1 <- sf_create(new_contacts[1:10,], 
+                                object_name = "Contact", 
+                                api_type = "Bulk 1.0")
+created_records_v1
 #> # A tibble: 10 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 0033s000014AdTXAA0 TRUE    TRUE    NA   
-#> 2 0033s000014AdTYAA0 TRUE    TRUE    NA   
-#> 3 0033s000014AdTZAA0 TRUE    TRUE    NA   
-#> 4 0033s000014AdTaAAK TRUE    TRUE    NA   
-#> 5 0033s000014AdTbAAK TRUE    TRUE    NA   
+#> 1 0033s000017uMKQAA2 TRUE    TRUE    NA   
+#> 2 0033s000017uMKRAA2 TRUE    TRUE    NA   
+#> 3 0033s000017uMKSAA2 TRUE    TRUE    NA   
+#> 4 0033s000017uMKTAA2 TRUE    TRUE    NA   
+#> 5 0033s000017uMKUAA2 TRUE    TRUE    NA   
 #> # … with 5 more rows
 
-created_records_v2 <- sf_create(new_contacts[11:20,],
-                                object_name = "Contact",
-                                api_type = "Bulk 2.0")
-created_records_v2
+created_records_v2 <- sf_create(new_contacts[11:20,],
+                                object_name = "Contact", 
+                                api_type = "Bulk 2.0")
+created_records_v2
 #> # A tibble: 10 x 7
-#>   sf__Id sf__Created sf__Error FirstName LastName My_External_Id_…
-#>   <chr>  <lgl>       <lgl>     <chr>     <chr>    <chr>           
-#> 1 0033s… TRUE        NA        Test      Contact… Bulk-51971-k    
-#> 2 0033s… TRUE        NA        Test      Contact… Bulk-51971-l    
-#> 3 0033s… TRUE        NA        Test      Contact… Bulk-51971-m    
-#> 4 0033s… TRUE        NA        Test      Contact… Bulk-51971-n    
-#> 5 0033s… TRUE        NA        Test      Contact… Bulk-51971-o    
-#> # … with 5 more rows, and 1 more variable: test_number__c <dbl>
                              
+#>   sf__Id         sf__Created sf__Error FirstName LastName       My_External_Id_…
+#>   <chr>          <lgl>       <lgl>     <chr>     <chr>          <chr>           
+#> 1 0033s000017uM… TRUE        NA        Test      Contact-Creat… Bulk-29970-k    
+#> 2 0033s000017uM… TRUE        NA        Test      Contact-Creat… Bulk-29970-l    
+#> 3 0033s000017uM… TRUE        NA        Test      Contact-Creat… Bulk-29970-m    
+#> 4 0033s000017uM… TRUE        NA        Test      Contact-Creat… Bulk-29970-n    
+#> 5 0033s000017uM… TRUE        NA        Test      Contact-Creat… Bulk-29970-o    
+#> # … with 5 more rows, and 1 more variable: test_number__c <dbl>
                              
 
                              
 
                              
 
                              
 Performance Benchmarks for Bulk Queries
                              
 
                              Below is a simple performance benchmark between the Bulk 1.0 and Bulk 2.0 APIs for a small query. In general, the Bulk 2.0 should be faster. One potential reason for the implementation in R to be faster is that the entire recordset is parsed at once from a downloaded CSV of the results when using the Bulk 1.0 API. The Bulk 2.0 retrieves the same data in large batches (typically 50,000 records at a time). I would encourage users to experiment to see what works best in their Salesforce Org.
                              
-
                              soql <- "SELECT Id, Name FROM Contact"
-bulk1_query <- function(){sf_query(soql, "Contact", api_type="Bulk 1.0")}
-bulk2_query <- function(){sf_query(soql, api_type="Bulk 2.0")} # Bulk 2.0 doesn't need object name
+
                              +soql <- "SELECT Id, Name FROM Contact"
+bulk1_query <- function(){sf_query(soql, "Contact", api_type="Bulk 1.0")}
+bulk2_query <- function(){sf_query(soql, api_type="Bulk 2.0")} # Bulk 2.0 doesn't need object name
 
-res <- microbenchmark::microbenchmark(
-  bulk1_query(),
-  bulk2_query(),
-  times=8,
-  unit = "s"
-)
-res
+res <- microbenchmark::microbenchmark(
+  bulk1_query(),
+  bulk2_query(), 
+  times=8, 
+  unit = "s"
+)
+res
 #> Unit: seconds
-#>           expr      min       lq      mean    median        uq      max neval
-#>  bulk1_query() 9.222935 9.730267 11.013135 10.778163 11.654094 14.55710     8
-#>  bulk2_query() 7.686877 8.085627  9.059468  8.159815  8.578909 15.14017     8
+#>           expr      min       lq     mean   median        uq       max neval
+#>  bulk1_query() 8.073086 8.186539 9.921294 8.865593 10.791290 15.610421     8
+#>  bulk2_query() 6.812671 6.930544 7.360602 7.056803  7.977824  8.141803     8
 
-suppressWarnings(suppressMessages(
-  ggplot2::autoplot(res) +
-    ggplot2::scale_y_continuous(name="Time [seconds]", n.breaks=6)
-))
                              
+suppressWarnings(suppressMessages(
+  ggplot2::autoplot(res) + 
+    ggplot2::scale_y_continuous(name="Time [seconds]", n.breaks=6)
+))
                              
 
                              
 
                              
   
                              
@@ -313,7 +319,7 @@ 
                              
 
                              
 
 
                              
-  
                              Site built with pkgdown 1.5.1.
                              
+  
                              Site built with pkgdown 1.6.1.
                              
 
                              
 
       
diff --git a/docs/articles/working-with-bulk-apis_files/figure-html/unnamed-chunk-7-1.png b/docs/articles/working-with-bulk-apis_files/figure-html/unnamed-chunk-7-1.png
index d2cffab272532b983f2c49f85fbceb8e320a555e..10323130bbbf923cad2da2f9bb1a0a430fcf5418 100644
GIT binary patch
literal 36756
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

literal 62201
zcmeGEg;!Twv_1~QM@kU|5s;D+kXBMaN(pHJ1!<9Pq`MUrL=fq2k(6$*L8Mb@MY^P$
z-`t${ey@VQf5AOt=wRq^?Y-BU@yusFb3MMPAcc2=>;xJb8lLnGab+|#OlLH-V|qAP
z@F&`+P8~Ef3{unU*Ke9%m%46kVQs5oqo;2uWoTt+YpSm-bqx*e%G0N}wM{5)pB1jM
zGp4)HqGG}Q!2YEO9z9-|DtB^mrPtsfuT_LJ?>E{>gSGjVsK%BnTvfZtiV`>7FHgsw
zeP37RO?`3obiZ&hNB9Z)Z(Y9x|MFUyff$aGS3%Ucj8J
zcy%Wt^ej4YOdcBv=Xbk+XODzfLi_`gNU)OClqgxWv*b{`invZCn#0%My6JxH9^6aJ
zEt8}qqP|acuW0-w?xSbuipot?1fQ&Xcc
z*6*EkF#>~&qFBSkeI{9cr?5EB=AI>eqMK|)LOxM{
zbxEK&y7^7*+ZTHc4Z41tNe^&wTZ3
z)!~$03%$>YPV4gIs{C3QMIoWV!d9P*g@n#kzMkFcATH&MScyUY;;N*(`&`U&S}MIc
ztfxvJ(ls${V`|szeAIodHO0!ORQjDXzEZ7aQ+IP_hjWc($1H8cYfSA|ne8WyFI9zd
z?`AFT*g4%Mv&8yAyx1Q7;qeE`<@>+J)J{u!Ml?oG>9xWbkv{9jgP4Pc!N7-$t>~ue_nJtrP47(A#oGUY)
ziZIWSp`o)NI!|o-mUmQ1k8_FfB#!ksRYT&(H&IFrx37=qm-SC2akFe-|Hk$EMFZ85D_uI#`a2Fs}
zTrs>OZ6q&`#tc8>prHqtqG7;K=lRwqy;>H?oT7fRPYi5tT|M6`G%;W&JhAMOAlUn5+p}ex
zFm!8}_ACazC>r|Te(OCxW}_WwdI^O??Tz-A-@FN^>zl~Y|N3t+@NKft&~+kpuEae3
z+rNcB!yox6^w)La@5*m^qvgwTP&7;a{napV7MITdD-hhO^7*
zzkd=Mik*nMex?Igs)*np%cH8RvH!JWktgs+9Ht(me*MRe!Hx_a`^VpT%VOdzR<68l
zxA@yxz@JewV&G7RxcIz(|NaZrdjesihR`2g!;0w{8Bc^S;uxrk4qsS#y-o{;bULtN>=wqml>;`k2+mV6d84D_88RP
zTl*YklBZR{S(+MIgR|%=rbmd1Jaff;V=>)v)IkLI1*>{ToS5I7)@c#_fV-=kOFzS|
zJvh<$#t-{?fs=h>B1%a~Nx9fW$?l0trb6SdAD?zz1g1}k`Or!{xnW?CM!|1;0mDry
za);?=k|;XUoq{C(5042MFVN7uNz6>0$3J^fr@Gu_cyc?ySJVh2B{h{^G2!Ys{_Z{t
zKR-WLK#_G6u89pF1A}BRr67ZGYXY9#(?F-;Cw5xy91Ho+Q{GhJYX0lQKH&{VW?Mhz!-mU5a5ab!x*dK0ju+GRsV5t^}kRU&Xit{O{o9kM94Eo
zwBZ3xB&D?fu-9M`u*nTs@niq`!UcFhO;rKWzg)2z4DXXJE!m@ge4#V)fWZg3|JtA*
zV44DZXWB*o^@UaNfCY97iGOSm1qXQKugFJO|N6oqcz~;u9?QQr$Qe#3xK5lK{~uqt
z$PN$qKNI*r6ZpR<@PAR@|4$+qvvCcRb?zEa^R^j@ef*ZdU8Ph|4
zk%?qya~g8V9B`e7C{WNM@Vhe?AN29F&5N
zFLpMU`yC4Yl8G=>ywR*Lt@87sa4^L0E{`{NjG>@Q!g@F>X7A-_CaB`
zn7=cO)MohE6d9QzAN$#9*n{zUz$u>A%1$XNj|=^!mSHs4A4YjEx?mUj9?eJ?V%}%*
z#6%}vz{gziS*Y9B5pbHfz;=?2U}dtKXbD${7tqEZknewWf{3}HYN6I#a!*o1B06$?
zuAkBJTX86SMA~5d-?nK4(&RCPmg5AX)HhKv_mX8J*=^Tm)$Km_Ti0n5bLg=C{2bnN
zi}3sR?*^l9AFRC`^xE5$`c`6YEV*p-iq`QjSk#>r^3JEETLEaO7W}r*QX#js7x0eJ
zShsWTD8aWg#5nP>(DU;41dZ4H`bge98Z$2@g|+ath>@lH{>h_eH9`nxC9Icr2F&Vt
zJ>a7>^WHq$osIjQIsH~u@)>f`&*vK3@7=pM7Vk6^T4>l5<65%UtK%kr>ipHowE0fr
zBgTP42P^8?zn)@7jnZB+X`|l!@k~U{iDzQo|2W|V-CB3yDbM6<4-BTevXnFANL7YM
z-vu;dSRFrpTsSLH=7_zb`FsK3-W)`{P3!Ib12ckMn_1U$Gu<>3%YjiL?qZ~_XN6+F
zHo(AWVUNnQEUI6+s?2-Yr-tk5($dm4R<7Q9c=W)vWW3Q9(*2z&(J{2>k~VEVJta3T
zD^ttYNvW{gRgwv3rvLHjS>!;4UFcs3t8rBHSjX^wQa
zS#KVjqVQ(ga7!jpB#W8?)+q{;ME$kduZ5nwu5R&|M>b2eei%$-mrZULY!Bb(Lm)|0
zPp)Qjg*|6+t;aUjSoJgEt(V0XUps_*W36kMuuoAG^r|0rX}~}`Okfs?m0eK!pc7ni
zUQCjU=KLV6mMH8Y&UhX7)>Pl?)B%TH?QwfX#RTp*KVfS`;}e#Tlq90(09fMv2vqDP
zz#;NcN|ltpcFlLHh3?r^+S9@tcSWm+NlBTkYgQwKroNS0_P5|(!7jcWck&2EdJ7wD
zeMj3$AW(Gj_~e+;R-1CcU9l+$csB)HHh)GowIyGthgu=dYpB`<31Ugb55kT>HPHDQA>({R{l$4e+r7p`x>g6`c
zgt5}GN1U|&16Z-P`!5p#)ab>euvZ=%qX8K+E=yws@m*iC(oNb^I`VZzs$9Yt6(b;G
z_06yzehCQwU!f3=)fNkuLi6!HA(tquopTFYK88E=`-ed6m7QoI^`~S!X%LIY3n1V%
z*83czheEBWyFldVCym^O`bLeI7eWRhrsHfMO`_Lcg{cN)iZn=c3Krv-mebwYk(7^y
zN-bl*#0#$bdi4Dz0U1bu8LM_(!9vIIrA?}E%I(Ne=VH<-FDRLwoIq+(Z}elcye(0e
zuXEp#7du*t6takV^Hup$JVU&)Ei`|oH=l2!quvTq*)dxk-T1K~w}tS`M9*)xGMUJ@
zN3xm7FCIA^Z&63!9*m@(=|d8^i-LSz+}fQYf!lr-&x%F6(ms?Wzq*54lQD3aB6PO2
zw(Y3F**pYOG1kJ?@Igb75VYB2C8Rq2`2L-}u*^>PbD~Jy$@5q5(9+V%(M_}_a%h%X
z+_&;GB|WmIzt^O#?N#!zybeDnwP%=BU)_?n$0&^G>be#7YP2g$rKjoYUucl%GjO;}
z?2yuYL~(bvX7ZOlkmyErnrS>_kdMKrJT5GvTje-+0TNf&_C%uB=gIa|56@G~M+#t{
zMSSXd^7FmXI~60&eWLQRaQqz0XMH1RsKnL%$5TF;Pr;PAw+R=8Ae`2;
zppNVabqE3CI7;`ZFz|7n)K|MKU!bS|5Vt**nHVuSIhj=aPM6VgsJh}-mhy*NUQ1)r
zNKzWq^@{(6Y!|@NQ52ceb=zeuOLnP+&$mT@i>F8Q@%Eyl$g#h)@
z?=!=uS^8+g-?qo|Z~HuT9DhV!@gamS{98VlxWqT^-AggOUgNrYfq{YH<=n5{#y}Dd
z_G8$min9}W%p=_Qch}bhaF6Vdcl`%=AsxAZUI=yI3mSh3op>7iEf&b)HzGmGKI;%JH~Q?beU?*N4bs=K*QANe?6$h>?}TXE#*7%hZ1
z6ci#hmnZuBb(}{r-T1YLU)|1TugICO6x~xrRuN#OmF(e%r5xk?I1qk7lt64ZrQ;FZ&NfY7Gc1gmPv4o5eu6(hw9uNji)Q!ADSA%Nc6l?>RGK
z=J+_WK6CwLO@Q)^w{!scxqN@j__pJXW@b|)2gkdB(tidl7@IzB9-%v{GI#gXaH42f{@#{6ARVL!PV;
zckACe?Jy{43Y->nHfM`kPDwsYw&_!&+0g{_tcdxa#oVV8vTm
z*cfMRYu7;UR19L)JJgRKKhBU}o$d~ciaIA%()##mdt=Y{A3xHq1}hzxC4`-qg_YQWS?=M?$NloOL`+$H8
zptgSyy=FWT_RCcPTbOfD;z`xlpuplHQ>C88oEore6|$YlEvqc!I%TpslV8UU4pXeT
z^ah*i#oPKk2iI*aX#3?roQ;^vGF5
zVt2ZmHLecPm-Qc>WxmyLtK526m~d>c)}zW=L6q(2QWs&V;7ST^ET1;wJ5`RkCiO~9
z&3wbG>w`|ZCQesw)MVdzog(e0RA?aG>5D|-H1obO@CNJL^Ea!-#Yrz*wJjy}I2b+_>@UM>DV6v7;GxL<3gI
ztFh;%Kwrn1oE!w09EGLpwY!SM+jVYX3=J|OB6>Q>pb#V!@Wrs}cfC}49us3`t$(!W
z8DNBj;?WyKOgF-eE{}W3Zd|Ua8N!I+N?tBO`2%Q;+*lZ@`M|aQ3&6EuUx8i
zCv6UmK<{jf=g*%T^yH{J#*)^Ut6(^c0<4MT8*+YU^$wibpdp0j?@K&`CDyfAG@f|R
zV5sJ5&;vN&nq${2&AFAYGw9%f(~ZSvHE;(a(%gKmPL0OH(^OXZMTgTp8fqRu<4o|3
zI17PId_7d5txYxk$=9)M7X)URg;%>&CNN!iwBJGOpy-i_@jH@wNC>Ix-7Zt=Tu1X^
z#bwp5ymg97*djO|tabpBka}L=v0cU_F`an#W@cPs)+-#BtSu)NS1g>%7wh%rF3?ytd=l0mLS1+}QUM7aQ9h@at<3yY+(mrxW|FsD)Fm+$
z<=6bpH_ySo2Uncs#z1$%o%Gil_T0{$^2fpgBFfOo>Eahn-Aa2?QX$u3aY;$C$3!fu
z4M3E=)p{_0Gc#W?7_$Dvw4!oi$lnf0)a{n?8j22l{bBJJk~zRvq&xx=6S
z)t28t>x_KITof1Irl#H(6W0JdIfDv(DV5uzuWi*M<=8%R_Zp~2eR;h_fKY)tU1pWn>$c|5MzjCh|U
z<$T}0oBZo=pzwc=hCXz&GG+zShZ@Jk>>=GgNf@N$5_*qbSBv;(la)QoXemgG(L@*HUA9ajrRxrr8O{h!E
zx;ZHYo#x|Arm>ovWRFzvJ|hUIN)R%ZtnWrD?-x)g#tOgx_)#W|L0)T+iY)Q6kLT`|
zbmMdS<`!7z1#mA$v!ZL)4nYqz^g75ktGF!TwD{jpQ0G2}A|X~mQe6DT{@yOVaZ6nC
zpsA}d2Bhl??;he2*34_HcoY~m5f^KF_+9L(k5x
z@Hw1iVp_O;}
zFv$%WndeC4KnhrM2tYr9EOBtJGELgY_#DB;0vub4hcD3j4G>lS8she0v0dvgr1&_;
zeZWqd*5>-LmJBL81kWZwJtF%@1FG-cgz1?j?h+1E>LsE}m4r&!xiR;6M
z799V~dO%JFK=?UMVB?WpfC9U?R~<(eUA{YsuF7s~W7vxk5b+t0x|@gg8OrEOu*$I?
zU)1q!a_gr$GbQZi7#JDBoIZSz4rjit)lWq>@8*M$?nqV5tRO8Ns`u{U<&@HJ7o32LB9-EY1zM7(}(Pk_m~`DERDRVbnW3uQd$B60+QKJSQs5A&a!FT
z5^$I{us#oz>!i5HQH9cPpGI^C(sPbhMMtp+IPN&__T;2V?^?h^Y@Ly;%!KEH^X2d2
zHX1_dIH5IE&*#f^7^~wmfE~OWyVfa>!AV=-Fr(VuUZskh8|BNQ(qBRK=@|CKPC(pW
z;N-CFS4*L0j8aLIaybSn-SRUtKS54a{2zM>aTOx|eHsd1H7R(?J;r2kBa0Sa2Y
z4|yG#XgCA*o$?)N(u8&yFJ7D_y?oCfDom`AFL9_t>-j7KM@O#H8#_cha(e{uK0~?N
z#-iS`tA#}l^y`LaYAwX6Q&C7Y3aBx5&};K2iQuY~xxM`T3iI^avA_)T>w*}8MYRf)b)YRpX~bl;9Qto47YSJmB?T7-B-wWu^!jWL?H%e
zDkerilP^}-q~%ug8%@Z%YU__b3Q8pbHdF@syfX>V)MG4{zhGHGh?=!UX$%-zOi5Fu
zIm)%}E}Ok|dxp77LEefONcR$IWlo3OJFl;Si;su7W?>xKA9M_H5P`9SxoRRhCmkbn
zblu}xcFjB;K*y@YD-^HwXj(s3sFpmMM`od|(p*c!bKuEZ*G7Iu>PEo(M%R>D53@H#
zuvNV$s17;;J4vC2jwPU9J6NwFLNwv33&Q+3QmSOgg+kT&S011Ts4b)Br>O^~!pVdb
zYFVneG5pi-9}{xk|NdUCr+)rOP6<(k=&eD}a}fG=7}~PcI37QF!nvBSQ6l5Hw`p7#
zANb^OSj54G9UZj^pP~b&8^QO<&a0F`Xs;?Bfl&=x+rq!4WdkHjj934chp1ywWFu_a
zmBm?x6D{$D&cD7}^fZhfemDPou%yMBwG|3D4xA^VKxj#*@Z3RyHBexB=HbRijIY5T
z{)yb(*9YPrZ)=SCss-UJrPPO6tTZ%YAA>1pVxMGT9y(l~OMvmojY#6=5r0)60RA~(
ztSPdUdjjxBI5-o3x@qyTL;ncMA`p5tr>7*tTZ@_;e*uvN`eNozGK^Y+fI9xR1zH+N
z@9}Bh!CLi-CY>oPam5c_0c2h+bG&2Vw2q
zCYoazq4Dl0(QkU;aQIU|>K^}WQF5>bpG(9S)$-!Ftp@sVkb)j*!NGq)5|aXl{~0Ob
za`#!*4%qj_Fi{}F)8TkB)&THIM6jxV&*V}%B2h@D58*1Vyl#D9cmsf}MbW1QtID9C
z^pP9b??&Ykv)h7`GarT9js83_pIO`;z=SDwr4(145u{?tFi{I+@K}VVRio!m8s%f?
zL--XT_Q;OeRMi7^VC6CE3W0{C=$SKT44``D1ah^^DRAu&+%~v&7vL4rXlURYcBeyR
z0MOUfwJC0yD7^ay^*A`VcBI5+0AeUbzJP}$fHn$d#Pq)w==p7)cJIuPFLYfsa~TVj
zqWGo}^Waba9KrP=WK?K4NSUg+&jBRq7Jg1kyTI?haS45BpF_fX{kb)%<3V!6dEq@i
zI@gmM>oUm?d&z>RJs{_B-;^J@dg!Rp&$P8yLN$i)e4hc?uwO9;i~k8gI07=MD$<(<
zARG?0icW!Uxi#4A`~un*G?;L%$c;2ICUWmrO^hT
zl~4rpI#~h&NmP>uNY)%52OFC70-Dy`lzz7%QA&9CzFlPheD>Lur$-VYEpC1cKB8zAt@;XL|Ynkl*ic>wlRr0
zFTk!}mz(uRHWmMd4^(6_tqDS{vfYrX@yLRZCjBxlKc^Rt)PG26#0$Y=Wn(7o)-J>D%kt80Gr{|sZ%F@lrGuXe
z>1@E|rrMJICgWpNZTM(uuaWUunAlFQO}6`uSUGy{yRo7VS)gpMApYUKkFi4H4Y}UV
zm&$8LY5Ys{kGe1=u0LJJTM;vYL)WTf!LqO5O`aNKhfblvV?^r$uyb~f)c}x)b9
zDr5Fm>uXbp_ZjGV2TII(b=2vri{5}Jqb1YR(r(mw?v6o)*fOK;r2n-WJ4+mG%IJw$<3KXpbd8N+$B+E6_s5(
zPP0SUy`fkXfcim^y-@k=EH8pF?LH=)azd;2gE>`T1}!A2I6t|5>~600*_S1FL+7fnasm@Cab&RepeQ
zAl-Vn_IX^~Y%14Hyg#i|)b-%h0V_2kA`|wQ=cCcc5Esu25jw$w0WW+WPh7A~DBM{XO3L8(&90_CNcph`r(&@3gzn?hdDqPG{lmZu!
z$`fMcC(qXamc|zfm~X%8>%W5&49Re$-0r_(h6)Fv0^Qv#Zl@1ZK>PZO#?M348{iCb
zUW+^|*dM!zpMiqr2&ZYs1@(fvK5Y1)dINo51e{Up(8p_wu#;H(WNj$q
zyL>E8RPSxgAhee{!~=lepOeJ=>
zqO)aP{k1k^(cLp`Xa|eVo-jE-1O@UV&v(_}y@Cy~AtBU2m^E3gB7%e8V!r=V?^AK4
zBA(T8f=(?f>ia{kaIoosX~05Bc~4nQUqsj8(`Ng2;6x#L-g_yRp-s44Ni;^uZ<|IT
z=qMKhyx#o%>O;gTwe8}FSeWN1h}lZ`WnNs=V<@X#ZV?06RkX@rDbFa%U&N^ZBYbW-fn$wdqEbIjPJS1HLDygxgPVp(VnPNIrnB}
z$6Oruz%DsylEj9fT$c@{l`sHYG2Q@dCsMy7hHvD?@Je6p4`ZS>!1Uan<0BPzFW=et
z@ywA5vMVbPNY8=v9~k=RTZ9R#&(2(*`7bG4Y=d4j0$j!#e%0+y^I8wFLgso70uuf}
z9@}%j?<+Mv*+E5eoRHxLRQ)Zu^TLSUMu*V1YQC}s!+Fr5#^eAdi85e-#P7?+Ar$6`
zs8qzV^J}+WeTm~&QC3#wR3fbUvqqdJX|q4+8t|j2RhR{wFKlegpfd}4LRykf$qX6P
zSX6VOwgt(Ignk38qYO6zUa40*zXoMGd9SSf|x7TiBLp=uvOatpuHm_IPQi0z4bbIvnq(<
z-}=>U64AnPDi&hezn{d}S#A}14!WsE$Oe;h*bo#;dbw<_RDt2(oEU2i`y^MpR)6d?
z(nb>(VQh&PWQ6+XGJgiQNPaCbgm2%POxfRG0AB&+I`JKZuySM%p;(RYUCqv~)zER9
z;C$sg>Ipf8i%Ya6hDX-ED*?;g
zJ_T~{1v|}Bp3#m6QiV`)ycH8=#Cv%&*>}=XI;K*r$>$h$nr@xvQj6e1)c*CA{WGYV
z(M7AIXTN=oe}s32&Yjoy9++5+jlA)ja9{_;utu2`8y*>VNF4ulh6~O*RPP+<4e~Ou
zWD&}E;?7DhrjYwa0e`Dy*`QJ4H81CtfnIH=_?kIo+(gfU>C{^U^VvrsTX6OKpD8+EmkOs$YXq3Bz-*YG4|
z;MTe#gxHek3H&oS(P;Uxd5;yQ^)a1z_EQ;(dTyb%j%B4PtS0*e!1799P;(i1m^Hc3
z2D?P(5X)=ns-tOdn~qK8eiMkvivpv{kI&GzxWyAesi^1!{S_5rHjN9=q~+5+H8)h#
zFFHA~0+pR1&>^;PMvfYc#a$33B&vINz747$H*zw;+b
zr$-;9%(`CcVUc8b#ILp?O>TeltaoD$V|f`a&U>2^bHpYgYIRDRAeWJl+L-nfuuph?
z8NHb)b<;4x`TOzqb{A7waLu1Ug7FeEgHD=ht|^Dk8(h+a`5{Ckt@9o$O6nE1>5Yw5
zzzwC|AOAwS%vPR(-qA`V|G^Ggrm<&F1ABa0<#Oe3FN}urA#U5e&OQGN%A+X3`c-yu
zd5P%KNdwboLTgddEUumMeCZz1tN27XU(psIm@$d$u7r(!4wnTk)qJTxqvoN&n_z|7
z+b?g@gwfK>&BTzX)e*G2mji)&W83y&504=t4*pUbb6U0YGNKwX+66v#RU-iFG!ca~ji!#CnpRl>|t
z69-BB#*I#uNdpt;nY@77jGT){k%Q!Q##r0#le0|su$8r(39~yigI$?Rg=aM!7JSX^Vx~k(0?G@O_!$Hik2GE
zkq!HUDQI}*Jv5r@w-4$-y?d+zXcGEtJ;My9Gu?f?9_xd~Sh*&0;@J4gZ)K^+P}QIX
zK)MZFQ_&OYUG0VOf=&@2_xcv=U>griZtPeGgoUCqO<
zpKN=B@t9{nJDgY4db=CV&=p;>c`BQ}rkAVp6eUy6=7rAjyX|WxqF@SH6RRBA3^Buo
zAQTl=f2-j_V4>Ve$!+SL2FEu0sBwF)j
zP`*S$;%Smo&J?@fY&aWD#Xt8NsRu~kRDt-!6xy%fBGnP_8swc})%NMN{--Z5b#~)A
zT9tMOx>ELgP39du?nvx=wLj)`kkpXRPes?2$4=F~H5F-==2Vd8{2MT*uEw+<%RNQi
z-WQ_apKUZol+!l>2l51*LilI5ZuLSs!=kF
zE=|k*)qJmLstA|m@kZzqHJ?T_Kq$_)G6Bs_vwiItPCU(TxmvI4*Kw`Hp51*ntl3Uw
zJLd<$vEoBNJLyn{&m%xc>UEwq1MbVsM$WZ+^)@^P8{
zJk&Xxrw$PRcVsAZ?B(JJHObovBGxkL1!^v3?BAr6|Ef
zo}qN7?0_GX{yh#~a&%uVP}!pE?E0AZm*!rDKKNQmr!|*Gv5DT^WRFsUz?05I3BTuL
z140hdFD4sCu<*zXHtYqCM|ouTsqk<+~^cH_zQV>0|GED9KE9
zPmjBP(>>9d=TvVm}qH8M!Ng&fyCEqsHFQAw!oVnXaY#6;BRo%XKyNT
zv-$0X?n6b|@8i8p_M+uUFn3QtaDB&F41wn?f)Y|urtN2s3!M2<1jYN~45l{g;6hD%
z@f_m#OD$aG+5PtKzd>NP=-@M{=eP7$Q(<<-s?WW88B~e9=sJ{^JD*wd`-+67PZtu6
zbbI97lYexUkWk-pX)7mnjQeGFuasYP%yO@0yY&<|^^e?1^W?K*ZA#vdq8qBc_qLu2Z+L>ouD;fNIlLjU-CI{UG1j^uC$6LmL
zm+A@jGssA==~L4;Qf=>(yZFI4$J6j9KSa*0W20<$Zv)x>0|=*toGXTt=W?q&w$~V(
zU#1#3q^U^;2IF*7lx|7ReJ#q2E@w>rlu?$5b*aQzb~WjZK2LjS$yc_z-L=@PYyDR8
z)D!BNSoceui+V>Ml~GB?m*3FsB(N3Wk5jmsDIwKlYDFf`KgzGsOGczt?R>vz_`_bi
z2Y0)}L^~Q&KaaK@h@^Uh`8%8c>xGdU|
zFQW`5PR&4g%;4khC;OTuCbawJSDZz&nzcV<>aRO`xtnJkupB8HZ>P(I2dd_8YJewR
zpmJaI*+lQrDiv7Pa|~pd>S;G1n^h2e)$^*K^L08)FKMnWA;Z?Xw1o;`hvd&t$F;mb26&mFHWs0
zNa1Rt%hafB!dS=)@U`gU6RW2ti=8OVtD9oFTmT0!NZJCHjp7gD=E>lhxam5f?`DGQ
zujQ@gb)}kUSFAn7%R=*w!VET7jkO%7Ta_iy3i2aLGo2JcTk=gWl~UzCKPa~BAP^C#
zhywhFpOmWGDSJF*tuH7?ldISqU%gJRQ@X!{xaqx}n~^-Xb1q%G{n`AC^tR)J?zin}
zuk5PI*d3p_o*(PEolaQbg4N7(Gkf>8ie-RjmGkR+Pp_0p-qp6yMdVhCgl*PMY9RcA
zkq;izbJfQuClWHAw+CbdwI9dl-1?bZw$=B?fY&H}lAq{Gu(=1+!8&a&Pqj_H+~~Bn
z>MxaF$-Cd${)%i76wB7l`jc(R;|tG$z3)oHZN9Pf8CRhJOAXnA-k3YAbGJ8vDQISB
zMN1nRPotkJqpg&e3UbBuo;IH%V!86F71+ISq$)c8#$LG$sSt(b>eAbLSFvwfgE1usj
zgF@JS1BJcoo((NNY0^}5ZONZHqVNA0`&SblCh#kL^+lHiv(}htojpIg5lHo
z?sH)ZJ!@aMS{tBRu|92EJUznCjk(8hU*genT0fXy*)>H?td4zbMoHf93vg*wyurk
zHl;;G+nWOj*7*65+={xqsUN0y{x@Qy*puu|AfpGBP7CZn+B^sHCaN!NLc3p}Pz}4W
zW@o8s+&T`F#E(xICHt3(Has2a=EjZ*90P^HnP!QUFg;|p$%r!!W-SvU!^8ZRRarGxx;
zYk9%sVSH`SiH-B3O1kV!G+~Bq*5%bnHgjrK6b}{0hdXrXLM&|r9Wit&$0lHE
zYRP@7+R#JSBnuRa@fY^0Des7(`4pUKJB|zBVA$V{cvs6D$p2e;TG7_kLV9<81Nvy_
zQaF>84+N%Sgzdc(Gw$ChGI|P9(4O-KFE77_d6cHU*ZT6*<$&ZF=>6#gMCsg_@omwE
z0D+yO-hKETre(RB1l~NwI?q!-rM?m%CKY)Kno<}-Jm<0{tbb8my6gQlA|5Rti?Pan
z>Ync>B&nIa!itw3wBxpR-SjG<6cE&R3|!On%eAiCEuC!8V-uh)1pyC3`dfgI4ns_Z
zW-#%_$fR3a&EJX)S8uhYV3A#DSE?nu*&@?U!Kv!qtLciBt8%O}=B*yEX&>2Y9`~;B
zVzCKuMj?C#O96}nLJ{}OqOV}|DhA%vzh3f3CdleipZZV;g;G1g`T=UrNitiYvLdOU!!fNyhX`wfuys
z;9v_?@)Iy&n6&@Xv=TGEPg&%2E+SBm(TuXH_(^O|*oxy!)W*S{OEJF{SUB#LiDcYe
zA(aJ50o$<~MyK?3F~lc67ch|Z3=ek4O@DsO|BWWl;28
zvOlvPh
zo+V2@w>CiQluow(R$!6N7*PD`vFuwpS)?ncw{POjn@xZ~U4|=0&991-3AW|*6VOIA
z2l=;H*{JnbxNq8a4tzTAHk;DiLtT*2|4n4Bh3rcY#u(_r?v?shna&u3US@zMNo0RZ
z-of3ynsT7K)xB9aT^FBVz~PfaTKI1y8+FKKbjpjFPV6ws_b#oj_`8_EB}Em!Ny^S1
z%0A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%0D$75Jw(SRV<NE
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 :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/working-with-metadata.html b/docs/articles/working-with-metadata.html
index 928b8450..3bdaa839 100644
--- a/docs/articles/working-with-metadata.html
+++ b/docs/articles/working-with-metadata.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                              
 
@@ -54,7 +54,7 @@
       
                                
 
                              • 
   
                                Retrieving Object Metadata
                                
 
                                One common use case for the Metadata API is retrieving information about an object (fields, permissions, etc.). First, load the {salesforcer}, {dplyr}, and {purrr} packages and login, if needed.
                                
-
                                library(dplyr, warn.conflicts = FALSE)
-library(purrr)
-library(salesforcer)
-sf_auth()
                                
+
                                +library(dplyr, warn.conflicts = FALSE)
+library(purrr)
+library(salesforcer)
+sf_auth()
                                
 
                                You can use the sf_read_metadata() function to return a list of objects and their metadata. In the example below we retrieve the metadata for the Account and Contact objects. Note that the metadata_type argument is “CustomObject”. Standard Objects are an implementation of CustomObjects, so they are returned using that metadata type.
                                
-
                                read_obj_result <- sf_read_metadata(metadata_type = "CustomObject",
-                                    object_names = c("Account", "Contact"))
+
                                +read_obj_result <- sf_read_metadata(metadata_type = "CustomObject",
+                                    object_names = c("Account", "Contact"))
 
-read_obj_result[[1]][c("fullName", "label", "sharingModel", "enableHistory")]
+read_obj_result[[1]][c("fullName", "label", "sharingModel", "enableHistory")]
 #> $fullName
 #> [1] "Account"
 #> 
@@ -167,10 +169,10 @@ 
                                
 #> $enableHistory
 #> [1] "false"
 
-first_two_fields_idx <- head(which(names(read_obj_result[[1]]) == "fields"), 2)
+first_two_fields_idx <- head(which(names(read_obj_result[[1]]) == "fields"), 2)
 
 # show the first two returned fields of the Account object
-read_obj_result[[1]][first_two_fields_idx]
+read_obj_result[[1]][first_two_fields_idx]
 #> $fields
 #> $fields$fullName
 #> [1] "AccountNumber"
@@ -187,10 +189,11 @@ 
                                
 #> [1] "false"
 #> 
 #> $fields$type
-#> [1] "Picklist"
                                
+#> [1] "Picklist"
                                
 
                                The data is returned as a list because object definitions are highly nested representations. You may notice that we are missing some really specific details, such as, the picklist values of a field with type “Picklist”. You can get that information using
                                sf_describe_object_fields(). Here is an example using sf_describe_object_fields() where we get a tbl_df with one row for each field on the Account object:
                                
-
                                acct_fields <- sf_describe_object_fields("Account")
-acct_fields %>% select(name, label, length, soapType, type)
+
                                +acct_fields <- sf_describe_object_fields("Account")
+acct_fields %>% select(name, label, length, soapType, type)
 #> # A tibble: 68 x 5
 #>   name           label            length soapType    type     
 #>   <chr>          <chr>            <chr>  <chr>       <chr>    
@@ -198,13 +201,13 @@ 
                                
 #> 2 IsDeleted      Deleted          0      xsd:boolean boolean  
 #> 3 MasterRecordId Master Record ID 18     tns:ID      reference
 #> 4 Name           Account Name     255    xsd:string  string   
-#> 5 Type           Account Type     40     xsd:string  picklist 
+#> 5 Type           Account Type     255    xsd:string  picklist 
 #> # … with 63 more rows
 
 # show the picklist selection options for the Account Type field
-acct_fields %>%
-  filter(label == "Account Type") %>%
-  .$picklistValues
+acct_fields %>% 
+  filter(label == "Account Type") %>% 
+  .$picklistValues
 #> [[1]]
 #> # A tibble: 7 x 4
 #>   active defaultValue label                      value                     
@@ -214,12 +217,13 @@ 
                                
 #> 3 true   false        Customer - Channel         Customer - Channel        
 #> 4 true   false        Channel Partner / Reseller Channel Partner / Reseller
 #> 5 true   false        Installation Partner       Installation Partner      
-#> # … with 2 more rows
                                
+#> # … with 2 more rows
                                
 
                                If you prefer to be more precise about collecting and formatting the field data you can work directly with the nested lists that the APIs return. In this example we look at the picklist values of fields on the Account object.
                                
-
                                describe_obj_result <- sf_describe_objects(object_names=c('Account', 'Contact'))
+
                                +describe_obj_result <- sf_describe_objects(object_names=c('Account', 'Contact'))
 
 # confirm that the Account object is queryable
-describe_obj_result[[1]][c('label', 'queryable')]
+describe_obj_result[[1]][c('label', 'queryable')]
 #> $label
 #> [1] "Account"
 #> 
@@ -227,13 +231,13 @@ 
                                
 #> [1] "true"
 
 # now show the different picklist values for the Account Type field
-all_fields <- describe_obj_result[[1]][names(describe_obj_result[[1]]) == "fields"]
+all_fields <- describe_obj_result[[1]][names(describe_obj_result[[1]]) == "fields"]
 
-acct_type_field_idx <- which(sapply(all_fields,
-                                    FUN=function(x){x$label}) == "Account Type")
-acct_type_field <- all_fields[[acct_type_field_idx]]
-acct_type_field[which(names(acct_type_field) == "picklistValues")] %>%
-  map_df(as_tibble)
+acct_type_field_idx <- which(sapply(all_fields, 
+                                    FUN=function(x){x$label}) == "Account Type")
+acct_type_field <- all_fields[[acct_type_field_idx]]
+acct_type_field[which(names(acct_type_field) == "picklistValues")] %>% 
+  map_df(as_tibble)
 #> # A tibble: 7 x 4
 #>   active defaultValue label                      value                     
 #>   <chr>  <chr>        <chr>                      <chr>                     
@@ -242,62 +246,64 @@ 
                                
 #> 3 true   false        Customer - Channel         Customer - Channel        
 #> 4 true   false        Channel Partner / Reseller Channel Partner / Reseller
 #> 5 true   false        Installation Partner       Installation Partner      
-#> # … with 2 more rows
                                
+#> # … with 2 more rows
                                
 
                                It is recommended that you try out the various metadata functions sf_read_metadata(), sf_list_metadata(), sf_describe_metadata(), and sf_describe_objects() in order to see which information best suits your use case.
                                
 
                                
 
                                
 
                                
 Modifying Metadata
                                
 
                                Where the Metadata API really shines is when it comes to CRUD operations on metadata. In this example we will create an object, add fields to it, then delete that object.
                                
-
                                # create an object
-base_obj_name <- "Custom_Account1"
-custom_object <- list()
-custom_object$fullName <- paste0(base_obj_name, "__c")
-custom_object$label <- paste0(gsub("_", " ", base_obj_name))
-custom_object$pluralLabel <- paste0(base_obj_name, "s")
-custom_object$nameField <- list(displayFormat = 'AN-{0000}',
-                                label = paste0(base_obj_name, ' Number'),
-                                type = 'AutoNumber')
-custom_object$deploymentStatus <- 'Deployed'
-custom_object$sharingModel <- 'ReadWrite'
-custom_object$enableActivities <- 'true'
-custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
-custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
-                                           metadata = custom_object)
+
                                +# create an object
+base_obj_name <- "Custom_Account1"
+custom_object <- list()
+custom_object$fullName <- paste0(base_obj_name, "__c")
+custom_object$label <- paste0(gsub("_", " ", base_obj_name))
+custom_object$pluralLabel <- paste0(base_obj_name, "s")
+custom_object$nameField <- list(displayFormat = 'AN-{0000}', 
+                                label = paste0(base_obj_name, ' Number'), 
+                                type = 'AutoNumber')
+custom_object$deploymentStatus <- 'Deployed'
+custom_object$sharingModel <- 'ReadWrite'
+custom_object$enableActivities <- 'true'
+custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
+custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
+                                           metadata = custom_object)
 
 # add fields to the object
-custom_fields <- tibble(fullName=c(paste0(base_obj_name, '__c.CustomField3__c'),
-                                   paste0(base_obj_name, '__c.CustomField4__c')),
-                        label=c('Test Field3', 'Test Field4'),
-                        length=c(100, 100),
-                        type=c('Text', 'Text'))
-create_fields_result <- sf_create_metadata(metadata_type = 'CustomField',
-                                           metadata = custom_fields)
+custom_fields <- tibble(fullName=c(paste0(base_obj_name, '__c.CustomField3__c'), 
+                                   paste0(base_obj_name, '__c.CustomField4__c')), 
+                        label=c('Test Field3', 'Test Field4'), 
+                        length=c(100, 100), 
+                        type=c('Text', 'Text'))
+create_fields_result <- sf_create_metadata(metadata_type = 'CustomField', 
+                                           metadata = custom_fields)
 
 # delete the object
-delete_obj_result <- sf_delete_metadata(metadata_type = 'CustomObject',
-                                        object_names = c('Custom_Account1__c'))
                                
+delete_obj_result <- sf_delete_metadata(metadata_type = 'CustomObject', 
+                                        object_names = c('Custom_Account1__c'))
                                
 
                                Note that newly created custom fields are not editable by default, meaning that you will not be able to insert records into them until updating the field level security of your user profile. Run the following code to determine the user profiles in your org and updating the field permissions on an object that you may have created with the example code above.
                                
-
                                # get list of user proviles in order to get the "fullName" 
+
                                +# get list of user proviles in order to get the "fullName" 
 # parameter correct in the next call
-my_queries <- list(list(type = 'Profile'))
-profiles_list <- sf_list_metadata(queries = my_queries)
+my_queries <- list(list(type = 'Profile'))
+profiles_list <- sf_list_metadata(queries = my_queries)
 
-admin_editable <- list(fullName = 'Admin',
-                       fieldPermissions=list(field=paste0(custom_object$fullName,
-                                                          '.CustomField3__c'),
-                                             editable='true'),
-                       fieldPermissions=list(field=paste0(custom_object$fullName,
-                                                          '.CustomField4__c'),
-                                             editable='true'))
+admin_editable <- list(fullName = 'Admin', 
+                       fieldPermissions=list(field=paste0(custom_object$fullName, 
+                                                          '.CustomField3__c'),
+                                             editable='true'), 
+                       fieldPermissions=list(field=paste0(custom_object$fullName, 
+                                                          '.CustomField4__c'),
+                                             editable='true'))
 
 # update the field level security to "editable" for your fields
-prof_update <- sf_update_metadata(metadata_type = 'Profile',
-                                  metadata = admin_editable)
+prof_update <- sf_update_metadata(metadata_type = 'Profile', 
+                                  metadata = admin_editable)
 
 # now try inserting values into that custom object's fields
-my_new_data = tibble(CustomField3__c = "Hello World", CustomField4__c = "Hello World")
-added_record <- sf_create(my_new_data, object_name = custom_object$fullName)
                                
+my_new_data = tibble(CustomField3__c = "Hello World", CustomField4__c = "Hello World")
+added_record <- sf_create(my_new_data, object_name = custom_object$fullName)
                                
 
                                
   
                                
 
@@ -316,7 +322,7 @@ 
                                
 
                                
 
 
                                
-  
                                Site built with pkgdown 1.5.1.
                                
+  
                                Site built with pkgdown 1.6.1.
                                
 
                                
 
       
diff --git a/docs/articles/working-with-metadata_files/header-attrs-2.9/header-attrs.js b/docs/articles/working-with-metadata_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/working-with-metadata_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/articles/working-with-reports.html b/docs/articles/working-with-reports.html
index 65faa76d..b8593f43 100644
--- a/docs/articles/working-with-reports.html
+++ b/docs/articles/working-with-reports.html
@@ -46,7 +46,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                                
 
@@ -54,7 +54,7 @@
       
                                  
 
                                • 
   
                                  Authenticate
                                  
 
                                  First, load the {salesforcer} package and login either by OAuth 2.0 (SSO) or using your username, password, and security key.
                                  
-
                                  library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
-sf_auth()
                                  
+
                                  +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
+sf_auth()
                                  
 
                                  
 
                                  
 
                                  
@@ -174,76 +175,80 @@ 
                                  
 
                                  In Salesforce there is a dedicated page to displaying the list of reports in your Org. It typically follows the pattern: https://na1.salesforce.com/00O/o (replace na1 with your server instance). When you click on a report in the GUI you should see the results. Below is a screenshot of how a report may look in your Org. Note the report Id in the URL bar.
                                  
 
                                  
 
                                  The report Id above ("00O3s000006tE7zEAE") is the only information needed to pull those same results from an R session, like so:
                                  
-
                                  my_report_id <- "00O3s000006tE7zEAE"
-results <- sf_run_report(my_report_id)
-results
+
                                  +my_report_id <- "00O3s000006tE7zEAE"
+results <- sf_run_report(my_report_id)
+results
 #> # A tibble: 14 x 8
-#>   `Contact ID` `First Name` `test number` `Contact Owner` `Account ID`
-#>   <chr>        <chr>                <dbl> <chr>           <chr>       
-#> 1 0036A000002… Rose                    NA Steven Mortimer 0016A000003…
-#> 2 0036A000002… Sean                    NA Steven Mortimer 0016A000003…
-#> 3 0036A000002… Jack                    99 Steven Mortimer 0016A000003…
-#> 4 0036A000002… Tim                     NA Steven Mortimer 0016A000003…
-#> 5 0036A000002… John                    23 Steven Mortimer 0016A000003…
-#> # … with 9 more rows, and 3 more variables: `Account Name` <chr>, `Billing
-#> #   City` <chr>, `Account Owner` <chr>
                                  
+#>   `Contact ID`    `First Name` `test number` `Contact Owner` `Account ID`   
+#>   <chr>           <chr>                <dbl> <chr>           <chr>          
+#> 1 0036A000002C6Mm Edna                    NA Steven Mortimer 0016A0000035mJE
+#> 2 0036A000002C6Ml Liz                     NA Steven Mortimer 0016A0000035mJD
+#> 3 0036A000002C6Mk Tom                     NA Steven Mortimer 0016A0000035mJD
+#> 4 0036A000002C6MX Sean                    NA Steven Mortimer 0016A0000035mJ4
+#> 5 0036A000002C6MW Rose                    NA Steven Mortimer 0016A0000035mJ4
+#> # … with 9 more rows, and 3 more variables: Account Name <chr>,
+#> #   Billing City <chr>, Account Owner <chr>
                                  
 
                                  Note that the sf_run_report() function will, by default, run the report asynchronously. This means that a report instance will be requested and then the function will wait to retrieve the results. The advantage to using an asynchronous report is that the results of such a report are stored for 24 hours and can be retrieved again saving CPU resources, if needed. A more in-depth discussion on synchronous vs. asynchronous reports is available here https://developer.salesforce.com/docs/atlas.en-us.api_analytics.meta/api_analytics/sforce_analytics_rest_api_get_reportdata.htm. However, for reports with a relatively small number of records a synchronous report may be faster without having to do the round trip of creating then querying a report instance.
                                  
 
                                  
 
                                  
 
                                  
 Filtering a Report on the Fly
                                  
 
                                  The neat thing about using the API is that you can retrieve the results of a report with different filters applied. This allows you to obtain exactly the results needed without having to create separate copies of the same report. It takes some basic understanding of how report operators need to be supplied to the API, but it is not too difficult. Below is an example that only includes contact records created prior to this month and belong to an Account with a non-NULL Billing City.
                                  
-
                                  # filter records that was created before this month
-filter1 <- list(column = "CREATED_DATE",
-                        operator = "lessThan",
-                        value = "THIS_MONTH")
+
                                  +# filter records that was created before this month
+filter1 <- list(column = "CREATED_DATE",
+                        operator = "lessThan", 
+                        value = "THIS_MONTH")
 
 # filter records where the account billing address city is not empty
-filter2 <-  list(column = "ACCOUNT.ADDRESS1_CITY",
-                        operator = "notEqual",
-                        value = "")
+filter2 <-  list(column = "ACCOUNT.ADDRESS1_CITY",
+                        operator = "notEqual", 
+                        value = "")
 
 # combine filter1 and filter2 using 'AND' which means that records must meet both filters
-results_using_AND <- sf_run_report(my_report_id,
-                                   report_boolean_logic = "1 AND 2",
-                                   report_filters = list(filter1, filter2))
-results_using_AND
+results_using_AND <- sf_run_report(my_report_id, 
+                                   report_boolean_logic = "1 AND 2",
+                                   report_filters = list(filter1, filter2))
+results_using_AND
 #> # A tibble: 14 x 8
-#>   `Contact ID` `First Name` `test number` `Contact Owner` `Account ID`
-#>   <chr>        <chr>                <dbl> <chr>           <chr>       
-#> 1 0036A000002… Rose                    NA Steven Mortimer 0016A000003…
-#> 2 0036A000002… Sean                    NA Steven Mortimer 0016A000003…
-#> 3 0036A000002… Jack                    99 Steven Mortimer 0016A000003…
-#> 4 0036A000002… Tim                     NA Steven Mortimer 0016A000003…
-#> 5 0036A000002… John                    23 Steven Mortimer 0016A000003…
-#> # … with 9 more rows, and 3 more variables: `Account Name` <chr>, `Billing
-#> #   City` <chr>, `Account Owner` <chr>
                                  
+#>   `Contact ID`    `First Name` `test number` `Contact Owner` `Account ID`   
+#>   <chr>           <chr>                <dbl> <chr>           <chr>          
+#> 1 0036A000002C6MW Rose                    NA Steven Mortimer 0016A0000035mJ4
+#> 2 0036A000002C6MX Sean                    NA Steven Mortimer 0016A0000035mJ4
+#> 3 0036A000002C6MY Jack                    99 Steven Mortimer 0016A0000035mJ5
+#> 4 0036A000002C6Mb Tim                     NA Steven Mortimer 0016A0000035mJ8
+#> 5 0036A000002C6Mc John                    23 Steven Mortimer 0016A0000035mJ8
+#> # … with 9 more rows, and 3 more variables: Account Name <chr>,
+#> #   Billing City <chr>, Account Owner <chr>
                                  
 
                                  This second example shows how to return only the Top N number of records and combine the filter using the logical “OR” instead of “AND”.
                                  
-
                                  # combine filter1 and filter2 using 'OR' which means that records must meet one 
+
                                  +# combine filter1 and filter2 using 'OR' which means that records must meet one 
 # of the filters but also throw in a row limit based on a specific sort order
-results_using_OR <- sf_run_report(my_report_id,
-                                  report_boolean_logic = "1 OR 2",
-                                  report_filters = list(filter1, filter2),
-                                  sort_by = "Contact.test_number__c",
-                                  decreasing = TRUE,
-                                  top_n = 5)
-results_using_OR
+results_using_OR <- sf_run_report(my_report_id, 
+                                  report_boolean_logic = "1 OR 2",
+                                  report_filters = list(filter1, filter2), 
+                                  sort_by = "Contact.test_number__c", 
+                                  decreasing = TRUE, 
+                                  top_n = 5)
+results_using_OR
 #> # A tibble: 5 x 8
-#>   `Contact ID` `First Name` `test number` `Contact Owner` `Account ID`
-#>   <chr>        <chr>                <dbl> <chr>           <chr>       
-#> 1 0033s000012… KEEP                  1000 Steven Mortimer 0013s00000z…
-#> 2 0033s000012… KEEP                  1000 Steven Mortimer 0013s00000z…
-#> 3 0033s000012… KEEP                  1000 Steven Mortimer 0013s00000z…
-#> 4 0033s000012… KEEP                  1000 Steven Mortimer 0013s00000z…
-#> 5 0033s000012… KEEP                  1000 Steven Mortimer 0013s00000z…
-#> # … with 3 more variables: `Account Name` <chr>, `Billing City` <chr>, `Account
-#> #   Owner` <chr>
                                  
+#>   `Contact ID`    `First Name` `test number` `Contact Owner` `Account ID`   
+#>   <chr>           <chr>                <dbl> <chr>           <chr>          
+#> 1 0033s000012Nl0A KEEP                  1000 Steven Mortimer 0013s00000zFdug
+#> 2 0033s000012Nl0E KEEP                  1000 Steven Mortimer 0013s00000zFdug
+#> 3 0033s000012Nl0B KEEP                  1000 Steven Mortimer 0013s00000zFdug
+#> 4 0033s000012Nl0C KEEP                  1000 Steven Mortimer 0013s00000zFdug
+#> 5 0033s000012Nl0D KEEP                  1000 Steven Mortimer 0013s00000zFdug
+#> # … with 3 more variables: Account Name <chr>, Billing City <chr>,
+#> #   Account Owner <chr>
                                  
 
                                  I was able to determine some of the potential ways to filter by first reviewing the reportFilters element in the existing report metadata and also reviewing the list of report filter operators.
                                  
 
                                  First, you can always take the report filter specification from the report metadata and tailor it to your needs. Below is an example showing how to get that metadata for our report. You can select specific elements to better understand the structure of the report.
                                  
-
                                  report_details <- sf_describe_report(my_report_id)
-report_details$reportMetadata$reportType$type
+
                                  +report_details <- sf_describe_report(my_report_id)
+report_details$reportMetadata$reportType$type
 #> [1] "ContactList"
-report_details$reportMetadata$reportFilters
+report_details$reportMetadata$reportFilters
 #> [[1]]
 #> [[1]]$column
 #> [1] "CREATED_DATE"
@@ -275,33 +280,35 @@ 
                                  
 #> [1] "notEqual"
 #> 
 #> [[2]]$value
-#> [1] ""
                                  
+#> [1] ""
                                  
 
                                  Second, Salesforce has a few API endpoints that tell you the fields on the report or the report type, more generally, and all the ways you can declare a filter on a particular field type and. The reportTypeMetadata element returned on the report description also has detailed information on how to filter the report. For example, it already contains the start and end dates that would be applied when using the “LAST_MONTH” filter value on a date field.
                                  
-
                                  report_details$reportTypeMetadata$standardDateFilterDurationGroups[[6]]$standardDateFilterDurations[[1]]
+
                                  +report_details$reportTypeMetadata$standardDateFilterDurationGroups[[6]]$standardDateFilterDurations[[1]]
 #> $endDate
-#> [1] "2020-08-31"
+#> [1] "2021-06-30"
 #> 
 #> $label
 #> [1] "Last Month"
 #> 
 #> $startDate
-#> [1] "2020-08-01"
+#> [1] "2021-06-01"
 #> 
 #> $value
-#> [1] "LAST_MONTH"
                                  
+#> [1] "LAST_MONTH"
                                  
 
                                  Digging into the metadata of the report will allow you to better understand what filters you can set when filtering on the fly. In the example below you should notice that the field names on the report do not match the names of the typical API field names for the object, so please review carefully the fields on the report. For example, the CREATED_DATE report field is based on the CreatedDate object field.
                                  
-
                                  # report fields
-report_fields <- sf_list_report_fields(my_report_id)
-head(names(report_fields$equivalentFieldIndices))
+
                                  +# report fields
+report_fields <- sf_list_report_fields(my_report_id)
+head(names(report_fields$equivalentFieldIndices))
 #> [1] "CONTACT_CREATED_ALIAS"     "Contact.My_External_Id__c"
 #> [3] "IS_EMAIL_BOUNCED"          "REPORTS_TO"               
 #> [5] "ADDRESS2_ZIP"              "LAST_ACTIVITY"
 
-report_filters <- sf_list_report_filter_operators()
-unique_supported_fields <- report_filters %>%
-  distinct(supported_field_type) %>%
-  unlist()
-unique_supported_fields
+report_filters <- sf_list_report_filter_operators()
+unique_supported_fields <- report_filters %>% 
+  distinct(supported_field_type) %>% 
+  unlist()
+unique_supported_fields
 #>        supported_field_type1        supported_field_type2 
 #>                       "date"                    "address" 
 #>        supported_field_type3        supported_field_type4 
@@ -326,9 +333,9 @@ 
                                  
 #>                      "email"              "multipicklist"
 
 # operators to filter a picklist field
-picklist_field_operators <- report_filters %>%
-  filter(supported_field_type == "picklist")
-picklist_field_operators
+picklist_field_operators <- report_filters %>% 
+  filter(supported_field_type == "picklist")
+picklist_field_operators
 #> # A tibble: 9 x 3
 #>   supported_field_type label         name       
 #>   <chr>                <chr>         <chr>      
@@ -337,44 +344,45 @@ 
                                  
 #> 3 picklist             less than     lessThan   
 #> 4 picklist             greater than  greaterThan
 #> 5 picklist             less or equal lessOrEqual
-#> # … with 4 more rows
                                  
+#> # … with 4 more rows
                                  
 
                                  
 
                                  
 
                                  
 Managing your Reports
                                  
 
                                  The API also allows you to perform many admin functions like creating, copying, updating, or deleting reports and report instances. Take advantage of these functions as needed to keep your Org’s report list well-maintained. Below is a simple flow of creating, updating, and deleting a single report, but the amount you’re able to customize is completely up to you. The {salesforcer} package should support any operation that the Reports and Dashboards REST API supports.
                                  
-
                                  # first, grab all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+
                                  +# first, grab all possible reports in your Org
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # second, get the id of the report to update
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
-new_report <- sf_copy_report(this_report_id)
+new_report <- sf_copy_report(this_report_id)
 #> Naming the new report: 'KEEP - Accounts and Contacts - Copy'
 
 # third, update the report (2 ways shown)
-my_updated_report <- sf_update_report(new_report$reportMetadata$id,
-                                      report_metadata =
-                                        list(reportMetadata =
-                                          list(name = "Updated Name!")))
-my_updated_report$reportMetadata$name
+my_updated_report <- sf_update_report(new_report$reportMetadata$id,
+                                      report_metadata =
+                                        list(reportMetadata =
+                                          list(name = "Updated Name!")))
+my_updated_report$reportMetadata$name
 #> [1] "Updated Name!"
 
 # alternatively, pull down its metadata and update the name
-report_details <- sf_describe_report(new_report$reportMetadata$id)
-report_details$reportMetadata$name <- paste0(report_details$reportMetadata$name,
-                                             " - UPDATED AGAIN!")
+report_details <- sf_describe_report(new_report$reportMetadata$id)
+report_details$reportMetadata$name <- paste0(report_details$reportMetadata$name,
+                                             " - UPDATED AGAIN!")
 
 # update the report by passing the metadata
-my_updated_report <- sf_update_report(new_report$reportMetadata$id,
-                                      report_metadata = report_details)
-my_updated_report$reportMetadata$name
+my_updated_report <- sf_update_report(new_report$reportMetadata$id,
+                                      report_metadata = report_details)
+my_updated_report$reportMetadata$name
 #> [1] "Updated Name! - UPDATED AGAIN!"
 
 # fourth, delete that report using its Id
-success <- sf_delete_report(new_report$reportMetadata$id)
-success
-#> [1] TRUE
                                  
+success <- sf_delete_report(new_report$reportMetadata$id)
+success
+#> [1] TRUE
                                  
 
                                  
 
                                  
 
                                  
@@ -417,7 +425,7 @@ 
                                  
 
                                  
 
 
                                  
-  
                                  Site built with pkgdown 1.5.1.
                                  
+  
                                  Site built with pkgdown 1.6.1.
                                  
 
                                  
 
       
diff --git a/docs/articles/working-with-reports_files/header-attrs-2.9/header-attrs.js b/docs/articles/working-with-reports_files/header-attrs-2.9/header-attrs.js
new file mode 100644
index 00000000..dd57d92e
--- /dev/null
+++ b/docs/articles/working-with-reports_files/header-attrs-2.9/header-attrs.js
@@ -0,0 +1,12 @@
+// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+  var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+  var i, h, a;
+  for (i = 0; i < hs.length; i++) {
+    h = hs[i];
+    if (!/^h[1-6]$/i.test(h.tagName)) continue;  // it should be a header h1-h6
+    a = h.attributes;
+    while (a.length > 0) h.removeAttribute(a[0].name);
+  }
+});
diff --git a/docs/authors.html b/docs/authors.html
index cca14a87..94454517 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                                  
 
@@ -103,7 +103,7 @@
       
                                  pkgdown 1.5.1.
                                  
+  
                                  Site built with pkgdown 1.6.1.
                                  
 
                                  
 
       
diff --git a/docs/index.html b/docs/index.html
index 35371273..3f4fd0a1 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -54,7 +54,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
                                  
 
@@ -62,7 +62,7 @@
       
                                    
 
                                  • 
   
                                    • sf_auth())
                                      • 
@@ -195,27 +195,28 @@ 
                                      
 
                                      
 
                                      
 Installation
                                      
-
                                      # install the current CRAN version (0.2.0)
-install.packages("salesforcer")
+
                                      +# install the current CRAN version (1.0.0)
+install.packages("salesforcer")
 
 # or get the development version on GitHub
 # install.packages("remotes")
-remotes::install_github("StevenMMortimer/salesforcer")
                                      
-
                                      If you encounter an issue while using this package, please file a minimal reproducible example on GitHub.
                                      
+remotes::install_github("StevenMMortimer/salesforcer")
                                      
+
                                      If you encounter an issue while using this package, please file a minimal reproducible example on GitHub.
                                      
 
                                      
 
 
                                      
@@ -230,127 +231,134 @@ 
                                      
 
                                    • Basic Username-Password
                                      • 
 
 
                                      It is recommended to use OAuth 2.0 so that passwords do not have to be shared or embedded within scripts. User credentials will be stored in locally cached file entitled “.httr-oauth-salesforcer” in the current working directory. Also, note that if you use OAuth 2.0 authentication then the package will automatically refresh it so you will not have to call sf_auth() during each session if you have a cached “.httr-oauth-salesforcer” file in the working directory. The cache file is named that way to not conflict with the “.httr-oauth” files created by other packages.
                                      
-
                                      library(dplyr, warn.conflicts = FALSE)
-library(salesforcer)
+
                                      +library(dplyr, warn.conflicts = FALSE)
+library(salesforcer)
 
 # Using OAuth 2.0 authentication
-sf_auth()
+sf_auth()
 
 # Using Basic Username-Password authentication
-sf_auth(username = "test@gmail.com",
-        password = "{PASSWORD_HERE}",
-        security_token = "{SECURITY_TOKEN_HERE}")
                                      
+sf_auth(username = "test@gmail.com", 
+        password = "{PASSWORD_HERE}",
+        security_token = "{SECURITY_TOKEN_HERE}")
                                      
 
                                      After logging in with sf_auth(), you can check your connectivity by looking at the information returned about the current user. It should be information about you!
                                      
-
                                      # pull down information of person logged in
+
                                      +# pull down information of person logged in
 # it's a simple easy call to get started 
 # and confirm a connection to the APIs
-user_info <- sf_user_info()
-sprintf("Organization Id: %s", user_info$organizationId)
+user_info <- sf_user_info()
+sprintf("Organization Id: %s", user_info$organizationId)
 #> [1] "Organization Id: 00D6A0000003dN3UAI"
-sprintf("User Id: %s", user_info$userId)
-#> [1] "User Id: 0056A000000MPRjQAO"
                                      
+sprintf("User Id: %s", user_info$userId)
+#> [1] "User Id: 0056A000000MPRjQAO"
                                      
 
                                      
 
                                      
 
                                      
 Create
                                      
 
                                      Salesforce has objects and those objects contain records. One default object is the “Contact” object. This example shows how to create two records in the Contact object.
                                      
-
                                      n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n))
-created_records <- sf_create(new_contacts, object_name = "Contact")
-created_records
+
                                      +n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n))
+created_records <- sf_create(new_contacts, object_name = "Contact")
+created_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014Ad7FAAS TRUE   
-#> 2 0033s000014Ad7GAAS TRUE
                                      
+#> 1 0033s000014AgfSAAS TRUE   
+#> 2 0033s000014AgfTAAS TRUE
                                      
 
                                      
 
                                      
 
                                      
 Query
                                      
 
                                      Salesforce has proprietary form of SQL called SOQL (Salesforce Object Query Language). SOQL is a powerful tool that allows you to return the attributes of records on almost any object in Salesforce including Accounts, Contacts, Tasks, Opportunities, even Attachments! Below is an example where we grab the data we just created including Account object information for which the Contact record is associated with.
                                      
-
                                      my_soql <- sprintf("SELECT Id, 
+
                                      +my_soql <- sprintf("SELECT Id, 
                            Account.Name, 
                            FirstName, 
                            LastName 
                     FROM Contact 
-                    WHERE Id in ('%s')",
-                   paste0(created_records$id , collapse = "','"))
-queried_records <- sf_query(my_soql)
-queried_records
+                    WHERE Id in ('%s')", 
+                   paste0(created_records$id , collapse = "','"))
+queried_records <- sf_query(my_soql)
+queried_records
 #> # A tibble: 2 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
-#> 1 0033s000014Ad7FAAS Test      Contact-Create-1
-#> 2 0033s000014Ad7GAAS Test      Contact-Create-2
                                      
-
                                      NOTE: In the example above, you’ll notice that the "Account.Name" column does not appear in the results. This is because the SOAP and REST APIs only return an empty Account object for the record if there is no relationship to an account ( see #78). There is no reliable way to extract and rebuild the empty columns based on the query string. If there were Account information, an additional column titled "Account.Name" would appear in the results. Note, that the Bulk 1.0 and Bulk 2.0 APIs will return "Account.Name" as a column of all NA values for this query because they return results differently.
                                      
+#> 1 0033s000014AgfSAAS Test      Contact-Create-1
+#> 2 0033s000014AgfTAAS Test      Contact-Create-2
                                      
+
                                      NOTE: In the example above, you’ll notice that the "Account.Name" column does not appear in the results. This is because the SOAP and REST APIs only return an empty Account object for the record if there is no relationship to an account (see #78). There is no reliable way to extract and rebuild the empty columns based on the query string. If there were Account information, an additional column titled "Account.Name" would appear in the results. Note, that the Bulk 1.0 and Bulk 2.0 APIs will return "Account.Name" as a column of all NA values for this query because they return results differently.
                                      
 
                                      
 
                                      
 
                                      
 Update
                                      
 
                                      After creating records you can update them using sf_update(). Updating a record requires you to pass the Salesforce Id of the record. Salesforce creates a unique 18-character identifier on each record and uses that to know which record to attach the update information you provide. Simply include a field or column in your update dataset called “Id” and the information will be matched. Here is an example where we update each of the records we created earlier with a new first name called “TestTest”.
                                      
-
                                      # Update some of those records
-queried_records <- queried_records %>%
-  mutate(FirstName = "TestTest")
-
-updated_records <- sf_update(queried_records, object_name = "Contact")
-updated_records
+
                                      +# Update some of those records
+queried_records <- queried_records %>%
+  mutate(FirstName = "TestTest")
+  
+updated_records <- sf_update(queried_records, object_name = "Contact")
+updated_records
 #> # A tibble: 2 x 2
 #>   id                 success
 #>   <chr>              <lgl>  
-#> 1 0033s000014Ad7FAAS TRUE   
-#> 2 0033s000014Ad7GAAS TRUE
                                      
+#> 1 0033s000014AgfSAAS TRUE   
+#> 2 0033s000014AgfTAAS TRUE
                                      
 
                                      
 
                                      
 
                                      
 Bulk Operations
                                      
 
                                      For really large operations (inserts, updates, upserts, deletes, and queries) Salesforce provides the Bulk 1.0 and Bulk 2.0 APIs. In order to use the Bulk APIs in {salesforcer} you can just add api_type = "Bulk 1.0" or api_type = "Bulk 2.0" to your functions and the operation will be executed using the Bulk APIs. It’s that simple.
                                      
 
                                      The benefits of using the Bulk API for larger datasets is that the operation will reduce the number of individual API calls (organization usually have a limit on total calls) and batching the requests in bulk is usually quicker than running thousands of individuals calls when your data is large. Note: the Bulk 2.0 API does NOT guarantee the order of the data submitted is preserved in the output. This means that you must join on other data columns to match up the Ids that are returned in the output with the data you submitted. For this reason, Bulk 2.0 may not be a good solution for creating, updating, or upserting records where you need to keep track of the created Ids. The Bulk 2.0 API would be fine for deleting records where you only need to know which Ids were successfully deleted.
                                      
-
                                      # create contacts using the Bulk API
-n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n))
-created_records <- sf_create(new_contacts, "Contact", api_type = "Bulk 1.0")
-created_records
+
                                      +# create contacts using the Bulk API
+n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n))
+created_records <- sf_create(new_contacts, "Contact", api_type = "Bulk 1.0")
+created_records
 #> # A tibble: 2 x 4
 #>   Id                 Success Created Error
 #>   <chr>              <lgl>   <lgl>   <lgl>
-#> 1 0033s000014Ad7KAAS TRUE    TRUE    NA   
-#> 2 0033s000014Ad7LAAS TRUE    TRUE    NA
+#> 1 0033s000014AgfXAAS TRUE    TRUE    NA   
+#> 2 0033s000014AgfYAAS TRUE    TRUE    NA
 
 # query large recordsets using the Bulk API
-my_soql <- sprintf("SELECT Id,
+my_soql <- sprintf("SELECT Id,
                            FirstName, 
                            LastName
                     FROM Contact 
-                    WHERE Id in ('%s')",
-                   paste0(created_records$Id , collapse = "','"))
+                    WHERE Id in ('%s')", 
+                   paste0(created_records$Id , collapse = "','"))
 
-queried_records <- sf_query(my_soql, "Contact", api_type = "Bulk 1.0")
-queried_records
+queried_records <- sf_query(my_soql, "Contact", api_type = "Bulk 1.0")
+queried_records
 #> # A tibble: 2 x 3
 #>   Id                 FirstName LastName        
 #>   <chr>              <chr>     <chr>           
-#> 1 0033s000014Ad7KAAS Test      Contact-Create-1
-#> 2 0033s000014Ad7LAAS Test      Contact-Create-2
+#> 1 0033s000014AgfXAAS Test      Contact-Create-1
+#> 2 0033s000014AgfYAAS Test      Contact-Create-2
 
 # delete these records using the Bulk 2.0 API
-deleted_records <- sf_delete(queried_records$Id, "Contact", api_type = "Bulk 2.0")
-deleted_records
+deleted_records <- sf_delete(queried_records$Id, "Contact", api_type = "Bulk 2.0")
+deleted_records
 #> # A tibble: 2 x 4
 #>   Id                 sf__Id             sf__Created sf__Error
 #>   <chr>              <chr>              <lgl>       <lgl>    
-#> 1 0033s000014Ad7KAAS 0033s000014Ad7KAAS FALSE       NA       
-#> 2 0033s000014Ad7LAAS 0033s000014Ad7LAAS FALSE       NA
                                      
+#> 1 0033s000014AgfXAAS 0033s000014AgfXAAS FALSE       NA       
+#> 2 0033s000014AgfYAAS 0033s000014AgfYAAS FALSE       NA
                                      
 
                                      
 
                                      
 
                                      
 Using the Metadata API
                                      
 
                                      Salesforce is a very flexible platform in that it provides the Metadata API for users to create, read, update and delete their entire Salesforce environment from objects to page layouts and more. This makes it very easy to programmatically setup and teardown the Salesforce environment. One common use case for the Metadata API is retrieving information about an object (fields, permissions, etc.). You can use the sf_read_metadata() function to return a list of objects and their metadata. In the example below we retrieve the metadata for the Account and Contact objects. Note that the metadata_type argument is “CustomObject”. Standard Objects are an implementation of CustomObjects, so they are returned using that metadata type.
                                      
-
                                      read_obj_result <- sf_read_metadata(metadata_type = 'CustomObject',
-                                    object_names = c('Account', 'Contact'))
+
                                      +read_obj_result <- sf_read_metadata(metadata_type = 'CustomObject',
+                                    object_names = c('Account', 'Contact'))
 
-read_obj_result[[1]][c('fullName', 'label', 'sharingModel', 'enableHistory')]
+read_obj_result[[1]][c('fullName', 'label', 'sharingModel', 'enableHistory')]
 #> $fullName
 #> [1] "Account"
 #> 
@@ -363,10 +371,10 @@ 
                                      
 #> $enableHistory
 #> [1] "false"
 
-first_two_fields_idx <- head(which(names(read_obj_result[[1]]) == "fields"), 2)
+first_two_fields_idx <- head(which(names(read_obj_result[[1]]) == "fields"), 2)
 
 # show the first two returned fields of the Account object
-read_obj_result[[1]][first_two_fields_idx]
+read_obj_result[[1]][first_two_fields_idx]
 #> $fields
 #> $fields$fullName
 #> [1] "AccountNumber"
@@ -383,10 +391,11 @@ 
                                      
 #> [1] "false"
 #> 
 #> $fields$type
-#> [1] "Picklist"
                                      
+#> [1] "Picklist"
                                      
 
                                      The data is returned as a list because object definitions are highly nested representations. You may notice that we are missing some really specific details, such as, the picklist values of a field with type “Picklist”. You can get that information using sf_describe_object_fields(). Here is an example using sf_describe_object_fields() where we get a tbl_df with one row for each field on the Account object:
                                      
-
                                      acct_fields <- sf_describe_object_fields('Account')
-acct_fields %>% select(name, label, length, soapType, type)
+
                                      +acct_fields <- sf_describe_object_fields('Account')
+acct_fields %>% select(name, label, length, soapType, type)
 #> # A tibble: 68 x 5
 #>   name           label            length soapType    type     
 #>   <chr>          <chr>            <chr>  <chr>       <chr>    
@@ -398,9 +407,9 @@ 
                                      
 #> # … with 63 more rows
 
 # show the picklist selection options for the Account Type field
-acct_fields %>%
-  filter(label == "Account Type") %>%
-  .$picklistValues
+acct_fields %>% 
+  filter(label == "Account Type") %>% 
+  .$picklistValues
 #> [[1]]
 #> # A tibble: 7 x 4
 #>   active defaultValue label                      value                     
@@ -410,7 +419,7 @@ 
                                      
 #> 3 true   false        Customer - Channel         Customer - Channel        
 #> 4 true   false        Channel Partner / Reseller Channel Partner / Reseller
 #> 5 true   false        Installation Partner       Installation Partner      
-#> # … with 2 more rows
                                      
+#> # … with 2 more rows
                                      
 
                                      
 
                            
 
                            
@@ -481,11 +490,11 @@ 
                            Developers
                            
   
                            
 
                            Dev status
                            
 
                              
-
                            • R Build Status
                              • 
+
                            • R Build Status
                              • 
 
                            • CRAN Status
                              • 
 
                            • Lifecycle: Stable
                              • 
 
                            • Monthly Downloads
                              • 
-
                            • Coverage Status
                              • 
+
                            • Coverage Status
                              • 
 
                            
 
                            
 
                            
@@ -497,7 +506,7 @@ 
                            Dev status
                            
 
                          
 
 
                          
-  
                          Site built with pkgdown 1.5.1.
                          
+  
                          Site built with pkgdown 1.6.1.
                          
 
                          
 
       
diff --git a/docs/news/index.html b/docs/news/index.html
index 01d5303f..f7e40665 100644
--- a/docs/news/index.html
+++ b/docs/news/index.html
@@ -95,7 +95,7 @@
       
       
         salesforcer
-        0.2.2
+        1.0.0
       
     
 
@@ -103,7 +103,7 @@
       
                        
 
                        
 
                        
 Dependencies
                        
 
                          
+
                        • Increase the package’s default Salesforce API version to 52.0 (Summer ’21).
                          • 
+
                        • Remove uses of {RForcecom} after it was removed from CRAN on 6/9/2021 (#101)
                          • 
+
                        • Remove LazyData option in DESCRIPTION since data() is not utilized
                          • 
+
                        • Deprecate argument in sf_write_csv() from path to file as was done in {readr} v1.4.0.
                          • 
+
                        • Deprecate argument bind_using_character_cols because we will always need to bind as character and then parse if guess_types=TRUE. Per comments in tidyverse/readr#588 and tidyverse/readr#98, we must read all of the data as character first and then use type_convert() to ensure that we use all values in the column to guess the type. The default for read_csv() is to only use the first 1,000 rows and its guess_max argument cannot be set to Inf.
                          • 
+
                        • 
+
                          Change lifecycle status from “Maturing” to “Status” per the retirement of “Maturing” in the {lifecycle} package. The documentation notes:
                          
+
                          
+
                          Previously we used as maturing for functions that lay somewhere between experimental and stable. We stopped using this stage because, like questioning, it’s not clear what actionable information this stage delivers.
                          
+
                          
+
                          In addition, the lifecycle guidance states that experimental packages have version numbers less than 1.0.0 and may have major changes in its future. The {salesforcer} package has achieved a stable state with core functionality implemented and a focus on backwards compatibility due to the volume of users.
                          
+
                          • 
+
                        
+
                        
+
                        
+
                        
+Features
                        
+
                          
+
                        • Improve documentation to retrieve the access token or session ID after authentication (#97)
                          • 
+
                        • Improve parsing of Bulk API query recordsets from CSV where all values in the column will be used to guess the type instead of the first 1000.
                          • 
+
                        
+
                        
+
                        
+
                        
+Bug fixes
                        
+
                          
+
                        • Generalize the date and datetime parsing mechanism, such that, reports with date and datetime fields are not returned as NA (#93)
                          • 
+
                        • Fix the format of the OwnerChangeOptions header so it is accepted (#94)
                          • 
+
                        • Fix bug that caused Bulk 2.0 calls to crash when the results had datetime fields in the recordset (#95)
                          • 
+
                        
+
                        
+
                        
+
+    
                        
+
                        
+salesforcer 0.2.2 release
+
                        
+
                        
+
                        
+Dependencies
                        
+
                          
 
                        • This release relaxes the dependency on {dplyr} and brings back use of rbindlist() from {data.table} because of limitations of dplyr::bind_rows(). As noted in (tidyverse/dplyr#5429) {dplyr} will only support binding data.frames or lists of data.frames, not a list of lists which is needed in some applications of the {salesforcer} package.
                          • 
 
                        • Due to other recent changes between {vctrs} and {dplyr}, you may now see the following warning displayed when loading {salesforcer}, which is emitted by the loading of {dplyr}:
                          • 
 
                        
-
                        Warning: replacing previous import 'vctrs::data_frame' by 'tibble::data_frame' when loading 'dplyr'
                        
+
                        Warning: replacing previous import 'vctrs::data_frame' by 'tibble::data_frame' when loading 'dplyr'
                        
+
                        
+
                        
+
                        
+Features
                        
+
                          
+
                        • None
                          • 
+
                        
+
                        
+
                        
+
                        
+Bug fixes
                        
+
                          
+
                        • None
                          • 
+
                        
 
                        
 
                        
     
                        
 
                        
 salesforcer 0.2.1 release
 
                        
-
                        
+
                        
 
                        
-Dependencies
                        
+Dependencies

    • -CAUTION: This release requires {dplyr 1.0.0} because {dplyr 1.0.1} introduced a bug in bind_rows() with how it binds lists where the list elements have differing lengths. This is documented in tidyverse/dplyr#5417 and r-lib/vctrs#1073. The timeline for a fix is unknown as of Aug 16, 2020. You can install the older version of {dplyr} using the following command:
      • +CAUTION: This release requires {dplyr 1.0.0} because {dplyr 1.0.1} introduced a bug in bind_rows() with how it binds lists where the list elements have differing lengths. This is documented in tidyverse/dplyr#5417 and r-lib/vctrs#1073. The timeline for a fix is unknown as of Aug 16, 2020. You can install the older version of {dplyr} using the following command:
    -
    remotes::install_version("dplyr", "1.0.0")
    +
    +
+remotes::install_version("dplyr", "1.0.0")
    -
    +

    -Features

    +Features
    • Add support for the defaultLimit argument in sf_search() to be able to restrict the number of records from each individual object when searching across one or more objects.
    • Add support for updating attachments with the sf_update_attachments() function (#79).
    • Add support for downloading attachments just by its Id. In addition, the sf_download_attachment() function returns the file path of the downloaded content instead of a logical indicating success.
    -
    +

    -Bug fixes

    +Bug fixes
    • Fix bug introduced in {salesforcer 0.2.0} which could not stack records with errors longer than length 1. The new solution is to always return the errors column as a list, which is coerced to length 1 for the record (#66).
    • Fix bug in sf_search() that was passing "true"/"false" instead of actual boolean value for the spellCorrection parameter in the POST body.
      • @@ -231,16 +288,16 @@

      salesforcer 0.2.0 release

      -
      +

      -Dependencies

      +Dependencies
      • CAUTION: This release only has automated test coverage on R 4.0.0 or greater. Users should still be able to install and run using R (>= 3.6.0). However, it is recommended to upgrade to R 4.0.0 or greater.
      -
      +

      -Features

      +Features

      • Add experimental support for the Reports and Dashboards REST API.

      • Add support for Bulk 2.0 queries that was added in Salesforce version 47.0 (Winter ’20). CAUTION: The Bulk 2.0 API is now the default API when using sf_query_bulk() or sf_run_bulk_query(). Please test prior to upgrading in a production environment where you are running bulk queries.

        • @@ -281,9 +338,9 @@

      • Remove dependency on {data.table} which does not have a build for R-devel. This should only affect sf_read_metadata().

      -
      +

      -Bug Fixes

      +Bug Fixes

      • Fix bug that prevented enabling PKChunking in Bulk 1.0 queries. Users can now specify using TRUE/FALSE or details like chunkSize that imply TRUE. The results are then parsed appropriately by waiting for all individual batches to finish. (#46)

      • Fix bugs in REST and SOAP API queries to prevent infinite looping and mangling results of relationship queries, specifically parent-to-child nested queries. (#19, #35, #38, #54)

        • @@ -296,9 +353,9 @@

        salesforcer 0.1.4 release

        -
        +

        -Features

        +Features

        • Rebuilt package against R 4.0 (no issues observed with 3.6.3, 4.0.0, 4.0.1) (#53)

        • Upgrade to Salesforce version 48.0 (Spring ’20) from version 46.0 (Summer ’19)

          • @@ -310,9 +367,9 @@

        • Add Attachment and Metadata vignettes along with updated Bulk vignette.

        -
        +

        -Bug Fixes

        +Bug Fixes

        • Fix issue where REST query was not correctly passing and honoring the batch size control argument to paginate results

        • Fix issue in results of REST query pagination where the function was looping infinitely because of a bug in the implementation that would continue using the same next_records_url that was previously passed into the function (#54)

          • @@ -328,9 +385,9 @@

          salesforcer 0.1.3 release

          -
          +

          -Features

          +Features

          • Upgrade to version 46.0 (Summer ’19) from version 45.0 (Spring ’19)

          • Add RForcecom backward compatible version of rforcecom.getObjectDescription()

            • @@ -347,9 +404,9 @@

          • Add new function sf_merge() which combines up to 3 records of the same type into 1 record (#22)

          -
          +

          -Bug Fixes

          +Bug Fixes
          @@ -108,7 +108,7 @@

          Arguments

          @@ -232,7 +232,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/make_analytics_folder_child_operations_url.html b/docs/reference/make_analytics_folder_child_operations_url.html index 0866506f..56bc2ad6 100644 --- a/docs/reference/make_analytics_folder_child_operations_url.html +++ b/docs/reference/make_analytics_folder_child_operations_url.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -219,7 +219,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/make_rest_objects_url.html b/docs/reference/make_rest_objects_url.html index 2497d099..68cc845e 100644 --- a/docs/reference/make_rest_objects_url.html +++ b/docs/reference/make_rest_objects_url.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -241,7 +241,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/make_verbose_httr_message.html b/docs/reference/make_verbose_httr_message.html index 322c51f7..4effb402 100644 --- a/docs/reference/make_verbose_httr_message.html +++ b/docs/reference/make_verbose_httr_message.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -232,7 +232,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/merge_null_to_na.html b/docs/reference/merge_null_to_na.html index 5d92cfd5..916ea86f 100644 --- a/docs/reference/merge_null_to_na.html +++ b/docs/reference/merge_null_to_na.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -228,7 +228,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/metadata_type_validator.html b/docs/reference/metadata_type_validator.html index bd32365d..28d5c40d 100644 --- a/docs/reference/metadata_type_validator.html +++ b/docs/reference/metadata_type_validator.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
          @@ -213,7 +213,7 @@

          Value

          Details

          AccessMapping

          -

          Salesforce Documentation for AccessMapping

          +
          accessLevel

          a character

          object

          a character

          objectField

          a character

          @@ -222,7 +222,7 @@

          Details

          AccountSettings

          -

          Salesforce Documentation for AccountSettings

          +
          fullName

          a character (inherited from Metadata)

          enableAccountOwnerReport

          a character either 'true' or 'false'

          enableAccountTeams

          a character either 'true' or 'false'

          @@ -231,7 +231,7 @@

          Details

          AccountSharingRuleSettings

          -

          Salesforce Documentation for AccountSharingRuleSettings

          +
          caseAccessLevel

          a character

          contactAccessLevel

          a character

          opportunityAccessLevel

          a character

          @@ -239,7 +239,7 @@

          Details

          ActionLinkGroupTemplate

          -

          Salesforce Documentation for ActionLinkGroupTemplate

          +
          fullName

          a character (inherited from Metadata)

          actionLinkTemplates

          a ActionLinkTemplate

          category

          a PlatformActionGroupCategory - which is a character taking one of the following values: @@ -253,14 +253,14 @@

          Details

        • OncePerUser

        • Unlimited

          • -
          hoursUntilExpiration

          a integer

          +
          hoursUntilExpiration

          an integer

          isPublished

          a character either 'true' or 'false'

          name

          a character

          ActionLinkTemplate

          -

          Salesforce Documentation for ActionLinkTemplate

          +
          actionUrl

          a character

          headers

          a character

          isConfirmationRequired

          a character either 'true' or 'false'

          @@ -283,7 +283,7 @@

          Details

        • HttpPost

        • HttpPut

          • -
          position

          a integer

          +
          position

          an integer

          requestBody

          a character

          userAlias

          a character

          userVisibility

          a ActionLinkUserVisibility - which is a character taking one of the following values: @@ -299,7 +299,7 @@

          Details

          ActionOverride

          -

          Salesforce Documentation for ActionOverride

          +
          actionName

          a character

          comment

          a character

          content

          a character

          @@ -323,7 +323,7 @@

          Details

          ActivitiesSettings

          -

          Salesforce Documentation for ActivitiesSettings

          +
          fullName

          a character (inherited from Metadata)

          allowUsersToRelateMultipleContactsToTasksAndEvents

          a character either 'true' or 'false'

          autoRelateEventAttendees

          a character either 'true' or 'false'

          @@ -349,57 +349,57 @@

          Details

          AddressSettings

          -

          Salesforce Documentation for AddressSettings

          +
          fullName

          a character (inherited from Metadata)

          countriesAndStates

          a CountriesAndStates

          AdjustmentsSettings

          -

          Salesforce Documentation for AdjustmentsSettings

          +
          enableAdjustments

          a character either 'true' or 'false'

          enableOwnerAdjustments

          a character either 'true' or 'false'

          AgentConfigAssignments

          -

          Salesforce Documentation for AgentConfigAssignments

          +
          profiles

          a AgentConfigProfileAssignments

          users

          a AgentConfigUserAssignments

          AgentConfigButtons

          -

          Salesforce Documentation for AgentConfigButtons

          +
          button

          a character

          AgentConfigProfileAssignments

          -

          Salesforce Documentation for AgentConfigProfileAssignments

          +
          profile

          a character

          AgentConfigSkills

          -

          Salesforce Documentation for AgentConfigSkills

          +
          skill

          a character

          AgentConfigUserAssignments

          -

          Salesforce Documentation for AgentConfigUserAssignments

          +
          user

          a character

          AnalyticsCloudComponentLayoutItem

          -

          Salesforce Documentation for AnalyticsCloudComponentLayoutItem

          +
          assetType

          a character

          devName

          a character

          error

          a character

          filter

          a character

          -
          height

          a integer

          +
          height

          an integer

          hideOnError

          a character either 'true' or 'false'

          showHeader

          a character either 'true' or 'false'

          showSharing

          a character either 'true' or 'false'

          @@ -409,7 +409,7 @@

          Details

          AnalyticSnapshot

          -

          Salesforce Documentation for AnalyticSnapshot

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          groupColumn

          a character

          @@ -422,7 +422,7 @@

          Details

          AnalyticSnapshotMapping

          -

          Salesforce Documentation for AnalyticSnapshotMapping

          +
          aggregateType

          a ReportSummaryType - which is a character taking one of the following values:

          • Sum

            • @@ -443,8 +443,8 @@

            Details

          ApexClass

          -

          Salesforce Documentation for ApexClass

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          packageVersions

          a PackageVersion

          status

          a ApexCodeUnitStatus - which is a character taking one of the following values: @@ -457,8 +457,8 @@

          Details

          ApexComponent

          -

          Salesforce Documentation for ApexComponent

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          description

          a character

          label

          a character

          @@ -467,8 +467,8 @@

          Details

          ApexPage

          -

          Salesforce Documentation for ApexPage

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          availableInTouch

          a character either 'true' or 'false'

          confirmationTokenRequired

          a character either 'true' or 'false'

          @@ -479,15 +479,15 @@

          Details

          ApexTestSuite

          -

          Salesforce Documentation for ApexTestSuite

          +
          fullName

          a character (inherited from Metadata)

          testClassName

          a character

          ApexTrigger

          -

          Salesforce Documentation for ApexTrigger

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          packageVersions

          a PackageVersion

          status

          a ApexCodeUnitStatus - which is a character taking one of the following values: @@ -500,7 +500,7 @@

          Details

          AppActionOverride

          -

          Salesforce Documentation for AppActionOverride

          +
          actionName

          a character (inherited from ActionOverride)

          comment

          a character (inherited from ActionOverride)

          content

          a character (inherited from ActionOverride)

          @@ -512,38 +512,38 @@

          Details

          AppBrand

          -

          Salesforce Documentation for AppBrand

          +
          footerColor

          a character

          headerColor

          a character

          logo

          a character

          -
          logoVersion

          a integer

          +
          logoVersion

          an integer

          shouldOverrideOrgTheme

          a character either 'true' or 'false'

          AppComponentList

          -

          Salesforce Documentation for AppComponentList

          +
          alignment

          a character

          components

          a character

          AppMenu

          -

          Salesforce Documentation for AppMenu

          +
          fullName

          a character (inherited from Metadata)

          appMenuItems

          a AppMenuItem

          AppMenuItem

          -

          Salesforce Documentation for AppMenuItem

          +
          name

          a character

          type

          a character

          AppPreferences

          -

          Salesforce Documentation for AppPreferences

          +
          enableCustomizeMyTabs

          a character either 'true' or 'false'

          enableKeyboardShortcuts

          a character either 'true' or 'false'

          enableListViewHover

          a character either 'true' or 'false'

          @@ -557,7 +557,7 @@

          Details

          AppProfileActionOverride

          -

          Salesforce Documentation for AppProfileActionOverride

          +
          actionName

          a character (inherited from ProfileActionOverride)

          content

          a character (inherited from ProfileActionOverride)

          formFactor

          a FormFactor (inherited from ProfileActionOverride)

          @@ -569,13 +569,13 @@

          Details

          ApprovalAction

          -

          Salesforce Documentation for ApprovalAction

          +
          action

          a WorkflowActionReference

          ApprovalEntryCriteria

          -

          Salesforce Documentation for ApprovalEntryCriteria

          +
          booleanFilter

          a character

          criteriaItems

          a FilterItem

          formula

          a character

          @@ -583,13 +583,13 @@

          Details

          ApprovalPageField

          -

          Salesforce Documentation for ApprovalPageField

          +
          field

          a character

          ApprovalProcess

          -

          Salesforce Documentation for ApprovalProcess

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          allowRecall

          a character either 'true' or 'false'

          @@ -619,7 +619,7 @@

          Details

          ApprovalStep

          -

          Salesforce Documentation for ApprovalStep

          +
          allowDelegate

          a character either 'true' or 'false'

          approvalActions

          a ApprovalAction

          assignedApprover

          a ApprovalStepApprover

          @@ -639,7 +639,7 @@

          Details

          ApprovalStepApprover

          -

          Salesforce Documentation for ApprovalStepApprover

          +
          approver

          a Approver

          whenMultipleApprovers

          a RoutingType - which is a character taking one of the following values:

            @@ -650,7 +650,7 @@

            Details

          ApprovalStepRejectBehavior

          -

          Salesforce Documentation for ApprovalStepRejectBehavior

          +
          type

          a StepRejectBehaviorType - which is a character taking one of the following values:

          • RejectRequest

            • @@ -660,7 +660,7 @@

            Details

          ApprovalSubmitter

          -

          Salesforce Documentation for ApprovalSubmitter

          +
          submitter

          a character

          type

          a ProcessSubmitterType - which is a character taking one of the following values:

            @@ -681,7 +681,7 @@

            Details

          Approver

          -

          Salesforce Documentation for Approver

          +
          name

          a character

          type

          a NextOwnerType - which is a character taking one of the following values:

            @@ -695,19 +695,19 @@

            Details

          AppWorkspaceConfig

          -

          Salesforce Documentation for AppWorkspaceConfig

          +
          mappings

          a WorkspaceMapping

          ArticleTypeChannelDisplay

          -

          Salesforce Documentation for ArticleTypeChannelDisplay

          +
          articleTypeTemplates

          a ArticleTypeTemplate

          ArticleTypeTemplate

          -

          Salesforce Documentation for ArticleTypeTemplate

          +
          channel

          a Channel - which is a character taking one of the following values:

          • AllChannels

            • @@ -727,7 +727,7 @@

            Details

          AssignmentRule

          -

          Salesforce Documentation for AssignmentRule

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          ruleEntry

          a RuleEntry

          @@ -735,14 +735,14 @@

          Details

          AssignmentRules

          -

          Salesforce Documentation for AssignmentRules

          +
          fullName

          a character (inherited from Metadata)

          assignmentRule

          a AssignmentRule

          AssistantRecommendationType

          -

          Salesforce Documentation for AssistantRecommendationType

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          masterLabel

          a character

          @@ -753,28 +753,28 @@

          Details

          Attachment

          -

          Salesforce Documentation for Attachment

          -
          content

          a character formed using RCurl::base64Encode

          +
          +
          content

          a character formed using base64encode

          name

          a character

          AuraDefinitionBundle

          -

          Salesforce Documentation for AuraDefinitionBundle

          +
          fullName

          a character (inherited from Metadata)

          -
          SVGContent

          a character formed using RCurl::base64Encode

          +
          SVGContent

          a character formed using base64encode

          apiVersion

          a numeric

          -
          controllerContent

          a character formed using RCurl::base64Encode

          +
          controllerContent

          a character formed using base64encode

          description

          a character

          -
          designContent

          a character formed using RCurl::base64Encode

          -
          documentationContent

          a character formed using RCurl::base64Encode

          -
          helperContent

          a character formed using RCurl::base64Encode

          -
          markup

          a character formed using RCurl::base64Encode

          -
          modelContent

          a character formed using RCurl::base64Encode

          +
          designContent

          a character formed using base64encode

          +
          documentationContent

          a character formed using base64encode

          +
          helperContent

          a character formed using base64encode

          +
          markup

          a character formed using base64encode

          +
          modelContent

          a character formed using base64encode

          packageVersions

          a PackageVersion

          -
          rendererContent

          a character formed using RCurl::base64Encode

          -
          styleContent

          a character formed using RCurl::base64Encode

          -
          testsuiteContent

          a character formed using RCurl::base64Encode

          +
          rendererContent

          a character formed using base64encode

          +
          styleContent

          a character formed using base64encode

          +
          testsuiteContent

          a character formed using base64encode

          type

          a AuraBundleType - which is a character taking one of the following values:

          • Application

            • @@ -787,7 +787,7 @@

            Details

          AuthProvider

          -

          Salesforce Documentation for AuthProvider

          +
          fullName

          a character (inherited from Metadata)

          authorizeUrl

          a character

          consumerKey

          a character

          @@ -825,7 +825,7 @@

          Details

          AutoResponseRule

          -

          Salesforce Documentation for AutoResponseRule

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          ruleEntry

          a RuleEntry

          @@ -833,14 +833,14 @@

          Details

          AutoResponseRules

          -

          Salesforce Documentation for AutoResponseRules

          +
          fullName

          a character (inherited from Metadata)

          autoResponseRule

          a AutoResponseRule

          BrandingSet

          -

          Salesforce Documentation for BrandingSet

          +
          fullName

          a character (inherited from Metadata)

          brandingSetProperty

          a BrandingSetProperty

          description

          a character

          @@ -850,14 +850,14 @@

          Details

          BrandingSetProperty

          -

          Salesforce Documentation for BrandingSetProperty

          +
          propertyName

          a character

          propertyValue

          a character

          BusinessHoursEntry

          -

          Salesforce Documentation for BusinessHoursEntry

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          default

          a character either 'true' or 'false'

          @@ -881,7 +881,7 @@

          Details

          BusinessHoursSettings

          -

          Salesforce Documentation for BusinessHoursSettings

          +
          fullName

          a character (inherited from Metadata)

          businessHours

          a BusinessHoursEntry

          holidays

          a Holiday

          @@ -889,7 +889,7 @@

          Details

          BusinessProcess

          -

          Salesforce Documentation for BusinessProcess

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          isActive

          a character either 'true' or 'false'

          @@ -898,7 +898,7 @@

          Details

          CallCenter

          -

          Salesforce Documentation for CallCenter

          +
          fullName

          a character (inherited from Metadata)

          adapterUrl

          a character

          customSettings

          a character

          @@ -911,7 +911,7 @@

          Details

          CallCenterItem

          -

          Salesforce Documentation for CallCenterItem

          +
          label

          a character

          name

          a character

          value

          a character

          @@ -919,7 +919,7 @@

          Details

          CallCenterSection

          -

          Salesforce Documentation for CallCenterSection

          +
          items

          a CallCenterItem

          label

          a character

          name

          a character

          @@ -927,7 +927,7 @@

          Details

          CampaignInfluenceModel

          -

          Salesforce Documentation for CampaignInfluenceModel

          +
          fullName

          a character (inherited from Metadata)

          isActive

          a character either 'true' or 'false'

          isDefaultModel

          a character either 'true' or 'false'

          @@ -939,7 +939,7 @@

          Details

          CaseSettings

          -

          Salesforce Documentation for CaseSettings

          +
          fullName

          a character (inherited from Metadata)

          caseAssignNotificationTemplate

          a character

          caseCloseNotificationTemplate

          a character

          @@ -975,9 +975,9 @@

          Details

          CaseSubjectParticle

          -

          Salesforce Documentation for CaseSubjectParticle

          +
          fullName

          a character (inherited from Metadata)

          -
          index

          a integer

          +
          index

          an integer

          textField

          a character

          type

          a CaseSubjectParticleType - which is a character taking one of the following values:

            @@ -997,19 +997,19 @@

            Details

          Certificate

          -

          Salesforce Documentation for Certificate

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          caSigned

          a character either 'true' or 'false'

          encryptedWithPlatformEncryption

          a character either 'true' or 'false'

          expirationDate

          a character formatted as 'yyyy-mm-ddThh:mm:ssZ'

          -
          keySize

          a integer

          +
          keySize

          an integer

          masterLabel

          a character

          privateKeyExportable

          a character either 'true' or 'false'

          ChannelLayout

          -

          Salesforce Documentation for ChannelLayout

          +
          fullName

          a character (inherited from Metadata)

          enabledChannels

          a character

          label

          a character

          @@ -1019,13 +1019,13 @@

          Details

          ChannelLayoutItem

          -

          Salesforce Documentation for ChannelLayoutItem

          +
          field

          a character

          ChartSummary

          -

          Salesforce Documentation for ChartSummary

          +
          aggregate

          a ReportSummaryType - which is a character taking one of the following values:

          • Sum

            • @@ -1046,14 +1046,14 @@

            Details

          ChatterAnswersReputationLevel

          -

          Salesforce Documentation for ChatterAnswersReputationLevel

          +
          name

          a character

          -
          value

          a integer

          +
          value

          an integer

          ChatterAnswersSettings

          -

          Salesforce Documentation for ChatterAnswersSettings

          +
          fullName

          a character (inherited from Metadata)

          emailFollowersOnBestAnswer

          a character either 'true' or 'false'

          emailFollowersOnReply

          a character either 'true' or 'false'

          @@ -1071,7 +1071,7 @@

          Details

          ChatterExtension

          -

          Salesforce Documentation for ChatterExtension

          +
          fullName

          a character (inherited from Metadata)

          compositionComponent

          a character

          description

          a character

          @@ -1090,13 +1090,13 @@

          Details

          ChatterMobileSettings

          -

          Salesforce Documentation for ChatterMobileSettings

          +
          enablePushNotifications

          a character either 'true' or 'false'

          CleanDataService

          -

          Salesforce Documentation for CleanDataService

          +
          fullName

          a character (inherited from Metadata)

          cleanRules

          a CleanRule

          description

          a character

          @@ -1106,7 +1106,7 @@

          Details

          CleanRule

          -

          Salesforce Documentation for CleanRule

          +
          bulkEnabled

          a character either 'true' or 'false'

          bypassTriggers

          a character either 'true' or 'false'

          bypassWorkflow

          a character either 'true' or 'false'

          @@ -1126,16 +1126,16 @@

          Details

          CodeLocation

          -

          Salesforce Documentation for CodeLocation

          -
          column

          a integer

          -
          line

          a integer

          -
          numExecutions

          a integer

          +
          +
          column

          an integer

          +
          line

          an integer

          +
          numExecutions

          an integer

          time

          a numeric

          Community

          -

          Salesforce Documentation for Community

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          chatterAnswersFacebookSsoUrl

          a character

          @@ -1156,14 +1156,14 @@

          Details

          CommunityCustomThemeLayoutType

          -

          Salesforce Documentation for CommunityCustomThemeLayoutType

          +
          description

          a character

          label

          a character

          CommunityRoles

          -

          Salesforce Documentation for CommunityRoles

          +
          customerUserRole

          a character

          employeeUserRole

          a character

          partnerUserRole

          a character

          @@ -1171,10 +1171,10 @@

          Details

          CommunityTemplateBundleInfo

          -

          Salesforce Documentation for CommunityTemplateBundleInfo

          +
          description

          a character

          image

          a character

          -
          order

          a integer

          +
          order

          an integer

          title

          a character

          type

          a CommunityTemplateBundleInfoType - which is a character taking one of the following values:

            @@ -1185,7 +1185,7 @@

            Details

          CommunityTemplateDefinition

          -

          Salesforce Documentation for CommunityTemplateDefinition

          +
          fullName

          a character (inherited from Metadata)

          baseTemplate

          a CommunityBaseTemplate - which is a character taking one of the following values:

            @@ -1210,14 +1210,14 @@

            Details

          CommunityTemplatePageSetting

          -

          Salesforce Documentation for CommunityTemplatePageSetting

          +
          page

          a character

          themeLayout

          a character

          CommunityThemeDefinition

          -

          Salesforce Documentation for CommunityThemeDefinition

          +
          fullName

          a character (inherited from Metadata)

          customThemeLayoutType

          a CommunityCustomThemeLayoutType

          description

          a character

          @@ -1228,7 +1228,7 @@

          Details

          CommunityThemeSetting

          -

          Salesforce Documentation for CommunityThemeSetting

          +
          customThemeLayoutType

          a character

          themeLayout

          a character

          themeLayoutType

          a CommunityThemeLayoutType - which is a character taking one of the following values: @@ -1241,7 +1241,7 @@

          Details

          CompactLayout

          -

          Salesforce Documentation for CompactLayout

          +
          fullName

          a character (inherited from Metadata)

          fields

          a character

          label

          a character

          @@ -1249,14 +1249,14 @@

          Details

          CompanySettings

          -

          Salesforce Documentation for CompanySettings

          +
          fullName

          a character (inherited from Metadata)

          fiscalYear

          a FiscalYearSettings

          ComponentInstance

          -

          Salesforce Documentation for ComponentInstance

          +
          componentInstanceProperties

          a ComponentInstanceProperty

          componentName

          a character

          visibilityRule

          a UiFormulaRule

          @@ -1264,7 +1264,7 @@

          Details

          ComponentInstanceProperty

          -

          Salesforce Documentation for ComponentInstanceProperty

          +
          name

          a character

          type

          a ComponentInstancePropertyTypeEnum - which is a character taking one of the following values:

            @@ -1275,7 +1275,7 @@

            Details

          ConnectedApp

          -

          Salesforce Documentation for ConnectedApp

          +
          fullName

          a character (inherited from Metadata)

          attributes

          a ConnectedAppAttribute

          canvasConfig

          a ConnectedAppCanvasConfig

          @@ -1297,14 +1297,14 @@

          Details

          ConnectedAppAttribute

          -

          Salesforce Documentation for ConnectedAppAttribute

          +
          formula

          a character

          key

          a character

          ConnectedAppCanvasConfig

          -

          Salesforce Documentation for ConnectedAppCanvasConfig

          +
          accessMethod

          a AccessMethod - which is a character taking one of the following values:

          • Get

            • @@ -1343,7 +1343,7 @@

            Details

          ConnectedAppIpRange

          -

          Salesforce Documentation for ConnectedAppIpRange

          +
          description

          a character

          end

          a character

          start

          a character

          @@ -1351,11 +1351,11 @@

          Details

          ConnectedAppMobileDetailConfig

          -

          Salesforce Documentation for ConnectedAppMobileDetailConfig

          -
          applicationBinaryFile

          a character formed using RCurl::base64Encode

          +
          +
          applicationBinaryFile

          a character formed using base64encode

          applicationBinaryFileName

          a character

          applicationBundleIdentifier

          a character

          -
          applicationFileLength

          a integer

          +
          applicationFileLength

          an integer

          applicationIconFile

          a character

          applicationIconFileName

          a character

          applicationInstallUrl

          a character

          @@ -1377,7 +1377,7 @@

          Details

          ConnectedAppOauthConfig

          -

          Salesforce Documentation for ConnectedAppOauthConfig

          +
          callbackUrl

          a character

          certificate

          a character

          consumerKey

          a character

          @@ -1406,7 +1406,7 @@

          Details

          ConnectedAppSamlConfig

          -

          Salesforce Documentation for ConnectedAppSamlConfig

          +
          acsUrl

          a character

          certificate

          a character

          encryptionCertificate

          a character

          @@ -1445,20 +1445,20 @@

          Details

          Container

          -

          Salesforce Documentation for Container

          -
          height

          a integer

          +
          +
          height

          an integer

          isContainerAutoSizeEnabled

          a character either 'true' or 'false'

          region

          a character

          sidebarComponents

          a SidebarComponent

          style

          a character

          unit

          a character

          -
          width

          a integer

          +
          width

          an integer

          ContentAsset

          -

          Salesforce Documentation for ContentAsset

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          format

          a ContentAssetFormat - which is a character taking one of the following values:

          • Original

            • @@ -1473,7 +1473,7 @@

            Details

          ContentAssetLink

          -

          Salesforce Documentation for ContentAssetLink

          +
          access

          a ContentAssetAccess - which is a character taking one of the following values:

          • VIEWER

            • @@ -1486,7 +1486,7 @@

            Details

          ContentAssetRelationships

          -

          Salesforce Documentation for ContentAssetRelationships

          +
          insightsApplication

          a ContentAssetLink

          network

          a ContentAssetLink

          organization

          a ContentAssetLink

          @@ -1495,7 +1495,7 @@

          Details

          ContentAssetVersion

          -

          Salesforce Documentation for ContentAssetVersion

          +
          number

          a character

          pathOnClient

          a character

          zipEntry

          a character

          @@ -1503,13 +1503,13 @@

          Details

          ContentAssetVersions

          -

          Salesforce Documentation for ContentAssetVersions

          +
          version

          a ContentAssetVersion

          ContractSettings

          -

          Salesforce Documentation for ContractSettings

          +
          fullName

          a character (inherited from Metadata)

          autoCalculateEndDate

          a character either 'true' or 'false'

          autoExpirationDelay

          a character

          @@ -1521,20 +1521,20 @@

          Details

          CorsWhitelistOrigin

          -

          Salesforce Documentation for CorsWhitelistOrigin

          +
          fullName

          a character (inherited from Metadata)

          urlPattern

          a character

          CountriesAndStates

          -

          Salesforce Documentation for CountriesAndStates

          +
          countries

          a Country

          Country

          -

          Salesforce Documentation for Country

          +
          active

          a character either 'true' or 'false'

          integrationValue

          a character

          isoCode

          a character

          @@ -1547,7 +1547,7 @@

          Details

          CspTrustedSite

          -

          Salesforce Documentation for CspTrustedSite

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          endpointUrl

          a character

          @@ -1556,7 +1556,7 @@

          Details

          CustomApplication

          -

          Salesforce Documentation for CustomApplication

          +
          fullName

          a character (inherited from Metadata)

          actionOverrides

          a AppActionOverride

          brand

          a AppBrand

          @@ -1593,37 +1593,37 @@

          Details

          CustomApplicationComponent

          -

          Salesforce Documentation for CustomApplicationComponent

          +
          fullName

          a character (inherited from Metadata)

          buttonIconUrl

          a character

          buttonStyle

          a character

          buttonText

          a character

          -
          buttonWidth

          a integer

          -
          height

          a integer

          +
          buttonWidth

          an integer

          +
          height

          an integer

          isHeightFixed

          a character either 'true' or 'false'

          isHidden

          a character either 'true' or 'false'

          isWidthFixed

          a character either 'true' or 'false'

          visualforcePage

          a character

          -
          width

          a integer

          +
          width

          an integer

          CustomApplicationTranslation

          -

          Salesforce Documentation for CustomApplicationTranslation

          +
          label

          a character

          name

          a character

          CustomConsoleComponents

          -

          Salesforce Documentation for CustomConsoleComponents

          +
          primaryTabComponents

          a PrimaryTabComponents

          subtabComponents

          a SubtabComponents

          CustomDataType

          -

          Salesforce Documentation for CustomDataType

          +
          fullName

          a character (inherited from Metadata)

          customDataTypeComponents

          a CustomDataTypeComponent

          description

          a character

          @@ -1636,19 +1636,19 @@

          Details

          CustomDataTypeComponent

          -

          Salesforce Documentation for CustomDataTypeComponent

          +
          developerSuffix

          a character

          enforceFieldRequiredness

          a character either 'true' or 'false'

          label

          a character

          -
          length

          a integer

          -
          precision

          a integer

          -
          scale

          a integer

          +
          length

          an integer

          +
          precision

          an integer

          +
          scale

          an integer

          sortOrder

          a SortOrder - which is a character taking one of the following values:

          • Asc

          • Desc

          -
          sortPriority

          a integer

          +
          sortPriority

          an integer

          type

          a FieldType - which is a character taking one of the following values:

          • AutoNumber

            • @@ -1684,14 +1684,14 @@

            Details

          CustomDataTypeComponentTranslation

          -

          Salesforce Documentation for CustomDataTypeComponentTranslation

          +
          developerSuffix

          a character

          label

          a character

          CustomDataTypeTranslation

          -

          Salesforce Documentation for CustomDataTypeTranslation

          +
          components

          a CustomDataTypeComponentTranslation

          customDataTypeName

          a character

          description

          a character

          @@ -1700,7 +1700,7 @@

          Details

          CustomExperience

          -

          Salesforce Documentation for CustomExperience

          +
          fullName

          a character (inherited from Metadata)

          allowInternalUserLogin

          a character either 'true' or 'false'

          branding

          a CustomExperienceBranding

          @@ -1723,7 +1723,7 @@

          Details

          CustomExperienceBranding

          -

          Salesforce Documentation for CustomExperienceBranding

          +
          loginFooterText

          a character

          loginLogo

          a character

          pageFooter

          a character

          @@ -1741,7 +1741,7 @@

          Details

          CustomExperienceTabSet

          -

          Salesforce Documentation for CustomExperienceTabSet

          +
          customTab

          a character

          defaultTab

          a character

          standardTab

          a character

          @@ -1749,7 +1749,7 @@

          Details

          CustomFeedFilter

          -

          Salesforce Documentation for CustomFeedFilter

          +
          fullName

          a character (inherited from Metadata)

          criteria

          a FeedFilterCriterion

          description

          a character

          @@ -1759,7 +1759,7 @@

          Details

          CustomField

          -

          Salesforce Documentation for CustomField

          +
          fullName

          a character (inherited from Metadata)

          businessOwnerGroup

          a character

          businessOwnerUser

          a character

          @@ -1798,7 +1798,7 @@

          Details
          isNameField

          a character either 'true' or 'false'

          isSortingDisabled

          a character either 'true' or 'false'

          label

          a character

          -
          length

          a integer

          +
          length

          an integer

          lookupFilter

          a LookupFilter

          maskChar

          a EncryptedFieldMaskChar - which is a character taking one of the following values:

            @@ -1816,16 +1816,16 @@

            Details

          metadataRelationshipControllingField

          a character

          populateExistingRows

          a character either 'true' or 'false'

          -
          precision

          a integer

          +
          precision

          an integer

          referenceTargetField

          a character

          referenceTo

          a character

          relationshipLabel

          a character

          relationshipName

          a character

          -
          relationshipOrder

          a integer

          +
          relationshipOrder

          an integer

          reparentableMasterDetail

          a character either 'true' or 'false'

          required

          a character either 'true' or 'false'

          restrictedAdminField

          a character either 'true' or 'false'

          -
          scale

          a integer

          +
          scale

          an integer

          securityClassification

          a SecurityClassification - which is a character taking one of the following values:

          • AccountInformation

            • @@ -1835,7 +1835,7 @@

            Details

          • AssociativeBusinessOrPersonalData

          • AuthenticationData

          -
          startingNumber

          a integer

          +
          startingNumber

          an integer

          stripMarkup

          a character either 'true' or 'false'

          summarizedField

          a character

          summaryFilterItems

          a FilterItem

          @@ -1883,13 +1883,13 @@

          Details

          unique

          a character either 'true' or 'false'

          valueSet

          a ValueSet

          -
          visibleLines

          a integer

          +
          visibleLines

          an integer

          writeRequiresMasterRead

          a character either 'true' or 'false'

          CustomFieldTranslation

          -

          Salesforce Documentation for CustomFieldTranslation

          +
          caseValues

          a ObjectNameCaseValue

          gender

          a Gender - which is a character taking one of the following values:

            @@ -1914,7 +1914,7 @@

            Details

          CustomLabel

          -

          Salesforce Documentation for CustomLabel

          +
          fullName

          a character (inherited from Metadata)

          categories

          a character

          language

          a character

          @@ -1925,21 +1925,21 @@

          Details

          CustomLabels

          -

          Salesforce Documentation for CustomLabels

          +
          fullName

          a character (inherited from Metadata)

          labels

          a CustomLabel

          CustomLabelTranslation

          -

          Salesforce Documentation for CustomLabelTranslation

          +
          label

          a character

          name

          a character

          CustomMetadata

          -

          Salesforce Documentation for CustomMetadata

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          label

          a character

          @@ -1949,14 +1949,14 @@

          Details

          CustomMetadataValue

          -

          Salesforce Documentation for CustomMetadataValue

          +
          field

          a character

          value

          a character that appears similar to any of the other accepted types (integer, numeric, date, datetime, boolean)

          CustomNotificationType

          -

          Salesforce Documentation for CustomNotificationType

          +
          fullName

          a character (inherited from Metadata)

          customNotifTypeName

          a character

          description

          a character

          @@ -1968,7 +1968,7 @@

          Details

          CustomObject

          -

          Salesforce Documentation for CustomObject

          +
          fullName

          a character (inherited from Metadata)

          actionOverrides

          a ActionOverride

          allowInChatterGroups

          a character either 'true' or 'false'

          @@ -2070,7 +2070,7 @@

          Details

          CustomObjectTranslation

          -

          Salesforce Documentation for CustomObjectTranslation

          +
          fullName

          a character (inherited from Metadata)

          caseValues

          a ObjectNameCaseValue

          fieldSets

          a FieldSetTranslation

          @@ -2101,7 +2101,7 @@

          Details

          CustomPageWebLink

          -

          Salesforce Documentation for CustomPageWebLink

          +
          fullName

          a character (inherited from Metadata)

          availability

          a WebLinkAvailability - which is a character taking one of the following values:

            @@ -2131,7 +2131,7 @@

            Details
            hasMenubar

            a character either 'true' or 'false'

            hasScrollbars

            a character either 'true' or 'false'

            hasToolbar

            a character either 'true' or 'false'

            -
            height

            a integer

            +
            height

            an integer

            isResizable

            a character either 'true' or 'false'

            linkType

            a WebLinkType - which is a character taking one of the following values:

              @@ -2163,19 +2163,19 @@

              Details
              showsLocation

              a character either 'true' or 'false'

              showsStatus

              a character either 'true' or 'false'

              url

              a character

              -
              width

              a integer

              +
              width

              an integer

          CustomPageWebLinkTranslation

          -

          Salesforce Documentation for CustomPageWebLinkTranslation

          +
          label

          a character

          name

          a character

          CustomPermission

          -

          Salesforce Documentation for CustomPermission

          +
          fullName

          a character (inherited from Metadata)

          connectedApp

          a character

          description

          a character

          @@ -2185,14 +2185,14 @@

          Details

          CustomPermissionDependencyRequired

          -

          Salesforce Documentation for CustomPermissionDependencyRequired

          +
          customPermission

          a character

          dependency

          a character either 'true' or 'false'

          CustomShortcut

          -

          Salesforce Documentation for CustomShortcut

          +
          action

          a character (inherited from DefaultShortcut)

          active

          a character either 'true' or 'false' (inherited from DefaultShortcut)

          keyCommand

          a character (inherited from DefaultShortcut)

          @@ -2202,7 +2202,7 @@

          Details

          CustomSite

          -

          Salesforce Documentation for CustomSite

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          allowHomePage

          a character either 'true' or 'false'

          @@ -2264,14 +2264,14 @@

          Details

          CustomTab

          -

          Salesforce Documentation for CustomTab

          +
          fullName

          a character (inherited from Metadata)

          actionOverrides

          a ActionOverride

          auraComponent

          a character

          customObject

          a character either 'true' or 'false'

          description

          a character

          flexiPage

          a character

          -
          frameHeight

          a integer

          +
          frameHeight

          an integer

          hasSidebar

          a character either 'true' or 'false'

          icon

          a character

          label

          a character

          @@ -2298,14 +2298,14 @@

          Details

          CustomTabTranslation

          -

          Salesforce Documentation for CustomTabTranslation

          +
          label

          a character

          name

          a character

          CustomValue

          -

          Salesforce Documentation for CustomValue

          +
          fullName

          a character (inherited from Metadata)

          color

          a character

          default

          a character either 'true' or 'false'

          @@ -2316,7 +2316,7 @@

          Details

          Dashboard

          -

          Salesforce Documentation for Dashboard

          +
          fullName

          a character (inherited from Metadata)

          backgroundEndColor

          a character

          backgroundFadeDirection

          a ChartBackgroundDirection - which is a character taking one of the following values: @@ -2391,18 +2391,18 @@

          Details
          isGridLayout

          a character either 'true' or 'false'

          leftSection

          a DashboardComponentSection

          middleSection

          a DashboardComponentSection

          -
          numSubscriptions

          a integer

          +
          numSubscriptions

          an integer

          rightSection

          a DashboardComponentSection

          runningUser

          a character

          textColor

          a character

          title

          a character

          titleColor

          a character

          -
          titleSize

          a integer

          +
          titleSize

          an integer

          DashboardComponent

          -

          Salesforce Documentation for DashboardComponent

          +
          autoselectColumnsFromReport

          a character either 'true' or 'false'

          chartAxisRange

          a ChartRangeType - which is a character taking one of the following values:

            @@ -2481,13 +2481,13 @@

            Details

          • Bottom

          • OnChart

          -
          maxValuesDisplayed

          a integer

          +
          maxValuesDisplayed

          an integer

          metricLabel

          a character

          page

          a character

          -
          pageHeightInPixels

          a integer

          +
          pageHeightInPixels

          an integer

          report

          a character

          scontrol

          a character

          -
          scontrolHeightInPixels

          a integer

          +
          scontrolHeightInPixels

          an integer

          showPercentage

          a character either 'true' or 'false'

          showPicturesOnCharts

          a character either 'true' or 'false'

          showPicturesOnTables

          a character either 'true' or 'false'

          @@ -2507,13 +2507,13 @@

          Details

          DashboardComponentColumn

          -

          Salesforce Documentation for DashboardComponentColumn

          +
          breakPoint1

          a numeric

          breakPoint2

          a numeric

          -
          breakPointOrder

          a integer

          -
          highRangeColor

          a integer

          -
          lowRangeColor

          a integer

          -
          midRangeColor

          a integer

          +
          breakPointOrder

          an integer

          +
          highRangeColor

          an integer

          +
          lowRangeColor

          an integer

          +
          midRangeColor

          an integer

          reportColumn

          a character

          showTotal

          a character either 'true' or 'false'

          type

          a DashboardComponentColumnType - which is a character taking one of the following values: @@ -2524,7 +2524,7 @@

          Details

          DashboardComponentSection

          -

          Salesforce Documentation for DashboardComponentSection

          +
          columnSize

          a DashboardComponentSize - which is a character taking one of the following values:

          • Narrow

            • @@ -2536,27 +2536,27 @@

            Details

          DashboardComponentSortInfo

          -

          Salesforce Documentation for DashboardComponentSortInfo

          +
          sortColumn

          a character

          sortOrder

          a character

          DashboardFilter

          -

          Salesforce Documentation for DashboardFilter

          +
          dashboardFilterOptions

          a DashboardFilterOption

          name

          a character

          DashboardFilterColumn

          -

          Salesforce Documentation for DashboardFilterColumn

          +
          column

          a character

          DashboardFilterOption

          -

          Salesforce Documentation for DashboardFilterOption

          +
          operator

          a DashboardFilterOperation - which is a character taking one of the following values:

          • equals

            • @@ -2577,7 +2577,7 @@

            Details

          DashboardFlexTableComponentProperties

          -

          Salesforce Documentation for DashboardFlexTableComponentProperties

          +
          flexTableColumn

          a DashboardComponentColumn

          flexTableSortInfo

          a DashboardComponentSortInfo

          hideChatterPhotos

          a character either 'true' or 'false'

          @@ -2585,7 +2585,7 @@

          Details

          DashboardFolder

          -

          Salesforce Documentation for DashboardFolder

          +
          accessType

          a FolderAccessTypes (inherited from Folder)

          folderShares

          a FolderShare (inherited from Folder)

          name

          a character (inherited from Folder)

          @@ -2595,31 +2595,31 @@

          Details

          DashboardGridComponent

          -

          Salesforce Documentation for DashboardGridComponent

          -
          colSpan

          a integer

          -
          columnIndex

          a integer

          +
          +
          colSpan

          an integer

          +
          columnIndex

          an integer

          dashboardComponent

          a DashboardComponent

          -
          rowIndex

          a integer

          -
          rowSpan

          a integer

          +
          rowIndex

          an integer

          +
          rowSpan

          an integer

          DashboardGridLayout

          -

          Salesforce Documentation for DashboardGridLayout

          +
          dashboardGridComponents

          a DashboardGridComponent

          -
          numberOfColumns

          a integer

          -
          rowHeight

          a integer

          +
          numberOfColumns

          an integer

          +
          rowHeight

          an integer

          DashboardMobileSettings

          -

          Salesforce Documentation for DashboardMobileSettings

          +
          enableDashboardIPadApp

          a character either 'true' or 'false'

          DashboardTableColumn

          -

          Salesforce Documentation for DashboardTableColumn

          +
          aggregateType

          a ReportSummaryType - which is a character taking one of the following values:

          • Sum

            • @@ -2630,7 +2630,7 @@

            Details

          calculatePercent

          a character either 'true' or 'false'

          column

          a character

          -
          decimalPlaces

          a integer

          +
          decimalPlaces

          an integer

          showTotal

          a character either 'true' or 'false'

          sortBy

          a DashboardComponentFilter - which is a character taking one of the following values:

            @@ -2643,7 +2643,7 @@

            Details

          DataCategory

          -

          Salesforce Documentation for DataCategory

          +
          dataCategory

          a DataCategory

          label

          a character

          name

          a character

          @@ -2651,7 +2651,7 @@

          Details

          DataCategoryGroup

          -

          Salesforce Documentation for DataCategoryGroup

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          dataCategory

          a DataCategory

          @@ -2662,8 +2662,8 @@

          Details

          DataPipeline

          -

          Salesforce Documentation for DataPipeline

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          label

          a character

          scriptType

          a DataPipelineType - which is a character taking one of the following values: @@ -2674,7 +2674,7 @@

          Details

          DefaultShortcut

          -

          Salesforce Documentation for DefaultShortcut

          +
          action

          a character

          active

          a character either 'true' or 'false'

          keyCommand

          a character

          @@ -2682,7 +2682,7 @@

          Details

          DelegateGroup

          -

          Salesforce Documentation for DelegateGroup

          +
          fullName

          a character (inherited from Metadata)

          customObjects

          a character

          groups

          a character

          @@ -2695,7 +2695,7 @@

          Details

          DeployDetails

          -

          Salesforce Documentation for DeployDetails

          +
          componentFailures

          a DeployMessage

          componentSuccesses

          a DeployMessage

          retrieveResult

          a RetrieveResult

          @@ -2704,7 +2704,7 @@

          Details

          DeployOptions

          -

          Salesforce Documentation for DeployOptions

          +
          allowMissingFiles

          a character either 'true' or 'false'

          autoUpdatePackage

          a character either 'true' or 'false'

          checkOnly

          a character either 'true' or 'false'

          @@ -2725,7 +2725,7 @@

          Details

          DescribeMetadataObject

          -

          Salesforce Documentation for DescribeMetadataObject

          +
          childXmlNames

          a character

          directoryName

          a character

          inFolder

          a character either 'true' or 'false'

          @@ -2736,8 +2736,8 @@

          Details

          Document

          -

          Salesforce Documentation for Document

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          description

          a character

          internalUseOnly

          a character either 'true' or 'false'

          keywords

          a character

          @@ -2747,7 +2747,7 @@

          Details

          DocumentFolder

          -

          Salesforce Documentation for DocumentFolder

          +
          accessType

          a FolderAccessTypes (inherited from Folder)

          folderShares

          a FolderShare (inherited from Folder)

          name

          a character (inherited from Folder)

          @@ -2757,7 +2757,7 @@

          Details

          DuplicateRule

          -

          Salesforce Documentation for DuplicateRule

          +
          fullName

          a character (inherited from Metadata)

          actionOnInsert

          a DupeActionType - which is a character taking one of the following values:

            @@ -2782,30 +2782,30 @@

            Details

          • EnforceSharingRules

          • BypassSharingRules

          -
          sortOrder

          a integer

          +
          sortOrder

          an integer

          DuplicateRuleFilter

          -

          Salesforce Documentation for DuplicateRuleFilter

          +
          booleanFilter

          a character

          duplicateRuleFilterItems

          a DuplicateRuleFilterItem

          DuplicateRuleFilterItem

          -

          Salesforce Documentation for DuplicateRuleFilterItem

          +
          field

          a character (inherited from FilterItem)

          operation

          a FilterOperation (inherited from FilterItem)

          value

          a character (inherited from FilterItem)

          valueField

          a character (inherited from FilterItem)

          -
          sortOrder

          a integer

          +
          sortOrder

          an integer

          table

          a character

          DuplicateRuleMatchRule

          -

          Salesforce Documentation for DuplicateRuleMatchRule

          +
          matchRuleSObjectType

          a character

          matchingRule

          a character

          objectMapping

          a ObjectMapping

          @@ -2813,15 +2813,15 @@

          Details

          EclairGeoData

          -

          Salesforce Documentation for EclairGeoData

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          maps

          a EclairMap

          masterLabel

          a character

          EclairMap

          -

          Salesforce Documentation for EclairMap

          +
          boundingBoxBottom

          a numeric

          boundingBoxLeft

          a numeric

          boundingBoxRight

          a numeric

          @@ -2833,7 +2833,7 @@

          Details

          EmailFolder

          -

          Salesforce Documentation for EmailFolder

          +
          accessType

          a FolderAccessTypes (inherited from Folder)

          folderShares

          a FolderShare (inherited from Folder)

          name

          a character (inherited from Folder)

          @@ -2843,7 +2843,7 @@

          Details

          EmailServicesAddress

          -

          Salesforce Documentation for EmailServicesAddress

          +
          authorizedSenders

          a character

          developerName

          a character

          isActive

          a character either 'true' or 'false'

          @@ -2853,7 +2853,7 @@

          Details

          EmailServicesFunction

          -

          Salesforce Documentation for EmailServicesFunction

          +
          fullName

          a character (inherited from Metadata)

          apexClass

          a character

          attachmentOption

          a EmailServicesAttOptions - which is a character taking one of the following values: @@ -2905,8 +2905,8 @@

          Details

          EmailTemplate

          -

          Salesforce Documentation for EmailTemplate

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          apiVersion

          a numeric

          attachedDocuments

          a character

          attachments

          a Attachment

          @@ -2958,7 +2958,7 @@

          Details

          EmailToCaseRoutingAddress

          -

          Salesforce Documentation for EmailToCaseRoutingAddress

          +
          addressType

          a EmailToCaseRoutingAddressType - which is a character taking one of the following values:

          • EmailToCase

            • @@ -2980,7 +2980,7 @@

            Details

          EmailToCaseSettings

          -

          Salesforce Documentation for EmailToCaseSettings

          +
          enableE2CSourceTracking

          a character either 'true' or 'false'

          enableEmailToCase

          a character either 'true' or 'false'

          enableHtmlEmail

          a character either 'true' or 'false'

          @@ -3006,7 +3006,7 @@

          Details

          EmbeddedServiceBranding

          -

          Salesforce Documentation for EmbeddedServiceBranding

          +
          fullName

          a character (inherited from Metadata)

          contrastInvertedColor

          a character

          contrastPrimaryColor

          a character

          @@ -3020,7 +3020,7 @@

          Details

          EmbeddedServiceConfig

          -

          Salesforce Documentation for EmbeddedServiceConfig

          +
          fullName

          a character (inherited from Metadata)

          masterLabel

          a character

          site

          a character

          @@ -3028,7 +3028,7 @@

          Details

          EmbeddedServiceFieldService

          -

          Salesforce Documentation for EmbeddedServiceFieldService

          +
          fullName

          a character (inherited from Metadata)

          appointmentBookingFlowName

          a character

          cancelApptBookingFlowName

          a character

          @@ -3045,7 +3045,7 @@

          Details

          EmbeddedServiceLiveAgent

          -

          Salesforce Documentation for EmbeddedServiceLiveAgent

          +
          fullName

          a character (inherited from Metadata)

          avatarImg

          a character

          customPrechatComponent

          a character

          @@ -3079,15 +3079,15 @@

          Details

          EmbeddedServiceQuickAction

          -

          Salesforce Documentation for EmbeddedServiceQuickAction

          +
          embeddedServiceLiveAgent

          a character

          -
          order

          a integer

          +
          order

          an integer

          quickActionDefinition

          a character

          EntitlementProcess

          -

          Salesforce Documentation for EntitlementProcess

          +
          fullName

          a character (inherited from Metadata)

          SObjectType

          a character

          active

          a character either 'true' or 'false'

          @@ -3104,19 +3104,19 @@

          Details
          recordType

          a character

          versionMaster

          a character

          versionNotes

          a character

          -
          versionNumber

          a integer

          +
          versionNumber

          an integer

          EntitlementProcessMilestoneItem

          -

          Salesforce Documentation for EntitlementProcessMilestoneItem

          +
          businessHours

          a character

          criteriaBooleanFilter

          a character

          milestoneCriteriaFilterItems

          a FilterItem

          milestoneCriteriaFormula

          a character

          milestoneName

          a character

          minutesCustomClass

          a character

          -
          minutesToComplete

          a integer

          +
          minutesToComplete

          an integer

          successActions

          a WorkflowActionReference

          timeTriggers

          a EntitlementProcessMilestoneTimeTrigger

          useCriteriaStartTime

          a character either 'true' or 'false'

          @@ -3124,9 +3124,9 @@

          Details

          EntitlementProcessMilestoneTimeTrigger

          -

          Salesforce Documentation for EntitlementProcessMilestoneTimeTrigger

          +
          actions

          a WorkflowActionReference

          -
          timeLength

          a integer

          +
          timeLength

          an integer

          workflowTimeTriggerUnit

          a MilestoneTimeUnits - which is a character taking one of the following values:

          • Minutes

            • @@ -3137,7 +3137,7 @@

            Details

          EntitlementSettings

          -

          Salesforce Documentation for EntitlementSettings

          +
          fullName

          a character (inherited from Metadata)

          assetLookupLimitedToActiveEntitlementsOnAccount

          a character either 'true' or 'false'

          assetLookupLimitedToActiveEntitlementsOnContact

          a character either 'true' or 'false'

          @@ -3153,19 +3153,19 @@

          Details

          EntitlementTemplate

          -

          Salesforce Documentation for EntitlementTemplate

          +
          fullName

          a character (inherited from Metadata)

          businessHours

          a character

          -
          casesPerEntitlement

          a integer

          +
          casesPerEntitlement

          an integer

          entitlementProcess

          a character

          isPerIncident

          a character either 'true' or 'false'

          -
          term

          a integer

          +
          term

          an integer

          type

          a character

          EscalationAction

          -

          Salesforce Documentation for EscalationAction

          +
          assignedTo

          a character

          assignedToTemplate

          a character

          assignedToType

          a AssignToLookupValueType - which is a character taking one of the following values: @@ -3173,7 +3173,7 @@

          Details

        • User

        • Queue

          • -
          minutesToEscalation

          a integer

          +
          minutesToEscalation

          an integer

          notifyCaseOwner

          a character either 'true' or 'false'

          notifyEmail

          a character

          notifyTo

          a character

          @@ -3182,7 +3182,7 @@

          Details

          EscalationRule

          -

          Salesforce Documentation for EscalationRule

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          ruleEntry

          a RuleEntry

          @@ -3190,14 +3190,14 @@

          Details

          EscalationRules

          -

          Salesforce Documentation for EscalationRules

          +
          fullName

          a character (inherited from Metadata)

          escalationRule

          a EscalationRule

          EventDelivery

          -

          Salesforce Documentation for EventDelivery

          +
          fullName

          a character (inherited from Metadata)

          eventParameters

          a EventParameterMap

          eventSubscription

          a character

          @@ -3211,14 +3211,14 @@

          Details

          EventParameterMap

          -

          Salesforce Documentation for EventParameterMap

          +
          parameterName

          a character

          parameterValue

          a character

          EventSubscription

          -

          Salesforce Documentation for EventSubscription

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          eventParameters

          a EventParameterMap

          @@ -3228,7 +3228,7 @@

          Details

          ExtendedErrorDetails

          -

          Salesforce Documentation for ExtendedErrorDetails

          +
          extendedErrorCode

          a ExtendedErrorCode - which is a character taking one of the following values:

          • ACTIONCALL_DUPLICATE_INPUT_PARAM - Errors with this extended error code have the following properties: @@ -3746,7 +3746,7 @@

            Details

          ExternalDataSource

          -

          Salesforce Documentation for ExternalDataSource

          +
          fullName

          a character (inherited from Metadata)

          authProvider

          a character

          certificate

          a character

          @@ -3791,7 +3791,7 @@

          Details

          ExternalServiceRegistration

          -

          Salesforce Documentation for ExternalServiceRegistration

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          label

          a character

          @@ -3804,7 +3804,7 @@

          Details

          FeedFilterCriterion

          -

          Salesforce Documentation for FeedFilterCriterion

          +
          feedItemType

          a FeedItemType - which is a character taking one of the following values:

          • TrackedChange

            • @@ -3847,8 +3847,8 @@

            Details

          FeedItemSettings

          -

          Salesforce Documentation for FeedItemSettings

          -
          characterLimit

          a integer

          +
          +
          characterLimit

          an integer

          collapseThread

          a character either 'true' or 'false'

          displayFormat

          a FeedItemDisplayFormat - which is a character taking one of the following values:

            @@ -3891,7 +3891,7 @@

            Details

          FeedLayout

          -

          Salesforce Documentation for FeedLayout

          +
          autocollapsePublisher

          a character either 'true' or 'false'

          compactFeed

          a character either 'true' or 'false'

          feedFilterPosition

          a FeedLayoutFilterPosition - which is a character taking one of the following values: @@ -3911,7 +3911,7 @@

          Details

          FeedLayoutComponent

          -

          Salesforce Documentation for FeedLayoutComponent

          +
          componentType

          a FeedLayoutComponentType - which is a character taking one of the following values:

          • HelpAndToolLinks

            • @@ -3924,13 +3924,13 @@

            Details

          • CaseUnifiedFiles

          • Visualforce

          -
          height

          a integer

          +
          height

          an integer

          page

          a character

          FeedLayoutFilter

          -

          Salesforce Documentation for FeedLayoutFilter

          +
          feedFilterName

          a character

          feedFilterType

          a FeedLayoutFilterType - which is a character taking one of the following values:

            @@ -3974,7 +3974,7 @@

            Details

          FieldMapping

          -

          Salesforce Documentation for FieldMapping

          +
          SObjectType

          a character

          developerName

          a character

          fieldMappingRows

          a FieldMappingRow

          @@ -3983,15 +3983,15 @@

          Details

          FieldMappingField

          -

          Salesforce Documentation for FieldMappingField

          +
          dataServiceField

          a character

          dataServiceObjectName

          a character

          -
          priority

          a integer

          +
          priority

          an integer

          FieldMappingRow

          -

          Salesforce Documentation for FieldMappingRow

          +
          SObjectType

          a character

          fieldMappingFields

          a FieldMappingField

          fieldName

          a character

          @@ -4004,7 +4004,7 @@

          Details

          FieldOverride

          -

          Salesforce Documentation for FieldOverride

          +
          field

          a character

          formula

          a character

          literalValue

          a character

          @@ -4012,18 +4012,18 @@

          Details

          FieldServiceSettings

          -

          Salesforce Documentation for FieldServiceSettings

          +
          fullName

          a character (inherited from Metadata)

          fieldServiceNotificationsOrgPref

          a character either 'true' or 'false'

          fieldServiceOrgPref

          a character either 'true' or 'false'

          -
          serviceAppointmentsDueDateOffsetOrgValue

          a integer

          +
          serviceAppointmentsDueDateOffsetOrgValue

          an integer

          workOrderLineItemSearchFields

          a character

          workOrderSearchFields

          a character

          FieldSet

          -

          Salesforce Documentation for FieldSet

          +
          fullName

          a character (inherited from Metadata)

          availableFields

          a FieldSetItem

          description

          a character

          @@ -4033,7 +4033,7 @@

          Details

          FieldSetItem

          -

          Salesforce Documentation for FieldSetItem

          +
          field

          a character

          isFieldManaged

          a character either 'true' or 'false'

          isRequired

          a character either 'true' or 'false'

          @@ -4041,21 +4041,21 @@

          Details

          FieldSetTranslation

          -

          Salesforce Documentation for FieldSetTranslation

          +
          label

          a character

          name

          a character

          FieldValue

          -

          Salesforce Documentation for FieldValue

          +
          name

          a character

          value

          a character that appears similar to any of the other accepted types (integer, numeric, date, datetime, boolean)

          FileProperties

          -

          Salesforce Documentation for FileProperties

          +
          createdById

          a character

          createdByName

          a character

          createdDate

          a character formatted as 'yyyy-mm-ddThh:mm:ssZ'

          @@ -4080,7 +4080,7 @@

          Details

          FileTypeDispositionAssignmentBean

          -

          Salesforce Documentation for FileTypeDispositionAssignmentBean

          +
          behavior

          a FileDownloadBehavior - which is a character taking one of the following values:

          • DOWNLOAD

            • @@ -4206,7 +4206,7 @@

            Details

          FileUploadAndDownloadSecuritySettings

          -

          Salesforce Documentation for FileUploadAndDownloadSecuritySettings

          +
          fullName

          a character (inherited from Metadata)

          dispositions

          a FileTypeDispositionAssignmentBean

          noHtmlUploadAsAttachment

          a character either 'true' or 'false'

          @@ -4214,7 +4214,7 @@

          Details

          FilterItem

          -

          Salesforce Documentation for FilterItem

          +
          field

          a character

          operation

          a FilterOperation - which is a character taking one of the following values:

            @@ -4237,21 +4237,21 @@

            Details

          FindSimilarOppFilter

          -

          Salesforce Documentation for FindSimilarOppFilter

          +
          similarOpportunitiesDisplayColumns

          a character

          similarOpportunitiesMatchFields

          a character

          FiscalYearSettings

          -

          Salesforce Documentation for FiscalYearSettings

          +
          fiscalYearNameBasedOn

          a character

          startMonth

          a character

          FlexiPage

          -

          Salesforce Documentation for FlexiPage

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          flexiPageRegions

          a FlexiPageRegion

          @@ -4286,7 +4286,7 @@

          Details

          FlexiPageRegion

          -

          Salesforce Documentation for FlexiPageRegion

          +
          appendable

          a RegionFlagStatus - which is a character taking one of the following values:

          • disabled

            • @@ -4319,14 +4319,14 @@

            Details

          FlexiPageTemplateInstance

          -

          Salesforce Documentation for FlexiPageTemplateInstance

          +
          name

          a character

          properties

          a ComponentInstanceProperty

          Flow

          -

          Salesforce Documentation for Flow

          +
          fullName

          a character (inherited from Metadata)

          actionCalls

          a FlowActionCall

          apexPluginCalls

          a FlowApexPluginCall

          @@ -4374,10 +4374,10 @@

          Details

          FlowActionCall

          -

          Salesforce Documentation for FlowActionCall

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          actionName

          a character

          actionType

          a InvocableActionType - which is a character taking one of the following values:

            @@ -4412,7 +4412,7 @@

            Details

          FlowActionCallInputParameter

          -

          Salesforce Documentation for FlowActionCallInputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          name

          a character

          value

          a FlowElementReferenceOrValue

          @@ -4420,7 +4420,7 @@

          Details

          FlowActionCallOutputParameter

          -

          Salesforce Documentation for FlowActionCallOutputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          name

          a character

          @@ -4428,10 +4428,10 @@

          Details

          FlowApexPluginCall

          -

          Salesforce Documentation for FlowApexPluginCall

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          apexClass

          a character

          connector

          a FlowConnector

          faultConnector

          a FlowConnector

          @@ -4441,7 +4441,7 @@

          Details

          FlowApexPluginCallInputParameter

          -

          Salesforce Documentation for FlowApexPluginCallInputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          name

          a character

          value

          a FlowElementReferenceOrValue

          @@ -4449,7 +4449,7 @@

          Details

          FlowApexPluginCallOutputParameter

          -

          Salesforce Documentation for FlowApexPluginCallOutputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          name

          a character

          @@ -4457,17 +4457,17 @@

          Details

          FlowAssignment

          -

          Salesforce Documentation for FlowAssignment

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          assignmentItems

          a FlowAssignmentItem

          connector

          a FlowConnector

          FlowAssignmentItem

          -

          Salesforce Documentation for FlowAssignmentItem

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          operator

          a FlowAssignmentOperator - which is a character taking one of the following values: @@ -4482,13 +4482,13 @@

          Details

          FlowBaseElement

          -

          Salesforce Documentation for FlowBaseElement

          +
          processMetadataValues

          a FlowMetadataValue

          FlowCategory

          -

          Salesforce Documentation for FlowCategory

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          flowCategoryItems

          a FlowCategoryItems

          @@ -4497,13 +4497,13 @@

          Details

          FlowCategoryItems

          -

          Salesforce Documentation for FlowCategoryItems

          +
          flow

          a character

          FlowChoice

          -

          Salesforce Documentation for FlowChoice

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          choiceText

          a character

          @@ -4525,7 +4525,7 @@

          Details

          FlowChoiceTranslation

          -

          Salesforce Documentation for FlowChoiceTranslation

          +
          choiceText

          a character

          name

          a character

          userInput

          a FlowChoiceUserInputTranslation

          @@ -4533,7 +4533,7 @@

          Details

          FlowChoiceUserInput

          -

          Salesforce Documentation for FlowChoiceUserInput

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          isRequired

          a character either 'true' or 'false'

          promptText

          a character

          @@ -4542,14 +4542,14 @@

          Details

          FlowChoiceUserInputTranslation

          -

          Salesforce Documentation for FlowChoiceUserInputTranslation

          +
          promptText

          a character

          validationRule

          a FlowInputValidationRuleTranslation

          FlowCondition

          -

          Salesforce Documentation for FlowCondition

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          leftValueReference

          a character

          operator

          a FlowComparisonOperator - which is a character taking one of the following values: @@ -4573,14 +4573,14 @@

          Details

          FlowConnector

          -

          Salesforce Documentation for FlowConnector

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          targetReference

          a character

          FlowConstant

          -

          Salesforce Documentation for FlowConstant

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          dataType

          a FlowDataType - which is a character taking one of the following values: @@ -4600,10 +4600,10 @@

          Details

          FlowDecision

          -

          Salesforce Documentation for FlowDecision

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          defaultConnector

          a FlowConnector

          defaultConnectorLabel

          a character

          rules

          a FlowRule

          @@ -4611,16 +4611,16 @@

          Details

          FlowDefinition

          -

          Salesforce Documentation for FlowDefinition

          +
          fullName

          a character (inherited from Metadata)

          -
          activeVersionNumber

          a integer

          +
          activeVersionNumber

          an integer

          description

          a character

          masterLabel

          a character

          FlowDefinitionTranslation

          -

          Salesforce Documentation for FlowDefinitionTranslation

          +
          flows

          a FlowTranslation

          fullName

          a character

          label

          a character

          @@ -4628,7 +4628,7 @@

          Details

          FlowDynamicChoiceSet

          -

          Salesforce Documentation for FlowDynamicChoiceSet

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          dataType

          a FlowDataType - which is a character taking one of the following values: @@ -4645,7 +4645,7 @@

          Details

          displayField

          a character

          filters

          a FlowRecordFilter

          -
          limit

          a integer

          +
          limit

          an integer

          object

          a character

          outputAssignments

          a FlowOutputFieldAssignment

          picklistField

          a character

          @@ -4661,7 +4661,7 @@

          Details

          FlowElement

          -

          Salesforce Documentation for FlowElement

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          description

          a character

          name

          a character

          @@ -4669,7 +4669,7 @@

          Details

          FlowElementReferenceOrValue

          -

          Salesforce Documentation for FlowElementReferenceOrValue

          +
          booleanValue

          a character either 'true' or 'false'

          dateTimeValue

          a character formatted as 'yyyy-mm-ddThh:mm:ssZ'

          dateValue

          a character formatted as 'yyyy-mm-dd'

          @@ -4680,7 +4680,7 @@

          Details

          FlowFormula

          -

          Salesforce Documentation for FlowFormula

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          dataType

          a FlowDataType - which is a character taking one of the following values: @@ -4696,12 +4696,12 @@

          Details

        • Multipicklist

          • expression

          a character

          -
          scale

          a integer

          +
          scale

          an integer

          FlowInputFieldAssignment

          -

          Salesforce Documentation for FlowInputFieldAssignment

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          field

          a character

          value

          a FlowElementReferenceOrValue

          @@ -4709,23 +4709,23 @@

          Details

          FlowInputValidationRule

          -

          Salesforce Documentation for FlowInputValidationRule

          +
          errorMessage

          a character

          formulaExpression

          a character

          FlowInputValidationRuleTranslation

          -

          Salesforce Documentation for FlowInputValidationRuleTranslation

          +
          errorMessage

          a character

          FlowLoop

          -

          Salesforce Documentation for FlowLoop

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          assignNextValueToReference

          a character

          collectionReference

          a character

          iterationOrder

          a IterationOrder - which is a character taking one of the following values: @@ -4739,24 +4739,24 @@

          Details

          FlowMetadataValue

          -

          Salesforce Documentation for FlowMetadataValue

          +
          name

          a character

          value

          a FlowElementReferenceOrValue

          FlowNode

          -

          Salesforce Documentation for FlowNode

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          label

          a character

          -
          locationX

          a integer

          -
          locationY

          a integer

          +
          locationX

          an integer

          +
          locationY

          an integer

          FlowOutputFieldAssignment

          -

          Salesforce Documentation for FlowOutputFieldAssignment

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          field

          a character

          @@ -4764,10 +4764,10 @@

          Details

          FlowRecordCreate

          -

          Salesforce Documentation for FlowRecordCreate

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          assignRecordIdToReference

          a character

          connector

          a FlowConnector

          faultConnector

          a FlowConnector

          @@ -4778,10 +4778,10 @@

          Details

          FlowRecordDelete

          -

          Salesforce Documentation for FlowRecordDelete

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          connector

          a FlowConnector

          faultConnector

          a FlowConnector

          filters

          a FlowRecordFilter

          @@ -4791,7 +4791,7 @@

          Details

          FlowRecordFilter

          -

          Salesforce Documentation for FlowRecordFilter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          field

          a character

          operator

          a FlowRecordFilterOperator - which is a character taking one of the following values: @@ -4812,10 +4812,10 @@

          Details

          FlowRecordLookup

          -

          Salesforce Documentation for FlowRecordLookup

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          assignNullValuesIfNoRecordsFound

          a character either 'true' or 'false'

          connector

          a FlowConnector

          faultConnector

          a FlowConnector

          @@ -4834,10 +4834,10 @@

          Details

          FlowRecordUpdate

          -

          Salesforce Documentation for FlowRecordUpdate

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          connector

          a FlowConnector

          faultConnector

          a FlowConnector

          filters

          a FlowRecordFilter

          @@ -4848,7 +4848,7 @@

          Details

          FlowRule

          -

          Salesforce Documentation for FlowRule

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          conditionLogic

          a character

          @@ -4859,10 +4859,10 @@

          Details

          FlowScreen

          -

          Salesforce Documentation for FlowScreen

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          allowBack

          a character either 'true' or 'false'

          allowFinish

          a character either 'true' or 'false'

          allowPause

          a character either 'true' or 'false'

          @@ -4877,7 +4877,7 @@

          Details

          FlowScreenField

          -

          Salesforce Documentation for FlowScreenField

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          choiceReferences

          a character

          @@ -4914,13 +4914,13 @@

          Details
          isRequired

          a character either 'true' or 'false'

          isVisible

          a character either 'true' or 'false'

          outputParameters

          a FlowScreenFieldOutputParameter

          -
          scale

          a integer

          +
          scale

          an integer

          validationRule

          a FlowInputValidationRule

          FlowScreenFieldInputParameter

          -

          Salesforce Documentation for FlowScreenFieldInputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          name

          a character

          value

          a FlowElementReferenceOrValue

          @@ -4928,7 +4928,7 @@

          Details

          FlowScreenFieldOutputParameter

          -

          Salesforce Documentation for FlowScreenFieldOutputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          name

          a character

          @@ -4936,7 +4936,7 @@

          Details

          FlowScreenFieldTranslation

          -

          Salesforce Documentation for FlowScreenFieldTranslation

          +
          fieldText

          a character

          helpText

          a character

          name

          a character

          @@ -4945,7 +4945,7 @@

          Details

          FlowScreenRule

          -

          Salesforce Documentation for FlowScreenRule

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          conditionLogic

          a character

          conditions

          a FlowCondition

          @@ -4955,7 +4955,7 @@

          Details

          FlowScreenRuleAction

          -

          Salesforce Documentation for FlowScreenRuleAction

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          attribute

          a character

          fieldReference

          a character

          @@ -4964,7 +4964,7 @@

          Details

          FlowScreenTranslation

          -

          Salesforce Documentation for FlowScreenTranslation

          +
          fields

          a FlowScreenFieldTranslation

          helpText

          a character

          name

          a character

          @@ -4973,29 +4973,29 @@

          Details

          FlowStage

          -

          Salesforce Documentation for FlowStage

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          isActive

          a character either 'true' or 'false'

          label

          a character

          -
          stageOrder

          a integer

          +
          stageOrder

          an integer

          FlowStep

          -

          Salesforce Documentation for FlowStep

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          connectors

          a FlowConnector

          FlowSubflow

          -

          Salesforce Documentation for FlowSubflow

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          connector

          a FlowConnector

          flowName

          a character

          inputAssignments

          a FlowSubflowInputAssignment

          @@ -5004,7 +5004,7 @@

          Details

          FlowSubflowInputAssignment

          -

          Salesforce Documentation for FlowSubflowInputAssignment

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          name

          a character

          value

          a FlowElementReferenceOrValue

          @@ -5012,7 +5012,7 @@

          Details

          FlowSubflowOutputAssignment

          -

          Salesforce Documentation for FlowSubflowOutputAssignment

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          name

          a character

          @@ -5020,7 +5020,7 @@

          Details

          FlowTextTemplate

          -

          Salesforce Documentation for FlowTextTemplate

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          text

          a character

          @@ -5028,7 +5028,7 @@

          Details

          FlowTranslation

          -

          Salesforce Documentation for FlowTranslation

          +
          choices

          a FlowChoiceTranslation

          fullName

          a character

          label

          a character

          @@ -5037,7 +5037,7 @@

          Details

          FlowVariable

          -

          Salesforce Documentation for FlowVariable

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          dataType

          a FlowDataType - which is a character taking one of the following values: @@ -5056,16 +5056,16 @@

          Details
          isInput

          a character either 'true' or 'false'

          isOutput

          a character either 'true' or 'false'

          objectType

          a character

          -
          scale

          a integer

          +
          scale

          an integer

          value

          a FlowElementReferenceOrValue

          FlowWait

          -

          Salesforce Documentation for FlowWait

          +
          label

          a character (inherited from FlowNode)

          -
          locationX

          a integer (inherited from FlowNode)

          -
          locationY

          a integer (inherited from FlowNode)

          +
          locationX

          an integer (inherited from FlowNode)

          +
          locationY

          an integer (inherited from FlowNode)

          defaultConnector

          a FlowConnector

          defaultConnectorLabel

          a character

          faultConnector

          a FlowConnector

          @@ -5074,7 +5074,7 @@

          Details

          FlowWaitEvent

          -

          Salesforce Documentation for FlowWaitEvent

          +
          description

          a character (inherited from FlowElement)

          name

          a character (inherited from FlowElement)

          conditionLogic

          a character

          @@ -5088,7 +5088,7 @@

          Details

          FlowWaitEventInputParameter

          -

          Salesforce Documentation for FlowWaitEventInputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          name

          a character

          value

          a FlowElementReferenceOrValue

          @@ -5096,7 +5096,7 @@

          Details

          FlowWaitEventOutputParameter

          -

          Salesforce Documentation for FlowWaitEventOutputParameter

          +
          processMetadataValues

          a FlowMetadataValue (inherited from FlowBaseElement)

          assignToReference

          a character

          name

          a character

          @@ -5104,7 +5104,7 @@

          Details

          Folder

          -

          Salesforce Documentation for Folder

          +
          fullName

          a character (inherited from Metadata)

          accessType

          a FolderAccessTypes - which is a character taking one of the following values:

            @@ -5125,7 +5125,7 @@

            Details

          FolderShare

          -

          Salesforce Documentation for FolderShare

          +
          accessLevel

          a FolderShareAccessLevel - which is a character taking one of the following values:

          • View

            • @@ -5157,20 +5157,20 @@

            Details

          ForecastingCategoryMapping

          -

          Salesforce Documentation for ForecastingCategoryMapping

          +
          forecastingItemCategoryApiName

          a character

          weightedSourceCategories

          a WeightedSourceCategory

          ForecastingDisplayedFamilySettings

          -

          Salesforce Documentation for ForecastingDisplayedFamilySettings

          +
          productFamily

          a character

          ForecastingSettings

          -

          Salesforce Documentation for ForecastingSettings

          +
          fullName

          a character (inherited from Metadata)

          displayCurrency

          a DisplayCurrency - which is a character taking one of the following values:

            @@ -5185,7 +5185,7 @@

            Details

          ForecastingTypeSettings

          -

          Salesforce Documentation for ForecastingTypeSettings

          +
          active

          a character either 'true' or 'false'

          adjustmentsSettings

          a AdjustmentsSettings

          displayedCategoryApiNames

          a character

          @@ -5215,9 +5215,9 @@

          Details

          ForecastRangeSettings

          -

          Salesforce Documentation for ForecastRangeSettings

          -
          beginning

          a integer

          -
          displaying

          a integer

          +
          +
          beginning

          an integer

          +
          displaying

          an integer

          periodType

          a PeriodTypes - which is a character taking one of the following values:

          • Month

            • @@ -5229,7 +5229,7 @@

            Details

          GlobalPicklistValue

          -

          Salesforce Documentation for GlobalPicklistValue

          +
          fullName

          a character (inherited from Metadata)

          color

          a character

          default

          a character either 'true' or 'false'

          @@ -5239,14 +5239,14 @@

          Details

          GlobalQuickActionTranslation

          -

          Salesforce Documentation for GlobalQuickActionTranslation

          +
          label

          a character

          name

          a character

          GlobalValueSet

          -

          Salesforce Documentation for GlobalValueSet

          +
          fullName

          a character (inherited from Metadata)

          customValue

          a CustomValue

          description

          a character

          @@ -5256,14 +5256,14 @@

          Details

          GlobalValueSetTranslation

          -

          Salesforce Documentation for GlobalValueSetTranslation

          +
          fullName

          a character (inherited from Metadata)

          valueTranslation

          a ValueTranslation

          Group

          -

          Salesforce Documentation for Group

          +
          fullName

          a character (inherited from Metadata)

          doesIncludeBosses

          a character either 'true' or 'false'

          name

          a character

          @@ -5271,27 +5271,27 @@

          Details

          HistoryRetentionPolicy

          -

          Salesforce Documentation for HistoryRetentionPolicy

          -
          archiveAfterMonths

          a integer

          -
          archiveRetentionYears

          a integer

          +
          +
          archiveAfterMonths

          an integer

          +
          archiveRetentionYears

          an integer

          description

          a character

          Holiday

          -

          Salesforce Documentation for Holiday

          +
          activityDate

          a character formatted as 'yyyy-mm-dd'

          businessHours

          a character

          description

          a character

          endTime

          a character formatted as 'hh:mm:ssZ

          isRecurring

          a character either 'true' or 'false'

          name

          a character

          -
          recurrenceDayOfMonth

          a integer

          +
          recurrenceDayOfMonth

          an integer

          recurrenceDayOfWeek

          a character

          -
          recurrenceDayOfWeekMask

          a integer

          +
          recurrenceDayOfWeekMask

          an integer

          recurrenceEndDate

          a character formatted as 'yyyy-mm-dd'

          recurrenceInstance

          a character

          -
          recurrenceInterval

          a integer

          +
          recurrenceInterval

          an integer

          recurrenceMonthOfYear

          a character

          recurrenceStartDate

          a character formatted as 'yyyy-mm-dd'

          recurrenceType

          a character

          @@ -5300,10 +5300,10 @@

          Details

          HomePageComponent

          -

          Salesforce Documentation for HomePageComponent

          +
          fullName

          a character (inherited from Metadata)

          body

          a character

          -
          height

          a integer

          +
          height

          an integer

          links

          a character

          page

          a character

          pageComponentType

          a PageComponentType - which is a character taking one of the following values: @@ -5324,7 +5324,7 @@

          Details

          HomePageLayout

          -

          Salesforce Documentation for HomePageLayout

          +
          fullName

          a character (inherited from Metadata)

          narrowComponents

          a character

          wideComponents

          a character

          @@ -5332,14 +5332,14 @@

          Details

          IdeaReputationLevel

          -

          Salesforce Documentation for IdeaReputationLevel

          +
          name

          a character

          -
          value

          a integer

          +
          value

          an integer

          IdeasSettings

          -

          Salesforce Documentation for IdeasSettings

          +
          fullName

          a character (inherited from Metadata)

          enableChatterProfile

          a character either 'true' or 'false'

          enableIdeaThemes

          a character either 'true' or 'false'

          @@ -5351,7 +5351,7 @@

          Details

          Index

          -

          Salesforce Documentation for Index

          +
          fullName

          a character (inherited from Metadata)

          fields

          a IndexField

          label

          a character

          @@ -5359,14 +5359,14 @@

          Details

          IndexField

          -

          Salesforce Documentation for IndexField

          +
          name

          a character

          sortDirection

          a character

          InsightType

          -

          Salesforce Documentation for InsightType

          +
          fullName

          a character (inherited from Metadata)

          defaultTrendType

          a InsightTrendType - which is a character taking one of the following values:

            @@ -5388,7 +5388,7 @@

            Details

          InstalledPackage

          -

          Salesforce Documentation for InstalledPackage

          +
          fullName

          a character (inherited from Metadata)

          password

          a character

          versionNumber

          a character

          @@ -5396,7 +5396,7 @@

          Details

          IntegrationHubSettings

          -

          Salesforce Documentation for IntegrationHubSettings

          +
          fullName

          a character (inherited from Metadata)

          canonicalName

          a character

          canonicalNameBindingChar

          a character

          @@ -5410,14 +5410,14 @@

          Details
          setupSimpleName

          a character

          uUID

          a character

          version

          a character

          -
          versionBuild

          a integer

          -
          versionMajor

          a integer

          -
          versionMinor

          a integer

          +
          versionBuild

          an integer

          +
          versionMajor

          an integer

          +
          versionMinor

          an integer

          IntegrationHubSettingsType

          -

          Salesforce Documentation for IntegrationHubSettingsType

          +
          fullName

          a character (inherited from Metadata)

          canonicalName

          a character

          canonicalNameBindingChar

          a character

          @@ -5429,14 +5429,14 @@

          Details
          setupSimpleName

          a character

          uUID

          a character

          version

          a character

          -
          versionBuild

          a integer

          -
          versionMajor

          a integer

          -
          versionMinor

          a integer

          +
          versionBuild

          an integer

          +
          versionMajor

          an integer

          +
          versionMinor

          an integer

          IpRange

          -

          Salesforce Documentation for IpRange

          +
          description

          a character

          end

          a character

          start

          a character

          @@ -5444,20 +5444,20 @@

          Details

          KeyboardShortcuts

          -

          Salesforce Documentation for KeyboardShortcuts

          +
          customShortcuts

          a CustomShortcut

          defaultShortcuts

          a DefaultShortcut

          Keyword

          -

          Salesforce Documentation for Keyword

          +
          keyword

          a character

          KeywordList

          -

          Salesforce Documentation for KeywordList

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          keywords

          a Keyword

          @@ -5466,7 +5466,7 @@

          Details

          KnowledgeAnswerSettings

          -

          Salesforce Documentation for KnowledgeAnswerSettings

          +
          assignTo

          a character

          defaultArticleType

          a character

          enableArticleCreation

          a character either 'true' or 'false'

          @@ -5474,19 +5474,19 @@

          Details

          KnowledgeCaseField

          -

          Salesforce Documentation for KnowledgeCaseField

          +
          name

          a character

          KnowledgeCaseFieldsSettings

          -

          Salesforce Documentation for KnowledgeCaseFieldsSettings

          +
          field

          a KnowledgeCaseField

          KnowledgeCaseSettings

          -

          Salesforce Documentation for KnowledgeCaseSettings

          +
          articlePDFCreationProfile

          a character

          articlePublicSharingCommunities

          a KnowledgeCommunitiesSettings

          articlePublicSharingSites

          a KnowledgeSitesSettings

          @@ -5507,13 +5507,13 @@

          Details

          KnowledgeCommunitiesSettings

          -

          Salesforce Documentation for KnowledgeCommunitiesSettings

          +
          community

          a character

          KnowledgeLanguage

          -

          Salesforce Documentation for KnowledgeLanguage

          +
          active

          a character either 'true' or 'false'

          defaultAssignee

          a character

          defaultAssigneeType

          a KnowledgeLanguageLookupValueType - which is a character taking one of the following values: @@ -5532,13 +5532,13 @@

          Details

          KnowledgeLanguageSettings

          -

          Salesforce Documentation for KnowledgeLanguageSettings

          +
          language

          a KnowledgeLanguage

          KnowledgeSettings

          -

          Salesforce Documentation for KnowledgeSettings

          +
          fullName

          a character (inherited from Metadata)

          answers

          a KnowledgeAnswerSettings

          cases

          a KnowledgeCaseSettings

          @@ -5558,13 +5558,13 @@

          Details

          KnowledgeSitesSettings

          -

          Salesforce Documentation for KnowledgeSitesSettings

          +
          site

          a character

          KnowledgeSuggestedArticlesSettings

          -

          Salesforce Documentation for KnowledgeSuggestedArticlesSettings

          +
          caseFields

          a KnowledgeCaseFieldsSettings

          useSuggestedArticlesForCase

          a character either 'true' or 'false'

          workOrderFields

          a KnowledgeWorkOrderFieldsSettings

          @@ -5573,31 +5573,31 @@

          Details

          KnowledgeWorkOrderField

          -

          Salesforce Documentation for KnowledgeWorkOrderField

          +
          name

          a character

          KnowledgeWorkOrderFieldsSettings

          -

          Salesforce Documentation for KnowledgeWorkOrderFieldsSettings

          +
          field

          a KnowledgeWorkOrderField

          KnowledgeWorkOrderLineItemField

          -

          Salesforce Documentation for KnowledgeWorkOrderLineItemField

          +
          name

          a character

          KnowledgeWorkOrderLineItemFieldsSettings

          -

          Salesforce Documentation for KnowledgeWorkOrderLineItemFieldsSettings

          +
          field

          a KnowledgeWorkOrderLineItemField

          Layout

          -

          Salesforce Documentation for Layout

          +
          fullName

          a character (inherited from Metadata)

          customButtons

          a character

          customConsoleComponents

          a CustomConsoleComponents

          @@ -5630,14 +5630,14 @@

          Details

          LayoutColumn

          -

          Salesforce Documentation for LayoutColumn

          +
          layoutItems

          a LayoutItem

          reserved

          a character

          LayoutItem

          -

          Salesforce Documentation for LayoutItem

          +
          analyticsCloudComponent

          a AnalyticsCloudComponentLayoutItem

          behavior

          a UiBehavior - which is a character taking one of the following values:

            @@ -5650,7 +5650,7 @@

            Details
            customLink

            a character

            emptySpace

            a character either 'true' or 'false'

            field

            a character

            -
            height

            a integer

            +
            height

            an integer

            page

            a character

            reportChartComponent

            a ReportChartComponentLayoutItem

            scontrol

            a character

            @@ -5661,7 +5661,7 @@

            Details

          LayoutSection

          -

          Salesforce Documentation for LayoutSection

          +
          customLabel

          a character either 'true' or 'false'

          detailHeading

          a character either 'true' or 'false'

          editHeading

          a character either 'true' or 'false'

          @@ -5678,14 +5678,14 @@

          Details

          LayoutSectionTranslation

          -

          Salesforce Documentation for LayoutSectionTranslation

          +
          label

          a character

          section

          a character

          LayoutTranslation

          -

          Salesforce Documentation for LayoutTranslation

          +
          layout

          a character

          layoutType

          a character

          sections

          a LayoutSectionTranslation

          @@ -5693,7 +5693,7 @@

          Details

          LeadConvertSettings

          -

          Salesforce Documentation for LeadConvertSettings

          +
          fullName

          a character (inherited from Metadata)

          allowOwnerChange

          a character either 'true' or 'false'

          objectMapping

          a ObjectMapping

          @@ -5707,7 +5707,7 @@

          Details

          Letterhead

          -

          Salesforce Documentation for Letterhead

          +
          fullName

          a character (inherited from Metadata)

          available

          a character either 'true' or 'false'

          backgroundColor

          a character

          @@ -5723,9 +5723,9 @@

          Details

          LetterheadHeaderFooter

          -

          Salesforce Documentation for LetterheadHeaderFooter

          +
          backgroundColor

          a character

          -
          height

          a integer

          +
          height

          an integer

          horizontalAlignment

          a LetterheadHorizontalAlignment - which is a character taking one of the following values:

          • None

            • @@ -5745,21 +5745,21 @@

            Details

          LetterheadLine

          -

          Salesforce Documentation for LetterheadLine

          +
          color

          a character

          -
          height

          a integer

          +
          height

          an integer

          LicensedCustomPermissions

          -

          Salesforce Documentation for LicensedCustomPermissions

          +
          customPermission

          a character

          licenseDefinition

          a character

          LicenseDefinition

          -

          Salesforce Documentation for LicenseDefinition

          +
          fullName

          a character (inherited from Metadata)

          aggregationGroup

          a character

          description

          a character

          @@ -5768,16 +5768,16 @@

          Details
          licensedCustomPermissions

          a LicensedCustomPermissions

          licensingAuthority

          a character

          licensingAuthorityProvider

          a character

          -
          minPlatformVersion

          a integer

          +
          minPlatformVersion

          an integer

          origin

          a character

          -
          revision

          a integer

          -
          trialLicenseDuration

          a integer

          -
          trialLicenseQuantity

          a integer

          +
          revision

          an integer

          +
          trialLicenseDuration

          an integer

          +
          trialLicenseQuantity

          an integer

          LightningBolt

          -

          Salesforce Documentation for LightningBolt

          +
          fullName

          a character (inherited from Metadata)

          category

          a LightningBoltCategory - which is a character taking one of the following values:

            @@ -5796,29 +5796,29 @@

            Details

          LightningBoltFeatures

          -

          Salesforce Documentation for LightningBoltFeatures

          +
          description

          a character

          -
          order

          a integer

          +
          order

          an integer

          title

          a character

          LightningBoltImages

          -

          Salesforce Documentation for LightningBoltImages

          +
          image

          a character

          -
          order

          a integer

          +
          order

          an integer

          LightningBoltItems

          -

          Salesforce Documentation for LightningBoltItems

          +
          name

          a character

          type

          a character

          LightningComponentBundle

          -

          Salesforce Documentation for LightningComponentBundle

          +
          fullName

          a character (inherited from Metadata)

          apiVersion

          a numeric

          isExposed

          a character either 'true' or 'false'

          @@ -5826,7 +5826,7 @@

          Details

          LightningExperienceTheme

          -

          Salesforce Documentation for LightningExperienceTheme

          +
          fullName

          a character (inherited from Metadata)

          defaultBrandingSet

          a character

          description

          a character

          @@ -5836,23 +5836,23 @@

          Details

          ListMetadataQuery

          -

          Salesforce Documentation for ListMetadataQuery

          +
          folder

          a character

          type

          a character

          ListPlacement

          -

          Salesforce Documentation for ListPlacement

          -
          height

          a integer

          +
          +
          height

          an integer

          location

          a character

          units

          a character

          -
          width

          a integer

          +
          width

          an integer

          ListView

          -

          Salesforce Documentation for ListView

          +
          fullName

          a character (inherited from Metadata)

          booleanFilter

          a character

          columns

          a character

          @@ -5998,7 +5998,7 @@

          Details

          ListViewFilter

          -

          Salesforce Documentation for ListViewFilter

          +
          field

          a character

          operation

          a FilterOperation - which is a character taking one of the following values:

            @@ -6020,7 +6020,7 @@

            Details

          LiveAgentConfig

          -

          Salesforce Documentation for LiveAgentConfig

          +
          enableLiveChat

          a character either 'true' or 'false'

          openNewAccountSubtab

          a character either 'true' or 'false'

          openNewCaseSubtab

          a character either 'true' or 'false'

          @@ -6033,19 +6033,19 @@

          Details

          LiveAgentSettings

          -

          Salesforce Documentation for LiveAgentSettings

          +
          fullName

          a character (inherited from Metadata)

          enableLiveAgent

          a character either 'true' or 'false'

          LiveChatAgentConfig

          -

          Salesforce Documentation for LiveChatAgentConfig

          +
          fullName

          a character (inherited from Metadata)

          assignments

          a AgentConfigAssignments

          autoGreeting

          a character

          -
          capacity

          a integer

          -
          criticalWaitTime

          a integer

          +
          capacity

          an integer

          +
          criticalWaitTime

          an integer

          customAgentName

          a character

          enableAgentFileTransfer

          a character either 'true' or 'false'

          enableAgentSneakPeek

          a character either 'true' or 'false'

          @@ -6079,7 +6079,7 @@

          Details

          LiveChatButton

          -

          Salesforce Documentation for LiveChatButton

          +
          fullName

          a character (inherited from Metadata)

          animation

          a LiveChatButtonPresentation - which is a character taking one of the following values:

            @@ -6089,8 +6089,8 @@

            Details

          • Custom

          autoGreeting

          a character

          -
          chasitorIdleTimeout

          a integer

          -
          chasitorIdleTimeoutWarning

          a integer

          +
          chasitorIdleTimeout

          an integer

          +
          chasitorIdleTimeoutWarning

          an integer

          chatPage

          a character

          customAgentName

          a character

          deployments

          a LiveChatButtonDeployments

          @@ -6129,7 +6129,7 @@

          Details

          isActive

          a character either 'true' or 'false'

          label

          a character

          -
          numberOfReroutingAttempts

          a integer

          +
          numberOfReroutingAttempts

          an integer

          offlineImage

          a character

          onlineImage

          a character

          optionsCustomRoutingIsEnabled

          a character either 'true' or 'false'

          @@ -6139,13 +6139,13 @@

          Details
          optionsHasRerouteDeclinedRequest

          a character either 'true' or 'false'

          optionsIsAutoAccept

          a character either 'true' or 'false'

          optionsIsInviteAutoRemove

          a character either 'true' or 'false'

          -
          overallQueueLength

          a integer

          -
          perAgentQueueLength

          a integer

          +
          overallQueueLength

          an integer

          +
          perAgentQueueLength

          an integer

          postChatPage

          a character

          postChatUrl

          a character

          preChatFormPage

          a character

          preChatFormUrl

          a character

          -
          pushTimeOut

          a integer

          +
          pushTimeOut

          an integer

          routingType

          a LiveChatButtonRoutingType - which is a character taking one of the following values:

          • Choice

            • @@ -6154,7 +6154,7 @@

            Details

          site

          a character

          skills

          a LiveChatButtonSkills

          -
          timeToRemoveInvite

          a integer

          +
          timeToRemoveInvite

          an integer

          type

          a LiveChatButtonType - which is a character taking one of the following values:

          • Standard

            • @@ -6286,23 +6286,23 @@

            Details

          LiveChatButtonDeployments

          -

          Salesforce Documentation for LiveChatButtonDeployments

          +
          deployment

          a character

          LiveChatButtonSkills

          -

          Salesforce Documentation for LiveChatButtonSkills

          +
          skill

          a character

          LiveChatDeployment

          -

          Salesforce Documentation for LiveChatDeployment

          +
          fullName

          a character (inherited from Metadata)

          brandingImage

          a character

          -
          connectionTimeoutDuration

          a integer

          -
          connectionWarningDuration

          a integer

          +
          connectionTimeoutDuration

          an integer

          +
          connectionWarningDuration

          an integer

          displayQueuePosition

          a character either 'true' or 'false'

          domainWhiteList

          a LiveChatDeploymentDomainWhitelist

          enablePrechatApi

          a character either 'true' or 'false'

          @@ -6315,13 +6315,13 @@

          Details

          LiveChatDeploymentDomainWhitelist

          -

          Salesforce Documentation for LiveChatDeploymentDomainWhitelist

          +
          domain

          a character

          LiveChatSensitiveDataRule

          -

          Salesforce Documentation for LiveChatSensitiveDataRule

          +
          fullName

          a character (inherited from Metadata)

          actionType

          a SensitiveDataActionType - which is a character taking one of the following values:

            @@ -6329,7 +6329,7 @@

            Details

          • Replace

          description

          a character

          -
          enforceOn

          a integer

          +
          enforceOn

          an integer

          isEnabled

          a character either 'true' or 'false'

          pattern

          a character

          replacement

          a character

          @@ -6337,14 +6337,14 @@

          Details

          LiveMessageSettings

          -

          Salesforce Documentation for LiveMessageSettings

          +
          fullName

          a character (inherited from Metadata)

          enableLiveMessage

          a character either 'true' or 'false'

          LogInfo

          -

          Salesforce Documentation for LogInfo

          +
          category

          a LogCategory - which is a character taking one of the following values:

          • Db

            • @@ -6373,7 +6373,7 @@

            Details

          LookupFilter

          -

          Salesforce Documentation for LookupFilter

          +
          active

          a character either 'true' or 'false'

          booleanFilter

          a character

          description

          a character

          @@ -6385,46 +6385,46 @@

          Details

          LookupFilterTranslation

          -

          Salesforce Documentation for LookupFilterTranslation

          +
          errorMessage

          a character

          informationalMessage

          a character

          MacroSettings

          -

          Salesforce Documentation for MacroSettings

          +
          fullName

          a character (inherited from Metadata)

          enableAdvancedSearch

          a character either 'true' or 'false'

          ManagedTopic

          -

          Salesforce Documentation for ManagedTopic

          +
          fullName

          a character (inherited from Metadata)

          managedTopicType

          a character

          name

          a character

          parentName

          a character

          -
          position

          a integer

          +
          position

          an integer

          topicDescription

          a character

          ManagedTopics

          -

          Salesforce Documentation for ManagedTopics

          +
          fullName

          a character (inherited from Metadata)

          managedTopic

          a ManagedTopic

          MarketingActionSettings

          -

          Salesforce Documentation for MarketingActionSettings

          +
          fullName

          a character (inherited from Metadata)

          enableMarketingAction

          a character either 'true' or 'false'

          MarketingResourceType

          -

          Salesforce Documentation for MarketingResourceType

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          masterLabel

          a character

          @@ -6434,7 +6434,7 @@

          Details

          MatchingRule

          -

          Salesforce Documentation for MatchingRule

          +
          fullName

          a character (inherited from Metadata)

          booleanFilter

          a character

          description

          a character

          @@ -6453,7 +6453,7 @@

          Details

          MatchingRuleItem

          -

          Salesforce Documentation for MatchingRuleItem

          +
          blankValueBehavior

          a BlankValueBehavior - which is a character taking one of the following values:

          • MatchBlanks

            • @@ -6476,27 +6476,27 @@

            Details

          MatchingRules

          -

          Salesforce Documentation for MatchingRules

          +
          fullName

          a character (inherited from Metadata)

          matchingRules

          a MatchingRule

          Metadata

          -

          Salesforce Documentation for Metadata

          +
          fullName

          a character

          MetadataWithContent

          -

          Salesforce Documentation for MetadataWithContent

          +
          fullName

          a character (inherited from Metadata)

          -
          content

          a character formed using RCurl::base64Encode

          +
          content

          a character formed using base64encode

          MilestoneType

          -

          Salesforce Documentation for MilestoneType

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          recurrenceType

          a MilestoneTypeRecurrenceType - which is a character taking one of the following values: @@ -6509,14 +6509,14 @@

          Details

          MiniLayout

          -

          Salesforce Documentation for MiniLayout

          +
          fields

          a character

          relatedLists

          a RelatedListItem

          MobileSettings

          -

          Salesforce Documentation for MobileSettings

          +
          fullName

          a character (inherited from Metadata)

          chatterMobile

          a ChatterMobileSettings

          dashboardMobile

          a DashboardMobileSettings

          @@ -6526,7 +6526,7 @@

          Details

          ModeratedEntityField

          -

          Salesforce Documentation for ModeratedEntityField

          +
          entityName

          a character

          fieldName

          a character

          keywordList

          a character

          @@ -6534,7 +6534,7 @@

          Details

          ModerationRule

          -

          Salesforce Documentation for ModerationRule

          +
          fullName

          a character (inherited from Metadata)

          action

          a ModerationRuleAction - which is a character taking one of the following values:

            @@ -6544,12 +6544,12 @@

            Details

          • Replace

          • Flag

          -
          actionLimit

          a integer

          +
          actionLimit

          an integer

          active

          a character either 'true' or 'false'

          description

          a character

          entitiesAndFields

          a ModeratedEntityField

          masterLabel

          a character

          -
          notifyLimit

          a integer

          +
          notifyLimit

          an integer

          timePeriod

          a RateLimitTimePeriod - which is a character taking one of the following values:

          • Short

            • @@ -6566,7 +6566,7 @@

            Details

          NamedCredential

          -

          Salesforce Documentation for NamedCredential

          +
          fullName

          a character (inherited from Metadata)

          allowMergeFieldsInBody

          a character either 'true' or 'false'

          allowMergeFieldsInHeader

          a character either 'true' or 'false'

          @@ -6596,7 +6596,7 @@

          Details

          NameSettings

          -

          Salesforce Documentation for NameSettings

          +
          fullName

          a character (inherited from Metadata)

          enableMiddleName

          a character either 'true' or 'false'

          enableNameSuffix

          a character either 'true' or 'false'

          @@ -6604,16 +6604,16 @@

          Details

          NavigationLinkSet

          -

          Salesforce Documentation for NavigationLinkSet

          +
          navigationMenuItem

          a NavigationMenuItem

          NavigationMenuItem

          -

          Salesforce Documentation for NavigationMenuItem

          +
          defaultListViewId

          a character

          label

          a character

          -
          position

          a integer

          +
          position

          an integer

          publiclyAvailable

          a character either 'true' or 'false'

          subMenu

          a NavigationSubMenu

          target

          a character

          @@ -6623,13 +6623,13 @@

          Details

          NavigationSubMenu

          -

          Salesforce Documentation for NavigationSubMenu

          +
          navigationMenuItem

          a NavigationMenuItem

          Network

          -

          Salesforce Documentation for Network

          +
          fullName

          a character (inherited from Metadata)

          allowInternalUserLogin

          a character either 'true' or 'false'

          allowMembersToFlag

          a character either 'true' or 'false'

          @@ -6662,7 +6662,7 @@

          Details
          forgotPasswordTemplate

          a character

          gatherCustomerSentimentData

          a character either 'true' or 'false'

          logoutUrl

          a character

          -
          maxFileSizeKb

          a integer

          +
          maxFileSizeKb

          an integer

          navigationLinkSet

          a NavigationLinkSet

          networkMemberGroups

          a NetworkMemberGroup

          networkPageOverrides

          a NetworkPageOverride

          @@ -6689,14 +6689,14 @@

          Details

          NetworkAccess

          -

          Salesforce Documentation for NetworkAccess

          +
          ipRanges

          a IpRange

          NetworkBranding

          -

          Salesforce Documentation for NetworkBranding

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          loginFooterText

          a character

          loginLogo

          a character

          loginLogoName

          a character

          @@ -6720,14 +6720,14 @@

          Details

          NetworkMemberGroup

          -

          Salesforce Documentation for NetworkMemberGroup

          +
          permissionSet

          a character

          profile

          a character

          NetworkPageOverride

          -

          Salesforce Documentation for NetworkPageOverride

          +
          changePasswordPageOverrideSetting

          a NetworkPageOverrideSetting - which is a character taking one of the following values:

          • Designer

            • @@ -6762,7 +6762,7 @@

            Details

          NetworkTabSet

          -

          Salesforce Documentation for NetworkTabSet

          +
          customTab

          a character

          defaultTab

          a character

          standardTab

          a character

          @@ -6770,14 +6770,14 @@

          Details

          NextAutomatedApprover

          -

          Salesforce Documentation for NextAutomatedApprover

          +
          useApproverFieldOfRecordOwner

          a character either 'true' or 'false'

          userHierarchyField

          a character

          ObjectMapping

          -

          Salesforce Documentation for ObjectMapping

          +
          inputObject

          a character

          mappingFields

          a ObjectMappingField

          outputObject

          a character

          @@ -6785,14 +6785,14 @@

          Details

          ObjectMappingField

          -

          Salesforce Documentation for ObjectMappingField

          +
          inputField

          a character

          outputField

          a character

          ObjectNameCaseValue

          -

          Salesforce Documentation for ObjectNameCaseValue

          +
          article

          a Article - which is a character taking one of the following values:

          • None

            • @@ -6844,7 +6844,7 @@

            Details

          ObjectRelationship

          -

          Salesforce Documentation for ObjectRelationship

          +
          join

          a ObjectRelationship

          outerJoin

          a character either 'true' or 'false'

          relationship

          a character

          @@ -6852,41 +6852,41 @@

          Details

          ObjectSearchSetting

          -

          Salesforce Documentation for ObjectSearchSetting

          +
          enhancedLookupEnabled

          a character either 'true' or 'false'

          lookupAutoCompleteEnabled

          a character either 'true' or 'false'

          name

          a character

          -
          resultsPerPageCount

          a integer

          +
          resultsPerPageCount

          an integer

          ObjectUsage

          -

          Salesforce Documentation for ObjectUsage

          +
          object

          a character

          OpportunityListFieldsLabelMapping

          -

          Salesforce Documentation for OpportunityListFieldsLabelMapping

          +
          field

          a character

          label

          a character

          OpportunityListFieldsSelectedSettings

          -

          Salesforce Documentation for OpportunityListFieldsSelectedSettings

          +
          field

          a character

          OpportunityListFieldsUnselectedSettings

          -

          Salesforce Documentation for OpportunityListFieldsUnselectedSettings

          +
          field

          a character

          OpportunitySettings

          -

          Salesforce Documentation for OpportunitySettings

          +
          fullName

          a character (inherited from Metadata)

          autoActivateNewReminders

          a character either 'true' or 'false'

          enableFindSimilarOpportunities

          a character either 'true' or 'false'

          @@ -6898,15 +6898,15 @@

          Details

          Orchestration

          -

          Salesforce Documentation for Orchestration

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          context

          a character

          masterLabel

          a character

          OrchestrationContext

          -

          Salesforce Documentation for OrchestrationContext

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          events

          a OrchestrationContextEvent

          @@ -6918,7 +6918,7 @@

          Details

          OrchestrationContextEvent

          -

          Salesforce Documentation for OrchestrationContextEvent

          +
          eventType

          a character

          orchestrationEvent

          a character

          platformEvent

          a character

          @@ -6927,7 +6927,7 @@

          Details

          OrderSettings

          -

          Salesforce Documentation for OrderSettings

          +
          fullName

          a character (inherited from Metadata)

          enableNegativeQuantity

          a character either 'true' or 'false'

          enableOrders

          a character either 'true' or 'false'

          @@ -6937,21 +6937,21 @@

          Details

          OrganizationSettingsDetail

          -

          Salesforce Documentation for OrganizationSettingsDetail

          +
          settingName

          a character

          settingValue

          a character either 'true' or 'false'

          OrgPreferenceSettings

          -

          Salesforce Documentation for OrgPreferenceSettings

          +
          fullName

          a character (inherited from Metadata)

          preferences

          a OrganizationSettingsDetail

          Package

          -

          Salesforce Documentation for Package

          +
          fullName

          a character (inherited from Metadata)

          apiAccessLevel

          a APIAccessLevel - which is a character taking one of the following values:

            @@ -6971,22 +6971,22 @@

            Details

          PackageTypeMembers

          -

          Salesforce Documentation for PackageTypeMembers

          +
          members

          a character

          name

          a character

          PackageVersion

          -

          Salesforce Documentation for PackageVersion

          -
          majorNumber

          a integer

          -
          minorNumber

          a integer

          +
          +
          majorNumber

          an integer

          +
          minorNumber

          an integer

          namespace

          a character

          PasswordPolicies

          -

          Salesforce Documentation for PasswordPolicies

          +
          apiOnlyUserHomePageURL

          a character

          complexity

          a Complexity - which is a character taking one of the following values:

            @@ -7034,7 +7034,7 @@

            Details

          PathAssistant

          -

          Salesforce Documentation for PathAssistant

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          entityName

          a character

          @@ -7046,14 +7046,14 @@

          Details

          PathAssistantSettings

          -

          Salesforce Documentation for PathAssistantSettings

          +
          fullName

          a character (inherited from Metadata)

          pathAssistantEnabled

          a character either 'true' or 'false'

          PathAssistantStep

          -

          Salesforce Documentation for PathAssistantStep

          +
          fieldNames

          a character

          info

          a character

          picklistValueName

          a character

          @@ -7061,7 +7061,7 @@

          Details

          PermissionSet

          -

          Salesforce Documentation for PermissionSet

          +
          fullName

          a character (inherited from Metadata)

          applicationVisibilities

          a PermissionSetApplicationVisibility

          classAccesses

          a PermissionSetApexClassAccess

          @@ -7081,42 +7081,42 @@

          Details

          PermissionSetApexClassAccess

          -

          Salesforce Documentation for PermissionSetApexClassAccess

          +
          apexClass

          a character

          enabled

          a character either 'true' or 'false'

          PermissionSetApexPageAccess

          -

          Salesforce Documentation for PermissionSetApexPageAccess

          +
          apexPage

          a character

          enabled

          a character either 'true' or 'false'

          PermissionSetApplicationVisibility

          -

          Salesforce Documentation for PermissionSetApplicationVisibility

          +
          application

          a character

          visible

          a character either 'true' or 'false'

          PermissionSetCustomPermissions

          -

          Salesforce Documentation for PermissionSetCustomPermissions

          +
          enabled

          a character either 'true' or 'false'

          name

          a character

          PermissionSetExternalDataSourceAccess

          -

          Salesforce Documentation for PermissionSetExternalDataSourceAccess

          +
          enabled

          a character either 'true' or 'false'

          externalDataSource

          a character

          PermissionSetFieldPermissions

          -

          Salesforce Documentation for PermissionSetFieldPermissions

          +
          editable

          a character either 'true' or 'false'

          field

          a character

          readable

          a character either 'true' or 'false'

          @@ -7124,7 +7124,7 @@

          Details

          PermissionSetGroup

          -

          Salesforce Documentation for PermissionSetGroup

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          isCalculatingChanges

          a character either 'true' or 'false'

          @@ -7134,7 +7134,7 @@

          Details

          PermissionSetObjectPermissions

          -

          Salesforce Documentation for PermissionSetObjectPermissions

          +
          allowCreate

          a character either 'true' or 'false'

          allowDelete

          a character either 'true' or 'false'

          allowEdit

          a character either 'true' or 'false'

          @@ -7146,14 +7146,14 @@

          Details

          PermissionSetRecordTypeVisibility

          -

          Salesforce Documentation for PermissionSetRecordTypeVisibility

          +
          recordType

          a character

          visible

          a character either 'true' or 'false'

          PermissionSetTabSetting

          -

          Salesforce Documentation for PermissionSetTabSetting

          +
          tab

          a character

          visibility

          a PermissionSetTabVisibility - which is a character taking one of the following values:

            @@ -7165,28 +7165,28 @@

            Details

          PermissionSetUserPermission

          -

          Salesforce Documentation for PermissionSetUserPermission

          +
          enabled

          a character either 'true' or 'false'

          name

          a character

          PersonalJourneySettings

          -

          Salesforce Documentation for PersonalJourneySettings

          +
          fullName

          a character (inherited from Metadata)

          enableExactTargetForSalesforceApps

          a character either 'true' or 'false'

          PersonListSettings

          -

          Salesforce Documentation for PersonListSettings

          +
          fullName

          a character (inherited from Metadata)

          enablePersonList

          a character either 'true' or 'false'

          PicklistEntry

          -

          Salesforce Documentation for PicklistEntry

          +
          active

          a character either 'true' or 'false'

          defaultValue

          a character either 'true' or 'false'

          label

          a character

          @@ -7196,7 +7196,7 @@

          Details

          PicklistValue

          -

          Salesforce Documentation for PicklistValue

          +
          color

          a character (inherited from GlobalPicklistValue)

          default

          a character either 'true' or 'false' (inherited from GlobalPicklistValue)

          description

          a character (inherited from GlobalPicklistValue)

          @@ -7215,7 +7215,7 @@

          Details

        • Closed

          • highPriority

          a character either 'true' or 'false'

          -
          probability

          a integer

          +
          probability

          an integer

          reverseRole

          a character

          reviewed

          a character either 'true' or 'false'

          won

          a character either 'true' or 'false'

          @@ -7223,14 +7223,14 @@

          Details

          PicklistValueTranslation

          -

          Salesforce Documentation for PicklistValueTranslation

          +
          masterLabel

          a character

          translation

          a character

          PlatformActionList

          -

          Salesforce Documentation for PlatformActionList

          +
          fullName

          a character (inherited from Metadata)

          actionListContext

          a PlatformActionListContext - which is a character taking one of the following values:

            @@ -7260,7 +7260,7 @@

            Details

          PlatformActionListItem

          -

          Salesforce Documentation for PlatformActionListItem

          +
          actionName

          a character

          actionType

          a PlatformActionType - which is a character taking one of the following values:

            @@ -7271,13 +7271,13 @@

            Details

          • ActionLink

          • InvocableAction

          -
          sortOrder

          a integer

          +
          sortOrder

          an integer

          subtype

          a character

          PlatformCachePartition

          -

          Salesforce Documentation for PlatformCachePartition

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          isDefaultPartition

          a character either 'true' or 'false'

          @@ -7287,10 +7287,10 @@

          Details

          PlatformCachePartitionType

          -

          Salesforce Documentation for PlatformCachePartitionType

          -
          allocatedCapacity

          a integer

          -
          allocatedPurchasedCapacity

          a integer

          -
          allocatedTrialCapacity

          a integer

          +
          +
          allocatedCapacity

          an integer

          +
          allocatedPurchasedCapacity

          an integer

          +
          allocatedTrialCapacity

          an integer

          cacheType

          a PlatformCacheType - which is a character taking one of the following values:

          • Session

            • @@ -7300,7 +7300,7 @@

            Details

          Portal

          -

          Salesforce Documentation for Portal

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          admin

          a character

          @@ -7342,7 +7342,7 @@

          Details

          PostTemplate

          -

          Salesforce Documentation for PostTemplate

          +
          fullName

          a character (inherited from Metadata)

          default

          a character either 'true' or 'false'

          description

          a character

          @@ -7352,13 +7352,13 @@

          Details

          PrimaryTabComponents

          -

          Salesforce Documentation for PrimaryTabComponents

          +
          containers

          a Container

          ProductSettings

          -

          Salesforce Documentation for ProductSettings

          +
          fullName

          a character (inherited from Metadata)

          enableCascadeActivateToRelatedPrices

          a character either 'true' or 'false'

          enableQuantitySchedule

          a character either 'true' or 'false'

          @@ -7367,7 +7367,7 @@

          Details

          Profile

          -

          Salesforce Documentation for Profile

          +
          fullName

          a character (inherited from Metadata)

          applicationVisibilities

          a ProfileApplicationVisibility

          categoryGroupVisibilities

          a ProfileCategoryGroupVisibility

          @@ -7391,7 +7391,7 @@

          Details

          ProfileActionOverride

          -

          Salesforce Documentation for ProfileActionOverride

          +
          actionName

          a character

          content

          a character

          formFactor

          a FormFactor - which is a character taking one of the following values: @@ -7415,21 +7415,21 @@

          Details

          ProfileApexClassAccess

          -

          Salesforce Documentation for ProfileApexClassAccess

          +
          apexClass

          a character

          enabled

          a character either 'true' or 'false'

          ProfileApexPageAccess

          -

          Salesforce Documentation for ProfileApexPageAccess

          +
          apexPage

          a character

          enabled

          a character either 'true' or 'false'

          ProfileApplicationVisibility

          -

          Salesforce Documentation for ProfileApplicationVisibility

          +
          application

          a character

          default

          a character either 'true' or 'false'

          visible

          a character either 'true' or 'false'

          @@ -7437,7 +7437,7 @@

          Details

          ProfileCategoryGroupVisibility

          -

          Salesforce Documentation for ProfileCategoryGroupVisibility

          +
          dataCategories

          a character

          dataCategoryGroup

          a character

          visibility

          a CategoryGroupVisibility - which is a character taking one of the following values: @@ -7450,21 +7450,21 @@

          Details

          ProfileCustomPermissions

          -

          Salesforce Documentation for ProfileCustomPermissions

          +
          enabled

          a character either 'true' or 'false'

          name

          a character

          ProfileExternalDataSourceAccess

          -

          Salesforce Documentation for ProfileExternalDataSourceAccess

          +
          enabled

          a character either 'true' or 'false'

          externalDataSource

          a character

          ProfileFieldLevelSecurity

          -

          Salesforce Documentation for ProfileFieldLevelSecurity

          +
          editable

          a character either 'true' or 'false'

          field

          a character

          readable

          a character either 'true' or 'false'

          @@ -7472,14 +7472,14 @@

          Details

          ProfileLayoutAssignment

          -

          Salesforce Documentation for ProfileLayoutAssignment

          +
          layout

          a character

          recordType

          a character

          ProfileLoginHours

          -

          Salesforce Documentation for ProfileLoginHours

          +
          fridayEnd

          a character

          fridayStart

          a character

          mondayEnd

          a character

          @@ -7498,7 +7498,7 @@

          Details

          ProfileLoginIpRange

          -

          Salesforce Documentation for ProfileLoginIpRange

          +
          description

          a character

          endAddress

          a character

          startAddress

          a character

          @@ -7506,7 +7506,7 @@

          Details

          ProfileObjectPermissions

          -

          Salesforce Documentation for ProfileObjectPermissions

          +
          allowCreate

          a character either 'true' or 'false'

          allowDelete

          a character either 'true' or 'false'

          allowEdit

          a character either 'true' or 'false'

          @@ -7518,23 +7518,23 @@

          Details

          ProfilePasswordPolicy

          -

          Salesforce Documentation for ProfilePasswordPolicy

          +
          fullName

          a character (inherited from Metadata)

          -
          lockoutInterval

          a integer

          -
          maxLoginAttempts

          a integer

          -
          minimumPasswordLength

          a integer

          +
          lockoutInterval

          an integer

          +
          maxLoginAttempts

          an integer

          +
          minimumPasswordLength

          an integer

          minimumPasswordLifetime

          a character either 'true' or 'false'

          obscure

          a character either 'true' or 'false'

          -
          passwordComplexity

          a integer

          -
          passwordExpiration

          a integer

          -
          passwordHistory

          a integer

          -
          passwordQuestion

          a integer

          +
          passwordComplexity

          an integer

          +
          passwordExpiration

          an integer

          +
          passwordHistory

          an integer

          +
          passwordQuestion

          an integer

          profile

          a character

          ProfileRecordTypeVisibility

          -

          Salesforce Documentation for ProfileRecordTypeVisibility

          +
          default

          a character either 'true' or 'false'

          personAccountDefault

          a character either 'true' or 'false'

          recordType

          a character

          @@ -7543,7 +7543,7 @@

          Details

          ProfileSessionSetting

          -

          Salesforce Documentation for ProfileSessionSetting

          +
          fullName

          a character (inherited from Metadata)

          externalCommunityUserIdentityVerif

          a character either 'true' or 'false'

          forceLogout

          a character either 'true' or 'false'

          @@ -7555,13 +7555,13 @@

          Details

        • HIGH_ASSURANCE

          • sessionPersistence

          a character either 'true' or 'false'

          -
          sessionTimeout

          a integer

          +
          sessionTimeout

          an integer

          sessionTimeoutWarning

          a character either 'true' or 'false'

          ProfileTabVisibility

          -

          Salesforce Documentation for ProfileTabVisibility

          +
          tab

          a character

          visibility

          a TabVisibility - which is a character taking one of the following values:

            @@ -7573,27 +7573,27 @@

            Details

          ProfileUserPermission

          -

          Salesforce Documentation for ProfileUserPermission

          +
          enabled

          a character either 'true' or 'false'

          name

          a character

          PublicGroups

          -

          Salesforce Documentation for PublicGroups

          +
          publicGroup

          a character

          PushNotification

          -

          Salesforce Documentation for PushNotification

          +
          fieldNames

          a character

          objectName

          a character

          Queue

          -

          Salesforce Documentation for Queue

          +
          fullName

          a character (inherited from Metadata)

          doesSendEmailToMembers

          a character either 'true' or 'false'

          email

          a character

          @@ -7605,7 +7605,7 @@

          Details

          QueueMembers

          -

          Salesforce Documentation for QueueMembers

          +
          publicGroups

          a PublicGroups

          roleAndSubordinates

          a RoleAndSubordinates

          roleAndSubordinatesInternal

          a RoleAndSubordinatesInternal

          @@ -7615,19 +7615,19 @@

          Details

          QueueSobject

          -

          Salesforce Documentation for QueueSobject

          +
          sobjectType

          a character

          QuickAction

          -

          Salesforce Documentation for QuickAction

          +
          fullName

          a character (inherited from Metadata)

          canvas

          a character

          description

          a character

          fieldOverrides

          a FieldOverride

          flowDefinition

          a character

          -
          height

          a integer

          +
          height

          an integer

          icon

          a character

          isProtected

          a character either 'true' or 'false'

          label

          a character

          @@ -7683,12 +7683,12 @@

          Details

        • LightningComponent

        • Flow

          • -
          width

          a integer

          +
          width

          an integer

          QuickActionLayout

          -

          Salesforce Documentation for QuickActionLayout

          +
          layoutSectionStyle

          a LayoutSectionStyle - which is a character taking one of the following values:

          • TwoColumnsTopToBottom

            • @@ -7701,13 +7701,13 @@

            Details

          QuickActionLayoutColumn

          -

          Salesforce Documentation for QuickActionLayoutColumn

          +
          quickActionLayoutItems

          a QuickActionLayoutItem

          QuickActionLayoutItem

          -

          Salesforce Documentation for QuickActionLayoutItem

          +
          emptySpace

          a character either 'true' or 'false'

          field

          a character

          uiBehavior

          a UiBehavior - which is a character taking one of the following values: @@ -7720,52 +7720,52 @@

          Details

          QuickActionList

          -

          Salesforce Documentation for QuickActionList

          +
          quickActionListItems

          a QuickActionListItem

          QuickActionListItem

          -

          Salesforce Documentation for QuickActionListItem

          +
          quickActionName

          a character

          QuickActionSendEmailOptions

          -

          Salesforce Documentation for QuickActionSendEmailOptions

          +
          defaultEmailTemplateName

          a character

          ignoreDefaultEmailTemplateSubject

          a character either 'true' or 'false'

          QuickActionTranslation

          -

          Salesforce Documentation for QuickActionTranslation

          +
          label

          a character

          name

          a character

          QuotasSettings

          -

          Salesforce Documentation for QuotasSettings

          +
          showQuotas

          a character either 'true' or 'false'

          QuoteSettings

          -

          Salesforce Documentation for QuoteSettings

          +
          fullName

          a character (inherited from Metadata)

          enableQuote

          a character either 'true' or 'false'

          RecommendationAudience

          -

          Salesforce Documentation for RecommendationAudience

          +
          recommendationAudienceDetails

          a RecommendationAudienceDetail

          RecommendationAudienceDetail

          -

          Salesforce Documentation for RecommendationAudienceDetail

          +
          audienceCriteriaType

          a AudienceCriteriaType - which is a character taking one of the following values:

          • CustomList

            • @@ -7777,13 +7777,13 @@

            Details

          RecommendationDefinition

          -

          Salesforce Documentation for RecommendationDefinition

          +
          recommendationDefinitionDetails

          a RecommendationDefinitionDetail

          RecommendationDefinitionDetail

          -

          Salesforce Documentation for RecommendationDefinitionDetail

          +
          actionUrl

          a character

          description

          a character

          linkText

          a character

          @@ -7794,7 +7794,7 @@

          Details

          RecommendationStrategy

          -

          Salesforce Documentation for RecommendationStrategy

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          masterLabel

          a character

          @@ -7804,7 +7804,7 @@

          Details

          RecordType

          -

          Salesforce Documentation for RecordType

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          businessProcess

          a character

          @@ -7816,14 +7816,14 @@

          Details

          RecordTypePicklistValue

          -

          Salesforce Documentation for RecordTypePicklistValue

          +
          picklist

          a character

          values

          a PicklistValue

          RecordTypeTranslation

          -

          Salesforce Documentation for RecordTypeTranslation

          +
          description

          a character

          label

          a character

          name

          a character

          @@ -7831,26 +7831,26 @@

          Details

          RelatedContent

          -

          Salesforce Documentation for RelatedContent

          +
          relatedContentItems

          a RelatedContentItem

          RelatedContentItem

          -

          Salesforce Documentation for RelatedContentItem

          +
          layoutItem

          a LayoutItem

          RelatedList

          -

          Salesforce Documentation for RelatedList

          +
          hideOnDetail

          a character either 'true' or 'false'

          name

          a character

          RelatedListItem

          -

          Salesforce Documentation for RelatedListItem

          +
          customButtons

          a character

          excludeButtons

          a character

          fields

          a character

          @@ -7865,7 +7865,7 @@

          Details

          RemoteSiteSetting

          -

          Salesforce Documentation for RemoteSiteSetting

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          disableProtocolSecurity

          a character either 'true' or 'false'

          @@ -7875,7 +7875,7 @@

          Details

          Report

          -

          Salesforce Documentation for Report

          +
          fullName

          a character (inherited from Metadata)

          aggregates

          a ReportAggregate

          block

          a Report

          @@ -8111,11 +8111,11 @@

          Details
          groupingsDown

          a ReportGrouping

          historicalSelector

          a ReportHistoricalSelector

          name

          a character

          -
          numSubscriptions

          a integer

          +
          numSubscriptions

          an integer

          params

          a ReportParam

          reportType

          a character

          roleHierarchyFilter

          a character

          -
          rowLimit

          a integer

          +
          rowLimit

          an integer

          scope

          a character

          showCurrentDate

          a character either 'true' or 'false'

          showDetails

          a character either 'true' or 'false'

          @@ -8132,7 +8132,7 @@

          Details

          ReportAggregate

          -

          Salesforce Documentation for ReportAggregate

          +
          acrossGroupingContext

          a character

          calculatedFormula

          a character

          datatype

          a ReportAggregateDatatype - which is a character taking one of the following values: @@ -8148,18 +8148,18 @@

          Details
          isCrossBlock

          a character either 'true' or 'false'

          masterLabel

          a character

          reportType

          a character

          -
          scale

          a integer

          +
          scale

          an integer

          ReportAggregateReference

          -

          Salesforce Documentation for ReportAggregateReference

          +
          aggregate

          a character

          ReportBlockInfo

          -

          Salesforce Documentation for ReportBlockInfo

          +
          aggregateReferences

          a ReportAggregateReference

          blockId

          a character

          joinTable

          a character

          @@ -8167,7 +8167,7 @@

          Details

          ReportBucketField

          -

          Salesforce Documentation for ReportBucketField

          +
          bucketType

          a ReportBucketFieldType - which is a character taking one of the following values:

          • text

            • @@ -8189,7 +8189,7 @@

            Details

          ReportBucketFieldSourceValue

          -

          Salesforce Documentation for ReportBucketFieldSourceValue

          +
          from

          a character

          sourceValue

          a character

          to

          a character

          @@ -8197,14 +8197,14 @@

          Details

          ReportBucketFieldValue

          -

          Salesforce Documentation for ReportBucketFieldValue

          +
          sourceValues

          a ReportBucketFieldSourceValue

          value

          a character

          ReportChart

          -

          Salesforce Documentation for ReportChart

          +
          backgroundColor1

          a character

          backgroundColor2

          a character

          backgroundFadeDir

          a ChartBackgroundDirection - which is a character taking one of the following values: @@ -8276,15 +8276,15 @@

          Details

        • Manual

          • textColor

          a character

          -
          textSize

          a integer

          +
          textSize

          an integer

          title

          a character

          titleColor

          a character

          -
          titleSize

          a integer

          +
          titleSize

          an integer

          ReportChartComponentLayoutItem

          -

          Salesforce Documentation for ReportChartComponentLayoutItem

          +
          cacheData

          a character either 'true' or 'false'

          contextFilterableField

          a character

          error

          a character

          @@ -8302,7 +8302,7 @@

          Details

          ReportColorRange

          -

          Salesforce Documentation for ReportColorRange

          +
          aggregate

          a ReportSummaryType - which is a character taking one of the following values:

          • Sum

            • @@ -8321,7 +8321,7 @@

            Details

          ReportColumn

          -

          Salesforce Documentation for ReportColumn

          +
          aggregateTypes

          a ReportSummaryType - which is a character taking one of the following values:

          • Sum

            • @@ -8337,7 +8337,7 @@

            Details

          ReportCrossFilter

          -

          Salesforce Documentation for ReportCrossFilter

          +
          criteriaItems

          a ReportFilterItem

          operation

          a ObjectFilterOperator - which is a character taking one of the following values:

            @@ -8351,7 +8351,7 @@

            Details

          ReportDataCategoryFilter

          -

          Salesforce Documentation for ReportDataCategoryFilter

          +
          dataCategory

          a character

          dataCategoryGroup

          a character

          operator

          a DataCategoryFilterOperation - which is a character taking one of the following values: @@ -8365,7 +8365,7 @@

          Details

          ReportFilter

          -

          Salesforce Documentation for ReportFilter

          +
          booleanFilter

          a character

          criteriaItems

          a ReportFilterItem

          language

          a Language - which is a character taking one of the following values: @@ -8494,7 +8494,7 @@

          Details

          ReportFilterItem

          -

          Salesforce Documentation for ReportFilterItem

          +
          column

          a character

          columnToColumn

          a character either 'true' or 'false'

          isUnlocked

          a character either 'true' or 'false'

          @@ -8519,7 +8519,7 @@

          Details

          ReportFolder

          -

          Salesforce Documentation for ReportFolder

          +
          accessType

          a FolderAccessTypes (inherited from Folder)

          folderShares

          a FolderShare (inherited from Folder)

          name

          a character (inherited from Folder)

          @@ -8529,7 +8529,7 @@

          Details

          ReportGrouping

          -

          Salesforce Documentation for ReportGrouping

          +
          aggregateType

          a ReportAggrType - which is a character taking one of the following values:

          • Sum

            • @@ -8570,27 +8570,27 @@

            Details

          ReportHistoricalSelector

          -

          Salesforce Documentation for ReportHistoricalSelector

          +
          snapshot

          a character

          ReportLayoutSection

          -

          Salesforce Documentation for ReportLayoutSection

          +
          columns

          a ReportTypeColumn

          masterLabel

          a character

          ReportParam

          -

          Salesforce Documentation for ReportParam

          +
          name

          a character

          value

          a character

          ReportTimeFrameFilter

          -

          Salesforce Documentation for ReportTimeFrameFilter

          +
          dateColumn

          a character

          endDate

          a character formatted as 'yyyy-mm-dd'

          interval

          a UserDateInterval - which is a character taking one of the following values: @@ -8665,7 +8665,7 @@

          Details

          ReportType

          -

          Salesforce Documentation for ReportType

          +
          fullName

          a character (inherited from Metadata)

          autogenerated

          a character either 'true' or 'false'

          baseObject

          a character

          @@ -8698,7 +8698,7 @@

          Details

          ReportTypeColumn

          -

          Salesforce Documentation for ReportTypeColumn

          +
          checkedByDefault

          a character either 'true' or 'false'

          displayNameOverride

          a character

          field

          a character

          @@ -8707,14 +8707,14 @@

          Details

          ReportTypeColumnTranslation

          -

          Salesforce Documentation for ReportTypeColumnTranslation

          +
          label

          a character

          name

          a character

          ReportTypeSectionTranslation

          -

          Salesforce Documentation for ReportTypeSectionTranslation

          +
          columns

          a ReportTypeColumnTranslation

          label

          a character

          name

          a character

          @@ -8722,7 +8722,7 @@

          Details

          ReportTypeTranslation

          -

          Salesforce Documentation for ReportTypeTranslation

          +
          description

          a character

          label

          a character

          name

          a character

          @@ -8731,13 +8731,13 @@

          Details

          ReputationBranding

          -

          Salesforce Documentation for ReputationBranding

          +
          smallImage

          a character

          ReputationLevel

          -

          Salesforce Documentation for ReputationLevel

          +
          branding

          a ReputationBranding

          label

          a character

          lowerThreshold

          a numeric

          @@ -8745,33 +8745,33 @@

          Details

          ReputationLevelDefinitions

          -

          Salesforce Documentation for ReputationLevelDefinitions

          +
          level

          a ReputationLevel

          ReputationLevels

          -

          Salesforce Documentation for ReputationLevels

          +
          chatterAnswersReputationLevels

          a ChatterAnswersReputationLevel

          ideaReputationLevels

          a IdeaReputationLevel

          ReputationPointsRule

          -

          Salesforce Documentation for ReputationPointsRule

          +
          eventType

          a character

          -
          points

          a integer

          +
          points

          an integer

          ReputationPointsRules

          -

          Salesforce Documentation for ReputationPointsRules

          +
          pointsRule

          a ReputationPointsRule

          RetrieveRequest

          -

          Salesforce Documentation for RetrieveRequest

          +
          apiVersion

          a numeric

          packageNames

          a character

          singlePackage

          a character either 'true' or 'false'

          @@ -8781,7 +8781,7 @@

          Details

          Role

          -

          Salesforce Documentation for Role

          +
          caseAccessLevel

          a character (inherited from RoleOrTerritory)

          contactAccessLevel

          a character (inherited from RoleOrTerritory)

          description

          a character (inherited from RoleOrTerritory)

          @@ -8793,19 +8793,19 @@

          Details

          RoleAndSubordinates

          -

          Salesforce Documentation for RoleAndSubordinates

          +
          roleAndSubordinate

          a character

          RoleAndSubordinatesInternal

          -

          Salesforce Documentation for RoleAndSubordinatesInternal

          +
          roleAndSubordinateInternal

          a character

          RoleOrTerritory

          -

          Salesforce Documentation for RoleOrTerritory

          +
          fullName

          a character (inherited from Metadata)

          caseAccessLevel

          a character

          contactAccessLevel

          a character

          @@ -8817,13 +8817,13 @@

          Details

          Roles

          -

          Salesforce Documentation for Roles

          +
          role

          a character

          RuleEntry

          -

          Salesforce Documentation for RuleEntry

          +
          assignedTo

          a character

          assignedToType

          a AssignToLookupValueType - which is a character taking one of the following values:

            @@ -8858,7 +8858,7 @@

            Details

          SamlSsoConfig

          -

          Salesforce Documentation for SamlSsoConfig

          +
          fullName

          a character (inherited from Metadata)

          attributeName

          a character

          attributeNameIdFormat

          a character

          @@ -8904,13 +8904,13 @@

          Details

          ScheduledRecommendation

          -

          Salesforce Documentation for ScheduledRecommendation

          +
          scheduledRecommendationDetails

          a ScheduledRecommendationDetail

          ScheduledRecommendationDetail

          -

          Salesforce Documentation for ScheduledRecommendationDetail

          +
          channel

          a RecommendationChannel - which is a character taking one of the following values:

          • DefaultChannel

            • @@ -8921,14 +8921,14 @@

            Details

          • CustomChannel5

          enabled

          a character either 'true' or 'false'

          -
          rank

          a integer

          +
          rank

          an integer

          recommendationAudience

          a character

          Scontrol

          -

          Salesforce Documentation for Scontrol

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          contentSource

          a SControlContentSource - which is a character taking one of the following values:

          • HTML

            • @@ -8949,7 +8949,7 @@

            Details

          • Big5-HKSCS

          • x-SJIS_0213

          -
          fileContent

          a character formed using RCurl::base64Encode

          +
          fileContent

          a character formed using base64encode

          fileName

          a character

          name

          a character

          supportsCaching

          a character either 'true' or 'false'

          @@ -8957,14 +8957,14 @@

          Details

          ScontrolTranslation

          -

          Salesforce Documentation for ScontrolTranslation

          +
          label

          a character

          name

          a character

          SearchLayouts

          -

          Salesforce Documentation for SearchLayouts

          +
          customTabListAdditionalFields

          a character

          excludedStandardButtons

          a character

          listViewButtons

          a character

          @@ -8978,7 +8978,7 @@

          Details

          SearchSettings

          -

          Salesforce Documentation for SearchSettings

          +
          fullName

          a character (inherited from Metadata)

          documentContentSearchEnabled

          a character either 'true' or 'false'

          optimizeSearchForCJKEnabled

          a character either 'true' or 'false'

          @@ -8993,13 +8993,13 @@

          Details

          SearchSettingsByObject

          -

          Salesforce Documentation for SearchSettingsByObject

          +
          searchSettingsByObject

          a ObjectSearchSetting

          SecuritySettings

          -

          Salesforce Documentation for SecuritySettings

          +
          fullName

          a character (inherited from Metadata)

          networkAccess

          a NetworkAccess

          passwordPolicies

          a PasswordPolicies

          @@ -9008,7 +9008,7 @@

          Details

          ServiceCloudConsoleConfig

          -

          Salesforce Documentation for ServiceCloudConsoleConfig

          +
          componentList

          a AppComponentList

          detailPageRefreshMethod

          a character

          footerColor

          a character

          @@ -9025,7 +9025,7 @@

          Details

          SessionSettings

          -

          Salesforce Documentation for SessionSettings

          +
          disableTimeoutWarning

          a character either 'true' or 'false'

          enableCSPOnEmail

          a character either 'true' or 'false'

          enableCSRFOnGet

          a character either 'true' or 'false'

          @@ -9069,14 +9069,14 @@

          Details

          SFDCMobileSettings

          -

          Salesforce Documentation for SFDCMobileSettings

          +
          enableMobileLite

          a character either 'true' or 'false'

          enableUserToDeviceLinking

          a character either 'true' or 'false'

          SharedTo

          -

          Salesforce Documentation for SharedTo

          +
          allCustomerPortalUsers

          a character

          allInternalUsers

          a character

          allPartnerUsers

          a character

          @@ -9102,7 +9102,7 @@

          Details

          SharingBaseRule

          -

          Salesforce Documentation for SharingBaseRule

          +
          fullName

          a character (inherited from Metadata)

          accessLevel

          a character

          accountSettings

          a AccountSharingRuleSettings

          @@ -9113,7 +9113,7 @@

          Details

          SharingCriteriaRule

          -

          Salesforce Documentation for SharingCriteriaRule

          +
          accessLevel

          a character (inherited from SharingBaseRule)

          accountSettings

          a AccountSharingRuleSettings (inherited from SharingBaseRule)

          description

          a character (inherited from SharingBaseRule)

          @@ -9125,7 +9125,7 @@

          Details

          SharingOwnerRule

          -

          Salesforce Documentation for SharingOwnerRule

          +
          accessLevel

          a character (inherited from SharingBaseRule)

          accountSettings

          a AccountSharingRuleSettings (inherited from SharingBaseRule)

          description

          a character (inherited from SharingBaseRule)

          @@ -9136,27 +9136,27 @@

          Details

          SharingReason

          -

          Salesforce Documentation for SharingReason

          +
          fullName

          a character (inherited from Metadata)

          label

          a character

          SharingReasonTranslation

          -

          Salesforce Documentation for SharingReasonTranslation

          +
          label

          a character

          name

          a character

          SharingRecalculation

          -

          Salesforce Documentation for SharingRecalculation

          +
          className

          a character

          SharingRules

          -

          Salesforce Documentation for SharingRules

          +
          fullName

          a character (inherited from Metadata)

          sharingCriteriaRules

          a SharingCriteriaRule

          sharingOwnerRules

          a SharingOwnerRule

          @@ -9165,7 +9165,7 @@

          Details

          SharingSet

          -

          Salesforce Documentation for SharingSet

          +
          fullName

          a character (inherited from Metadata)

          accessMappings

          a AccessMapping

          description

          a character

          @@ -9175,30 +9175,30 @@

          Details

          SharingTerritoryRule

          -

          Salesforce Documentation for SharingTerritoryRule

          +
          sharedFrom

          a SharedTo (inherited from SharingOwnerRule)

          SidebarComponent

          -

          Salesforce Documentation for SidebarComponent

          +
          componentType

          a character

          createAction

          a character

          enableLinking

          a character either 'true' or 'false'

          -
          height

          a integer

          +
          height

          an integer

          label

          a character

          lookup

          a character

          page

          a character

          relatedLists

          a RelatedList

          unit

          a character

          updateAction

          a character

          -
          width

          a integer

          +
          width

          an integer

          SiteDotCom

          -

          Salesforce Documentation for SiteDotCom

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          label

          a character

          siteType

          a SiteType - which is a character taking one of the following values:

            @@ -9210,7 +9210,7 @@

            Details

          SiteRedirectMapping

          -

          Salesforce Documentation for SiteRedirectMapping

          +
          action

          a SiteRedirect - which is a character taking one of the following values:

          • Permanent

            • @@ -9223,7 +9223,7 @@

            Details

          SiteWebAddress

          -

          Salesforce Documentation for SiteWebAddress

          +
          certificate

          a character

          domainName

          a character

          primary

          a character either 'true' or 'false'

          @@ -9231,7 +9231,7 @@

          Details

          Skill

          -

          Salesforce Documentation for Skill

          +
          fullName

          a character (inherited from Metadata)

          assignments

          a SkillAssignments

          description

          a character

          @@ -9240,26 +9240,26 @@

          Details

          SkillAssignments

          -

          Salesforce Documentation for SkillAssignments

          +
          profiles

          a SkillProfileAssignments

          users

          a SkillUserAssignments

          SkillProfileAssignments

          -

          Salesforce Documentation for SkillProfileAssignments

          +
          profile

          a character

          SkillUserAssignments

          -

          Salesforce Documentation for SkillUserAssignments

          +
          user

          a character

          SocialCustomerServiceSettings

          -

          Salesforce Documentation for SocialCustomerServiceSettings

          +
          fullName

          a character (inherited from Metadata)

          caseSubjectOption

          a CaseSubjectOption - which is a character taking one of the following values:

            @@ -9271,14 +9271,14 @@

            Details

          StandardFieldTranslation

          -

          Salesforce Documentation for StandardFieldTranslation

          +
          label

          a character

          name

          a character

          StandardValue

          -

          Salesforce Documentation for StandardValue

          +
          color

          a character (inherited from CustomValue)

          default

          a character either 'true' or 'false' (inherited from CustomValue)

          description

          a character (inherited from CustomValue)

          @@ -9298,7 +9298,7 @@

          Details

          groupingString

          a character

          highPriority

          a character either 'true' or 'false'

          -
          probability

          a integer

          +
          probability

          an integer

          reverseRole

          a character

          reviewed

          a character either 'true' or 'false'

          won

          a character either 'true' or 'false'

          @@ -9306,7 +9306,7 @@

          Details

          StandardValueSet

          -

          Salesforce Documentation for StandardValueSet

          +
          fullName

          a character (inherited from Metadata)

          groupingStringEnum

          a character

          sorted

          a character either 'true' or 'false'

          @@ -9315,14 +9315,14 @@

          Details

          StandardValueSetTranslation

          -

          Salesforce Documentation for StandardValueSetTranslation

          +
          fullName

          a character (inherited from Metadata)

          valueTranslation

          a ValueTranslation

          State

          -

          Salesforce Documentation for State

          +
          active

          a character either 'true' or 'false'

          integrationValue

          a character

          isoCode

          a character

          @@ -9333,8 +9333,8 @@

          Details

          StaticResource

          -

          Salesforce Documentation for StaticResource

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          cacheControl

          a StaticResourceCacheControl - which is a character taking one of the following values:

          • Private

            • @@ -9346,27 +9346,27 @@

            Details

          StrategyNode

          -

          Salesforce Documentation for StrategyNode

          +
          definition

          a character

          description

          a character

          name

          a character

          parentNode

          a character

          -
          type

          a integer

          +
          type

          an integer

          SubtabComponents

          -

          Salesforce Documentation for SubtabComponents

          +
          containers

          a Container

          SummaryLayout

          -

          Salesforce Documentation for SummaryLayout

          +
          masterLabel

          a character

          -
          sizeX

          a integer

          -
          sizeY

          a integer

          -
          sizeZ

          a integer

          +
          sizeX

          an integer

          +
          sizeY

          an integer

          +
          sizeZ

          an integer

          summaryLayoutItems

          a SummaryLayoutItem

          summaryLayoutStyle

          a SummaryLayoutStyle - which is a character taking one of the following values:

            @@ -9385,23 +9385,23 @@

            Details

          SummaryLayoutItem

          -

          Salesforce Documentation for SummaryLayoutItem

          +
          customLink

          a character

          field

          a character

          -
          posX

          a integer

          -
          posY

          a integer

          -
          posZ

          a integer

          +
          posX

          an integer

          +
          posY

          an integer

          +
          posZ

          an integer

          SupervisorAgentConfigSkills

          -

          Salesforce Documentation for SupervisorAgentConfigSkills

          +
          skill

          a character

          SynonymDictionary

          -

          Salesforce Documentation for SynonymDictionary

          +
          fullName

          a character (inherited from Metadata)

          groups

          a SynonymGroup

          isProtected

          a character either 'true' or 'false'

          @@ -9410,7 +9410,7 @@

          Details

          SynonymGroup

          -

          Salesforce Documentation for SynonymGroup

          +
          languages

          a Language - which is a character taking one of the following values:

          • en_US

            • @@ -9538,14 +9538,14 @@

            Details

          TabLimitConfig

          -

          Salesforce Documentation for TabLimitConfig

          +
          maxNumberOfPrimaryTabs

          a character

          maxNumberOfSubTabs

          a character

          Territory

          -

          Salesforce Documentation for Territory

          +
          caseAccessLevel

          a character (inherited from RoleOrTerritory)

          contactAccessLevel

          a character (inherited from RoleOrTerritory)

          description

          a character (inherited from RoleOrTerritory)

          @@ -9558,7 +9558,7 @@

          Details

          Territory2

          -

          Salesforce Documentation for Territory2

          +
          fullName

          a character (inherited from Metadata)

          accountAccessLevel

          a character

          caseAccessLevel

          a character

          @@ -9574,7 +9574,7 @@

          Details

          Territory2Model

          -

          Salesforce Documentation for Territory2Model

          +
          fullName

          a character (inherited from Metadata)

          customFields

          a FieldValue

          description

          a character

          @@ -9583,7 +9583,7 @@

          Details

          Territory2Rule

          -

          Salesforce Documentation for Territory2Rule

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          booleanFilter

          a character

          @@ -9594,14 +9594,14 @@

          Details

          Territory2RuleAssociation

          -

          Salesforce Documentation for Territory2RuleAssociation

          +
          inherited

          a character either 'true' or 'false'

          ruleName

          a character

          Territory2RuleItem

          -

          Salesforce Documentation for Territory2RuleItem

          +
          field

          a character

          operation

          a FilterOperation - which is a character taking one of the following values:

            @@ -9623,7 +9623,7 @@

            Details

          Territory2Settings

          -

          Salesforce Documentation for Territory2Settings

          +
          fullName

          a character (inherited from Metadata)

          defaultAccountAccessLevel

          a character

          defaultCaseAccessLevel

          a character

          @@ -9634,7 +9634,7 @@

          Details

          Territory2SettingsOpportunityFilter

          -

          Salesforce Documentation for Territory2SettingsOpportunityFilter

          +
          apexClassName

          a character

          enableFilter

          a character either 'true' or 'false'

          runOnCreate

          a character either 'true' or 'false'

          @@ -9642,16 +9642,16 @@

          Details

          Territory2Type

          -

          Salesforce Documentation for Territory2Type

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          name

          a character

          -
          priority

          a integer

          +
          priority

          an integer

          TopicsForObjects

          -

          Salesforce Documentation for TopicsForObjects

          +
          fullName

          a character (inherited from Metadata)

          enableTopics

          a character either 'true' or 'false'

          entityApiName

          a character

          @@ -9659,7 +9659,7 @@

          Details

          TouchMobileSettings

          -

          Salesforce Documentation for TouchMobileSettings

          +
          enableTouchAppIPad

          a character either 'true' or 'false'

          enableTouchAppIPhone

          a character either 'true' or 'false'

          enableTouchBrowserIPad

          a character either 'true' or 'false'

          @@ -9669,7 +9669,7 @@

          Details

          TransactionSecurityAction

          -

          Salesforce Documentation for TransactionSecurityAction

          +
          block

          a character either 'true' or 'false'

          endSession

          a character either 'true' or 'false'

          freezeUser

          a character either 'true' or 'false'

          @@ -9679,7 +9679,7 @@

          Details

          TransactionSecurityNotification

          -

          Salesforce Documentation for TransactionSecurityNotification

          +
          inApp

          a character either 'true' or 'false'

          sendEmail

          a character either 'true' or 'false'

          user

          a character

          @@ -9687,7 +9687,7 @@

          Details

          TransactionSecurityPolicy

          -

          Salesforce Documentation for TransactionSecurityPolicy

          +
          fullName

          a character (inherited from Metadata)

          action

          a TransactionSecurityAction

          active

          a character either 'true' or 'false'

          @@ -9722,7 +9722,7 @@

          Details

          Translations

          -

          Salesforce Documentation for Translations

          +
          fullName

          a character (inherited from Metadata)

          customApplications

          a CustomApplicationTranslation

          customDataTypeTranslations

          a CustomDataTypeTranslation

          @@ -9737,7 +9737,7 @@

          Details

          UiFormulaCriterion

          -

          Salesforce Documentation for UiFormulaCriterion

          +
          leftValue

          a character

          operator

          a character

          rightValue

          a character

          @@ -9745,15 +9745,15 @@

          Details

          UiFormulaRule

          -

          Salesforce Documentation for UiFormulaRule

          +
          booleanFilter

          a character

          criteria

          a UiFormulaCriterion

          UiPlugin

          -

          Salesforce Documentation for UiPlugin

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          description

          a character

          extensionPointIdentifier

          a character

          isEnabled

          a character either 'true' or 'false'

          @@ -9763,11 +9763,11 @@

          Details

          UserCriteria

          -

          Salesforce Documentation for UserCriteria

          +
          fullName

          a character (inherited from Metadata)

          -
          creationAgeInSeconds

          a integer

          +
          creationAgeInSeconds

          an integer

          description

          a character

          -
          lastChatterActivityAgeInSeconds

          a integer

          +
          lastChatterActivityAgeInSeconds

          an integer

          masterLabel

          a character

          profiles

          a character

          userTypes

          a NetworkUserType - which is a character taking one of the following values: @@ -9780,13 +9780,13 @@

          Details

          Users

          -

          Salesforce Documentation for Users

          +
          user

          a character

          ValidationRule

          -

          Salesforce Documentation for ValidationRule

          +
          fullName

          a character (inherited from Metadata)

          active

          a character either 'true' or 'false'

          description

          a character

          @@ -9797,14 +9797,14 @@

          Details

          ValidationRuleTranslation

          -

          Salesforce Documentation for ValidationRuleTranslation

          +
          errorMessage

          a character

          name

          a character

          ValueSet

          -

          Salesforce Documentation for ValueSet

          +
          controllingField

          a character

          restricted

          a character either 'true' or 'false'

          valueSetDefinition

          a ValueSetValuesDefinition

          @@ -9814,33 +9814,33 @@

          Details

          ValueSettings

          -

          Salesforce Documentation for ValueSettings

          +
          controllingFieldValue

          a character

          valueName

          a character

          ValueSetValuesDefinition

          -

          Salesforce Documentation for ValueSetValuesDefinition

          +
          sorted

          a character either 'true' or 'false'

          value

          a CustomValue

          ValueTranslation

          -

          Salesforce Documentation for ValueTranslation

          +
          masterLabel

          a character

          translation

          a character

          ValueTypeField

          -

          Salesforce Documentation for ValueTypeField

          +
          fields

          a ValueTypeField

          foreignKeyDomain

          a character

          isForeignKey

          a character either 'true' or 'false'

          isNameField

          a character either 'true' or 'false'

          -
          minOccurs

          a integer

          +
          minOccurs

          an integer

          name

          a character

          picklistValues

          a PicklistEntry

          soapType

          a character

          @@ -9849,7 +9849,7 @@

          Details

          VisualizationPlugin

          -

          Salesforce Documentation for VisualizationPlugin

          +
          fullName

          a character (inherited from Metadata)

          description

          a character

          developerName

          a character

          @@ -9861,10 +9861,10 @@

          Details

          VisualizationResource

          -

          Salesforce Documentation for VisualizationResource

          +
          description

          a character

          file

          a character

          -
          rank

          a integer

          +
          rank

          an integer

          type

          a VisualizationResourceType - which is a character taking one of the following values:

          • js

            • @@ -9874,7 +9874,7 @@

            Details

          VisualizationType

          -

          Salesforce Documentation for VisualizationType

          +
          description

          a character

          developerName

          a character

          icon

          a character

          @@ -9884,7 +9884,7 @@

          Details

          WaveApplication

          -

          Salesforce Documentation for WaveApplication

          +
          fullName

          a character (inherited from Metadata)

          assetIcon

          a character

          description

          a character

          @@ -9897,8 +9897,8 @@

          Details

          WaveDashboard

          -

          Salesforce Documentation for WaveDashboard

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          application

          a character

          description

          a character

          masterLabel

          a character

          @@ -9907,8 +9907,8 @@

          Details

          WaveDataflow

          -

          Salesforce Documentation for WaveDataflow

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          dataflowType

          a character

          description

          a character

          masterLabel

          a character

          @@ -9916,7 +9916,7 @@

          Details

          WaveDataset

          -

          Salesforce Documentation for WaveDataset

          +
          fullName

          a character (inherited from Metadata)

          application

          a character

          description

          a character

          @@ -9926,8 +9926,8 @@

          Details

          WaveLens

          -

          Salesforce Documentation for WaveLens

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          application

          a character

          datasets

          a character

          description

          a character

          @@ -9938,8 +9938,8 @@

          Details

          WaveRecipe

          -

          Salesforce Documentation for WaveRecipe

          -
          content

          a character formed using RCurl::base64Encode (inherited from MetadataWithContent)

          +
          +
          content

          a character formed using base64encode (inherited from MetadataWithContent)

          dataflow

          a character

          masterLabel

          a character

          securityPredicate

          a character

          @@ -9948,7 +9948,7 @@

          Details

          WaveTemplateBundle

          -

          Salesforce Documentation for WaveTemplateBundle

          +
          fullName

          a character (inherited from Metadata)

          assetIcon

          a character

          assetVersion

          a numeric

          @@ -9961,7 +9961,7 @@

          Details

          WaveXmd

          -

          Salesforce Documentation for WaveXmd

          +
          fullName

          a character (inherited from Metadata)

          application

          a character

          dataset

          a character

          @@ -9978,7 +9978,7 @@

          Details

          WaveXmdDate

          -

          Salesforce Documentation for WaveXmdDate

          +
          alias

          a character

          compact

          a character either 'true' or 'false'

          dateFieldDay

          a character

          @@ -9997,17 +9997,17 @@

          Details
          dateFieldWeek

          a character

          dateFieldYear

          a character

          description

          a character

          -
          firstDayOfWeek

          a integer

          -
          fiscalMonthOffset

          a integer

          +
          firstDayOfWeek

          an integer

          +
          fiscalMonthOffset

          an integer

          isYearEndFiscalYear

          a character either 'true' or 'false'

          label

          a character

          showInExplorer

          a character either 'true' or 'false'

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdDimension

          -

          Salesforce Documentation for WaveXmdDimension

          +
          customActions

          a WaveXmdDimensionCustomAction

          customActionsEnabled

          a character either 'true' or 'false'

          dateFormat

          a character

          @@ -10028,19 +10028,19 @@

          Details
          recordOrganizationIdField

          a character

          salesforceActions

          a WaveXmdDimensionSalesforceAction

          salesforceActionsEnabled

          a character either 'true' or 'false'

          -
          showDetailsDefaultFieldIndex

          a integer

          +
          showDetailsDefaultFieldIndex

          an integer

          showInExplorer

          a character either 'true' or 'false'

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdDimensionCustomAction

          -

          Salesforce Documentation for WaveXmdDimensionCustomAction

          +
          customActionName

          a character

          enabled

          a character either 'true' or 'false'

          icon

          a character

          method

          a character

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          target

          a character

          tooltip

          a character

          url

          a character

          @@ -10048,29 +10048,29 @@

          Details

          WaveXmdDimensionMember

          -

          Salesforce Documentation for WaveXmdDimensionMember

          +
          color

          a character

          label

          a character

          member

          a character

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdDimensionSalesforceAction

          -

          Salesforce Documentation for WaveXmdDimensionSalesforceAction

          +
          enabled

          a character either 'true' or 'false'

          salesforceActionName

          a character

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdMeasure

          -

          Salesforce Documentation for WaveXmdMeasure

          +
          dateFormat

          a character

          description

          a character

          field

          a character

          formatCustomFormat

          a character

          -
          formatDecimalDigits

          a integer

          +
          formatDecimalDigits

          an integer

          formatIsNegativeParens

          a character either 'true' or 'false'

          formatPrefix

          a character

          formatSuffix

          a character

          @@ -10080,29 +10080,29 @@

          Details
          isDerived

          a character either 'true' or 'false'

          label

          a character

          origin

          a character

          -
          showDetailsDefaultFieldIndex

          a integer

          +
          showDetailsDefaultFieldIndex

          an integer

          showInExplorer

          a character either 'true' or 'false'

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdOrganization

          -

          Salesforce Documentation for WaveXmdOrganization

          +
          instanceUrl

          a character

          label

          a character

          organizationIdentifier

          a character

          -
          sortIndex

          a integer

          +
          sortIndex

          an integer

          WaveXmdRecordDisplayLookup

          -

          Salesforce Documentation for WaveXmdRecordDisplayLookup

          +
          recordDisplayField

          a character

          WebLink

          -

          Salesforce Documentation for WebLink

          +
          fullName

          a character (inherited from Metadata)

          availability

          a WebLinkAvailability - which is a character taking one of the following values:

            @@ -10132,7 +10132,7 @@

            Details
            hasMenubar

            a character either 'true' or 'false'

            hasScrollbars

            a character either 'true' or 'false'

            hasToolbar

            a character either 'true' or 'false'

            -
            height

            a integer

            +
            height

            an integer

            isResizable

            a character either 'true' or 'false'

            linkType

            a WebLinkType - which is a character taking one of the following values:

              @@ -10164,19 +10164,19 @@

              Details
              showsLocation

              a character either 'true' or 'false'

              showsStatus

              a character either 'true' or 'false'

              url

              a character

              -
              width

              a integer

              +
              width

              an integer

          WebLinkTranslation

          -

          Salesforce Documentation for WebLinkTranslation

          +
          label

          a character

          name

          a character

          WebToCaseSettings

          -

          Salesforce Documentation for WebToCaseSettings

          +
          caseOrigin

          a character

          defaultResponseTemplate

          a character

          enableWebToCase

          a character either 'true' or 'false'

          @@ -10184,14 +10184,14 @@

          Details

          WeightedSourceCategory

          -

          Salesforce Documentation for WeightedSourceCategory

          +
          sourceCategoryApiName

          a character

          weight

          a numeric

          Workflow

          -

          Salesforce Documentation for Workflow

          +
          fullName

          a character (inherited from Metadata)

          alerts

          a WorkflowAlert

          fieldUpdates

          a WorkflowFieldUpdate

          @@ -10205,13 +10205,13 @@

          Details

          WorkflowAction

          -

          Salesforce Documentation for WorkflowAction

          +
          fullName

          a character (inherited from Metadata)

          WorkflowActionReference

          -

          Salesforce Documentation for WorkflowActionReference

          +
          name

          a character

          type

          a WorkflowActionType - which is a character taking one of the following values:

            @@ -10227,7 +10227,7 @@

            Details

          WorkflowAlert

          -

          Salesforce Documentation for WorkflowAlert

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          ccEmails

          a character

          description

          a character

          @@ -10245,7 +10245,7 @@

          Details

          WorkflowEmailRecipient

          -

          Salesforce Documentation for WorkflowEmailRecipient

          +
          field

          a character

          recipient

          a character

          type

          a ActionEmailRecipientTypes - which is a character taking one of the following values: @@ -10274,7 +10274,7 @@

          Details

          WorkflowFieldUpdate

          -

          Salesforce Documentation for WorkflowFieldUpdate

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          description

          a character

          field

          a character

          @@ -10305,7 +10305,7 @@

          Details

          WorkflowFlowAction

          -

          Salesforce Documentation for WorkflowFlowAction

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          description

          a character

          flow

          a character

          @@ -10317,14 +10317,14 @@

          Details

          WorkflowFlowActionParameter

          -

          Salesforce Documentation for WorkflowFlowActionParameter

          +
          name

          a character

          value

          a character

          WorkflowKnowledgePublish

          -

          Salesforce Documentation for WorkflowKnowledgePublish

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          action

          a KnowledgeWorkflowAction - which is a character taking one of the following values:

            @@ -10339,7 +10339,7 @@

            Details

          WorkflowRule

          -

          Salesforce Documentation for WorkflowRule

          +
          fullName

          a character (inherited from Metadata)

          actions

          a WorkflowActionReference

          active

          a character either 'true' or 'false'

          @@ -10359,7 +10359,7 @@

          Details

          WorkflowSend

          -

          Salesforce Documentation for WorkflowSend

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          action

          a SendAction - which is a character taking one of the following values:

            @@ -10373,7 +10373,7 @@

            Details

          WorkflowTask

          -

          Salesforce Documentation for WorkflowTask

          +
          extends WorkflowAction

          see documentation for WorkflowAction

          assignedTo

          a character

          assignedToType

          a ActionTaskAssignedToTypes - which is a character taking one of the following values: @@ -10390,7 +10390,7 @@

          Details

        • portalRole

          • description

          a character

          -
          dueDateOffset

          a integer

          +
          dueDateOffset

          an integer

          notifyAssignee

          a character either 'true' or 'false'

          offsetFromField

          a character

          priority

          a character

          @@ -10401,7 +10401,7 @@

          Details

          WorkflowTaskTranslation

          -

          Salesforce Documentation for WorkflowTaskTranslation

          +
          description

          a character

          name

          a character

          subject

          a character

          @@ -10409,7 +10409,7 @@

          Details

          WorkflowTimeTrigger

          -

          Salesforce Documentation for WorkflowTimeTrigger

          +
          actions

          a WorkflowActionReference

          offsetFromField

          a character

          timeLength

          a character

          @@ -10422,7 +10422,7 @@

          Details

          WorkspaceMapping

          -

          Salesforce Documentation for WorkspaceMapping

          +
          fieldName

          a character

          tab

          a character

          @@ -10444,7 +10444,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/parameterized_search_control.html b/docs/reference/parameterized_search_control.html index 8e5932e3..a8c0d431 100644 --- a/docs/reference/parameterized_search_control.html +++ b/docs/reference/parameterized_search_control.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
          @@ -244,15 +244,16 @@

          R

          https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_parameterized.htm#resources_search_parameterized

          Examples

          - 
          if (FALSE) {
+    
          if (FALSE) {
 # free text search only on Contact record Phone fields
 # this will improve the performance of the search
-my_phone_search <- "(336)"
-search_result <- sf_search(my_phone_search,
-                           objects = c("Contact", "Lead"),
-                           fields_scope = "PHONE",
-                           fields = c("Id", "FirstName", "LastName"))
-}
          
+my_phone_search <- "(336)"
+search_result <- sf_search(my_phone_search,
+                           objects = c("Contact", "Lead"),
+                           fields_scope = "PHONE",
+                           fields = c("Id", "FirstName", "LastName"))
+}
+
          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/parse_error_code_and_message.html b/docs/reference/parse_error_code_and_message.html index 83c331c7..28b3b843 100644 --- a/docs/reference/parse_error_code_and_message.html +++ b/docs/reference/parse_error_code_and_message.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -252,7 +252,7 @@

          Value

          and the columns represent the detail columns.

          Note

          -

          Below are the fact map key patterns for three report types:

          +

          Below are the fact map key patterns for three report types:

          TABULAR

          T!T: The grand total of a report. Both record data values and the grand total are represented by this key.

          SUMMARY

          <First level row grouping_second level row grouping_third @@ -264,7 +264,7 @@

          Note

          Each item in a row or column grouping is numbered starting with 0. Here are some examples of fact map keys:

          - +
          0!T

          The first item in the first-level grouping.

          1!T

          The second item in the first-level grouping.

          0_0!T

          The first item in the first-level grouping and the first item @@ -291,7 +291,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/patched_tempdir.html b/docs/reference/patched_tempdir.html index dca26a50..5f91bac4 100644 --- a/docs/reference/patched_tempdir.html +++ b/docs/reference/patched_tempdir.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          @@ -238,7 +238,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/remove_empty_linked_object_cols.html b/docs/reference/remove_empty_linked_object_cols.html index 35aca586..58a05ee4 100644 --- a/docs/reference/remove_empty_linked_object_cols.html +++ b/docs/reference/remove_empty_linked_object_cols.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          @@ -225,7 +225,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/return_matching_controls.html b/docs/reference/return_matching_controls.html index 3cbd40ae..3abe02f9 100644 --- a/docs/reference/return_matching_controls.html +++ b/docs/reference/return_matching_controls.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -213,7 +213,7 @@

          Arg

          @@ -270,13 +270,14 @@

          R

          https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

          Examples

          - 
          if (FALSE) {
+    
          if (FALSE) {
 # update Account object
-updates <- rforcecom.bulkAction(session,
-                                operation = 'update',
-                                data = my_data,
-                                object = 'Account')
-}
          
+updates <- rforcecom.bulkAction(session, 
+                                operation = 'update', 
+                                data = my_data, 
+                                object = 'Account')
+}
+
          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.bulkQuery.html b/docs/reference/rforcecom.bulkQuery.html index cd0f1c9a..00807db8 100644 --- a/docs/reference/rforcecom.bulkQuery.html +++ b/docs/reference/rforcecom.bulkQuery.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.bulkQuery.html'>rforcecom.bulkQuery</a></code> — rforcecom.bulkQuery • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.bulkQuery — rforcecom.bulkQuery • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -207,7 +207,7 @@

          Arg

          @@ -258,7 +258,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.create.html b/docs/reference/rforcecom.create.html index a7a94aab..30628722 100644 --- a/docs/reference/rforcecom.create.html +++ b/docs/reference/rforcecom.create.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.create.html'>rforcecom.create</a></code> — rforcecom.create • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.create — rforcecom.create • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -235,7 +235,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.delete.html b/docs/reference/rforcecom.delete.html index 754154ad..ef83f45c 100644 --- a/docs/reference/rforcecom.delete.html +++ b/docs/reference/rforcecom.delete.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.delete.html'>rforcecom.delete</a></code> — rforcecom.delete • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.delete — rforcecom.delete • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -235,7 +235,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.getObjectDescription.html b/docs/reference/rforcecom.getObjectDescription.html index f73bf8e7..c7e019a5 100644 --- a/docs/reference/rforcecom.getObjectDescription.html +++ b/docs/reference/rforcecom.getObjectDescription.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.getObjectDescription.html'>rforcecom.getObjectDescription</a></code> — rforcecom.getObjectDescription • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.getObjectDescription — rforcecom.getObjectDescription • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -234,7 +234,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.getServerTimestamp.html b/docs/reference/rforcecom.getServerTimestamp.html index 0df3c9ea..d311578b 100644 --- a/docs/reference/rforcecom.getServerTimestamp.html +++ b/docs/reference/rforcecom.getServerTimestamp.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.getServerTimestamp.html'>rforcecom.getServerTimestamp</a></code> — rforcecom.getServerTimestamp • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.getServerTimestamp — rforcecom.getServerTimestamp • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -223,7 +223,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.login.html b/docs/reference/rforcecom.login.html index 7ec1d48f..57f68630 100644 --- a/docs/reference/rforcecom.login.html +++ b/docs/reference/rforcecom.login.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.login.html'>rforcecom.login</a></code> — rforcecom.login • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.login — rforcecom.login • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -243,7 +243,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.query.html b/docs/reference/rforcecom.query.html index f4fd0e5e..f89d8b82 100644 --- a/docs/reference/rforcecom.query.html +++ b/docs/reference/rforcecom.query.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.query.html'>rforcecom.query</a></code> — rforcecom.query • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.query — rforcecom.query • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          @@ -200,7 +200,7 @@

          Arg

          @@ -236,7 +236,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.retrieve.html b/docs/reference/rforcecom.retrieve.html index 00755e0f..de98d344 100644 --- a/docs/reference/rforcecom.retrieve.html +++ b/docs/reference/rforcecom.retrieve.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.retrieve.html'>rforcecom.retrieve</a></code> — rforcecom.retrieve • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.retrieve — rforcecom.retrieve • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -210,7 +210,7 @@

          Arg

          @@ -271,7 +271,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.search.html b/docs/reference/rforcecom.search.html index ad88bf4e..211a9d42 100644 --- a/docs/reference/rforcecom.search.html +++ b/docs/reference/rforcecom.search.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.search.html'>rforcecom.search</a></code> — rforcecom.search • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.search — rforcecom.search • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -227,7 +227,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.update.html b/docs/reference/rforcecom.update.html index c7ae3e59..828b0540 100644 --- a/docs/reference/rforcecom.update.html +++ b/docs/reference/rforcecom.update.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.update.html'>rforcecom.update</a></code> — rforcecom.update • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.update — rforcecom.update • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -239,7 +239,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/rforcecom.upsert.html b/docs/reference/rforcecom.upsert.html index 2b0a2362..45475005 100644 --- a/docs/reference/rforcecom.upsert.html +++ b/docs/reference/rforcecom.upsert.html @@ -6,8 +6,8 @@ -The <code>salesforcer</code> backwards compatible version of -<code><a href='https://rdrr.io/pkg/RForcecom/man/rforcecom.upsert.html'>rforcecom.upsert</a></code> — rforcecom.upsert • salesforcer +The salesforcer backwards compatible version of +RForcecom::rforcecom.upsert — rforcecom.upsert • salesforcer @@ -53,8 +53,8 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -200,7 +200,7 @@

          Arg

          @@ -243,7 +243,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/safe_bind_rows.html b/docs/reference/safe_bind_rows.html index d9852462..b8e1cbda 100644 --- a/docs/reference/safe_bind_rows.html +++ b/docs/reference/safe_bind_rows.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
          session

          list; a list containing "sessionID", "instanceURL", and "apiVersion" as returned by -rforcecom.login. This argument is ignored in all +RForcecom::rforcecom.login. This argument is ignored in all backward compatible calls because the authorization credentials are stored in an environment internal to the salesforcer package, so it is no longer necessary to pass the session in each function call.

          @@ -242,7 +242,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/salesforcer-package.html b/docs/reference/salesforcer-package.html index 952db766..a5aa388d 100644 --- a/docs/reference/salesforcer-package.html +++ b/docs/reference/salesforcer-package.html @@ -6,7 +6,7 @@ -<code>salesforcer</code> package — salesforcer-package • salesforcer +salesforcer package — salesforcer-package • salesforcer @@ -52,7 +52,7 @@ - + @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -225,7 +225,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/set_null_elements_to_na_recursively.html b/docs/reference/set_null_elements_to_na_recursively.html index de8b31a2..f01e0710 100644 --- a/docs/reference/set_null_elements_to_na_recursively.html +++ b/docs/reference/set_null_elements_to_na_recursively.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
          @@ -223,7 +223,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_abort_job_bulk.html b/docs/reference/sf_abort_job_bulk.html index 0ac2e05f..2ed182c6 100644 --- a/docs/reference/sf_abort_job_bulk.html +++ b/docs/reference/sf_abort_job_bulk.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -225,10 +225,11 @@

          R

          https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

          Examples

          - 
          if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-sf_abort_job_bulk(job_info$id)
-}
          + 
          if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+sf_abort_job_bulk(job_info$id)
+}
+
          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_access_token.html b/docs/reference/sf_access_token.html index ca181180..aa2dcca3 100644 --- a/docs/reference/sf_access_token.html +++ b/docs/reference/sf_access_token.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -225,7 +225,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notification_create.html b/docs/reference/sf_analytics_notification_create.html index 561aece5..28f8725c 100644 --- a/docs/reference/sf_analytics_notification_create.html +++ b/docs/reference/sf_analytics_notification_create.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -222,7 +222,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notification_delete.html b/docs/reference/sf_analytics_notification_delete.html index 58c13c44..9da53bbb 100644 --- a/docs/reference/sf_analytics_notification_delete.html +++ b/docs/reference/sf_analytics_notification_delete.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -219,7 +219,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notification_describe.html b/docs/reference/sf_analytics_notification_describe.html index 5f101680..2028b8be 100644 --- a/docs/reference/sf_analytics_notification_describe.html +++ b/docs/reference/sf_analytics_notification_describe.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -219,7 +219,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notification_update.html b/docs/reference/sf_analytics_notification_update.html index 714ddde5..fd95459f 100644 --- a/docs/reference/sf_analytics_notification_update.html +++ b/docs/reference/sf_analytics_notification_update.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -227,7 +227,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notifications_limits.html b/docs/reference/sf_analytics_notifications_limits.html index 46fc89c9..7255f603 100644 --- a/docs/reference/sf_analytics_notifications_limits.html +++ b/docs/reference/sf_analytics_notifications_limits.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
          @@ -200,7 +200,7 @@

          Arg

          source

          character; a vector of character to specify what type of -analytics notification to return. Valid values are:

          +analytics notification to return. Valid values are:

          lightningDashboardSubscribe

          Dashboard subscriptions

          lightningReportSubscribe

          Report subscriptions

          waveNotification

          Einstein Analytics notifications

          @@ -235,7 +235,7 @@

          Contents

          -

          Site built with pkgdown 1.5.1.

          +

          Site built with pkgdown 1.6.1.

          diff --git a/docs/reference/sf_analytics_notifications_list.html b/docs/reference/sf_analytics_notifications_list.html index f59a4f8b..0350eadb 100644 --- a/docs/reference/sf_analytics_notifications_list.html +++ b/docs/reference/sf_analytics_notifications_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@

          • Experimental lifecycle

            +

            [Experimental]

            - 
            sf_analytics_notifications_list(
-  source = c("lightningDashboardSubscribe", "lightningReportSubscribe",
-    "waveNotification"),
-  owner_id = NULL,
-  record_id = NULL
-)
            + 
            sf_analytics_notifications_list(
+  source = c("lightningDashboardSubscribe", "lightningReportSubscribe",
+    "waveNotification"),
+  owner_id = NULL,
+  record_id = NULL
+)

            Arguments

            @@ -201,7 +201,7 @@

            Arg

            source

            character; a vector of character to specify what type of -analytics notification to return. Valid values are:

            +analytics notification to return. Valid values are:

            lightningDashboardSubscribe

            Dashboard subscriptions

            lightningReportSubscribe

            Report subscriptions

            waveNotification

            Einstein Analytics notifications

            @@ -242,7 +242,7 @@

            Contents

            -

            Site built with pkgdown 1.5.1.

            +

            Site built with pkgdown 1.6.1.

            diff --git a/docs/reference/sf_auth.html b/docs/reference/sf_auth.html index 39d85bc6..2fd4c505 100644 --- a/docs/reference/sf_auth.html +++ b/docs/reference/sf_auth.html @@ -54,7 +54,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -110,7 +110,7 @@

            • Stable lifecycle

              -

              Log in using Basic (Username-Password) or OAuth 2.0 authenticaion. OAuth does +

              [Stable]

              +

              Log in using Basic (Username-Password) or OAuth 2.0 authentication. OAuth does not require sharing passwords, but will require authorizing salesforcer as a connected app to view and manage your organization. You will be directed to a web browser, asked to sign in to your Salesforce account, and to grant salesforcer @@ -200,18 +200,18 @@

              Log in to Salesforce

              cached in a file named .httr-oauth-salesforcer in the current working directory.

              - 
              sf_auth(
-  username = NULL,
-  password = NULL,
-  security_token = NULL,
-  login_url = getOption("salesforcer.login_url"),
-  token = NULL,
-  consumer_key = getOption("salesforcer.consumer_key"),
-  consumer_secret = getOption("salesforcer.consumer_secret"),
-  callback_url = getOption("salesforcer.callback_url"),
-  cache = getOption("salesforcer.httr_oauth_cache"),
-  verbose = FALSE
-)
              + 
              sf_auth(
+  username = NULL,
+  password = NULL,
+  security_token = NULL,
+  login_url = getOption("salesforcer.login_url"),
+  token = NULL,
+  consumer_key = getOption("salesforcer.consumer_key"),
+  consumer_secret = getOption("salesforcer.consumer_secret"),
+  callback_url = getOption("salesforcer.callback_url"),
+  cache = getOption("salesforcer.httr_oauth_cache"),
+  verbose = FALSE
+)

              Arguments

              @@ -261,26 +261,49 @@

              Arg

              +

              Value

              + +

              list invisibly that contains 4 elements detailing the authentication state

              +

              Note

              + +

              The link{sf_auth} function invisibly returns the following +4 pieces of information which can be reused in other operations:

              +
              auth_method

              character; One of two options 'Basic' or 'OAuth'. If a username, +password, and security token were supplied, then this would result in +'Basic' authentication.

              +
              token

              Token2.0; The object returned by oauth2.0_token. +This value is NULL if auth_method='Basic'.

              +
              session_id

              character; A unique ID associated with this user session. The session +ID is obtained from the X-SFDC-Session header fetched with SOAP API's login() +call. This value is NULL if auth_method='OAuth'.

              +
              instance_url

              character; The domain address of the server that your Salesforce org +is on and where subsequent API calls will be directed to. For example, +https://na21.salesforce.com refers to an org located on the 'NA21' +server instance located in Chicago, USA / Washington DC, USA per this +Knowledge Article: https://help.salesforce.com/articleView?id=000314281.

              + +
              +

              Examples

              - 
              if (FALSE) {
+    
              if (FALSE) {
 # log in using basic authentication (username-password)
-sf_auth(username = "test@gmail.com",
-        password = "test_password",
-        security_token = "test_token")
+sf_auth(username = "test@gmail.com", 
+        password = "test_password", 
+        security_token = "test_token")
 
-# log in using OAuth 2.0
-# Via brower or refresh of .httr-oauth-salesforcer
-sf_auth()
+# log in using OAuth 2.0 (via browser or cached .httr-oauth-salesforcer)
+sf_auth()
 
 # log in to a Sandbox environment
 # Via brower or refresh of .httr-oauth-salesforcer
-sf_auth(login_url = "https://test.salesforce.com")
+sf_auth(login_url = "https://test.salesforce.com")
 
-# Save token and log in using it
-saveRDS(salesforcer_state()$token, "token.rds")
-sf_auth(token = "token.rds")
-}
              
+# Save token to disk and log in using it
+saveRDS(salesforcer_state()$token, "token.rds")
+sf_auth(token = "token.rds")
+}
+
              -

              Site built with pkgdown 1.5.1.

              +

              Site built with pkgdown 1.6.1.

              diff --git a/docs/reference/sf_auth_check.html b/docs/reference/sf_auth_check.html index 56288203..3b6ebc60 100644 --- a/docs/reference/sf_auth_check.html +++ b/docs/reference/sf_auth_check.html @@ -101,7 +101,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -109,7 +109,7 @@

              • Arguments

                @@ -236,7 +236,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_auth_refresh.html b/docs/reference/sf_auth_refresh.html index c51c6cb3..aa3bed93 100644 --- a/docs/reference/sf_auth_refresh.html +++ b/docs/reference/sf_auth_refresh.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -230,7 +230,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_batch_details_bulk.html b/docs/reference/sf_batch_details_bulk.html index 7791cbb7..8ab64d51 100644 --- a/docs/reference/sf_batch_details_bulk.html +++ b/docs/reference/sf_batch_details_bulk.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -238,14 +238,15 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk(operation = "query", object = "Account")
-soql <- "SELECT Id, Name FROM Account LIMIT 10"
-batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
-batch_details <- sf_batch_details_bulk(job_id=batch_query_info$jobId,
-                                       batch_id=batch_query_info$id)
-sf_close_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+job_info <- sf_create_job_bulk(operation = "query", object = "Account")
+soql <- "SELECT Id, Name FROM Account LIMIT 10"
+batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
+batch_details <- sf_batch_details_bulk(job_id=batch_query_info$jobId,
+                                       batch_id=batch_query_info$id)
+sf_close_job_bulk(job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_batch_status_bulk.html b/docs/reference/sf_batch_status_bulk.html index 8c78873a..8c467107 100644 --- a/docs/reference/sf_batch_status_bulk.html +++ b/docs/reference/sf_batch_status_bulk.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -236,15 +236,16 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk(operation = "query", object = "Account")
-soql <- "SELECT Id, Name FROM Account LIMIT 10"
-batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
-batch_status <- sf_batch_status_bulk(job_id = batch_query_info$jobId,
-                                     batch_id = batch_query_info$id)
-job_close_ind <- sf_close_job_bulk(job_info$id)
-sf_get_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+job_info <- sf_create_job_bulk(operation = "query", object = "Account")
+soql <- "SELECT Id, Name FROM Account LIMIT 10"
+batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
+batch_status <- sf_batch_status_bulk(job_id = batch_query_info$jobId,
+                                     batch_id = batch_query_info$id)
+job_close_ind <- sf_close_job_bulk(job_info$id)
+sf_get_job_bulk(job_info$id)                               
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_build_cols_spec.html b/docs/reference/sf_build_cols_spec.html index 779d2d7c..dfcec9d1 100644 --- a/docs/reference/sf_build_cols_spec.html +++ b/docs/reference/sf_build_cols_spec.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -223,7 +223,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_close_job_bulk.html b/docs/reference/sf_close_job_bulk.html index d33a807d..12e321f0 100644 --- a/docs/reference/sf_close_job_bulk.html +++ b/docs/reference/sf_close_job_bulk.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -228,15 +228,16 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-my_query <- "SELECT Id, Name FROM Account LIMIT 10"
-job_info <- sf_create_job_bulk(operation='query', object='Account')
-query_info <- sf_submit_query_bulk(job_id=job_info$id, soql=my_query)
-recordset <- sf_query_result_bulk(job_id = query_info$jobId,
-                                  batch_id = query_info$id,
-                                  result_id = result$result)
-sf_close_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+my_query <- "SELECT Id, Name FROM Account LIMIT 10"
+job_info <- sf_create_job_bulk(operation='query', object='Account')
+query_info <- sf_submit_query_bulk(job_id=job_info$id, soql=my_query)
+recordset <- sf_query_result_bulk(job_id = query_info$jobId,
+                                  batch_id = query_info$id,
+                                  result_id = result$result)
+sf_close_job_bulk(job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_control.html b/docs/reference/sf_control.html index eeb1eb16..7740fe5d 100644 --- a/docs/reference/sf_control.html +++ b/docs/reference/sf_control.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@
                • glm function.

                  - 
                  sf_control(
-  AllOrNoneHeader = list(allOrNone = FALSE),
-  AllowFieldTruncationHeader = list(allowFieldTruncation = FALSE),
-  AssignmentRuleHeader = list(useDefaultRule = TRUE),
-  DisableFeedTrackingHeader = list(disableFeedTracking = FALSE),
-  DuplicateRuleHeader = list(allowSave = FALSE, includeRecordDetails = FALSE,
-    runAsCurrentUser = TRUE),
-  EmailHeader = list(triggerAutoResponseEmail = FALSE, triggerOtherEmail = FALSE,
-    triggerUserEmail = TRUE),
-  LocaleOptions = list(language = "en_US"),
-  MruHeader = list(updateMru = FALSE),
-  OwnerChangeOptions = list(options = list(list(execute = TRUE, type =
-    "EnforceNewOwnerHasReadAccess"), list(execute = FALSE, type = "KeepAccountTeam"),
-    list(execute = FALSE, type = "KeepSalesTeam"), list(execute = FALSE, type =
-    "KeepSalesTeamGrantCurrentOwnerReadWriteAccess"), list(execute = FALSE, type =
-    "SendEmail"), list(execute = FALSE, type = "TransferAllOwnedCases"), list(execute =
-    TRUE, type = "TransferContacts"), list(execute = TRUE, type = "TransferContracts"),
-    list(execute = FALSE, type = "TransferNotesAndAttachments"),      list(execute =
-    TRUE, type = "TransferOpenActivities"), list(execute = TRUE, type =
-    "TransferOrders"), list(execute = FALSE, type = "TransferOtherOpenOpportunities"),
-    list(execute = FALSE, type = "TransferOwnedClosedOpportunities"), list(execute =
-    FALSE, type = "TransferOwnedOpenCases"), list(execute = FALSE, type =
-    "TransferOwnedOpenOpportunities"))),
-  QueryOptions = list(batchSize = 500),
-  UserTerritoryDeleteHeader = list(transferToUserId = NA),
-  BatchRetryHeader = list(`Sforce-Disable-Batch-Retry` = FALSE),
-  LineEndingHeader = list(`Sforce-Line-Ending` = NA),
-  PKChunkingHeader = list(`Sforce-Enable-PKChunking` = FALSE),
-  api_type = NULL,
-  operation = NULL
-)
                  + 
                  sf_control(
+  AllOrNoneHeader = list(allOrNone = FALSE),
+  AllowFieldTruncationHeader = list(allowFieldTruncation = FALSE),
+  AssignmentRuleHeader = list(useDefaultRule = TRUE),
+  DisableFeedTrackingHeader = list(disableFeedTracking = FALSE),
+  DuplicateRuleHeader = list(allowSave = FALSE, includeRecordDetails = FALSE,
+    runAsCurrentUser = TRUE),
+  EmailHeader = list(triggerAutoResponseEmail = FALSE, triggerOtherEmail = FALSE,
+    triggerUserEmail = TRUE),
+  LocaleOptions = list(language = "en_US"),
+  MruHeader = list(updateMru = FALSE),
+  OwnerChangeOptions = list(options = list(list(execute = TRUE, type =
+    "EnforceNewOwnerHasReadAccess"), list(execute = FALSE, type = "KeepAccountTeam"),
+    list(execute = FALSE, type = "KeepSalesTeam"), list(execute = FALSE, type =
+    "KeepSalesTeamGrantCurrentOwnerReadWriteAccess"), list(execute = FALSE, type =
+    "SendEmail"), list(execute = FALSE, type = "TransferAllOwnedCases"), list(execute =
+    TRUE, type = "TransferContacts"), list(execute = TRUE, type = "TransferContracts"),
+    list(execute = FALSE, type = "TransferNotesAndAttachments"),      list(execute =
+    TRUE, type = "TransferOpenActivities"), list(execute = TRUE, type =
+    "TransferOrders"), list(execute = FALSE, type = "TransferOtherOpenOpportunities"),
+    list(execute = FALSE, type = "TransferOwnedClosedOpportunities"), list(execute =
+    FALSE, type = "TransferOwnedOpenCases"), list(execute = FALSE, type =
+    "TransferOwnedOpenOpportunities"))),
+  QueryOptions = list(batchSize = 500),
+  UserTerritoryDeleteHeader = list(transferToUserId = NA),
+  BatchRetryHeader = list(`Sforce-Disable-Batch-Retry` = FALSE),
+  LineEndingHeader = list(`Sforce-Line-Ending` = NA),
+  PKChunkingHeader = list(`Sforce-Enable-PKChunking` = FALSE),
+  api_type = NULL,
+  operation = NULL
+)

                  Arguments

                @@ -378,19 +378,20 @@

                Arg

                Examples

                - 
                if (FALSE) {
-this_control <- sf_control(DuplicateRuleHeader=list(allowSave=TRUE,
-                                                    includeRecordDetails=FALSE,
-                                                    runAsCurrentUser=TRUE))
-new_contact <- c(FirstName = "Test", LastName = "Contact-Create")
-new_record <- sf_create(new_contact, "Contact", control = this_control)
+    
                if (FALSE) {
+this_control <- sf_control(DuplicateRuleHeader=list(allowSave=TRUE, 
+                                                    includeRecordDetails=FALSE, 
+                                                    runAsCurrentUser=TRUE))
+new_contact <- c(FirstName = "Test", LastName = "Contact-Create")
+new_record <- sf_create(new_contact, "Contact", control = this_control)
 
 # specifying the controls directly and are picked up by dots
-new_record <- sf_create(new_contact, "Contact",
-                        DuplicateRuleHeader = list(allowSave=TRUE,
-                                                   includeRecordDetails=FALSE,
-                                                   runAsCurrentUser=TRUE))
-}
                
+new_record <- sf_create(new_contact, "Contact", 
+                        DuplicateRuleHeader = list(allowSave=TRUE, 
+                                                   includeRecordDetails=FALSE, 
+                                                   runAsCurrentUser=TRUE))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_convert_lead.html b/docs/reference/sf_convert_lead.html index 94f58d98..33526c57 100644 --- a/docs/reference/sf_convert_lead.html +++ b/docs/reference/sf_convert_lead.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Converts Leads each into an Account, Contact, as well as (optionally) an Opportunity.

                  - 
                  sf_convert_lead(
-  input_data,
-  guess_types = TRUE,
-  api_type = c("SOAP"),
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_convert_lead(
+  input_data,
+  guess_types = TRUE,
+  api_type = c("SOAP"),
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -256,7 +256,7 @@

                Details in your input data called doNotCreateOpportunity and set its value to TRUE. The default is FALSE which creates opportunities. The order of columns in the input data does not matter, just that the names -match (case-insensitive).

                +match (case-insensitive).

                leadId

                ID of the Lead to convert. Required.

                convertedStatus

                Valid LeadStatus value for a converted lead. Required.

                accountId

                Id of the Account into which the lead will be merged. Required @@ -297,21 +297,22 @@

                Details

                Salesforce Documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # create a new lead at Grand Hotels & Resorts Ltd
-new_lead <- tibble(FirstName = "Test", LastName = "Prospect",
-                   Company = "Grand Hotels & Resorts Ltd")
-rec <- sf_create(new_lead, "Lead")
+new_lead <- tibble(FirstName = "Test", LastName = "Prospect",
+                   Company = "Grand Hotels & Resorts Ltd")
+rec <- sf_create(new_lead, "Lead")
 
 # find the Id of matching account to link to
-acct_id <- sf_query("SELECT Id from Account WHERE name = 'Grand Hotels & Resorts Ltd' LIMIT 1")
+acct_id <- sf_query("SELECT Id from Account WHERE name = 'Grand Hotels & Resorts Ltd' LIMIT 1")
 
 # create the row(s) for the leads to convert
-to_convert <- tibble(leadId = rec$id,
-                     convertedStatus = "Closed - Converted",
-                     accountId = acct_id$Id)
-converted_lead <- sf_convert_lead(to_convert)
-}
                
+to_convert <- tibble(leadId = rec$id, 
+                     convertedStatus = "Closed - Converted", 
+                     accountId = acct_id$Id)
+converted_lead <- sf_convert_lead(to_convert)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_copy_report.html b/docs/reference/sf_copy_report.html index ecae7aaf..a0107a58 100644 --- a/docs/reference/sf_copy_report.html +++ b/docs/reference/sf_copy_report.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Creates a copy of a custom, standard, or public report by sending a POST request to the Report List resource.

                  - 
                  sf_copy_report(report_id, name = NULL, verbose = FALSE)
                  + 
                  sf_copy_report(report_id, name = NULL, verbose = FALSE)

                  Arguments

                @@ -221,7 +221,7 @@

                Arg

                Value

                list representing the newly cloned report with up to 4 properties -that describe the report:

                +that describe the report:

                attributes

                Report type along with the URL to retrieve common objects and joined metadata.

                reportMetadata

                Unique identifiers for groupings and summaries.

                @@ -255,22 +255,23 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # only the 200 most recently viewed reports
-most_recent_reports <- sf_report_list()
+most_recent_reports <- sf_report_list()
 
 # all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # id of the report to copy
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
 # not providing a name appends " - Copy" to the name of the report being cloned
-report_details <- sf_copy_report(this_report_id)
+report_details <- sf_copy_report(this_report_id)
 
 # example of providing new name to the copied report
-report_details <- sf_copy_report(this_report_id, "My New Copy of Report ABC")
-}
                
+report_details <- sf_copy_report(this_report_id, "My New Copy of Report ABC")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create.html b/docs/reference/sf_create.html index d7ca8a15..4a2ff098 100644 --- a/docs/reference/sf_create.html +++ b/docs/reference/sf_create.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Adds one or more new records to your organization’s data.

                  - 
                  sf_create(
-  input_data,
-  object_name,
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  guess_types = TRUE,
-  control = list(...),
-  ...,
-  all_or_none = deprecated(),
-  verbose = FALSE
-)
                  + 
                  sf_create(
+  input_data,
+  object_name,
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  guess_types = TRUE,
+  control = list(...),
+  ...,
+  all_or_none = deprecated(),
+  verbose = FALSE
+)

                  Arguments

                @@ -266,22 +266,23 @@

                Note

                of records and not all records submitted to the function.

                Examples

                - 
                if (FALSE) {
-n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n))
-new_recs1 <- sf_create(new_contacts, object_name = "Contact")
+    
                if (FALSE) {
+n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact", 1:n))
+new_recs1 <- sf_create(new_contacts, object_name = "Contact")
 
 # add control to allow the creation of records that violate a duplicate rules
-new_recs2 <- sf_create(new_contacts, object_name = "Contact",
-                       DuplicateRuleHeader=list(allowSave=TRUE,
-                                                includeRecordDetails=FALSE,
-                                                runAsCurrentUser=TRUE))
-
+new_recs2 <- sf_create(new_contacts, object_name = "Contact", 
+                       DuplicateRuleHeader=list(allowSave=TRUE,
+                                                includeRecordDetails=FALSE,
+                                                runAsCurrentUser=TRUE))
+                                                  
 # example using the Bulk 1.0 API to insert records
-new_recs3 <- sf_create(new_contacts, object_name = "Contact",
-                       api_type = "Bulk 1.0")
-}
                
+new_recs3 <- sf_create(new_contacts, object_name = "Contact", 
+                       api_type = "Bulk 1.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_attachment.html b/docs/reference/sf_create_attachment.html index 8d447a89..bbf8281f 100644 --- a/docs/reference/sf_create_attachment.html +++ b/docs/reference/sf_create_attachment.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  This function will allow you to create attachments (and other blob data, such as Documents) by supplying file paths (absolute or relative) to media that you would like to upload to Salesforce along with accompanying metadata, such as a Description, Keywords, ParentId, FolderId, etc.

                  - 
                  sf_create_attachment(
-  attachment_input_data,
-  object_name = c("Attachment", "Document"),
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_create_attachment(
+  attachment_input_data,
+  object_name = c("Attachment", "Document"),
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -279,29 +279,30 @@

                See a sf_update_attachment()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # upload two PDFs from working directory to a particular record as Attachments
-file_path1 <- here::here("doc1.pdf")
-file_path2 <- here::here("doc2.pdf")
-parent_record_id <- "0036A000002C6MmQAK"
-attachment_details <- tibble(Body = c(file_path1, file_path2),
-                             ParentId = rep(parent_record_id, 2))
-result <- sf_create_attachment(attachment_details)
+file_path1 <- here::here("doc1.pdf")
+file_path2 <- here::here("doc2.pdf")
+parent_record_id <- "0036A000002C6MmQAK"
+attachment_details <- tibble(Body = c(file_path1, file_path2), 
+                             ParentId = rep(parent_record_id, 2))
+result <- sf_create_attachment(attachment_details)
 
 # the function supports inserting all blob content, just update the 
 # object_name argument to add the PDF as a Document instead of an Attachment
-document_details <- tibble(Name = "doc1.pdf",
-                           Description = "Test Document 1",
-                           Body = file_path1,
-                           FolderId = "00l6A000001EgIwQAK", # replace with your FolderId!
-                           Keywords = "example,test,document")
-result <- sf_create_attachment(document_details, object_name = "Document")
+document_details <- tibble(Name = "doc1.pdf", 
+                           Description = "Test Document 1", 
+                           Body = file_path1,
+                           FolderId = "00l6A000001EgIwQAK", # replace with your FolderId!
+                           Keywords = "example,test,document")
+result <- sf_create_attachment(document_details, object_name = "Document")
 
 # the Bulk API can be invoked using api_type="Bulk 1.0" which will automatically 
 # take a data.frame of Attachment info and create a ZIP file with CSV manifest 
 # that is required for that API
-result <- sf_create_attachment(attachment_details, api_type="Bulk 1.0")
-}
                
+result <- sf_create_attachment(attachment_details, api_type="Bulk 1.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_attachment_bulk_v1.html b/docs/reference/sf_create_attachment_bulk_v1.html index b8b982c0..a0fabed3 100644 --- a/docs/reference/sf_create_attachment_bulk_v1.html +++ b/docs/reference/sf_create_attachment_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -239,26 +239,27 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # NOTE THAT YOU MUST FIRST CREATE AN EXTERNAL ID FIELD CALLED My_External_Id 
 # BEFORE RUNNING THIS EXAMPLE
 # inserting 2 records
-my_data <- tibble(Name=c('New Record 1', 'New Record 2'),
-                  My_External_Id__c=c('11111','22222'))
-job_info <- sf_create_job_bulk(operation='insert',
-                               object='Account')
-batches_ind <- sf_create_batches_bulk(job_id = job_info$id,
-                                      input_data = my_data)
+my_data <- tibble(Name=c('New Record 1', 'New Record 2'),
+                  My_External_Id__c=c('11111','22222'))
+job_info <- sf_create_job_bulk(operation='insert',
+                               object='Account')
+batches_ind <- sf_create_batches_bulk(job_id = job_info$id,
+                                      input_data = my_data)
 # upserting 3 records
-my_data2 <- tibble(My_External_Id__c=c('11111','22222', '99999'),
-                  Name=c('Updated_Name1', 'Updated_Name2', 'Upserted_Record'))
-job_info <- sf_create_job_bulk(operation='upsert',
-                               externalIdFieldName='My_External_Id__c',
-                               object='Account')
-batches_ind <- sf_create_batches_bulk(job_id = job_info$id,
-                                      input_data = my_data2)
-sf_get_job_bulk(job_info$id)
-}
                
+my_data2 <- tibble(My_External_Id__c=c('11111','22222', '99999'), 
+                  Name=c('Updated_Name1', 'Updated_Name2', 'Upserted_Record')) 
+job_info <- sf_create_job_bulk(operation='upsert',
+                               externalIdFieldName='My_External_Id__c',
+                               object='Account')
+batches_ind <- sf_create_batches_bulk(job_id = job_info$id,
+                                      input_data = my_data2)
+sf_get_job_bulk(job_info$id)                                     
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_bulk_v1.html b/docs/reference/sf_create_bulk_v1.html index 8caaa992..9d542526 100644 --- a/docs/reference/sf_create_bulk_v1.html +++ b/docs/reference/sf_create_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -292,26 +292,27 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # insert into Account
-job_info <- sf_create_job_bulk(operation='insert', object_name='Account')
+job_info <- sf_create_job_bulk(operation='insert', object_name='Account')
 
 # delete from Account
-job_info <- sf_create_job_bulk(operation='delete', object_name='Account')
+job_info <- sf_create_job_bulk(operation='delete', object_name='Account')
 
 # update into Account
-job_info <- sf_create_job_bulk(operation='update', object_name='Account')
+job_info <- sf_create_job_bulk(operation='update', object_name='Account')
 
 # upsert into Account
-job_info <- sf_create_job_bulk(operation='upsert',
-                               externalIdFieldName='My_External_Id__c',
-                               object_name='Account')
+job_info <- sf_create_job_bulk(operation='upsert',
+                               externalIdFieldName='My_External_Id__c',
+                               object_name='Account')
 # insert attachments
-job_info <- sf_create_job_bulk(operation='insert', object_name='Attachment')
+job_info <- sf_create_job_bulk(operation='insert', object_name='Attachment')
 
 # query leads
-job_info <- sf_create_job_bulk(operation='query', object_name='Lead')
-}
                
+job_info <- sf_create_job_bulk(operation='query', object_name='Lead')
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_job_bulk_v1.html b/docs/reference/sf_create_job_bulk_v1.html index dbe85f53..6703e635 100644 --- a/docs/reference/sf_create_job_bulk_v1.html +++ b/docs/reference/sf_create_job_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@ 
                • c("insert", "delete", "upsert", "update", "hardDelete", "query",
-    "queryall"),
-  object_name,
-  external_id_fieldname = NULL,
-  content_type = c("CSV", "ZIP_CSV", "ZIP_XML", "ZIP_JSON"),
-  concurrency_mode = c("Parallel", "Serial"),
-  control,
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_create_job_bulk_v1(
+  operation = c("insert", "delete", "upsert", "update", "hardDelete", "query",
+    "queryall"),
+  object_name,
+  external_id_fieldname = NULL,
+  content_type = c("CSV", "ZIP_CSV", "ZIP_XML", "ZIP_JSON"),
+  concurrency_mode = c("Parallel", "Serial"),
+  control,
+  ...,
+  verbose = FALSE
+)

                  Note

                  @@ -220,7 +220,7 @@

                  Contents

                  -

                  Site built with pkgdown 1.5.1.

                  +

                  Site built with pkgdown 1.6.1.

                  diff --git a/docs/reference/sf_create_job_bulk_v2.html b/docs/reference/sf_create_job_bulk_v2.html index f750c194..8a9183de 100644 --- a/docs/reference/sf_create_job_bulk_v2.html +++ b/docs/reference/sf_create_job_bulk_v2.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@ 
                  • c("insert", "delete", "upsert", "update", "query", "queryall"),
-  object_name,
-  soql = NULL,
-  external_id_fieldname = NULL,
-  content_type = "CSV",
-  column_delimiter = c("COMMA", "TAB", "PIPE", "SEMICOLON", "CARET", "BACKQUOTE"),
-  control,
-  ...,
-  verbose = FALSE
-)
                    + 
                    sf_create_job_bulk_v2(
+  operation = c("insert", "delete", "upsert", "update", "query", "queryall"),
+  object_name,
+  soql = NULL,
+  external_id_fieldname = NULL,
+  content_type = "CSV",
+  column_delimiter = c("COMMA", "TAB", "PIPE", "SEMICOLON", "CARET", "BACKQUOTE"),
+  control,
+  ...,
+  verbose = FALSE
+)

                    Note

                    @@ -220,7 +220,7 @@

                    Contents

                    -

                    Site built with pkgdown 1.5.1.

                    +

                    Site built with pkgdown 1.6.1.

                    diff --git a/docs/reference/sf_create_metadata.html b/docs/reference/sf_create_metadata.html index 7a042278..ecd0d5db 100644 --- a/docs/reference/sf_create_metadata.html +++ b/docs/reference/sf_create_metadata.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -245,58 +245,59 @@

                See a

                Salesforce Documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # read the metadata of the existing Account object
 # we will use this object as a template to create a custom version
-metadata_info <- sf_read_metadata(metadata_type='CustomObject',
-                                  object_names=c('Account'))
-custom_metadata <- metadata_info[[1]]
+metadata_info <- sf_read_metadata(metadata_type='CustomObject',
+                                  object_names=c('Account'))
+custom_metadata <- metadata_info[[1]]
 # remove default actionOverrides, this cannot be set during creation
-custom_metadata[which(names(custom_metadata) %in% c("actionOverrides"))] <- NULL
+custom_metadata[which(names(custom_metadata) %in% c("actionOverrides"))] <- NULL
 # remove fields since its a custom object and the standard ones no longer exist
-custom_metadata[which(names(custom_metadata) %in% c("fields"))] <- NULL
+custom_metadata[which(names(custom_metadata) %in% c("fields"))] <- NULL
 # remove views so that we get the Standard List Views
-custom_metadata[which(names(custom_metadata) %in% c("listViews"))] <- NULL
+custom_metadata[which(names(custom_metadata) %in% c("listViews"))] <- NULL
 # remove links so that we get the Standard Web Links
-custom_metadata[which(names(custom_metadata) %in% c("webLinks"))] <- NULL
+custom_metadata[which(names(custom_metadata) %in% c("webLinks"))] <- NULL
 # now make some adjustments to customize the object
-this_label <- 'Custom_Account43'
-custom_metadata$fullName <- paste0(this_label, '__c')
-custom_metadata$label <- this_label
-custom_metadata$pluralLabel <- paste0(this_label, 's')
-custom_metadata$nameField <- list(displayFormat='AN-{0000}',
-                                  label='Account Number',
-                                  type='AutoNumber')
-custom_metadata$fields <- list(fullName="Phone__c",
-                               label="Phone",
-                               type="Phone")
+this_label <- 'Custom_Account43'
+custom_metadata$fullName <- paste0(this_label, '__c')
+custom_metadata$label <- this_label
+custom_metadata$pluralLabel <- paste0(this_label, 's')
+custom_metadata$nameField <- list(displayFormat='AN-{0000}',
+                                  label='Account Number',
+                                  type='AutoNumber')
+custom_metadata$fields <- list(fullName="Phone__c",
+                               label="Phone",
+                               type="Phone")
 # set the deployment status, this must be set before creation
-custom_metadata$deploymentStatus <- 'Deployed'
+custom_metadata$deploymentStatus <- 'Deployed'
 # make a description to identify this easily in the UI setup tab
-custom_metadata$description <- 'created by the Metadata API'
-new_custom_object <- sf_create_metadata(metadata_type = 'CustomObject',
-                                        metadata = custom_metadata,
-                                        verbose = TRUE)
+custom_metadata$description <- 'created by the Metadata API'
+new_custom_object <- sf_create_metadata(metadata_type = 'CustomObject',
+                                        metadata = custom_metadata, 
+                                        verbose = TRUE)
 
 # adding custom fields to our object 
 # input formatted as a list
-custom_fields <- list(list(fullName='Custom_Account43__c.CustomField66__c',
-                           label='CustomField66',
-                           length=100,
-                           type='Text'),
-                      list(fullName='Custom_Account43__c.CustomField77__c',
-                           label='CustomField77',
-                           length=100,
-                           type='Text'))
+custom_fields <- list(list(fullName='Custom_Account43__c.CustomField66__c',
+                           label='CustomField66',
+                           length=100,
+                           type='Text'),
+                      list(fullName='Custom_Account43__c.CustomField77__c',
+                           label='CustomField77',
+                           length=100,
+                           type='Text'))
 # formatted as a data.frame
-custom_fields <- data.frame(fullName=c('Custom_Account43__c.CustomField88__c',
-                                       'Custom_Account43__c.CustomField99__c'),
-                            label=c('Test Field1', 'Test Field2'),
-                            length=c(44,45),
-                            type=c('Text', 'Text'))
-new_custom_fields <- sf_create_metadata(metadata_type = 'CustomField',
-                                        metadata = custom_fields)
-}
                
+custom_fields <- data.frame(fullName=c('Custom_Account43__c.CustomField88__c',
+                                       'Custom_Account43__c.CustomField99__c'),
+                            label=c('Test Field1', 'Test Field2'),
+                            length=c(44,45),
+                            type=c('Text', 'Text'))
+new_custom_fields <- sf_create_metadata(metadata_type = 'CustomField', 
+                                        metadata = custom_fields)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_report.html b/docs/reference/sf_create_report.html index 03831385..bb4a2e81 100644 --- a/docs/reference/sf_create_report.html +++ b/docs/reference/sf_create_report.html @@ -101,7 +101,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -109,7 +109,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Create a new report using a POST request. To create a report, you only have to specify a name and report type to create a new report; all other metadata properties are optional. It is recommended to use the metadata from existing reports pulled @@ -198,12 +198,12 @@

                  Create a report

                  of a new report.

                  - 
                  sf_create_report(
-  name = NULL,
-  report_type = NULL,
-  report_metadata = NULL,
-  verbose = FALSE
-)
                  + 
                  sf_create_report(
+  name = NULL,
+  report_type = NULL,
+  report_metadata = NULL,
+  verbose = FALSE
+)

                  Arguments

                @@ -240,7 +240,7 @@

                Arg

                Value

                list representing the newly cloned report with up to 4 properties -that describe the report:

                +that describe the report:

                attributes

                Report type along with the URL to retrieve common objects and joined metadata.

                reportMetadata

                Unique identifiers for groupings and summaries.

                @@ -274,26 +274,27 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # creating a blank report using just the name and type
-my_new_report <- sf_create_report("Top Accounts Report", "AccountList")
+my_new_report <- sf_create_report("Top Accounts Report", "AccountList")
 
 # creating a report with additional metadata by grabbing an existing report
 # and modifying it slightly (only the name in this case)
 
 # first, grab all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # second, get the id of the report to copy
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
 # third, pull down its metadata and update the name
-report_describe_list <- sf_describe_report(this_report_id)
-report_describe_list$reportMetadata$name <- "TEST API Report Creation"
+report_describe_list <- sf_describe_report(this_report_id)
+report_describe_list$reportMetadata$name <- "TEST API Report Creation"
 
 # fourth, create the report by passing the metadata
-my_new_report <- sf_create_report(report_metadata=report_describe_list)
-}
                
+my_new_report <- sf_create_report(report_metadata=report_describe_list)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_create_rest.html b/docs/reference/sf_create_rest.html index b520bc9b..81d16452 100644 --- a/docs/reference/sf_create_rest.html +++ b/docs/reference/sf_create_rest.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -224,7 +224,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_copy.html b/docs/reference/sf_dashboard_copy.html index 31c38659..a133683b 100644 --- a/docs/reference/sf_dashboard_copy.html +++ b/docs/reference/sf_dashboard_copy.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -224,7 +224,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_delete.html b/docs/reference/sf_dashboard_delete.html index 216c1abe..f6ca2d44 100644 --- a/docs/reference/sf_dashboard_delete.html +++ b/docs/reference/sf_dashboard_delete.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -219,7 +219,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_describe.html b/docs/reference/sf_dashboard_describe.html index a8d87c03..15b29422 100644 --- a/docs/reference/sf_dashboard_describe.html +++ b/docs/reference/sf_dashboard_describe.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Returns metadata for the specified dashboard, including dashboard components, filters, layout, and the running user.

                  - 
                  sf_dashboard_describe(dashboard_id, as_tbl = TRUE, verbose = FALSE)
                  + 
                  sf_dashboard_describe(dashboard_id, as_tbl = TRUE, verbose = FALSE)

                  Arguments

                @@ -243,7 +243,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_filter_operators_list.html b/docs/reference/sf_dashboard_filter_operators_list.html index b09179ce..b0fd50c0 100644 --- a/docs/reference/sf_dashboard_filter_operators_list.html +++ b/docs/reference/sf_dashboard_filter_operators_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -234,7 +234,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_refresh.html b/docs/reference/sf_dashboard_refresh.html index 99a1bd5a..b0d2b6e2 100644 --- a/docs/reference/sf_dashboard_refresh.html +++ b/docs/reference/sf_dashboard_refresh.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -226,7 +226,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_results.html b/docs/reference/sf_dashboard_results.html index 6df74b84..2b1618a0 100644 --- a/docs/reference/sf_dashboard_results.html +++ b/docs/reference/sf_dashboard_results.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@
                @@ -243,7 +243,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_set_sticky_filter.html b/docs/reference/sf_dashboard_set_sticky_filter.html index e30ba7db..8a0d88ea 100644 --- a/docs/reference/sf_dashboard_set_sticky_filter.html +++ b/docs/reference/sf_dashboard_set_sticky_filter.html @@ -105,7 +105,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -113,7 +113,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Set a default filter value which gets applied to a dashboard when you open it. The default filter value you specify only applies to you (other people won’t see it when they open the dashboard). If you change the filter value @@ -206,10 +206,10 @@

                  Set a sticky dashboard filter

                  yourself, not for other users.

                  - 
                  sf_dashboard_set_sticky_filter(
-  dashboard_id,
-  dashboard_filters = c(character(0))
-)
                  + 
                  sf_dashboard_set_sticky_filter(
+  dashboard_id,
+  dashboard_filters = c(character(0))
+)

                  Arguments

                @@ -247,7 +247,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_status.html b/docs/reference/sf_dashboard_status.html index dd5dc52a..22a0e734 100644 --- a/docs/reference/sf_dashboard_status.html +++ b/docs/reference/sf_dashboard_status.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -237,7 +237,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboard_update.html b/docs/reference/sf_dashboard_update.html index ba045698..e04f66a3 100644 --- a/docs/reference/sf_dashboard_update.html +++ b/docs/reference/sf_dashboard_update.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -227,7 +227,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_dashboards_list.html b/docs/reference/sf_dashboards_list.html index 76bc8ddf..ca618772 100644 --- a/docs/reference/sf_dashboards_list.html +++ b/docs/reference/sf_dashboards_list.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -236,7 +236,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete.html b/docs/reference/sf_delete.html index 15c7bd38..c7bb8149 100644 --- a/docs/reference/sf_delete.html +++ b/docs/reference/sf_delete.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Deletes one or more records from your organization’s data.

                  - 
                  sf_delete(
-  ids,
-  object_name = NULL,
-  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
-  guess_types = TRUE,
-  control = list(...),
-  ...,
-  all_or_none = deprecated(),
-  verbose = FALSE
-)
                  + 
                  sf_delete(
+  ids,
+  object_name = NULL,
+  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
+  guess_types = TRUE,
+  control = list(...),
+  ...,
+  all_or_none = deprecated(),
+  verbose = FALSE
+)

                  Arguments

                @@ -265,17 +265,18 @@

                Note

                of records and not all records submitted to the function.

                Examples

                - 
                if (FALSE) {
-n <- 3
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n))
-new_records <- sf_create(new_contacts, object_name="Contact")
-deleted_first <- sf_delete(new_records$id[1], object_name = "Contact")
+    
                if (FALSE) {
+n <- 3
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact", 1:n))
+new_records <- sf_create(new_contacts, object_name="Contact")
+deleted_first <- sf_delete(new_records$id[1], object_name = "Contact")  
 
 # add the control to do an "All or None" deletion of the remaining records
-deleted_rest <- sf_delete(new_records$id[2:3], object_name = "Contact",
-                          AllOrNoneHeader = list(allOrNone = TRUE))
-}
                
+deleted_rest <- sf_delete(new_records$id[2:3], object_name = "Contact", 
+                          AllOrNoneHeader = list(allOrNone = TRUE))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_attachment.html b/docs/reference/sf_delete_attachment.html index a9e26ceb..fe34cbec 100644 --- a/docs/reference/sf_delete_attachment.html +++ b/docs/reference/sf_delete_attachment.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  This function is a wrapper around sf_delete that accepts a list of Ids and assumes that they are in the Attachment object and should be deleted. This function is solely provided as a convenience and to provide the last attachment function to parallel the CRUD functionality for all other records.

                  - 
                  sf_delete_attachment(
-  ids,
-  object_name = c("Attachment"),
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_delete_attachment(
+  ids,
+  object_name = c("Attachment"),
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -255,20 +255,21 @@

                See a sf_update_attachment()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # upload a PDF to a particular record as an Attachment
-file_path <- system.file("extdata",
+file_path <- system.file("extdata",
                          "data-wrangling-cheatsheet.pdf",
-                         package = "salesforcer")
-parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
-attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
-create_result <- sf_create_attachment(attachment_details)
+                         package = "salesforcer")
+parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
+attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
+create_result <- sf_create_attachment(attachment_details)
 
 # now delete the attachment
 # note that the function below is just running the following!
 # sf_delete(ids = create_result$id)
-sf_delete_attachment(ids = create_result$id)
-}
                
+sf_delete_attachment(ids = create_result$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_bulk_v1.html b/docs/reference/sf_delete_bulk_v1.html index d3c6b36d..9a52acb6 100644 --- a/docs/reference/sf_delete_bulk_v1.html +++ b/docs/reference/sf_delete_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -215,11 +215,12 @@

                Arg

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-sf_abort_job_bulk(job_info$id)
-sf_delete_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+sf_abort_job_bulk(job_info$id)
+sf_delete_job_bulk(job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_metadata.html b/docs/reference/sf_delete_metadata.html index dcc5dae2..66a03c7d 100644 --- a/docs/reference/sf_delete_metadata.html +++ b/docs/reference/sf_delete_metadata.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -242,10 +242,11 @@

                See a

                sf_list_metadata, Salesforce Documentation

                Examples

                - 
                if (FALSE) {
-metadata_info <- sf_delete_metadata(metadata_type = 'CustomObject',
-                                    object_names = c('Custom_Account25__c'))
-}
                + 
                if (FALSE) {
+metadata_info <- sf_delete_metadata(metadata_type = 'CustomObject', 
+                                    object_names = c('Custom_Account25__c'))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_report.html b/docs/reference/sf_delete_report.html index 200c2006..836291ac 100644 --- a/docs/reference/sf_delete_report.html +++ b/docs/reference/sf_delete_report.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -240,16 +240,17 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, grab all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # second, get the id of the report to delete
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
 # third, delete that report using its Id
-success <- sf_delete_report(this_report_id)
-}
                
+success <- sf_delete_report(this_report_id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_report_instance.html b/docs/reference/sf_delete_report_instance.html index 6684e398..dbf59505 100644 --- a/docs/reference/sf_delete_report_instance.html +++ b/docs/reference/sf_delete_report_instance.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -236,18 +236,19 @@

                See a sf_list_report_instances()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, get the Id of a report in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
-this_report_id <- all_reports$Id[1]
+all_reports <- sf_query("SELECT Id, Name FROM Report")
+this_report_id <- all_reports$Id[1]
 
 # second, ensure that report has been executed at least once asynchronously
-results <- sf_execute_report(this_report_id, async=TRUE)
+results <- sf_execute_report(this_report_id, async=TRUE)
 
 # check if that report has succeeded, if so (or if it errored), then delete
-instance_list <- sf_list_report_instances(this_report_id)
-instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
-}
                
+instance_list <- sf_list_report_instances(this_report_id)
+instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_delete_rest.html b/docs/reference/sf_delete_rest.html index eeae90c7..1048ddde 100644 --- a/docs/reference/sf_delete_rest.html +++ b/docs/reference/sf_delete_rest.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -212,10 +212,11 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # describe metadata for the organization associated with the session
-metadata_info <- sf_describe_metadata()
-}
                
+metadata_info <- sf_describe_metadata()
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_describe_object_fields.html b/docs/reference/sf_describe_object_fields.html index d8b73d16..839a0c41 100644 --- a/docs/reference/sf_describe_object_fields.html +++ b/docs/reference/sf_describe_object_fields.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  This function takes the name of an object in Salesforce and returns a description of the fields on that object by returning a tibble with one row per field.

                  - 
                  sf_describe_object_fields(object_name)
                  + 
                  sf_describe_object_fields(object_name)

                  Arguments

                @@ -213,9 +213,10 @@

                Note

                the user's field-level security settings.

                Examples

                - 
                if (FALSE) {
-acct_fields <- sf_describe_object_fields('Account')
-}
                + 
                if (FALSE) {
+acct_fields <- sf_describe_object_fields('Account')
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_describe_objects.html b/docs/reference/sf_describe_objects.html index bd084ebc..7be9ddd6 100644 --- a/docs/reference/sf_describe_objects.html +++ b/docs/reference/sf_describe_objects.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Describes the individual metadata for the specified object.

                  - 
                  sf_describe_objects(
-  object_names,
-  api_type = c("SOAP", "REST"),
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_describe_objects(
+  object_names,
+  api_type = c("SOAP", "REST"),
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -239,13 +239,14 @@

                See a

                REST API Documentation, REST API Example

                Examples

                - 
                if (FALSE) {
-account_metadata <- sf_describe_objects("Account")
-account_metadata_SOAP <- sf_describe_objects("Account", api_type="SOAP")
-multiple_objs_metadata <- sf_describe_objects(c("Contact", "Lead"))
-
-account_metadata_REST <- sf_describe_objects("Account", api_type="REST")
-}
                + 
                if (FALSE) {
+account_metadata <- sf_describe_objects("Account")
+account_metadata_SOAP <- sf_describe_objects("Account", api_type="SOAP")
+multiple_objs_metadata <- sf_describe_objects(c("Contact", "Lead"))
+
+account_metadata_REST <- sf_describe_objects("Account", api_type="REST")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_describe_report.html b/docs/reference/sf_describe_report.html index 7e79d2d4..91a5d297 100644 --- a/docs/reference/sf_describe_report.html +++ b/docs/reference/sf_describe_report.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -213,7 +213,7 @@

                Arg

                Value

                -

                list containing up to 4 properties that describe the report:

                +

                list containing up to 4 properties that describe the report:

                attributes

                Report type along with the URL to retrieve common objects and joined metadata.

                reportMetadata

                Unique identifiers for groupings and summaries.

                reportTypeMetadata

                Fields in each section of a report type plus filter information for those fields.

                @@ -256,17 +256,18 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # pull a list of up to 200 recent reports
 # (for a full list you must use sf_query on the Report object)
-reports <- sf_list_reports()
+reports <- sf_list_reports()
 
 # id for the first report
-reports[[1,"id"]]
+reports[[1,"id"]]
 
 # describe that report type
-described_report <- sf_describe_report_type(unique_report_types[[1,"id"]])
-}
                
+described_report <- sf_describe_report_type(unique_report_types[[1,"id"]])
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_describe_report_type.html b/docs/reference/sf_describe_report_type.html index a6a383d3..773ea26d 100644 --- a/docs/reference/sf_describe_report_type.html +++ b/docs/reference/sf_describe_report_type.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -215,7 +215,7 @@

                Arg

                Value

                -

                list containing up to 4 properties that describe the report:

                +

                list containing up to 4 properties that describe the report:

                attributes

                Report type along with the URL to retrieve common objects and joined metadata.

                reportMetadata

                Unique identifiers for groupings and summaries.

                @@ -249,16 +249,17 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
-reports <- sf_list_report_types()
-unique_report_types <- reports %>% distinct(reportTypes.type)
+    
                if (FALSE) {
+reports <- sf_list_report_types()
+unique_report_types <- reports %>% distinct(reportTypes.type)
 
 # first unique report type
-unique_report_types[[1,1]]
+unique_report_types[[1,1]]
 
 # describe that report type
-described_report <- sf_describe_report_type(unique_report_types[[1,1]])
-}
                
+described_report <- sf_describe_report_type(unique_report_types[[1,1]])
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_download_attachment.html b/docs/reference/sf_download_attachment.html index 09879c7b..80e6c04c 100644 --- a/docs/reference/sf_download_attachment.html +++ b/docs/reference/sf_download_attachment.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  This function will allow you to download an attachment to disk based on the attachment body, file name, and path.

                  - 
                  sf_download_attachment(
-  body,
-  name = NULL,
-  sf_id = NULL,
-  object_name = c("Attachment", "Document"),
-  path = "."
-)
                  + 
                  sf_download_attachment(
+  body,
+  name = NULL,
+  sf_id = NULL,
+  object_name = c("Attachment", "Document"),
+  path = "."
+)

                  Arguments

                @@ -256,19 +256,20 @@

                See a sf_update_attachment()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # downloading all attachments for a Parent record
 # if your attachment name doesn't include the extension, then you can use the 
 # ContentType column to append it to the Name, if needed
-queried_attachments <- sf_query("SELECT Id, Body, Name, ContentType 
+queried_attachments <- sf_query("SELECT Id, Body, Name, ContentType 
                                  FROM Attachment 
-                                 WHERE ParentId = '0016A0000035mJ5'")
-mapply(sf_download_attachment, queried_attachments$Body, queried_attachments$Name)
+                                 WHERE ParentId = '0016A0000035mJ5'")
+mapply(sf_download_attachment, queried_attachments$Body, queried_attachments$Name)
 
 # downloading an attachment by its Id
 # (the file name will be the same as it exists in Salesforce)
-sf_download_attachment(sf_id = queried_attachments$Id[1])
-}
                
+sf_download_attachment(sf_id = queried_attachments$Id[1])
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_empty_recycle_bin.html b/docs/reference/sf_empty_recycle_bin.html index aed499a5..545b7ad7 100644 --- a/docs/reference/sf_empty_recycle_bin.html +++ b/docs/reference/sf_empty_recycle_bin.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -233,28 +233,29 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_calls_emptyrecyclebin.htm

                Examples

                - 
                if (FALSE) {
-new_contact <- c(FirstName = "Test", LastName = "Contact")
-new_records <- sf_create(new_contact, object_name = "Contact")
-delete <- sf_delete(new_records$id[1],
-                    AllOrNoneHeader = list(allOrNone = TRUE))
-is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
-                       new_records$id[1]),
-                       queryall = TRUE)
-hard_deleted <- sf_empty_recycle_bin(new_records$id[1])
+    
                if (FALSE) {
+new_contact <- c(FirstName = "Test", LastName = "Contact")
+new_records <- sf_create(new_contact, object_name = "Contact")
+delete <- sf_delete(new_records$id[1],
+                    AllOrNoneHeader = list(allOrNone = TRUE))
+is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
+                       new_records$id[1]),
+                       queryall = TRUE)
+hard_deleted <- sf_empty_recycle_bin(new_records$id[1])
 
 # confirm that the record really is gone (can't be deleted)
-undelete <- sf_undelete(new_records$id[1])
+undelete <- sf_undelete(new_records$id[1])
 # if you use queryall you still will find the record for ~24hrs
-is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
-                               new_records$id[1]), queryall = TRUE)
-
+is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'", 
+                               new_records$id[1]), queryall = TRUE)
+                               
 # As of v48.0 (Spring 2020) you can query the Ids of all records in the Recycle 
 # Bin, which makes it easier to clear the entire bin because you can grab the 
 # Ids of the records first
-records_in_bin <- sf_query("SELECT Record FROM DeleteEvent")
-records_emptied_from_bin <- sf_delete(records_in_bin$Record)
-}
                
+records_in_bin <- sf_query("SELECT Record FROM DeleteEvent")
+records_emptied_from_bin <- sf_delete(records_in_bin$Record)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_end_job_bulk.html b/docs/reference/sf_end_job_bulk.html index 4ad8aa82..a2edc818 100644 --- a/docs/reference/sf_end_job_bulk.html +++ b/docs/reference/sf_end_job_bulk.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -242,7 +242,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_execute_report.html b/docs/reference/sf_execute_report.html index 97a6e26d..54cd57e1 100644 --- a/docs/reference/sf_execute_report.html +++ b/docs/reference/sf_execute_report.html @@ -103,7 +103,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -111,7 +111,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Get summary data with or without details by running a report synchronously or asynchronously through the API. When you run a report, the API returns data for the same number of records that are available when the report is run in @@ -202,17 +202,17 @@

                  Execute a report

                  use sf_run_report.

                  - 
                  sf_execute_report(
-  report_id,
-  async = FALSE,
-  include_details = TRUE,
-  labels = TRUE,
-  guess_types = TRUE,
-  bind_using_character_cols = FALSE,
-  as_tbl = TRUE,
-  report_metadata = NULL,
-  verbose = FALSE
-)
                  + 
                  sf_execute_report(
+  report_id,
+  async = FALSE,
+  include_details = TRUE,
+  labels = TRUE,
+  guess_types = TRUE,
+  bind_using_character_cols = deprecated(),
+  as_tbl = TRUE,
+  report_metadata = NULL,
+  verbose = FALSE
+)

                  Arguments

                @@ -275,7 +275,7 @@

                Arg elements of reportMetadata are documented HERE, but you will most commonly only need to specify the following 3 elements to -filter or query the results of an existing report:

                +filter or query the results of an existing report:

                reportFormat

                A character specifying the format of the report with possible values: "TABULAR", "SUMMARY", "MATRIX", or "MULTI_BLOCK".

                @@ -356,25 +356,25 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, get the Id of a report in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
-this_report_id <- all_reports$Id[1]
+all_reports <- sf_query("SELECT Id, Name FROM Report")
+this_report_id <- all_reports$Id[1]
 
 # then execute a synchronous report that will wait for the results
-results <- sf_execute_report(this_report_id)
+results <- sf_execute_report(this_report_id)
 
 # alternatively, you can execute an async report and then grab its results when done
 #   - The benefit of an async report is that the results will be stored for up to
 #     24 hours for faster recall, if needed
-results <- sf_execute_report(this_report_id, async=TRUE)
+results <- sf_execute_report(this_report_id, async=TRUE)
 
 # check if completed and proceed if the status is "Success"
-instance_list <- sf_list_report_instances(report_id)
-instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
-if(instance_status == "Success"){
-  results <- sf_get_report_instance_results(report_id, results$id)
-}
+instance_list <- sf_list_report_instances(report_id)
+instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
+if(instance_status == "Success"){
+  results <- sf_get_report_instance_results(report_id, results$id)
+}
 
 # Note: For more complex execution use the report_metadata argument.
 # This can be done by building the list from scratch based on Salesforce 
@@ -382,13 +382,14 @@ 
                Examp
 # property of the report and modifying the list slightly (recommended). 
 # In addition, for relatively simple changes, you can leverage the convenience 
 # function sf_report_wrapper() which makes it easier to retrieve report results
-report_details <- sf_describe_report(this_report_id)
-report_metadata <- list(reportMetadata = report_details$reportMetadata)
-report_metadata$reportMetadata$showGrandTotal <- FALSE
-report_metadata$reportMetadata$showSubtotals <- FALSE
-fields <- sf_execute_report(this_report_id,
-                            report_metadata = report_metadata)
-}
                
+report_details <- sf_describe_report(this_report_id)
+report_metadata <- list(reportMetadata = report_details$reportMetadata)
+report_metadata$reportMetadata$showGrandTotal <- FALSE
+report_metadata$reportMetadata$showSubtotals <- FALSE
+fields <- sf_execute_report(this_report_id,
+                            report_metadata = report_metadata)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_find_duplicates.html b/docs/reference/sf_find_duplicates.html index c8e6bad8..adb1f39c 100644 --- a/docs/reference/sf_find_duplicates.html +++ b/docs/reference/sf_find_duplicates.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Performs rule-based searches for duplicate records.

                  - 
                  sf_find_duplicates(
-  search_criteria,
-  object_name,
-  include_record_details = FALSE,
-  guess_types = TRUE,
-  verbose = FALSE
-)
                  + 
                  sf_find_duplicates(
+  search_criteria,
+  object_name,
+  include_record_details = FALSE,
+  guess_types = TRUE,
+  verbose = FALSE
+)

                  Arguments

                @@ -246,18 +246,19 @@

                Note

                rules on the search criteria to determine which records in other objects are duplicates.

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # use the duplicate rules associated with the Lead object on the search 
 # criteria (email) in order to find duplicates
-found_dupes <- sf_find_duplicates(search_criteria =
-                                    list(Email="bond_john@grandhotels.com"),
-                                  object_name = "Lead")
-
+found_dupes <- sf_find_duplicates(search_criteria =
+                                    list(Email="bond_john@grandhotels.com"),
+                                  object_name = "Lead")
+                                  
 # now look for duplicates on email using the Contact object's rules
-found_dupes <- sf_find_duplicates(search_criteria =
-                                    list(Email="bond_john@grandhotels.com"),
-                                  object_name = "Contact")
-}
                
+found_dupes <- sf_find_duplicates(search_criteria = 
+                                    list(Email="bond_john@grandhotels.com"),
+                                  object_name = "Contact")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_find_duplicates_by_id.html b/docs/reference/sf_find_duplicates_by_id.html index bc3e7e12..7069b8af 100644 --- a/docs/reference/sf_find_duplicates_by_id.html +++ b/docs/reference/sf_find_duplicates_by_id.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Performs rule-based searches for duplicate records.

                  - 
                  sf_find_duplicates_by_id(
-  sf_id,
-  include_record_details = FALSE,
-  guess_types = TRUE,
-  verbose = FALSE
-)
                  + 
                  sf_find_duplicates_by_id(
+  sf_id,
+  include_record_details = FALSE,
+  guess_types = TRUE,
+  verbose = FALSE
+)

                  Arguments

                @@ -242,11 +242,12 @@

                Note

                Account object.

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # use the duplicate rules associated with the object that this record 
 # belongs to in order to find duplicates
-found_dupes <- sf_find_duplicates_by_id(sf_id = "00Q6A00000aABCnZZZ")
-}
                
+found_dupes <- sf_find_duplicates_by_id(sf_id = "00Q6A00000aABCnZZZ")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_format_date.html b/docs/reference/sf_format_date.html index bc2b1f80..6854c0c7 100644 --- a/docs/reference/sf_format_date.html +++ b/docs/reference/sf_format_date.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -244,12 +244,13 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/get_all_jobs.htm

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-all_jobs_info <- sf_get_all_jobs_bulk()
+    
                if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+all_jobs_info <- sf_get_all_jobs_bulk()
 # just the Bulk API 1.0 jobs
-all_jobs_info <- sf_get_all_jobs_bulk(parameterized_search_list=list(jobType='Classic'))
-}
                
+all_jobs_info <- sf_get_all_jobs_bulk(parameterized_search_list=list(jobType='Classic'))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_all_query_jobs_bulk.html b/docs/reference/sf_get_all_query_jobs_bulk.html index bedd0a5f..26b523e5 100644 --- a/docs/reference/sf_get_all_query_jobs_bulk.html +++ b/docs/reference/sf_get_all_query_jobs_bulk.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -248,14 +248,15 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/get_all_jobs.htm

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-all_query_jobs_info <- sf_get_all_query_jobs_bulk()
+    
                if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+all_query_jobs_info <- sf_get_all_query_jobs_bulk()
 # just the Bulk API 2.0 query jobs
-all_query_jobs_info <- sf_get_all_query_jobs_bulk(parameterized_search_list=list(jobType='V2Query'))
+all_query_jobs_info <- sf_get_all_query_jobs_bulk(parameterized_search_list=list(jobType='V2Query'))
 # just the Bulk API 1.0 query jobs
-all_query_jobs_info <- sf_get_all_query_jobs_bulk(parameterized_search_list=list(jobType='Classic'))
-}
                
+all_query_jobs_info <- sf_get_all_query_jobs_bulk(parameterized_search_list=list(jobType='Classic'))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_dashboard_data.html b/docs/reference/sf_get_dashboard_data.html index 4c2bd195..0df1695d 100644 --- a/docs/reference/sf_get_dashboard_data.html +++ b/docs/reference/sf_get_dashboard_data.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -237,7 +237,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_deleted.html b/docs/reference/sf_get_deleted.html index d7403a90..1cc79078 100644 --- a/docs/reference/sf_get_deleted.html +++ b/docs/reference/sf_get_deleted.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -226,10 +226,11 @@

                Note

                This API ignores the seconds portion of the supplied datetime values.

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # get all deleted Contact records from midnight until now
-deleted_recs <- sf_get_deleted("Contact", Sys.Date(), Sys.time())
-}
                
+deleted_recs <- sf_get_deleted("Contact", Sys.Date(), Sys.time())
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_job_bulk.html b/docs/reference/sf_get_job_bulk.html index bdda9325..33c41410 100644 --- a/docs/reference/sf_get_job_bulk.html +++ b/docs/reference/sf_get_job_bulk.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -232,11 +232,12 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-refreshed_job_info <- sf_get_job_bulk(job_info$id)
-sf_abort_job_bulk(refreshed_job_info$id)
-}
                + 
                if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+refreshed_job_info <- sf_get_job_bulk(job_info$id)
+sf_abort_job_bulk(refreshed_job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_job_records_bulk.html b/docs/reference/sf_get_job_records_bulk.html index fa9dbcf5..18b5924f 100644 --- a/docs/reference/sf_get_job_records_bulk.html +++ b/docs/reference/sf_get_job_records_bulk.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -214,14 +214,14 @@

                Arg

                - + +together by binding the rows

                @@ -245,15 +245,16 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk('insert', 'Account')
-input_data <- tibble(Name=c("Test Account 1", "Test Account 2"))
-batches_result <- sf_create_batches_bulk(job_info$id, input_data)
+    
                if (FALSE) {
+job_info <- sf_create_job_bulk('insert', 'Account')
+input_data <- tibble(Name=c("Test Account 1", "Test Account 2"))
+batches_result <- sf_create_batches_bulk(job_info$id, input_data)
 # pause a few seconds for operation to finish. Wait longer if job is not complete.
-Sys.sleep(3)
+Sys.sleep(3)
 # check status using - sf_get_job_bulk(job_info$id)
-job_record_details <- sf_get_job_records_bulk(job_id=job_info$id)
-}
                
+job_record_details <- sf_get_job_records_bulk(job_id=job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_report_instance_results.html b/docs/reference/sf_get_report_instance_results.html index 562e55d6..edb577c9 100644 --- a/docs/reference/sf_get_report_instance_results.html +++ b/docs/reference/sf_get_report_instance_results.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Retrieves results for an instance of a report run asynchronously with or without filters. Depending on your asynchronous report run request, data can be at the summary level or include details.

                  - 
                  sf_get_report_instance_results(
-  report_id,
-  report_instance_id,
-  labels = TRUE,
-  guess_types = TRUE,
-  bind_using_character_cols = FALSE,
-  fact_map_key = "T!T",
-  verbose = FALSE
-)
                  + 
                  sf_get_report_instance_results(
+  report_id,
+  report_instance_id,
+  labels = TRUE,
+  guess_types = TRUE,
+  bind_using_character_cols = deprecated(),
+  fact_map_key = "T!T",
+  verbose = FALSE
+)

                  Arguments

                record_types

                character; one or more types of records to retrieve from -the results of running the specified job

                character; one or more types of records to retrieve +from the results of running the specified job
                combine_record_types

                logical; indicating for Bulk 2.0 jobs whether the successfulResults, failedResults, and unprocessedRecords should be stacked -together by binding the rows.
                verbose
                @@ -268,7 +268,7 @@

                Value

                data from the "T!T" entry in the fact map.

                Note

                -

                Below are the fact map key patterns for three report types:

                +

                Below are the fact map key patterns for three report types:

                TABULAR

                T!T: The grand total of a report. Both record data values and the grand total are represented by this key.

                SUMMARY

                <First level row grouping_second level row grouping_third @@ -280,7 +280,7 @@

                Note

                Each item in a row or column grouping is numbered starting with 0. Here are some examples of fact map keys:

                - +
                0!T

                The first item in the first-level grouping.

                1!T

                The second item in the first-level grouping.

                0_0!T

                The first item in the first-level grouping and the first item @@ -307,22 +307,23 @@

                See a sf_list_report_instances()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # execute a report asynchronously in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
-this_report_id <- all_reports$Id[1]
-results <- sf_execute_report(this_report_id, async=TRUE)
+all_reports <- sf_query("SELECT Id, Name FROM Report")
+this_report_id <- all_reports$Id[1]
+results <- sf_execute_report(this_report_id, async=TRUE)
 
 # check if that report has succeeded, ... 
-instance_list <- sf_list_report_instances(this_report_id)
-instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
+instance_list <- sf_list_report_instances(this_report_id)
+instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
 
 # ... if so, then grab the results
-if(instance_status == "Success"){
-  report_data <- sf_get_report_instance_results(report_id = this_report_id,
-                                                report_instance_id = results$id)
-}
-}
                
+if(instance_status == "Success"){
+  report_data <- sf_get_report_instance_results(report_id = this_report_id, 
+                                                report_instance_id = results$id)
+}
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_get_updated.html b/docs/reference/sf_get_updated.html index c3a69e3f..5b2d1d9c 100644 --- a/docs/reference/sf_get_updated.html +++ b/docs/reference/sf_get_updated.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -226,10 +226,11 @@

                Note

                This API ignores the seconds portion of the supplied datetime values.

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # get all updated Contact records from midnight until now
-updated_recs <- sf_get_updated("Contact", Sys.Date(), Sys.time())
-}
                
+updated_recs <- sf_get_updated("Contact", Sys.Date(), Sys.time())
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_guess_cols.html b/docs/reference/sf_guess_cols.html index 2d7803e8..03e5505f 100644 --- a/docs/reference/sf_guess_cols.html +++ b/docs/reference/sf_guess_cols.html @@ -6,7 +6,7 @@ -Reorder resultset columns to prioritize <code>sObject</code> and <code>Id</code> — sf_guess_cols • salesforcer +Parse resultset columns to a known datatype in R — sf_guess_cols • salesforcer @@ -52,7 +52,7 @@ - + @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -221,7 +221,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_input_data_validation.html b/docs/reference/sf_input_data_validation.html index c60893f9..c0f4185c 100644 --- a/docs/reference/sf_input_data_validation.html +++ b/docs/reference/sf_input_data_validation.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -226,14 +226,15 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-job_info <- sf_create_job_bulk(operation = "query", object = "Account")
-soql <- "SELECT Id, Name FROM Account LIMIT 10"
-batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
-submitted_batches <- sf_job_batches_bulk(job_id=batch_query_info$jobId)
-job_close_ind <- sf_close_job_bulk(job_info$id)
-sf_get_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+job_info <- sf_create_job_bulk(operation = "query", object = "Account")
+soql <- "SELECT Id, Name FROM Account LIMIT 10"
+batch_query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = soql)
+submitted_batches <- sf_job_batches_bulk(job_id=batch_query_info$jobId)
+job_close_ind <- sf_close_job_bulk(job_info$id)
+sf_get_job_bulk(job_info$id)                               
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_api_limits.html b/docs/reference/sf_list_api_limits.html index 4032a89c..1559bd25 100644 --- a/docs/reference/sf_list_api_limits.html +++ b/docs/reference/sf_list_api_limits.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Lists information about limits in your org.

                  - 
                  sf_list_api_limits()
                  + 
                  sf_list_api_limits()

                  Value

                  @@ -229,9 +229,10 @@

                  Note

                  Examples

                  - 
                  if (FALSE) {
-sf_list_api_limits()
-}
                  + 
                  if (FALSE) {
+sf_list_api_limits()
+}
+
                  -

                  Site built with pkgdown 1.5.1.

                  +

                  Site built with pkgdown 1.6.1.

                  diff --git a/docs/reference/sf_list_metadata.html b/docs/reference/sf_list_metadata.html index 3b0285b8..a1da3ba5 100644 --- a/docs/reference/sf_list_metadata.html +++ b/docs/reference/sf_list_metadata.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -223,13 +223,14 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # pull back a list of all Custom Objects and Email Templates
-my_queries <- list(list(type='CustomObject'),
-                   list(folder='unfiled$public',
-                        type='EmailTemplate'))
-metadata_info <- sf_list_metadata(queries=my_queries)
-}
                
+my_queries <- list(list(type='CustomObject'),
+                   list(folder='unfiled$public',
+                        type='EmailTemplate'))
+metadata_info <- sf_list_metadata(queries=my_queries)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_objects.html b/docs/reference/sf_list_objects.html index b871b686..63342f4c 100644 --- a/docs/reference/sf_list_objects.html +++ b/docs/reference/sf_list_objects.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Lists the available objects and their metadata for your organization’s data.

                  - 
                  sf_list_objects()
                  + 
                  sf_list_objects()

                  Value

                  @@ -198,9 +198,10 @@

                  Value

                  list

                  Examples

                  - 
                  if (FALSE) {
-sf_list_objects()
-}
                  + 
                  if (FALSE) {
+sf_list_objects()
+}
+
                  -

                  Site built with pkgdown 1.5.1.

                  +

                  Site built with pkgdown 1.6.1.

                  diff --git a/docs/reference/sf_list_report_fields.html b/docs/reference/sf_list_report_fields.html index 164f8932..b9989ae9 100644 --- a/docs/reference/sf_list_report_fields.html +++ b/docs/reference/sf_list_report_fields.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                  • Experimental lifecycle

                    +

                    [Experimental]

                    The Report Fields resource returns report fields available for specified reports. Use the resource to determine the best fields for use in dashboard filters by seeing which fields different source reports have in common. Available in API version 40.0 and later.

                    - 
                    sf_list_report_fields(
-  report_id,
-  intersect_with = c(character(0)),
-  verbose = FALSE
-)
                    + 
                    sf_list_report_fields(
+  report_id,
+  intersect_with = c(character(0)),
+  verbose = FALSE
+)

                    Arguments

                @@ -229,7 +229,7 @@

                Arg

                Value

                -

                list representing the 4 different field report properties:

                +

                list representing the 4 different field report properties:

                displayGroups

                Fields available when adding a filter.

                equivalentFields

                Fields available for each specified report. Each object in this array is a list of common fields categorized by report type.

                equivalentFieldIndices

                Map of each field’s API name to the index of the field in the equivalentFields array.

                @@ -262,16 +262,17 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, grab all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # second, get the id of the report to check fields on
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
 # third, pull that report and intersect its fields with up to three other reports
-fields <- sf_list_report_fields(this_report_id, intersect_with=head(all_reports[["Id"]],3))
-}
                
+fields <- sf_list_report_fields(this_report_id, intersect_with=head(all_reports[["Id"]],3))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_report_filter_operators.html b/docs/reference/sf_list_report_filter_operators.html index d770689c..e10a5f69 100644 --- a/docs/reference/sf_list_report_filter_operators.html +++ b/docs/reference/sf_list_report_filter_operators.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Use the Filter Operators API to get information about which filter operators are available for reports and dashboards. The Filter Operators API is available in API version 40.0 and later.

                  - 
                  sf_list_report_filter_operators(as_tbl = TRUE, verbose = FALSE)
                  + 
                  sf_list_report_filter_operators(as_tbl = TRUE, verbose = FALSE)

                  Arguments

                @@ -243,13 +243,14 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
-report_filters <- sf_list_report_filter_operators()
-unique_supported_fields <- report_filters %>% distinct(supported_field_type)
+    
                if (FALSE) {
+report_filters <- sf_list_report_filter_operators()
+unique_supported_fields <- report_filters %>% distinct(supported_field_type)
 
 # operators to filter a picklist field
-picklist_field_operators <- report_filters %>% filter(supported_field_type == "picklist")
-}
                
+picklist_field_operators <- report_filters %>% filter(supported_field_type == "picklist")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_report_instances.html b/docs/reference/sf_list_report_instances.html index 9c924da5..adb78bef 100644 --- a/docs/reference/sf_list_report_instances.html +++ b/docs/reference/sf_list_report_instances.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Returns a list of instances for a report that you requested to be run asynchronously. Each item in the list is treated as a separate instance of the report run with metadata in that snapshot of time.

                  - 
                  sf_list_report_instances(report_id, as_tbl = TRUE, verbose = FALSE)
                  + 
                  sf_list_report_instances(report_id, as_tbl = TRUE, verbose = FALSE)

                  Arguments

                @@ -238,19 +238,20 @@

                See a sf_get_report_instance_results()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, get the Id of a report in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
-this_report_id <- all_reports$Id[1]
+all_reports <- sf_query("SELECT Id, Name FROM Report")
+this_report_id <- all_reports$Id[1]
 
 # second, execute an async report
-results <- sf_execute_report(this_report_id, async=TRUE)
+results <- sf_execute_report(this_report_id, async=TRUE)
 
 # third, pull a list of async requests ("instances") usually meant for checking 
 # if a recently requested report has succeeded and the results can be retrieved
-instance_list <- sf_list_report_instances(this_report_id)
-instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
-}
                
+instance_list <- sf_list_report_instances(this_report_id)
+instance_status <- instance_list[[which(instance_list$id == results$id), "status"]]
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_report_types.html b/docs/reference/sf_list_report_types.html index bbacdce6..f6b80d35 100644 --- a/docs/reference/sf_list_report_types.html +++ b/docs/reference/sf_list_report_types.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -238,13 +238,14 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
-report_types <- sf_list_report_types()
-unique_report_types <- report_types %>% select(reportTypes.type)
+    
                if (FALSE) {
+report_types <- sf_list_report_types()
+unique_report_types <- report_types %>% select(reportTypes.type)
 
 # return the results as a list
-reports_as_list <- sf_list_report_types(as_tbl=FALSE)
-}
                
+reports_as_list <- sf_list_report_types(as_tbl=FALSE)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_reports.html b/docs/reference/sf_list_reports.html index 0f179cc4..d12bc343 100644 --- a/docs/reference/sf_list_reports.html +++ b/docs/reference/sf_list_reports.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Displays a list of full list of reports based on the Report object. If recent is up to 200 tabular, matrix, or summary reports that you recently viewed. To get additional details on reports by format, name, and other fields, use a SOQL query on the Report object.

                  - 
                  sf_list_reports(recent = FALSE, as_tbl = TRUE, verbose = FALSE)
                  + 
                  sf_list_reports(recent = FALSE, as_tbl = TRUE, verbose = FALSE)

                  Arguments

                @@ -260,16 +260,17 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # to return all possible reports, which is queried from the Report object
-reports <- sf_list_reports()
+reports <- sf_list_reports()
 
 # return the results as a list
-reports_as_list <- sf_list_reports(as_tbl=FALSE)
+reports_as_list <- sf_list_reports(as_tbl=FALSE)
 
 # return up to 200 recently viewed reports
-all_reports <- sf_list_reports(recent=TRUE)
-}
                
+all_reports <- sf_list_reports(recent=TRUE)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_list_resources.html b/docs/reference/sf_list_resources.html index 413b941f..aa96f934 100644 --- a/docs/reference/sf_list_resources.html +++ b/docs/reference/sf_list_resources.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Lists available resources for the specified API version, including resource name and URI.

                  - 
                  sf_list_resources()
                  + 
                  sf_list_resources()

                  Value

                  @@ -200,9 +200,10 @@

                  Value

                  list

                  Examples

                  - 
                  if (FALSE) {
-sf_list_resources()
-}
                  + 
                  if (FALSE) {
+sf_list_resources()
+}
+
                  -

                  Site built with pkgdown 1.5.1.

                  +

                  Site built with pkgdown 1.6.1.

                  diff --git a/docs/reference/sf_list_rest_api_versions.html b/docs/reference/sf_list_rest_api_versions.html index 5923711b..cf1cebdc 100644 --- a/docs/reference/sf_list_rest_api_versions.html +++ b/docs/reference/sf_list_rest_api_versions.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                  • Stable lifecycle

                    +

                    [Stable]

                    Lists summary information about each Salesforce version currently available, including the version, label, and a link to each version\'s root

                    - 
                    sf_list_rest_api_versions()
                    + 
                    sf_list_rest_api_versions()

                    Value

                    @@ -200,9 +200,10 @@

                    Value

                    list

                    Examples

                    - 
                    if (FALSE) {
-sf_list_rest_api_versions()
-}
                    + 
                    if (FALSE) {
+sf_list_rest_api_versions()
+}
+
                    -

                    Site built with pkgdown 1.5.1.

                    +

                    Site built with pkgdown 1.6.1.

                    diff --git a/docs/reference/sf_merge.html b/docs/reference/sf_merge.html index bf0f81e8..fe53c4f1 100644 --- a/docs/reference/sf_merge.html +++ b/docs/reference/sf_merge.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                    • Experimental lifecycle

                      +

                      [Experimental]

                      This function combines records of the same object type into one of the records, known as the master record. The other records, known as the victim records, will be deleted. If a victim record has related records the master record the new parent of the related records.

                      - 
                      sf_merge(
-  master_id,
-  victim_ids,
-  object_name,
-  master_fields = character(0),
-  api_type = c("SOAP"),
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                      + 
                      sf_merge(
+  master_id,
+  victim_ids,
+  object_name,
+  master_fields = character(0),
+  api_type = c("SOAP"),
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                      Arguments

                @@ -264,26 +264,27 @@

                Value

                tbl_df of records with success indicator

                Examples

                - 
                if (FALSE) {
-n <- 3
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n),
-                       Description = paste0("Description", 1:n))
-new_recs1 <- sf_create(new_contacts, object_name = "Contact")
+    
                if (FALSE) {
+n <- 3
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact", 1:n),
+                       Description = paste0("Description", 1:n))
+new_recs1 <- sf_create(new_contacts, object_name = "Contact")
 
 # merge the second and third into the first record, but set the
 # description field equal to the description of the second. All other fields
 # will from the first record or, if blank, from the other records
-merge_res <- sf_merge(master_id = new_recs1$id[1],
-                      victim_ids = new_recs1$id[2:3],
-                      object_name = "Contact",
-                      master_fields = tibble("Description" = new_contacts$Description[2]))
+merge_res <- sf_merge(master_id = new_recs1$id[1],
+                      victim_ids = new_recs1$id[2:3],
+                      object_name = "Contact",
+                      master_fields = tibble("Description" = new_contacts$Description[2]))
 # check the second and third records now have the same Master Record Id as the first
-merge_check <- sf_query(sprintf("SELECT Id, MasterRecordId, Description 
-                                 FROM Contact WHERE Id IN ('%s')",
-                                 paste0(new_recs1$id, collapse="','")),
-                        queryall = TRUE)
-}
                
+merge_check <- sf_query(sprintf("SELECT Id, MasterRecordId, Description 
+                                 FROM Contact WHERE Id IN ('%s')", 
+                                 paste0(new_recs1$id, collapse="','")), 
+                        queryall = TRUE)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query.html b/docs/reference/sf_query.html index a339aacb..bdfe3427 100644 --- a/docs/reference/sf_query.html +++ b/docs/reference/sf_query.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Executes a query against the specified object and returns data that matches the specified criteria.

                  - 
                  sf_query(
-  soql,
-  object_name = NULL,
-  queryall = FALSE,
-  guess_types = TRUE,
-  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
-  control = list(...),
-  ...,
-  page_size = deprecated(),
-  next_records_url = NULL,
-  bind_using_character_cols = FALSE,
-  object_name_append = FALSE,
-  object_name_as_col = FALSE,
-  verbose = FALSE
-)
                  + 
                  sf_query(
+  soql,
+  object_name = NULL,
+  queryall = FALSE,
+  guess_types = TRUE,
+  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
+  control = list(...),
+  ...,
+  page_size = deprecated(),
+  next_records_url = NULL,
+  bind_using_character_cols = deprecated(),
+  object_name_append = FALSE,
+  object_name_as_col = FALSE,
+  verbose = FALSE
+)

                  Arguments

                @@ -312,9 +312,10 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-sf_query("SELECT Id, Account.Name, Email FROM Contact LIMIT 10")
-}
                + 
                if (FALSE) {
+sf_query("SELECT Id, Account.Name, Email FROM Contact LIMIT 10")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_bulk_v1.html b/docs/reference/sf_query_bulk_v1.html index 205357d2..d57f6a2d 100644 --- a/docs/reference/sf_query_bulk_v1.html +++ b/docs/reference/sf_query_bulk_v1.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -286,15 +286,16 @@

                R

                Bulk 1.0 documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # select all Ids from Account object (up to 1000)
-ids <- sf_query_bulk_v1(soql = 'SELECT Id FROM Account LIMIT 1000',
-                        object_name = 'Account')
+ids <- sf_query_bulk_v1(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                        object_name = 'Account')
 # alternatively you can specify as 
-ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000',
-                object_name = 'Account',
-                api_type="Bulk 1.0")
-}
                
+ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                object_name = 'Account', 
+                api_type="Bulk 1.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_bulk_v2.html b/docs/reference/sf_query_bulk_v2.html index 78954c5b..aeb1d21c 100644 --- a/docs/reference/sf_query_bulk_v2.html +++ b/docs/reference/sf_query_bulk_v2.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -286,15 +286,16 @@

                R

                Bulk 2.0 documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # select all Ids from Account object (up to 1000)
-ids <- sf_query_bulk_v2(soql = 'SELECT Id FROM Account LIMIT 1000',
-                        object_name = 'Account')
+ids <- sf_query_bulk_v2(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                        object_name = 'Account')
 # alternatively you can specify as 
-ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000',
-                object_name = 'Account',
-                api_type="Bulk 2.0")
-}
                
+ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                object_name = 'Account', 
+                api_type="Bulk 2.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_report.html b/docs/reference/sf_query_report.html index 24801523..d969c28d 100644 --- a/docs/reference/sf_query_report.html +++ b/docs/reference/sf_query_report.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@
                @@ -211,7 +211,7 @@

                Arg elements of reportMetadata are documented HERE, but you will most commonly only need to specify the following 3 elements to -filter or query the results of an existing report:

                +filter or query the results of an existing report:

                reportFormat

                A character specifying the format of the report with possible values: "TABULAR", "SUMMARY", "MATRIX", or "MULTI_BLOCK".

                @@ -288,7 +288,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_result_bulk.html b/docs/reference/sf_query_result_bulk.html index 09ae3976..9eca44e7 100644 --- a/docs/reference/sf_query_result_bulk.html +++ b/docs/reference/sf_query_result_bulk.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                @@ -266,17 +266,18 @@

                R

                Bulk 1.0 documentation and Bulk 2.0 documentation

                Examples

                - 
                if (FALSE) {
-my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
-job_info <- sf_create_job_bulk(operation = 'query', object = 'Account')
-query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query)
-result <- sf_batch_details_bulk(job_id = query_info$jobId,
-                                batch_id = query_info$id)
-recordset <- sf_query_result_bulk(job_id = query_info$jobId,
-                                  batch_id = query_info$id,
-                                  result_id = result$result)
-sf_close_job_bulk(job_info$id)
-}
                + 
                if (FALSE) {
+my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
+job_info <- sf_create_job_bulk(operation = 'query', object = 'Account')
+query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query)
+result <- sf_batch_details_bulk(job_id = query_info$jobId,
+                                batch_id = query_info$id)
+recordset <- sf_query_result_bulk(job_id = query_info$jobId,
+                                  batch_id = query_info$id,
+                                  result_id = result$result)
+sf_close_job_bulk(job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_result_bulk_v1.html b/docs/reference/sf_query_result_bulk_v1.html index f6cd3661..38b838a5 100644 --- a/docs/reference/sf_query_result_bulk_v1.html +++ b/docs/reference/sf_query_result_bulk_v1.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -260,17 +260,18 @@

                R

                Bulk 1.0 documentation

                Examples

                - 
                if (FALSE) {
-my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
-job_info <- sf_create_job_bulk(operation = 'query', object = 'Account', api_type="Bulk 1.0")
-query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query, api_type="Bulk 1.0")
-result <- sf_batch_details_bulk(job_id = query_info$jobId,
-                                batch_id = query_info$id)
-recordset <- sf_query_result_bulk(job_id = query_info$jobId,
-                                  batch_id = query_info$id,
-                                  result_id = result$result)
-sf_close_job_bulk(job_info$id, api_type="Bulk 1.0")
-}
                + 
                if (FALSE) {
+my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
+job_info <- sf_create_job_bulk(operation = 'query', object = 'Account', api_type="Bulk 1.0")
+query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query, api_type="Bulk 1.0")
+result <- sf_batch_details_bulk(job_id = query_info$jobId,
+                                batch_id = query_info$id)
+recordset <- sf_query_result_bulk(job_id = query_info$jobId,
+                                  batch_id = query_info$id,
+                                  result_id = result$result)
+sf_close_job_bulk(job_info$id, api_type="Bulk 1.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_query_result_bulk_v2.html b/docs/reference/sf_query_result_bulk_v2.html index 5d4967db..c1a4a912 100644 --- a/docs/reference/sf_query_result_bulk_v2.html +++ b/docs/reference/sf_query_result_bulk_v2.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -263,17 +263,18 @@

                R

                Bulk 2.0 documentation

                Examples

                - 
                if (FALSE) {
-my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
-job_info <- sf_create_job_bulk(operation = 'query', object = 'Account', api_type="Bulk 2.0")
-query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query, api_type="Bulk 2.0")
-result <- sf_batch_details_bulk(job_id = query_info$jobId,
-                                batch_id = query_info$id)
-recordset <- sf_query_result_bulk(job_id = query_info$jobId,
-                                  batch_id = query_info$id,
-                                  result_id = result$result)
-sf_close_job_bulk(job_info$id, api_type="Bulk 2.0")
-}
                + 
                if (FALSE) {
+my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
+job_info <- sf_create_job_bulk(operation = 'query', object = 'Account', api_type="Bulk 2.0")
+query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query, api_type="Bulk 2.0")
+result <- sf_batch_details_bulk(job_id = query_info$jobId,
+                                batch_id = query_info$id)
+recordset <- sf_query_result_bulk(job_id = query_info$jobId,
+                                  batch_id = query_info$id,
+                                  result_id = result$result)
+sf_close_job_bulk(job_info$id, api_type="Bulk 2.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_read_metadata.html b/docs/reference/sf_read_metadata.html index a2df0703..104c41a4 100644 --- a/docs/reference/sf_read_metadata.html +++ b/docs/reference/sf_read_metadata.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -222,10 +222,11 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/

                Examples

                - 
                if (FALSE) {
-metadata_info <- sf_read_metadata(metadata_type='CustomObject',
-                                  object_names=c('Account'))
-}
                + 
                if (FALSE) {
+metadata_info <- sf_read_metadata(metadata_type='CustomObject', 
+                                  object_names=c('Account'))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_rename_metadata.html b/docs/reference/sf_rename_metadata.html index 26b78c08..2312d390 100644 --- a/docs/reference/sf_rename_metadata.html +++ b/docs/reference/sf_rename_metadata.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -228,11 +228,12 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/

                Examples

                - 
                if (FALSE) {
-renamed_custom_object <- sf_rename_metadata(metadata_type = 'CustomObject',
-                                            old_fullname = 'Custom_Account32__c',
-                                            new_fullname = 'Custom_Account99__c')
-}
                + 
                if (FALSE) {
+renamed_custom_object <- sf_rename_metadata(metadata_type = 'CustomObject', 
+                                            old_fullname = 'Custom_Account32__c', 
+                                            new_fullname = 'Custom_Account99__c')
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_reorder_cols.html b/docs/reference/sf_reorder_cols.html index 830b95c6..a6412c49 100644 --- a/docs/reference/sf_reorder_cols.html +++ b/docs/reference/sf_reorder_cols.html @@ -6,7 +6,7 @@ -Reorder resultset columns to prioritize <code>sObject</code> and <code>Id</code> — sf_reorder_cols • salesforcer +Reorder resultset columns to prioritize sObject and Id — sf_reorder_cols • salesforcer @@ -52,7 +52,7 @@ - + @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -221,7 +221,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_children.html b/docs/reference/sf_report_folder_children.html index 3b9b5e2f..4359d7df 100644 --- a/docs/reference/sf_report_folder_children.html +++ b/docs/reference/sf_report_folder_children.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -225,7 +225,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_create.html b/docs/reference/sf_report_folder_create.html index 4258d986..2f9cc048 100644 --- a/docs/reference/sf_report_folder_create.html +++ b/docs/reference/sf_report_folder_create.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -222,7 +222,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_delete.html b/docs/reference/sf_report_folder_delete.html index ccc05c88..4767f1cf 100644 --- a/docs/reference/sf_report_folder_delete.html +++ b/docs/reference/sf_report_folder_delete.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -219,7 +219,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_describe.html b/docs/reference/sf_report_folder_describe.html index f8255a49..41d9d9c5 100644 --- a/docs/reference/sf_report_folder_describe.html +++ b/docs/reference/sf_report_folder_describe.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -219,7 +219,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_share_delete.html b/docs/reference/sf_report_folder_share_delete.html index 0609c752..7ca2f680 100644 --- a/docs/reference/sf_report_folder_share_delete.html +++ b/docs/reference/sf_report_folder_share_delete.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -224,7 +224,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_share_describe.html b/docs/reference/sf_report_folder_share_describe.html index d2aa894b..417ec75a 100644 --- a/docs/reference/sf_report_folder_share_describe.html +++ b/docs/reference/sf_report_folder_share_describe.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -224,7 +224,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_share_recipients.html b/docs/reference/sf_report_folder_share_recipients.html index 68255df8..30ad205c 100644 --- a/docs/reference/sf_report_folder_share_recipients.html +++ b/docs/reference/sf_report_folder_share_recipients.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -238,7 +238,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_share_update.html b/docs/reference/sf_report_folder_share_update.html index 3bda351a..91d839b7 100644 --- a/docs/reference/sf_report_folder_share_update.html +++ b/docs/reference/sf_report_folder_share_update.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -232,7 +232,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_shares_add.html b/docs/reference/sf_report_folder_shares_add.html index 358b92f2..9185a422 100644 --- a/docs/reference/sf_report_folder_shares_add.html +++ b/docs/reference/sf_report_folder_shares_add.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -229,7 +229,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_shares_list.html b/docs/reference/sf_report_folder_shares_list.html index 84643267..40ae8ad2 100644 --- a/docs/reference/sf_report_folder_shares_list.html +++ b/docs/reference/sf_report_folder_shares_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -219,7 +219,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_shares_update.html b/docs/reference/sf_report_folder_shares_update.html index f90b8cb5..bb8337ff 100644 --- a/docs/reference/sf_report_folder_shares_update.html +++ b/docs/reference/sf_report_folder_shares_update.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -229,7 +229,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folder_update.html b/docs/reference/sf_report_folder_update.html index f618ae61..c73572b2 100644 --- a/docs/reference/sf_report_folder_update.html +++ b/docs/reference/sf_report_folder_update.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -227,7 +227,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_report_folders_list.html b/docs/reference/sf_report_folders_list.html index b43a8173..c31df12b 100644 --- a/docs/reference/sf_report_folders_list.html +++ b/docs/reference/sf_report_folders_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  - 
                  sf_report_folders_list()
                  + 
                  sf_report_folders_list()

                  Value

                  @@ -210,7 +210,7 @@

                  Contents

                  -

                  Site built with pkgdown 1.5.1.

                  +

                  Site built with pkgdown 1.6.1.

                  diff --git a/docs/reference/sf_reset_password.html b/docs/reference/sf_reset_password.html index 835ee708..028293dc 100644 --- a/docs/reference/sf_reset_password.html +++ b/docs/reference/sf_reset_password.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -223,13 +223,14 @@

                Value

                list

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # reset a user's password and ensure that an email is triggered to them
-sf_reset_password(user_id = "0056A000000ZZZaaBBB",
-                  EmailHeader = list(triggerAutoResponseEmail = FALSE,
-                                     triggerOtherEmail = FALSE,
-                                     triggerUserEmail = TRUE))
-}
                
+sf_reset_password(user_id = "0056A000000ZZZaaBBB", 
+                  EmailHeader = list(triggerAutoResponseEmail = FALSE, 
+                                     triggerOtherEmail = FALSE, 
+                                     triggerUserEmail = TRUE))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_rest_list.html b/docs/reference/sf_rest_list.html index 7dce279a..f4906266 100644 --- a/docs/reference/sf_rest_list.html +++ b/docs/reference/sf_rest_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -233,7 +233,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_retrieve.html b/docs/reference/sf_retrieve.html index 62a2d930..8031d4d5 100644 --- a/docs/reference/sf_retrieve.html +++ b/docs/reference/sf_retrieve.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Retrieves one or more new records to your organization’s data.

                  - 
                  sf_retrieve(
-  ids,
-  fields,
-  object_name,
-  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
-  guess_types = TRUE,
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_retrieve(
+  ids,
+  fields,
+  object_name,
+  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
+  guess_types = TRUE,
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -259,15 +259,16 @@

                Value

                tibble

                Examples

                - 
                if (FALSE) {
-n <- 3
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n))
-new_contacts_result <- sf_create(new_contacts, object_name="Contact")
-retrieved_records <- sf_retrieve(ids=new_contacts_result$id,
-                                 fields=c("LastName"),
-                                 object_name="Contact")
-}
                + 
                if (FALSE) {
+n <- 3
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact", 1:n))
+new_contacts_result <- sf_create(new_contacts, object_name="Contact")
+retrieved_records <- sf_retrieve(ids=new_contacts_result$id,
+                                 fields=c("LastName"),
+                                 object_name="Contact")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_retrieve_metadata.html b/docs/reference/sf_retrieve_metadata.html index cbcf281a..4b6e36bf 100644 --- a/docs/reference/sf_retrieve_metadata.html +++ b/docs/reference/sf_retrieve_metadata.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  This function makes a request to retrieve metadata as a package XML files that can be modified and later deployed into an environment

                  - 
                  sf_retrieve_metadata(
-  retrieve_request,
-  filename = "package.zip",
-  check_interval = 3,
-  max_tries = 20,
-  verbose = FALSE
-)
                  + 
                  sf_retrieve_metadata(
+  retrieve_request,
+  filename = "package.zip",
+  check_interval = 3,
+  max_tries = 20,
+  verbose = FALSE
+)

                  Arguments

                @@ -248,11 +248,12 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_retrieve.htm

                Examples

                - 
                if (FALSE) {
-retrieve_request <- list(unpackaged=list(types=list(members='*',
-                                                    name='CustomObject')))
-retrieve_info <- sf_retrieve_metadata(retrieve_request)
-}
                + 
                if (FALSE) {
+retrieve_request <- list(unpackaged=list(types=list(members='*',
+                                                    name='CustomObject')))
+retrieve_info <- sf_retrieve_metadata(retrieve_request)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_retrieve_metadata_check_status.html b/docs/reference/sf_retrieve_metadata_check_status.html index 2fb2a227..1d6bac18 100644 --- a/docs/reference/sf_retrieve_metadata_check_status.html +++ b/docs/reference/sf_retrieve_metadata_check_status.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -237,13 +237,14 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_checkretrievestatus.htm

                Examples

                - 
                if (FALSE) {
-retrieve_request <- list(unpackaged=list(types=list(members='*', name='CustomObject')))
-retrieve_info <- sf_retrieve_metadata(retrieve_request)
+    
                if (FALSE) {
+retrieve_request <- list(unpackaged=list(types=list(members='*', name='CustomObject')))
+retrieve_info <- sf_retrieve_metadata(retrieve_request)
 
 # check on status, this will automatically download the contents to package.zip when ready
-retrieve_status <- sf_retrieve_metadata_check_status(retrieve_info$id)
-}
                
+retrieve_status <- sf_retrieve_metadata_check_status(retrieve_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_retrieve_rest.html b/docs/reference/sf_retrieve_rest.html index d7a0fffe..9d4fa549 100644 --- a/docs/reference/sf_retrieve_rest.html +++ b/docs/reference/sf_retrieve_rest.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -279,6 +283,17 @@

                Arg

                + + + + + + + + @@ -312,15 +327,16 @@

                See a

                Salesforce Documentation

                Examples

                - 
                if (FALSE) {
-n <- 20
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n))
+    
                if (FALSE) {
+n <- 20
+new_contacts <- tibble(FirstName = rep("Test", n), 
+                       LastName = paste0("Contact", 1:n))
 # insert new records into the Contact object
-inserts <- sf_bulk_operation(input_data = new_contacts,
-                             object_name = "Contact",
-                             operation = "insert")
-}
                
+inserts <- sf_bulk_operation(input_data = new_contacts, 
+                             object_name = "Contact", 
+                             operation = "insert")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_run_bulk_query.html b/docs/reference/sf_run_bulk_query.html index 238ca89b..fda699dd 100644 --- a/docs/reference/sf_run_bulk_query.html +++ b/docs/reference/sf_run_bulk_query.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  This function is a convenience wrapper for submitting and retrieving query API jobs from the Bulk 1.0 and Bulk 2.0 APIs.

                  - 
                  sf_run_bulk_query(
-  soql,
-  object_name = NULL,
-  queryall = FALSE,
-  guess_types = TRUE,
-  bind_using_character_cols = FALSE,
-  interval_seconds = 3,
-  max_attempts = 200,
-  control = list(...),
-  ...,
-  api_type = c("Bulk 2.0", "Bulk 1.0"),
-  verbose = FALSE
-)
-
-sf_query_bulk(
-  soql,
-  object_name = NULL,
-  queryall = FALSE,
-  guess_types = TRUE,
-  bind_using_character_cols = FALSE,
-  interval_seconds = 3,
-  max_attempts = 200,
-  control = list(...),
-  ...,
-  api_type = c("Bulk 2.0", "Bulk 1.0"),
-  verbose = FALSE
-)
                  + 
                  sf_run_bulk_query(
+  soql,
+  object_name = NULL,
+  queryall = FALSE,
+  guess_types = TRUE,
+  bind_using_character_cols = deprecated(),
+  interval_seconds = 3,
+  max_attempts = 200,
+  control = list(...),
+  ...,
+  api_type = c("Bulk 2.0", "Bulk 1.0"),
+  verbose = FALSE
+)
+
+sf_query_bulk(
+  soql,
+  object_name = NULL,
+  queryall = FALSE,
+  guess_types = TRUE,
+  bind_using_character_cols = deprecated(),
+  interval_seconds = 3,
+  max_attempts = 200,
+  control = list(...),
+  ...,
+  api_type = c("Bulk 2.0", "Bulk 1.0"),
+  verbose = FALSE
+)

                  Arguments

                wait_for_results

                logical; indicating whether to wait for the operation to complete so that the batch results of individual records can be obtained

                record_types

                character; one or more types of records to retrieve +from the results of running the specified job

                combine_record_types

                logical; indicating for Bulk 2.0 jobs whether the +successfulResults, failedResults, and unprocessedRecords should be stacked +together by binding the rows
                control
                @@ -303,22 +303,23 @@

                R

                Bulk 1.0 documentation and Bulk 2.0 documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # select all Ids from Account object (up to 1000)
-ids <- sf_query_bulk(soql = 'SELECT Id FROM Account LIMIT 1000')
+ids <- sf_query_bulk(soql = 'SELECT Id FROM Account LIMIT 1000')
 
 # note that, by default, bulk queries are executed using the Bulk 2.0 API, which 
 # does not required the object name, but the Bulk 1.0 API can be still be invoked 
 # for queries by setting api_type="Bulk 1.0".
 
 # alternatively you can specify as:
-ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000',
-                api_type = "Bulk 2.0")
-
-ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000',
-                object_name = 'Account',
-                api_type = "Bulk 1.0")
-}
                
+ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                api_type = "Bulk 2.0")
+
+ids <- sf_query(soql = 'SELECT Id FROM Account LIMIT 1000', 
+                object_name = 'Account', 
+                api_type = "Bulk 1.0")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_run_report.html b/docs/reference/sf_run_report.html index 74c1806d..7d179d2f 100644 --- a/docs/reference/sf_run_report.html +++ b/docs/reference/sf_run_report.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  This function is a convenience wrapper for retrieving the data from a report. By default, it executes an asynchronous report and waits for the detailed data summarized in a tabular format, before pulling them down and returning as a tbl_df.

                  - 
                  sf_run_report(
-  report_id,
-  report_filters = NULL,
-  report_boolean_logic = NULL,
-  sort_by = character(0),
-  decreasing = FALSE,
-  top_n = NULL,
-  async = TRUE,
-  interval_seconds = 3,
-  max_attempts = 200,
-  wait_for_results = TRUE,
-  verbose = FALSE
-)
                  + 
                  sf_run_report(
+  report_id,
+  report_filters = NULL,
+  report_boolean_logic = NULL,
+  sort_by = character(0),
+  decreasing = FALSE,
+  top_n = NULL,
+  async = TRUE,
+  interval_seconds = 3,
+  max_attempts = 200,
+  wait_for_results = TRUE,
+  guess_types = TRUE,
+  bind_using_character_cols = deprecated(),
+  fact_map_key = "T!T",
+  verbose = FALSE
+)

                  Arguments

                @@ -276,6 +279,32 @@

                Arg report finish running so that data can be obtained. Otherwise, return the report instance details which can be used to retrieve the results when the async report has finished.

                + +

                + + + + + + + + + + @@ -298,6 +327,30 @@

                Details without total rows and given options to filter, and select the Top N as function arguments rather than forcing the user to create an entire list of reportMetadata.

                +

                Note

                + +

                Below are the fact map key patterns for three report types:

                +
                TABULAR

                T!T: The grand total of a report. Both record data +values and the grand total are represented by this key.

                +
                SUMMARY

                <First level row grouping_second level row grouping_third + level row grouping>!T: T refers to the row grand total.

                +
                MATRIX

                <First level row grouping_second level row grouping>!<First + level column grouping_second level column grouping>.

                + +
                + +

                Each item in a row or column grouping is numbered starting with 0. Here are +some examples of fact map keys:

                +
                +
                0!T

                The first item in the first-level grouping.

                +
                1!T

                The second item in the first-level grouping.

                +
                0_0!T

                The first item in the first-level grouping and the first item +in the second-level grouping.

                +
                0_1!T

                The first item in the first-level grouping and the second item +in the second-level grouping.

                + +
                +

                Salesforce Documentation

                @@ -327,38 +380,39 @@

                See a sf_update_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # find a report in your org and run it
-all_reports <- sf_query("SELECT Id, Name FROM Report")
-this_report_id <- all_reports$Id[1]
-results <- sf_run_report(this_report_id)
+all_reports <- sf_query("SELECT Id, Name FROM Report")
+this_report_id <- all_reports$Id[1]
+results <- sf_run_report(this_report_id)
 
 # apply your own filters to that same report
 # set up some filters, if needed
 # filter records that was created before this month
-filter1 <- list(column = "CREATED_DATE",
-                operator = "lessThan",
-                value = "THIS_MONTH")
+filter1 <- list(column = "CREATED_DATE",
+                operator = "lessThan", 
+                value = "THIS_MONTH")
 
 # filter records where the account billing address city is not empty
-filter2 <-  list(column = "ACCOUNT.ADDRESS1_CITY",
-                 operator = "notEqual",
-                 value = "")
+filter2 <-  list(column = "ACCOUNT.ADDRESS1_CITY",
+                 operator = "notEqual", 
+                 value = "")
 
 # combine filter1 and filter2 using 'AND' so that records must meet both filters
-results_using_AND <- sf_run_report(my_report_id,
-                                   report_boolean_logic = "1 AND 2",
-                                   report_filters = list(filter1, filter2))
+results_using_AND <- sf_run_report(my_report_id, 
+                                   report_boolean_logic = "1 AND 2",
+                                   report_filters = list(filter1, filter2))
 
 # combine filter1 and filter2 using 'OR' which means that records must meet one 
 # of the filters but also throw in a row limit based on a specific sort order
-results_using_OR <- sf_run_report(my_report_id,
-                                  report_boolean_logic = "1 OR 2",
-                                  report_filters = list(filter1, filter2),
-                                  sort_by = "Contact.test_number__c",
-                                  decreasing = TRUE,
-                                  top_n = 5)
-}
                
+results_using_OR <- sf_run_report(my_report_id, 
+                                  report_boolean_logic = "1 OR 2",
+                                  report_filters = list(filter1, filter2), 
+                                  sort_by = "Contact.test_number__c", 
+                                  decreasing = TRUE, 
+                                  top_n = 5)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_search.html b/docs/reference/sf_search.html index 9bba0e7b..44753095 100644 --- a/docs/reference/sf_search.html +++ b/docs/reference/sf_search.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Searches for records in your organization’s data.

                  - 
                  sf_search(
-  search_string,
-  is_sosl = FALSE,
-  guess_types = TRUE,
-  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
-  parameterized_search_options = list(...),
-  verbose = FALSE,
-  ...
-)
                  + 
                  sf_search(
+  search_string,
+  is_sosl = FALSE,
+  guess_types = TRUE,
+  api_type = c("REST", "SOAP", "Bulk 1.0", "Bulk 2.0"),
+  parameterized_search_options = list(...),
+  verbose = FALSE,
+  ...
+)

                  Arguments

                guess_types

                logical; indicating whether or not to use col_guess() +to try and cast the data returned in the recordset. If TRUE then +col_guess() is used, if FALSE then all fields will be returned +as character. This is helpful when col_guess() will mangle field values +in Salesforce that you'd like to preserve during translation into a tbl_df, +like numeric looking values that must be preserved as strings ("48.0").

                bind_using_character_cols

                logical; an indicator of whether to +cast the data to all character columns to ensure that bind_rows +does not fail because two paginated recordsets have differing datatypes for the +same column. Set this to TRUE rarely, typically only when having this +set to FALSE returns an error or you want all columns in the data to be +character.

                fact_map_key

                character; string providing an index into each +section of a fact map, from which you can access summary and detailed data. +The pattern for the fact map keys varies by report format so it is important +to know what the reportFormat property of the target report is. See the +note below for more details.
                verbose
                @@ -261,23 +261,24 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_sosl.htm

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # free text search
-area_code_search_string <- "(336)"
-search_result <- sf_search(area_code_search_string)
+area_code_search_string <- "(336)"
+search_result <- sf_search(area_code_search_string)
 
 # free text search with parameters
-search_result <- sf_search(area_code_search_string,
-                           fields_scope = "PHONE",
-                           objects = "Lead",
-                           fields = c("id", "phone", "firstname", "lastname"))
+search_result <- sf_search(area_code_search_string,
+                           fields_scope = "PHONE",
+                           objects = "Lead",
+                           fields = c("id", "phone", "firstname", "lastname"))
 
 # using SOSL
-my_sosl_search <- paste("FIND {(336)} in phone fields returning",
+my_sosl_search <- paste("FIND {(336)} in phone fields returning",
                         "contact(id, phone, firstname, lastname),",
-                        "lead(id, phone, firstname, lastname)")
-sosl_search_result <- sf_search(my_sosl_search, is_sosl=TRUE)
-}
                
+                        "lead(id, phone, firstname, lastname)")
+sosl_search_result <- sf_search(my_sosl_search, is_sosl=TRUE)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_server_timestamp.html b/docs/reference/sf_server_timestamp.html index 40c304bf..1fd643dd 100644 --- a/docs/reference/sf_server_timestamp.html +++ b/docs/reference/sf_server_timestamp.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -225,7 +225,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_set_password.html b/docs/reference/sf_set_password.html index 0e5715ea..e0c7f3be 100644 --- a/docs/reference/sf_set_password.html +++ b/docs/reference/sf_set_password.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -218,9 +218,10 @@

                Value

                list

                Examples

                - 
                if (FALSE) {
-sf_set_password(user_id = "0056A000000ZZZaaBBB", password="password123")
-}
                + 
                if (FALSE) {
+sf_set_password(user_id = "0056A000000ZZZaaBBB", password="password123")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_submit_query_bulk.html b/docs/reference/sf_submit_query_bulk.html index ca1c05c9..9d3a8837 100644 --- a/docs/reference/sf_submit_query_bulk.html +++ b/docs/reference/sf_submit_query_bulk.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -239,11 +239,12 @@

                R

                Bulk 1.0 documentation

                Examples

                - 
                if (FALSE) {
-my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
-job_info <- sf_create_job_bulk(operation = 'query', object = 'Account')
-query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query)
-}
                + 
                if (FALSE) {
+my_query <- "SELECT Id, Name FROM Account LIMIT 1000"
+job_info <- sf_create_job_bulk(operation = 'query', object = 'Account')
+query_info <- sf_submit_query_bulk(job_id = job_info$id, soql = my_query)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_undelete.html b/docs/reference/sf_undelete.html index 096ce015..b20e868b 100644 --- a/docs/reference/sf_undelete.html +++ b/docs/reference/sf_undelete.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -245,18 +245,19 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_calls_undelete.htm

                Examples

                - 
                if (FALSE) {
-new_contact <- c(FirstName = "Test", LastName = "Contact")
-new_records <- sf_create(new_contact, object_name = "Contact")
-delete <- sf_delete(new_records$id[1],
-                    AllOrNoneHeader = list(allOrNone = TRUE))
-is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
-                       new_records$id[1]),
-                       queryall = TRUE)
-undelete <- sf_undelete(new_records$id[1])
-is_not_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
-                           new_records$id[1]))
-}
                + 
                if (FALSE) {
+new_contact <- c(FirstName = "Test", LastName = "Contact")
+new_records <- sf_create(new_contact, object_name = "Contact")
+delete <- sf_delete(new_records$id[1],
+                    AllOrNoneHeader = list(allOrNone = TRUE))
+is_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
+                       new_records$id[1]), 
+                       queryall = TRUE)
+undelete <- sf_undelete(new_records$id[1])
+is_not_deleted <- sf_query(sprintf("SELECT Id, IsDeleted FROM Contact WHERE Id='%s'",
+                           new_records$id[1]))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_update.html b/docs/reference/sf_update.html index 6d4b757e..55bd123c 100644 --- a/docs/reference/sf_update.html +++ b/docs/reference/sf_update.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Updates one or more records to your organization’s data.

                  - 
                  sf_update(
-  input_data,
-  object_name,
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  guess_types = TRUE,
-  control = list(...),
-  ...,
-  all_or_none = deprecated(),
-  verbose = FALSE
-)
                  + 
                  sf_update(
+  input_data,
+  object_name,
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  guess_types = TRUE,
+  control = list(...),
+  ...,
+  all_or_none = deprecated(),
+  verbose = FALSE
+)

                  Arguments

                @@ -266,18 +266,19 @@

                Note

                of records and not all records submitted to the function.

                Examples

                - 
                if (FALSE) {
-n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact", 1:n))
-new_records <- sf_create(new_contacts, "Contact")
-updated_contacts <- tibble(FirstName = rep("TestTest", n),
-                           LastName = paste0("Contact", 1:n),
-                           Id = new_records$id)
+    
                if (FALSE) {
+n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact", 1:n))
+new_records <- sf_create(new_contacts, "Contact")
+updated_contacts <- tibble(FirstName = rep("TestTest", n),
+                           LastName = paste0("Contact", 1:n),
+                           Id = new_records$id)
 # update and allow fields to be truncated if they are too long
-update <- sf_update(input_data = updated_contacts, object_name = "Contact",
-                    AllowFieldTruncationHeader=list(allowFieldTruncation=TRUE))
-}
                
+update <- sf_update(input_data = updated_contacts, object_name = "Contact",
+                    AllowFieldTruncationHeader=list(allowFieldTruncation=TRUE))
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_update_attachment.html b/docs/reference/sf_update_attachment.html index 4265b86e..ed8886f0 100644 --- a/docs/reference/sf_update_attachment.html +++ b/docs/reference/sf_update_attachment.html @@ -101,7 +101,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -109,7 +109,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  This function will allow you to update attachments (and other blob data, such as Documents) by providing the Id of the attachment record and the file paths (absolute or relative) to media that you would like to upload to Salesforce @@ -198,14 +198,14 @@

                  Update Attachments

                  Body, IsPrivate, and OwnerId).

                  - 
                  sf_update_attachment(
-  attachment_input_data,
-  object_name = c("Attachment"),
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  control = list(...),
-  ...,
-  verbose = FALSE
-)
                  + 
                  sf_update_attachment(
+  attachment_input_data,
+  object_name = c("Attachment"),
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  control = list(...),
+  ...,
+  verbose = FALSE
+)

                  Arguments

                @@ -281,22 +281,23 @@

                See a sf_download_attachment()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # upload a PDF to a particular record as an Attachment
-file_path <- system.file("extdata",
+file_path <- system.file("extdata",
                          "data-wrangling-cheatsheet.pdf",
-                         package = "salesforcer")
-parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
-attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
-create_result <- sf_create_attachment(attachment_details)
+                         package = "salesforcer")
+parent_record_id <- "0036A000002C6MmQAK" # replace with your own ParentId!
+attachment_details <- tibble(Body = file_path, ParentId = parent_record_id)
+create_result <- sf_create_attachment(attachment_details)
 
 # download, zip, and re-upload the PDF
-pdf_path <- sf_download_attachment(sf_id = create_result$id[1])
-zipped_path <- paste0(pdf_path, ".zip")
-zip(zipped_path, pdf_path)
-attachment_details <- tibble(Id = create_result$id, Body = zipped_path)
-update_result <- sf_update_attachment(attachment_details)
-}
                
+pdf_path <- sf_download_attachment(sf_id = create_result$id[1])
+zipped_path <- paste0(pdf_path, ".zip")
+zip(zipped_path, pdf_path)
+attachment_details <- tibble(Id = create_result$id, Body = zipped_path)
+update_result <- sf_update_attachment(attachment_details)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_update_attachment_bulk_v1.html b/docs/reference/sf_update_attachment_bulk_v1.html index a7a8eb64..9b4df1e2 100644 --- a/docs/reference/sf_update_attachment_bulk_v1.html +++ b/docs/reference/sf_update_attachment_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -249,30 +249,31 @@

                See a

                Salesforce Documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # create an object that we can update
-base_obj_name <- "Custom_Account1"
-custom_object <- list()
-custom_object$fullName <- paste0(base_obj_name, "__c")
-custom_object$label <- paste0(gsub("_", " ", base_obj_name))
-custom_object$pluralLabel <- paste0(base_obj_name, "s")
-custom_object$nameField <- list(displayFormat = 'AN-{0000}',
-                                label = paste0(base_obj_name, ' Number'),
-                                type = 'AutoNumber')
-custom_object$deploymentStatus <- 'Deployed'
-custom_object$sharingModel <- 'ReadWrite'
-custom_object$enableActivities <- 'true'
-custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
-custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
-                                           metadata = custom_object)
+base_obj_name <- "Custom_Account1"
+custom_object <- list()
+custom_object$fullName <- paste0(base_obj_name, "__c")
+custom_object$label <- paste0(gsub("_", " ", base_obj_name))
+custom_object$pluralLabel <- paste0(base_obj_name, "s")
+custom_object$nameField <- list(displayFormat = 'AN-{0000}', 
+                                label = paste0(base_obj_name, ' Number'), 
+                                type = 'AutoNumber')
+custom_object$deploymentStatus <- 'Deployed'
+custom_object$sharingModel <- 'ReadWrite'
+custom_object$enableActivities <- 'true'
+custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
+custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
+                                           metadata = custom_object)
 # now update the object that was created
-update_metadata <- custom_object
-update_metadata$fullName <- 'Custom_Account1__c'
-update_metadata$label <- 'New Label Custom_Account1'
-update_metadata$pluralLabel <- 'Custom_Account1s_new'
-updated_custom_object_result <- sf_update_metadata(metadata_type = 'CustomObject',
-                                                   metadata = update_metadata)
-}
                
+update_metadata <- custom_object 
+update_metadata$fullName <- 'Custom_Account1__c'
+update_metadata$label <- 'New Label Custom_Account1'
+update_metadata$pluralLabel <- 'Custom_Account1s_new'
+updated_custom_object_result <- sf_update_metadata(metadata_type = 'CustomObject',
+                                                   metadata = update_metadata)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_update_report.html b/docs/reference/sf_update_report.html index df6163f5..76896439 100644 --- a/docs/reference/sf_update_report.html +++ b/docs/reference/sf_update_report.html @@ -99,7 +99,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -107,7 +107,7 @@

                • Experimental lifecycle

                  +

                  [Experimental]

                  Save changes to a report by sending a PATCH request to the Report resource. Note that saving a report deletes any running async report jobs because they might be obsolete based on the updates.

                  - 
                  sf_update_report(report_id, report_metadata, verbose = FALSE)
                  + 
                  sf_update_report(report_id, report_metadata, verbose = FALSE)

                  Arguments

                @@ -223,7 +223,7 @@

                Arg

                Value

                list representing the newly cloned report with up to 4 properties -that describe the report:

                +that describe the report:

                attributes

                Report type along with the URL to retrieve common objects and joined metadata.

                reportMetadata

                Unique identifiers for groupings and summaries.

                @@ -257,27 +257,28 @@

                See a sf_run_report()

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # first, grab all possible reports in your Org
-all_reports <- sf_query("SELECT Id, Name FROM Report")
+all_reports <- sf_query("SELECT Id, Name FROM Report")
 
 # second, get the id of the report to update
-this_report_id <- all_reports$Id[1]
+this_report_id <- all_reports$Id[1]
 
-my_updated_report <- sf_update_report(this_report_id,
-                                      report_metadata =
-                                        list(reportMetadata =
-                                          list(name = "Updated Report Name!")))
+my_updated_report <- sf_update_report(this_report_id,
+                                      report_metadata =
+                                        list(reportMetadata =
+                                          list(name = "Updated Report Name!")))
 
 # alternatively, pull down its metadata and update the name
-report_details <- sf_describe_report(this_report_id)
-report_details$reportMetadata$name <- paste0(report_details$reportMetadata$name,
-                                             " - UPDATED")
+report_details <- sf_describe_report(this_report_id)
+report_details$reportMetadata$name <- paste0(report_details$reportMetadata$name,
+                                             " - UPDATED")
 
 # fourth, update the report by passing the metadata
-my_updated_report <- sf_update_report(this_report_id,
-                                      report_metadata = report_details)
-}
                
+my_updated_report <- sf_update_report(this_report_id,
+                                      report_metadata = report_details)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_update_rest.html b/docs/reference/sf_update_rest.html index 486c09b0..e73814a8 100644 --- a/docs/reference/sf_update_rest.html +++ b/docs/reference/sf_update_rest.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -226,9 +226,10 @@

                R

                https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/

                Examples

                - 
                if (FALSE) {
-upload_info <- sf_upload_complete_bulk(job_id=job_info$id)
-}
                + 
                if (FALSE) {
+upload_info <- sf_upload_complete_bulk(job_id=job_info$id)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_upsert.html b/docs/reference/sf_upsert.html index 524caddd..3fd91af4 100644 --- a/docs/reference/sf_upsert.html +++ b/docs/reference/sf_upsert.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@

                • Stable lifecycle

                  +

                  [Stable]

                  Upserts one or more new records to your organization’s data.

                  - 
                  sf_upsert(
-  input_data,
-  object_name,
-  external_id_fieldname,
-  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
-  guess_types = TRUE,
-  control = list(...),
-  ...,
-  all_or_none = deprecated(),
-  verbose = FALSE
-)
                  + 
                  sf_upsert(
+  input_data,
+  object_name,
+  external_id_fieldname,
+  api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0"),
+  guess_types = TRUE,
+  control = list(...),
+  ...,
+  all_or_none = deprecated(),
+  verbose = FALSE
+)

                  Arguments

                @@ -268,25 +268,26 @@

                Value

                tbl_df of records with success indicator

                Examples

                - 
                if (FALSE) {
-n <- 2
-new_contacts <- tibble(FirstName = rep("Test", n),
-                       LastName = paste0("Contact-Create-", 1:n),
-                       My_External_Id__c=letters[1:n])
-new_contacts_result <- sf_create(new_contacts, object_name="Contact")
-
-upserted_contacts <- tibble(FirstName = rep("Test", n),
-                            LastName = paste0("Contact-Upsert-", 1:n),
-                            My_External_Id__c=letters[1:n])
-new_record <- tibble(FirstName = "Test",
-                     LastName = paste0("Contact-Upsert-", n+1),
-                     My_External_Id__c=letters[n+1])
-upserted_contacts <- bind_rows(upserted_contacts, new_record)
-
-upserted_contacts_result1 <- sf_upsert(upserted_contacts,
-                                       object_name="Contact",
-                                       "My_External_Id__c")
-}
                + 
                if (FALSE) {
+n <- 2
+new_contacts <- tibble(FirstName = rep("Test", n),
+                       LastName = paste0("Contact-Create-", 1:n),
+                       My_External_Id__c=letters[1:n])
+new_contacts_result <- sf_create(new_contacts, object_name="Contact")
+
+upserted_contacts <- tibble(FirstName = rep("Test", n),
+                            LastName = paste0("Contact-Upsert-", 1:n),
+                            My_External_Id__c=letters[1:n])
+new_record <- tibble(FirstName = "Test",
+                     LastName = paste0("Contact-Upsert-", n+1),
+                     My_External_Id__c=letters[n+1])
+upserted_contacts <- bind_rows(upserted_contacts, new_record)
+
+upserted_contacts_result1 <- sf_upsert(upserted_contacts, 
+                                       object_name="Contact", 
+                                       "My_External_Id__c")
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_upsert_bulk_v1.html b/docs/reference/sf_upsert_bulk_v1.html index fff964a7..60b73816 100644 --- a/docs/reference/sf_upsert_bulk_v1.html +++ b/docs/reference/sf_upsert_bulk_v1.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -249,33 +249,34 @@

                See a

                Salesforce Documentation

                Examples

                - 
                if (FALSE) {
+    
                if (FALSE) {
 # create an object that we can confirm the update portion of the upsert
-base_obj_name <- "Custom_Account1"
-custom_object <- list()
-custom_object$fullName <- paste0(base_obj_name, "__c")
-custom_object$label <- paste0(gsub("_", " ", base_obj_name))
-custom_object$pluralLabel <- paste0(base_obj_name, "s")
-custom_object$nameField <- list(displayFormat = 'AN-{0000}',
-                                label = paste0(base_obj_name, ' Number'),
-                                type = 'AutoNumber')
-custom_object$deploymentStatus <- 'Deployed'
-custom_object$sharingModel <- 'ReadWrite'
-custom_object$enableActivities <- 'true'
-custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
-custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
-                                           metadata = custom_object)
+base_obj_name <- "Custom_Account1"
+custom_object <- list()
+custom_object$fullName <- paste0(base_obj_name, "__c")
+custom_object$label <- paste0(gsub("_", " ", base_obj_name))
+custom_object$pluralLabel <- paste0(base_obj_name, "s")
+custom_object$nameField <- list(displayFormat = 'AN-{0000}', 
+                                label = paste0(base_obj_name, ' Number'), 
+                                type = 'AutoNumber')
+custom_object$deploymentStatus <- 'Deployed'
+custom_object$sharingModel <- 'ReadWrite'
+custom_object$enableActivities <- 'true'
+custom_object$description <- paste0(base_obj_name, " created by the Metadata API")
+custom_object_result <- sf_create_metadata(metadata_type = 'CustomObject',
+                                           metadata = custom_object)
 # now update the object that was created
-upsert_metadata <- list(custom_object, custom_object)
-upsert_metadata[[1]]$fullName <- 'Custom_Account1__c'
-upsert_metadata[[1]]$label <- 'New Label Custom_Account1'
-upsert_metadata[[1]]$pluralLabel <- 'Custom_Account1s_new'
-upsert_metadata[[2]]$fullName <- 'Custom_Account2__c'
-upsert_metadata[[2]]$label <- 'New Label Custom_Account2'
-upsert_metadata[[2]]$pluralLabel <- 'Custom_Account2s_new'
-upserted_custom_object_result <- sf_upsert_metadata(metadata_type = 'CustomObject',
-                                                    metadata = upsert_metadata)
-}
                
+upsert_metadata <- list(custom_object, custom_object)
+upsert_metadata[[1]]$fullName <- 'Custom_Account1__c'
+upsert_metadata[[1]]$label <- 'New Label Custom_Account1'
+upsert_metadata[[1]]$pluralLabel <- 'Custom_Account1s_new'
+upsert_metadata[[2]]$fullName <- 'Custom_Account2__c'
+upsert_metadata[[2]]$label <- 'New Label Custom_Account2'
+upsert_metadata[[2]]$pluralLabel <- 'Custom_Account2s_new'
+upserted_custom_object_result <- sf_upsert_metadata(metadata_type = 'CustomObject',
+                                                    metadata = upsert_metadata)
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_upsert_rest.html b/docs/reference/sf_upsert_rest.html index 5a4de8b9..30356091 100644 --- a/docs/reference/sf_upsert_rest.html +++ b/docs/reference/sf_upsert_rest.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -215,9 +215,10 @@

                Value

                list

                Examples

                - 
                if (FALSE) {
-sf_user_info()
-}
                + 
                if (FALSE) {
+sf_user_info()
+}
+
                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/sf_write_csv.html b/docs/reference/sf_write_csv.html index f6cf432e..760517f1 100644 --- a/docs/reference/sf_write_csv.html +++ b/docs/reference/sf_write_csv.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -238,7 +238,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/stop_w_errors_listed.html b/docs/reference/stop_w_errors_listed.html index 5123bdc0..50666cef 100644 --- a/docs/reference/stop_w_errors_listed.html +++ b/docs/reference/stop_w_errors_listed.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -228,7 +228,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/token_available.html b/docs/reference/token_available.html index 621653c0..bcfcb216 100644 --- a/docs/reference/token_available.html +++ b/docs/reference/token_available.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -229,7 +229,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/unbox_list_elements_recursively.html b/docs/reference/unbox_list_elements_recursively.html index bb8c26a6..9b1ec894 100644 --- a/docs/reference/unbox_list_elements_recursively.html +++ b/docs/reference/unbox_list_elements_recursively.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@
                @@ -229,7 +229,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/unnest_col.html b/docs/reference/unnest_col.html index ec6537ff..c5e62c1d 100644 --- a/docs/reference/unnest_col.html +++ b/docs/reference/unnest_col.html @@ -97,7 +97,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -105,7 +105,7 @@
                @@ -228,7 +228,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/valid_metadata_list.html b/docs/reference/valid_metadata_list.html index 2b501852..bcdab964 100644 --- a/docs/reference/valid_metadata_list.html +++ b/docs/reference/valid_metadata_list.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -228,7 +228,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/xmlToList2.html b/docs/reference/xmlToList2.html index 7ec0a244..e4b74d6c 100644 --- a/docs/reference/xmlToList2.html +++ b/docs/reference/xmlToList2.html @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -225,7 +225,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/xml_drop_and_unlist.html b/docs/reference/xml_drop_and_unlist.html index 15dfbb3b..0d355b95 100644 --- a/docs/reference/xml_drop_and_unlist.html +++ b/docs/reference/xml_drop_and_unlist.html @@ -6,7 +6,7 @@ -Drop <code>type</code> and <code>Id</code> attributes on XML queried records and unlist — xml_drop_and_unlist • salesforcer +Drop type and Id attributes on XML queried records and unlist — xml_drop_and_unlist • salesforcer @@ -52,7 +52,7 @@ - + salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@
                @@ -226,7 +226,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/xml_drop_and_unlist_recursively.html b/docs/reference/xml_drop_and_unlist_recursively.html index c54540a5..017d248e 100644 --- a/docs/reference/xml_drop_and_unlist_recursively.html +++ b/docs/reference/xml_drop_and_unlist_recursively.html @@ -6,7 +6,7 @@ -Recursively Drop <code>type</code> and <code>Id</code> attributes and flatten a list — xml_drop_and_unlist_recursively • salesforcer +Recursively Drop type and Id attributes and flatten a list — xml_drop_and_unlist_recursively • salesforcer @@ -52,7 +52,7 @@ - + @@ -98,7 +98,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -106,7 +106,7 @@
                @@ -226,7 +226,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/xml_extract_parent_and_child_result.html b/docs/reference/xml_extract_parent_and_child_result.html index 185392a9..fe524e79 100644 --- a/docs/reference/xml_extract_parent_and_child_result.html +++ b/docs/reference/xml_extract_parent_and_child_result.html @@ -100,7 +100,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -108,7 +108,7 @@
                @@ -227,7 +227,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/docs/reference/xml_nodeset_to_df.html b/docs/reference/xml_nodeset_to_df.html index 34c89f30..38d3ada6 100644 --- a/docs/reference/xml_nodeset_to_df.html +++ b/docs/reference/xml_nodeset_to_df.html @@ -96,7 +96,7 @@ salesforcer - 0.2.2 + 1.0.0 @@ -104,7 +104,7 @@
                @@ -221,7 +221,7 @@

                Contents

                -

                Site built with pkgdown 1.5.1.

                +

                Site built with pkgdown 1.6.1.

                diff --git a/vignettes/getting-started.Rmd b/vignettes/getting-started.Rmd index 97c9a974..8e1ad58d 100644 --- a/vignettes/getting-started.Rmd +++ b/vignettes/getting-started.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Getting Started} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/passing-control-args.Rmd b/vignettes/passing-control-args.Rmd index eaba229c..c54b3772 100644 --- a/vignettes/passing-control-args.Rmd +++ b/vignettes/passing-control-args.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Passing Control Args} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/supported-queries.Rmd b/vignettes/supported-queries.Rmd index 544802f4..60fd604d 100644 --- a/vignettes/supported-queries.Rmd +++ b/vignettes/supported-queries.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Supported Queries} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/supported-queries_files/figure-html/run-performance-test-1.png b/vignettes/supported-queries_files/figure-html/run-performance-test-1.png index 1f03a4208ca57f4af6032613aacfc15fab7336c9..fcf9acb37dae8e199d2d5f2373cbf73bcbc682fb 100644 GIT binary patch literal 13388 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 diff --git a/vignettes/transitioning-from-RForcecom.Rmd b/vignettes/transitioning-from-RForcecom.Rmd index a9d63890..21d51c5a 100644 --- a/vignettes/transitioning-from-RForcecom.Rmd +++ b/vignettes/transitioning-from-RForcecom.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Transitioning from RForcecom} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/working-with-attachments.Rmd b/vignettes/working-with-attachments.Rmd index bccac99d..d7604649 100644 --- a/vignettes/working-with-attachments.Rmd +++ b/vignettes/working-with-attachments.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Working with Attachments} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/working-with-bulk-apis.Rmd b/vignettes/working-with-bulk-apis.Rmd index f88f693c..7f71e0d1 100644 --- a/vignettes/working-with-bulk-apis.Rmd +++ b/vignettes/working-with-bulk-apis.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Working with Bulk APIs} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/working-with-metadata.Rmd b/vignettes/working-with-metadata.Rmd index c5e4f5a5..747502f1 100644 --- a/vignettes/working-with-metadata.Rmd +++ b/vignettes/working-with-metadata.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Working with Metadata} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/working-with-reports.Rmd b/vignettes/working-with-reports.Rmd index ace7b436..b7c10206 100644 --- a/vignettes/working-with-reports.Rmd +++ b/vignettes/working-with-reports.Rmd @@ -9,7 +9,7 @@ output: keep_md: true vignette: > %\VignetteIndexEntry{Working with Reports} - %\VignetteEngine{rmarkdown::render} + %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- From 154978098dd3b1432407f0f173a61295756dc489 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 19:09:25 -0500 Subject: [PATCH 36/42] Make CRAN submission requests --- NAMESPACE | 18 ++-- NEWS.md | 2 +- R/attachments.R | 12 +++ R/auth.R | 9 +- R/bulk-operation.R | 34 +++++- R/compatibility.R | 6 +- R/endpoints-analytics-dashboard.R | 28 +++++ R/endpoints-analytics-notification.R | 9 ++ R/endpoints-analytics-report-folder.R | 28 ++++- R/endpoints-analytics-report.R | 56 +++++++++- R/endpoints-bulk.R | 102 +++++++++++++++++- R/endpoints-rest.R | 62 ++++++++--- R/endpoints-soap.R | 17 ++- R/retrieve-metadata.R | 2 +- R/utils-control.R | 19 ++++ R/utils-datatypes.R | 59 +++++++--- R/utils-httr.R | 29 ++++- R/utils-input-validation.R | 5 + R/utils-query.R | 10 +- R/utils-xml.R | 26 +++-- R/utils.R | 39 ++++++- cran-comments.md | 25 ++++- man/VERB_n.Rd | 4 + man/accepted_controls_by_api.Rd | 9 ++ man/accepted_controls_by_operation.Rd | 9 ++ man/build_manifest_xml_from_list.Rd | 5 +- man/build_metadata_xml_from_list.Rd | 5 +- man/build_proxy.Rd | 3 + man/build_soap_xml_from_list.Rd | 9 +- man/catch_errors.Rd | 7 ++ man/check_and_encode_files.Rd | 16 +++ man/combine_parent_and_child_resultsets.Rd | 4 + man/filter_valid_controls.Rd | 17 +++ man/format_headers_for_verbose.Rd | 8 ++ man/get_os.Rd | 2 +- man/guess_object_name_from_soql.Rd | 8 ++ man/is_legit_token.Rd | 12 +++ ...e_analytics_folder_child_operations_url.Rd | 9 ++ man/make_analytics_folder_collections_url.Rd | 5 + man/make_analytics_folder_operations_url.Rd | 9 ++ man/make_analytics_folder_share_by_id_url.Rd | 12 +++ ...e_analytics_folder_share_recipients_url.Rd | 17 ++- man/make_analytics_folder_shares_url.Rd | 9 ++ ...e_analytics_notification_operations_url.Rd | 5 + ...make_analytics_notifications_limits_url.Rd | 5 + man/make_analytics_notifications_list_url.Rd | 5 + man/make_base_metadata_url.Rd | 5 + man/make_base_rest_url.Rd | 5 + man/make_base_soap_url.Rd | 5 + man/make_bulk_batch_details_url.Rd | 15 +++ man/make_bulk_batch_status_url.Rd | 15 +++ man/make_bulk_batches_url.Rd | 12 +++ man/make_bulk_create_job_url.Rd | 12 +++ man/make_bulk_delete_job_url.Rd | 12 +++ man/make_bulk_end_job_generic_url.Rd | 12 +++ man/make_bulk_get_all_jobs_url.Rd | 14 +++ man/make_bulk_get_all_query_jobs_url.Rd | 14 +++ man/make_bulk_get_job_url.Rd | 15 +++ man/make_bulk_job_records_url.Rd | 15 +++ man/make_bulk_query_result_url.Rd | 18 ++++ man/make_bulk_query_url.Rd | 12 +++ man/make_chatter_users_url.Rd | 5 + man/make_composite_batch_url.Rd | 5 + man/make_composite_url.Rd | 5 + man/make_dashboard_copy_url.Rd | 9 ++ man/make_dashboard_describe_url.Rd | 9 ++ ...ake_dashboard_filter_operators_list_url.Rd | 9 ++ ...e_dashboard_filter_options_analysis_url.Rd | 9 ++ man/make_dashboard_status_url.Rd | 9 ++ man/make_dashboard_url.Rd | 9 ++ man/make_dashboards_list_url.Rd | 5 + man/make_login_url.Rd | 13 +++ man/make_parameterized_search_url.Rd | 18 +++- man/make_query_url.Rd | 16 +++ man/make_report_copy_url.Rd | 9 ++ man/make_report_create_url.Rd | 5 + man/make_report_describe_url.Rd | 9 ++ man/make_report_execute_url.Rd | 19 ++++ man/make_report_fields_url.Rd | 9 ++ man/make_report_filter_operators_list_url.Rd | 9 ++ man/make_report_instance_url.Rd | 13 +++ man/make_report_instances_list_url.Rd | 9 ++ man/make_report_query_url.Rd | 5 + man/make_report_type_describe_url.Rd | 8 ++ man/make_report_types_list_url.Rd | 5 + man/make_report_url.Rd | 9 ++ man/make_reports_list_url.Rd | 5 + man/make_rest_describe_url.Rd | 5 + man/make_rest_objects_url.Rd | 11 +- man/make_rest_record_url.Rd | 14 ++- man/make_search_url.Rd | 8 ++ man/make_soap_xml_skeleton.Rd | 6 +- man/make_verbose_httr_message.Rd | 19 ++++ man/merge_null_to_na.Rd | 12 ++- man/parse_error_code_and_message.Rd | 6 ++ man/rDELETE.Rd | 3 + man/rGET.Rd | 3 + man/rPATCH.Rd | 3 + man/rPOST.Rd | 3 + man/rPUT.Rd | 3 + man/remove_empty_linked_object_cols.Rd | 4 + man/return_matching_controls.Rd | 10 ++ man/rforcecom.login.Rd | 2 +- man/salesforcer_state.Rd | 3 + man/session_id_available.Rd | 2 +- man/sf_create_job_bulk_v1.Rd | 35 ++++++ man/sf_create_job_bulk_v2.Rd | 37 +++++++ man/sf_end_job_bulk.Rd | 4 + man/sf_format_date.Rd | 7 ++ man/sf_format_datetime.Rd | 7 ++ man/sf_format_time.Rd | 26 +++++ man/sf_format_time.data.frame.Rd | 8 ++ man/sf_format_time.list.Rd | 8 ++ man/sf_input_data_validation.Rd | 15 +++ man/sf_rest_list.Rd | 5 + man/sf_write_csv.Rd | 13 +++ man/token_available.Rd | 2 +- man/validate_get_all_jobs_params.Rd | 11 ++ man/xml_drop_and_unlist.Rd | 7 +- man/xml_extract_parent_and_child_result.Rd | 3 + man/xml_nodeset_to_df.Rd | 2 +- 121 files changed, 1406 insertions(+), 108 deletions(-) create mode 100644 man/sf_format_time.Rd diff --git a/NAMESPACE b/NAMESPACE index af1e28a1..fda390c6 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -1,16 +1,7 @@ # Generated by roxygen2: do not edit by hand -S3method(sf_format_time,"NULL") -S3method(sf_format_time,AsIs) -S3method(sf_format_time,Date) -S3method(sf_format_time,POSIXct) -S3method(sf_format_time,POSIXlt) -S3method(sf_format_time,POSIXt) -S3method(sf_format_time,character) S3method(sf_format_time,data.frame) S3method(sf_format_time,list) -S3method(sf_format_time,logical) -S3method(sf_format_time,numeric) export(VERB_n) export(accepted_controls_by_api) export(accepted_controls_by_operation) @@ -21,6 +12,7 @@ export(build_proxy) export(build_soap_xml_from_list) export(catch_errors) export(catch_unknown_api) +export(check_and_encode_files) export(collapse_list_with_dupe_names) export(combine_parent_and_child_resultsets) export(compact2) @@ -38,6 +30,7 @@ export(format_headers_for_verbose) export(format_report_row) export(get_os) export(guess_object_name_from_soql) +export(is_legit_token) export(list_extract_parent_and_child_result) export(make_analytics_folder_child_operations_url) export(make_analytics_folder_collections_url) @@ -151,6 +144,8 @@ export(sf_create) export(sf_create_attachment) export(sf_create_batches_bulk) export(sf_create_job_bulk) +export(sf_create_job_bulk_v1) +export(sf_create_job_bulk_v2) export(sf_create_metadata) export(sf_create_report) export(sf_dashboard_components_describe) @@ -184,6 +179,7 @@ export(sf_find_duplicates) export(sf_find_duplicates_by_id) export(sf_format_date) export(sf_format_datetime) +export(sf_format_time) export(sf_get_all_jobs_bulk) export(sf_get_all_query_jobs_bulk) export(sf_get_dashboard_data) @@ -310,7 +306,11 @@ importFrom(dplyr,rename_at) importFrom(dplyr,rename_with) importFrom(dplyr,select) importFrom(dplyr,tibble) +importFrom(httr,DELETE) importFrom(httr,GET) +importFrom(httr,PATCH) +importFrom(httr,POST) +importFrom(httr,PUT) importFrom(httr,RETRY) importFrom(httr,add_headers) importFrom(httr,build_url) diff --git a/NEWS.md b/NEWS.md index 662691d5..02856b6d 100644 --- a/NEWS.md +++ b/NEWS.md @@ -4,7 +4,7 @@ * Increase the package's default Salesforce API version to 52.0 (Summer '21). - * Remove uses of {RForcecom} after it was removed from CRAN on 6/9/2021 (#101) + * Remove uses of {RForcecom} after it was archived on CRAN on 6/8/2021 (#101) * Remove LazyData option in DESCRIPTION since `data()` is not utilized diff --git a/R/attachments.R b/R/attachments.R index 65e24d7c..82345749 100644 --- a/R/attachments.R +++ b/R/attachments.R @@ -635,8 +635,20 @@ sf_delete_attachment <- function(ids, #' #' @importFrom base64enc base64encode #' @family Attachment functions +#' @param dat \code{tbl_df} or \code{list} of information regarding attachments +#' stored locally that will be encoded for use in the APIs. +#' @param column \code{character}; a string that indicates which column in the +#' \code{dat} argument is storing the body of information that needs to be encoded. +#' @param encode \code{logical}; a indicator of whether the body column should +#' be encoded in this step, which allows us to utilize this function for checking +#' or checking and encoding. +#' @param n_check \code{integer}; an integer specifying how many elements in the +#' \code{dat} argument that should be checked to see if the referenced file path +#' exists locally. This fails the function early if users accidentally specify +#' the wrong path. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal +#' @export check_and_encode_files <- function(dat, column = "Body", encode = TRUE, n_check = 100){ # Documents can be created from Urls so ignore encoding if there is no "Body" column if(column == "Body" & !("Body" %in% names(dat))){ diff --git a/R/auth.R b/R/auth.R index 1eefeb40..419abd04 100644 --- a/R/auth.R +++ b/R/auth.R @@ -243,7 +243,12 @@ sf_auth <- function(username = NULL, #' Check that token appears to be legitimate #' +#' @param x an object that is supposed to be an object of class \code{Token2.0} +#' (an S3 class provided by \code{httr}). If so, the result will return \code{TRUE}. +#' @template verbose +#' @return \code{logical} #' @keywords internal +#' @export is_legit_token <- function(x, verbose = FALSE) { if (!inherits(x, "Token2.0")) { @@ -336,7 +341,7 @@ sf_auth_refresh <- function(verbose = FALSE) { #' Check if a session_id is available in \code{\link{salesforcer}}'s internal #' \code{.state} environment. #' -#' @return logical +#' @return \code{logical} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -360,7 +365,7 @@ session_id_available <- function(verbose = TRUE) { #' Check if a token is available in \code{\link{salesforcer}}'s internal #' \code{.state} environment. #' -#' @return logical +#' @return \code{logical} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/bulk-operation.R b/R/bulk-operation.R index e9000c67..19665378 100644 --- a/R/bulk-operation.R +++ b/R/bulk-operation.R @@ -126,8 +126,23 @@ sf_create_job_bulk <- function(operation = c("insert", "delete", "upsert", "upda #' @importFrom xml2 xml_new_document xml_add_child xml_add_sibling #' @importFrom httr content #' @importFrom XML xmlToList +#' @template operation +#' @template object_name +#' @template external_id_fieldname +#' @param content_type \code{character}; a string indicating the format for +#' the API request and response. Must be one of 'CSV', 'ZIP_CSV', 'ZIP_XML', or +#' 'ZIP_JSON'. +#' @param concurrency_mode \code{character}; a string indicating whether the batches +#' should be processed in parallel or serially (sequentially). Serial processing +#' is helpful when multiple records may trigger simultaneous edits to another +#' related record (e.g., updating multiple children all on the same account). +#' @template control +#' @param ... arguments to be used to form the default control argument if it is not supplied directly. +#' @template verbose +#' @return \code{tbl_df}; a data frame containing information about the job created. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal +#' @export sf_create_job_bulk_v1 <- function(operation = c("insert", "delete", "upsert", "update", "hardDelete", "query", "queryall"), object_name, @@ -213,8 +228,23 @@ sf_create_job_bulk_v1 <- function(operation = c("insert", "delete", "upsert", "u #' @importFrom xml2 xml_new_document xml_add_child xml_add_sibling #' @importFrom httr content #' @importFrom jsonlite toJSON prettify +#' @template operation +#' @template object_name +#' @template soql +#' @template external_id_fieldname +#' @param content_type \code{character}; a string indicating the format for +#' the API request and response. Must be 'CSV' because it is the only supported +#' format for the Bulk 2.0 API. +#' @param column_delimiter \code{character}; a string indicating which character +#' should be treated as the delimiter in the CSV file. Must be one of 'COMMA', +#' 'TAB', 'PIPE', 'SEMICOLON', 'CARET', or 'BACKQUOTE'. +#' @template control +#' @param ... arguments to be used to form the default control argument if it is not supplied directly. +#' @template verbose +#' @return \code{tbl_df}; a data frame containing information about the job created. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal +#' @export sf_create_job_bulk_v2 <- function(operation = c("insert", "delete", "upsert", "update", "query", "queryall"), @@ -536,6 +566,8 @@ sf_get_all_query_jobs_bulk <- function(parameterized_search_list = #' how the bulk job should be ended #' @template api_type #' @template verbose +#' @return \code{logical}; returns \code{TRUE} if the job was able to be ended; +#' otherwise, an error message is printed #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -547,7 +579,7 @@ sf_end_job_bulk <- function(job_id, end_type <- match.arg(end_type) api_type <- match.arg(api_type) if(api_type == "Bulk 2.0" & end_type == "Closed"){ - end_typ <- "UploadComplete" + end_type <- "UploadComplete" } request_body <- toJSON(list(state=end_type), auto_unbox = TRUE) bulk_end_job_url <- make_bulk_end_job_generic_url(job_id, api_type) diff --git a/R/compatibility.R b/R/compatibility.R index 467affa4..2e466e02 100644 --- a/R/compatibility.R +++ b/R/compatibility.R @@ -28,7 +28,7 @@ #' #' @param username Your username for login to the Salesforce.com. In many cases, username is your E-mail address. #' @param password Your password for login to the Salesforce.com. Note: DO NOT FORGET your Security Token. (Ex.) If your password is "Pass1234" and your security token is "XYZXYZXYZXYZ", you should set "Pass1234XYZXYZXYZXYZ". -#' @param loginURL (optional) Login URL. If your environment is sandbox specify (ex:) "https://test.salesforce.com/". +#' @param loginURL (optional) Login URL. If your environment is sandbox specify (ex:) "https://test.salesforce.com". #' @param apiVersion (optional) Version of the REST API and SOAP API that you want to use. (ex:) "35.0" Supported versions from v20.0 and up. #' @return #' \item{sessionID}{Session ID.} @@ -41,11 +41,11 @@ rforcecom.login <- function(username, password, loginURL="https://login.salesfor if(!is.null(loginURL)){ options(salesforcer.login_url = loginURL) - #message("Ignoring loginURL. If needed, set in options like so: options(salesforcer.login_url = \"https://login.salesforce.com\")") + # message("Ignoring loginURL. If needed, set in options like so: options(salesforcer.login_url = \"https://login.salesforce.com\")") } if(!is.null(apiVersion)){ options(salesforcer.api_version = apiVersion) - #message("Ignoring apiVersion. If needed, set in options like so: options(salesforcer.api_version = \"42.0\")") + # message("Ignoring apiVersion. If needed, set in options like so: options(salesforcer.api_version = \"42.0\")") } sf_auth(username=username, diff --git a/R/endpoints-analytics-dashboard.R b/R/endpoints-analytics-dashboard.R index e7b1d41d..3f49ce79 100644 --- a/R/endpoints-analytics-dashboard.R +++ b/R/endpoints-analytics-dashboard.R @@ -1,5 +1,10 @@ #' Dashboard filter operators list URL generator #' +#' @param for_dashboards \code{logical}; an indicator of whether the filter is +#' in reference to dashboards or not. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -14,6 +19,9 @@ make_dashboard_filter_operators_list_url <- function(for_dashboards=FALSE){ #' Dashboard list URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -27,6 +35,10 @@ make_dashboards_list_url <- function(){ #' Dashboard status URL generator #' +#' @template dashboard_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -41,6 +53,10 @@ make_dashboard_status_url <- function(dashboard_id){ #' Dashboard describe URL generator #' +#' @template dashboard_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -55,6 +71,10 @@ make_dashboard_describe_url <- function(dashboard_id){ #' Dashboard filter options analysis URL generator #' +#' @template dashboard_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -69,6 +89,10 @@ make_dashboard_filter_options_analysis_url <- function(dashboard_id){ #' Dashboard URL generator #' +#' @template dashboard_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -83,6 +107,10 @@ make_dashboard_url <- function(dashboard_id){ #' Dashboard Copy URL generator #' +#' @template dashboard_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-analytics-notification.R b/R/endpoints-analytics-notification.R index 5f2aefae..ecbed2ac 100644 --- a/R/endpoints-analytics-notification.R +++ b/R/endpoints-analytics-notification.R @@ -1,5 +1,8 @@ #' Analytics Notification list URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics notification calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -13,6 +16,9 @@ make_analytics_notifications_list_url <- function(){ #' Analytics Notification limits URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics notification calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -26,6 +32,9 @@ make_analytics_notifications_limits_url <- function(){ #' Analytics Notification operations URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics notification calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-analytics-report-folder.R b/R/endpoints-analytics-report-folder.R index 2efae362..c76509f6 100644 --- a/R/endpoints-analytics-report-folder.R +++ b/R/endpoints-analytics-report-folder.R @@ -1,5 +1,8 @@ #' Analytics Folder collections URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -13,6 +16,10 @@ make_analytics_folder_collections_url <- function(){ #' Analytics Folder operations URL generator #' +#' @template report_folder_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -27,6 +34,10 @@ make_analytics_folder_operations_url <- function(report_folder_id){ #' Analytics Folder shares URL generator #' +#' @template report_folder_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -41,6 +52,11 @@ make_analytics_folder_shares_url <- function(report_folder_id){ #' Analytics Folder share by Id URL generator #' +#' @template report_folder_id +#' @template share_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -56,10 +72,16 @@ make_analytics_folder_share_by_id_url <- function(report_folder_id, share_id){ #' Analytics Folder share recipients URL generator #' +#' @template report_folder_id +#' @param share_type \code{character}; the type of data for the recipients, +#' such as user, group, or role. The default is "User". +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export -make_analytics_folder_share_recipients_url <- function(report_folder_id, share_type){ +make_analytics_folder_share_recipients_url <- function(report_folder_id, share_type="User"){ # ensure we are authenticated first so the url can be formed sf_auth_check() sprintf("%s/services/data/v%s/folders/%s/share-recipients?shareType=%s", @@ -71,6 +93,10 @@ make_analytics_folder_share_recipients_url <- function(report_folder_id, share_t #' Analytics Folder child operations URL generator #' +#' @template report_folder_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Analytics folder calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-analytics-report.R b/R/endpoints-analytics-report.R index 0f9668ca..fb43de61 100644 --- a/R/endpoints-analytics-report.R +++ b/R/endpoints-analytics-report.R @@ -1,10 +1,13 @@ #' Report Type List URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export make_report_types_list_url <- function(){ - # ensure we are authenticated first so the url can be formed + # ensure we are authenticated first so the URL can be formed sf_auth_check() sprintf("%s/services/data/v%s/analytics/reportTypes", salesforcer_state()$instance_url, @@ -13,6 +16,9 @@ make_report_types_list_url <- function(){ #' Reports List URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -26,11 +32,15 @@ make_reports_list_url <- function(){ #' Report Type Describe URL generator #' +#' @param type \code{character}; The API name of a report type. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export make_report_type_describe_url <- function(type){ - # ensure we are authenticated first so the url can be formed + # ensure we are authenticated first so the URL can be formed sf_auth_check() sprintf("%s/services/data/v%s/analytics/reportTypes/%s", salesforcer_state()$instance_url, @@ -40,6 +50,11 @@ make_report_type_describe_url <- function(type){ #' Report Filter Operator List URL generator #' +#' @param for_dashboards \code{logical}; an indicator of whether the filter is +#' in reference to dashboards or not. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -54,6 +69,10 @@ make_report_filter_operators_list_url <- function(for_dashboards=FALSE){ #' Report Fields URL generator #' +#' @template report_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -68,6 +87,10 @@ make_report_fields_url <- function(report_id){ #' Report Describe URL generator #' +#' @template report_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -82,6 +105,12 @@ make_report_describe_url <- function(report_id){ #' Report Execute URL generator #' +#' @template report_id +#' @template async +#' @template include_details +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -104,6 +133,10 @@ make_report_execute_url <- function(report_id, async=TRUE, include_details=FALSE #' Report Instances List URL generator #' +#' @template report_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -118,6 +151,11 @@ make_report_instances_list_url <- function(report_id){ #' Report Instance URL generator #' +#' @template report_id +#' @template report_instance_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -133,6 +171,9 @@ make_report_instance_url <- function(report_id, report_instance_id){ #' Report Query URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -146,6 +187,9 @@ make_report_query_url <- function(){ #' Report Create URL generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -159,6 +203,10 @@ make_report_create_url <- function(){ #' Report URL generator #' +#' @template report_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -173,6 +221,10 @@ make_report_url <- function(report_id){ #' Report Copy URL generator #' +#' @template report_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Reports and Dashboards API calls to. This URL is specific to your instance +#' and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-bulk.R b/R/endpoints-bulk.R index 72fcb653..4951d54e 100644 --- a/R/endpoints-bulk.R +++ b/R/endpoints-bulk.R @@ -1,5 +1,12 @@ #' Bulk Create Job URL Generator #' +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @param query_operation \code{logical}; an indicator of whether the call is +#' for a query or another operation, such as, CRUD operations. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -27,6 +34,14 @@ make_bulk_create_job_url <- function(api_type=c("Bulk 1.0", "Bulk 2.0"), #' Bulk Get Job Generic URL Generator #' +#' @template job_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @param query_operation \code{logical}; an indicator of whether the call is +#' for a query or another operation, such as, CRUD operations. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -58,6 +73,14 @@ make_bulk_get_job_url <- function(job_id, #' Bulk Get All Jobs Generic URL Generator #' +#' @param parameterized_search_list \code{list}; a list of search options to locate +#' Bulk API jobs. +#' @param next_records_url \code{character}; a string returned by a Salesforce +#' query from where to find subsequent records returned by a paginated query. +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) to send a request +#' to in order to retrieve queried jobs. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -92,14 +115,22 @@ make_bulk_get_all_jobs_url <- function(parameterized_search_list = list(isPkChun #' Bulk Get All Query Jobs Generic URL Generator #' +#' @param parameterized_search_list \code{list}; a list of search options to locate +#' Bulk API query jobs. +#' @param next_records_url \code{character}; a string returned by a Salesforce +#' query from where to find subsequent records returned by a paginated query. +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) to send a request +#' to in order to retrieve queried jobs. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export make_bulk_get_all_query_jobs_url <- function(parameterized_search_list = list(isPkChunkingEnabled=NULL, - jobType=NULL, - concurrencyMode=NULL), - next_records_url=NULL, - api_type=c("Bulk 2.0")){ + jobType=NULL, + concurrencyMode=NULL), + next_records_url=NULL, + api_type=c("Bulk 2.0")){ # ensure we are authenticated first so the url can be formed sf_auth_check() api_type <- match.arg(api_type) @@ -127,9 +158,15 @@ make_bulk_get_all_query_jobs_url <- function(parameterized_search_list = list(is #' Validate Query Parameters When Getting List of All Bulk Jobs #' +#' @param parameterized_search_list \code{list}; a list of search options to +#' locate Bulk API jobs. +#' @param type \code{character}; a string indicating which type of jobs to +#' include in the result. +#' @return \code{character}; a complete URL (as a string) to send a request +#' to in order to retrieve queried jobs. +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/query_get_all_jobs.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/query_get_all_jobs.htm} #' @export validate_get_all_jobs_params <- function(parameterized_search_list, type="all"){ for (n in names(parameterized_search_list)){ @@ -159,6 +196,12 @@ validate_get_all_jobs_params <- function(parameterized_search_list, type="all"){ #' Bulk End Job Generic URL Generator #' +#' @template job_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -181,6 +224,12 @@ make_bulk_end_job_generic_url <- function(job_id, api_type=c("Bulk 1.0", "Bulk 2 #' Bulk Delete Job Generic URL Generator #' +#' @template job_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -201,6 +250,12 @@ make_bulk_delete_job_url <- function(job_id, api_type=c("Bulk 2.0")){ #' Bulk Batches URL Generator #' #' @importFrom xml2 url_escape +#' @template job_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -223,6 +278,12 @@ make_bulk_batches_url <- function(job_id, api_type=c("Bulk 1.0", "Bulk 2.0")){ #' Bulk Query URL Generator #' +#' @template job_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -248,6 +309,13 @@ make_bulk_query_url <- function(job_id=NULL, #' Bulk Batch Status URL Generator #' +#' @template job_id +#' @template batch_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -265,6 +333,13 @@ make_bulk_batch_status_url <- function(job_id, batch_id, api_type=c("Bulk 1.0")) #' Bulk Batch Details URL Generator #' +#' @template job_id +#' @template batch_id +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -282,6 +357,15 @@ make_bulk_batch_details_url <- function(job_id, batch_id, api_type=c("Bulk 1.0") #' Bulk Query Result URL Generator #' +#' @template job_id +#' @template batch_id +#' @param result_id \code{character}; the Salesforce Id assigned to a generated +#' result for a bulk query batch. +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -316,6 +400,14 @@ make_bulk_query_result_url <- function(job_id, #' Bulk Job Records URL Generator #' +#' @template job_id +#' @param record_type \code{character}; one of 'successfulResults', 'failedResults', +#' or 'unprocessedRecords' indicating the type of records to retrieve. +#' @param api_type \code{character}; a string indicating which Bulk API to execute +#' the call against. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send subsequent Bulk API calls to. This URL is specific to your instance and +#' the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-rest.R b/R/endpoints-rest.R index 6c6d90bf..cc67dc7a 100644 --- a/R/endpoints-rest.R +++ b/R/endpoints-rest.R @@ -1,5 +1,8 @@ #' Base REST API URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send REST API calls to. This URL is specific to your instance and the API +#' version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -14,6 +17,9 @@ make_base_rest_url <- function(){ #' REST API Describe URL Generator #' #' @template object_name +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send REST API calls to regarding a specific object. This URL is also specific +#' to your instance and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -26,21 +32,11 @@ make_rest_describe_url <- function(object_name){ object_name) } -#' Parameterized Search URL Generator -#' -#' @importFrom xml2 url_escape -#' @importFrom httr build_url parse_url -#' @note This function is meant to be used internally. Only use when debugging. -#' @keywords internal -#' @export -make_parameterized_search_url <- function(search_string, params){ - this_url <- parse_url(paste0(make_base_rest_url(), "parameterizedSearch/")) - this_url$query <- c(list(q=url_escape(search_string)), params) - build_url(this_url) -} - #' Chatter Users URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send REST API calls regarding chatter users. This URL is specific to your +#' instance and the API version because it relies on the base rest URL. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -50,6 +46,9 @@ make_chatter_users_url <- function(){ #' Composite URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send composite REST API calls to. This URL is specific to your +#' instance and the API version because it relies on the base rest URL. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -60,6 +59,12 @@ make_composite_url <- function(){ #' Query URL Generator #' #' @importFrom xml2 url_escape +#' @template soql +#' @template queryall +#' @param next_records_url \code{character}; a string returned by a Salesforce +#' query from where to find subsequent records returned by a paginated query. +#' @return \code{character}; a complete URL (as a string) to send a request +#' to in order to retrieve queried records. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -86,6 +91,13 @@ make_query_url <- function(soql, queryall, next_records_url){ #' #' @importFrom xml2 url_escape #' @importFrom httr build_url parse_url +#' @param search_string \code{character}; a valid string for conducting a simple +#' RESTful search using parameters instead of a SOSL clause. +#' @param params \code{list}; a list of other values to populate in the URL +#' query string to further restrict the search +#' @return \code{character}; a complete URL (as a string) that has applied the +#' proper escaping and formatting for the search specified by the function inputs. +#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_parameterized.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -105,6 +117,10 @@ make_parameterized_search_url <- function(search_string=NULL, params=NULL){ #' Search URL Generator #' #' @importFrom xml2 url_escape +#' @param search_string \code{character}; a valid string for conducting a SOSL +#' search. +#' @return \code{character}; a complete URL (as a string) that has applied the +#' proper escaping and formatting for the search specified by the string. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -115,24 +131,36 @@ make_search_url <- function(search_string){ #' REST Objects URL Generator #' +#' @template object_name +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send REST API calls to regarding a specific object. This URL is also specific +#' to your instance and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export -make_rest_objects_url <- function(object){ - paste0(make_base_rest_url(), "sobjects/", object, "/") +make_rest_objects_url <- function(object_name){ + paste0(make_base_rest_url(), "sobjects/", object_name, "/") } #' REST Individual Record URL Generator #' +#' @template object_name +#' @template sf_id +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send REST API calls to regarding a specific record in an object. This URL is +#' also specific to your instance and the API version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export -make_rest_record_url <- function(object, sf_id){ - paste0(make_base_rest_url(), "sobjects/", object, "/", sf_id) +make_rest_record_url <- function(object_name, sf_id){ + paste0(make_base_rest_url(), "sobjects/", object_name, "/", sf_id) } #' Composite Batch URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send composite batch REST API calls to. This URL is specific to your instance +#' and the API version being used because it relies on the base REST URL. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/endpoints-soap.R b/R/endpoints-soap.R index fc8a1ffb..a1b157be 100644 --- a/R/endpoints-soap.R +++ b/R/endpoints-soap.R @@ -1,6 +1,15 @@ #' Login URL Generator #' -#' @note This function is meant to be used internally. Only use when debugging. +#' @param login_url \code{character}; the package default login URL is +#' https://login.salesforce.com, but other URLs can be used. For example, if you +#' are logging into a sandbox environment, then the login URL should be set to +#' https://test.salesforce.com. +#' @return \code{character}; a complete URL (as a string) that will be used to +#' login to. This string is specific to your environment (production, sandbox, +#' etc.) and the API version being used. +#' @note This function is meant to be used internally. Only use when debugging. +#' You should set the login URL globally as one of the package options: +#' \code{options(salesforcer.login_url="https://test.salesforce.com")}. #' @keywords internal #' @export make_login_url <- function(login_url){ @@ -11,6 +20,9 @@ make_login_url <- function(login_url){ #' Base SOAP API URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send SOAP API calls to. This URL is specific to your instance and the API +#' version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -24,6 +36,9 @@ make_base_soap_url <- function(){ #' Base Metadata API URL Generator #' +#' @return \code{character}; a complete URL (as a string) that will be used to +#' send Metadata API calls to. This URL is specific to your instance and the API +#' version being used. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/retrieve-metadata.R b/R/retrieve-metadata.R index bc45a393..3ce17613 100644 --- a/R/retrieve-metadata.R +++ b/R/retrieve-metadata.R @@ -109,7 +109,6 @@ sf_retrieve_metadata <- function(retrieve_request, #' @importFrom xml2 xml_ns_strip xml_find_all as_list read_xml #' @importFrom purrr map_df map_dfc #' @importFrom dplyr as_tibble -#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_checkretrievestatus.htm} #' @param id \code{character}; string id returned from \link{sf_retrieve_metadata} #' @param include_zip \code{logical}; Set to false to check the status of the retrieval without #' attempting to retrieve the zip file. If omitted, this argument defaults to true. @@ -118,6 +117,7 @@ sf_retrieve_metadata <- function(retrieve_request, #' working directory as package.zip #' @template verbose #' @return A \code{list} of the response +#' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_checkretrievestatus.htm} #' @examples #' \dontrun{ #' retrieve_request <- list(unpackaged=list(types=list(members='*', name='CustomObject'))) diff --git a/R/utils-control.R b/R/utils-control.R index 43c4f789..6dd7db29 100644 --- a/R/utils-control.R +++ b/R/utils-control.R @@ -203,6 +203,9 @@ sf_control <- function(AllOrNoneHeader=list(allOrNone=FALSE), #' Return the Accepted Control Arguments by API Type #' +#' @template api_type +#' @return \code{character}; a vector of strings indicating which control arguments +#' are accepted by the specified API. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -223,6 +226,9 @@ accepted_controls_by_api <- function(api_type = c("SOAP", "REST", "Bulk 1.0", "B #' Return the Accepted Control Arguments by Operation #' +#' @template operation +#' @return \code{character}; a vector of strings indicating which control arguments +#' are accepted by the specified operation. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -260,6 +266,13 @@ accepted_controls_by_operation <- function(operation = c("create" , "insert", #' Filter Out Control Arguments by API or Operation #' +#' @param supplied \code{list}; a list of input data regarding the control arguments +#' along with the with API and operation information to make a complete assessment +#' of which control arguments are applicable. +#' @template api_type +#' @template operation +#' @return \code{character}; a vector of strings returning only the control arguments +#' that are accepted by the specified API and operation. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -306,6 +319,12 @@ filter_valid_controls <- function(supplied, api_type = NULL, operation = NULL){ #' Of All Args Return Ones Matching Control Arguments #' +#' @param args \code{character}; a vector of strings that represent the function +#' arguments. +#' @return \code{character}; a vector of strings returning only the function arguments +#' that match control arguments so that users can specify them directly in each +#' function and not have to construct a control object every time in order to +#' pass only one or two control arguments. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/utils-datatypes.R b/R/utils-datatypes.R index 87981cc8..45599234 100644 --- a/R/utils-datatypes.R +++ b/R/utils-datatypes.R @@ -1,9 +1,12 @@ #' Format Datetimes for Create and Update operations #' -#' @note This function is meant to be used internally. Only use when debugging. #' @importFrom lubridate as_datetime -#' @keywords internal +#' @param x a value representing a datetime +#' @return \code{character}; a datetime string formatted in ISO8601 per the +#' requirements of the Salesforce APIs. #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} +#' @note This function is meant to be used internally. Only use when debugging. +#' @keywords internal #' @export sf_format_datetime <- function(x){ format(as_datetime(x), "%Y-%m-%dT%H:%M:%SZ") @@ -11,26 +14,45 @@ sf_format_datetime <- function(x){ #' Format Dates for Create and Update operations #' +#' @param x a value representing a datetime +#' @return \code{character}; a date string with the time set to midnight and then +#' formatted in ISO8601 per the requirements of the Salesforce APIs. +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @export sf_format_date <- function(x){ x <- as_datetime(format(x, "%Y-%m-%d 00:00:00"), tz=Sys.timezone()) sf_format_datetime(x) } +#' Format all Date and Datetime columns in a list +#' +#' @importFrom dplyr mutate_if +#' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date +#' @param x data which may or may not have values, elements, columns that +#' represent a datetime. If so, each of those are cast to the ISO8601 standard +#' per the requirements of Salesforce APIs. +#' @return the same data object with datetime values formatted. +#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} +#' @note This function is meant to be used internally. Only use when debugging. +#' @keywords internal +#' @export sf_format_time <- function (x, ...) { UseMethod("sf_format_time", x) } #' Format all Date and Datetime columns in a list #' -#' @note This function is meant to be used internally. Only use when debugging. #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date -#' @keywords internal +#' @param x \code{list}; a list object which may or may not have values +#' that represent a datetime. If so, they are cast to the ISO8601 standard per +#' the requirements of Salesforce APIs. +#' @return \code{list}; the same list object with datetime values formatted. #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} +#' @note This function is meant to be used internally. Only use when debugging. +#' @keywords internal #' @export sf_format_time.list <- function(x){ lapply(x, FUN=function(xx){ @@ -44,11 +66,15 @@ sf_format_time.list <- function(x){ #' Format all Date and Datetime columns in a dataset #' -#' @note This function is meant to be used internally. Only use when debugging. #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date -#' @keywords internal +#' @param x \code{tbl_df}; a data frame object which may or may not have columns +#' that represent a datetime. If so, they are cast to the ISO8601 standard per +#' the requirements of Salesforce APIs. +#' @return \code{tbl_df}; the same data frame object with datetime values formatted. #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} +#' @note This function is meant to be used internally. Only use when debugging. +#' @keywords internal #' @export sf_format_time.data.frame <- function(x){ x %>% @@ -58,48 +84,47 @@ sf_format_time.data.frame <- function(x){ mutate_if(is.Date, sf_format_date) } - -#' @export +#' @keywords internal sf_format_time.Date <- function(x){ sf_format_date(x) } -#' @export +#' @keywords internal sf_format_time.POSIXct <- function(x){ sf_format_datetime(x) } -#' @export +#' @keywords internal sf_format_time.POSIXlt <- function(x){ sf_format_datetime(x) } -#' @export +#' @keywords internal sf_format_time.POSIXt <- function(x){ sf_format_datetime(x) } -#' @export +#' @keywords internal sf_format_time.character <- function(x){ x } -#' @export +#' @keywords internal sf_format_time.numeric <- function(x){ x } -#' @export +#' @keywords internal sf_format_time.logical <- function(x){ x } -#' @export +#' @keywords internal sf_format_time.NULL <- function(x){ x } -#' @export +#' @keywords internal sf_format_time.AsIs <- function(x){ x } diff --git a/R/utils-httr.R b/R/utils-httr.R index 4458ee69..b8080560 100644 --- a/R/utils-httr.R +++ b/R/utils-httr.R @@ -27,9 +27,11 @@ #' Generic implementation of HTTP methods with retries and authentication #' -#' @param verb string; The name of HTTP verb to execute #' @importFrom httr RETRY status_code config add_headers #' @importFrom stats runif +#' @param verb string; The name of HTTP verb to execute +#' @return The last response. Note that if the request doesn't succeed after +#' \code{times} then the request will fail and return the response. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -60,6 +62,7 @@ VERB_n <- function(verb) { #' GETs with retries and authentication #' #' @importFrom httr GET +#' @return A \code{response()} object as defined by the \code{httr} package. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -67,6 +70,8 @@ rGET <- VERB_n("GET") #' POSTs with retries and authentication #' +#' @importFrom httr POST +#' @return A \code{response()} object as defined by the \code{httr} package. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -74,6 +79,8 @@ rPOST <- VERB_n("POST") #' PATCHs with retries and authentication #' +#' @importFrom httr PATCH +#' @return A \code{response()} object as defined by the \code{httr} package. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -81,6 +88,8 @@ rPATCH <- VERB_n("PATCH") #' PUTs with retries and authentication #' +#' @importFrom httr PUT +#' @return A \code{response()} object as defined by the \code{httr} package. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -88,6 +97,8 @@ rPUT <- VERB_n("PUT") #' DELETEs with retries and authentication #' +#' @importFrom httr DELETE +#' @return A \code{response()} object as defined by the \code{httr} package. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -97,6 +108,8 @@ rDELETE <- VERB_n("DELETE") #' #' Assuming the error code is less than 500, this function will return the #' +#' @param x \code{response()}; a response that indicates an error +#' @return \code{list}; a list containing the error code and message for printing. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -126,6 +139,9 @@ parse_error_code_and_message <- function(x){ #' #' @importFrom httr content http_error #' @importFrom xml2 as_list xml_find_first +#' @param x \code{response()}; a response from an HTTP request +#' @return \code{logical}; return \code{FALSE} if the function finishes without +#' detecting an error, otherwise stop the function call. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -153,16 +169,18 @@ catch_errors <- function(x){ #' Execute a non-paginated REST API call to list items #' +#' @importFrom purrr map_df +#' @importFrom dplyr as_tibble tibble +#' @importFrom readr col_guess type_convert +#' @importFrom httr content +#' @param url \code{character}; a valid REST API URL (as a string) #' @template as_tbl #' @param records_root \code{character} or \code{integer}; an index or string that #' identifies the element in the parsed list which contains the records returned #' by the API call. By default, this argument is \code{NULL}, which means that #' each element in the list is an individual record. #' @template verbose -#' @importFrom purrr map_df -#' @importFrom dplyr as_tibble tibble -#' @importFrom readr col_guess type_convert -#' @importFrom httr content +#' @return \code{tbl_df} or \code{list} of data depending on what was requested. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -199,6 +217,7 @@ sf_rest_list <- function(url, #' Function to build a proxy object to pass along with httr requests #' #' @importFrom httr use_proxy +#' @return an \code{httr} proxy object #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/utils-input-validation.R b/R/utils-input-validation.R index 610ad4e4..44825c83 100644 --- a/R/utils-input-validation.R +++ b/R/utils-input-validation.R @@ -102,6 +102,11 @@ message_w_errors_listed <- function(main_text = "Consider the following:", #' Validate the input for an operation #' +#' @template input_data +#' @template operation +#' @return the input data validated and formatted according to the specified +#' operation. This allows more flexibility for the user while ensuring that all +#' inputs are formatted as expected by the target APIs and operations. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/utils-query.R b/R/utils-query.R index 0b6ce4f6..e8642f6f 100644 --- a/R/utils-query.R +++ b/R/utils-query.R @@ -260,7 +260,10 @@ drop_attributes_recursively <- function(x, #' @importFrom purrr map modify_if #' @importFrom rlist list.flatten #' @importFrom utils head tail -#' @param x \code{list}; a list of xml content parsed into a list by xml2 +#' @param x \code{list}; a list of XML content parsed into a list by xml2 +#' @return \code{character}; a named vector of strings from the parsed XML. Nested +#' elements have their hierarchy represented by a period between the element names +#' at each level. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -468,9 +471,10 @@ extract_records_from_xml_nodeset_of_records <- function(x, #' bound together to return one complete \code{tbl_df} of the query result for #' that parent record. #' +#' @importFrom xml2 xml_find_all xml_remove #' @param x \code{xml_node}; a \code{xml_node} from an xml2 parsed response #' representing one individual parent query record. -#' @importFrom xml2 xml_find_all xml_remove +#' @return \code{tbl_df} of the query result for that parent record. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -574,6 +578,8 @@ list_extract_parent_and_child_result <- function(x){ #' the query recordset, that can be joined with its corresponding child records. #' @param child_df_list \code{list} of \code{tbl_df}; a list of child records that #' is the same length as the number of rows in the parent_df. +#' @return \code{tbl_df}; a data frame of parent data replicated for each child +#' record in the corresponding list. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/utils-xml.R b/R/utils-xml.R index 4d83c64c..1d1998b4 100644 --- a/R/utils-xml.R +++ b/R/utils-xml.R @@ -54,7 +54,7 @@ xmlToList2 <- function(node){ #' @importFrom purrr modify_if #' @importFrom utils capture.output #' @param this_node \code{xml_node}; to be parsed out -#' @return \code{data.frame} parsed from the supplied xml +#' @return \code{tbl_df} parsed from the supplied XML #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -78,7 +78,10 @@ xml_nodeset_to_df <- function(this_node){ #' #' @importFrom XML newXMLNode xmlValue<- #' @param soap_headers \code{list}; any number of SOAP headers -#' @return a XML document +#' @param metadata_ns \code{logical}; an indicator of whether to use the namespaces +#' required by the Metadata API or the default ones. +#' @return \code{xmlNode}; an XML object containing just the header portion of the +#' request #' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/soap_headers.htm} #' @note This function is meant to be used internally. Only use when debugging. #' Any of the following SOAP headers are allowed: @@ -172,14 +175,15 @@ make_soap_xml_skeleton <- function(soap_headers=list(), metadata_ns=FALSE){ #' @param input_data a \code{data.frame} of data to fill the XML body #' @template operation #' @template object_name -#' @param fields \code{character}; one or more strings indicating the fields to be returned -#' on the records +#' @param fields \code{character}; one or more strings indicating the fields to +#' be returned on the records #' @template external_id_fieldname #' @param root_name \code{character}; the name of the root node if created #' @param ns named vector; a collection of character strings indicating the namespace #' definitions of the root node if created -#' @param root \code{XMLNode}; a node to be used as the root -#' @return a XML document +#' @param root \code{xmlNode}; an XML node to be used as the root +#' @return \code{xmlNode}; an XML node with the complete XML built using the root +#' and the input data in the format needed for the operation. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -328,8 +332,9 @@ build_soap_xml_from_list <- function(input_data, #' @param root_name \code{character}; the name of the root node if created #' @param ns named vector; a collection of character strings indicating the namespace #' definitions of the root node if created -#' @param root \code{XMLNode}; a node to be used as the root -#' @return A XML document with the sublist data added +#' @param root \code{xmlNode}; an XML node to be used as the root +#' @return \code{xmlNode}; an XML node with the input data added as needed for the +#' Metadata API and its objects. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -371,9 +376,10 @@ build_metadata_xml_from_list <- function(input_data, #' #' @importFrom XML newXMLNode xmlValue<- #' @param input_data \code{list}; data to be appended -#' @param root \code{XMLNode}; a node to be used as the root +#' @param root \code{xmlNode}; an XML node to be used as the root +#' @return \code{xmlNode}; an XML node constructed into a manifest data required +#' by the Bulk APIs for handling binary attachment data. #' @references \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/binary_create_request_file.htm} -#' @return A XML document with the sublist manifest data added #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/R/utils.R b/R/utils.R index b9d4c0e0..537120d6 100644 --- a/R/utils.R +++ b/R/utils.R @@ -1,5 +1,6 @@ #' Return the package's .state environment variable #' +#' @return \code{list}; a list of values stored in the package's .state environment variable #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -12,7 +13,7 @@ salesforcer_state <- function(){ #' This function determines whether the system running the R code #' is Windows, Mac, or Linux #' -#' @return A character string +#' @return \code{character}; a string indicating the current operating system. #' @examples #' \dontrun{ #' get_os() @@ -63,6 +64,14 @@ patched_tempdir <- function(){ #' Return NA if NULL #' +#' A helper function to convert NULL values in API responses to a value of NA +#' which is allowed in data frames. Oftentimes, a NULL value creates issues when +#' binding and building data frames from parsed output, so we need to switch to NA. +#' +#' @param x a value, typically a single element or a list to switch to NA if +#' its value appears to be NULL. +#' @return the original value of parameter \code{x} or \code{NA} if the value +#' meets the criteria to be considered NULL. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -82,6 +91,13 @@ merge_null_to_na <- function(x){ #' #' @importFrom lifecycle deprecate_warn is_present deprecated #' @importFrom readr write_csv +#' @param x \code{tbl_df}; a data frame object to save as a CSV +#' @param file A file or connection to write to. +#' @param path \Sexpr[results=rd, stage=render]{lifecycle::badge("deprecated")}, +#' use the `file` argument instead. +#' @return the input \code{x} invisibly. This function is called for its +#' side-effect of creating a CSV file at the specified location using the format +#' required by Salesforce. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -104,9 +120,11 @@ sf_write_csv <- function(x, file, path=deprecated()){ #' in the resultset and try to exclude an additional completely blank column #' created by records that don't have a relationship at all in that related entity. #' +#' @importFrom dplyr select one_of #' @param dat data; a \code{tbl_df} or \code{data.frame} of a returned resultset #' @template api_type -#' @importFrom dplyr select one_of +#' @return \code{tbl_df}; the passed in data, but with the object columns removed +#' that are empty links to other objects. #' @keywords internal #' @export remove_empty_linked_object_cols <- function(dat, api_type = c("SOAP", "REST")){ @@ -141,6 +159,9 @@ remove_empty_linked_object_cols <- function(dat, api_type = c("SOAP", "REST")){ #' Try to Guess the Object if User Does Not Specify for Bulk Queries #' +#' @template soql +#' @return \code{character}; a string parsed from the input that represents the +#' object name that the query appears to target. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -157,6 +178,10 @@ guess_object_name_from_soql <- function(soql){ #' Format Headers for Printing #' +#' @param request_headers \code{list}; a list of values from the API request or +#' response that represent the headers of the call +#' @return \code{character}; a string constructed from the input that is easier +#' to read when we print it out #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export @@ -169,6 +194,16 @@ format_headers_for_verbose <- function(request_headers){ #' Format Verbose Call #' #' @importFrom jsonlite prettify +#' @param method \code{character}; the type of HTTP method invoked (e.g., POST, +#' PUT, DELETE, etc.). +#' @param url \code{character}; the URL that the request was sent to +#' @param headers \code{character}; the set of header options set on the request +#' @param body \code{character}; the body of the request. +#' @param auto_unbox \code{logical}, an indicator of whether to parse vectors of +#' of length 1 into a single character string, rather than a list. +#' @param ... additional arguments passed on to \code{\link[jsonlite]{toJSON}}. +#' @return \code{NULL} invisibly, because this function is intended for the +#' side-effect of printing out the details of an HTTP call. #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal #' @export diff --git a/cran-comments.md b/cran-comments.md index 121c3c3f..f900ffd2 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -1,11 +1,28 @@ # Release summary +## Note for CRAN Maintainers upon Submission of salesforcer 1.0.0 + +Per the request of Julia Haider, I have added \value{} specs to the .Rd files +for all exported methods and explained those values in detail. + +In addition, she requested that I explain how the issues which caused this +package to be archived have now been resolved. On June 8, 2021, CRAN archived the +{RForcecom} package. Tests and vignettes in this package referenced {RForcecom} +and it was listed in this package's DESCRIPTION file under 'Suggests'. On June 9, +2021, CRAN sent an email that this package had failing check results. The +failures were due to RForcecom having been archived on CRAN. To resolve, I +removed all executing references to the RForcecom library in the code, because +I cannot anticipate whether the author of the package will restore it to CRAN. I +was not able to complete this work by the stated deadline (June 23) because I was +traveling without connection to the tools required to make the necessary changes. +As such, CRAN archived this package. + ## Test environments * Local Mac OS install, R-release 4.0.2 -* Ubuntu 16.04 (on GitHub Actions), R-release, R 4.0.2 -* Mac OS 10.15.5 (on GitHub Actions) R-release, R 4.0.2 -* Microsoft Windows Server 2019 10.0.17763 (on GitHub Actions) R-release, R 4.0.2 +* Ubuntu 16.04 (on GitHub Actions), R-release, R 4.1.0 +* Mac OS 10.15.5 (on GitHub Actions) R-release, R 4.1.0 +* Microsoft Windows Server 2019 10.0.17763 (on GitHub Actions) R-release, R 4.1.0 * win-builder (R-release 4.1.0) ## R CMD check results @@ -27,8 +44,6 @@ CRAN repository db overrides: 0 errors v | 0 warnings v | 1 note x ----- - ## revdepcheck results Not done for this version because the prior version was removed from CRAN. diff --git a/man/VERB_n.Rd b/man/VERB_n.Rd index 865ac4e1..9ddcd09a 100644 --- a/man/VERB_n.Rd +++ b/man/VERB_n.Rd @@ -9,6 +9,10 @@ VERB_n(verb) \arguments{ \item{verb}{string; The name of HTTP verb to execute} } +\value{ +The last response. Note that if the request doesn't succeed after +\code{times} then the request will fail and return the response. +} \description{ Generic implementation of HTTP methods with retries and authentication } diff --git a/man/accepted_controls_by_api.Rd b/man/accepted_controls_by_api.Rd index 60652c86..9387b174 100644 --- a/man/accepted_controls_by_api.Rd +++ b/man/accepted_controls_by_api.Rd @@ -8,6 +8,15 @@ accepted_controls_by_api( api_type = c("SOAP", "REST", "Bulk 1.0", "Bulk 2.0", "Metadata") ) } +\arguments{ +\item{api_type}{\code{character}; one of \code{"REST"}, \code{"SOAP"}, +\code{"Bulk 1.0"}, or \code{"Bulk 2.0"} indicating which API to use when +making the request.} +} +\value{ +\code{character}; a vector of strings indicating which control arguments +are accepted by the specified API. +} \description{ Return the Accepted Control Arguments by API Type } diff --git a/man/accepted_controls_by_operation.Rd b/man/accepted_controls_by_operation.Rd index 6aabac4d..d9a11459 100644 --- a/man/accepted_controls_by_operation.Rd +++ b/man/accepted_controls_by_operation.Rd @@ -10,6 +10,15 @@ accepted_controls_by_operation( "describeSObjects", "resetPassword") ) } +\arguments{ +\item{operation}{\code{character}; a string defining the type of operation being +performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", +"query", "queryall").} +} +\value{ +\code{character}; a vector of strings indicating which control arguments +are accepted by the specified operation. +} \description{ Return the Accepted Control Arguments by Operation } diff --git a/man/build_manifest_xml_from_list.Rd b/man/build_manifest_xml_from_list.Rd index 03b7b9df..df4af2ff 100644 --- a/man/build_manifest_xml_from_list.Rd +++ b/man/build_manifest_xml_from_list.Rd @@ -9,10 +9,11 @@ build_manifest_xml_from_list(input_data, root = NULL) \arguments{ \item{input_data}{\code{list}; data to be appended} -\item{root}{\code{XMLNode}; a node to be used as the root} +\item{root}{\code{xmlNode}; an XML node to be used as the root} } \value{ -A XML document with the sublist manifest data added +\code{xmlNode}; an XML node constructed into a manifest data required +by the Bulk APIs for handling binary attachment data. } \description{ This function converts a list of data for binary attachments to XML diff --git a/man/build_metadata_xml_from_list.Rd b/man/build_metadata_xml_from_list.Rd index 9082cc4a..f79ba4f6 100644 --- a/man/build_metadata_xml_from_list.Rd +++ b/man/build_metadata_xml_from_list.Rd @@ -22,10 +22,11 @@ build_metadata_xml_from_list( \item{ns}{named vector; a collection of character strings indicating the namespace definitions of the root node if created} -\item{root}{\code{XMLNode}; a node to be used as the root} +\item{root}{\code{xmlNode}; an XML node to be used as the root} } \value{ -A XML document with the sublist data added +\code{xmlNode}; an XML node with the input data added as needed for the +Metadata API and its objects. } \description{ This function converts a list of metadata to XML diff --git a/man/build_proxy.Rd b/man/build_proxy.Rd index c7e7165b..961f57d3 100644 --- a/man/build_proxy.Rd +++ b/man/build_proxy.Rd @@ -6,6 +6,9 @@ \usage{ build_proxy() } +\value{ +an \code{httr} proxy object +} \description{ Function to build a proxy object to pass along with httr requests } diff --git a/man/build_soap_xml_from_list.Rd b/man/build_soap_xml_from_list.Rd index a43d911c..b3d92371 100644 --- a/man/build_soap_xml_from_list.Rd +++ b/man/build_soap_xml_from_list.Rd @@ -28,8 +28,8 @@ performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", \item{object_name}{\code{character}; the name of the Salesforce object that the function is operating against (e.g. "Account", "Contact", "CustomObject__c").} -\item{fields}{\code{character}; one or more strings indicating the fields to be returned -on the records} +\item{fields}{\code{character}; one or more strings indicating the fields to +be returned on the records} \item{external_id_fieldname}{\code{character}; string identifying a custom field on the object that has been set as an "External ID" field. This field is used to reference @@ -40,10 +40,11 @@ objects during upserts to determine if the record already exists in Salesforce o \item{ns}{named vector; a collection of character strings indicating the namespace definitions of the root node if created} -\item{root}{\code{XMLNode}; a node to be used as the root} +\item{root}{\code{xmlNode}; an XML node to be used as the root} } \value{ -a XML document +\code{xmlNode}; an XML node with the complete XML built using the root +and the input data in the format needed for the operation. } \description{ Parse data into XML format diff --git a/man/catch_errors.Rd b/man/catch_errors.Rd index f9ad8e98..316751a3 100644 --- a/man/catch_errors.Rd +++ b/man/catch_errors.Rd @@ -6,6 +6,13 @@ \usage{ catch_errors(x) } +\arguments{ +\item{x}{\code{response()}; a response from an HTTP request} +} +\value{ +\code{logical}; return \code{FALSE} if the function finishes without +detecting an error, otherwise stop the function call. +} \description{ Function to catch and print HTTP errors } diff --git a/man/check_and_encode_files.Rd b/man/check_and_encode_files.Rd index d0f3050e..d44eb606 100644 --- a/man/check_and_encode_files.Rd +++ b/man/check_and_encode_files.Rd @@ -6,6 +6,22 @@ \usage{ check_and_encode_files(dat, column = "Body", encode = TRUE, n_check = 100) } +\arguments{ +\item{dat}{\code{tbl_df} or \code{list} of information regarding attachments +stored locally that will be encoded for use in the APIs.} + +\item{column}{\code{character}; a string that indicates which column in the +\code{dat} argument is storing the body of information that needs to be encoded.} + +\item{encode}{\code{logical}; a indicator of whether the body column should +be encoded in this step, which allows us to utilize this function for checking +or checking and encoding.} + +\item{n_check}{\code{integer}; an integer specifying how many elements in the +\code{dat} argument that should be checked to see if the referenced file path +exists locally. This fails the function early if users accidentally specify +the wrong path.} +} \description{ Check that file paths exist and data is encoded if specified } diff --git a/man/combine_parent_and_child_resultsets.Rd b/man/combine_parent_and_child_resultsets.Rd index 325459e2..3ce097df 100644 --- a/man/combine_parent_and_child_resultsets.Rd +++ b/man/combine_parent_and_child_resultsets.Rd @@ -13,6 +13,10 @@ the query recordset, that can be joined with its corresponding child records.} \item{child_df_list}{\code{list} of \code{tbl_df}; a list of child records that is the same length as the number of rows in the parent_df.} } +\value{ +\code{tbl_df}; a data frame of parent data replicated for each child +record in the corresponding list. +} \description{ This function accepts a \code{data.frame} with one row representing each parent record returned by a query with a corresponding list element in the diff --git a/man/filter_valid_controls.Rd b/man/filter_valid_controls.Rd index bf0024a2..5505c0d7 100644 --- a/man/filter_valid_controls.Rd +++ b/man/filter_valid_controls.Rd @@ -6,6 +6,23 @@ \usage{ filter_valid_controls(supplied, api_type = NULL, operation = NULL) } +\arguments{ +\item{supplied}{\code{list}; a list of input data regarding the control arguments +along with the with API and operation information to make a complete assessment +of which control arguments are applicable.} + +\item{api_type}{\code{character}; one of \code{"REST"}, \code{"SOAP"}, +\code{"Bulk 1.0"}, or \code{"Bulk 2.0"} indicating which API to use when +making the request.} + +\item{operation}{\code{character}; a string defining the type of operation being +performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", +"query", "queryall").} +} +\value{ +\code{character}; a vector of strings returning only the control arguments +that are accepted by the specified API and operation. +} \description{ Filter Out Control Arguments by API or Operation } diff --git a/man/format_headers_for_verbose.Rd b/man/format_headers_for_verbose.Rd index 6fe84ee0..abed77ce 100644 --- a/man/format_headers_for_verbose.Rd +++ b/man/format_headers_for_verbose.Rd @@ -6,6 +6,14 @@ \usage{ format_headers_for_verbose(request_headers) } +\arguments{ +\item{request_headers}{\code{list}; a list of values from the API request or +response that represent the headers of the call} +} +\value{ +\code{character}; a string constructed from the input that is easier +to read when we print it out +} \description{ Format Headers for Printing } diff --git a/man/get_os.Rd b/man/get_os.Rd index c8869986..9d9fc9ce 100644 --- a/man/get_os.Rd +++ b/man/get_os.Rd @@ -7,7 +7,7 @@ get_os() } \value{ -A character string +\code{character}; a string indicating the current operating system. } \description{ This function determines whether the system running the R code diff --git a/man/guess_object_name_from_soql.Rd b/man/guess_object_name_from_soql.Rd index dfed9cd6..743f2543 100644 --- a/man/guess_object_name_from_soql.Rd +++ b/man/guess_object_name_from_soql.Rd @@ -6,6 +6,14 @@ \usage{ guess_object_name_from_soql(soql) } +\arguments{ +\item{soql}{\code{character}; a string defining a SOQL query +(e.g. "SELECT Id, Name FROM Account").} +} +\value{ +\code{character}; a string parsed from the input that represents the +object name that the query appears to target. +} \description{ Try to Guess the Object if User Does Not Specify for Bulk Queries } diff --git a/man/is_legit_token.Rd b/man/is_legit_token.Rd index 1a05341a..57344b43 100644 --- a/man/is_legit_token.Rd +++ b/man/is_legit_token.Rd @@ -6,6 +6,18 @@ \usage{ is_legit_token(x, verbose = FALSE) } +\arguments{ +\item{x}{an object that is supposed to be an object of class \code{Token2.0} +(an S3 class provided by \code{httr}). If so, the result will return \code{TRUE}.} + +\item{verbose}{\code{logical}; an indicator of whether to print additional +detail for each API call, which is useful for debugging. More specifically, when +set to \code{TRUE} the URL, header, and body will be printed for each request, +along with additional diagnostic information where available.} +} +\value{ +\code{logical} +} \description{ Check that token appears to be legitimate } diff --git a/man/make_analytics_folder_child_operations_url.Rd b/man/make_analytics_folder_child_operations_url.Rd index d32b49cb..e1bbcdb8 100644 --- a/man/make_analytics_folder_child_operations_url.Rd +++ b/man/make_analytics_folder_child_operations_url.Rd @@ -6,6 +6,15 @@ \usage{ make_analytics_folder_child_operations_url(report_folder_id) } +\arguments{ +\item{report_folder_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder (it will start with "00l").} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Folder child operations URL generator } diff --git a/man/make_analytics_folder_collections_url.Rd b/man/make_analytics_folder_collections_url.Rd index da213bbe..eba1392a 100644 --- a/man/make_analytics_folder_collections_url.Rd +++ b/man/make_analytics_folder_collections_url.Rd @@ -6,6 +6,11 @@ \usage{ make_analytics_folder_collections_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Folder collections URL generator } diff --git a/man/make_analytics_folder_operations_url.Rd b/man/make_analytics_folder_operations_url.Rd index 851a6c42..f44165db 100644 --- a/man/make_analytics_folder_operations_url.Rd +++ b/man/make_analytics_folder_operations_url.Rd @@ -6,6 +6,15 @@ \usage{ make_analytics_folder_operations_url(report_folder_id) } +\arguments{ +\item{report_folder_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder (it will start with "00l").} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Folder operations URL generator } diff --git a/man/make_analytics_folder_share_by_id_url.Rd b/man/make_analytics_folder_share_by_id_url.Rd index 8b0fd74b..12dea646 100644 --- a/man/make_analytics_folder_share_by_id_url.Rd +++ b/man/make_analytics_folder_share_by_id_url.Rd @@ -6,6 +6,18 @@ \usage{ make_analytics_folder_share_by_id_url(report_folder_id, share_id) } +\arguments{ +\item{report_folder_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder (it will start with "00l").} + +\item{share_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder share (it will start with "004").} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Folder share by Id URL generator } diff --git a/man/make_analytics_folder_share_recipients_url.Rd b/man/make_analytics_folder_share_recipients_url.Rd index 3451bdab..73c5f6b5 100644 --- a/man/make_analytics_folder_share_recipients_url.Rd +++ b/man/make_analytics_folder_share_recipients_url.Rd @@ -4,7 +4,22 @@ \alias{make_analytics_folder_share_recipients_url} \title{Analytics Folder share recipients URL generator} \usage{ -make_analytics_folder_share_recipients_url(report_folder_id, share_type) +make_analytics_folder_share_recipients_url( + report_folder_id, + share_type = "User" +) +} +\arguments{ +\item{report_folder_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder (it will start with "00l").} + +\item{share_type}{\code{character}; the type of data for the recipients, +such as user, group, or role. The default is "User".} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. } \description{ Analytics Folder share recipients URL generator diff --git a/man/make_analytics_folder_shares_url.Rd b/man/make_analytics_folder_shares_url.Rd index d01c18c2..ba6d14d1 100644 --- a/man/make_analytics_folder_shares_url.Rd +++ b/man/make_analytics_folder_shares_url.Rd @@ -6,6 +6,15 @@ \usage{ make_analytics_folder_shares_url(report_folder_id) } +\arguments{ +\item{report_folder_id}{\code{character}; the Salesforce Id assigned to a created +analytics folder (it will start with "00l").} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics folder calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Folder shares URL generator } diff --git a/man/make_analytics_notification_operations_url.Rd b/man/make_analytics_notification_operations_url.Rd index 5e603438..870fbf95 100644 --- a/man/make_analytics_notification_operations_url.Rd +++ b/man/make_analytics_notification_operations_url.Rd @@ -6,6 +6,11 @@ \usage{ make_analytics_notification_operations_url(notification_id) } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics notification calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Notification operations URL generator } diff --git a/man/make_analytics_notifications_limits_url.Rd b/man/make_analytics_notifications_limits_url.Rd index 795156c4..470be4a7 100644 --- a/man/make_analytics_notifications_limits_url.Rd +++ b/man/make_analytics_notifications_limits_url.Rd @@ -6,6 +6,11 @@ \usage{ make_analytics_notifications_limits_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics notification calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Notification limits URL generator } diff --git a/man/make_analytics_notifications_list_url.Rd b/man/make_analytics_notifications_list_url.Rd index 4f0367ec..e409be14 100644 --- a/man/make_analytics_notifications_list_url.Rd +++ b/man/make_analytics_notifications_list_url.Rd @@ -6,6 +6,11 @@ \usage{ make_analytics_notifications_list_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Analytics notification calls to. This URL is specific to your instance +and the API version being used. +} \description{ Analytics Notification list URL generator } diff --git a/man/make_base_metadata_url.Rd b/man/make_base_metadata_url.Rd index 1555f54c..647f73b4 100644 --- a/man/make_base_metadata_url.Rd +++ b/man/make_base_metadata_url.Rd @@ -6,6 +6,11 @@ \usage{ make_base_metadata_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Metadata API calls to. This URL is specific to your instance and the API +version being used. +} \description{ Base Metadata API URL Generator } diff --git a/man/make_base_rest_url.Rd b/man/make_base_rest_url.Rd index b6e12833..5281a894 100644 --- a/man/make_base_rest_url.Rd +++ b/man/make_base_rest_url.Rd @@ -6,6 +6,11 @@ \usage{ make_base_rest_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send REST API calls to. This URL is specific to your instance and the API +version being used. +} \description{ Base REST API URL Generator } diff --git a/man/make_base_soap_url.Rd b/man/make_base_soap_url.Rd index 89c8de55..d2fdd567 100644 --- a/man/make_base_soap_url.Rd +++ b/man/make_base_soap_url.Rd @@ -6,6 +6,11 @@ \usage{ make_base_soap_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send SOAP API calls to. This URL is specific to your instance and the API +version being used. +} \description{ Base SOAP API URL Generator } diff --git a/man/make_bulk_batch_details_url.Rd b/man/make_bulk_batch_details_url.Rd index af6e65f2..d460355b 100644 --- a/man/make_bulk_batch_details_url.Rd +++ b/man/make_bulk_batch_details_url.Rd @@ -6,6 +6,21 @@ \usage{ make_bulk_batch_details_url(job_id, batch_id, api_type = c("Bulk 1.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{batch_id}{\code{character}; the Salesforce Id assigned to a submitted +batch as returned by \link{sf_create_batches_bulk}. It will start with \code{"751"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Batch Details URL Generator } diff --git a/man/make_bulk_batch_status_url.Rd b/man/make_bulk_batch_status_url.Rd index c16d35c4..acb43e7f 100644 --- a/man/make_bulk_batch_status_url.Rd +++ b/man/make_bulk_batch_status_url.Rd @@ -6,6 +6,21 @@ \usage{ make_bulk_batch_status_url(job_id, batch_id, api_type = c("Bulk 1.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{batch_id}{\code{character}; the Salesforce Id assigned to a submitted +batch as returned by \link{sf_create_batches_bulk}. It will start with \code{"751"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Batch Status URL Generator } diff --git a/man/make_bulk_batches_url.Rd b/man/make_bulk_batches_url.Rd index d416626d..96107b92 100644 --- a/man/make_bulk_batches_url.Rd +++ b/man/make_bulk_batches_url.Rd @@ -6,6 +6,18 @@ \usage{ make_bulk_batches_url(job_id, api_type = c("Bulk 1.0", "Bulk 2.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Batches URL Generator } diff --git a/man/make_bulk_create_job_url.Rd b/man/make_bulk_create_job_url.Rd index c1dd2e40..ecb41af9 100644 --- a/man/make_bulk_create_job_url.Rd +++ b/man/make_bulk_create_job_url.Rd @@ -9,6 +9,18 @@ make_bulk_create_job_url( query_operation = FALSE ) } +\arguments{ +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} + +\item{query_operation}{\code{logical}; an indicator of whether the call is +for a query or another operation, such as, CRUD operations.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Create Job URL Generator } diff --git a/man/make_bulk_delete_job_url.Rd b/man/make_bulk_delete_job_url.Rd index 68ad7a32..f1d889bb 100644 --- a/man/make_bulk_delete_job_url.Rd +++ b/man/make_bulk_delete_job_url.Rd @@ -6,6 +6,18 @@ \usage{ make_bulk_delete_job_url(job_id, api_type = c("Bulk 2.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Delete Job Generic URL Generator } diff --git a/man/make_bulk_end_job_generic_url.Rd b/man/make_bulk_end_job_generic_url.Rd index 216ada0a..bba948d2 100644 --- a/man/make_bulk_end_job_generic_url.Rd +++ b/man/make_bulk_end_job_generic_url.Rd @@ -6,6 +6,18 @@ \usage{ make_bulk_end_job_generic_url(job_id, api_type = c("Bulk 1.0", "Bulk 2.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk End Job Generic URL Generator } diff --git a/man/make_bulk_get_all_jobs_url.Rd b/man/make_bulk_get_all_jobs_url.Rd index 31ce4176..098bea32 100644 --- a/man/make_bulk_get_all_jobs_url.Rd +++ b/man/make_bulk_get_all_jobs_url.Rd @@ -10,6 +10,20 @@ make_bulk_get_all_jobs_url( api_type = c("Bulk 2.0") ) } +\arguments{ +\item{parameterized_search_list}{\code{list}; a list of search options to locate +Bulk API jobs.} + +\item{next_records_url}{\code{character}; a string returned by a Salesforce +query from where to find subsequent records returned by a paginated query.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) to send a request +to in order to retrieve queried jobs. +} \description{ Bulk Get All Jobs Generic URL Generator } diff --git a/man/make_bulk_get_all_query_jobs_url.Rd b/man/make_bulk_get_all_query_jobs_url.Rd index 14f01e6f..9c8e5e23 100644 --- a/man/make_bulk_get_all_query_jobs_url.Rd +++ b/man/make_bulk_get_all_query_jobs_url.Rd @@ -11,6 +11,20 @@ make_bulk_get_all_query_jobs_url( api_type = c("Bulk 2.0") ) } +\arguments{ +\item{parameterized_search_list}{\code{list}; a list of search options to locate +Bulk API query jobs.} + +\item{next_records_url}{\code{character}; a string returned by a Salesforce +query from where to find subsequent records returned by a paginated query.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) to send a request +to in order to retrieve queried jobs. +} \description{ Bulk Get All Query Jobs Generic URL Generator } diff --git a/man/make_bulk_get_job_url.Rd b/man/make_bulk_get_job_url.Rd index 842ed76e..24252d0e 100644 --- a/man/make_bulk_get_job_url.Rd +++ b/man/make_bulk_get_job_url.Rd @@ -10,6 +10,21 @@ make_bulk_get_job_url( query_operation = NULL ) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} + +\item{query_operation}{\code{logical}; an indicator of whether the call is +for a query or another operation, such as, CRUD operations.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Get Job Generic URL Generator } diff --git a/man/make_bulk_job_records_url.Rd b/man/make_bulk_job_records_url.Rd index ae6024f5..e128c26f 100644 --- a/man/make_bulk_job_records_url.Rd +++ b/man/make_bulk_job_records_url.Rd @@ -10,6 +10,21 @@ make_bulk_job_records_url( api_type = c("Bulk 2.0") ) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{record_type}{\code{character}; one of 'successfulResults', 'failedResults', +or 'unprocessedRecords' indicating the type of records to retrieve.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Job Records URL Generator } diff --git a/man/make_bulk_query_result_url.Rd b/man/make_bulk_query_result_url.Rd index 828901d0..513ed5aa 100644 --- a/man/make_bulk_query_result_url.Rd +++ b/man/make_bulk_query_result_url.Rd @@ -11,6 +11,24 @@ make_bulk_query_result_url( api_type = c("Bulk 1.0", "Bulk 2.0") ) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{batch_id}{\code{character}; the Salesforce Id assigned to a submitted +batch as returned by \link{sf_create_batches_bulk}. It will start with \code{"751"}.} + +\item{result_id}{\code{character}; the Salesforce Id assigned to a generated +result for a bulk query batch.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Query Result URL Generator } diff --git a/man/make_bulk_query_url.Rd b/man/make_bulk_query_url.Rd index 7aef098e..ffca5b78 100644 --- a/man/make_bulk_query_url.Rd +++ b/man/make_bulk_query_url.Rd @@ -6,6 +6,18 @@ \usage{ make_bulk_query_url(job_id = NULL, api_type = c("Bulk 1.0", "Bulk 2.0")) } +\arguments{ +\item{job_id}{\code{character}; the Salesforce Id assigned to a submitted job as +returned by \link{sf_create_job_bulk}. It will start with \code{"750"}.} + +\item{api_type}{\code{character}; a string indicating which Bulk API to execute +the call against.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send subsequent Bulk API calls to. This URL is specific to your instance and +the API version being used. +} \description{ Bulk Query URL Generator } diff --git a/man/make_chatter_users_url.Rd b/man/make_chatter_users_url.Rd index 8a8e6961..8bfdf061 100644 --- a/man/make_chatter_users_url.Rd +++ b/man/make_chatter_users_url.Rd @@ -6,6 +6,11 @@ \usage{ make_chatter_users_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send REST API calls regarding chatter users. This URL is specific to your +instance and the API version because it relies on the base rest URL. +} \description{ Chatter Users URL Generator } diff --git a/man/make_composite_batch_url.Rd b/man/make_composite_batch_url.Rd index 8a5a9e80..d9eecf68 100644 --- a/man/make_composite_batch_url.Rd +++ b/man/make_composite_batch_url.Rd @@ -6,6 +6,11 @@ \usage{ make_composite_batch_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send composite batch REST API calls to. This URL is specific to your instance +and the API version being used because it relies on the base REST URL. +} \description{ Composite Batch URL Generator } diff --git a/man/make_composite_url.Rd b/man/make_composite_url.Rd index 6da8adce..ffd957d9 100644 --- a/man/make_composite_url.Rd +++ b/man/make_composite_url.Rd @@ -6,6 +6,11 @@ \usage{ make_composite_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send composite REST API calls to. This URL is specific to your +instance and the API version because it relies on the base rest URL. +} \description{ Composite URL Generator } diff --git a/man/make_dashboard_copy_url.Rd b/man/make_dashboard_copy_url.Rd index 7cc67768..a0dd428d 100644 --- a/man/make_dashboard_copy_url.Rd +++ b/man/make_dashboard_copy_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_copy_url(dashboard_id) } +\arguments{ +\item{dashboard_id}{\code{character}; the Salesforce Id assigned to a created +dashboard. It will start with \code{"01Z"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard Copy URL generator } diff --git a/man/make_dashboard_describe_url.Rd b/man/make_dashboard_describe_url.Rd index 5e30e404..839f99a7 100644 --- a/man/make_dashboard_describe_url.Rd +++ b/man/make_dashboard_describe_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_describe_url(dashboard_id) } +\arguments{ +\item{dashboard_id}{\code{character}; the Salesforce Id assigned to a created +dashboard. It will start with \code{"01Z"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard describe URL generator } diff --git a/man/make_dashboard_filter_operators_list_url.Rd b/man/make_dashboard_filter_operators_list_url.Rd index 1ca4ccb9..36c7a0eb 100644 --- a/man/make_dashboard_filter_operators_list_url.Rd +++ b/man/make_dashboard_filter_operators_list_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_filter_operators_list_url(for_dashboards = FALSE) } +\arguments{ +\item{for_dashboards}{\code{logical}; an indicator of whether the filter is +in reference to dashboards or not.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard filter operators list URL generator } diff --git a/man/make_dashboard_filter_options_analysis_url.Rd b/man/make_dashboard_filter_options_analysis_url.Rd index 5824f269..fffe573c 100644 --- a/man/make_dashboard_filter_options_analysis_url.Rd +++ b/man/make_dashboard_filter_options_analysis_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_filter_options_analysis_url(dashboard_id) } +\arguments{ +\item{dashboard_id}{\code{character}; the Salesforce Id assigned to a created +dashboard. It will start with \code{"01Z"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard filter options analysis URL generator } diff --git a/man/make_dashboard_status_url.Rd b/man/make_dashboard_status_url.Rd index 3e10c245..6eee4429 100644 --- a/man/make_dashboard_status_url.Rd +++ b/man/make_dashboard_status_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_status_url(dashboard_id) } +\arguments{ +\item{dashboard_id}{\code{character}; the Salesforce Id assigned to a created +dashboard. It will start with \code{"01Z"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard status URL generator } diff --git a/man/make_dashboard_url.Rd b/man/make_dashboard_url.Rd index 6d1bbf75..65444632 100644 --- a/man/make_dashboard_url.Rd +++ b/man/make_dashboard_url.Rd @@ -6,6 +6,15 @@ \usage{ make_dashboard_url(dashboard_id) } +\arguments{ +\item{dashboard_id}{\code{character}; the Salesforce Id assigned to a created +dashboard. It will start with \code{"01Z"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard URL generator } diff --git a/man/make_dashboards_list_url.Rd b/man/make_dashboards_list_url.Rd index 14ab87d0..837a729d 100644 --- a/man/make_dashboards_list_url.Rd +++ b/man/make_dashboards_list_url.Rd @@ -6,6 +6,11 @@ \usage{ make_dashboards_list_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Dashboard list URL generator } diff --git a/man/make_login_url.Rd b/man/make_login_url.Rd index d84a294c..9d564808 100644 --- a/man/make_login_url.Rd +++ b/man/make_login_url.Rd @@ -6,10 +6,23 @@ \usage{ make_login_url(login_url) } +\arguments{ +\item{login_url}{\code{character}; the package default login URL is +https://login.salesforce.com, but other URLs can be used. For example, if you +are logging into a sandbox environment, then the login URL should be set to +https://test.salesforce.com.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +login to. This string is specific to your environment (production, sandbox, +etc.) and the API version being used. +} \description{ Login URL Generator } \note{ This function is meant to be used internally. Only use when debugging. +You should set the login URL globally as one of the package options: +\code{options(salesforcer.login_url="https://test.salesforce.com")}. } \keyword{internal} diff --git a/man/make_parameterized_search_url.Rd b/man/make_parameterized_search_url.Rd index b2f97d75..7fa4a3e6 100644 --- a/man/make_parameterized_search_url.Rd +++ b/man/make_parameterized_search_url.Rd @@ -5,17 +5,25 @@ \title{Parameterized Search URL Generator} \usage{ make_parameterized_search_url(search_string = NULL, params = NULL) +} +\arguments{ +\item{search_string}{\code{character}; a valid string for conducting a simple +RESTful search using parameters instead of a SOSL clause.} -make_parameterized_search_url(search_string = NULL, params = NULL) +\item{params}{\code{list}; a list of other values to populate in the URL +query string to further restrict the search} +} +\value{ +\code{character}; a complete URL (as a string) that has applied the +proper escaping and formatting for the search specified by the function inputs. } \description{ -Parameterized Search URL Generator - Parameterized Search URL Generator } \note{ This function is meant to be used internally. Only use when debugging. - -This function is meant to be used internally. Only use when debugging. +} +\references{ +\url{https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_parameterized.htm} } \keyword{internal} diff --git a/man/make_query_url.Rd b/man/make_query_url.Rd index c7fb0deb..6cc68769 100644 --- a/man/make_query_url.Rd +++ b/man/make_query_url.Rd @@ -6,6 +6,22 @@ \usage{ make_query_url(soql, queryall, next_records_url) } +\arguments{ +\item{soql}{\code{character}; a string defining a SOQL query +(e.g. "SELECT Id, Name FROM Account").} + +\item{queryall}{\code{logical}; indicating if the query recordset should include records +that have been deleted because of a merge or delete. Setting this argument to +\code{TRUE} will also return information about archived Task and Event records. +It is available in API versions 29.0 and later.} + +\item{next_records_url}{\code{character}; a string returned by a Salesforce +query from where to find subsequent records returned by a paginated query.} +} +\value{ +\code{character}; a complete URL (as a string) to send a request +to in order to retrieve queried records. +} \description{ Query URL Generator } diff --git a/man/make_report_copy_url.Rd b/man/make_report_copy_url.Rd index 8de7b5df..7b408c7c 100644 --- a/man/make_report_copy_url.Rd +++ b/man/make_report_copy_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_copy_url(report_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Copy URL generator } diff --git a/man/make_report_create_url.Rd b/man/make_report_create_url.Rd index a424630e..39a6c5c3 100644 --- a/man/make_report_create_url.Rd +++ b/man/make_report_create_url.Rd @@ -6,6 +6,11 @@ \usage{ make_report_create_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Create URL generator } diff --git a/man/make_report_describe_url.Rd b/man/make_report_describe_url.Rd index a3b4e8d3..fa17de92 100644 --- a/man/make_report_describe_url.Rd +++ b/man/make_report_describe_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_describe_url(report_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Describe URL generator } diff --git a/man/make_report_execute_url.Rd b/man/make_report_execute_url.Rd index a3a3fd4a..63896c18 100644 --- a/man/make_report_execute_url.Rd +++ b/man/make_report_execute_url.Rd @@ -6,6 +6,25 @@ \usage{ make_report_execute_url(report_id, async = TRUE, include_details = FALSE) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} + +\item{async}{\code{logical}; an indicator, by default set to \code{TRUE}, which +executes the report asynchronously. If executed asynchronously, this function +will return a list of attributes of the created report instance. The results +can be pulled down by providing the report id and instance id to +the function \code{\link{sf_get_report_instance_results}}. Refer to the details +of the documentation on why executing a report asynchronously is preferred.} + +\item{include_details}{\code{logical}; an indicator applying to a synchronous +indicating whether the run should return summary data with details.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Execute URL generator } diff --git a/man/make_report_fields_url.Rd b/man/make_report_fields_url.Rd index 25f180f1..82252b8e 100644 --- a/man/make_report_fields_url.Rd +++ b/man/make_report_fields_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_fields_url(report_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Fields URL generator } diff --git a/man/make_report_filter_operators_list_url.Rd b/man/make_report_filter_operators_list_url.Rd index 36fe57aa..43cbe9ef 100644 --- a/man/make_report_filter_operators_list_url.Rd +++ b/man/make_report_filter_operators_list_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_filter_operators_list_url(for_dashboards = FALSE) } +\arguments{ +\item{for_dashboards}{\code{logical}; an indicator of whether the filter is +in reference to dashboards or not.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Filter Operator List URL generator } diff --git a/man/make_report_instance_url.Rd b/man/make_report_instance_url.Rd index bac54e73..48a18340 100644 --- a/man/make_report_instance_url.Rd +++ b/man/make_report_instance_url.Rd @@ -6,6 +6,19 @@ \usage{ make_report_instance_url(report_id, report_instance_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} + +\item{report_instance_id}{\code{character}; the Salesforce Id assigned to a +created analytics report instance (an asynchronous run). It will start with +\code{"0LG"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Instance URL generator } diff --git a/man/make_report_instances_list_url.Rd b/man/make_report_instances_list_url.Rd index e9a44f5a..f0bc7346 100644 --- a/man/make_report_instances_list_url.Rd +++ b/man/make_report_instances_list_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_instances_list_url(report_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Instances List URL generator } diff --git a/man/make_report_query_url.Rd b/man/make_report_query_url.Rd index 852282ac..333fbb80 100644 --- a/man/make_report_query_url.Rd +++ b/man/make_report_query_url.Rd @@ -6,6 +6,11 @@ \usage{ make_report_query_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Query URL generator } diff --git a/man/make_report_type_describe_url.Rd b/man/make_report_type_describe_url.Rd index f80a76da..99d50f46 100644 --- a/man/make_report_type_describe_url.Rd +++ b/man/make_report_type_describe_url.Rd @@ -6,6 +6,14 @@ \usage{ make_report_type_describe_url(type) } +\arguments{ +\item{type}{\code{character}; The API name of a report type.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Type Describe URL generator } diff --git a/man/make_report_types_list_url.Rd b/man/make_report_types_list_url.Rd index ecc52259..8bf7af90 100644 --- a/man/make_report_types_list_url.Rd +++ b/man/make_report_types_list_url.Rd @@ -6,6 +6,11 @@ \usage{ make_report_types_list_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report Type List URL generator } diff --git a/man/make_report_url.Rd b/man/make_report_url.Rd index a39bf6d9..2d03e9e2 100644 --- a/man/make_report_url.Rd +++ b/man/make_report_url.Rd @@ -6,6 +6,15 @@ \usage{ make_report_url(report_id) } +\arguments{ +\item{report_id}{\code{character}; the Salesforce Id assigned to a created +analytics report. It will start with \code{"00O"}.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Report URL generator } diff --git a/man/make_reports_list_url.Rd b/man/make_reports_list_url.Rd index f98f4b9b..268e3f24 100644 --- a/man/make_reports_list_url.Rd +++ b/man/make_reports_list_url.Rd @@ -6,6 +6,11 @@ \usage{ make_reports_list_url() } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send Reports and Dashboards API calls to. This URL is specific to your instance +and the API version being used. +} \description{ Reports List URL generator } diff --git a/man/make_rest_describe_url.Rd b/man/make_rest_describe_url.Rd index fffddb2b..01fdb429 100644 --- a/man/make_rest_describe_url.Rd +++ b/man/make_rest_describe_url.Rd @@ -10,6 +10,11 @@ make_rest_describe_url(object_name) \item{object_name}{\code{character}; the name of the Salesforce object that the function is operating against (e.g. "Account", "Contact", "CustomObject__c").} } +\value{ +\code{character}; a complete URL (as a string) that will be used to +send REST API calls to regarding a specific object. This URL is also specific +to your instance and the API version being used. +} \description{ REST API Describe URL Generator } diff --git a/man/make_rest_objects_url.Rd b/man/make_rest_objects_url.Rd index ca230e3c..5d9c143c 100644 --- a/man/make_rest_objects_url.Rd +++ b/man/make_rest_objects_url.Rd @@ -4,7 +4,16 @@ \alias{make_rest_objects_url} \title{REST Objects URL Generator} \usage{ -make_rest_objects_url(object) +make_rest_objects_url(object_name) +} +\arguments{ +\item{object_name}{\code{character}; the name of the Salesforce object that the +function is operating against (e.g. "Account", "Contact", "CustomObject__c").} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send REST API calls to regarding a specific object. This URL is also specific +to your instance and the API version being used. } \description{ REST Objects URL Generator diff --git a/man/make_rest_record_url.Rd b/man/make_rest_record_url.Rd index ec98c122..23f5c69f 100644 --- a/man/make_rest_record_url.Rd +++ b/man/make_rest_record_url.Rd @@ -4,7 +4,19 @@ \alias{make_rest_record_url} \title{REST Individual Record URL Generator} \usage{ -make_rest_record_url(object, sf_id) +make_rest_record_url(object_name, sf_id) +} +\arguments{ +\item{object_name}{\code{character}; the name of the Salesforce object that the +function is operating against (e.g. "Account", "Contact", "CustomObject__c").} + +\item{sf_id}{\code{character}; a Salesforce generated Id that uniquely +identifies a record.} +} +\value{ +\code{character}; a complete URL (as a string) that will be used to +send REST API calls to regarding a specific record in an object. This URL is +also specific to your instance and the API version being used. } \description{ REST Individual Record URL Generator diff --git a/man/make_search_url.Rd b/man/make_search_url.Rd index d7cf1fd9..0debdf25 100644 --- a/man/make_search_url.Rd +++ b/man/make_search_url.Rd @@ -6,6 +6,14 @@ \usage{ make_search_url(search_string) } +\arguments{ +\item{search_string}{\code{character}; a valid string for conducting a SOSL +search.} +} +\value{ +\code{character}; a complete URL (as a string) that has applied the +proper escaping and formatting for the search specified by the string. +} \description{ Search URL Generator } diff --git a/man/make_soap_xml_skeleton.Rd b/man/make_soap_xml_skeleton.Rd index 4d4beea1..15985729 100644 --- a/man/make_soap_xml_skeleton.Rd +++ b/man/make_soap_xml_skeleton.Rd @@ -8,9 +8,13 @@ make_soap_xml_skeleton(soap_headers = list(), metadata_ns = FALSE) } \arguments{ \item{soap_headers}{\code{list}; any number of SOAP headers} + +\item{metadata_ns}{\code{logical}; an indicator of whether to use the namespaces +required by the Metadata API or the default ones.} } \value{ -a XML document +\code{xmlNode}; an XML object containing just the header portion of the +request } \description{ Create XML in preparation for sending to the SOAP API diff --git a/man/make_verbose_httr_message.Rd b/man/make_verbose_httr_message.Rd index 7c88c6b6..00e1f6c6 100644 --- a/man/make_verbose_httr_message.Rd +++ b/man/make_verbose_httr_message.Rd @@ -13,6 +13,25 @@ make_verbose_httr_message( ... ) } +\arguments{ +\item{method}{\code{character}; the type of HTTP method invoked (e.g., POST, +PUT, DELETE, etc.).} + +\item{url}{\code{character}; the URL that the request was sent to} + +\item{headers}{\code{character}; the set of header options set on the request} + +\item{body}{\code{character}; the body of the request.} + +\item{auto_unbox}{\code{logical}, an indicator of whether to parse vectors of +of length 1 into a single character string, rather than a list.} + +\item{...}{additional arguments passed on to \code{\link[jsonlite]{toJSON}}.} +} +\value{ +\code{NULL} invisibly, because this function is intended for the +side-effect of printing out the details of an HTTP call. +} \description{ Format Verbose Call } diff --git a/man/merge_null_to_na.Rd b/man/merge_null_to_na.Rd index 6d9ed14f..2a2ad124 100644 --- a/man/merge_null_to_na.Rd +++ b/man/merge_null_to_na.Rd @@ -6,8 +6,18 @@ \usage{ merge_null_to_na(x) } +\arguments{ +\item{x}{a value, typically a single element or a list to switch to NA if +its value appears to be NULL.} +} +\value{ +the original value of parameter \code{x} or \code{NA} if the value +meets the criteria to be considered NULL. +} \description{ -Return NA if NULL +A helper function to convert NULL values in API responses to a value of NA +which is allowed in data frames. Oftentimes, a NULL value creates issues when +binding and building data frames from parsed output, so we need to switch to NA. } \note{ This function is meant to be used internally. Only use when debugging. diff --git a/man/parse_error_code_and_message.Rd b/man/parse_error_code_and_message.Rd index 00444974..d64d6f93 100644 --- a/man/parse_error_code_and_message.Rd +++ b/man/parse_error_code_and_message.Rd @@ -6,6 +6,12 @@ \usage{ parse_error_code_and_message(x) } +\arguments{ +\item{x}{\code{response()}; a response that indicates an error} +} +\value{ +\code{list}; a list containing the error code and message for printing. +} \description{ Assuming the error code is less than 500, this function will return the } diff --git a/man/rDELETE.Rd b/man/rDELETE.Rd index 14de13bc..9f925192 100644 --- a/man/rDELETE.Rd +++ b/man/rDELETE.Rd @@ -6,6 +6,9 @@ \usage{ rDELETE(url, headers = character(0), ...) } +\value{ +A \code{response()} object as defined by the \code{httr} package. +} \description{ DELETEs with retries and authentication } diff --git a/man/rGET.Rd b/man/rGET.Rd index d4e6cb48..4468e4d2 100644 --- a/man/rGET.Rd +++ b/man/rGET.Rd @@ -6,6 +6,9 @@ \usage{ rGET(url, headers = character(0), ...) } +\value{ +A \code{response()} object as defined by the \code{httr} package. +} \description{ GETs with retries and authentication } diff --git a/man/rPATCH.Rd b/man/rPATCH.Rd index c8e6350a..2182967e 100644 --- a/man/rPATCH.Rd +++ b/man/rPATCH.Rd @@ -6,6 +6,9 @@ \usage{ rPATCH(url, headers = character(0), ...) } +\value{ +A \code{response()} object as defined by the \code{httr} package. +} \description{ PATCHs with retries and authentication } diff --git a/man/rPOST.Rd b/man/rPOST.Rd index dcda1f41..1b6da5a1 100644 --- a/man/rPOST.Rd +++ b/man/rPOST.Rd @@ -6,6 +6,9 @@ \usage{ rPOST(url, headers = character(0), ...) } +\value{ +A \code{response()} object as defined by the \code{httr} package. +} \description{ POSTs with retries and authentication } diff --git a/man/rPUT.Rd b/man/rPUT.Rd index b5df58f5..0882fd7e 100644 --- a/man/rPUT.Rd +++ b/man/rPUT.Rd @@ -6,6 +6,9 @@ \usage{ rPUT(url, headers = character(0), ...) } +\value{ +A \code{response()} object as defined by the \code{httr} package. +} \description{ PUTs with retries and authentication } diff --git a/man/remove_empty_linked_object_cols.Rd b/man/remove_empty_linked_object_cols.Rd index c76dfbf4..f0aaa58b 100644 --- a/man/remove_empty_linked_object_cols.Rd +++ b/man/remove_empty_linked_object_cols.Rd @@ -13,6 +13,10 @@ remove_empty_linked_object_cols(dat, api_type = c("SOAP", "REST")) \code{"Bulk 1.0"}, or \code{"Bulk 2.0"} indicating which API to use when making the request.} } +\value{ +\code{tbl_df}; the passed in data, but with the object columns removed +that are empty links to other objects. +} \description{ This function will detect if there are related entity columns coming back in the resultset and try to exclude an additional completely blank column diff --git a/man/return_matching_controls.Rd b/man/return_matching_controls.Rd index e93b68a1..d6ec4cd3 100644 --- a/man/return_matching_controls.Rd +++ b/man/return_matching_controls.Rd @@ -6,6 +6,16 @@ \usage{ return_matching_controls(args) } +\arguments{ +\item{args}{\code{character}; a vector of strings that represent the function +arguments.} +} +\value{ +\code{character}; a vector of strings returning only the function arguments +that match control arguments so that users can specify them directly in each +function and not have to construct a control object every time in order to +pass only one or two control arguments. +} \description{ Of All Args Return Ones Matching Control Arguments } diff --git a/man/rforcecom.login.Rd b/man/rforcecom.login.Rd index 0c063fde..eeccbd78 100644 --- a/man/rforcecom.login.Rd +++ b/man/rforcecom.login.Rd @@ -17,7 +17,7 @@ rforcecom.login( \item{password}{Your password for login to the Salesforce.com. Note: DO NOT FORGET your Security Token. (Ex.) If your password is "Pass1234" and your security token is "XYZXYZXYZXYZ", you should set "Pass1234XYZXYZXYZXYZ".} -\item{loginURL}{(optional) Login URL. If your environment is sandbox specify (ex:) "https://test.salesforce.com/".} +\item{loginURL}{(optional) Login URL. If your environment is sandbox specify (ex:) "https://test.salesforce.com".} \item{apiVersion}{(optional) Version of the REST API and SOAP API that you want to use. (ex:) "35.0" Supported versions from v20.0 and up.} } diff --git a/man/salesforcer_state.Rd b/man/salesforcer_state.Rd index 967d0c98..d44f348e 100644 --- a/man/salesforcer_state.Rd +++ b/man/salesforcer_state.Rd @@ -6,6 +6,9 @@ \usage{ salesforcer_state() } +\value{ +\code{list}; a list of values stored in the package's .state environment variable +} \description{ Return the package's .state environment variable } diff --git a/man/session_id_available.Rd b/man/session_id_available.Rd index f5ac9823..681885f9 100644 --- a/man/session_id_available.Rd +++ b/man/session_id_available.Rd @@ -7,7 +7,7 @@ session_id_available(verbose = TRUE) } \value{ -logical +\code{logical} } \description{ Check if a session_id is available in \code{\link{salesforcer}}'s internal diff --git a/man/sf_create_job_bulk_v1.Rd b/man/sf_create_job_bulk_v1.Rd index 6972dc68..f53bac7b 100644 --- a/man/sf_create_job_bulk_v1.Rd +++ b/man/sf_create_job_bulk_v1.Rd @@ -16,6 +16,41 @@ sf_create_job_bulk_v1( verbose = FALSE ) } +\arguments{ +\item{operation}{\code{character}; a string defining the type of operation being +performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", +"query", "queryall").} + +\item{object_name}{\code{character}; the name of the Salesforce object that the +function is operating against (e.g. "Account", "Contact", "CustomObject__c").} + +\item{external_id_fieldname}{\code{character}; string identifying a custom field on the +object that has been set as an "External ID" field. This field is used to reference +objects during upserts to determine if the record already exists in Salesforce or not.} + +\item{content_type}{\code{character}; a string indicating the format for +the API request and response. Must be one of 'CSV', 'ZIP_CSV', 'ZIP_XML', or +'ZIP_JSON'.} + +\item{concurrency_mode}{\code{character}; a string indicating whether the batches +should be processed in parallel or serially (sequentially). Serial processing +is helpful when multiple records may trigger simultaneous edits to another +related record (e.g., updating multiple children all on the same account).} + +\item{control}{\code{list}; a list of parameters for controlling the behavior of +the API call being used. For more information of what parameters are available +look at the documentation for \code{\link{sf_control}}.} + +\item{...}{arguments to be used to form the default control argument if it is not supplied directly.} + +\item{verbose}{\code{logical}; an indicator of whether to print additional +detail for each API call, which is useful for debugging. More specifically, when +set to \code{TRUE} the URL, header, and body will be printed for each request, +along with additional diagnostic information where available.} +} +\value{ +\code{tbl_df}; a data frame containing information about the job created. +} \description{ Create Job using Bulk 1.0 API } diff --git a/man/sf_create_job_bulk_v2.Rd b/man/sf_create_job_bulk_v2.Rd index 7121327d..d6e4b779 100644 --- a/man/sf_create_job_bulk_v2.Rd +++ b/man/sf_create_job_bulk_v2.Rd @@ -16,6 +16,43 @@ sf_create_job_bulk_v2( verbose = FALSE ) } +\arguments{ +\item{operation}{\code{character}; a string defining the type of operation being +performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", +"query", "queryall").} + +\item{object_name}{\code{character}; the name of the Salesforce object that the +function is operating against (e.g. "Account", "Contact", "CustomObject__c").} + +\item{soql}{\code{character}; a string defining a SOQL query +(e.g. "SELECT Id, Name FROM Account").} + +\item{external_id_fieldname}{\code{character}; string identifying a custom field on the +object that has been set as an "External ID" field. This field is used to reference +objects during upserts to determine if the record already exists in Salesforce or not.} + +\item{content_type}{\code{character}; a string indicating the format for +the API request and response. Must be 'CSV' because it is the only supported +format for the Bulk 2.0 API.} + +\item{column_delimiter}{\code{character}; a string indicating which character +should be treated as the delimiter in the CSV file. Must be one of 'COMMA', +'TAB', 'PIPE', 'SEMICOLON', 'CARET', or 'BACKQUOTE'.} + +\item{control}{\code{list}; a list of parameters for controlling the behavior of +the API call being used. For more information of what parameters are available +look at the documentation for \code{\link{sf_control}}.} + +\item{...}{arguments to be used to form the default control argument if it is not supplied directly.} + +\item{verbose}{\code{logical}; an indicator of whether to print additional +detail for each API call, which is useful for debugging. More specifically, when +set to \code{TRUE} the URL, header, and body will be printed for each request, +along with additional diagnostic information where available.} +} +\value{ +\code{tbl_df}; a data frame containing information about the job created. +} \description{ Create Job using Bulk 2.0 API } diff --git a/man/sf_end_job_bulk.Rd b/man/sf_end_job_bulk.Rd index c93bedea..a2f2191d 100644 --- a/man/sf_end_job_bulk.Rd +++ b/man/sf_end_job_bulk.Rd @@ -27,6 +27,10 @@ detail for each API call, which is useful for debugging. More specifically, when set to \code{TRUE} the URL, header, and body will be printed for each request, along with additional diagnostic information where available.} } +\value{ +\code{logical}; returns \code{TRUE} if the job was able to be ended; +otherwise, an error message is printed +} \description{ End Bulk API Job } diff --git a/man/sf_format_date.Rd b/man/sf_format_date.Rd index aa01c709..13127508 100644 --- a/man/sf_format_date.Rd +++ b/man/sf_format_date.Rd @@ -6,6 +6,13 @@ \usage{ sf_format_date(x) } +\arguments{ +\item{x}{a value representing a datetime} +} +\value{ +\code{character}; a date string with the time set to midnight and then +formatted in ISO8601 per the requirements of the Salesforce APIs. +} \description{ Format Dates for Create and Update operations } diff --git a/man/sf_format_datetime.Rd b/man/sf_format_datetime.Rd index d75105e8..f7506163 100644 --- a/man/sf_format_datetime.Rd +++ b/man/sf_format_datetime.Rd @@ -6,6 +6,13 @@ \usage{ sf_format_datetime(x) } +\arguments{ +\item{x}{a value representing a datetime} +} +\value{ +\code{character}; a datetime string formatted in ISO8601 per the +requirements of the Salesforce APIs. +} \description{ Format Datetimes for Create and Update operations } diff --git a/man/sf_format_time.Rd b/man/sf_format_time.Rd new file mode 100644 index 00000000..5e599617 --- /dev/null +++ b/man/sf_format_time.Rd @@ -0,0 +1,26 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/utils-datatypes.R +\name{sf_format_time} +\alias{sf_format_time} +\title{Format all Date and Datetime columns in a list} +\usage{ +sf_format_time(x, ...) +} +\arguments{ +\item{x}{data which may or may not have values, elements, columns that +represent a datetime. If so, each of those are cast to the ISO8601 standard +per the requirements of Salesforce APIs.} +} +\value{ +the same data object with datetime values formatted. +} +\description{ +Format all Date and Datetime columns in a list +} +\note{ +This function is meant to be used internally. Only use when debugging. +} +\seealso{ +\url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} +} +\keyword{internal} diff --git a/man/sf_format_time.data.frame.Rd b/man/sf_format_time.data.frame.Rd index f2542bef..a3b0d0c9 100644 --- a/man/sf_format_time.data.frame.Rd +++ b/man/sf_format_time.data.frame.Rd @@ -6,6 +6,14 @@ \usage{ \method{sf_format_time}{data.frame}(x) } +\arguments{ +\item{x}{\code{tbl_df}; a data frame object which may or may not have columns +that represent a datetime. If so, they are cast to the ISO8601 standard per +the requirements of Salesforce APIs.} +} +\value{ +\code{tbl_df}; the same data frame object with datetime values formatted. +} \description{ Format all Date and Datetime columns in a dataset } diff --git a/man/sf_format_time.list.Rd b/man/sf_format_time.list.Rd index f62e7e9b..e4d810a8 100644 --- a/man/sf_format_time.list.Rd +++ b/man/sf_format_time.list.Rd @@ -6,6 +6,14 @@ \usage{ \method{sf_format_time}{list}(x) } +\arguments{ +\item{x}{\code{list}; a list object which may or may not have values +that represent a datetime. If so, they are cast to the ISO8601 standard per +the requirements of Salesforce APIs.} +} +\value{ +\code{list}; the same list object with datetime values formatted. +} \description{ Format all Date and Datetime columns in a list } diff --git a/man/sf_input_data_validation.Rd b/man/sf_input_data_validation.Rd index 9b08ffeb..d5cae806 100644 --- a/man/sf_input_data_validation.Rd +++ b/man/sf_input_data_validation.Rd @@ -6,6 +6,21 @@ \usage{ sf_input_data_validation(input_data, operation = "") } +\arguments{ +\item{input_data}{\code{named vector}, \code{matrix}, \code{data.frame}, or +\code{tbl_df}; data can be coerced into a \code{data.frame}. If performing an +\code{update}, \code{upsert}, or \code{delete} operation, then one column or +field must be the \code{Id} of the record to modify or delete.} + +\item{operation}{\code{character}; a string defining the type of operation being +performed (e.g. "insert", "update", "upsert", "delete", "hardDelete", +"query", "queryall").} +} +\value{ +the input data validated and formatted according to the specified +operation. This allows more flexibility for the user while ensuring that all +inputs are formatted as expected by the target APIs and operations. +} \description{ Validate the input for an operation } diff --git a/man/sf_rest_list.Rd b/man/sf_rest_list.Rd index e2905611..51fefc7d 100644 --- a/man/sf_rest_list.Rd +++ b/man/sf_rest_list.Rd @@ -7,6 +7,8 @@ sf_rest_list(url, as_tbl = FALSE, records_root = NULL, verbose = FALSE) } \arguments{ +\item{url}{\code{character}; a valid REST API URL (as a string)} + \item{as_tbl}{\code{logical}; an indicator of whether to convert the parsed JSON into a \code{tbl_df}.} @@ -20,6 +22,9 @@ detail for each API call, which is useful for debugging. More specifically, when set to \code{TRUE} the URL, header, and body will be printed for each request, along with additional diagnostic information where available.} } +\value{ +\code{tbl_df} or \code{list} of data depending on what was requested. +} \description{ Execute a non-paginated REST API call to list items } diff --git a/man/sf_write_csv.Rd b/man/sf_write_csv.Rd index b928e280..62d2dac5 100644 --- a/man/sf_write_csv.Rd +++ b/man/sf_write_csv.Rd @@ -6,6 +6,19 @@ \usage{ sf_write_csv(x, file, path = deprecated()) } +\arguments{ +\item{x}{\code{tbl_df}; a data frame object to save as a CSV} + +\item{file}{A file or connection to write to.} + +\item{path}{\Sexpr[results=rd, stage=render]{lifecycle::badge("deprecated")}, +use the \code{file} argument instead.} +} +\value{ +the input \code{x} invisibly. This function is called for its +side-effect of creating a CSV file at the specified location using the format +required by Salesforce. +} \description{ Write a CSV file in format acceptable to Salesforce APIs } diff --git a/man/token_available.Rd b/man/token_available.Rd index e4bde6b8..60200589 100644 --- a/man/token_available.Rd +++ b/man/token_available.Rd @@ -7,7 +7,7 @@ token_available(verbose = FALSE) } \value{ -logical +\code{logical} } \description{ Check if a token is available in \code{\link{salesforcer}}'s internal diff --git a/man/validate_get_all_jobs_params.Rd b/man/validate_get_all_jobs_params.Rd index b995f190..8dd32555 100644 --- a/man/validate_get_all_jobs_params.Rd +++ b/man/validate_get_all_jobs_params.Rd @@ -6,6 +6,17 @@ \usage{ validate_get_all_jobs_params(parameterized_search_list, type = "all") } +\arguments{ +\item{parameterized_search_list}{\code{list}; a list of search options to +locate Bulk API jobs.} + +\item{type}{\code{character}; a string indicating which type of jobs to +include in the result.} +} +\value{ +\code{character}; a complete URL (as a string) to send a request +to in order to retrieve queried jobs. +} \description{ Validate Query Parameters When Getting List of All Bulk Jobs } diff --git a/man/xml_drop_and_unlist.Rd b/man/xml_drop_and_unlist.Rd index 736f5a5c..7884761f 100644 --- a/man/xml_drop_and_unlist.Rd +++ b/man/xml_drop_and_unlist.Rd @@ -7,7 +7,12 @@ xml_drop_and_unlist(x) } \arguments{ -\item{x}{\code{list}; a list of xml content parsed into a list by xml2} +\item{x}{\code{list}; a list of XML content parsed into a list by xml2} +} +\value{ +\code{character}; a named vector of strings from the parsed XML. Nested +elements have their hierarchy represented by a period between the element names +at each level. } \description{ This function will detect if there are metadata fields returned by the SOAP diff --git a/man/xml_extract_parent_and_child_result.Rd b/man/xml_extract_parent_and_child_result.Rd index 43c3814a..dd324723 100644 --- a/man/xml_extract_parent_and_child_result.Rd +++ b/man/xml_extract_parent_and_child_result.Rd @@ -10,6 +10,9 @@ xml_extract_parent_and_child_result(x) \item{x}{\code{xml_node}; a \code{xml_node} from an xml2 parsed response representing one individual parent query record.} } +\value{ +\code{tbl_df} of the query result for that parent record. +} \description{ This function accepts a node representing the result of an individual parent recordset from a nested parent-child query where there are zero or more child diff --git a/man/xml_nodeset_to_df.Rd b/man/xml_nodeset_to_df.Rd index 2dfa9bcd..636b802c 100644 --- a/man/xml_nodeset_to_df.Rd +++ b/man/xml_nodeset_to_df.Rd @@ -10,7 +10,7 @@ xml_nodeset_to_df(this_node) \item{this_node}{\code{xml_node}; to be parsed out} } \value{ -\code{data.frame} parsed from the supplied xml +\code{tbl_df} parsed from the supplied XML } \description{ A function specifically for parsing an XML node into a \code{data.frame} From 970bde9b5eafcbd286c197f9045dd0687a25ee0e Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 20:00:16 -0500 Subject: [PATCH 37/42] Fix bug with formatting an object of class AsIs --- R/utils-datatypes.R | 14 +++++++++++--- man/sf_format_date.Rd | 5 +++-- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/R/utils-datatypes.R b/R/utils-datatypes.R index 45599234..243a5535 100644 --- a/R/utils-datatypes.R +++ b/R/utils-datatypes.R @@ -15,8 +15,9 @@ sf_format_datetime <- function(x){ #' Format Dates for Create and Update operations #' #' @param x a value representing a datetime -#' @return \code{character}; a date string with the time set to midnight and then -#' formatted in ISO8601 per the requirements of the Salesforce APIs. +#' @return \code{character}; a date string with the time set to midnight in the +#' user's system timezone and then formatted in ISO8601 per the requirements of +#' the Salesforce APIs. #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal @@ -126,5 +127,12 @@ sf_format_time.NULL <- function(x){ #' @keywords internal sf_format_time.AsIs <- function(x){ - x + if("AsIs" %in% class(x)){ + if(length(class(x)[-match("AsIs", class(x))]) == 0){ + x <- unclass(x) + } else { + class(x) <- class(x)[-match("AsIs", class(x))] + } + } + sf_format_time(x) } diff --git a/man/sf_format_date.Rd b/man/sf_format_date.Rd index 13127508..c5570ee6 100644 --- a/man/sf_format_date.Rd +++ b/man/sf_format_date.Rd @@ -10,8 +10,9 @@ sf_format_date(x) \item{x}{a value representing a datetime} } \value{ -\code{character}; a date string with the time set to midnight and then -formatted in ISO8601 per the requirements of the Salesforce APIs. +\code{character}; a date string with the time set to midnight in the +user's system timezone and then formatted in ISO8601 per the requirements of +the Salesforce APIs. } \description{ Format Dates for Create and Update operations From 7b1ca4c7ce3e3f2adfc915eb24c27029074ce66b Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 21:57:22 -0500 Subject: [PATCH 38/42] Export the S3 methods for sf_format_time --- NAMESPACE | 20 ++++++++ R/utils-datatypes.R | 79 +++++++++++++++++--------------- man/sf_format_datetime.Rd | 8 ++-- man/sf_format_time.Rd | 37 ++++++++++++++- man/sf_format_time.data.frame.Rd | 26 ----------- man/sf_format_time.list.Rd | 26 ----------- 6 files changed, 102 insertions(+), 94 deletions(-) delete mode 100644 man/sf_format_time.data.frame.Rd delete mode 100644 man/sf_format_time.list.Rd diff --git a/NAMESPACE b/NAMESPACE index fda390c6..3f71d10d 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -1,7 +1,16 @@ # Generated by roxygen2: do not edit by hand +S3method(sf_format_time,"NULL") +S3method(sf_format_time,AsIs) +S3method(sf_format_time,Date) +S3method(sf_format_time,POSIXct) +S3method(sf_format_time,POSIXlt) +S3method(sf_format_time,POSIXt) +S3method(sf_format_time,character) S3method(sf_format_time,data.frame) S3method(sf_format_time,list) +S3method(sf_format_time,logical) +S3method(sf_format_time,numeric) export(VERB_n) export(accepted_controls_by_api) export(accepted_controls_by_operation) @@ -180,6 +189,17 @@ export(sf_find_duplicates_by_id) export(sf_format_date) export(sf_format_datetime) export(sf_format_time) +export(sf_format_time.AsIs) +export(sf_format_time.Date) +export(sf_format_time.NULL) +export(sf_format_time.POSIXct) +export(sf_format_time.POSIXlt) +export(sf_format_time.POSIXt) +export(sf_format_time.character) +export(sf_format_time.data.frame) +export(sf_format_time.list) +export(sf_format_time.logical) +export(sf_format_time.numeric) export(sf_get_all_jobs_bulk) export(sf_get_all_query_jobs_bulk) export(sf_get_dashboard_data) diff --git a/R/utils-datatypes.R b/R/utils-datatypes.R index 243a5535..8ed62e8d 100644 --- a/R/utils-datatypes.R +++ b/R/utils-datatypes.R @@ -1,9 +1,11 @@ #' Format Datetimes for Create and Update operations #' #' @importFrom lubridate as_datetime -#' @param x a value representing a datetime -#' @return \code{character}; a datetime string formatted in ISO8601 per the -#' requirements of the Salesforce APIs. +#' @param x an object, potentially, representing a datetime that should be converted +#' to the Salesforce standard. +#' @return \code{character}; an object where any values that appear to be a date +#' or date time are reformatted as an ISO8601 string per the requirements of the +#' Salesforce APIs. #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal @@ -27,7 +29,7 @@ sf_format_date <- function(x){ sf_format_datetime(x) } -#' Format all Date and Datetime columns in a list +#' Format all Date and Datetime values in an object #' #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date @@ -38,22 +40,16 @@ sf_format_date <- function(x){ #' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} #' @note This function is meant to be used internally. Only use when debugging. #' @keywords internal +#' @rdname sf_format_time #' @export sf_format_time <- function (x, ...) { UseMethod("sf_format_time", x) } -#' Format all Date and Datetime columns in a list -#' #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date -#' @param x \code{list}; a list object which may or may not have values -#' that represent a datetime. If so, they are cast to the ISO8601 standard per -#' the requirements of Salesforce APIs. -#' @return \code{list}; the same list object with datetime values formatted. -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} -#' @note This function is meant to be used internally. Only use when debugging. -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.list #' @export sf_format_time.list <- function(x){ lapply(x, FUN=function(xx){ @@ -65,17 +61,10 @@ sf_format_time.list <- function(x){ }) } -#' Format all Date and Datetime columns in a dataset -#' #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date -#' @param x \code{tbl_df}; a data frame object which may or may not have columns -#' that represent a datetime. If so, they are cast to the ISO8601 standard per -#' the requirements of Salesforce APIs. -#' @return \code{tbl_df}; the same data frame object with datetime values formatted. -#' @seealso \url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} -#' @note This function is meant to be used internally. Only use when debugging. -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.data.frame #' @export sf_format_time.data.frame <- function(x){ x %>% @@ -85,54 +74,70 @@ sf_format_time.data.frame <- function(x){ mutate_if(is.Date, sf_format_date) } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.Date +#' @export sf_format_time.Date <- function(x){ sf_format_date(x) } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.POSIXct +#' @export sf_format_time.POSIXct <- function(x){ sf_format_datetime(x) } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.POSIXlt +#' @export sf_format_time.POSIXlt <- function(x){ sf_format_datetime(x) } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.POSIXt +#' @export sf_format_time.POSIXt <- function(x){ sf_format_datetime(x) } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.character +#' @export sf_format_time.character <- function(x){ x } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.numeric +#' @export sf_format_time.numeric <- function(x){ x } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.logical +#' @export sf_format_time.logical <- function(x){ x } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.NULL +#' @export sf_format_time.NULL <- function(x){ x } -#' @keywords internal +#' @rdname sf_format_time +#' @export sf_format_time.AsIs +#' @export sf_format_time.AsIs <- function(x){ - if("AsIs" %in% class(x)){ - if(length(class(x)[-match("AsIs", class(x))]) == 0){ - x <- unclass(x) - } else { - class(x) <- class(x)[-match("AsIs", class(x))] - } + if(length(class(x)[-match("AsIs", class(x))]) == 0){ + class(x) <- NULL + } else { + class(x) <- class(x)[-match("AsIs", class(x))] } sf_format_time(x) } diff --git a/man/sf_format_datetime.Rd b/man/sf_format_datetime.Rd index f7506163..011e40ba 100644 --- a/man/sf_format_datetime.Rd +++ b/man/sf_format_datetime.Rd @@ -7,11 +7,13 @@ sf_format_datetime(x) } \arguments{ -\item{x}{a value representing a datetime} +\item{x}{an object, potentially, representing a datetime that should be converted +to the Salesforce standard.} } \value{ -\code{character}; a datetime string formatted in ISO8601 per the -requirements of the Salesforce APIs. +\code{character}; an object where any values that appear to be a date +or date time are reformatted as an ISO8601 string per the requirements of the +Salesforce APIs. } \description{ Format Datetimes for Create and Update operations diff --git a/man/sf_format_time.Rd b/man/sf_format_time.Rd index 5e599617..88257f38 100644 --- a/man/sf_format_time.Rd +++ b/man/sf_format_time.Rd @@ -2,9 +2,42 @@ % Please edit documentation in R/utils-datatypes.R \name{sf_format_time} \alias{sf_format_time} -\title{Format all Date and Datetime columns in a list} +\alias{sf_format_time.list} +\alias{sf_format_time.data.frame} +\alias{sf_format_time.Date} +\alias{sf_format_time.POSIXct} +\alias{sf_format_time.POSIXlt} +\alias{sf_format_time.POSIXt} +\alias{sf_format_time.character} +\alias{sf_format_time.numeric} +\alias{sf_format_time.logical} +\alias{sf_format_time.NULL} +\alias{sf_format_time.AsIs} +\title{Format all Date and Datetime values in an object} \usage{ sf_format_time(x, ...) + +\method{sf_format_time}{list}(x) + +\method{sf_format_time}{data.frame}(x) + +\method{sf_format_time}{Date}(x) + +\method{sf_format_time}{POSIXct}(x) + +\method{sf_format_time}{POSIXlt}(x) + +\method{sf_format_time}{POSIXt}(x) + +\method{sf_format_time}{character}(x) + +\method{sf_format_time}{numeric}(x) + +\method{sf_format_time}{logical}(x) + +\method{sf_format_time}{`NULL`}(x) + +\method{sf_format_time}{AsIs}(x) } \arguments{ \item{x}{data which may or may not have values, elements, columns that @@ -15,7 +48,7 @@ per the requirements of Salesforce APIs.} the same data object with datetime values formatted. } \description{ -Format all Date and Datetime columns in a list +Format all Date and Datetime values in an object } \note{ This function is meant to be used internally. Only use when debugging. diff --git a/man/sf_format_time.data.frame.Rd b/man/sf_format_time.data.frame.Rd deleted file mode 100644 index a3b0d0c9..00000000 --- a/man/sf_format_time.data.frame.Rd +++ /dev/null @@ -1,26 +0,0 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/utils-datatypes.R -\name{sf_format_time.data.frame} -\alias{sf_format_time.data.frame} -\title{Format all Date and Datetime columns in a dataset} -\usage{ -\method{sf_format_time}{data.frame}(x) -} -\arguments{ -\item{x}{\code{tbl_df}; a data frame object which may or may not have columns -that represent a datetime. If so, they are cast to the ISO8601 standard per -the requirements of Salesforce APIs.} -} -\value{ -\code{tbl_df}; the same data frame object with datetime values formatted. -} -\description{ -Format all Date and Datetime columns in a dataset -} -\note{ -This function is meant to be used internally. Only use when debugging. -} -\seealso{ -\url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} -} -\keyword{internal} diff --git a/man/sf_format_time.list.Rd b/man/sf_format_time.list.Rd deleted file mode 100644 index e4d810a8..00000000 --- a/man/sf_format_time.list.Rd +++ /dev/null @@ -1,26 +0,0 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/utils-datatypes.R -\name{sf_format_time.list} -\alias{sf_format_time.list} -\title{Format all Date and Datetime columns in a list} -\usage{ -\method{sf_format_time}{list}(x) -} -\arguments{ -\item{x}{\code{list}; a list object which may or may not have values -that represent a datetime. If so, they are cast to the ISO8601 standard per -the requirements of Salesforce APIs.} -} -\value{ -\code{list}; the same list object with datetime values formatted. -} -\description{ -Format all Date and Datetime columns in a list -} -\note{ -This function is meant to be used internally. Only use when debugging. -} -\seealso{ -\url{https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_date_format.htm} -} -\keyword{internal} From 5b9dd6092e0f7db401d775e63abbc215370576ec Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 23:01:35 -0500 Subject: [PATCH 39/42] Update wordlist for new documentation changes --- inst/WORDLIST | 2 ++ 1 file changed, 2 insertions(+) diff --git a/inst/WORDLIST b/inst/WORDLIST index b88cd6de..983ffcfb 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -1524,6 +1524,8 @@ ReputationPointsRules RequestFeedback Requeue requiredField +REST +RESTful resultset ResumeFlow retrieveMetadata From 141cdb9151fb32aa6743a1de7630817092bf6642 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 23:02:02 -0500 Subject: [PATCH 40/42] Fix deprecated argument badge --- R/utils.R | 2 +- man/sf_write_csv.Rd | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/R/utils.R b/R/utils.R index 537120d6..9c519a99 100644 --- a/R/utils.R +++ b/R/utils.R @@ -93,7 +93,7 @@ merge_null_to_na <- function(x){ #' @importFrom readr write_csv #' @param x \code{tbl_df}; a data frame object to save as a CSV #' @param file A file or connection to write to. -#' @param path \Sexpr[results=rd, stage=render]{lifecycle::badge("deprecated")}, +#' @param path `r lifecycle::badge("deprecated")` #' use the `file` argument instead. #' @return the input \code{x} invisibly. This function is called for its #' side-effect of creating a CSV file at the specified location using the format diff --git a/man/sf_write_csv.Rd b/man/sf_write_csv.Rd index 62d2dac5..392573a2 100644 --- a/man/sf_write_csv.Rd +++ b/man/sf_write_csv.Rd @@ -11,7 +11,7 @@ sf_write_csv(x, file, path = deprecated()) \item{file}{A file or connection to write to.} -\item{path}{\Sexpr[results=rd, stage=render]{lifecycle::badge("deprecated")}, +\item{path}{\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#deprecated}{\figure{lifecycle-deprecated.svg}{options: alt='[Deprecated]'}}}{\strong{[Deprecated]}} use the \code{file} argument instead.} } \value{ From 751626388b7a3613427f4ece2e59a4789a96da99 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Mon, 5 Jul 2021 23:18:51 -0500 Subject: [PATCH 41/42] Make S3 method arguments consistent --- NAMESPACE | 11 ----------- R/utils-datatypes.R | 13 +------------ man/sf_format_time.Rd | 2 +- 3 files changed, 2 insertions(+), 24 deletions(-) diff --git a/NAMESPACE b/NAMESPACE index 3f71d10d..1c22e0ef 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -189,17 +189,6 @@ export(sf_find_duplicates_by_id) export(sf_format_date) export(sf_format_datetime) export(sf_format_time) -export(sf_format_time.AsIs) -export(sf_format_time.Date) -export(sf_format_time.NULL) -export(sf_format_time.POSIXct) -export(sf_format_time.POSIXlt) -export(sf_format_time.POSIXt) -export(sf_format_time.character) -export(sf_format_time.data.frame) -export(sf_format_time.list) -export(sf_format_time.logical) -export(sf_format_time.numeric) export(sf_get_all_jobs_bulk) export(sf_get_all_query_jobs_bulk) export(sf_get_dashboard_data) diff --git a/R/utils-datatypes.R b/R/utils-datatypes.R index 8ed62e8d..da20bf29 100644 --- a/R/utils-datatypes.R +++ b/R/utils-datatypes.R @@ -42,14 +42,13 @@ sf_format_date <- function(x){ #' @keywords internal #' @rdname sf_format_time #' @export -sf_format_time <- function (x, ...) { +sf_format_time <- function (x) { UseMethod("sf_format_time", x) } #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date #' @rdname sf_format_time -#' @export sf_format_time.list #' @export sf_format_time.list <- function(x){ lapply(x, FUN=function(xx){ @@ -64,7 +63,6 @@ sf_format_time.list <- function(x){ #' @importFrom dplyr mutate_if #' @importFrom lubridate is.POSIXct is.POSIXlt is.POSIXt is.Date #' @rdname sf_format_time -#' @export sf_format_time.data.frame #' @export sf_format_time.data.frame <- function(x){ x %>% @@ -75,63 +73,54 @@ sf_format_time.data.frame <- function(x){ } #' @rdname sf_format_time -#' @export sf_format_time.Date #' @export sf_format_time.Date <- function(x){ sf_format_date(x) } #' @rdname sf_format_time -#' @export sf_format_time.POSIXct #' @export sf_format_time.POSIXct <- function(x){ sf_format_datetime(x) } #' @rdname sf_format_time -#' @export sf_format_time.POSIXlt #' @export sf_format_time.POSIXlt <- function(x){ sf_format_datetime(x) } #' @rdname sf_format_time -#' @export sf_format_time.POSIXt #' @export sf_format_time.POSIXt <- function(x){ sf_format_datetime(x) } #' @rdname sf_format_time -#' @export sf_format_time.character #' @export sf_format_time.character <- function(x){ x } #' @rdname sf_format_time -#' @export sf_format_time.numeric #' @export sf_format_time.numeric <- function(x){ x } #' @rdname sf_format_time -#' @export sf_format_time.logical #' @export sf_format_time.logical <- function(x){ x } #' @rdname sf_format_time -#' @export sf_format_time.NULL #' @export sf_format_time.NULL <- function(x){ x } #' @rdname sf_format_time -#' @export sf_format_time.AsIs #' @export sf_format_time.AsIs <- function(x){ if(length(class(x)[-match("AsIs", class(x))]) == 0){ diff --git a/man/sf_format_time.Rd b/man/sf_format_time.Rd index 88257f38..11a7dd69 100644 --- a/man/sf_format_time.Rd +++ b/man/sf_format_time.Rd @@ -15,7 +15,7 @@ \alias{sf_format_time.AsIs} \title{Format all Date and Datetime values in an object} \usage{ -sf_format_time(x, ...) +sf_format_time(x) \method{sf_format_time}{list}(x) From c14b2be6fe157c5913c46d87006a8040ba75d0d5 Mon Sep 17 00:00:00 2001 From: "Steven M. Mortimer" Date: Tue, 6 Jul 2021 22:09:06 -0500 Subject: [PATCH 42/42] Update NEWS.md with release tag link --- NEWS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/NEWS.md b/NEWS.md index 02856b6d..c5659896 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,4 +1,4 @@ -## salesforcer 1.0.0 +## salesforcer 1.0.0 [release](https://github.com/StevenMMortimer/salesforcer/releases/tag/v1.0.0) ### Dependencies