Page History

BellaDati can import data from URLs, web services and REST APIs.

Connecting to URL has similarities with file import . In addition URL imports can be scheduled to execute automatically and repeatedly.

Connecting to URL

From Data Source Connectors page select Connect over HTTP.

Connection Parameters

Enter following parameters to connect to URL source:

• URL: Web address
• File content: Select the file format - CSV (text file), Excel (XLS, XLSX), XML, JSON or ZIP
• Authentication: No Authentication, Simple, oAuth1a, oAuth2

Then continue setting like for file import .

Date and Time Variables

If you need to change the URL or HTTP post content dynamically, you can use predefined variables. BellaDati currently supports functions to get date, time or timestamp in user defined formats:

$firstValue(L_DATE_ATTRIBUTE) //returns 2013-01-01

$firstValue(L_TIME_ATTRIBUTE) //returns 10:00:54

$lastValue(L_DATE_ATTRIBUTE) //returns 2013-12-31

$lastValue(L_TIME_ATTRIBUTE) //returns 23:59:59

DateString

• now - represents actual date
• actualyear - represents the first day of actual year (1.1.20XX). For example actualyear selected on 21.9.2010 represents date 1.1.2010
• actualquarter - represents the first day of actual quarter (1.1.20XX, 1.4.20XX, 1.7.20XX, 1.10.20XX). For example actualquarter selected on 21.9.2010 represents date 1.7.2010
• actualmonth - represents the first day of actual month (1.1.20XX, 1.2.20XX, ...). For example actaulmonth selected in 21.9.2010 represents date 1.9.2010
• actualweek - represents first day of actual week (Monday). For example actualweek selected on 21.9.2010 represents date 20.9.2010 (Monday of this week in calendar)
• relative and absolute enterig of date can be adjusted by operators using this syntax: date +|- n[d|w|m|q|y], where n is integer, d represents day, w represents week, m represents month q represents quartal and y represents year. We can for example define time in this way:  actualyear + 2m -4d. Today is 21.9.2010, so this value represents 1.1.2010 + 2 months - 4 days, which means date 25.2.2010.

TimeString

• now - represents actual time
• actualhour - represents the actual hour at 0 minutes and 0 seconds.
• actualminute - represents the actual minute at 0 seconds
• actualsecond - represents the actual second

TUTORIAL VIDEO

<iframe width="560" height="315" src="https://www.youtube.com/embed/wMG1n4jEf2k" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Connecting to SOAP web Services

BellaDati is able to connect resources available on network via the HTTP protocol. Except this simple usage, we can connect also more complex resources available as Web services. Web services are using the SOAP protocol, which is based on the plain HTTP protocol. The SOAP message comes in standard XML format, which is in BellaDati perfectly supported. Here is an example how to do it:

1. Enter the endpoint URL of your web service and choose the XML file format.
2. Open the advanced settings, choose the POST method and set the following parameters:
   1. SOAPAction - value is contained in the WSDL file, which describes your web service. It is defined in the soapAction tag, e.g.: <soap:operation soapAction="http://www.sap.com/Z_HSI_HRP04_RZH_READ_DATA"/>
   2. Content-Type - set the value to text/xml
3. Insert the POST content in the depicted structure:

Connecting to REST web services

You can connect to REST web services over HTTP using BellaDati. Just select the proper HTTP GET header type and file type (eg. CSV).

Authentication

The following authentication methods are supported:

• Basic and Digest HTTP Access Authentication ( RFC2617 standard )
• OAuth1a
• OAuth2

For OAuth1a, following connection parameters are available: 

• Consumer Key,
• Consumer Secret,
• Request Token URL,
• Token Authorization URL,
• Access Token URL.

For OAuth2, it is also possible to define Resource and State parameters, which are used for example when connecting to Office 365 services.

Connecting to Office 365 via HTTP Connector

This example will show how to connect to Office 365 via HTTP Connector and how to import list of contacts from the e-mail account.

