{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5245,"path":"conversational-interfaces/virtual-agent/va-file-picker.md","title":"File Picker user input control","bundle":null,"doc_type":null,"release":"australia","body":"\n# File Picker user input control\n\nUse the File Picker user input control in a Virtual Agent topic to prompt a user to upload an image or any file type. After the user uploads an image file, the image appears immediately in the Virtual Agent client.\n\n## File Picker user input control properties\n\nAll file types are supported by the file picker, except the SVG format for image files. Although the image can be high resolution, the image displayed in the Virtual Agent client is scaled based on the aspect ratio. Images scale to fit within the chat window.\n\nIn Microsoft Teams, a file can be uploaded through the paper clip \\(attachment\\) icon, or using drag-and-drop. Copying and pasting only works for image files. Users can share attachments on Microsoft Teams through the Virtual Agent file picker user input control, and by sending attachments while chatting with a live agent.\n\nThe live agent picker scenario:\n\n-   Doesn't support the SVG format for image files.\n-   Supports a combination of text, files, and emojis. However, orders may show up differently between how a user sends these items versus how an agent views these items.\n-   Doesn't support formatted text.\n\nWhen a file upload is in progress, you can't upload or enter text for the file picker control. The uploaded files go through a virus scan and validation.\n\nYou can link an uploaded file to a case you create using the Record Action utility. For more information, see [Record Action utility](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-record-action-util.md).\n\nThe following table lists the details about the properties of the File Picker.\n\n<table id=\"table_nff_y1b_3db\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nNode name\n\n</td><td>\n\nName that identifies the File Picker user input control node in the topic flow.\n\n</td></tr><tr><td>\n\nVariable name\n\n</td><td>\n\nName of the variable that stores the user response to this prompt. The variable name is automatically created from the **Node name** property.\n\n</td></tr><tr><td>\n\nPrompt\n\n</td><td>\n\nPrompt or question asking the user to upload the item. The prompt can be a text string that includes variables or a script that returns text.\n\n</td></tr><tr><td>\n\nAllow user to upload\n\n</td><td>\n\nType of file to upload. All file types are supported, except the SVG format for image files.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nConfirmation messages\n\n</td></tr><tr><td>\n\nInput completion confirmation\n\n</td><td>\n\nBot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: `Thanks, (Input Variables > Username)!` Or if you're using a script, the acknowledgement might be: `Thanks, {{vaInputs.username}}!`\n\n</td></tr><tr><td>\n\nDefault value confirmation\n\n</td><td>\n\nMessage that asks the user to verify that the value in the **Default value** field is correct. This message is used instead of a value in the **Prompt** field. It can contain either a text string or a script that returns text. For example, if you're using dot-walking: `Are you (Input Variables > Username)?` Or if you're using a script, the confirmation message might be: `Are you {{vaScripts.lastUsername}}?`.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide or skip this node\n\n</td></tr><tr><td>\n\nConditionally show this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n</td></tr><tr><td>\n\nAllow user to skip this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.\n\n</td></tr><tr><td>\n\nSkip reprompting if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip reprompting in the conversation. When a preceding node is revisited through a topic loopback or Dialog Act, Virtual Agent bypasses this node and automatically retains its original value.\n\n</td></tr></tbody>\n</table>## Using the File Picker control in different client interfaces\n\nThe process to select an image differs based on the Virtual Agent client interface. Use the following steps to select an image in the client interface of your choice.\n\nThe following table lists details about the File Picker control in different client interfaces.\n\n<table id=\"table_zjd_5h2_d2b\"><thead><tr><th>\n\nPlatform\n\n</th><th>\n\nSteps to select an image or file\n\n</th></tr></thead><tbody><tr><td>\n\nWeb UI\n\n</td><td>\n\n1.  Select **Click here to upload an image.** or **Click here to upload a file.**\n2.  Select a file from your local computer. All file types are supported.\n\n</td></tr><tr><td>\n\nSlack\n\n</td><td>\n\n1.  Select the Green **+** icon.\n2.  Select **Your computer**.\n3.  Select an image file from your local computer.\n\nAll file types are supported.\n\n\n</td></tr><tr><td>\n\nMicrosoft Teams\n\n</td><td>\n\n1.  On your local computer, copy an image file.\n2.  Paste the image file into the text input field in Microsoft Teams.\n\n</td></tr><tr><td>\n\nWorkplace\n\n</td><td>\n\n1.  Select the Workplace image icon \\[Omitted image \"FB-image-icon.png\"\\] Alt text: Workplace image icon..\n2.  Select an image file from your local computer.\n\nAll file types are supported.\n\n\n</td></tr><tr><td>\n\nServiceNow mobile\n\n</td><td>\n\n1.  Touch **Upload an image**.\n2.  Select an image file from the photo library on your mobile device.\n\n **Note:** The **Upload a file** button is only available when you enable the **All file types** file picker property.\n\n</td></tr></tbody>\n</table>## Example of a File Picker user input control\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n<table id=\"table_f1f_v2p_xdb\"><thead><tr><th>\n\nFile Picker properties\n\n</th><th>\n\nFile Picker prompt\n\n</th></tr></thead><tbody><tr><td rowspan=\"2\">\n\n\\[Omitted image \"va-file-picker-properties.png\"\\] Alt text: Basic properties include the node name, prompt, and file type, either Image or All file types.\n\n</td><td>\n\n\\[Omitted image \"va-file-picker-image.png\"\\] Alt text: In a chat window, the prompt reads, \"Please upload your image.\" The button reads, \"Click here to upload an image.\"\n\n</td></tr><tr><td>\n\n\\[Omitted image \"va-image-picker-mobile.png\"\\] Alt text: Prompt that reads, \"Please upload a file for the detailed description of the case.\" There are three options: Upload an Image, Take Photo, or Upload a File.\n\n</td></tr></tbody>\n</table>## Channel support\n\nThe following table lists the details about the channel support for the File Picker user input control.\n\n<table id=\"table_kwp_dyq_rsb\"><thead><tr><th>\n\nChannel\n\n</th><th>\n\nSupport\n\n</th><th>\n\nConstraints\n\n</th></tr></thead><tbody><tr><td>\n\nWeb UI\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nMobile UI\n\n</td><td>\n\nSupported\n\n</td><td>\n\nPrompt that users see asking for permission for the app to access a camera or file system if the user has not already given the permission.\n\n \\[Omitted image \"camera-access-prompt.png\"\\] Alt text: Prompt that reads, \"Mobile\" Would Like to Access the Camera. The choices are \"Don't Allow\" and \"OK.\"\n\n</td></tr><tr><td>\n\nServiceNow Otto panel\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nMicrosoft Teams\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nGoogle Chat\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nSlack\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nWorkplace\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nFacebook Messenger\n\n</td><td>\n\nSupported\n\n</td><td>\n\nSupported file types are JPG, PNG, BMP, and MP4. The files have a maximum size limit based on the file type:\n\n-   For images, the maximum size limit is 10 MB.\n-   For videos, the maximum size limit is 200 MB.\n\n</td></tr><tr><td>\n\nSMS Twilio\n\n</td><td>\n\nPartial support\n\n</td><td>\n\nImage files only\n\n</td></tr><tr><td>\n\nLINE\n\n</td><td>\n\nSupported\n\n</td><td>\n\nSupported file types are JPG, PNG, BMP, and MP4. The files have a maximum size limit based on the file type:\n\n-   For images, the maximum size limit is 10 MB.\n-   For videos, the maximum size limit is 200 MB.\n\n</td></tr><tr><td>\n\nWhatsApp\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nApple Messages for Business\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nAlexa \\(Voice\\)\n\n</td><td>\n\nNot supported\n\n</td><td>\n\nNot applicable\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Assistant Designer user input controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-user-inputs.md)\n\n"}}