Serviceklasse für die Anbindung von edoc datahub

Sie können die Klasse DatahubService z.B. in einem Aktions-Plugin verwenden, um Daten von edoc datahub abzufragen und um neue Zielobjekte oder Webhooks zu erstellen.

Klassenname und Namespace

\edoc\appserver\services\DatahubService

Öffentliche Funktionen

getClients(): array

Diese Funktion gibt eine Liste aller erstellten Mandanten zurück.

Parameter

Keine

Rückgabe

Typ	Beschreibung
array	Gibt die Liste mit allen Mandanten zurück.

getTargetObjects(): array

Diese Funktion gibt eine Liste aller erstellten Zielobjekte und deren Eigenschaften zurück.

Parameter

Keine

Rückgabe

Typ	Beschreibung
array	Gibt die Liste aller erstellten Zielobjekte und deren Eigenschaften zurück.

createTargetObject($source, $name, $text, $properties): void

Diese Funktion erzeugt ein neues Zielobjekt.

Parameter

Name	Typ	Beschreibung
source	string	Gibt den Ursprung des Objektes an, z.B. die App-ID der eigenen App, um Objekte der eigenen App zu identifizieren.
name	string	Gibt den Namen des Zielobjekts an.
text	string	Gibt den Text des Zielobjekts an.
properties	`#[ArrayShape([[` `"id" => "string",` `"text" => "string",` `"key" => "boolean",` `"source" => ["string"]` `]])] array`	Gibt die Liste mit den Eigenschaften des Zielobjektes an.

Rückgabe

Keine

getTargetObjectData($clientId, $targetObjectName, $propertyIds, $createdAfter, $updatedAfter, $pageNumber, $pageSize): array

Diese Funktion liefert die importierten Daten des Zielobjektes zurück.

Parameter

Name	Typ	Beschreibung
clientId	string	Gibt den Mandanten an.
targetObjektName	string	Gibt den Namen des Zielobjektes an.
propertyIds	array	Gibt die Liste mit den IDs der Eigenschaften des Zielobjektes an.
createdAfter	int	Gibt nur Daten zurück, die nach dem angegebenen Zeitstempel erzeugt wurden. Standard: 0
updatedAfter	int	Gibt nur Daten zurück, die nach dem angegebenen Zeitstempel aktualisiert wurden. Standard: 0
pageNumber	int	Gibt an, welche Seite der Daten geladen werden soll. Standard: 0
pageSize	int	Gibt an, wie viele Zeilen eine Seite anzeigen soll. Standard: 100

Rückgabe

Typ

Beschreibung

array

Gibt die Liste mit allen importierten Daten des Zielobjektes zurück.

Eine Zeile enthält nur die im Parameter propertyIds angegebenen Eigenschaften.

createWebhook($host, $path): string

Diese Funktion erzeugt einen neuen Webhook.

Parameter

Name

Typ

Beschreibung

host

string

Gibt die Adresse des Zielservers an.

Wenn Sie edoc-Services verwenden, geben Sie nur den Servicenamen an.

Wenn Sie externe Services verwenden, geben Sie das verwendete Protokoll an, z.B.: http://

path

string

Gibt den relativen Pfad aufzurufenden Endpunktes an.

Rückgabe

Typ	Beschreibung
string	Gibt die ID des neu erstellten Webhooks zurück.

Beispiel für ein Aktions-Plug-In

In diesem Codebeispiel werden alle Mandanten aus edoc datahub abgerufen.

PHP

<?php

namespace edoc\appserver\app\actions\plugins;

use edoc\appserver\app\AbstractAction;
use edoc\appserver\services\DatahubService;

class GetClients extends AbstractAction
{
    use \edoc\appserver\app\actions\DatasetAction;
    
    protected function init()
    {
    }

    protected function exec(): AbstractAction
    {        
      $processedClients = [];

      $dh = new DatahubService();
      $clients = $dh->getClients();
      
      foreach ($clients as $client) {
        // process client data
      }

      return $this->returnDataset($processedClients);
    
    }
}