Skip to end of banner
Go to start of banner

Xactly Upsert

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

On this Page

Snap type:Write
Description:

This Snap creates a new object or updates an existing object in Xactly Incent app. To perform create, do not supply any value for xobj:id field. To perform update, supply Object-ID of existing object to xobj:id field. 

  • Expected upstream Snaps: CSV Generator / File Reader and so on
  • Expected downstream Snaps: File Writer.
  • Expected input: The name of the Xactly object to be created such as PersonWSO or BonusWSO and the property values of the object to be matched.
  • Expected output: Confirmation of the object's creation.


Prerequisites:None.
Support and limitations:Works in Ultra Task Pipelines.
Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. It uses an account class called XactlySoapAccount which stores the WSDL file and the credentials to connect to Xactly server.  It also caches Session ID that is required for subsequent CRUD operations. See Configuring Xactly Accounts for information on setting up this type of account.


Views:
Input

The Snap has exactly one input view which contains properties to be used while performing the save operation.

The following properties are recommended to be used at the minimum for performing successful save operation: employeeId, version, name, description, prefix, firstName, lastName, region, personalTarget, personalTargetUnitTypeId, paymentCurrencyUnitTypeId, user, isMaster.


The properties user, paymentCurrencyUnitTypeId and personalTargetUnitTypeId must have well-defined values as per Xactly User web page.

Output

This Snap has exactly one output view that contains the contains the outcome of the save operation. 

Error

This Snap has at most one error view and produces zero or more documents in the view.

Settings

Label*

Specify the name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.


Xactly object

The type of object to be saved. Once defined, the input view will provide the schema of the object so that field values can be defined for the save request.

Default Value: PersonWSO
Example: CustomerWSO

Snap execution

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Troubleshooting

Error

Reason

Resolution

HTTP/1.1 407 Proxy Authentication required.

Unable to tunnel through proxy.

Add the following key-value pair values to your Groundplex configuration and restart the plex to reflect the changes.

Key : jcc.jvm_options
Value : -Djdk.http.auth.tunneling.disabledSchemes=""

Release 

Snap Pack Version

Date

Type

  Updates

February 2024

436patches25953

Latest

Upgraded Apache CXF from version 3.4.2 to 3.6.3 to prevent vulnerability issues.

November 2023

main23721

 

Stable

Updated and certified against the current SnapLogic Platform release.

August 2023

main22460

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023

main21015

 

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023

main19844

 

Stable

Upgraded with the latest SnapLogic Platform release.

November 2022

main18944

 

Stable

Upgraded with the latest SnapLogic Platform release.

October 2022

430patches18502

 

Latest

The Xactly Snaps now pass the upstream input document to the error view successfully.

August 2022

main17386

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.29

main15993

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.28

main14627

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.26

main11181

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.25

main9554

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.24

main8556

Stable

Upgraded with the latest SnapLogic Platform release.

4.23

main7430

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.22

main6403

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.21

snapsmrc542

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.20

snapsmrc535

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.19

snaprsmrc528

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.18

snapsmrc523

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.17

ALL7402

 

Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17

snapsmrc515

 

Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16

snapsmrc508

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.15

snapsmrc500

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.14

snapsmrc490

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.13

snapsmrc486

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.11

snapsmrc465

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.10 Patch 

xactly3636

 

Latest

Fixed the issue for field not found in JSON object: soapenv:Body resolution

4.10

snapsmrc414

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.9 Patch 

xactly3039

 

Latest

Updated to display proper error message when wrong credentials are given in the account.

4.9

snapsmrc405

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.7

snapsmrc382

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.6

snapsmrc362

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.5.1

snapsmrc344

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.4.1

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.4

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.32

 

Stable

Added "Xactly" to Delete, Search and Upsert Snap names.

  • No labels