NowDataSDK-Klasse – Android

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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://instanz.servicenow.com“
    Tabelle : 2. Ausgabe
    Typ Beschreibung
    Ergebnis<NowGraphQLService> NowGraphQLService-Objekt in 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 Instanz ServiceNow verfügbar gemacht werden.

    Darüber hinaus können Sie anwenderdefinierte geskriptete REST APIs in Ihrer Instanz ServiceNow entwickeln und in Ihrer Anwendung Android mithilfe 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://instanz.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 -Instanz ServiceNow hochladen, herunterladen und löschen. Nachdem Sie einen Anhang in Ihre -Instanz hochgeladen haben, generiert sie Metadaten für den Anhang, die Sie dann in Ihre Anwendung Android 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://instanz.servicenow.com“
    Tabelle : 6. Ausgabe
    Typ Beschreibung
    Ergebnis<NowAttachmentService> NowAttachmentService-Objekt in einem 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 Ihnen 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://instanz.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 }
    }