Downloading Gmail Attachments in SSIS is always a little more difficult than working with simple text or numeric columns. If you are not an SSIS expert, doing it for the first time may be challenging. That is why we created this article for you. This is a common request we receive, so we are bringing this article to you.

Gmail is the most popular email service in the world, and it can be helpful to automate and get valuable information from it. We will connect to Gmail with the REST API. For that, if you are not an experienced user of the REST API, do not worry. This article is for you. We will provide simple steps for the connection.

Requirements

To do it, we will need the following components:

1. SSDT for SSIS must be installed on your computer
2. ZappySys SSIS Powerpack should be installed. This Powerpack Plugin includes connectors to Gmail via the REST API.

Getting Started

Creating the connection

1. First of all, in SSDT, create a new SSIS project
2. To create a connection in SSDT, open the Connection Manager and select New Connection.
   

   Create a new connection

3. Select the ZS OAuth connection. This is a special connection included with the ZS.
   SSIS PowerPack installer that we will use to connect to Gmail.
   

   Select ZS-OAuth connector
4. In the ZS OAuth connection, select the Google API OAuth Provider and specify the following credentials and scope permissions:
   

   SSIS Gmail connection

   https://mail.google.com/
   https://www.googleapis.com/auth/gmail.modify
   https://www.googleapis.com/auth/gmail.readonly
   https://www.googleapis.com/auth/gmail.addons.current.message.readonly
   https://www.googleapis.com/auth/gmail.addons.current.message.action

Creating the package to download Gmail attachments in SSIS

1. First of all, drag and drop the Data Flow Task from the SSIS Toolbox and double-click it
   to edit.
   

   Drag and Drop SSIS Data Flow Task from SSIS Toolbox

2. Secondly, in the Data Flow, we will use the JSON Source to connect to Gmail and get the attachments. JSON Source is a ZappySys component used now only to connect to JSON files, but also to connect to REST API Servers that support JSON. In this case, Gmail REST API can send information in JSON Format. Use the connection created before.
3. Basically, we need to specify the URL of the Gmail attachment. In Gmail, the email attachment is inside the message. Then you need to specify the message-id and the Gmail attachment-id like this:
   

   Zappysys JSON source Gmail attachments configuration

   https://www.googleapis.com/gmail/v1/users/me/messages/{{User::email_id}}/attachments/{{User::attachment_id}}

4. Now, in the go-to columns tab, set the data type to DT_IMAGE and increase the length of the other columns’ DT_WSTR fields by 1000 and 1500. We set

   contentBytes

   to the

   DT_IMAGE

     datatype, it’s like

   varbinary(MAX)

   

   JSON Source Columns Tab – attachment datatype

5. Next, we will use the derived column to set the path to the local folder where the attachment will be stored. The derived column will be used to set the local path for the attachment. Make sure to specify valid paths with double backslashes, since backslashes are special characters. The derived column is a special transformation component that creates new columns. SSIS expressions.
   

   Derived columns – Gmail attachment file path

6. Also, we will require the Export column to download into a file. This component is specially used to get images or binary files into the file system.
   

   Export columns transformation – Gmail attachment

7. Finally, we will use the Trash destination to get the attachment and finish the flow. This one is also a ZappySys component ubiquitous.
8. Your package should be something like this:
   

   Final Result – Gmail attachment

9. The next step is to run it and test it.
10. If everything is fine, we will be able to see the file in your system.

Conclusion

In conclusion, we learned how to download Gmail attachments in SSIS. Basically, you need to use the ZappySys JSON Source to connect to Gmail via the REST API, then use the derived column component to specify the path to store the attachment. The next step is to use the Export column component to export the attachment. Finally, the ZS Trash destination is the attachment’s destination. If you liked this article, do not hesitate to continue testing and using ZappySys PowerPack for SSIS.

API Connector

Here are a few examples with our API connector for Gmail

API connector – Gmail get message attachments

API connector – Gmail download message attachments

The post Download Gmail Attachment in SSIS appeared first on ZappySys Blog.

Download Salesforce Attachment in SSIS can be difficult the first time. In this new article, we will show how to download an Attachment from the Salesforce Source into a file using SSIS. Working with images is always tricky the first time. However, with the right article, this process is really simple. This article will show you how simple it is to do it.

Salesforce is an extremely powerful CRM based in the cloud. This company was created in California, San Francisco and it is a very common request to get the information from the cloud into a file automatically. These can be achieved with our ZappySys SSIS PowerPack plus some SSIS tasks.

Requirements

In order to do it, we will need the following components:

1. SSDT for SSIS installed
2. ZappySys SSIS Powerpack installed
3. A connection to Salesforce. In order to create a connection to Salesforce, check this video or check our article related.
4. Finally, we will need a file in Salesforce to download.

Getting Started

Creating the connection

1. First of all, in SSDT, create a new SSIS project
2. In order to create a connection in SSDT, go to the connection manager, and select a new connection.
   

   ssis-create-salesforce-connection

3. Also, Select the ZS Salesforce connection. This new connection is created by the ZS SSIS PowerPack plugin mentioned in the requirements. With this connection, we can easily connect to Salesforce and get the Information.
   

   Select SSIS Salesforce connection

4. Finally, write your email, password, and token. For more information about getting the token, please check our article related.
   

   Salesforce credentials in SSIS

Creating the package

1. First of All, Drag and drop the Data Flow Task from SSIS Toolbox and double-click it to edit.
   

   Drag and Drop : Data Flow Task from SSIS Toolbox

2. Secondly, in the Data Flow, we will use the Salesforce Source to connect to Salesforce and get the attachments.
   

   Drag and Drop: Salesforce Source from SSIS Toolbox

3. For this purpose, we will use the attachment table from Salesforce.
4. In addition, we will get the columns from the table. The image is in the body, however, we have additional columns like the id, name, ContenType, BodyLenght, createDate, and more:
   

   SSIS Salesforce Columns

5. Next, we will need to drag and drop SSIS Derived Column from the SSIS Toolbox below the Salesforce Source and connect it.
   

   Drag and drop the Derived Column

6. Double-click on the derived column, to specify the path to store the image in a local folder.
   

   SSIS-derived column download image salesforce

7. Now let’s, drag and drop SSIS Export Column from the SSIS Toolbox >> Other Transforms.
   

   Drag and drop Export Column

8. Double-click on the Export column to download an image of the body. In the Extract Column map the Body column of File data and the Path Column to where you want to save that file.
   

   SSIS export column salesforce image

9. Finally, we will use the trash destination to get the image and finish the flow.
   

   SSIS Trash destination

10. Now, we are ready. Your package should be something like this:
    

    ssis-full-download-package

11. Run the package to test it.
12. If everything is fine, we will be able to see the file. As you can see Downloading Salesforce Attachment in SSIS is a straightforward process.

Conclusion

In conclusion, we learned in this article how to Download Salesforce Attachment in SSIS. Basically, you need to use the ZappySys salesforce source, then use the derived column to specify the path and the Export column to get the image. Finally, the ZS Trash destination will be used  If you liked this article, do not hesitate to continue testing and using ZappySys PowerPack for SSIS.

The post Download Salesforce Attachment in SSIS appeared first on ZappySys Blog.