NowDataSDK-Klasse – Android

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Die NowDataSDK -Klasse bietet Funktionen, die die Erstellung und Initialisierung verschiedener Funktionsservices wie NowGraphQLService, NowAttachmentService, NowTableService und NowAPIService ermöglichen.

    NowDataSDK – makeGraphQLService(instanceURL: URL)

    Erstellt und initialisiert eine Instanz der NowGraphQLService-Funktion. Dieser Service ermöglicht den Zugriff auf die GraphQL- API in Ihrer Instanz ServiceNow.

    Weitere Informationen zur GraphQL-API ServiceNow finden Sie unter Fragen Sie Datensatzdaten mit dem GraphQL-API-Framework ab.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    instanceURL URL URL der Instanz ServiceNow, auf die zugegriffen werden soll. Beispiel: „https://instance.servicenow.com“
    Tabelle : 2. Ausgabe
    Typ Beschreibung
    Ergebnis<NowGraphQLService> NowGraphQLService-Objekt in ein Kotlin-Ergebnisobjekteingeschlossen.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    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 }
    }

    NowDataSDK – makeNowAPIService(instanceURL: URL)

    Erstellt und initialisiert eine Instanz des NowAPIService-Service. Mit diesem Service können Sie auf die öffentlichen REST APIs zugreifen, die von Ihrer ServiceNow -Instanz verfügbar gemacht werden.

    Darüber hinaus können Sie benutzerdefinierte geskriptete REST-APIs in Ihrer ServiceNow -Instanz entwickeln und in Ihrer Android -Anwendung mit der NowAPIService- API darauf zugreifen. Weitere Informationen zu ServiceNow REST APIs finden Sie unter Scripted REST APIs.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    instanceURL URL URL der Instanz ServiceNow, auf die zugegriffen werden soll. Beispiel: „https://instance.servicenow.com“
    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Ergebnis<NowAPIService> NowAPIService in ein Kotlin-Ergebnisobjekteingeschlossen.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    private var nowApiService: NowAPIService? = null
    
    /**
      * Create the NowAPIService 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.
      * NowAPIService should be created after initializing the NowSDK
      */
    suspend fun getNowApiService(): NowAPIService? {
      if (nowApiService != null) return nowApiService
    
      return NowDataSDK.makeAPIService(URL("https://instance-name.service-now.com")).getOrThrow()
        .also { this.nowApiService = it }
    }

    NowDataSDK – makeNowAttachmentService(instanceURL: URL)

    Erstellt und initialisiert eine Instanz der NowAttachmentService-Funktion.

    Mit diesem Service können Sie Anhangsdateien aus Ihrer ServiceNow -Instanz hochladen, herunterladen und löschen. Nachdem Sie einen Anhang in Ihre Instanz hochgeladen haben, werden Metadaten für den Anhang generiert, die Sie dann in Ihre Android -Anwendung herunterladen können.

    Weitere Informationen zu ServiceNow -Anhängen finden Sie unter Anhang-API.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    instanceURL URL URL der Instanz ServiceNow, auf die zugegriffen werden soll. Beispiel: „https://instance.servicenow.com“
    Tabelle : 6. Ausgabe
    Typ Beschreibung
    Ergebnis<NowAttachmentService> NowAttachmentService-Objekt in ein Kotlin-Ergebnisobjekteingeschlossen.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    private var nowAttachmentService: NowAttachmentService? = null
    
    /**
      * Create the NowAttachmentService 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.
      * NowAttachmentService should be created after initializing the NowSDK.
      */
    suspend fun getNowAttachmentService(): NowAttachmentService? {
      if (nowAttachmentService != null) return nowAttachmentService
    
      return NowDataSDK.makeAttachmentService(URL("https://instance-name.service-now.com"))
        .getOrThrow()
        .also { this.nowAttachmentService = it }
    }

    NowDataSDK – makeTableService(instanceURL: URL)

    Erstellt und initialisiert eine Instanz der NowTableService-Funktion.

    Dieser Service ermöglicht den Zugriff auf die REST- Tabellen -API in einer ServiceNow -Instanz. Weitere Informationen zur REST- Tabellen -API finden Sie unter Tabellen-API.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    instanceURL URL URL der Instanz ServiceNow, auf die zugegriffen werden soll. Beispiel: „https://instance.servicenow.com“
    Tabelle : 8. Ausgabe
    Typ Beschreibung
    Ergebnis<NowTableService> NowTableService-Objekt in ein Kotlin-Ergebnisobjekteingeschlossen.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    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 }
    }