Write Data(Delete) (deprecated)

Operation Name

Write Data(Delete)

Function Overview

This operation is to delete data using the SOAP API delete() call.

 

You must specify each records ID to use delete().

However, with this component you may use a field other than ID as the key. In this case query() will be used to lookup the IDs based on the key.

 

You can retrieve the results of each record corresponding to the input data from the output schema.

 

= Remarks =

For details about the API specification used in this operation, refer to the API documentation of the selected version in the connection resource from the following link destination page.

  • "Salesforce Developer Documentation"-(https://developer.salesforce.com/docs)

    • SOAP API Developer's Guide

Data Model

The data model of this component is table model type.

Properties

= Remarks =

For details on use of variables, refer to Variables.

Basic Settings

Item name

Required/Optional

Use of Variables

Description

Remarks

Name

Required

Not Available

Enter a name that is used on the script canvas.

 

Input Data

Required

Not Available

Select a component on the script canvas.

 

Required Settings

Item name

Required/Optional

Use of Variables

Description

Remarks

Destination

Required

Not Available

Select a connection resource.

Add

A new connection resource can be added.

Edit list

Connection resource settings can be edited in > HULFT INTEGRATE > Connections.

 

Table Name

Required

Not Available

Select the name of a table in Salesforce.

 

Sort

Required

Not Available

Sorts the list of items by the selected method.

Check Ascending order
Check Descending order
Label Ascending order
Label Descending order
API Ascending order

(Default)

API Descending order
Type Ascending order
Type Descending order

 

Item list

Required

-

Displays the item list of the table on Salesforce selected in Table Name.

Only the items that can be added are displayed.

Item list/Check

Optional

Not Available

Select the checkboxes for the columns that you want to select as Schema definition.

 

Item list/Label

Required

Not Available

Displays the label name of the column of the table selected in Table Name.

 

Item list/API

Required

Not Available

Displays the API name of the column of the table selected in Table Name.

 

Item list/Type

Required

Not Available

Displays the data type of the column of the table selected in Table Name.

 

Schema definition

Required

-

Displays a list of columns for the table selected as the schema definition.

 

Schema definition/Label

Required

Not Available

Displays the label names of the columns for the table selected as the schema definition.

 

Schema definition/API

Required

Not Available

Displays the API names of the columns for the table selected as the schema definition.

 

Schema definition/Type

Required

Not Available

Displays the data types of the columns for the table selected as the schema definition.

 

Property actions

Item name

Description

Remarks

Select

Set items selected in the List item/Check column in Schema definition.

 

Option Settings

Item name

Required/Optional

Use of Variables

Description

Remarks

Column name type

Required

Not Available

Select the display type of the column name, for displaying the schema in mapping.

Label

The label name (item name) defined in Salesforce is displayed.

API

(Default)

The API reference name defined in Salesforce is displayed.

 

Batch size

Required

Available

Specify a batch size for performing the write data operation on Salesforce.

  • The default value is "200".

  • A number of 1 or greater, up to 200, can be set. An error occurs if any number outside of this range is set.

  • Depending on the operating environment, increasing the batch size generally helps improve the performance of the write data operation.

Note

According to the Salesforce connector specifications, if you set a batch size to 200 when writing 1,000 records, the write operation is performed in 5 installments.

Whether or not to get result per rows

Required

Not Available

Specify whether or not to obtain results, after writing to Salesforce.

Get

(Default)

Obtain the results of the write data operation.

Do Not Get

Do not obtain the results of the write data operation.

  • If Get is selected, items specified in the Schema and items showing results can be passed to the subsequent processing as data in Table Model type.

  • Please refer to "Schemas" about the obtained information.

Comment

Item name

Required/Optional

Use of Variables

Description

Remarks

Comment

Optional

Not Available

You can write a short description of this connector.

 

Schemas

Input Schema

The number of columns varies depending on the Schema definition settings.

= Remarks =

For schema structure, refer to Table model type .

Output Schema

Information regarding the results of deletion will appear in the column, set in the Schema definition.

(Hereafter shown as "Label/API")

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>Label/API set in the Schema definition</column>
       :
    <column>DeleteResult_ID/delete_result_id</column>
    <column>DeleteResult_SuccessFlag/delete_result_is_success</column>
    <column>DeleteResult_ErrorStatusCode/delete_result_error_status_code</column>
    <column>DeleteResult_ErrorMessage/delete_result_error_message</column>
    <column>DeleteResult_RowNumber/delete_result_row_number</column>
  </row>
  <row>
    :
  </row>
</table>

Element Name

Column Name(Label/API)

Description

Remarks

row

-

Repeats as many times as the number of data given to the input schema.

For example, if two data records are deleted by one input data record, this element would be repeated two times.

  • If Do Not Getis selected in Whether or not to get result per rows, the repetition will be 0 times.

Note

If mismatch data exist, such as that data types do not match, the order of input data and output data will not necessarily match. By specifying DeleteResult_RowNumber/delete_result_row_number as the order condition, the data can be sorted in accordance to the input data in the subsequent Mapper.

column

DeleteResult_ID/delete_result_id

Salesforce ID is output.

 

DeleteResult_SuccessFlag/delete_result_is_success

Success Flag is output.

  • true:Successfully processed

  • false:Process failed Please check the DeleteResult_ErrorStatusCode/delete_result_error_status_code as well as DeleteResult_ErrorMessage/delete_result_error_message.

 

DeleteResult_ErrorStatusCode/delete_result_error_status_code

The status code, returned by the Salesforce API, is output.

  • In the below-mentioned case, the Salesforce connector will output the code and message.

    • SALESFORCE_ADAPTER_ILLEGAL_DATA_TYPE

      When the type of connection resource is API 23.0 or earlier, this is set when the defined item type and input data type do not match. For example, if an item is defined as "double" but a character string is input (not a number).

    • SALESFORCE_ADAPTER_DATA_NOT_FOUND

      This is set when the target data is searched in Saleforce but cannot be found, in the case that key in Schema Definition contain items other than ID.

DeleteResult_ErrorMessage/delete_result_error_message

The message returned by the Salesforce API is output.

DeleteResult_RowNumber/delete_result_row_number

Number is output based on the placement of the node within the data given to the input schema.

 

Loading schema in Mapper

The schema is loaded automatically.

= Remarks =

For details, refer to Edit Schema.

Mass data processing

Mass data processing isn't supported.

Transaction

Transaction isn't supported.

Parallel Stream Processing

PSP isn't supported.

Available Component variables

Component Variable Name

Description

Remarks

delete_count

The number of data that was successful in the deletion processing is stored.

  • The default value is null.

error_count

The number of data that was unsuccessful in the deletion processing is stored.

  • The default value is null.

read_count

The number of input data is stored.

  • The default value is null.

not_exist_count

The number of input data whose deletion target data do not exist is stored.

  • The default value is null.

  • The value is not stored if the conditions below are not satisfied.

    • Get is selected in Whether or not to get result per rows

    • Field (key) selected in the Schema definition contains field other than ID

server_url

The end point URL after Login is stored.

  • The default value is null.

session_id

The session Id is stored.

  • The default value is null.

message_category

When an error occurs, the category of the message code corresponding to the error is stored.

  • The default value is null.

message_code

When an error occurs, the code of the message code corresponding to the error is stored.

  • The default value is null.

message_level

When an error occurs, the severity of the message code corresponding to the error is stored.

  • The default value is null.

operation_api_exception_code

The ExceptionCode of the occured error, in a case of API error, is stored.

  • The default value is null.

  • For any error other than an API Error, the value is not stored.

operation_error_message

When an error occurs, the error message is stored.

  • The default value is null.

operation_error_trace

When an error occurs, the trace information for the error is stored.

  • The default value is null.

Message codes, exception messages, and limitations

Connector

Message code

Error message

Limitations

Messages and limitations of the Salesforce(deprecated) connector

check

check

check