Table of Contents

Search

  1. Preface
  2. Working with Transformations
  3. Aggregator Transformation
  4. Custom Transformation
  5. Custom Transformation Functions
  6. Data Masking Transformation
  7. Data Masking Examples
  8. Expression Transformation
  9. External Procedure Transformation
  10. Filter Transformation
  11. HTTP Transformation
  12. Identity Resolution Transformation
  13. Java Transformation
  14. Java Transformation API Reference
  15. Java Expressions
  16. Java Transformation Example
  17. Joiner Transformation
  18. Lookup Transformation
  19. Lookup Caches
  20. Dynamic Lookup Cache
  21. Normalizer Transformation
  22. Rank Transformation
  23. Router Transformation
  24. Sequence Generator Transformation
  25. Sorter Transformation
  26. Source Qualifier Transformation
  27. SQL Transformation
  28. Using the SQL Transformation in a Mapping
  29. Stored Procedure Transformation
  30. Transaction Control Transformation
  31. Union Transformation
  32. Unstructured Data Transformation
  33. Update Strategy Transformation
  34. XML Transformations

Transformation Guide

Transformation Guide

Set Data Function (Array-Based Mode)

Set Data Function (Array-Based Mode)

Use the set data function when you want the procedure to pass a value to an output port. You can set the data, the length of the data, if applicable, and the indicator for the output port you specify. You do not use separate functions to set the length or indicator for the output port.
Use the following syntax:
void INFA_CTASetData( INFA_CT_OUTPUTPORT_HANDLE outputport, INFA_INT32 iRow, void* pData, INFA_UINT32 nLength, INFA_INDICATOR indicator);
The following table describes the arguments for this function:
Argument
Datatype
Input/
Output
Description
outputport
INFA_CT_OUTPUTPORT_HANDLE
Input
Output port handle.
iRow
INFA_INT32
Input
Index number of the row in the block. The index is zero-based.
You must verify the procedure only passes an index number that exists in the data block. If you pass an invalid value, the Integration Service shuts down unexpectedly.
pData
void*
Input
Pointer to the data.
nLength
INFA_UINT32
Input
Length of the port. Use for string and binary ports only.
You must verify the function passes the correct length of the data. If the function passes a different length, the output notification function returns failure for this port.
Verify the length you set for string and binary ports is not greater than the precision for the port. If you set the length greater than the port precision, you get unexpected results. For example, the session may fail.
indicator
INFA_INDICATOR
Input
Indicator value for the output port. Use one of the following values:
  • INFA_DATA_VALID. Indicates the data is valid.
  • INFA_NULL_DATA. Indicates a null value.
  • INFA_DATA_TRUNCATED. Indicates the data has been truncated.

0 COMMENTS

We’d like to hear from you!