NAiOS IconNAiOS Logo
Volver al catálogo

ServiceNow

servicenow

ServiceNow is a cloud-based enterprise platform that helps organizations automate and manage digital workflows across IT, HR, customer service, and operations.

Acciones
5
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (5)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Attach file to recordSERVICENOW_ATTACH_FILE_TO_RECORDAcción

Attaches a file to a specified record in a servicenow table. this endpoint allows you to attach a file with the provided details to the specified record.

Parámetros de entrada

  • file_namestringObligatorio

    Name to give the attachment.

  • table_namestringObligatorio

    Name of the table to attach the file to.

  • creation_timestring

    Creation date and time of the attachment. Use this parameter to capture attachment creation times when the Now Mobile app is offline and the attachment is uploaded to a record at a later time.

  • record_sys_idstringObligatorio

    Sys_id of the record in the table specified in table_name that you want to attach the file to.

  • file_to_uploadobjectObligatorio

    The path of the file to upload.

  • encryption_contextstring

    Sys_id of an encryption context record. Specify this parameter to allow only users with the specified encryption context to access the attachment. For additional information on encryption context records, see https://www.servicenow.com/docs/csh?topicname=column-level-encryption-landing&version=yokohama&pubname=yokohama-platform-security.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a recordSERVICENOW_CREATE_A_RECORDAcción

Creates a new record in a specified servicenow table. this endpoint allows you to create a new record with the provided data in the specified table.

Parámetros de entrada

  • table_namestringObligatorio

    The name of the table where the record will be created.

  • sysparm_viewstringenum

    UI view for which to render the data. Determines the fields returned in the response.

    desktopmobileboth
  • sysparm_fieldsstring

    Comma-separated list of fields to return in the response. Invalid fields are ignored. Default behaviour is to return all fields.

  • sysparm_display_valuestringenum

    Determines the type of data returned, either the actual values from the database or the display values of the fields. Display values are manipulated based on the actual value in the database and user or system settings and preferences.

    truefalseall
  • sysparm_input_display_valueboolean

    Flag that indicates whether to set field values using the display value or the actual value.

  • sysparm_exclude_reference_linkboolean

    Flag that indicates whether to exclude Table API links for reference fields.

Parámetros de salida

  • dataobjectObligatorio

    The data returned by the API

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete a recordSERVICENOW_DELETE_A_RECORDAcción

Deletes a record from a specified servicenow table. this endpoint allows you to delete a record with the provided id from the specified table.

Parámetros de entrada

  • sys_idstringObligatorio

    Sys_id of the record to delete.

  • table_namestringObligatorio

    Name of the table from which to delete the specified record, such as 'incident' or 'asset'.

  • sysparm_query_no_domainboolean

    Flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Find fileSERVICENOW_FIND_FILEAcción

Finds a file in a specified servicenow table. this endpoint allows you to find a file with the provided name in the specified table.

Parámetros de entrada

  • sysparm_limitstring

    Limit to be applied on pagination. Note: Unusually large sysparm_limit values can impact system performance.

  • sysparm_querystring

    Encoded query. Queries for the Attachment API are relative to the Attachments [sys_attachment] table. For example: (sysparm_query=file_name=attachment.doc) The encoded query provides support for order by. To sort responses based on certain fields, use the ORDERBY and ORDERBYDESC clauses in sysparm_query. For example, sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name orders the results in ascending order by name first, then in descending order by table name.

  • sysparm_offsetstring

    Number of records to exclude from the query. Use this parameter to get more records than specified in sysparm_limit parameter. For example, if sysparm_limit is set to 500, but there are additional records you want to query, you can specify a sysparm_offset parameter value of 500 to get the second set of records.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get recordsSERVICENOW_GET_RECORDSAcción

Retrieves a record from a specified servicenow table. this endpoint allows you to retrieve a record with the provided id from the specified table.

