IRPCTaskPaneConfigurations.SaveTaskPaneConfiguration
Vault API / standard write session idempotent returns metadata structure version
Saves the calling user's task pane configuration.
| Service | Task pane configurations MFiles.IRPCTaskPaneConfigurations |
|---|---|
| gRPC method | /MFiles.IRPCTaskPaneConfigurations/SaveTaskPaneConfiguration |
| HTTP (mf-http-grpc) | POST /grpc/v1/save-task-pane-configuration |
| Request | SaveTaskPaneConfigurationRequest |
| Response | SaveTaskPaneConfigurationResponse |
| Book and level | Vault API, standard |
| Kind | write |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | yes (in the mfiles-metadata-version-bin trailer) |
| Streaming | none (unary) |
Remarks
- Requires a vault session. No special vault rights are needed.
- The first four bytes of
data_must bedata_versionas a 32-bit little-endian integer, or the call fails with "The parameter is incorrect.". An emptydata_stores the program defaults. - Saving deletes the caller's stored configurations of newer data versions.
Request: SaveTaskPaneConfigurationRequest
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
data_version | int32 | The data version of the blob. |
data_ | bytes | The configuration blob, starting with data_version as a 32-bit little-endian integer. |
Response: SaveTaskPaneConfigurationResponse
No fields.