Skip to main content
This gem runs in .

Overview

Use a Source and Target gem to read from or write to Smartsheet locations in Prophecy pipelines. This page covers supported file formats, how to create the gem, and how to configure connection details and paths for both Source and Target gems.

Supported file formats

FormatReadWrite
XLSX

Create a Smartsheet gem

To create a Smartsheet Source or Target gem in your pipeline:
1

Add a Source or Target gem to the pipeline

  1. Open your pipeline in the Studio.
  2. Click on Source/Target in the canvas.
  3. Select Source or Target from the dropdown.
  4. Click on the gem to open the configuration.
2

Select Smartsheet format

In the Type tab, select Smartsheet. Then, click Next.
3

Set location details

In the Location tab, set your file format and connection details. To learn more, jump to Location.
4

Set file properties

In the Properties tab, set the file properties. See Excel to view XLSX-specific properties.
5

Preview data (Source only)

In the Preview tab, load a sample of the data and verify that it looks correct.

Source location

ParameterDescription
Select or create connectionSelect an existing Smartsheet connection or create a new one.
File PathPath to the file in Smartsheet.
Example: /Projects/ProjectName/file.csv
ExamineClick Examine to automatically determine the file format and compression type (if any).
Format typeType of file to read, such as csv or json.
CompressionThe compression type of the file to read.

Supported types: uncompressed,gzip, zstd, lz4, zlib, snappy, lzop

Target location

ParameterDescription
Select or create connectionSelect an existing Smartsheet connection or create a new one.
File PathPath to the file in Smartsheet.
Example: /Projects/ProjectName/file.csv
ExamineIf an existing file exists at the target path, click Examine to automatically determine the file format and compression type (if any).
Encryption AlgorithmThe encryption algorithm to use when writing the file.

Supported algorithms: AES-192, AES-296, BlowFish
Format typeType of file to write, such as csv or json.
CompressionThe compression type to use when writing the file.

Supported types: uncompressed,gzip, zstd, lz4, zlib, snappy, lzop
Configure encryption in a Target gem to encrypt an entire file. Use the DataEncoderDecoder gem to encrypt individual columns.