Parámetros de entrada

  • table_namestringObligatorio

    The name of the table from which to retrieve the record.

  • sysparm_viewstringenum

    UI view for which to render the data. Determines the fields returned in the response.

    desktopmobileboth
  • sysparm_limitinteger

    Maximum number of records to return. For requests that exceed this number of records, use the sysparm_offset parameter to paginate record retrieval. This limit is applied before ACL evaluation. If no records return, including records you have access to, rearrange the record order so records you have access to return first. Note: Unusually large sysparm_limit values can impact system performance.

  • sysparm_querystring

    Encoded query used to filter the result set. You can use a UI filter to obtain a properly encoded query. Syntax: sysparm_query=<col_name><operator><value>. <col_name>: Name of the table column to filter against. <operator>: Supports the following values: =: Exactly matches <value>. !=: Does not match <value>. ^: Logically AND multiple query statements. ^OR: Logically OR multiple query statements. LIKE: <col_name> contains the specified string. Only works for <col_name> fields whose data type is string. STARTSWITH: <col_name> starts with the specified string. Only works for <col_name> fields whose data type is string. ENDSWITH: <col_name> ends with the specified string. Only works for <col_name> fields whose data type is string. <value>: Value to match against. All parameters are case-sensitive. Queries can contain more than one entry, such as sysparm_query=<col_name><operator><value>[<operator><col_name><operator><value>]. For example: (sysparm_query=caller_id=javascript:gs.getUserID()^active=true) Encoded queries also support order by functionality. To sort responses based on certain fields, use the ORDERBY and ORDERBYDESC clauses in sysparm_query. Syntax: ORDERBY<col_name> ORDERBYDESC<col_name> For example: sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory This query filters all active records and orders the results in ascending order by number, and then in descending order by category. If part of the query is invalid, such as by specifying an invalid field name, the instance ignores the invalid part. It then returns rows using only the valid portion of the query. You can control this behavior using the property glide.invalid_query.returns_no_rows. Set this property to true to return no rows on an invalid query. Note: The glide.invalid_query.returns_no_rows property controls the behavior of all queries across the instance, such as in lists, scripts (GlideRecord.query()), and web service APIs.

  • sysparm_fieldsstring

    Comma-separated list of fields to return in the response. Invalid fields are ignored.

  • sysparm_offsetinteger

    Starting record index for which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks. For example, the first time you call this endpoint, sysparm_offset is set to '0'. To simply page through all available records, use sysparm_offset=sysparm_offset+sysparm_limit, until you reach the end of all records. Don't pass a negative number in the sysparm_offset parameter.

  • name_value_pairsstring

    Name-value pairs to use to filter the result set. This parameter is mutually exclusive with sysparm_query. For example, instead of using &sysparm_query=active=true, you can simplify the calling statement by using &active=true. You can also use the display value when the field is a choice or reference type field, such as &state=closed instead of &state=7. To specify multiple key-value pairs, separate each with an ampersand, such as &active=true&assigned_to=john.smith.

  • sysparm_no_countboolean

    Flag that indicates whether to execute a select count(*) query on the table to return the number of rows in the associated table.

  • sysparm_display_valuestringenum

    Determines the type of data returned, either the actual values from the database or the display values of the fields. Display values are manipulated based on the actual value in the database and user or system settings and preferences. If returning display values, the value that is returned is dependent on the field type. Choice fields: The database value may be a number, but the display value will be more descriptive. Date fields: The database value is in UTC format, while the display value is based on the user's time zone. Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context. Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.

    truefalseall
  • sysparm_query_categorystring

    Name of the category to use for queries.

  • sysparm_query_no_domainboolean

    Flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured. Valid values: false (Exclude the record if it is in a domain that the currently logged in user is not configured to access), true (Include the record even if it is in a domain that the currently logged in user is not configured to access). Note: The sysparm_query_no_domain parameter is available only to system administrators or users who have the query_no_domain_table_api role.

  • sysparm_exclude_reference_linkboolean

    Flag that indicates whether to exclude Table API links for reference fields.

  • sysparm_suppress_pagination_headerboolean

    Flag that indicates whether to remove the Link header from the response. The Link header provides various URLs to relative pages in the record set which you can use to paginate the returned record set. Valid values: true (Remove the Link header from the response), false (Do not remove the Link header from the response).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not