[{"data":1,"prerenderedAt":437},["ShallowReactive",2],{"blog-custom-fields-in-open-audit":3,"authors":286},{"id":4,"title":5,"author":6,"body":7,"categories":268,"category":269,"date":270,"description":271,"extension":272,"featured":273,"fields":268,"image":274,"keyTakeaways":268,"meta":275,"modified":268,"navigation":34,"path":276,"seo":277,"slug":278,"stem":279,"tags":280,"__hash__":285},"blog\u002Fblog\u002Fcustom-fields-in-open-audit.md","Custom Fields in Open-AudIT","Luke Richardson",{"type":8,"value":9,"toc":261},"minimark",[10,15,19,22,25,35,39,42,46,53,56,59,63,69,72,75,78,89,92,95,157,160,242,246,257],[11,12,14],"h2",{"id":13},"introduction","Introduction",[16,17,18],"p",{},"Adding fields that are specific to your requirements is an extremely simple process with Open-AudIT. You can then populate these fields with whatever data you would like recorded. Asset Numbers, Cost Codes, specific attributes, etc.",[16,20,21],{},"Fields can be one of two types. A freeform text field or a selectable list of values. A log is kept of any changes to a field – when it was changed, what it previously was and who changed it.",[16,23,24],{},"We have a quick video showing this process, here:",[26,27],"iframe",{"width":28,"height":29,"src":30,"title":31,"frameBorder":32,"allow":33,"allowFullScreen":34},560,315,"https:\u002F\u002Fwww.youtube.com\u002Fembed\u002F_r8B9FiEAnk","YouTube video player","0","accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture",true,[11,36,38],{"id":37},"community-requests","Community Requests",[16,40,41],{},"As always, if you have a field that is not already in Open-AudIT and you think would be useful to the community at large, please do send us your idea. We're only too happy to incorporate new fields into Open-AudIT when the community requests them.",[11,43,45],{"id":44},"the-gui","The GUI",[16,47,48],{},[49,50],"img",{"alt":51,"src":52},"Open-AudIT GUI feature view","\u002Fimages\u002Fblog\u002FOpen-AudIT-features1.png",[16,54,55],{},"Creating a field is simply a matter of menu -> Manage -> Fields -> Create Fields. Provide it with a name (as a minimum) and you're done. Easy! Now the field will appear on the Device Details pages.",[16,57,58],{},"You can change the type to either a text field or a list of predefined values.",[11,60,62],{"id":61},"the-api","The API",[16,64,65],{},[49,66],{"alt":67,"src":68},"Open-AudIT admin user management screen","\u002Fimages\u002Fblog\u002FUser-Admin-Open-AudIT-650.png",[16,70,71],{},"As with all collections within Open-AudIT, fields are also accessible via the JSON API. Simply send a GET request to \u002Ffields for a list. The standard POST, DELETE and PATCH requests also work as expected.",[16,73,74],{},"More specific details are available on the Open-AudIT wiki, Fields.",[16,76,77],{},"Updating the value of a device's custom field is also available via the API. Send a PATCH to \u002Fdevices\u002F{id} with a JSON formatted, URL encoded payload of data.",[79,80,85],"pre",{"className":81,"code":83,"language":84},[82],"language-text","data=%7B%22data%22%3A%7B%22id%22%3A%221%22%2C%22type%22%3A%22devices%22%2C%22attributes\n%22%3A%7B%22My+select+field%22%3A%226%22%7D%7D%7D\n","text",[86,87,83],"code",{"__ignoreMap":88},"",[16,90,91],{},"An example of the JSON formatted, URL encoded data payload is below. In this instance, we are changing the value of \"My select field\" for device #1.",[16,93,94],{},"When it's not URL encoded, it looks thus:",[79,96,100],{"className":97,"code":98,"language":99,"meta":88,"style":88},"language-json shiki shiki-themes github-light github-dark","{\"data\":{\"id\":\"1\",\"type\":\"devices\",\"attributes\":{\"My select field\":\"6\"}}}\n","json",[86,101,102],{"__ignoreMap":88},[103,104,107,111,115,118,121,124,128,131,134,136,139,141,144,146,149,151,154],"span",{"class":105,"line":106},"line",1,[103,108,110],{"class":109},"sVt8B","{",[103,112,114],{"class":113},"sj4cs","\"data\"",[103,116,117],{"class":109},":{",[103,119,120],{"class":113},"\"id\"",[103,122,123],{"class":109},":",[103,125,127],{"class":126},"sZZnC","\"1\"",[103,129,130],{"class":109},",",[103,132,133],{"class":113},"\"type\"",[103,135,123],{"class":109},[103,137,138],{"class":126},"\"devices\"",[103,140,130],{"class":109},[103,142,143],{"class":113},"\"attributes\"",[103,145,117],{"class":109},[103,147,148],{"class":113},"\"My select field\"",[103,150,123],{"class":109},[103,152,153],{"class":126},"\"6\"",[103,155,156],{"class":109},"}}}\n",[16,158,159],{},"And nicely formatted for human consumption, it looks thus:",[79,161,163],{"className":97,"code":162,"language":99,"meta":88,"style":88},"{\n    \"data\": {\n        \"id\": \"1\",\n        \"type\": \"devices\",\n        \"attributes\": {\n            \"My select field\": \"6\"\n        }\n    }\n}\n",[86,164,165,170,179,193,205,213,224,230,236],{"__ignoreMap":88},[103,166,167],{"class":105,"line":106},[103,168,169],{"class":109},"{\n",[103,171,173,176],{"class":105,"line":172},2,[103,174,175],{"class":113},"    \"data\"",[103,177,178],{"class":109},": {\n",[103,180,182,185,188,190],{"class":105,"line":181},3,[103,183,184],{"class":113},"        \"id\"",[103,186,187],{"class":109},": ",[103,189,127],{"class":126},[103,191,192],{"class":109},",\n",[103,194,196,199,201,203],{"class":105,"line":195},4,[103,197,198],{"class":113},"        \"type\"",[103,200,187],{"class":109},[103,202,138],{"class":126},[103,204,192],{"class":109},[103,206,208,211],{"class":105,"line":207},5,[103,209,210],{"class":113},"        \"attributes\"",[103,212,178],{"class":109},[103,214,216,219,221],{"class":105,"line":215},6,[103,217,218],{"class":113},"            \"My select field\"",[103,220,187],{"class":109},[103,222,223],{"class":126},"\"6\"\n",[103,225,227],{"class":105,"line":226},7,[103,228,229],{"class":109},"        }\n",[103,231,233],{"class":105,"line":232},8,[103,234,235],{"class":109},"    }\n",[103,237,239],{"class":105,"line":238},9,[103,240,241],{"class":109},"}\n",[11,243,245],{"id":244},"related-reading","Related reading",[247,248,249],"ul",{},[250,251,252],"li",{},[253,254,256],"a",{"href":255},"\u002Fblog\u002Ffinding-devices-with-custom-queries-in-open-audit\u002F","Finding Devices with Custom Queries in Open-AudIT",[258,259,260],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":88,"searchDepth":172,"depth":172,"links":262},[263,264,265,266,267],{"id":13,"depth":172,"text":14},{"id":37,"depth":172,"text":38},{"id":44,"depth":172,"text":45},{"id":61,"depth":172,"text":62},{"id":244,"depth":172,"text":245},null,"Open-AudIT","2017-10-06","How to create and manage custom fields in Open-AudIT to store additional device attributes like asset numbers, cost codes, and more.","md",false,"\u002Fimages\u002Fblog\u002Fopen-audit-detailed-device.png",{},"\u002Fblog\u002Fcustom-fields-in-open-audit",{"title":5,"description":271},"custom-fields-in-open-audit","blog\u002Fcustom-fields-in-open-audit",[281,282,283,284],"open-audit","custom fields","api","how-to","IXouAaqCZt-BwmQk16v56oR6AUIlj8FARQwOSHL-Daw",[287,300,313,330,343,356,377,390,403,424],{"id":288,"title":289,"aliases":268,"avatar":268,"body":290,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":294,"navigation":34,"path":295,"role":268,"seo":296,"slug":297,"stem":298,"tagline":268,"__hash__":299},"authors\u002Fauthors\u002Fchris-jacko.md","Chris Jacko",{"type":8,"value":291,"toc":292},[],{"title":88,"searchDepth":172,"depth":172,"links":293},[],{},"\u002Fauthors\u002Fchris-jacko",{"title":289,"description":88},"chris-jacko","authors\u002Fchris-jacko","-5nEsaQsigkcWpKzYAqcAMNdd5X_63lHLFxBErQh-BY",{"id":301,"title":302,"aliases":268,"avatar":268,"body":303,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":307,"navigation":34,"path":308,"role":268,"seo":309,"slug":310,"stem":311,"tagline":268,"__hash__":312},"authors\u002Fauthors\u002Fdamian-fielke.md","Damian Fielke",{"type":8,"value":304,"toc":305},[],{"title":88,"searchDepth":172,"depth":172,"links":306},[],{},"\u002Fauthors\u002Fdamian-fielke",{"title":302,"description":88},"damian-fielke","authors\u002Fdamian-fielke","3PEJAVsJcgwSNJ1JITFFtKm4oEaNBZtPdNswW2VTo9U",{"id":314,"title":315,"aliases":316,"avatar":318,"body":319,"description":88,"extension":272,"inactive":273,"kind":323,"links":268,"meta":324,"navigation":34,"path":325,"role":268,"seo":326,"slug":327,"stem":328,"tagline":268,"__hash__":329},"authors\u002Fauthors\u002Ffirstwave-team.md","FirstWave Team",[317],"FirstWave","\u002Fbrand-assets\u002Flogos\u002Ffirstwave\u002Ffirstwave-logo-400x400.png",{"type":8,"value":320,"toc":321},[],{"title":88,"searchDepth":172,"depth":172,"links":322},[],"organization",{},"\u002Fauthors\u002Ffirstwave-team",{"title":315,"description":88},"firstwave-team","authors\u002Ffirstwave-team","Bo2R0Jf6KPnxzN8ZkUNQCgcXInERWo9t7QcDaVG10KA",{"id":331,"title":332,"aliases":268,"avatar":268,"body":333,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":337,"navigation":34,"path":338,"role":268,"seo":339,"slug":340,"stem":341,"tagline":268,"__hash__":342},"authors\u002Fauthors\u002Fjames-banks.md","James Banks",{"type":8,"value":334,"toc":335},[],{"title":88,"searchDepth":172,"depth":172,"links":336},[],{},"\u002Fauthors\u002Fjames-banks",{"title":332,"description":88},"james-banks","authors\u002Fjames-banks","XUyPfpVxtEsDafIwYwj83M5KT5uOLkuxhJVUkSPy2co",{"id":344,"title":345,"aliases":268,"avatar":268,"body":346,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":350,"navigation":34,"path":351,"role":268,"seo":352,"slug":353,"stem":354,"tagline":268,"__hash__":355},"authors\u002Fauthors\u002Fjessica-hall.md","Jessica Hall",{"type":8,"value":347,"toc":348},[],{"title":88,"searchDepth":172,"depth":172,"links":349},[],{},"\u002Fauthors\u002Fjessica-hall",{"title":345,"description":88},"jessica-hall","authors\u002Fjessica-hall","WdFYsoJ1la6mKj2UVtjze0aJqOHikzY7rSnpgFXg65k",{"id":357,"title":6,"aliases":268,"avatar":358,"body":359,"description":363,"extension":272,"inactive":273,"kind":268,"links":366,"meta":369,"navigation":34,"path":370,"role":371,"seo":372,"slug":373,"stem":374,"tagline":375,"__hash__":376},"authors\u002Fauthors\u002Fluke-richardson.md","\u002Fimages\u002Fteam\u002Fluke-richardson.jpeg",{"type":8,"value":360,"toc":364},[361],[16,362,363],{},"My focus is on building systems, automations, and highlighting ways FirstWave products can solve the everyday IT Networking nerd.",{"title":88,"searchDepth":172,"depth":172,"links":365},[],{"linkedin":367,"github":368},"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Flukedrichardson\u002F","https:\u002F\u002Fgithub.com\u002Fluker-rgb\u002F",{},"\u002Fauthors\u002Fluke-richardson","Head of Marketing",{"title":6,"description":363},"luke-richardson","authors\u002Fluke-richardson","Can't see the woods amongst the trees without Open-AudIT","SZylsD9NCkjp2XdGUuI55Nj2PnQ8OtAWNJGjWvTrigE",{"id":378,"title":379,"aliases":268,"avatar":268,"body":380,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":384,"navigation":34,"path":385,"role":268,"seo":386,"slug":387,"stem":388,"tagline":268,"__hash__":389},"authors\u002Fauthors\u002Folivia-gribben.md","Olivia Gribben",{"type":8,"value":381,"toc":382},[],{"title":88,"searchDepth":172,"depth":172,"links":383},[],{},"\u002Fauthors\u002Folivia-gribben",{"title":379,"description":88},"olivia-gribben","authors\u002Folivia-gribben","ZSnPtTAye23G8U1Q9gebwWVfVX_tO5E2Mf6D5FfIxEk",{"id":391,"title":392,"aliases":268,"avatar":268,"body":393,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":397,"navigation":34,"path":398,"role":268,"seo":399,"slug":400,"stem":401,"tagline":268,"__hash__":402},"authors\u002Fauthors\u002Fsarah-lispet.md","Sarah Lispet",{"type":8,"value":394,"toc":395},[],{"title":88,"searchDepth":172,"depth":172,"links":396},[],{},"\u002Fauthors\u002Fsarah-lispet",{"title":392,"description":88},"sarah-lispet","authors\u002Fsarah-lispet","E955cfPrBH-u0nNKbJ-DdAAUhA1JST-Go0EODcGv9LY",{"id":404,"title":405,"aliases":268,"avatar":406,"body":407,"description":411,"extension":272,"inactive":273,"kind":268,"links":414,"meta":416,"navigation":34,"path":417,"role":418,"seo":419,"slug":420,"stem":421,"tagline":422,"__hash__":423},"authors\u002Fauthors\u002Fsharon-hunneybell.md","Sharon Hunneybell","\u002Fimages\u002Fteam\u002Fsharon-hunneybell.png",{"type":8,"value":408,"toc":412},[409],[16,410,411],{},"Over 20 years of experience as a technology leader. Recognised by the AFR as one of Australia's Top 100 Women of Influence in Technology and Innovation. Industry Fellow at Griffith University.",{"title":88,"searchDepth":172,"depth":172,"links":413},[],{"linkedin":415},"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fsharonhunneybell\u002F",{},"\u002Fauthors\u002Fsharon-hunneybell","VP of Products",{"title":405,"description":411},"sharon-hunneybell","authors\u002Fsharon-hunneybell","Technology leader with over 20 years in the industry, and an Industry Fellow at Griffith University.","tlbya__xxsO4vAF3WX8gNdnlgdxP-NuSHGQSKO1Zhgs",{"id":425,"title":426,"aliases":268,"avatar":268,"body":427,"description":88,"extension":272,"inactive":273,"kind":268,"links":268,"meta":431,"navigation":34,"path":432,"role":268,"seo":433,"slug":434,"stem":435,"tagline":268,"__hash__":436},"authors\u002Fauthors\u002Fsimon-may.md","Simon May",{"type":8,"value":428,"toc":429},[],{"title":88,"searchDepth":172,"depth":172,"links":430},[],{},"\u002Fauthors\u002Fsimon-may",{"title":426,"description":88},"simon-may","authors\u002Fsimon-may","0in6dS2PIxCquqjG_2uCTM8PAw3O1xyMGHfcNRgCm8w",1788507217275]