Welcome to the Fieldcode Manual

Tip: Start typing in the input box for immediate search results.

Search fields are all along work place used to find and filter for tickets you want to examine further. They can be used for a very fine search and allow you to find exactly the tickets you need. Search fields can even be combined with the use of logical operators and can help you to find a very specific cluster of tickets. When it comes to using search fields, using the right syntax is for sure essential. In the paragraphs below you can find a lot of hands-on examples to learn more about search fields.

If you want to search for a text value (data type: TEXT) inside a ticket like eg. name of company, country code, city name, project etc. then you have to put it between quotation marks:

 project:MyFirstCompany

You don’t have to use brackets if it’s one word without spaces. However, when you have spaces between the word, you need to use them:

project:”My first company”

If you want to insert a numeric value (data type: TEXT) like for example the CNI number of a ticket the quotation marks are not needed, simply write the numeric value in this case:

cni:5

Also important to know – always try to use the correct spelling for the aliases.

Incorrect spelling

inwarranty:TRUE

Correct spelling

inWarranty:TRUE

If you want to two or more  values you should use rounded brackets and a connector like AND or OR.

The OR operator displays results with at least one value fulfilled.

affectedCountryCode:(DE OR PL OR GR)

The AND operator displays results with all values fulfilled.

category:(“Break and fix” AND cni.sort:[5 to 8])

If you want to search for a range of tickets you have to use brackets and the word TO as a connector:

appointmentFixedTo:[202105 TO 202110]

The following format is used especially for the date data type fields:

YYYYMMDDHHMM

Year, Month, Day, Hours and Minutes

The shorter format YYYYMMDD or YYYYMM also works for searching

Be advised that searching for ranges only works with the data type date.

If you want to search for a ticket in a specific status you can just use the appropriate alias:

status:canceled

Searching for two status at once:

status: (CANCELED OR “PENDING WAIT ONSITE”)

You can also use NOT to search for specific filter elements according to the exclusion principle:

NOT status: canceled

You can also search for multiple status at once, just use the correct syntax:

NOT status: (CANCELED OR “PENDING WAIT ONSITE” OR APPOINTMENT)

You can use the simple lsdt query to find tickets for a particular date:

lsdt:20210602

If you want to search for tickets within specific dates you can use the time operators YEAR, HOURS, SECONDS and the query NOW to find the ticket:

lsdt:[NOW-1HOUR]

You can also use mathematical symbols to find a particular set of tickets:

lsdt:<20210602

Above alias will search for tickets that were last updated before the 02.06.2021. It will not display tickets after this date.

The following mathematical symbols are supported throughout search fields:

<; >; <=

Let’s say you want to find tickets with the help of mathematical symbols.

What you can do then in this case is to go by the data type date and using for example the alias lsdt to find tickets that are in the Ticket Pool before the LSDT.

lsdt:<=20220601

Absolutely! But just for text and numbers.

Let’s say you want to find tickets with contact persons, where you don’t know the exact spelling. You know the persons’ name starts with a “ki” and ends with a “y”. What you could do in this case is the following:

affectedUser:ki*y

This will display you all tickets with the variation of the name, doesn’t matter if our person is named: Kimchy, Kilaory or Kitty. The search will display them all.

The same principle goes for numbers. Let’s say you don’t know the last digit of the CNI’s so you decide to browse through all of them to find your right ticket.

cni:13*

This will display you all tickets with the CNI numbers between 130 and 139 and the ticket with CNI 13 (because the star doesn’t have to mean a number necessarily).

If you want to search for a ticket with multiple conditions you can use operators as OR, AND; TO or NOT etc. pp.

Be advised that the operator NOT is always put before the alias:

NOT category: “Break and fix”

More complex combined queries:

category:(“Standard” AND appointmentFixedFrom:[202105 TO 202110])

Next example:

category:(“Break and fix” AND cni.sort:[5 to 8])

We currently fully support the following data types in our search.

TEXT: The text data type stores any kind of text data (including numbers).

BOOLEAN: A Boolean value represents a truth value; that is, TRUE or FALSE.

DATE: Date fields have a predetermined size and format. They can be defined on the definition specification. We use the following specification inside our search: YYYYMMDDHHMM or the shorter one YYYYMMDD or YYYYMM

UUID: Universal Unique Identifier, commonly used for unique IDs
(eg. reportingUserId). 

INTEGER: The INTEGER data type stores whole numbers that range from -2147483647 to 2147483647 for 9 or 10 digits of precision.

DOUBLE: A double-precision floating-point number is a long floating-point number of 64 bits.

