Versions Compared

Old Version 41

changes.mady.by.user Kanako Higashi

Saved on

compared with

New Version 42

changes.mady.by.user Kanako Higashi

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languagesk

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.

Info

URL popup ponúka pokročilé možnosti pre autentizáciu a nastavenie hlavičky HTTP.

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.

Note

Prihlasovacie údaje nie sú povinné

 

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:

Názov

Popis

Príklady

$date(dateString)

Hodnotí dateString a zobrazuje dátum vo formáte rrrr-MM-dd .

$date(now + 5d -4w)
$date(2011-01-01 + 5d -4w)
$date(actualMonth -1d)

$date(dateString, format)

Funguje rovnako ako $date(dateString), ale výstupný formát je možné nastaviť parametrom format

$date(now + 5d -4w, dd-MM-yyyy)
$date(2011-01-01 + 5d -4w, MMyyyy)
$date(actualMonth -1d, yyyy-dd-MM)

$time(timeString)

Hodnotí timeString a zobrazuje čas vo formáte HH:mm:ss

$time(now)
$time(actualhour)
$time(actualminute)

$time(timeString, format)

Funguje rovnako ako $time(timeString), ale výstupný formát je možné nastaviť parametrom format 

$time(now, HH:mm:ss)
$time(actualhour, MMss)
$time(actualminute, HHmmss)

$timestamp()

Zobrazí terajší timestamp

$timestamp()

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:

Info

REST API podporuje štandarný OAuth s bezpečnostným mechanizmom (security token).

Tutoriálové video

HTML
<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

Sv translation
languageja

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

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

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

URLでの接続はファイルのインポートと類似しています。その上、URLのインポートは自動で繰り返し実行されるようスケジューリングできます。

Info

URLポップアップは URLポップアップは、認証と特定のHTTPヘッダー設定の先進的なセクションを提供します。設定の詳細セクションを提供します。

URLへの接続

URLに接続

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

接続パラメーター

URLソースの接続には次のパラメーターを入力する必要があります以下のパラメーターを入力して、URLソースに接続します:

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

続けてファイルインポートを同様に設定してください。次に、Importing from Fileなどの設定を続けます。

Note

ログイン情報とパスワードは任意のパラメーターです。ログインとパスワードは、任意のパラメーターです。

 

日付と時刻変数

URLやHTTPポストコンテンツを大々的に変更する必要がある場合、既定義の変数を使用できます。BellaDatiは現在、日付、時刻、時刻表示をユーザー定義形式で得る機能をサポートしています:

名前

説明

例

$date(dateString)

dateStringを評価、日付をyyyy-MM-dd 形式でアウトプットｚします。dateString

$date(now + 5d -4w)
$date(2011-01-01 + 5d -4w)
$date(actualMonth -1d)

$date(dateString, format)

$date(dateString)のように作用しますが、 アウトプット形式はformatパラメーターにコントロールされます。

$date(now + 5d -4w, dd-MM-yyyy)
$date(2011-01-01 + 5d -4w, MMyyyy)
$date(actualMonth -1d, yyyy-dd-MM)

$time(timeString)

timeString を評価し、結果時間をHH:mm:ss形式でアウトプットします。

$time(now)
$time(actualhour)
$time(actualminute)

$time(timeString, format)

$time(timeString)のように作用しますが、 アウトプット形式はformatパラメーターによってコントロールされます。

$time(now, HH:mm:ss)
$time(actualhour, MMss)
$time(actualminute, HHmmss)

$timestamp()

現在の時刻表示バリューを返します。

$timestamp()

DateString

  • now – 日付を表します
  • actualyear – 年の最初の日を表します (1.1.20XX)。 例えば、21.9.2010で選択されたactualyearは日付 1.1.2010を表します。
  • actualquarter - 四半期の最初の日を表します(1.1.20XX, 1.4.20XX, 1.7.20XX, 1.10.20XX)。例えば、21.9.2010で選択されたactualquarterは日付1.7.2010を表します。
  • actualmonth -月の最初の日を表します(1.1.20XX, 1.2.20XX, ...)。例えば、21.9.2010で選択されたactaulmonthは日付1.9.2010を表します。
  • actualweek -週の最初の日を表します(月曜日)。 例えば、21.9.2010で選択されたactualweekは日付20.9.2010 (この週の月曜日)を表します。
  • 絶対的な日付入力は、操作者がこの構文を使うことで調整できます: 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を表します。

TimeString

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

チュートリアルビデオ

HTML
<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ウェブサービスに接続

BellaDatiはHTTPプロトコルを通して、ネットワーク上の利用可能なリソースを接続することができます。 このシンプルな使用法の他に、ウェブサービスとして利用可能なより複雑なリソースを接続することもできます。ウェブサービスは、プレーンなHTTPプロトコルに基づくSOAP プロトコルを使用しています。SOAPプロトコルは標準のXML形式であり、BellaDatiで完全にサポートされています。以下は実行例です:

  1. あなたのウェブサービスのエンドポイントURLを入力し、XMLファイル形式を選択します。
  2. アドバンスセッティングを開き、POST方法を選択、以下のパラメーターを設定します。:
      1. SOAPアクション – 値はあなたのウェブサービスについて説明するWSDLファイルに含まれています。soapAction タグで定義されています。例えば: <soap:operation soapAction="http://www.sap.com/Z_HSI_HRP04_RZH_READ_DATA"/>
    2. コンテンツ-種類 – 値をtext/xmlに設定 
  3. 表される構造にPOSTコンテンツを挿入:

Info

SAPウェブサービスへの接続で問題がある場合は、WSDLに基づいたXMLの正しい構造を生み出すSoapUI のような、外部のツールを用いることをお勧めします。

SoapUIはさらに、正しいhttp ポストコンテンツを生み出す手助けをします。

 

RESTウェブサービスへの接続

BellaDatiを用いて、HTTPを通して RESTウェブサービスへ接続することもできます。適切なHTTP GETヘッダータイプとファイルタイプ (例 CSV)を選択してください。

認証

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

Info

REST APIはセキュリティートークンのOAuth基準 をサポートしています。

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.


 

次に

...