SharePoint - Send CSV
- 16 Mar 2023
- 4 Minutes to read
SharePoint - Send CSV
- Updated on 16 Mar 2023
- 4 Minutes to read
SharePoint - Send CSV creates a CSV file with the results of the saved query supplied as a trigger (or entities that have been selected in the asset table), and sends it to a specific path on SharePoint.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonious. You can change the name according to your needs.
- Add description (optional) - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs and Adapter Fetch History Modules
- Action name - The name of the Main action. A default value is added by Axonious. You can change the name according to your needs.
- Configure Action Conditions - Toggle on to enter a condition statement. See Configuring Enforcement Action Conditions to learn more about condition statement syntax.
Click to view Connection Settings
- Authentication Method - Select the Authentication Method, either User Credentials, or Client Credentials.
- User name and Password (required) - The credentials for a SharePoint user account that has the read and write permissions to the supplied Site URL and Folder Path. Use when you choose User Credentials as the Authentication Method
- Client ID and Secret - Use Client ID and Secret when you choose Client Credentials as the Authentication Method
- Site URL (required) - The SharePoint site URL. For example: https://testaxonius.sharepoint.com/sites/TestSite/.
- Folder path (required) - Specify the folder path. If the path is incorrect, the action will fail. You have to specify the full path and include everything that follows the SharePoint site URL. For example if the SharePoint site URL is https://testaxonius.sharepoint.com/sites/TestSite/ and your folder is in /OurDepartment/OurDeptDocs/CSVFiles/FilesFromThisWeek, you must make sure you list the complete path.
- File name (required, default: axonius_data) - The file name.
- Append date and time to file name (required, default: True)
- If enabled, the date and time (in UTC) of enforcement action execution will be added as a suffix to the generated CSV file name. For example, axonius_data_2020-01-06-16:48:13.csv.
- If disabled, the CSV file will be stored based on the specified/default file name.
- Verify SSL (required, default: True) - Verify the SSL certificate offered by Microsoft OneDrive. For more details, see SSL Trust & CA Settings.
- If enabled, the SSL certificate offered by Microsoft SharePoint will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
- If disabled, the SSL certificate offered by Microsoft SharePoint will not be verified against the CA database inside of Axonius.
- HTTPS proxy (optional) - A proxy to use when connecting to Microsoft SharePoint.
- If supplied, Axonius will utilize the proxy when connecting to Microsoft SharePoint.
- If not supplied, Axonius will connect directly to Microsoft SharePoint.
- Create CSV even if no data is returned in the query (optional) - Select whether to create and send a CSV file even if the query does not return any results.
Additional CSV Settings
- Split by asset entities - Select to create a CSV file where each asset on a device is shown as a separate row. This separates each asset as the 'expand' option in the application. It separates each asset by its entity. For example, you will be able to know which values were fetched from each adapter connection.
a. If supplied, each value on a device or user is shown as a separate row.
b. If not supplied all values on a device are in the same cell on the CSV file.
- Split by field values - Choose field value - For complex fields and lists you can create a CSV file where the values of complex fields and lists are represented as separate rows in the file. From the drop-down box select the value that you want to display in the file, 'Tags' for instance. Only fields that have been discovered are available. For example, if you export by Installed Software, you will be able to see each installed Software name and its version.
- Don't split complex objects into columns - When selected, complex objects appear in a single column in JSON format. By default, each field in a complex object is split into a separate column in the CSV file.
- Export CSV delimiter to use for multi-value fields (default: Export CSV delimiter to use for multi-value fields field under the System Settings section in the GUI Settings) - Specify a delimiter to separate between values within the same field of an exported CSV file, otherwise the delimiter defined in Export CSV delimiter to use for multi-value fields is used.
- Maximum rows (default: 1048500) - Specify the maximum number of rows to be included in the CSV file. When you set a value here the generated CSV file will include the top x rows, based on the specified values. Otherwise, the generated CSV file will include the default maximum rows, set as 1048500.
For more details about other Enforcement Actions available, see Action Library.