Description
The SORACOM File Upload component allows for sending files to SORACOM's Harvest.
Preliminary Setup on SORACOM's Side
Please assign the target SIM card to a SIM group in SORACOM's management console and enable Harvest Files in the settings.
※A SORACOM Air SIM card or SORACOM Arc is required to connect Gravio to the internet.
※For operations on SORACOM's management console, please contact SORACOM directly.
Input and Output Payload
| Input Payload | Description |
|---|---|
cv.Payload | When the input property is a payload, refer to the Harvest documentation for usable formats |
| Output Payload | Description |
|---|---|
cv.Payload | If the HTTP response's Content-Type header is "application/json", it is stored as JSON; if "text/*" and a charset (utf-8/shift_jis/euc-jp/iso-2022-jp) is specified, it is stored as a string; otherwise, it is stored as a byte array. |
Component Properties
| Property Name | Description |
|---|---|
| Input | Payload or file name |
| File Name | The file name to send when the input property is a file name |
| Content-Type | HTTP header's Content-Type |
| Harvest Folder Name | The folder name on Harvest where the file will be saved. If empty, it is saved in the root folder |
| Harvest File Name | The file name on Harvest where the file will be saved |
| Timeout | HTTP request response timeout value |
Component Variables
| Component Variable | Description |
|---|---|
| cv.Payload | Body of the response |
| cv.StatusCode | Result of the request |
| cv.Headers | Response headers |
| cv.ContentLength | Length of the response |
Placeholders Usable in Harvest Folder Name
The following placeholders can be used in the Harvest folder name:
| Placeholder | Description |
|---|---|
| :imsi: | The IMSI of the IoT SIM |
| :time: | The UNIX time (in milliseconds) when the file was sent |
For how to use these placeholders, refer to the following link.
https://users.soracom.io/en-us/docs/harvest/enable-files/