Versions Compared

Key

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

TIXnGO is the leading secure mobile wallet solution provided by the SecuTix company.

...

Recommended value: 1000


Multilingual Feature

Add the custom parameter sendMultilingualAsJsonObject=true in the General tab when you configure an External printing interface.

Image Modified

Set up multilingual event fields in the ticket template

Prepare your ticket template and use this template when scheduling a Tickets external printing function
Example: event.name = ${Performance_hostTeam} - ${Performance_opposingTeam}

Other available multilingual fields:

TIXNGO nameS-360 Ticket template config nameS-360 usually uses variablesTranslated values come from
Event group nameevent.group.name${Product_externalName}

Organisation > Catalogue > Ordinary admissions > Competition

Image Modified

Event group imageevent.group.imageStatic URLMultilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Event nameevent.name${Performance_hostTeam} - ${Performance_opposingTeam}

Organisation > Initialisation > Organisation parameters > Teams

Event websiteevent.websiteStatic URLMultilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Event address siteevent.address.site${Space_externalName}

Institution > Venue > Venue parameters > Space

Image Modified

Event address cityevent.address.city${Site_externalName}

Institution > Venue > Venue parameters > Sites (General)

Image Modified

Event address line1event.address.line1${Site_street1}

Institution > Venue > Venue parameters > Sites (Address)

Image Modified

Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO

Event address line2event.address.line2${Site_street2}
Event address line3event.address.line3${Site_street3}

Set up multilingual ticket detail values in the ticket template

TIXNGO nameS-360 Ticket template config nameS-360 usually uses variablesTranslated values come from
Ticket details mainticketDetails.main.<sequence>.key

Static values
Hospitality, Entrance, Gate, Block, Row, Seat,...

Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO

ticketDetails.main.<sequence>.value

${Hospitality_seatRoomName}, ${External_Entrance_externalName}, ${Entrance_externalName}, ${Seat_block}, ${Seat_row}, ${Seat_nb},...


Ticket details extraticketDetails.extra.<sequence>.key

Static values
Category, Order number, ticket number, target group, No re-entry,...

Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
ticketDetails.extra.<sequence>.value${LogicalSeatCategory_externalName}, ${Operation_field}, ${Ticket_taxnumber}, ${Amount_currency} ${Amount_baseUnitAmount}, ${Contingent_externalName}

Ticket details hidden
(Not displayed in the mobile ticket app)

ticketDetails.hidden.<sequence>.keyStatic valuesMultilingual value has not been supported in S-360 and TIXNGO yet
ticketDetails.hidden.<sequence>.valueAny values

...

Comfort variable codeFormatExampleInjected field inside TIXnGONotes
TIXAct

start_of_season
end_of_season
+1d/-1w
dd/mm/yy hh:mm

start_of_season
end_of_season
2w
22/10/23 21:15
activationParameters.time

If not defined, nothing special happens

Parts in blue will be implemented with :

Jira Legacy
serverSecuTix JIRA Tracking System
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-128539

TIXStart

start_of_season
end_of_season
+1d/-1w
dd/mm/yy hh:mm

start_of_season
end_of_season
2w
22/10/23 21:15

event.startTime

If comfort variable is not defined, then the value is taken from the start time of the performance or the start validity date of the ticket.

Parts in blue will be implemented with :

Jira Legacy
serverSecuTix JIRA Tracking System
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-128539

TIXExp

start_of_season
end_of_season
+1d/-1w
dd/mm/yy hh:mm

start_of_season
end_of_season
2w
22/10/23 21:15

event.expirationDate

If comfort variable is not defined, then the value is taken from the end date of the performance + duration (or +24 hours if duration not defined), or the end validity date of the ticket.

Parts in blue will be implemented with :

Jira Legacy
serverSecuTix JIRA Tracking System
serverIddb7e2039-f715-3f84-b1ed-ba058a819c06
keySTX-128539

...

Please enter here one or many of the following values, separated by commas

FIRSTNAME,LASTNAME,BIRTHDATE,ID_NUMBER,COUNTRY_CODE,BIRTH_REGION,BIRTH_PLACE

Only the tickets having those beneficiary values filled will be sent to TIXnGO.

...

  1. if the cancellation cause is in the list of overrideVisibilityFlagForInvalidationReasons (default value: empty), the the visibility is true. (showDeletedTicket =true)
  2. Else, if the checkbox "Notify spectator" is checked, the the visibility is set to true. (showDeletedTicket =true)
  3. Else default visbility is used. Default: false (showDeletedTicket =false), Can be altered using custom parameter: visibilityFlagDefaultValue

Multilingual Feature

...

Push controlled tickets

This batch pushes the controlled status of the tickets to TIXnGO

...

Custom parametersPurpose 
ticketIterationSize

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.

batchSplitSize

This custom parameter is used for the Retrieve tickets status from TIXnGO batch. 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

resetInjectionInvalidationReasons

This custom parameter is used for the Tickets external printing 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

excludeTicketResale
overrideVisibilityFlagForInvalidationReasons

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=true, overrideVisibilityFlagForInvalidationReason=RESALE_PENDING, RESOLD

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=trueTo generate tnPRVariables file ticket detail after injecting ticket into TnG. To check the variable and its value as well
enforceMandatoryParametersThe 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.
dumpDataModifiedByTemplateDefault value: false. Set it to true to log the values modified by the template associated to the export.
overlaySpectatirDetailsWithLastOwner

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_MODE

Only possible value lifecycle. When enabled, activates ticket status feature related to

Jira Legacy
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 TIXnGO

sendmultilingualjsonobject=true

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

Jira Legacy
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

usePushCancelledTicketsV1

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.

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

...