Versions Compared

Old Version 40

changes.mady.by.user Ondrej Špalek

Saved on

compared with

New Version 41

changes.mady.by.user Kanako Higashi

Saved on

Key

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

...

Sv translation
languageja

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

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

Info

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

URLへの接続

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

接続パラメーター

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

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

続けてファイルインポートを同様に設定してください。

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.


 

次に

...