ServiceNow - Move or Copy Attachment

📘

Note

There is a fundamental difference between moving and copying an attachment. The Copy action is more complex.

Each flow begins by identifying both the attachment and its intended destination:

1. Retrieve the attachment ID from the endpoint:

   • endpoint: table/sys_attachment
   • sysparam_query: table_sys_id={table_sys_id}^table_name={table_name}

2. Retrieve the destination record sys_id using a query mapped with Dynamic Values.

   • endpoint: table/{table}
   • sysparam_query: number=INC00001

For each attachment, the subsequent steps vary based on whether you're moving or copying the attachment.

Move flow:

1. Change the attachment record destination by putting in a new value.

   • endpoint: table/sys_attachment/{attachment_sys_id}
   • body params: table_name=new_table_name, table_sys_id=new_table_sys_id

2. Check if the destination record contains the moved attachment.

   • endpoint: table/sys_attachment
   • sysparam_query: table_sys_id={table_sys_id}^table_name={table_name}

Copy flow:

1. Download the attachment file to Axonius.

   • endpoint: attachment/{attachment_sys_id}/file

2. Upload the attachment file to the destination record.

   • endpoint: attachment/file
   • URL parameters: table_name=table_name, table_sys_id=table_sys_id, file_name=file_name
   • body: File content

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

When accessing an enforcement action using the API, you must use the backend form of field names.

Use the Syntax Helper to find the correct name. In the enforcement action, enable Configure Dynamic Values and select Syntax Helper.

📘

Note

• Not all asset types are supported for all Enforcement Actions.
• See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
• See Actions supported for Aggregated Security Findings.
• See Actions supported for Software.

• Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
• Configure Dynamic Values (optional) - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

💡

Connection and Credentials

When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

• ServiceNow Domain - The full URL for your ServiceNow instance.

• User Name and Password - To connect to ServiceNow, you need to create a user with action privileges to create and manage assets.

• OAuth Client ID and OAuth Client Secret - The credentials for OAuth-based access to ServiceNow. Refer to OAuth 2.0 with Inbound REST for full details on how to obtain the OAuth Token.

• OAuth Refresh Token - When using the OAuth method of authentication, enter the value of the Refresh Token issued by a ServiceNow instance. This token is used to obtain new access tokens without requiring the user to reauthenticate.

• OAuth Custom Endpoint Path - Specify a custom endpoint path to be used instead of the default oauth_token.do.

• Enable sending OAuth requests as JSON - Enable sending the request in JSON format instead of the standard www-form-urlencoded format.

• Apigee URL - The URL of the domain that the GET request is sent to for acquiring the Apigee token.

• Resource Apigee - The specific resources that the Apigee token is configured to access.

• Verify SSL (Optional) (default: enabled) - Selects whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings. This setting is enabled by default on all new adapter settings. If you need to disable SSL verification, make sure you disable this setting.)

• HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

• Gateway Name - Select the Gateway through which to connect to perform the action.

Gateway Name - Select the Gateway through which to connect to perform the action.

For more details about other enforcement actions available, see Action Library.