Dropbox Request node
Use the Dropbox Request node to connect to Dropbox and issue requests to retrieve files, folders, and paper docs, create, retrieve or revoke shared links, or download file content.
The Dropbox Request node is available on Windows, AIX®, and Linux® systems.
This topic contains the following sections:
Purpose
- Files
- Retrieve all files, download file contents.
- Folders
- Retrieve all folders.
- Paper docs
- Retrieve all paper docs.
The Dropbox Request node operations are synchronous and non-transactional, which means that, if a message flow fails and rolls back after the Dropbox Request node, the operation on the data source will still complete.
Using the Dropbox Request node in a message flow
For more information about the tasks that are involved in using the Dropbox Request node, see Using Dropbox with IBM App Connect Enterprise.
Terminals and properties
When you put an instance of the Dropbox Request node into a message flow, you can configure it. For more information, see Configuring a message flow node. The properties of the node are displayed in the Properties view. All mandatory properties for which you must enter a value (those without a default value) are marked with an asterisk.
The Dropbox Request node terminals are described in the following table.
Terminal | Description |
---|---|
In | The input terminal that accepts a message for processing by the node. The Dropbox Request node is driven by a message arriving on the In terminal. |
Out | The output terminal from which the message tree is propagated. The output message tree contains the object that is returned from the Dropbox connector. |
No Data | If the Dropbox connector is invoked successfully but the action returns no data (such as a retrieve action that found no records), the message is sent to the No Data terminal. |
Failure | If an error occurs in the Dropbox Request node, the message is sent to the Failure terminal. |
The following tables describe the node properties. The columns headed M indicate whether the property is mandatory (marked with an asterisk on the panel if you must enter a value when no default is defined); the columns headed C indicate whether the property is configurable (you can change the value when you add the message flow to the BAR file to deploy it).
Property | M | C | Default | Description |
---|---|---|---|---|
Node name | No | No | The node type, Dropbox Request | The name of the node. |
Short description | No | No | A brief description of the node. | |
Long description | No | No | Text that describes the purpose of the node in the message flow. |
Property | M | C | Default | Description |
---|---|---|---|---|
Action | Yes | No | This property shows the action to be performed by the Dropbox Request node. The action is defined through the Connector
Discovery wizard, and is then displayed in the Action property in read-only
format. Click Launch Connector Discovery to start the Connector Discovery wizard for the Dropbox connector, and define the action that you require. |
|
Object | Yes | No | This property shows the object on which the specified action is to be performed. The object is defined through the Connector Discovery wizard, and is then displayed in the Object property in read-only format. | |
Schema base name | Yes | No | The name of the schema files that describe the format of the request message
and response message that are sent and received from the Dropbox connector. The schema files can be used by a Mapping node to map the data values. You can open the schema by
clicking the Open request schema or Open response
schema buttons. A request schema is generated only if the selected action and object
require a request message. If the action that is selected is of type |
Property | M | C | Default | Description | mqsiapplybaroverride command property |
---|---|---|---|---|---|
Policy | Yes | Yes | This property specifies the name of the policy that contains the details of
the security identity that is used for the connection. The policy has a type of
DropBox and is defined in a policy project. |
policyUrl | |
Timeout (seconds) | No | Yes | 60 | This property specifies the time (in seconds) that the node waits for Dropbox to process the operation. The default is 60 seconds. | timeout |
The Dropbox Request node Request properties are described in the following table.
Property | M | C | Default | Description |
---|---|---|---|---|
Request mode | No | No | None | This property determines the message that is sent to the connector when the
selected action (specified during connector discovery) is performed. The Request
mode is set during connector discovery, by using the Connector Discovery wizard. If you
want to edit this property, start the Connector Discovery wizard by clicking Launch
Connector Discovery in the node property editor. This property can be set to either of
the following values:
|
Map inputs | No | No | The Map inputs table is used to define the input that
is available for use when building the message to be sent to the connector, and for defining the
filter values for operations that require a filter. The entries in the Map
inputs table describe specific parts of the message assembly and the schemas that define
them:
By default, the table contains data that describes a generic input message and the structured parts of the local environment tree. You can add an entry to the Map inputs table to specify the location of a message in the message assembly that is described by an associated JSON schema. If there is a preceding message flow node that defines the structure of a JSON message arriving on this node's input terminal, the schema is located and suggested as an option that you can use. For more information about using JSONata mapping, see Configuring mapping for discovery connector request nodes and JSONata mapping example. |
|
Data location | Yes | No | $Body | This property specifies the location in the incoming message tree from which
data is retrieved to form the request that is sent from the request node. The default value,
$Body, represents the incoming message body. You can enter any XPath or ESQL
expression that defines the location of the message tree to serialize and send. This property applies only when the Request mode property is set to Using Data location. |
Property | M | C | Default | Description |
---|---|---|---|---|
Result data location | Yes | No | $ResultRoot | This property specifies the message tree location to which the Dropbox Request node sends results. |
Output data location | Yes | No | $OutputRoot | This property specifies the message tree location to which the Dropbox Request node sends output. |
Copy local environment | No | No | Selected | This property controls whether to copy the incoming local environment or propagate the incoming local environment. By default, this check box is selected, which specifies that the local environment is copied so that the incoming local environment is preserved. The additions to the local environment are visible only to nodes downstream of this node. If this check box is cleared, the incoming local environment is used for the outgoing message. Any modifications that are made to the local environment by this node are visible to both downstream and upstream nodes after this node has completed. |
Property | M | C | Default | Description |
---|---|---|---|---|
Filter options | No | Yes | The Filter options section controls which objects are
to be operated upon when the Dropbox Request node executes.
The structure of the filter options is defined using the Connector Discovery wizard, but you can
modify the values that are used in the comparison by using the Edit button.
The property value can be either a text value or an ESQL or XPATH expression that is resolved from the contents of the message that is passed to the Dropbox Request node as it executes. |
|
Maximum number of items to retrieve | No | Yes | 15 | This property specifies the maximum number of items that can be retrieved from the Dropbox connector. |
Limit exceeded | No | Yes | This property specifies the action to be taken if the number of items that are
retrieved from the connector exceeds the specified maximum:
|
The Dropbox Request node Validation properties are described in the following table.
Property | M | C | Default | Description | mqsiapplybaroverride command property |
---|---|---|---|---|---|
Validate | No | Yes | Content and value | This property controls whether request messages are validated against the
request schema that is discovered during connector discovery, and is enabled by default. You can set
this property to one of the following values:
|
validateRequestMaster |
Failure action | No | No | Exception list | This property controls the action that is taken when a validation failure
occurs. You can set it to one of the following values:
|
|
Response validation options | No | No | Validation of the response message is not controlled by this node. The discovery connector builds the response message and produces a valid message that matches the schema. |
Property | M | C | Default | Description |
---|---|---|---|---|
Events | No | No | None | Events that you define for the node are displayed on this tab. By default, no
monitoring events are defined on any node in a message flow. Use Add,
Edit, and Delete to create, change, or delete
monitoring events for the node; see Configuring monitoring event sources by using monitoring properties for details. You can enable and disable events that are shown here by selecting or clearing the Enabled check box. |
Property | M | C | Default | Description |
---|---|---|---|---|
Message domain | Yes | No | JSON | The domain that is used to parse the response message. By default, the message that is propagated is in the JSON domain. You cannot specify a different domain. |
Message model | No | No | The name or location of the message model schema file in which the incoming message is defined. You cannot set this property. | |
Message | No | No | The name of the response message. The node detects the message type automatically; you cannot set this property. | |
Physical format | No | No | The name of the physical format of the response message. You cannot set this property. |