Welcome to the Fieldcode Manual

Type a term in the box to instantly list helpful topics. Category filters help to narrow down search results.

Search queries can be used along Work Place to find tickets or a set of tickets. Queries can be used for a very granular search. Search queries can be combined with the aid of logical operators and can therefore help you to find very specific ticket clusters.

In the sections below you can find a lot of examples to learn more about queries and how to combine them with logical operators.

The search query table gives you the possibility to instantly copy & paste queries over to Fieldcode Work Place.

If you want to search for a text value (data type: STRING) like eg. name of company, country code, city name, project etc. then normally you have to put the values between quotation marks. If it’s just one word you don’t have to use quotations, you can instead refrain from using quotations:

 project:My/First/Project

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

project:”My second project”

If you want to insert a numeric value (data type: STRING) like for example the CNI number of a ticket do as follows:

cni:”5″

Also good to know – always try to use the correct spelling for the queries – otherwise results may not appear.

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 type fields in order for results to be displayed:
YYYYMMDDHHMM = Year, Month, Day, Hours, and Minutes

The shorter format YYYYMMDD or YYYYMM also works for the query search.

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

If you want to search for tickets in a particular status you can just use the matching query:

status:canceled

Searching for two statuses at once is also easily possible:

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:<20230602

Above alias will search for tickets that were last updated before the 02.06.2023.
It won’t 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 could do in this case is to go by the data type date and using the query lsdt to find only tickets before a selected LSDT.

lsdt:<=20220601

Yes! 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”

A more complex combined query example:

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

Another complex combined query example:

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

We currently utilize the following data types in our search.

String: The string data type stores any kind of text data (including numbers).
Boolean: The boolean value  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.

Yes, you can!
If you like a query and you want to use it more frequently you can save it for further usage.
Learn more in the My queries topic.

You can try to find tickets with a specific keyword by just typing a keyword inside the search field.
This can prove particularly useful if for any reason you cannot find a matching query or you just need some fast results.
The Elastic Search will then do it’s best to display results with all tickets that contain your keyword.
Let’s assume you want to find all tickets which have the value “unicorn” somewhere entered:

 unicorn

You can also take this further to find all tickets that particularly do not not contain this value by using the – symbol.

-“unicorn”

Query prefixes explained
  • "affected" queries refer to ticket requestor data 
  • "currentIntervention" queries only display results for the last appointment and not the ones before
  • "intervention" queries refer to appointment data 
  • "items" queries refer to Part data
  • "items.currentshipping" queries only display results for the last shipment and not the ones before 
Quick tips for using the below search query table
  • You can use the search field inside the query table below to find a search query faster
  • You can sort ascending or descending by using the arrows inside the table
  • You can copy queries and paste them inside the Ticket Pool, just change the value according to your desired value
  • Date fields usually use the UTC TIME ZONE as a reference point, therefore it is not a bug and expected behavior if other dates show up in the search result
