Add Generic Control to Pass Headers

Closes #4, Closes #5

DESCRIPTION

@@ -1,36 +1,37 @@
 Package: salesforcer
 Title: An Implementation of 'Salesforce' APIs Using Tidy Principles
 Version: 0.1.2.9000
-Date: 2018-04-12
-Description: An implementation of the 'Salesforce' Platform APIs (REST, SOAP, 
+Date: 2019-06-09
+Description: Functions connecting to the 'Salesforce' Platform APIs (REST, SOAP, 
     Bulk 1.0, Bulk 2.0, and Metadata) <https://developer.salesforce.com/page/Salesforce_APIs>. 
-    This package is an articulation of the most API methods into R. The API calls 
-    return XML or JSON that is parsed tidy data structures. For more details please 
-    see the 'Salesforces' API references and this package's website 
+    This package is an articulation of the most Salesforce API methods into R. The 
+    API calls return XML or JSON that is parsed tidy data structures. For more details 
+    please see the 'Salesforce' API references and this package's website 
     <https://stevenmmortimer.github.io/salesforcer/> for more information, 
     documentation, and examples.
 Authors@R: c(
     person(c("Steven", "M."), "Mortimer", , "reportmort@gmail.com", c("aut", "cre")),
     person("Takekatsu", "Hiramura", , "thira@plavox.info", c("ctb")),
-    person("Jennifer", "Bryan", , "jenny@rstudio.com", c("ctb")),
-    person("Joanna", "Zhao", , "joanna.zhao@alumni.ubc.ca", c("ctb"))
+    person("Jennifer", "Bryan", , "jenny@rstudio.com", c("ctb", "cph")),
+    person("Joanna", "Zhao", , "joanna.zhao@alumni.ubc.ca", c("ctb", "cph"))
     )
 URL: https://github.com/StevenMMortimer/salesforcer
 BugReports: https://github.com/StevenMMortimer/salesforcer/issues
 Encoding: UTF-8
 Depends:
-    R (>= 3.1.0)
+    R (>= 3.5.0)
 License: MIT + file LICENSE
 LazyData: true
 Imports:
-    methods,
-    httr,
-    dplyr,
-    xml2,
-    XML,
+    methods (>= 3.5.0),
+    XML (>= 3.98-1.19),
+    httr (>= 1.4.0),
+    dplyr (>= 0.8.0),
+    xml2 (>= 1.2.0),
+    readr (>= 1.3.1),
+    data.table (>= 1.12.0),
     jsonlite,
     purrr,
-    readr,
     lubridate
 Suggests:
     knitr,

NAMESPACE

@@ -1,9 +1,12 @@
 # Generated by roxygen2: do not edit by hand
 
 export(VERB_n)
+export(accepted_controls_by_api)
+export(accepted_controls_by_operation)
 export(build_soap_xml_from_list)
 export(catch_errors)
 export(collapse_list_with_dupe_names)
+export(filter_valid_controls)
 export(get_os)
 export(make_base_metadata_url)
 export(make_base_rest_url)
@@ -36,6 +39,7 @@ export(rPATCH)
 export(rPOST)
 export(rPUT)
 export(remove_empty_linked_object_cols)
+export(return_matching_controls)
 export(rforcecom.bulkAction)
 export(rforcecom.bulkQuery)
 export(rforcecom.create)
@@ -59,6 +63,7 @@ export(sf_batch_details_bulk)
 export(sf_batch_status_bulk)
 export(sf_bulk_operation)
 export(sf_close_job_bulk)
+export(sf_control)
 export(sf_create)
 export(sf_create_batches_bulk)
 export(sf_create_job_bulk)
@@ -121,6 +126,7 @@ importFrom(XML,xmlSApply)
 importFrom(XML,xmlSize)
 importFrom(XML,xmlToList)
 importFrom(XML,xmlValue)
+importFrom(data.table,rbindlist)
 importFrom(dplyr,"%>%")
 importFrom(dplyr,as_tibble)
 importFrom(dplyr,bind_rows)
@@ -162,6 +168,7 @@ importFrom(methods,as)
 importFrom(purrr,map)
 importFrom(purrr,map_df)
 importFrom(purrr,map_dfc)
+importFrom(purrr,modify)
 importFrom(purrr,modify_if)
 importFrom(readr,col_character)
 importFrom(readr,col_guess)

NEWS.md

@@ -2,6 +2,7 @@
 
 ### Features
 
+  * Upgraded to version 46.0 (Summer '19) from version 45.0 (Spring '19)
   * Add **RForcecom** backward compatibile version of `rforcecom.getObjectDescription()`
   * Add `sf_describe_object_fields()` which is a tidyier version of `rforcecom.getObjectDescription()`
   * Allow users to control whether query results are kept as all character or the 
@@ -11,6 +12,14 @@
   * Add new utility functions `sf_set_password()` and `sf_reset_password()` (#11)
   * Add two new functions to check for duplicates (`sf_find_duplicates()`, `sf_find_duplicates_by_id()`) (#4)
   * Add new function to download attachments to disk (`sf_download_attachment()`) (#20)
+  * The `object_name` argument, required for bulk queries, will be inferred if left blank, 
+  making it no longer a required argument
+  * Almost all functions in the package now have a `control` argument and dots (`...`) which 
+  allows for more than a dozen different control parameters listed in `sf_control()` to be 
+  fed into existing function calls to tweak the default behavior. For example, if you would 
+  like to override duplicate rules then you can adjust the `DuplicateRuleHeader`. If you 
+  would like to have certain assignment rule run on newly created records, then pass in the 
+  `AssignmentRuleHeader` (#4, #5)
 
 ### Bug Fixes
 
@@ -20,7 +29,16 @@
   since that only supported aborting Bulk 2.0 jobs (#13)
   * Fix bug that had only production environment logins possible because of hard 
   coding (@weckstm, #18)
-  * Make `sf_describe_object_fields()` more robust against nested list elements (#16)
+  * Make `sf_describe_object_fields()` more robust against nested list elements and 
+  also return picklists as tibbles (#16)
+  * Fix bug where four of the bulk operation options (`content_type`, `concurrency_mode`, 
+  `line_ending`, and `column_delimiter`) where not being passed down from 
+  the top level generic functions like `sf_create()`, `sf_update()`, etc. However, 
+  `line_ending` has now been moved into the `sf_control` function so it is no longer 
+  explicitly listed for bulk operations as an argument. (@mitch-niche, #23)
+  * Ensure that for SOAP, REST, and Bulk 2.0 APIs the verbose argument prints out 
+  the XML or JSON along with the URL of the call so it can be replicated via cURL or 
+  some other programming language (#8)
 
 ---