1. Select Connect over HTTP from list of data sources.
2. Fill in the URL, in this example https://outlook.office.com/api/v1.0/me/contacts/?$orderby=displayname%20asc.  
3. Change File content to JSON.
4. Select OAuth2 authentication.
5. Add HTTP header with name Accept and value  text/*, multipart/mixed, application/xml, application/json; odata.metadata=none.
   
   
6. In Authentication settings, fill in the OAuth Access Token which you generated in Office 365 and set the OAuth Token Type to Bearer (see Office 365 settings below).
7. Click on Sign in using OAuth and fill in all the parameters. Set the scope accordingly to the token.
   
   
8. Click on Continue and import the data.

Office 365 settings

1. Go to https://portal.azure.com/
2. In the left menu, click on Azure Active Directory and then on  App registrations .
3. Add new application registration, select Web app/API and fill in the URL of your BellaDati application.
4. In Reply URLs, add new record: URLofYourBD/auth/callback/oauth2
5. In Required permissions, add:
   1. Office 365 Exchange Online (Microsoft.Exchange) -  Read contacts in all mailboxes
   2. Windows Azure Active Directory (Microsoft.Azure.ActiveDirectory)  - Sign in and read user profile
6. In Keys, add a new key and copy the credentials.

Next Steps

• Take me back to data sources
• Import settings
• Scheduling Import

  List siblings

BellaDati je schopné importovať dáta z URL, webových služieb a RESP API.

Pripojenie na URL je podobné importu súboru. Avšak v porovnaní s týmto importom, je možné pri URL nastaviť interval opakovania.

Pripojenie cez URL

Zo zoznamu zdrojov dát vyberte Obsah z URL.

Parametre pripojenia

Pre pripojenie k URL zadajte nasledujúce parametre: 

• URL: Webová adresa
• Obsah súboru: Vyberte formát cieľového súboru - 
• Autentizácia: Bez autentizácia, Jednoduchá, oAuth1a, oAuth2

Nasledujúce nastavenia sú rovnaké ako pri importe súboru.

Premenné času a dátumu

Ak potrebujete aby sa obsah URL alebo HTTP menil dynamicky, použite prednastavené premenné. BellaDati podporuje funkciu získavania času, dátumu alebo timestamp v použivateľom definovaných formátoch:

DateString

• now - zobrazí aktuálny dátum 
• actualyear - zobrazí prvý deň aktuálneho roku (teda actualyear zadaný 21.9.2010 zobrazí hodnotu 1.1.2010).
• actualquarter - zobrazí prvý deň aktuálneho štvrťroku (1.1.20XX, 1.4.20XX, 1.7.20XX, 1.10.20XX).
• actualmonth - zobrazí prvý deň aktuálneho mesiacazň (1.1.20XX, 1.2.20XX, ...). 
• actualweek - zobrazí prvý deň aktuálneho týždňa (Pondelok). 
• relatívne a absolútne zadaný čas je môžne upraviť pomocou funkcii: dátum +|- n[d|w|m|q|y], kde n je celé číslo, d je deň, w víkend, m zastupuje mesiac, q štvrťrok a y je rok. Príklad: actualyear + 2m -4d. Dnes je 21.9.2010, takže nami zadana hodnota znamena  1.1.2010 + 2 mesiace - 4 dni, a teda zobrazí dátum  25.2.2010.

TimeString

• now - zobrazí aktuálny čas
• actualhour - zobrazí aktuálnu hodinu (napr. 9:30:23 zobrazí ako 9:00:00).
• actualminute - zobrazí aktuálnu minútu.
• actualsecond - zobrazí aktuálnu sekundu. 

Pripojenie na SOAP webové služby 

BellaDati je schopné pripojiť sa k dátam dostupným na sieti pomocou protokolu HTTP. Naviac sa dokáže pripojiť na ďalšie komplexnejšie zdroje prístupne na webe. Webové služby využívajú protokol SOAP, ktorý je založený na čistom HTTP protokole. Správy zo SOAP sú v štandardnom XML formáte, ktorý BellaDati bezproblémovo podporuje. Tu je príklad použitia:

1. Zadajte URL Vami požadovanej webovej služby a vyberte formát XML .
2. Otvorte pokročilé nastavenia, vyberte metódu POST a zadajte nasledujúce parametre: 
   1. SOAPAction - hodnota je zadaná v súbore WSDL, ktorý popisuje Vašu webovú službu. Je určená v popise soapAction, napr.: <soap:operation soapAction="http://www.sap.com/Z_HSI_HRP04_RZH_READ_DATA"/>
   2. Content-Type - nastaví hodnotu text/xml
3. Vložte obsah POST do nasledujúcej štruktúry: 

Pripojenie na REST webové služby

Taktiež je možné pripojiť BellaDati na webové služby využívajúce REST. Stačí vybrať správny HTTP GET header a druh súboru (napr. CSV).

Autentizácia

BellaDati podporuje nasledujúce autentizačné metódy:

• Základný a pokročilý  HTTP Access Authentication (RFC2617 standard).

Tutoriálové video

<iframe width="560" height="315" src="https://www.youtube.com/embed/wMG1n4jEf2k" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Kam ďalej

• Späť na zdroje dát
• Nastavenia importu
• Plánovanie importu 

  List siblings

BellaDatiは、URL、Webサービス、REST APIからデータをインポートすることができます。

URLへの接続は、Importing from Fileと類似しています。さらに、URLのインポートは、自動的に繰り返し実行されるようスケジューリングできます。

URLに接続

データソースに接続するページからHTTPで接続を選択してください。 

接続パラメーター

以下のパラメーターを入力して、URLソースに接続します:

• URL: Webアドレス
• ファイルコンテンツ: ファイル形式を選択します - CSV (テキストファイル)、Excel (XLS, XLSX)、XML、JSON、ZIP
• 認証: 認証なし、シンプル、oAuth1a、oAuth2

次に、Importing from Fileなどの設定を続けます。

日付と時刻の変数

URLやHTTPポストコンテンツを動的に変更する必要がある場合、事前定義された変数を使用できます。BellaDatiは現在、ユーザー定義の形式で日付、時刻、タイムスタンプを取得する関数をサポートしています:

$firstValue(L_DATE_ATTRIBUTE) //returns 2013-01-01

$firstValue(L_TIME_ATTRIBUTE) //returns 10:00:54

$lastValue(L_DATE_ATTRIBUTE) //returns 2013-12-31

$lastValue(L_TIME_ATTRIBUTE) //returns 23:59:59

DateString

• now – 日付を表します。
• actualyear – 年の最初の日を表します (20XX.1.1)。 例えば、2010.9.21に選択されたactualyearは、日付2010.1.1を表します。
• actualquarter – 四半期の最初の日を表します(20XX.1.1、20XX.4.1、20XX.7.1、20XX.10.1)。例えば、2010.9.21に選択されたactualquarterは、日付2010.7.1を表します。
• actualmonth – 月の最初の日を表します(20XX.1.1、20XX.2.1, ...)。例えば、2010.9.21に選択されたactaulmonthは、日付2010.9.1を表します。
• actualweek – 週の最初の日を表します(月曜日)。 例えば、2010.9.21に選択されたactualweekは、日付2010.9.20(この週の月曜日)を表します。
• 絶対的な日付入力は、操作者がこの構文を使うことで調整できます: date +|- n[d|w|m|q|y]、 nが整数の時、d は日、 w は週、m は月、qは四半期、yは年を表します。例えばこのように定義できます:  actualyear + 2m -4d。今日は21.9.2010であるため、このバリューは1.1.2010 + 2 months - 4 days、つまり日付は25.2.2010を表します。
• 日付の相対および絶対入力は、次の構文を使用して演算子で調整できます: date +|- n[d|w|m|q|y]、nは整数、dは日、wは週、mは月、qは四半期、yは年を表します。例えば、次のように時間を定義できます: actualyear + 2m -4d。今日は2010年9月21日であるとすると、この値は2010.1.1 + 2か月 - 4日、つまり日付2010.2.25を表します。

TimeString

• now – 時間を表します。
• actualhour – 時間を0分0秒で表します。
• actualminute – 分を0秒で表します。
• actualsecond – 秒を表します。

チュートリアルビデオ

<iframe width="560" height="315" src="https://www.youtube.com/embed/wMG1n4jEf2k" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

SOAP webサービスに接続

BellaDatiは、HTTPプロトコルを介してネットワーク上で利用可能なリソースに接続できます。この単純な使用法を除いて、Webサービスとして利用可能なより複雑なリソースも接続できます。 Webサービスは、プレーンHTTPプロトコルに基づくSOAPプロトコルを使用しています。 SOAPメッセージは標準のXML形式で提供され、BellaDatiで完全にサポートされています。これを行う方法の例を次に示します:

1. webサービスのエンドポイントURLを入力し、XMLファイル形式を選択します。
2. 詳細設定を開き、POSTメソッドを選択、以下のパラメーターを設定します:
   
   1. SOAPAction – 値は、Webサービスを説明するWSDLファイルに含まれています。soapActionタグで定義されています。例: <soap:operation soapAction="http://www.sap.com/Z_HSI_HRP04_RZH_READ_DATA"/>
   2. Content-Type – 値をtext/xmlに設定します。
3. 表される構造にPOSTコンテンツを挿入します:

REST webサービスに接続

BellaDatiを使用して、HTTP経由でREST Webサービスに接続できます。適切なHTTP GETヘッダータイプとファイルタイプ（例: CSV）を選択するだけです。

認証

サポートされる認証方法は次の通りです:

• 基本アクセス認証およびダイジェストHTTPアクセス認証 (RFC2617標準)。
• OAuth1a
• OAuth2

OAuth1aの場合、次の接続パラメーターを使用できます:

• コンシューマキー
• コンシューマシークレット
• リクエストトークンURL
• トークン認証URL
• アクセストークンURL

OAuth2の場合、例えばOffice 365サービスに接続する時に使用されるResourceおよびStateパラメーターを定義することもできます。 

HTTPコネクター経由でOffice 365に接続

この例では、HTTPコネクターを介してOffice 365に接続する方法と、電子メールアカウントから連絡先のリストをインポートする方法を示します。

1. データソースのリストから[HTTP経由で接続]を選択します。
2. URL（この例では https://outlook.office.com/api/v1.0/me/contacts/?$orderby=displayname%20asc.）に入力します。
3. ファイルのコンテンツをJSONに変更します。
4. OAuth2認証を選択します。
5. Acceptという名前とtext/*, multipart/mixed, application/xml, application/json; odata.metadata=noneという値を持つHTTPヘッダーを追加します。
   
   
6. [認証設定]で、Office 365で生成したOAuthアクセストークンを入力し、OAuthトークンタイプをBearerに設定します（以下のOffice 365設定を参照）。
7. OAuthを使用してサインインをクリックし、すべてのパラメーターを入力します。トークンに応じてスコープを設定します。
    
8. [続行]をクリックして、データをインポートします。
   

Office 365の設定 

1. https://portal.azure.com/ にアクセスします。
2. 左側のメニューで、[Azure Active Directory]をクリックし、[アプリの登録]をクリックします。
3. 新しいアプリケーション登録を追加し、Webアプリ/APIを選択して、BellaDatiアプリケーションのURLを入力します。
4. 返信URLで、新しいレコードを追加します: URLofYourBD/auth/callback/oauth2
5. [必要なアクセス許可]で、次を追加します:
   1. Office 365 Exchange Online（Microsoft.Exchange） -  すべてのメールボックスの連絡先を読み取る
   2. Windows Azure Active Directory（Microsoft.Azure.ActiveDirectory） -  サインインしてユーザープロファイルを読み取る
6. [キー]で、新しいキーを追加し、資格情報をコピーします。 

次に

• Data Sourcesに戻る
• Import Settings
• Scheduling Import 

  List siblings

BellaDati kann Daten von URLs, Webservices und REST-APIs importieren.

Das Verbinden mit einer URL hat Ähnlichkeiten mit dem Dateiimport. Außerdem können URL-Importe automatisch und wiederholt ausgeführt werden.

Verbindung zur URL herstellen

Wählen Sie auf der Seite Datenquellen-Connectors die Option Verbindung über URL herstellen.

Verbindungsparameter

Geben Sie die folgenden Parameter ein, um eine Verbindung zur URL-Quelle herzustellen:

• URL: Webadresse
• Dateiinhalt: Wählen Sie das Dateiformat aus - CSV (Textdatei), Excel (XLS, XLSX), XML, JSON oder ZIP
• Authentifizierung: Keine Authentifizierung, Einfach, oAuth1a, oAuth2

Setzen Sie dann die Einstellungen wie beim Dateiimport fort.

Datums- und Zeitvariablen

Wenn Sie den URL- oder HTTP-Post-Inhalt dynamisch ändern müssen, können Sie vordefinierte Variablen verwenden. BellaDati unterstützt derzeit Funktionen zum Abrufen von Datum, Uhrzeit oder Zeitstempel in benutzerdefinierten Formaten:

$firstValue(L_DATE_ATTRIBUTE) //returns 2013-01-01

$firstValue(L_TIME_ATTRIBUTE) //returns 10:00:54

$lastValue(L_DATE_ATTRIBUTE) //returns 2013-12-31

$lastValue(L_TIME_ATTRIBUTE) //returns 23:59:59

DateString

• now - steht für aktuelles Datum
• actualyear - entspricht dem ersten Tag des tatsächlichen Jahres (1.1.20XX). Beispielsweise repräsentiert das am 21.9.2010 ausgewählte aktuelle Jahr das Datum 1.1.2010
• actualquarter - stellt den ersten Tag des tatsächlichen Quartals dar (1.1.20XX, 1.4.20XX, 1.7.20XX, 1.10.20XX). Beispielsweise entspricht das am 21.9.2010 ausgewählte aktuelle Quartal dem Datum 1.7.2010
• actualmonth -stellt den ersten Tag des aktuellen Monats dar (1.1.20XX, 1.2.20XX, ...). Zum Beispiel entspricht actaulmonth, ausgewählt am 21.9.2010, dem Datum 1.9.2010
• actualweek - steht für den ersten Tag der tatsächlichen Woche (Montag). Beispielsweise repräsentiert die am 21.9.2010 ausgewählte tatsächliche Woche das Datum 20.9.2010 (Montag dieser Woche im Kalender).
  Die relative und absolute Eingabe des Datums kann von Operatoren mit der folgenden Syntax angepasst werden: Datum + | - n [d | w | m | q | y], wobei n eine Ganzzahl ist, d den Tag darstellt, w die Woche darstellt, m den Monat q darstellt Quartal und y steht für Jahr. Wir können zum Beispiel die Zeit auf diese Weise definieren: aktuelles Jahr + 2m -4d. Heute ist der 21.9.2010, daher entspricht dieser Wert dem 1.1.2010 + 2 Monaten - 4 Tagen, das ist das Datum 25.2.2010.

TimeString

• now -steht für die tatsächliche Zeit
• actualhour - steht für die tatsächliche Stunde bei 0 Minuten und 0 Sekunden.
• actualminute - steht für die tatsächliche Minute bei 0 Sekunden
• actualsecond - repräsentiert die tatsächliche Sekunde

TUTORIAL VIDEO

<iframe width="560" height="315" src="https://www.youtube.com/embed/wMG1n4jEf2k" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Verbindung zu SOAP-Webdiensten

BellaDati kann über das HTTP-Protokoll verfügbare Ressourcen im Netzwerk verbinden. Abgesehen von dieser einfachen Verwendung können wir auch komplexere Ressourcen verbinden, die als Web-Services verfügbar sind. Webdienste verwenden das SOAP-Protokoll, das auf dem einfachen HTTP-Protokoll basiert. Die SOAP-Nachricht wird im Standard-XML-Format geliefert, das in BellaDati perfekt unterstützt wird. Hier ist ein Beispiel, wie es geht:

1. Geben Sie die Endpunkt-URL Ihres Web-Service ein und wählen Sie das XML Dateiformat.
2. Öffnen Sie die erweiterten Einstellungen, wählen Sie die POST-Methode aus und legen Sie die folgenden Parameter fest:
   
   1. Der SOAPAction-Wert ist in der WSDL-Datei enthalten, die Ihren Webdienst beschreibt. Es ist im soapAction-Tag definiert, z.B.: <soap:operation soapAction="http://www.sap.com/Z_HSI_HRP04_RZH_READ_DATA"/>
   2. Content-Type - Setzen Sie den Wert auf text / xml
3. Fügen Sie den POST-Inhalt in die dargestellte Struktur ein:

Verbindung zu REST-Webdiensten

Sie können über BellaDati eine Verbindung zu REST-Webdiensten über HTTP herstellen. Wählen Sie einfach den richtigen HTTP-GET-Headertyp und -Dateityp aus (z. B. CSV).

Authentifizierung

Die folgenden Authentifizierungsmethoden werden unterstützt:

• Basic and Digest HTTP Access Authentication (RFC2617 standard)
• OAuth1a
• OAuth2

Für OAuth1a stehen folgende Verbindungsparameter zur Verfügung:

• Consumer Key,
• Consumer Secret,
• Token-URL anfordern,
• Token-Autorisierungs-URL,
• Zugriffstoken-URL

Für OAuth2 können auch Ressourcen- und Zustandsparameter definiert werden, die beispielsweise beim Herstellen einer Verbindung mit Office 365-Diensten verwendet werden.

Verbindung zu Office 365 über HTTP Connector

In diesem Beispiel wird gezeigt, wie Sie über HTTP Connector eine Verbindung zu Office 365 herstellen und eine Liste der Kontakte aus dem E-Mail-Konto importieren.

1. Wählen Sie Connect over HTTP aus der Liste der Datenquellen aus.
2. Geben Sie die URL ein, in diesem Beispiel https://outlook.office.com/api/v1.0/me/contacts/?$orderby=displayname%20asc. 
3. Ändern Sie den Inhalt der Datei in JSON.
4. Wählen Sie OAuth2-Authentifizierung aus.
5. Fügen Sie einen HTTP-Header mit dem Namen Accept und Wert text / *, multipart / mixed, application / xml, application / json hinzu. odata.metadata = keine.
   
   
6. Geben Sie unter Authentifizierungseinstellungen das OAuth-Zugriffstoken ein, das Sie in Office 365 generiert haben, und legen Sie den OAuth-Token-Typ auf Träger fest (siehe Office 365-Einstellungen unten).
7. Klicken Sie auf mit OAuth anmelden und geben Sie alle Parameter ein. Stellen Sie den Gültigkeitsbereich entsprechend dem Token ein.
   
   
8. Klicken Sie auf Weiter und importieren Sie die Daten.

Office 365 Einstellungen

1. Gehen Sie zu https://portal.azure.com/
2. Klicken Sie im linken Menü auf Azure Active Directory und dann auf App-Registrierungen.
3. Fügen Sie eine neue Anwendungsregistrierung hinzu, wählen Sie Web-App / API aus und geben Sie die URL Ihrer BellaDati-Anwendung ein.
4. Fügen Sie unter Antwort-URLs einen neuen Dataset hinzu: URLofYourBD / auth / callback / oauth2
5. Fügen Sie unter Erforderliche Berechtigungen folgendes hinzu:
   1. Office 365 Exchange Online (Microsoft.Exchange) - Kontakte in allen Mailboxen lesen
   2. Windows Azure Active Directory (Microsoft.Azure.ActiveDirectory) - Melden Sie sich an und lesen Sie das Benutzerprofil
6. Fügen Sie unter Schlüssel einen neuen Schlüssel hinzu und kopieren Sie die Anmeldeinformationen.

Nächste Schritte

• Bring mich zu den Datenquellen zurück
• Importeinstellungen
• Planen des Imports

  List siblings