Skip to main content

Text attribute

Store a string of text​

A Text attribute can store a single text string containing any number of characters.

Configuration​

When adding or editing a Text attribute on a design/interface, you can configure the following properties. These determine how the attribute will behave when users populate its value on corresponding items.

  • Code (read-only) - the attribute's Global Unique Code (Guc) identifier.
  • Name * - enter a distinct name that clearly identifies the attribute.
  • Description - describe what the attribute represents and how it's intended to be used. This helps users and AI agents to understand its purpose.
  • Required - if enabled, the attribute must be populated before an item can be saved. It can't be left blank!
  • Read-only - if enabled, the attribute can only be populated when creating items. It can't be edited afterwards!
  • Unique - if enabled, the attribute only accepts values that aren't already stored in other items of the design/interface.
  • Default value - the attribute is automatically populated with this value. It can usually be changed before saving, unless the attribute is also Read-only or excluded from an item form.

  • Min length - the attribute won't accept text with fewer characters than this. If left blank, this is effectively zero.

  • Max length - the attribute won't accept text with more characters than this. If left blank, text is only constrained by database limitations (roughly 16 million characters).

  • Regular expression - the attribute will only accept text that matches the supplied regular expression, e.g. to block special characters, enter ^[A-Za-z0-9\., ]+$

  • Searchable - if disabled, the attribute will be excluded from all searches and AQS queries. Useful for storing sensitive data!

    Important

    This can only be disabled when adding the attribute. It can't be edited afterwards.

  • Tags - use the Tag Manager to assign custom tags or a relevant system tag.

    Available system tags

    Treat the attribute as:

    • Barcode - the value is rendered as a scannable barcode in Alloy Mobile.

    • Colour - a hexadecimal colour code, e.g. #df412c .

    • Collection - an item collection.

    • DodiCode - the Global Unique Code (Guc) of a design or interface, e.g. designs_taskStatuses, designInterfaces_assets.

    • Email - an email address.

    • FeatureCode - an Asset Management feature code, e.g. workflows_closeProject.

    • Icon - an icon library code, e.g. icon-element-fire .

    • Image - a URL to an image. If valid, the image is displayed.

    • MeshCode - the Global Unique Code (Guc) of an integration endpoint used to push or pull data, e.g. meshes_telensaFaultPushAlloy.

    • Phone - a phone number.

    • ReportDodiCode - the Global Unique Code (Guc) of a runnable report design, e.g. designs_jobTicketReport.

    • Svg - the SVG markup of a graphic. If valid, the graphic is displayed.

      Example
      <svg width="536" height="115" viewBox="0 0 536 115" fill="none" xmlns="http://www.w3.org/2000/svg">
        <path
          d="M511.999 73.5593L501.819 46.7793H487.799L505.409 85.9993C503.239 91.1693 499.989 99.0193 493.399 99.0193C489.979 99.0193 486.809 97.9293 484.139 96.0993L479.799 105.859C484.049 108.779 489.139 110.029 493.069 110.029C510.259 110.029 514.679 95.3393 518.519 86.3293L535.869 46.7793H522.189L511.999 73.5593ZM459.459 90.4993C465.799 90.4993 471.059 87.7493 474.229 83.7393V89.5793H486.659V64.7193C486.659 57.1293 484.069 45.8593 466.049 45.8593C459.879 45.8593 452.279 47.2793 447.029 52.5293L451.619 60.3693C457.629 55.8593 463.799 56.2793 465.299 56.2793C468.389 56.2793 474.229 58.4493 474.229 63.4593V64.6293C469.889 63.3793 466.389 62.7893 462.469 62.7893C451.869 62.7893 444.279 68.2993 444.279 76.3093C444.279 85.7393 452.119 90.4993 459.459 90.4993ZM464.889 69.8893C467.639 69.8893 471.059 70.4693 474.479 71.5593V76.1493C471.389 78.8993 468.219 80.7393 462.799 80.7393C458.709 80.7393 456.879 78.0693 456.879 75.9793C456.879 73.6393 458.299 69.8893 464.889 69.8893ZM398.539 72.5593L391.109 46.7793H377.429L380.769 56.5393L392.699 89.5793H403.299L410.639 65.2993L417.979 89.5793H428.579L440.509 56.5393L443.849 46.7793H430.169L422.739 72.5593L414.979 47.9493H406.299L398.539 72.5593ZM368.739 75.2293C365.739 78.0693 361.309 80.3193 356.889 80.3193C348.959 80.3193 344.039 76.3993 343.789 71.0593H378.249C378.249 54.0393 366.899 45.8593 355.049 45.8593C341.279 45.8593 331.439 55.7893 331.439 68.3893C331.439 80.5693 340.119 90.4993 355.969 90.4993C361.729 90.4993 369.819 88.7493 375.909 82.0693L368.739 75.2293ZM354.889 55.9493C359.059 55.9493 364.649 58.0393 365.489 63.5393H344.049C345.539 57.7893 350.879 55.9493 354.889 55.9493ZM293.269 79.5693C296.189 88.4993 304.869 90.4993 311.209 90.4993C320.639 90.4993 328.729 85.9993 328.729 77.2293C328.729 74.3893 327.809 67.7993 317.719 64.8793L311.299 62.3793C309.129 61.5493 307.289 60.5393 307.289 58.7093C307.289 56.5393 309.709 55.2093 312.049 55.2093C313.969 55.2093 317.059 55.8793 318.139 59.2993L327.739 54.8793C323.729 47.1993 317.229 45.8693 312.299 45.8693C303.119 45.8693 295.529 50.3693 295.529 58.9693C295.529 60.8893 296.029 67.6493 306.209 71.2293L313.719 74.3993C316.059 75.2293 316.889 76.2393 316.889 77.6493C316.889 79.8193 314.049 80.8993 311.299 80.8993C307.879 80.8993 303.539 79.3993 302.289 74.4793L293.269 79.5693ZM288.169 46.7793H275.739V69.7193C275.739 75.6393 273.319 80.2293 267.559 80.2293C261.799 80.2293 259.629 75.7193 259.629 69.7993V46.7793H247.199V70.0593C247.199 80.9093 250.449 90.4993 262.469 90.4993C267.639 90.4993 272.149 88.7493 275.739 83.7393V89.5793H288.169V46.7793ZM212.379 90.4993C218.719 90.4993 223.979 87.7493 227.149 83.7393V89.5793H239.579V64.7193C239.579 57.1293 236.989 45.8593 218.969 45.8593C212.799 45.8593 205.199 47.2793 199.949 52.5293L204.539 60.3693C210.549 55.8593 216.719 56.2793 218.219 56.2793C221.309 56.2793 227.149 58.4493 227.149 63.4593V64.6293C222.809 63.3793 219.309 62.7893 215.389 62.7893C204.789 62.7893 197.199 68.2993 197.199 76.3093C197.189 85.7393 205.039 90.4993 212.379 90.4993ZM217.799 69.8893C220.549 69.8893 223.969 70.4693 227.389 71.5593V76.1493C224.299 78.8993 221.129 80.7393 215.709 80.7393C211.619 80.7393 209.789 78.0693 209.789 75.9793C209.789 73.6393 211.209 69.8893 217.799 69.8893ZM141.579 60.3793C141.579 76.6493 153.849 90.4993 173.619 90.4993C182.709 90.4993 188.639 87.5793 194.559 83.1593L189.219 73.3093C184.959 76.5593 180.289 78.9793 173.699 78.9793C161.849 78.9793 154.679 70.7993 154.679 60.3693C154.679 49.9393 161.859 41.7593 173.699 41.7593C180.289 41.7593 184.959 44.1793 189.219 47.4293L194.559 37.5793C188.639 33.1593 182.709 30.2393 173.619 30.2393C153.849 30.2593 141.579 44.1093 141.579 60.3793Z"
          fill="#31135E"
        />
        <path d="M61.4998 47.2991C60.8798 47.7491 59.8698 47.7491 59.2598 47.2991L43.0098 35.4891L59.2598 23.6891C59.8798 23.2391 60.8898 23.2391 61.4998 23.6891L77.7498 35.4891L61.4998 47.2991Z" fill="#F87A63" />
        <path d="M42.8895 12.1895C42.2695 12.6395 41.7695 13.6295 41.7695 14.3895V32.0095L57.4895 20.5895C58.1095 20.1395 58.6095 19.1495 58.6095 18.3895V0.769531L42.8895 12.1895Z" fill="#F87A63" />
        <path d="M78.9992 32.0095V30.6195V14.3895C78.9992 13.6295 78.4892 12.6395 77.8792 12.1895L62.1592 0.769531V18.3895C62.1592 19.1495 62.6692 20.1395 63.2792 20.5895L78.9992 32.0095Z" fill="#F87A63" />
        <path d="M39.7097 37.8896L23.4597 49.6996C22.8397 50.1496 22.5297 51.1097 22.7697 51.8297L28.9797 70.9296L45.2297 59.1296C45.8497 58.6796 46.1597 57.7196 45.9197 56.9996L39.7097 37.8896Z" fill="#B86BB2" />
        <path d="M36.7791 35.6297L20.0191 30.1897C19.2991 29.9497 18.1991 30.1297 17.5791 30.5797L1.86914 41.9897L18.6191 47.4297C19.3391 47.6697 20.4391 47.4897 21.0591 47.0397L36.7791 35.6297Z" fill="#B86BB2" />
        <path d="M30.2393 74.8096L36.4493 93.9096C36.6893 94.6296 37.4993 95.2296 38.2693 95.2296H58.3493L52.1393 76.1296C51.8993 75.4096 51.0893 74.8096 50.3293 74.8096H30.2393Z" fill="#957DFF" />
        <path d="M44.7396 114.159C45.4996 114.159 46.4896 113.649 46.9396 113.039L57.2896 98.7891H37.8596C37.0996 98.7891 36.1096 99.2891 35.6596 99.9091L25.3096 114.159H44.7396Z" fill="#957DFF" />
        <path d="M27.1794 76.8994L16.8194 91.1494C16.3694 91.7694 16.1994 92.8594 16.4294 93.5894L22.4294 112.069L32.7894 97.8194C33.2394 97.1994 33.4094 96.1094 33.1794 95.3794L27.1794 76.8994Z" fill="#957DFF" />
        <path d="M62.4199 95.2296H82.4999C83.2599 95.2296 84.0799 94.6396 84.3199 93.9096L90.5299 74.8096H70.4499C69.6899 74.8096 68.8699 75.3996 68.6299 76.1296L62.4199 95.2296Z" fill="#40A6D9" />
        <path d="M104.32 93.5894C104.56 92.8694 104.38 91.7694 103.93 91.1494L93.5695 76.8994L87.5695 95.3794C87.3295 96.0994 87.5095 97.1994 87.9595 97.8194L98.3195 112.069L104.32 93.5894Z" fill="#40A6D9" />
        <path d="M63.46 98.7793L73.82 113.029C74.27 113.649 75.26 114.149 76.02 114.149H95.45L85.09 99.8993C84.64 99.2793 83.65 98.7793 82.89 98.7793H63.46Z" fill="#40A6D9" />
        <path d="M91.7896 70.9296L97.9996 51.8297C98.2396 51.0997 97.9196 50.1396 97.3096 49.6996L81.0596 37.8896L74.8496 56.9896C74.6096 57.7196 74.9296 58.6797 75.5396 59.1197L91.7896 70.9296Z" fill="#03CF9E" />
        <path d="M103.179 30.5792C102.559 30.1292 101.469 29.9592 100.739 30.1892L83.9893 35.6292L99.7093 47.0492C100.329 47.4992 101.419 47.6692 102.149 47.4392L118.909 41.9992L103.179 30.5792Z" fill="#03CF9E" />
        <path d="M95.4893 71.0391L112.249 65.5991C112.969 65.3591 113.759 64.5791 113.999 63.8491L119.569 46.6891L119.999 45.3691L103.249 50.8091C102.529 51.0491 101.739 51.8291 101.499 52.5591L95.4893 71.0391Z" fill="#03CF9E" />
        <path d="M6.76953 63.8491C7.00953 64.5691 7.78953 65.3591 8.51953 65.5991L25.2695 71.0391L19.2695 52.5591C19.0295 51.8291 18.2495 51.0491 17.5195 50.8091L0.769531 45.3691L6.76953 63.8491Z" fill="#B86BB2" />
      </svg>

    • Url - a URL to a website. Users can select Open to view the website in a new browser tab.

    • Username - an Asset Management username.

    • RequiredOnTaskStatus[Completed/Cancelled] - only relevant if the design/interface implements the Tasks interface. The attribute becomes required when a task's status changes to Completed or Cancelled.

    • ActionParameter[Dynamic] - for internal use only. Marks the attribute as a configurable parameter on a workflow action.

  • AQS agent enabled - if disabled, the attribute is excluded from AI agent queries.

Populate the attribute on items​

When creating or editing an item, select the attribute to start typing in it. Enter or paste in text that meets the configured restrictions.

A Text attribute field

If a system tag is assigned to the attribute, a picker may appear to let you choose a value instead, e.g. if the "FeatureCode" tag is assigned, use the picker to browse the available features by category.

The feature picker for a FeatureCode-tagged Text attribute, showing categories to browse