Creating a component

SECURITY  Refer to COMPONENTS > Components in Security Level Details - Permissions

NAVIGATION  Components tab

Support covers the following:

• Troubleshoot jobs associated to scripts/components
• Investigate if a script runs successfully outside of Datto RMM but does not run successfully in Datto RMM.

Support does not cover custom script/component creation. Partners are advised to contact their Account Manager for a Professional Services engagement if they require assistance with script/component creation.

1. Click the Components tab.
2. In the top left corner, click New Component.
3. Select a Category: Applications, Device Monitors, Scripts.
4. Enter a Name and a Description.
5. Click Save. The Component page opens. The following information is displayed:

Field	Description
Favorite	Only available for the categories Applications and Scripts. Click the icon to make this component available to be used in quick jobs and as alert response in monitors in the current UI. Refer to Make a component available for quick jobs and Run the following component.
Copy this component	Opens a confirmation dialog. Click OK to create a copy of the component.
General
Field	Description
Category	Displays the selection made on the previous page.
Name	Displays the name entered on the previous page but it can be edited.
Description	Displays the description entered on the previous page but it can be edited.
ID	The unique identifier of the new component.
Component Level	Specifies which users can view this component. Refer to Component Level. NOTE  The component level of custom components can be set to 1 (Basic), 2 (Low), 3 (Medium), 4 (High) and 5 (Super).
Created	The date and time the component was created in UTC, and the name of the creator.
Modified	The date and time the component was last modified.
Change Image	Click to select a different image for this component. You can choose an already uploaded image from the image library, or you can choose an image on your machine (48x48 PNG/JPG/GIF file).
Sites
Field	Description
Sites radio button	Select one of the following options: • All sites - The component can be deployed to devices belonging to any site. • Selected sites - You can select the sites this component can be deployed to. Use the Search field above either the Include or Exclude column to search for your sites. As you type, the search results are narrowed to match your search string. By default, all sites are initially excluded. Refer to Map components to specific sites.
Commands / Script
Field	Description
Install command/Script	From the drop-down list, select the scripting language you want to use. For an overview of scripting, refer to Scripting.
Expand/Collapse	Changes the size of the Install command text box.
Text field	Enter the install command (script) into the text box.
Timeout this script if not completed within X seconds	Allows you to set the maximum amount of time, in seconds, after which the script will time out.
This component requires site credentials	Only available for the categories Applications and Scripts. If installing this component requires a username and password that is unique for each site, checking this setting will allow Datto RMM to use the cached credentials entered in Site Settings. This is useful if you’re running the component on multiple sites that each need different credentials. For example, you can specify the credentials for 10 different sites, then just run the component once against 10 different sites at the same time. Refer to Credentials.
Files (only available for the categories Applications and Scripts)
Field	Description
Add file...	Click Add file... to add an installer file. The file will be uploaded and shown in the list. Click the Delete this file icon to remove it if necessary. Refer to Attached files. NOTE  You can have more than one file in the component but each file must not be larger than 3GB. In addition, you should not exceed a component size of 5GB total.
Variables
Field	Description
Input Variables	Input variables allow you to determine certain parameters at runtime, so you don't have to have them hard coded in the script itself. Moreover, input variables allow you to re-use a single component to carry out multiple tasks. You can add multiple variables, and they can be edited and deleted. For more information, refer to Input variables.
Output Data	Only available for the category Device Monitors. You need to let Datto RMM know what variable name you're using to capture the output. Click the plus icon to the right of this section to open the Add Output Variable dialog box. You can add multiple variables, and they can be edited and deleted. Add the following details: • Name • Type - Select one of the following options: String, Number, Timestamp, Boolean, Blob • Description Finally, click Add. For more information, refer to Create a custom component monitor.
Post-Conditions (only available for the categories Applications and Scripts)
Field	Description
Warning Text	This function will look at the output (Standard Output Stream and/or the Standard Error Stream) from a script you have run and alert if a specific text string is either found or not found. Click Click here to add a post-condition. For more information, refer to Post-Conditions.

6. Click Save. The component will now be added to your Component Library.

Custom components and components that are copies of components downloaded from the ComStore can be edited. For components that can be edited, the name appears as a hyperlink.

1. Click the Components tab.
2. Click a component name that appears as a hyperlink.

3. Edit the fields as required. For field descriptions, refer to Create a component.
4. When you have finished editing the component, click Save.

IMPORTANT  When you edit a component that is used in a Monitoring policy, make sure to re-push the policy for the component changes to be applied.