Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Supported parameters (13.05.2024)

Custom parameters
InjectFeedbackCancelledControlledN
TypePurpose 
Interface Global Parameters
killRatioS-360 TechnicalThis parameter is technical,  for advanced configuration. To avoid blocking the execution of the interface
doContinueInCaseOfSyncErrorS-360 Technical doContinueInCaseOfSyncError=true required for “Receive ticket status from TIXnGO” interface functionality, prevents same error tickets being considered by the interface multiple times.
stickToTheHourS-360 Technical

Advanced configuration. Default value: true
When true, schedule is executed every 5', sticking to the minutes ending by 5. If it executes at 13h35 and has a duration of 7 minutes, next execution won't be 13h42 (35+7), but 45 (35+7, rounding to the next x5 minutes)
When false, schedule is executed every 5',If it executes at 13h35 and has a duration of 7 minutes, execution will be at 13h42 (35+7).

maxLengthDumpedCallsInKbsS-360 Technical

Use for troubleshooting ONLY. In order to save the payloads exchanged between S-360 & TIXNGO, you can use maxLengthDumpedCallsInKbs=5000

ticketIterationSize

TIXNGO Performances

Integer. Default value : 50. Number of tickets pushed to TIXNGO in one call.
Prior to the planned performances improvements on TIXNGO side, the current maximum number of tickets supported is 50.
(warning) Do not use this custom parameter if you did not have a proper discussion about performances with Platform or TIXNGO team (warning)

Ticket Injection
dumpTnPRvariables=true
Y

N

N
S-360 TechnicalTo generate tnPRVariables file ticket detail after injecting ticket into TnG. To check the variable and its value as well
enforceMandatoryParameters
YNNNN
S-360 BusinessThe interface fails with a proper error message before calling TixNGo if the mandatory parameters of the tickets to inject are not present.
Default value : true. Do not change if you don't know what you are doing.
dumpDataModifiedByTemplate
YNN
S-360 TechnicalDefault value: false. Set it to true to log the values modified by the template associated to the export.
overlaySpectatirDetailsWithLastOwnerYNN
overlaySpectatorDetailsWithLastOwnerS-360 Technical
N" (typo included) not "Spectator" as you may expect.

Default value: true. Set it to false to skip the rule: But, IF the tickets has been reprinted, it will be assigned to its last known holder, as retrieved from TIXnGO

.
(warning) The parameter is spelled with "SpectatirN


resetInjectionInvalidationReasons

YNN

S-360 Business

This custom parameter is used for the Tickets external printing

to

to allow injecting mobile tickets to the latest ticket holder contact or cultural contact based on the invalidation reason, i.e., reseating

Example: After injecting ticket into TnG for contact A (cultural contact) then contact A open mobile app and transfer the ticket to contact B (latest mobile owner). On the STX side, the operator reprinted that ticket with invalidation reason THEFT and reinject it into TnG, this ticket will reinject back to contact A. If there is no invalidation reason here, the new ticket will be reinjected back to contact B

Note: All the cancellation reasons are those which appear on the list of values in the BO [Institution > Initialisation > List of values > Ticket (Cancellation cause)]. With validation reason Theft , rESEATING will work too because the invalidation causes will be modified in order to remove the spaces and to be all set in upper cases

Image Modified

sendmultilingualjsonobject=trueYNNNT

resetInjectionInvalidationReasons=ITA_WRONG_DATA  this is required for ticket reprint functionality. With this setup if mobile ticket is reprinted with invalidation reason “WRONG DATA” ticket will be injected to the current cultural contact and not to the latest owner.

sendMultilingualAsJsonObject

updateJSONInsteadOfObject

S-360 Business

Use sendMultilingualAsJsonObject=true to

o

inject tickets to TIXNGO  from S360 or by CSV with multilingual support

Jira
serverSecuTix JIRA Tracking System
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-127552

(question) What it is exactly doing ? The code mentions "Control the missing mappings addition".

injectOptimSplitQueries


It is an optimization to reduce the time of selecting tickets to process in ticket injection. by default is true. to desactivate; injectOptimSplitQueries=false
Retrieve ticket status
ticketIterationSizeNNYY

This custom parameter is used for the Tickets external printing/ Push cancelled and validate tickets/ Push controlled tickets. To support larger batch sizes, split them into smaller calls to blockchain to send smaller batches, one after the other inside the same execution. The default split size is 50

Note: The TIXnGO side supported only 50 tickets/times, so that should be kept as default.

batchSplitSizeNYNNThis custom parameter is used for the Retrieve tickets status from TIXnGO batch. To support


TIXNGO_LIFECYCLE_MODETIXNGO Business

(error) DEPRECATED parameter (error) Only the LIFECYCLE mode will be supported and used by default. Ability to use legacy payload has been removed (error)
For more info about lifecycle vs history, please refer to this page : 4. Retrieve ticket status from TIXnGO

additionalDiffParametersTIXNGO Technical

Advanced configuration. Use for troubleshooting ONLY.

String. Multi-value parameters allowing to customize results returned by TIXNGO diff end-point using the lifecycle mode.

  • additionalDiffParameters=lightPayload=true → By enabling the lightPayload, TIXNGO won't return event details, legacy status & history object

