Form Updates

AutomatR.GoogleForms.Activities.FormUpdates

The "Form Updates" activity in AutomatR is part of the Google Forms activities package, utilizing the Google Forms API to update an existing form with multiple operations. This activity facilitates batch updates to a Google Form, enhancing the customization and modification of form properties.

Properties

Name	Description
Input
Form ID	The unique identifier of the form to be updated. String variables containing the Form ID. This field is required.
Requests	The batch of update requests in JSON format. String variables containing the JSON representation of the update requests. This field is required.
Miscellaneous
Display Name	Provides a customizable name for the activity displayed in the workflow. The display name enhances clarity and organization within the automation project. String variables containing the desired display name.
Optional
Delay	Specifies the amount of time (in seconds) to wait before starting the activity. Useful for handling synchronization issues. Integer variables containing the delay duration. Example: If the amount of time is 1000 milliseconds or 1 sec, i.e., 1.
Output
Result	Returns the response as Form Details in an UpdatedFormObjectResult format. Variables of type UpdatedFormObjectResult to store the response.

How to use:

1. Drag and drop the "Form Updates" activity onto the workflow.
2. Configure the properties by specifying the form ID and providing the batch of update requests in JSON format.
3. Optionally, configure the delay before starting the activity.
4. Execute the workflow to apply the specified updates to the Google Form.

Example:

Consider an example where the "Form Updates" activity is used to update an existing Google Form with two operations: creating a new item at index 0 and updating the form description:

Form Updates:
  Form ID: "formId"
  Requests: "{
    \"includeFormInResponse\": false,
    \"requests\": [
      {
        \"createItem\": {
          \"item\": {
            \"description\": \"Hello TEST\",
            \"textItem\": {}
          },
          \"location\": {
            \"index\": 0
          }
        }
      },
      {
        \"updateFormProperties\": {
          \"properties\": {
            \"description\": \"Updated Form Description\"
          },
          \"fields\": \"description\"
        }
      }
    ]
  }"
  Delay: 2
  Result: formResponse

In this example, the activity updates the specified Google Form with the provided batch of update requests. The response is stored in the variable "formResponse" for further handling in the workflow.