Interagir avec les données de table dans une ServiceNow instance

Le Mobile SDK vous permet d’interagir avec les données dans les tables qui résident sur votre ServiceNow instance. Vous pouvez interagir avec ces données via l’API deServiceNow table REST à l’aide de l’API NowTableService() qui appelle directement l’interface REST, ou via l’API NowGraphQLService() qui exécute une requête GraphQL spécifiée sur l’API GraphQL REST.

Si vous souhaitez renvoyer des données à partir de plusieurs tables au sein d’un seul appel, vous devez utiliser l’API NowGraphQLService(). Si vous devez interagir avec ServiceNow des API REST autres que l’API Table , reportez-vous à la section Interagir avec l’API REST publique sur une ServiceNow instance.

Utilisation de NowGraphQLService pour interagir avec ServiceNow les tables

La classe NowGraphQLService fournit des méthodes qui vous permettent de construire et d’exécuter des requêtes GraphQL sur une table spécifiée au sein de votre ServiceNow instance si l’utilisateur connecté dispose de l’autorisation appropriée. Vous pouvez définir toutes les opérations CRUD dans votre requête GraphQL.

L’exemple suivant montre comment importer le cadre de travail NowData, puis initialiser un objet NowGraphQLService que vous pouvez ensuite utiliser pour interagir avec les tables de votre ServiceNow instance.

/**
 * Helper class used to handle different Now service instances.
 */
@Singleton
class SdkManager @Inject constructor() {

    private var nowGraphQLService: NowGraphQLService? = null

    /**
     * Create the NowGraphQLService once in the lifetime of the application inside the Application class or another manager class
     * that will be injected into other classes via dagger/hilt.
     * NowGraphQLService should be created after initializing the NowSDK
     */
    suspend fun getNowGraphQLService(): NowGraphQLService? {
        if (nowGraphQLService != null) return nowGraphQLService

        return NowDataSDK.makeGraphQLService(URL("https://instance-name.service-now.com")).getOrThrow()
            .also { this.nowGraphQLService = it }
    }
}

Cet exemple montre comment obtenir des articles de la base de connaissances publiés à l’aide d’une requête GraphQL.

suspend fun loadList() = withContext(Dispatchers.IO) {
    val kbArticlesQuery = """
    { 
        GlideRecord_Query {
            kb_knowledge(queryConditions: "active=true^ORDERBYpublishedDESC"
            pagination:{ limit: 10, offset: 0 }) {
                _results {
                    sys_id { value },
                    number { displayValue },
                    short_description { displayValue },
                    author { displayValue }
                    published { displayValue }
                }
            }
        }
     }
 """
    val graphQLService = sdkManager.getNowGraphQLService()

    //graphQLService?.graphQLRequest(kbArticlesQuery)?.execute() can also be used
    graphQLService?.graphQLRequest(kbArticlesQuery)?.enqueue(
        { response ->
            response.body?.let {
                val resultString = String(it)
            }

        }, { nowDataError ->
            //handle error
        })
}

Utilisation de NowTableService pour interagir avec ServiceNow les tables

La classe NowTableService fournit des méthodes pour effectuer des opérations CRUD sur les enregistrements dans les tables qui résident sur votre ServiceNow instance. Grâce à cette interface, vous pouvez accéder directement à n’importe quel enregistrement de n’importe quelle ServiceNow table pour laquelle l’utilisateur connecté est autorisé. NowTableService prend en charge la remontée pas à pas pour les champs de référence. Par exemple, si une table contient une référence à la table Utilisateur, la valeur de remontée pas à pas user.name renvoie le nom de l’utilisateur.

Lors du renvoi des données demandées, toutes les listes de contrôle d’accès (ACL) applicables sont appliquées aux données, ce qui peut entraîner moins de résultats que prévu ou des erreurs d’autorisation si l’utilisateur authentifié ne dispose pas des droits d’accès à la table spécifiée.

L’exemple suivant montre comment importer le cadre de travail NowData , puis initialiser un objet NowTableServce que vous pouvez ensuite utiliser pour interagir avec ServiceNow les tables d’instance.

/**
 * Helper class used to handle different Now service instances. It has an application scope or is Singleton
 */
@Singleton
class SdkManager @Inject constructor() {

    private var nowTableService: NowTableService? = null

    /**
     * Create the NowTableService once in the lifetime of the application inside the Application class or another manager class
     * that will be injected into other classes via dagger/hilt.
     * NowTableService should be created after initializing the NowSDK
     */
    suspend fun getNowTableService(): NowTableService? {
        if (nowTableService != null) return nowTableService

        return NowDataSDK.makeTableService(URL("https://instance-name.service-now.com")).getOrThrow()
            .also { this.nowTableService = it }
    }
 }    


suspend fun loadCases() = withContext(Dispatchers.IO) {
    val tableService = sdkManager.getNowTableService()

    //configure what data to pass back
    val fetchConfiguration =  FetchConfiguration(Filter("active=true"), 10)

    val response = runCatching {
        tableService?.records(
            "sn_customerservice_case",
            fetchConfiguration
        )?.execute()
    }

    if (response.isSuccess) {
        val resultString = response.getOrNull()?.body?.let { String(it) }
    } else {
        //handle unsuccessful result
    }
}

Pour obtenir des exemples de code supplémentaires utilisant les méthodes NowTableService disponibles, consultez la documentation de l’API NowTableService .