(error) DEPRECATED parameter (error) Only the lighPayload mode will be supported and used by default. Ability to revert the heavy payload has been removed (error)

  • additionalDiffParameters=updatedDate=<date-time> to filter tickets by date, example additionalDiffParameters=lightPayload=true&updatedDate=2022-08-15T04:25:28.483Z 

Use for troubleshooting ONLY. Not fit for day-to-day operations. → By setting up a date, TIXNGO will return only the tickets matching the updatedDate criteria. 

  • additionalDiffParameters=taxNumber=<list of tax number> to filter tickets by taxNumber, example additionalDiffParameters=lightPayload=true&updatedDate=2023-05-01T04:25:28.483Z&taxNumber=01010043155

Use for troubleshooting ONLY. Not fit for day-to-day operations. → By setting up a date, TIXNGO will return only the tickets matching the updatedDate criteria. 

For more information please refer to the US TIX2-3167

batchSplitSizeTIXNGO Performances

To support larger batch sizes, split them into smaller calls to blockchain to retrieve smaller batches, one after the other inside the same execution. The default split size is 1000

Example: Batch size in the Retrieve tickets status from TIXnGO = 5000, batchSplitSize = 1000. It will split 5000 to 5 calls in the same execution with 1000 per call

excludeTicketResale
overrideVisibilityFlagForInvalidationReasonsNNY

enableTicketDistributionToCulturalContactS-360 Business

Default value: false

When true, for a successfully transferred ticket, will create a cultural contact and change the CC of this ticket by this newly created contact (ie "Distribute the ticket") while introducing a new row into the Distribution history. For other "PENDING" statuses, will create a contact based on what is already returned by TIXNGO and update it later when the transfer is either completed or cancelled/interrupted.
When false, no contact creation, no ticket distribution.

Push Cancelled
excludeResaleTickets
overrideVisibilityFlagForInvalidationReasons
S-360 Business
N

Both custom parameters are used for putting blockchain tickets into the resale platform and specified for Push cancelled and validate ticket batch. The purpose of those parameters is to update the invalidation reason to TnG after putting the ticket on the resale platform or tickets is resold.

Example:

excludeTicketResale

excludeResaleTickets=true, overrideVisibilityFlagForInvalidationReason=RESALE_PENDING, RESOLD. by default.

After putting the ticket on the resale platform, the old ticket is invalidated and the validation reason will be updated into TnG side by the Push cancelled and validate ticket with invalidation set at overrideVisibilityFlagForInvalidationReason

For more information, please refer to the US STX-110559

dumpTnPRvariables=trueY

N

NNTo generate tnPRVariables file ticket detail after injecting ticket into TnG

.

To check the variable and its value as wellenforceMandatoryParametersYNNNThe interface fails with a proper error message before calling TixNGo if the mandatory parameters of the tickets to inject are not present.
Default value : true. Do not change if you don't know what you are doing.dumpDataModifiedByTemplateYNNNDefault value: false. Set it to true to log the values modified by the template associated to the export.overlaySpectatirDetailsWithLastOwnerYNNN

Default value: true. Set it to false to skip the rule: But, IF the tickets has been reprinted, it will be assigned to its last known holder, as retrieved from TIXnGO.
(warning) The parameter is spelled with "Spectatir" (typo included) not "Spectator" as you may expect.

TIXNGO_LIFECYCLE_MODENYNNOnly possible value lifecycle. When enabled, activates ticket status feature related to
Jira
serverSecuTix JIRA Tracking System
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-122715
If not used, the default mode for synchronisation is the history/legacy one. For more info about lifecycle vs history, please refer to this page : Retrieve ticket status from TIXnGOsendmultilingualjsonobject=trueYNNN

To inject tickets to TIXNGO  from S360 or by CSV with multilingual support

Jira
serverSecuTix JIRA Tracking System
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-127552

usePushCancelledTicketsV1NNYN

Default value: false. Set it to true to use the deprecated query to get the list of cancelled/invalidated tickets.
(warning) DEPRECATED. Either set it explicitly to false or remove completely the custom parameter.

doPatchWhenPushingControlledTicketsNNNYBy default is set to use PATCH in the API call. If set to false (doPatchWhenPushingControlledTickets=false), the method POST will be used.

For more information regarding visibility rule, please refer to the section "Ticket visibility rule" in https://confluence.secutix.com/x/tAxWCg

cancelledBucketSizeTIXNGO Performances 

Integer. Default value : 50. Number of tickets pushed to TIXNGO in one call.
Prior to the planned performances improvements on TIXNGO side, the current maximum number of tickets supported is 50.
(warning) Do not use this custom parameter if you did not have a proper discussion about performances with Platform or TIXNGO team (warning)

Push Controlled
doPatchWhenPushingControlledTicketsTIXNGO Performances 

(error) DEPRECATED parameter (error) Only the POST method will be supported and used by default. Ability to use PATCH method has been removed (error)
Boolean. If true, the function is using PATCH method in the API call. If false, the function is using POST method which has better performances.

controlledBucketSize
TIXNGO Performances 

Integer. Default value : 50. Number of tickets pushed to TIXNGO in one call.
Prior to the planned performances improvements on TIXNGO side, the current maximum number of tickets supported is 50.
(warning) Do not use this custom parameter if you did not have a proper discussion about performances with Platform or TIXNGO team (warning)