If you like a query and you want to use it more frequently you can save it for further usage. Find out more in the My queries topic.

Quick tips for using our further below search fields table

  • You can use the search field to faster find your desired search query
  • You can sort ascending or descending by using the the arrows inside the table
  • You can copy the search query and paste it inside Fieldcode work place, just change the value to your needs
  • Ticket Pool = How the column is called inside the Ticket Pool (Learn more about this columns in Adjust Table View)
Ticket PoolSearch GoalSearch QueryExample ValueData Type
Tickets with a specific address noteaffectedAddressNote:“Third Floor“Third FloorTEXT
CityTickets with a specific cityaffectedCity:“Wroclaw“WroclawTEXT
Tickets with a specific companyaffectedCompany:“Fieldcode Germany GmbH"Fieldcode Germany GmbHTEXT
Company NameTickets with a specific country codeaffectedCountryCode:“DE“PLTEXT
CountryTickets with a specific countryaffectedCountryName:“Germany“GermanyTEXT
Tickets with a specific primary end user emailaffectedMail1:"support@fieldcode.com"john.doe@yourcompany.comTEXT
Tickets with a specific secondary end user emailaffectedMail2:"support@fieldcode.com"doe.john@yourcompany.comTEXT
Tickets with a specific primary end user phone numberAffectedPhone1:“0039-1233456“0039-1233456TEXT
Tickets with a specific secondary end user phone numberAffectedPhone2:“0039-1233456“0039-1233456TEXT
Tickets with a specific onsite addressaffectedSite:“Company Ltd.“Test Company Ltd.TEXT
Tickets with a specific street name, insert without numberaffectedStreet:“Examplestreet“ExamplestreetTEXT
Tickets with a specific timezone IDaffectedTimezoneId:“Europe/Berlin"Europe/BerlinTEXT
End user nameTickets with a specific contact personaffectedUser:“John Doe“John DoeTEXT
Tickets with a specific ZIP codeaffectedZip:“90409“90409TEXT
Tickets with a specific Appointment Cancel CommentappointmentCancelComment:“Appointment canceled due to customer wish“Appointment canceled because of bad weatherTEXT
Tickets which have the appointment canceledappointmentCanceled:trueTrue BOOLEAN
Tickets with a specific appointment commentappointmentComment:“repair done“Repair succesfulTEXT
Tickets with a specific fixed from appointment dateappointmentFixedFrom:20211010<=2021010DATE
Fixed to dateTickets with a specific fixed to appointment dateappointmentFixedTo:20211010<20211010DATE
Tickets with a specific appointment from dateappointmentFrom:20211010<=2021010DATE
Tickets with a specific appointment ID (check for it in Fieldcode admin panel)appointmentId:8ebd82e7-af64-440e-9bdf-cf0887eb0e608ebd82e7-af64-440e-9bdf-cf0887eb0e60UUID
Ticket with a specific appointment statusappointmentStatus:“FAILED“COMPLETEDTEXT
Tickets with a specific appointment to dateappointmentTo:20211010[202105 TO 202110]DATE
Tickets with a specific appointment user IDapppointmentUserId:8ebd82e7-af64-440e-9bdf-cf0887eb0e608ebd82e7-af64-440e-9bdf-cf0887eb0e60UUID
Tickets with a specific appointment user nameappointmentUserName:“John Doe“Marsha WilliamsTEXT
Tickets with a specific asset tagassetTag:“example text“iPhone 12 ProTEXT
Tickets with a specific cancel reason constant display textcancelReasonConstantDisplayText:CONSTANT DISPLAY_TEXTTEXT
CategoryTickets with a specific category (eg. Break & Fix)category:"Installation, Move, Add, Change, and Disposal"StandardTEXT
Tickets with a specific category constant display textCONSTANT DISPLAY_TEXTStandardTEXT
Tickets with a specific close date or close date rangeClosed:20211010>20211010DATE
CNETickets with a specific CNE or CNE rangecne:“CNE1105“CNE1082TEXT
CNE ParentTicket with a specific CNE ParentcneParent:“ANYTEXT“AX57213TEXT
CNITickets which have a specific CNI or CNI rangecni:12912*INTEGER
Tickets with a specific condition config descriptionconditionConfigDesDue date is getting close!TEXT
Tickets with a specific condition config enumerationconditionConfigEnumCONDITION_APPOINTMENT_DISPATCHED_TO;
CONDITION_APPOINTMENT_DISPATCHED_FROM;
CONDITION_LSDT;
CONDITION_APPOINTMENT_FIXED_TO;
CONDITION_APPOINTMENT_FIXED_FROM;
CONDITION_TICKETSTATUS
TEXT
Tickets with a specific condition critical timeconditionCriticalTime:20211010[NOW/DAY-10DAY TO NOW]DATE
Tickets with a specific condition warn timeconditionWarnTime:20211010[NOW/DAY-10DAY TO NOW]DATE
Creation DateTickets with a specific creation datecreation:20211010[NOW/DAY-10DAY TO NOW]DATE
Tickets with a specific appointment cancel comment (searches only the last appointments of all tickets)currentAppointmentCancelComment:"Bad Weather"Tornado warningTEXT
Tickets with a canceled appointment or opposite (searches only the last appointments of all tickets)currentAppointmentCanceled:TRUETRUEBOOLEAN
Tickets with a specific appointment cancel reason (searches only the last appointments of all tickets)currentAppointmentCancelReasonCanceled due to customer wishTEXT
Tickets with a specific appointment comment (searches only the last appointments of all tickets)currentAppointmentComment:“example text“ANYTEXTTEXT
Tickets with a dispatched appointment or opposite (searches only the last appointments of all tickets)currentAppointmentDispatched:TRUEFALSEBOOLEAN
Tickets with a specific appointment dispatched from time or range (searches only the last appointments of all tickets)currentAppointmentDispatchedFrom:20211010>=2021010DATE
Tickets with specific appointment to time or range (searches only the last appointments of all tickets)currentAppointmentDispatchedTo:20211010>=2021010DATE
Tickets with a specific appointment fixed from time or range (searches only the last appointments of all tickets)currentAppointmentFixedFrom:20211010>=2021010DATE
Tickets with a specific appointment fixed to time or range (searches only the last appointments of all tickets)currentAppointmentFixedTo:20211010>=2021010DATE
Tickets where the appointment is locked or opposite (searches only the last appointments of all tickets)currentAppointmentLocked:TRUEFALSEBOOLEAN
Tickets with a specific appointment preferred from time or range (searches only the last appointments of all tickets)currentAppointmentPreferredFrom:20211010>=2021010DATE
Tickets with a specific appointment preferred to time or range (searches only the last appointments of all tickets)currentAppointmentPreferredTo:20211010>=2021010DATE
Tickets with a specific proposed from time or range (searches only the last appointments of all tickets)currentAppointmentProposedFrom:20211010>=2021010DATE
Tickets with a specific appointment proposed to time or range (searches only the last appointments of all tickets)currentAppointmentProposedTo:20211010>=2021010DATE
Tickets with a specific appointment status (searches only the last appointments of all tickets)currentAppointmentStatus:FAILEDCOMPLETEDTEXT
Tickets with undispatched appointment or opposite (searches only the last appointments of all tickets)currentAppointmentUndispatched:TRUETRUEBOOLEAN
Tickets with a specific appointment User ID (searches only the last appointments of all tickets)currentAppointmentUserId:8ebd82e7-af64-440e-9bdf-cf0887eb0e608ebd82e7-af64-440e-9bdf-cf0887eb0e60UUID
Tickets with a specific appointment user name (searches only the last appointments of all tickets)currentAppointmentUserName:“John Doe“"FirstName LastName"TEXT
Tickets with a specific duration (searches only the last appointments of all tickets)currentDuration:1800SecondsINTEGER
Tickets with a specific duration end (searches only the last appointments of all tickets)currentDurationEnd:20211010>=2021010DATE
Tickets with a specific duration start (searches only the last appointments of all tickets)currentDurationStart:202105<=2021010DATE
Tickets with a specific duration type (searches only the last appointments of all tickets)currentDurationType:WORKTIMEWORKTIMETEXT
Tickets with a LSDT miss or opposite (searches only the last LSDT miss of all tickets)currentLsdtMiss:TRUETRUEBOOLEAN
Tickets with a successful reporting or opposite (searches only the last reporting succesful of all tickets)currentReportingSuccessful:TRUETRUEBOOLEAN
Tickets with a specific reporting user ID (searches only the last reporting of all tickets)currentReportingUserId:8ebd82e7-af64-440e-9bdf-cf0887eb0e608ebd82e7-af64-440e-9bdf-cf0887eb0e60UUID
Tickets with a specific reporting user name (searches only the last appointments of all tickets)currentReportingUserName:“John Doe“"FirstName LastName"TEXT
Tickets with a specific reporting work note (searches only the last reporting of all tickets)currentReportingWorkNote:“example text"work done successfullyTEXT
Tickets with a specific description textdescription:“example text“Ticket is urgentTEXT
Tickets with a system connectiondirectConnectionStatus:ActiveActiveTEXT
Tickets which were dispatched or oppositedispatched:TRUETRUEBOOLEAN
Tickets with a specific ticket duration (in minutes)durations:18001800INTEGER
Error CodeTickets with a specific error codeerrorCode:“No error"ANYTEXTTEXT
Info/Alert/PartTickets which where escalated or oppositeescalation:TRUEFALSEBOOLEAN
Tickets which have a specific escalation reasonescalationReason:“example text“Ticket was escalated because customer could not be reachedTEXT
Tickets with a specific estimated duration in minutesestimatedDuration:6090INTEGER
Ticket with a specific device host nameHostname:“www“wwwTEXT
Tickets with a specific IDid:2198851012INTEGER
Info/Alert/PartTickets which have a critical indication or oppositeindicationIsCritical:TRUEFALSEBOOLEAN
Info/Alert/PartTickets which have a warning indication or oppositeindicationIsWarning:TRUEFALSEBOOLEAN
Tickets where the device is either in warranty or oppositeinWarranty:TRUEFALSEBOOLEAN
Tickets which are locked by the user or oppositelocked:TRUEFALSEBOOLEAN
LSDTTickets with a specific LSDT timelsdt:[202105 TO 202110]<=2021010DATE
Tickets with a specific Mac Adressmac:“E4-B9-7A-DE-00-94"E4-B9-7A-DE-00-94TEXT
Tickets with a specific manufacturer namemanufacturerName:“example text“LenovroTEXT
DeviceTickets with a specific modelmodel:“example text“Lenovro Deskbook X12TEXT
Tickets with a specific notenote:“example text“ANYTEXTTEXT
Tickets with a specific device operating systemos:“MacOS“Windows 11TEXT
Partner nameTicket with a specific partner assignedpartnerName:"Partner Company"ABC Partner CompanyTEXT
Tickets with a specific preferred to datepreferredTo:[202105 TO 202110][202105 TO 202110]DATE
Tickets with a specific prioritypriority:13INTEGER
Tickets with a specific product lineproductLine:“Intel“AMDTEXT
ProjectTicket with a specific projectproject:“My Company“Test Company Ltd.TEXT
Tickets with a specific Project IDprojectId:19342479INTEGER
Tickets with a specific proposed from timeproposedFrom:20211010<=2021010DATE
Tickets with a specific proposed to timeproposedTo:20211010<=2021010DATE
Tickets with a specific reporting User IDreportingUserID:“8ebd82e7-af64-440e-9bdf-cf0887eb0e60“8ebd82e7-af64-440e-9bdf-cf0887eb0e60“UUID
Tickets with a specific reporting work notereportingWorkNote:“reporting done“Reporting without signoffTEXT
ScoreTickets with a specific ticket scorescore:71-10DOUBLE
Tickets with a specific device serialserial:“DEV-SER-2729“AJX-31X-21JTEXT
Tickets with a specific serial providedserialProvided:“34yxz-0812r-144“JKA-81U-081TEXT
Tickets with a specific device short descriptionshortDescription:“Smaller variant of the device“Bigger variant of the displayTEXT
Tickets with a specific Specification referencespecificationReference:“32342“Size XLTEXT
StatusTickets with a specific statusStatus:“RESOLVED“NEWTEXT
SubcategoryTickets with a specific sub categorysubCategory:“Standard“Break & FixTEXT
Ticket which were resolved successful or oppositesuccessful:“TRUE“FALSEBOOLEAN
Tickets with a specific suppliersupplier:“Demo Company“Example Company Ltd.TEXT
Tickets with a specific device typetype:“desktop“mobileTEXT
Tickets which are undispatchedundispatched:TRUEFALSEBOOLEAN
Tickets with a specific User IDuserId:“8ebd82e7-af64-440e-9bdf-cf0887eb0e60“8ebd82e7-af64-440e-9bdf-cf0887eb0e60UUID
Grabbed byTickets grabbed by a specific personuserName:“John Doe“Marsha WilliamsTEXT
Info/Alert/PartTickets with a vip flag or oppositevip:TRUEFALSEBOOLEAN
Tickets which have a device with a specific warranty typewarrantyType:“Apple Care +“Apple Care +TEXT
Tickets with a wrong serial provided or oppositewrongSerialProvided:TRUEFALSEBOOLEAN
Partner nameTickets with a specific partnerpartner:"ABC Company"ABC CompanyTEXT
Was this article helpful?
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Tags:
Next How the ticket colors are defined
Table of Contents