Versions Compared

Version Old Version 1 New Version 2
Changes made by

Marco Suter (Unlicensed)

Marco Suter (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2

Einzelnes Objekt via DataContract lesen

...

Code Block
languagec#
public class MyCoreIdentityDataContract
{
    public string Nachname { get; set; }
    [JsonProperty("Stadt / Ort")]
    public string City { get; set; }
}

public async Task GetCoreIdentityByIdDataContractGetCoreIdentityById()
{
    var api = GetService<IApiV2Client>();
    var endpoint = api.DmcoreService.Servicedmcore.CoreIdentity;
    MyCoreIdentityDataContract item = await endpoint.GetByIdAsync<MyCoreIdentityDataContract>(3);
}

...

Code Block
languagec#
public async Task GetCoreIdentityByIdDynamicGetCoreIdentityById()
{
    var api = GetService<IApiV2Client>();
    var endpoint = api.DmcoreService.Servicedmcore.CoreIdentity;
    var item = await endpoint.GetByIdAsync(3, new
    {
        Nachname = string.Empty
    });
}

Liste von Objekten via DataContract lesen

Als Eigenschafts-Filter werden die Property-Namen (oder falls vorhanden die Value des JsonPropertyAttributes) des DataContracts verwendet

SDK-Methode

Code Block
languagec#
IPagedAsyncEnumerable<TResult> IApiV2Endpoint.GetListAsync<TResult>(
  Action<ListOptions<IListModifier>> options = null, 
  CancellationToken cancellationToken = default
);

REST-Equivalent

Kein exaktes equivalent vorhanden da IPagedAsyncEnumerable<TResult> im Hintergrund ein Paging ausführt und weitere Einträge bei Bedarf nachgeladen werden.

Code Block
GET /apiv2/servicedmcore/CoreIdentity
?fields=Nachname,Stadt%20%2F%20Ort

Beispiel-Code

Code Block
languagec#
public class MyCoreIdentityDataContract
{
    public string Nachname { get; set; }
    [JsonProperty("Stadt / Ort")]
    public string City { get; set; }
}

public async Task GetCoreIdentityList()
{
    var api = GetService<IApiV2Client>();
    var endpoint = api.DmcoreService.Servicedmcore.CoreIdentity;
    var list = await endpoint.GetListAsync<MyCoreIdentityDataContract>().ToArray();
}

Liste von Objekten via Template-Objekt lesen

Als Eigenschafts-Filter werden die Property-Namen des Template-Objektes verwendet. Abfragen für Eigenschaften welche als Property nicht gültig sind (z.B: Namen mit Leerzeichen) sind mit dieser Methode nicht möglich

SDK-Methode

Code Block
languagec#
IPagedAsyncEnumerable<TResult> IApiV2Endpoint.GetListAsync<TResult>(
  TResult template, 
  Action<ListOptions<IListModifier>> options = null, 
  CancellationToken cancellationToken = default
);

REST-Equivalent

Kein exaktes equivalent vorhanden da IPagedAsyncEnumerable<TResult> im Hintergrund ein Paging ausführt und weitere Einträge bei Bedarf nachgeladen werden.

Code Block
GET /apiv2/servicedmcore/CoreIdentity
?fields=Nachname

Beispiel-Code

Code Block
languagec#
public async Task GetCoreIdentityList()
{
    var api = GetService<IApiV2Client>();
    var endpoint = api.DmcoreService.Servicedmcore.CoreIdentity;
    var list = await endpoint.GetListAsync(new
    {
        Nachname = string.Empty
    }).ToArray();
}

Liste von Objekten mit Filter

SDK-Methode

Code Block
languagec#
IPagedAsyncEnumerable<TResult> IApiV2Endpoint.GetListAsync<TResult>(
  TResult template, 
  Action<ListOptions<IListModifier>> options = null, 
  CancellationToken cancellationToken = default
);

REST-Equivalent

Kein exaktes equivalent vorhanden da IPagedAsyncEnumerable<TResult> im Hintergrund ein Paging ausführt und weitere Einträge bei Bedarf nachgeladen werden.

Code Block
GET /apiv2/servicedmcore/CoreIdentity
?fields=Nachname
&filter=Stadt%20%2F%20Ort eq Aarau

Beispiel-Code

Code Block
languagec#
public async Task GetCoreIdentityList()
{
    var api = GetService<IApiV2Client>();
    var endpoint = api.DmcoreService.Servicedmcore.CoreIdentity;
    var list = await endpoint.GetListAsync(new
    {
        Nachname = string.Empty
    },
    o => o.AddModifier(new PropertyFilter
    {
        FilterType = FilterType.Equals,
        PropertyName = "Stadt / Ort",
        Value = "Aarau"
    })).ToArray();
}