<h2>Submit Catalog Item Request action</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2024" /><meta name="DC.rights.owner" content="(C) Copyright 2024" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="reference" /><meta name="DC.title" content="Submit Catalog Item Request action" /><meta name="abstract" content="Create a requested item [sc_req_item] on a Service Catalog Request [sc_request]." /><meta name="description" content="Create a requested item [sc_req_item] on a Service Catalog Request [sc_request]." /><meta name="DC.relation" scheme="URI" content="../../../administer/flow-designer/concept/flow-actions.html" /><meta name="DC.relation" scheme="URI" content="../../../build/custom-application/reference/r_CustomApplicationDevelopment.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/automation-engine/concept/automation-engine-overview.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/flow-designer/concept/flow-designer.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/flow-designer/reference/flow-designer-reference.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2022-08-04" /><meta name="DC.date.modified" content="2022-08-04" /><meta name="page-type" content="automation-engine" /><meta name="page-type" content="platform" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="submit-catalog-item-request-flow-designer" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Submit Catalog Item Request action</title></head><body id="submit-catalog-item-request-flow-designer"> <div class="breadcrumb"><a class="link" href="../../../build/custom-application/reference/r_CustomApplicationDevelopment.html" title="The Now Platform provides a single mobile and web application development platform to build business applications and extend existing apps that power your digital transformation.">Hyperautomation and Low-Code</a> > <a class="link" href="../../../administer/automation-engine/concept/automation-engine-overview.html" title="Create integrations and connections across multiple systems. Quickly connect with third-party applications, build your own custom integrations, and automate repetitive tasks and document processing. Govern your end-to-end multi-vendor automation life cycles from one place.">Automate your workflow</a> > <a class="link" href="../../../administer/flow-designer/concept/flow-designer.html" title="Flow Designer is a Now Platform feature that enables process owners to automate work. Build multi-step flows from reusable components without having to code.">Flow Designer</a> > <a class="link" href="../../../administer/flow-designer/reference/flow-designer-reference.html" title="Get details about Flow Designer components like actions, flow logic, and properties.">Flow Designer reference</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">Submit Catalog Item Request action</h1> <div class="body refbody"><p class="shortdesc"><span class="ph">Create a requested item [sc_req_item] on a <span class="ph">Service Catalog</span> Request [sc_request].</span></p> <div class="section" id="submit-catalog-item-request-flow-designer__section_e1d_ggn_tkb"><h2 class="title sectiontitle">Roles and availability</h2> <p class="p"><span class="ph">Available as a <span class="ph">Flow Designer</span> <span class="ph">ServiceNow</span> core action. Users with the flow_designer or admin role can add an action to a flow and define configuration details.</span></p> </div> <div class="section" id="submit-catalog-item-request-flow-designer__section_imr_chn_tkb"><h2 class="title sectiontitle">Inputs</h2> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="submit-catalog-item-request-flow-designer__table_n5q_qhn_tkb" class="table" frame="border" border="1" rules="all"><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d947208e78">Input</th><th class="entry cellrowborder" style="vertical-align:top;" id="d947208e81">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Catalog Item</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 "><p class="p">Name of the requested catalog item.</p> <p class="p">Extra inputs may be added dynamically, depending on which catalog item is selected. For example, when the requested catalog item is a new email account, a field for <span class="ph uicontrol">Preferred Email address</span> appears.</p> <div class="note"><span class="notetitle">Note:</span> The following Service Catalog variable types are not supported.<ul class="ul" id="submit-catalog-item-request-flow-designer__ul_wsx_dpv_4qb"><li class="li">list collector</li><li class="li">lookup multiple choice</li><li class="li">lookup select box</li></ul> </div> </td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Quantity</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">Number of items requested.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Special Instructions</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">Text describing any special instructions about the item request.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Delivery Address</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">Location where the requested item should be delivered.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Requested for</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">User that the item is requested for.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Don't fail on error</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">Option to determine whether to fail the flow if the action produces an error.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Wait for Completion</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 ">Option to force the flow to wait until the action has been completed before continuing.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Enable timeout</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 "><div class="p">Option to limit the amount of time that the flow waits for the action to be completed before continuing.<div class="note"><span class="notetitle">Note:</span> Use the <span class="ph uicontrol">Enable timeout</span> option to prevent this action from continuing to run. If the condition to continue is never met, a timeout value specifies when the system skips the Wait for Condition action and go to the next item in the flow. You must set a Duration value to enable a timeout. You can also select a Schedule if you want to compute the duration end date based on a specific work schedule.</div> </div> <p class="p">This field appears only when the <span class="ph uicontrol">Wait for Completion</span> option is selected.</p> </td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Duration</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 "><p class="p">Amount of time that the flow waits before continuing when the <span class="ph uicontrol">Enable timeout</span> option is selected. Enter the time to wait in hours, minutes, and seconds. If you leave this field empty, the flow does not wait.</p> <p class="p">This field appears only when the <span class="ph uicontrol">Wait for Completion</span> option is selected.</p> </td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e78 ">Schedule</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e81 "><p class="p">Schedule used to compute the timeout duration when the <span class="ph uicontrol">Enable timeout</span> option is selected. For example, waiting for 10 hours as part of an 8-5 weekdays schedule causes the flow to wait for one or more business days. If you leave this field empty, the timeout runs without a schedule.</p> <p class="p">This field appears only when the <span class="ph uicontrol">Wait for Completion</span> option is selected.</p> </td></tr></tbody></table> </div> </div> </div> <div class="section" id="submit-catalog-item-request-flow-designer__section_j2j_2hn_tkb"><h2 class="title sectiontitle">Output</h2> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="submit-catalog-item-request-flow-designer__table_nb4_g3n_tkb" class="table" frame="border" border="1" rules="all"><colgroup><col /><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d947208e256">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d947208e259">Description</th><th class="entry cellrowborder" style="vertical-align:top;" id="d947208e262">Data Type</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e256 ">Error Message</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e259 ">Message that displays if the action produces an error.</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e262 ">String</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e256 ">Requested Item</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e259 ">Document ID for the requested item.</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e262 ">Document ID</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e256 ">Status</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e259 ">The completion status of the action as a numeric value.<ul class="ul" id="submit-catalog-item-request-flow-designer__ul_zjm_jt5_klb"><li class="li">0 (success)</li><li class="li">1 (error)</li><li class="li">2 (timeout)</li></ul> </td><td class="entry cellrowborder" style="vertical-align:top;" headers="d947208e262 ">Choice</td></tr></tbody></table> </div> </div> </div> <div class="section" id="submit-catalog-item-request-flow-designer__section_dxx_dhn_tkb"><h2 class="title sectiontitle">Example</h2> <p class="p"><img class="image" id="submit-catalog-item-request-flow-designer__image_kfj_rts_qlb" width="800" src="../images/submit-catalog-item-request.png" alt="Example Submit Catalog Item Request action in a flow." /></p> </div> <div class="section" id="submit-catalog-item-request-flow-designer__section_tvl_db4_45b"><h2 class="title sectiontitle">Design considerations</h2> <p class="p">Follow these design considerations when creating flows that contain Submit a Catalog Item Request actions.</p> <dl class="dl"><dt class="dt dlterm">Escape quotation marks from string data pills with the String Replace transform function</dt><dd class="dd">Complex string variables are converted into JSON format when stored in the system. To prevent any JSON formatting errors, you can use a Replace String transform function to escape the quotation marks present in any string data pills you use for catalog variables. See <a class="xref" href="string-transform-functions.html" title="Use string transform functions to reformat or perform calculations on String data pills.">String transform functions</a>.</dd><dt class="dt dlterm">Use transform functions to validate data pills</dt><dd class="dd">Whenever you use a data pill to provide data for an action input, you can use a transform function to validate the data. See <a class="xref" href="../concept/transform-functions.html" title="Transform data pill values without the need to write a script. Use transform functions to reformat text, perform mathematical calculations, sanitize potentially unsafe SQL statements, and serialize complex objects to raw XML.">Transform functions</a> for a list of available transform functions.</dd></dl> </div> </div> <div class="related-links"> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../administer/flow-designer/concept/flow-actions.html" title="Actions can be added to any flow, enabling process analysts to automate Now Platform features without having to write code.">Flow Designer actions</a></div> </div> </div></body></html></div>