{
  "DataSources": [
    {
      "Id": "JOBS",
      "Rows": [
        [
          "10011",
          "10011 - Test Generic Project",
          "TEST",
          "12345AA",
          "19 Nov 2013",
          "12 Somewhere Road"
        ],
        [
          "ZDS654",
          "ZDS654 - Maintenance Costs to Excavator",
          "TEST",
          "",
          "27 Nov 2013",
          "24 Somewhere Else Road"
        ],
        [
          "ZDF662",
          "ZDF662 - Maintenancedoor jouw API-eindpunt moet zijn geformatteerd.

Invoer
Type
Beschrijving
DataSources
Verzameling van DataSource
Verzameling met de Gegevensbronnen die zijn aangevraagd.

Als er niets is veranderd sinds de LastUpdated ontvangen van de app-aanvraag.

Dan kun je een reactie retourneren zonder de eigenschap DataSources gedefinieerd. Of, als je meerdere gegevensbronnen retourneert.

Dan zijn geen Rows, NewRows en 
DeletedRows eigenschappen ingesteld 
op degenen die je niet wilt bijwerken.
LastUpdated      
verplicht
DateTime
(JJJJ-MM-DDTHH:MI:SS)
Het moment waarop de rijen voor deze Gegevensbronnen het laatst zijn bijgewerkt. 

Over het algemeen raden we aan de huidige datum en tijd van jouw hostserver te gebruiken bij het verwerken van de aanvraag.

De app slaat deze waarde op en verzendt deze exact zoals ontvangen in de LastUpdated en LastUpdateds velden van de volgende GET-aanvraag.

Dit biedt een centraal moment voor incrementele updates, vooral omdat de app met de tijd van jouw server synchroniseert in plaats van te vertrouwen op de onbetrouwbare apparaattijd. 

De "T" in de vereiste indeling is een scheidingsteken.
De array "Rows" in de GET-reactie van jouw eindpunt (gedetailleerd in de tabel hieronder) is een verzameling van waarden (Val), elk vertegenwoordigt de afzonderlijke kolomwaarde voor die Rij.

Elke Rij moet minstens twee waarden (Val) bevatten. De eerste Val moet de unieke identifier of sleutel zijn die gebruikt wordt om deze specifieke rij waarden geretourneerd door jouw eindpunt te identificeren.
De eerste waarde (Val) is ook essentieel als sleutel voor het uitvoeren van incrementele verwijderingen via het DeletedRows veld hierboven vermeld.
De tweede waarde (Val) moet de standaard weergaveable labeltekst van de rij zijn. Je kunt dit standaard overschrijven door het veld Display Options in te stellen op de Data Source "Settings" pagina.
Invoer
Type
Beschrijving
Id
verplicht
String
De Externe ID van de DataSource waarvoor de gekoppelde Rij-gegevens gelden. 
Moet overeenkomen met de Externe ID geconfigureerd op de Data Source -> Settings pagina op het platform.

Rows


Verzameling van Rij
Een verzameling Rijen die alle huidige Data Source rijen op de app volledig zullen vervangen.
Als je Rows opgeeft, worden alle waarden in NewRows en DeletedRows genegeerd.

NewRows

Verzameling van Rij
Een verzameling rijen die moeten worden toegevoegd/bijgewerkt naar de bestaande data source rijen op de app.
Gebruik dit veld om incrementele invoegingen/updates voor jouw Data Source uit te voeren.
DeletedRows
Verzameling van Rij
Een verzameling Rij Items die moeten worden verwijderd uit de bestaande Data Source rijen op de app.
Gebruik dit veld om incrementele verwijderingen van jouw Data Source uit te voeren.
Elke Rij moet één Val element bevatten die jouw unieke identifier voor de Rij is om te verwijderen.

Elke waarde in de "Rows" array komt overeen met een kolom in de dataset die jouw eindpunt retourneert. Hieronder staat een samenvatting van hoe elke geretourneerde waarde moet worden geformatteerd.
Invoer
Type
Beschrijving
Val
verplicht
String
Een kolomwaarde voor deze rij kan elke string waarde bevatten.
Als je wilt dat deze kolom een pictogram/afbeelding in de mobiele app weergeeft.
Geef de HTTP URL van de afbeelding op. 
De gekoppelde afbeelding moet in PNG of JPG/JPEG indeling zijn.
Jouw webservice moet een HTTP-status op 400-niveau retourneren als de GET mislukt.

Voorbeeldcode 
C# voorbeeld dat de aanvraag- en responsstructuren als eenvoudige klassen schematiseert.
Ook als je C# niet gebruikt, kan het bekijken van de eigenschappen en structuur in codevorm erg nuttig zijn om aan de slag te gaan met jouw eigen Platform Replicate service.





Platform Replicate – Aanvraag- en Responsstructuur.cs












using System;
using System.Collections.Generic;

namespace Example.HostedGET
{
    // Data Transfer Object (DTO) klassen voor webservices gekoppeld aan Hosted GET connectors op Gegevensbronnen.
    // Een Hosted GET service stelt de rijen voor een Gegevensbron van een extern systeem/database bloot.
    // De service moet de request payload accepteren die in de DRows klasse hieronder wordt beschreven, 
    // en moet reageren met de payload beschreven in de DRowsResponse klasse.

    /// <summary>
    /// Request DTO klasse voor oproepen gedaan door de app naar Hosted GET webservices.
    /// </summary>
    public class DRowsRequest
    {
        /// <summary>
        /// Kommagescheiden lijst van Externe IDs voor elke Gegevensbron die de app wil synchroniseren.  
        /// Je stelt de Externe ID in op de Gegevensbron via de App Builder -> Data Sources -> Settings pagina in het platform.
        /// </summary>
        public string Ids { get; set; }

        /// <summary>
        /// Kommagescheiden lijst van laatst bijgewerkte waarden voor elke externe id in Ids die de app wil synchroniseren.  
        /// Waarden worden in dezelfde volgorde als Ids vermeld en bevatten een lege waarde als de gerelateerde gegevensbron niet eerder is aangevraagd.
        /// Gebruik dit om incrementele app-updates te implementeren, waarbij je alleen de nieuwe/bijgewerkte en verwijderde rijen terugstuurt sinds de app voor het laatst is ingecheckt. 
        /// Dit wordt aanbevolen voor grote Gegevensbronnen om serverbronnen te besparen en voorkomen dat mobiele gegevenstoewijzingen uitgeput raken.
        /// </summary>
        public string LastUpdateds { get; set; }

        /// <summary>
        /// Jouw unieke Bedrijfs-Id, te vinden op de Organisatie Setup pagina in het platform
        /// </summary>
        public int ProviderId { get; set; }

        /// <summary>
        /// Jouw unieke Integratiemodule, te vinden op de Organisatie Setup pagina in het platform
        /// </summary>
        public string IntegrationKey { get; set; }

        /// <summary>
        /// E-mailadres van de ingelogde app-gebruiker die de aanvraag doet
        /// </summary>
        public string Email { get; set; }
    }

    /// <summary>
    /// Response DTO klasse voor oproepen gedaan door de app naar Hosted GET webservices.
    /// </summary>
    public class DRowsResponse
    {
        /// <summary>
        /// Verzameling met de Gegevensbronnen die zijn aangevraagd.
        /// </summary>
        public DSources DataSources { get; set; }

        /// <summary>
        /// Het moment waarop de rijen voor deze Gegevensbron het laatst zijn bijgewerkt.  
        /// We raden aan dat dit de huidige datum en tijd op jouw hostserver is op het moment van verwerking van de aanvraag.
        /// Deze waarde wordt opgeslagen door de app en verzonden in het LastUpdateds veld van de volgende Rij Search aanvraag gedaan door de app.
        /// Dit geeft een centraal moment voor incrementele updates in het bijzonder, omdat de app jouw servertijden echo zal gebruiken in plaats van jouw eigen onbetrouwbare apparaattijd.
        /// </summary>
        public DateTime LastUpdated { get; set; }
    }

    public class DSource
    {
        /// <summary>
        /// De Externe Id van de Dataummary>
        /// Een verzameling van Rows die moeten worden toegevoegd/bijgewerkt aan de bestaande Data Source rijen in de app.
        /// Gebruik dit veld om incrementele inserts/updates van je Data Source uit te voeren.
        /// </summary>
        public Rows NewRows { get; set; }

        /// <summary>
        /// Een verzameling van Row Items die moeten worden verwijderd uit de bestaande Data Source rijen in de app.
        /// Gebruik dit veld om incrementele deletes van je Data Source uit te voeren.
        /// Elke Row moet een enkel Val element bevatten dat je unieke identifier voor de Row is om te verwijderen.
        /// </summary>
        public Rows DeletedRows { get; set; }
    }
	
    public class DSources : List<DSource> { }
	
    public class Rows : List<Row> { }

    public class Row : List<string> { }

}



Problemen oplossen / Testen 
Zodra je een Platform Replicate connector op je Data Source hebt ingesteld, zal de Rows pagina voor die Data Source automatisch proberen rijen op te halen van de gegeven GET URL.
De Rows pagina maakt hetzelfde verzoek als de app, inclusief je huidige ingelogde gebruiker.
Dit is een snelle en eenvoudige manier om te zien of je Platform Replicate webservice het GET verzoek begrijpt en rijen in het juiste formaat retourneert.
Wat doe ik wanneer Platform Replicate werkt op mijn iOS app maar niet op Android?
Dit komt bijna zeker door hoe Android SSL-certificaten behandelt – Android is in feite strenger met SSL-certificaatketens dan iOS.
SSL-certificaatketens bestaan uit het primaire SSL-certificaat voor je webservice endpoint domein en eventuele tussentijdse certificaten uitgegeven door je Certificate Authority.
Als je probeert verbinding te maken met een webadres met een onvolledige SSL-keten, zal Android de verbinding weigeren.
Als je Android apparaten niet kunnen synchroniseren, kun je testen of het probleem gerelateerd is aan een onvolledige SSL-keten door je Platform Replicate service URL in je standaard Android webbrowser te bezoeken.
Je krijgt waarschijnlijk een verbindingsfout met tekst zoals "de certificaatautoriteit is ongeldig".
Je kunt je SSL-configuratie verder verifiëren met een testservice zoals SSL Labs:
https://www.ssllabs.com/ssltest
Als je SSL-installatie problemen heeft, zie je waarschuwingen zoals "keten onvolledig" in de SSL Labs testresultaten.
Om het probleem op te lossen, zorg ervoor dat de Platform Replicate webservice server de tussentijdse certificaten van je Certificate Authority heeft geïnstalleerd.
Als je bijvoorbeeld GoDaddy gebruikt, zou het beste startpunt hier zijn:
https://support.godaddy.com/help/article/868/what-is-an-intermediate-certificate?countrysite=au
Zodra je de juiste certificaatketen hebt, zullen de Platform Replicate data sources naar je Android apparaten synchroniseren omdat zij nu verbinding kunnen maken met je webservice.
Je kunt de certificaatketen controleren door de Platform Replicate URL in je Android webbrowser te controleren. Wanneer opgelost, zou het geen certificaatfouten meer moeten tonen.