Interagir avec les données d’une table dans une ServiceNow instance

Cela 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 ServiceNowREST Table en utilisant 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 REST GraphQL .

Si vous souhaitez renvoyer les données de plusieurs tables dans un seul appel, vous devez utiliser l’API NowGraphQLService( ). Si vous avez besoin d’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 l’infrastructure 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 des tables

La classe NowTableService fournit des méthodes permettant d’effectuer des opérations CRUD sur les enregistrements des 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 lequel 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 renvoie user.name 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 framework 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, reportez-vous à la documentation de l’API NowTableService .