Update Group
Operation name
Update Group
Function overview
Updates the group of Box specified in the input data.
For details on API specifications used by this component, refer to the Box API reference at the following URL:
-
https://developer.box.com/reference/put-groups-id/
Data model
The data model of this component is table model type.
Properties
For details on use of variables, refer to Variables.
Basic settings
Item name |
Required/Optional |
Use of variables |
Description |
Remarks |
---|---|---|---|---|
Name |
Required |
Not available |
Enter a name that is used on the script canvas. |
|
Input data |
Required |
Not available |
Select a component on the script canvas. |
|
Required settings
Item name |
Required/Optional |
Use of variables |
Description |
Remarks |
---|---|---|---|---|
Destination |
Required |
Not available |
Select a connection resource.
|
|
Comment
Item name |
Required/Optional |
Use of variables |
Description |
Remarks |
---|---|---|---|---|
Comment |
Optional |
Not available |
You can write a short description of this connector. |
|
Schemas
Input schema
<?xml version="1.0" encoding="UTF-8" ?> <table> <row> <column>name</column> <column>new_name</column> <column>provenance</column> <column>external_sync_identifier</column> <column>description</column> <column>invitability_level</column> <column>member_viewability_level</column> </row> <row> : </row> </table>
Element name |
Label |
Description |
Required/Optional |
Remarks |
---|---|---|---|---|
row |
|
Repeats for the number of groups to be updated. |
|
|
column |
name |
Enter the name of the group. |
Required |
|
new_name |
Enter the new group name. |
Optional |
Note
This name must be unique across the enterprise in Box. |
|
provenance |
Enter the name of an externally linked source. |
Optional |
Note
If a value is specified, the Box Admin will become unable to directly edit the group name and its members from the admin console. |
|
external_sync_identifier |
Enter the identifier of an externally linked source. |
Optional |
|
|
description |
Enter the description of the group. |
Optional |
|
|
invitability_level |
Enter the types of users who can set this group as a collaborator. |
Optional |
|
|
member_viewability_level |
|
Optional |
|
Output schema
<?xml version="1.0" encoding="UTF-8" ?> <table> <row> <column>result</column> <column>name</column> <column>status_code</column> <column>error_code</column> <column>message</column> <column>request_id</column> </row> <row> : </row> </table>
Element name |
Label |
Description |
Remarks |
---|---|---|---|
row |
|
Repeats for the number of input items that failed in the processing. |
|
column |
result |
When input is invalid, "skipped" is output. When request execution results in an error, "failed" is output. |
|
name |
name of the input item that failed in the processing is output. |
|
|
status_code |
If the result is "failed", an HTTP status code is output from Box. |
|
|
error_code |
If the result is "failed", an error code that identifies the error contents is output. |
|
|
message |
An error message is output. |
|
|
request_id |
If the result is "failed", the ID that uniquely distinguishes the request relative to Box is output. |
|
Loading schema in Mapper
The schema is loaded automatically.
For details, refer to Edit Schema.
Mass data processing
Mass data processing isn't supported.
Transaction
Transaction isn't supported.
Parallel Stream Processing
PSP isn't supported.
Available component variables
Component variable name |
Description |
Remarks |
---|---|---|
succeeded_count |
The number of input items that were processed successfully is stored. |
|
failed_count |
The number of input items that failed in the processing is stored. |
|
skipped_count |
The number of input items that were skipped in the processing is stored. |
|
message_category |
When an error occurs, the category of the message code corresponding to the error is stored. |
|
message_code |
When an error occurs, the code of the message code corresponding to the error is stored. |
|
message_level |
When an error occurs, the severity of the message code corresponding to the error is stored. |
|
error_type |
When an error occurs, the error type is stored. |
|
error_message |
When an error occurs, the error message is stored. |
|
error_trace |
When an error occurs, the trace information for the error is stored. |
|
Message codes, exception messages, and limitations
Connector |
Message code |
Exception message |
Limitations |
---|---|---|---|
Messages and limitations of the Box connector |