QuerySearch goalTicket Pool termData type
affectedAddressNote:"Fourth floor - first right"Address notestring
affectedCity:NurembergCityCitystring
affectedCompany:"DEMO GmbH"CompanyCompany Namestring
affectedCountryCode:DECountry codestring
affectedCountryName:GermanyCountryCountrystring
affectedMail1:"manualwriters@live.com"Primary customer emailstring
affectedMail2:"manualwriters@live.com"Secondary customer emailstring
affectedPhone1:“00391233456“Primary customer phone number string
affectedPhone2:“0039-1233456“Secondary customer phone number string
affectedSite:“DEMO CORP Ltd.“Site address string
affectedState:TexasStateStatestring
affectedStreet:TucherstrasseStreet namestring
affectedStreetNumber:"13"Street numberstring
affectedTimezoneId:“Europe/Berlin"Timezone IDstring
affectedUser:“John Doe“Contact person/Customer name End user namestring
affectedZip:90409 ZIP codestring
assetTag:“example tag“ Asset tag string
category:"Installation, Move, Add, Change, and Disposal"CategoryCategorystring
categoryConstantDisplayText:AnytextCategory labelstring
clipboard:trueClipboardboolean
closed:20230602Closedstring($date-time)
cne:A47Call Number ExternalCNEstring
cneParent:A47Call Number External ParentCNE Parentstring
cni:39Call Number InternalCNIinteger($int32)
conditions.constantDescription:ANYTEXTDescription -> Conditionsstring
conditions.constantEnumeration:ANYTEXTEnumeration -> Conditionsstring
conditions.criticalTime:20230602Critical time -> Conditionsstring($date-time)
conditions.id:45ID -> Conditionsinteger($int64)
conditions.warnTime:20230602Warning time -> Conditionsstring($date-time)
container:trueContainerboolean
containerId:237Childinteger($int64)
creation:20230602CreationCreation Datestring($date-time)
currentIntervention. durationStart:20230602Duration start -> Current interventionstring($date-time)
currentIntervention. reportingUserId:34Reporting user ID -> Current interventionstring
currentIntervention. reportingUserName:"John Doe"Reporting user name -> Current interventionstring
currentIntervention. reportingWorkNote:ANYTEXTReporting work note -> Current interventionstring
currentIntervention.appointment.cancelComment:ANYTEXTCancel comment -> Appointment -> Current interventionstring
currentIntervention.appointment.canceled:trueCanceled -> Appointment -> Current interventionboolean
currentIntervention.appointment.cancelReason:ANYTEXTCancel reason -> Appointment -> Current interventionstring
currentIntervention.appointment.comment:ANYTEXTComment -> Appointment -> Current interventionstring
currentIntervention.appointment.dispatched:trueDispatched -> Appointment -> Current interventionboolean
currentIntervention.appointment.dispatchedFrom:20230602Dispatched From -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.dispatchedTo:20230602Dispatched To -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.dispatchGroup:NurembergDispatch Group -> Appointment -> Current interventionstring
currentIntervention.appointment.fixedFrom:20230602Fixed From -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.fixedTo:20230602Fixed To -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.id:451ID -> Appointment -> Current interventioninteger($int64)
currentIntervention.appointment.isFixedResource:trueEngineer; Technician; Is fixed -> Appointment -> Current interventionboolean
currentIntervention.appointment.locked:trueAppoitnment; Locked -> Appointment -> Current interventionboolean
currentIntervention.appointment.preferredFrom:20230602Preferred From -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.preferredTo:20230602Preferred To -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.proposedFrom:20230602Proposed From -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.proposedTo:20230602Proposed To -> Appointment -> Current interventionstring($date-time)
currentIntervention.appointment.status:ANYTEXTStatus -> Appointment -> Current interventionstring
currentIntervention.appointment.undispatched:trueUndispatched -> Appointment -> Current interventionboolean
currentIntervention.appointment.undispatchedV2:trueUndispatched V2 -> Appointment -> Current interventionboolean
currentIntervention.appointment.userId:ANYTEXTUser ID -> Appointment -> Current interventionstring
currentIntervention.appointment.userName:ANYTEXTUser name -> Appointment -> Current interventionstring
currentIntervention.duration:20230602Duration -> Current interventioninteger($int32)
currentIntervention.durationEnd:20230602Duration end -> Current interventionstring($date-time)
currentIntervention.durationType:ANYTEXTDuration type -> Current interventionstring
currentIntervention.lsdtMiss:trueLSDT Miss -> Current interventionboolean
currentIntervention.reportingSuccessful:trueReporting successful -> Current interventionboolean
description:ANYTEXTDescriptionstring
deviceCategory:DesktopDevice CategoryDevice Categorystring
directConnections.directConnectionHealth:ANYTEXTDirect connection health -> Direct connectionsstring
directConnections.directConnectionStatus:ANYTEXTDirect connection status -> Direct connectionsstring
directConnections.directConnectionSystemName:ANYTEXTDirect connection status name -> Direct connectionsstring
directConnectionStatus:ANYTEXTDirect connection status -> Direct connectionstring
directConnectionSystemName:ANYTEXTDirect connection system namestring
dispatchGroups.id:ANYTEXTID -> Dispatch groupsstring
dispatchStatuses.appointment:20230602Appointment -> Dispatch statusesinteger($int32)
dispatchStatuses.executionDelayStart:20230602Delay start -> Dispatch statusesstring($date-time)
dispatchStatuses.id:ANYTEXTID -> Dispatch statusesstring
dispatchStatuses.nonExecutionRiskStart:20230602Non execution risk start -> Dispatch statusesstring($date-time)
dispatchStatuses.status:ANYTEXTStatus -> Dispatch statusesstring
errorCode:A23527ASEEE0Error codeError Codestring
escalation:trueEscalationInfo/Alert/Part -> Escalationboolean
escalationReason:ANYTEXTEscalation reasonstring
esdt:20230602Earliest Service Delivery TimeESDTstring($date-time)
estimatedDuration:20230602Estimated durationinteger($int32)
geolocation.lat: "49.454420"Latitude -> Geolocationnumber($double)
geolocation.lon:"54.031372"Longitude -> Geolocationnumber($double)
hostname:ANYTEXTHostnamestring
id:43621IDinteger($int64)
indications.constantDescription:ANYTEXTConstant description -> Indicationsstring
indications.constantEnumeration:ANYTEXTConstant enumeration -> Indicationsstring
indications.id:146ID - Indicationsinteger($int64)
indications.isCritical:trueCritical -> IndicationsInfo/Alert/Part -> Criticalboolean
indications.isInfo:trueInfo -> IndicationsInfo/Alert/Part -> Infoboolean
indications.isWarning:trueWarning -> IndicationsInfo/Alert/Part -> Warningboolean
interventions.appointments.cancelComment:ANYTEXTCancel comment -> Appointments -> Interventionsstring
interventions.appointments.canceled:trueCanceled -> Appointments -> Interventionsboolean
interventions.appointments.cancelReason:ANYTEXTCancel reason -> Appointments -> Interventionsstring
interventions.appointments.comment:ANYTEXTComment -> Appointments -> Interventionsstring
interventions.appointments.dispatched:trueDispatched -> Appointments -> Interventionsboolean
interventions.appointments.dispatchedFrom:20230602Dispatched from -> Appointments -> Interventionsstring($date-time)
interventions.appointments.dispatchedTo:20230602Dispatched to -> Appointments -> Interventionsstring($date-time)
interventions.appointments.dispatchGroup:ANYTEXTDispatch groups -> Appointments -> Interventionsstring
interventions.appointments.fixedFrom:20230602Fixed from -> Appointments -> Interventionsstring($date-time)
interventions.appointments.fixedTo:20230602Fixed to -> Appointments -> InterventionsFixed to datestring($date-time)
interventions.appointments.id:6743ID -> Appointments -> Interventionsinteger($int64)
interventions.appointments.isFixedResource:trueFixed resource; fixed engineer, fixed technician -> Appointments -> Interventionsboolean
interventions.appointments.locked:trueLocked Appointments -> Appointments -> Interventionsboolean
interventions.appointments.preferredFrom:20230602Preferred from -> Appointments -> Interventionsstring($date-time)
interventions.appointments.preferredTo:20230602Preferred to -> Appointments -> Interventionsstring($date-time)
interventions.appointments.proposedFrom:20230602Proposed from -> Appointments -> Interventionsstring($date-time)
interventions.appointments.proposedTo:20230602Proposed to -> Appointments -> Interventionsstring($date-time)
interventions.appointments.status:ANYTEXTStatus -> Appointments -> Interventionsstring
interventions.appointments.undispatched:trueUndispatched -> Appointments -> Interventionsboolean
interventions.appointments.undispatchedV2:trueUndispatched V2 -> Appointments -> Interventionsboolean
interventions.appointments.userId:ANYTEXTUser ID -> Appointments -> Interventionsstring
interventions.appointments.userName:ANYTEXTUser name -> Appointments -> Interventionsstring
interventions.durations.duration:20230602Duration -> Durations -> Interventionsstring($date-time)
interventions.durations.end:20230602End -> Durations -> Interventionsstring($date-time)
interventions.durations.start:20230602Start -> Durations -> Interventionsstring($date-time)
interventions.durations.type:20230602Type -> Durations -> Interventionsstring($date-time)
interventions.id:235425ID -> Interventionsinteger($int64)
interventions.lsdtMiss:trueLSDT miss -> Interventionsboolean
interventions.reportingSuccessful:trueReporting successful -> Interventionsboolean
interventions.reportingUserId:ANYTEXTReporting user ID -> Interventionsstring
interventions.reportingUserName:ANYTEXTReporting user name -> Interventionsstring
interventions.reportingWorkNote:ANYTEXTReporting work note -> Interventionsstring
inWarranty:trueIn warrantyboolean
isInfoInProgress:trueInfo -> In Progressboolean
items.condition:ANYTEXTCondition -> Partsstring
items.currentShipping.addressNote:ANYTEXTAddress note -> Current shipping -> Partsstring
items.currentShipping.city:ANYTEXTCity -> Current shipping -> Partsstring
items.currentShipping.comment:ANYTEXTComment -> Current shipping -> Partsstring
items.currentShipping.company:ANYTEXTCompany -> Current shipping -> Partsstring
items.currentShipping.country:ANYTEXTCountry -> Current shipping -> Partsstring
items.currentShipping.countryCode:ANYTEXTCountry code -> Current shipping -> Partsstring
items.currentShipping.deliveryServiceUrl:ANYTEXTDelivery service URL -> Current shipping -> Partsstring
items.currentShipping.deliveryType:ANYTEXTDelivery typestring
items.currentShipping.estimatedDate:20230602Estimated date -> Current shipping -> Partsstring($date-time)
items.currentShipping.id:ANYTEXTID -> Current shipping -> Partsstring
items.currentShipping.notReceivedBy:ANYTEXTReceived by -> Current shipping -> Partsstring
items.currentShipping.notReceivedDate:20230602Not received date -> Current shipping -> Partsstring($date-time)
items.currentShipping.notReceivedReason:ANYTEXTNot received reason -> Current shipping -> Partsstring
items.currentShipping.pudo:ANYTEXTPUDO -> Current shipping -> Partsstring
items.currentShipping.receivedBy:ANYTEXTReceived by -> Current shipping -> Partsstring
items.currentShipping.receivedDate:20230602Received date -> Current shipping -> Partsstring($date-time)
items.currentShipping.returnedBy:ANYTEXTReturned by -> Current shipping -> Partsstring
items.currentShipping.returnedDate:20230602Returned date -> Current shipping -> Partsstring($date-time)
items.currentShipping.shipped:trueShipped -> Current shipping -> Partsboolean
items.currentShipping.shippingDate:20230602Shipping date -> Current shipping -> Partsstring($date-time)
items.currentShipping.shippingPartner:ANYTEXTShipping partner -> Current shipping -> Partsstring
items.currentShipping.shippmentCondition:ANYTEXTShipment condition -> Current shipping -> Partsstring
items.currentShipping.startingDate:20230602Starting date -> Current shipping -> Partsstring($date-time)
items.currentShipping.state:ANYTEXTState -> Current shipping -> Partsstring
items.currentShipping.street:ANYTEXTStreet -> Current shipping -> Partsstring
items.currentShipping.streetNumber:ANYTEXTStreet number -> Current shipping -> Partsstring
items.currentShipping.trackingCode:ANYTEXTTracking code -> Current shipping -> Partsstring
items.currentShipping.zip:ANYTEXTZIP -> Current shipping -> Partsstring
items.description:ANYTEXTDescription -> Partsstring
items.entryId:ANYTEXTEntry ID -> Partsstring
items.externalStatus:ANYTEXTExternal status -> Partsstring
items.failureCode:ANYTEXTFailure code -> Partsstring
items.id:ANYTEXTID -> Partsstring
items.manufacturer:ANYTEXTManufacturer -> Partsstring
items.name:ANYTEXTName -> Partsstring
items.orderNumber:ANYTEXTOrder number -> Partsstring
items.orderNumberLineItem:ANYTEXTOrder number line item -> Partsstring
items.partNumber:ANYTEXTPart number -> Partsstring
items.quantity:5Quantity;Sum,Total -> Partsinteger($int32)
items.reference:ANYTEXTReference -> Partsstring
items.replacedSerial:ANYTEXTReplaced serial -> Partsstring
items.serial:ANYTEXTSerial -> Partsstring
items.status:ANYTEXTStatus -> Partsstring
items.type:ANYTEXTType -> Partsstring
items.usage:ANYTEXTUsage -> Partsstring
lsdt:20230602Latest Service Delivery TimeLSDTstring($date-time)
mac:ANYTEXTMacstring
manufacturerName:ANYTEXTManufacturer namestring
model:"MacBook Air M2"ModelDevicestring
multiUndispatched:trueMulti undispatchedboolean
note:ANYTEXTNotestring
os:ANYTEXTOSstring
outsourced:trueOutsourced; Partnerboolean
outSourcingName:ANYTEXTOutsourcing namestring
outsourcingType:ANYTEXTOutsourcing typestring
outsourcingValue:ANYTEXTOutsourcing valuestring
partner:ANYTEXTPartnerstring
partnerName:"Dubbing brothers"Partner namePartner namestring
priority:2Priorityinteger($int32)
productLine:ANYTEXTProduct linestring
project:"MyFirstProject"ProjectProjectstring
projectId:2Project IDinteger($int32)
score:97ScoreScorestring
serial:ANYTEXTSerialstring
serialProvided:ANYTEXTSerial providedstring
shortDescription:ANYTEXTShort descriptionstring
skills.id:ANYTEXTID -> Skillsstring
skills.level:1Level -> Skillsinteger($int64)
skills.name:ANYTEXTName -> Skillsstring
skills.weight:3Weight -> Skillsnumber($double)
sla:ANYTEXTSLASLAstring
slaEnumeration:ANYTEXTSLA enumerationstring
specificationReference:ANYTEXTSpecification referencestring
status:"PENDING WAIT ONSITE"StatusStatusstring
subCategory:StandardSubcategorySubcategorystring
supplier:ANYTEXTSupplierstring
type:ANYTEXTTypestring
userId:ANYTEXTUser IDstring
userName:"Ralph Smuthers"User nameGrabbed bystring
vip:trueVIPInfo/Alert/Part -> VIPboolean
warrantyType:ANYTEXTWarranty typestring
wrongSerialProvided:trueWrong serial providedboolean
Was this article helpful?
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Table of Contents