Using the Google Directory Destination Component
The Google Directory Destination Component is an SSIS data flow pipeline component that can be used to write data to Google Directory services.
See Google Directory Connection Manager for how to connect to Google Directory and Google Directory Source Component for how to retrieve data from Google Directory.
There are three configuration pages:
- General
- Columns
- Error Handling
General Page
The General page allows you to specify general settings for the Google Directory Destination component.
- Connection Manager
-
The destination component requires a connection to Google Directory. The Connection Manager drop-down will show a list of all connection managers that are available to your current SSIS package.
- Destination Object
-
The Destination Object option allows you to specify which object to write data to. The Destination Object drop-down lists all available objects that you can write data to.
- Action
-
The Action option allows you to specify how data should be written to Google Directory.
Note: Supported actions may vary from object to object depending on Google Directory's API documentation.
- Batch Size
-
The Batch Size lets you specify how many records to send per service call to Google Directory.
- Refresh Component Button
-
Clicking the Refresh Component button causes the component to retrieve the latest metadata and update each field to its most recent metadata.
- Map Unmapped Fields Button
-
By clicking this button, the component will try to map any unmapped attributes by matching their names with the input columns from upstream components.
- Clear All Mappings Button
-
By clicking this button, the component will reset (clear) all your mappings in the destination component.
- Expression fx Icon
-
Click the blue fx icon to launch SSIS Expression Editor to enable dynamic updates of the property at run time.
- Generate Documentation Icon
-
Click the Generate Documentation icon to create a Word document that describes the component's metadata including relevant mapping, and so on.
Columns Page
The Columns page of the Google Directory Destination Component allows you to map the columns from upstream components to the Google Directory Fields. On this page, you can select the object whose columns you wish to configure in the top left drop-down.
On the Columns page, you would see a grid that contains four columns as shown below.
- Input Column: You can select an input column from an upstream component for the corresponding Destination Field.
- Destination Google Directory Field: The field that you are writing data to.
- Additional Field Details: An information icon will appear here if the column is special. Hover over the icon to see what makes the column special.
- Data Type: This column indicates the type of value for the current field.
- Unmap: This column can be used to unmap the field from the upstream input column, or otherwise it can be used to map the field to an upstream input column by matching its name if the field is not currently mapped.
Error Handling Page
The Error Handling page allows you to specify how errors should be handled when they happen.
There are three options available:
- Fail on error
- Redirect rows to error output
- Ignore error
On the Error Handling page, there is also an option that can be used to enable or disable the following output field for the destination component.
- NewlyCreatedRecordId: Contains the newly created Google directory object record's ID, which you can use to write to log or further process using additional data flow components.
