Share via

Staffbase (プレビュー)

  • リファレンス

Staffbase コネクタを使用すると、さまざまなツールやシステムをブリッジし、Staffbase プラットフォームを自動化されたワークフローに統合できます。 これには、プロセスを自動化したり、スケジュールに従ってタスクを実行したり、イベントが発生したときにユーザーに通知したりするための従業員アプリまたはイントラネットが含まれます。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Staffbase サポート
[URL] https://www.staffbase.com
メール support@staffbase.com
Connector Metadata
発行者 Staffbase
Web サイト https://www.staffbase.com
プライバシー ポリシー https://staffbase.com/en/privacy-policy/
カテゴリ コミュニケーション; 人事

Power Automate の Staffbase コネクタを使用すると、異なるツールとシステム間のギャップをブリッジし、Staffbase プラットフォームを自動化されたワークフローに含みます。 従業員のアプリやイントラネットを含む自動化されたワークフローの力を活用して、プロセスを自動化したり、スケジュールに従ってタスクを実行したり、イベントの発生時にユーザーに通知したりします。

前提条件

  • Microsoft 365 での Power Automate 管理者以上の役割。
  • Power Automate でのにプレミアム アカウント。
  • 組織の Staffbase ライセンス
  • Staffbase プラットフォームでの組織における管理者の役割
  • 認証を設定するための API トークン
  • アプリケーションがホストされている Staffasbe インフラストラクチャに関する情報については、support@staffbase.com にお問い合わせください

資格情報の入手方法

Staffbase プラットフォームと Power Automate に作成されたワークフロー間の基本認証については、API トークンが必要です。 Staffbase エクスペリエンス スタジオから、API トークンの生成 が可能です。

コネクタの使用を開始する

基本認証とホスティング URL を使用してコネクタを構成します。

  1. Power Automate で データ > 接続 に移動します。
  2. 接続の作成 または + 新しい接続 をクリックします。 コネクタの一覧を開きます。
  3. Staffbase コネクタを一覧で探します。
  4. + をクリックして、接続を作成します。 接続を作成するためのダイアログが開きます。
  5. API Token フィールドで、次の構文を使用して API トークンを追加します: Basic [API-Token] 注: 'Basic' と API token の間に空のスペースを追加する必要があります。
  6. Hosting ID フィールド で、Staffbase プラットフォームがホストされているインフラストラクチャの識別子を入力します: German hosting infrastructure: main-de1 US American hosting infrastructure: main-us1
  7. 作成 をクリックします。

詳細については、Staffbase サポート ポータル を参照してください。

既知の問題と制限事項

Staffbase コネクタは現在、すべての Staffbase API をサポートしているわけではありません。 Staffbase API の詳細については、Staffbase 開発者ポータル を参照してください。

一般的なエラーと解決策

ここで、コネクタを使用するときに一般的に発生する可能性のあるエラー (HTTP ステータス コード エラーなど) と、エラーを解決するためにユーザーが実行する必要があることを強調する必要があります。

よくあるご質問

  1. Staffbase コネクタを使用して、自動化できるビジネス ワークフローは何ですか ? たくさんのビジネス プロセスが Staffbase コネクタを使用して自動化できます。 たとえば、他のツールでアクションが発生したときに、従業員アプリまたはイントラネットで従業員に直接通知します。 このようなビジネス ユース ケースの詳細については、こちら を参照してください。

  2. Staffbase コネクタを使用して自動化されたワークフローを開始するのに役立つチュートリアルはありますか ? Staffbase では、Forms プラグインと Staffbase コネクタを使用して施設管理を自動化するチュートリアルを提供しています。 設定詳細については、セクション を参照してください。

接続の作成

コネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名称 タイプ 内容 必要
API キー securestring Staffbase インスタンスの "API-Key" True
Hosting ID string ホスト ID を指定する: hostingID True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

チャネル: ニュース チャネルの一覧を取得する

ニュース チャンネルの一覧を取得します。
チャネル: 指定したチャネルが含む投稿の一覧を取得する

指定したチャネルが含む投稿の一覧を取得します。
チャネル: 特定のチャネルに投稿を送信する

特定のニュース チャネルに投稿を送信します。
プロキシ: バージョンを取得する

現在のプロキシ バージョンを返します。
メディア: ID でメディアを取得する

ID で 1 つのメディアからメタデータを取得します。
メディア: メディアをすべて取得する

API トークンでアクセスできるメディアのメタデータをすべて取得します。
メディア: メディアを削除する

現在のコンテキストで指定したメディアを削除します。
ユーザー: ユーザーの一覧を取得する

API アクセス トークンに応じたユーザーの一覧を取得します。
ユーザー: ユーザーを削除する

指定したユーザーを削除します。
ユーザー: ユーザーを招待する

サインアップするメールをユーザーに送信します。
ユーザー: ユーザー情報を取得する

ユーザー ID で特定のユーザー情報を取得します。
ユーザー: ユーザー情報を更新する

ユーザー情報を更新します。
ユーザー: 復元メールを送信する

指定したユーザーに復元メールを送信します。
投稿: ID で投稿を取得する

一連のコメントを含む指定した投稿を要求します。
投稿: コメントを取得する

コメントの一覧を取得します。
投稿: 投稿の一覧を取得する

API トークンでアクセスできる投稿の一覧を取得します。
投稿: 投稿を削除する

システムから投稿を削除します。
投稿: 投稿を更新する

投稿を更新します。変更済みフィールドのみ (増分)。
通知: 通知を送信する

指定したユーザーに通知を送信します。

チャネル: ニュース チャネルの一覧を取得する

操作 ID:
ChannelsGetList

ニュース チャンネルの一覧を取得します。

戻り値

名前 パス 型 説明
total
 total integer

見つかったチャネルの総数。
limit
 limit integer

返品される品目の数量。
offset
 offset integer

この数値から始まる項目を取得するために、現在定義しているオフセット。
data
 data array of object
id
 data.id string

これはチャネルの ID です。
ローカライズ
 data.config.localization array of object
役職
 data.config.localization.title string

ローカライズ済みのチャンル タイトル。
locale
 data.config.localization.locale string

これはチャネル タイトルのロケールです。
spaceID
 data.spaceID string

チャネルを割り当てたスペースの ID。
作成済み
 data.created string

チャネルの作成日。
公開済み
 data.published string

チャネルの公開日。
更新済
 data.updated string

チャネルの更新日。

チャネル: 指定したチャネルが含む投稿の一覧を取得する

操作 ID:
ChannelsGetPosts

指定したチャネルが含む投稿の一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ChannelID
 channelID True string

ここには、たとえば getChannels で取得したチャネルの ID を挿入します。
Limit
 limit integer

返品すべき品目の数量 (既定値および最大値は 100)。
オフセット
 offset integer

オフセットを定義して、この数値から始まる項目を取得します。

戻り値

名前 パス 型 説明
total
 total integer

見つかった投稿の総数。
制限
 limit integer

返品される品目の数量。
offset
 offset integer

この数値から始まる項目を取得するために、現在定義しているオフセット。
data
 data array of postData

チャネル: 特定のチャネルに投稿を送信する

操作 ID:
ChannelsPostPost

特定のニュース チャネルに投稿を送信します。

パラメーター

名前 キー 必須 型 説明
ChannelID
 channelID True string

ここにはチャネルの ID を挿入します。
externalID
 externalID string

オプション: ここには外部 ID を入力します。
locale
 locale string

ロケールを挿入します。例: de_DE、en_US など
コンテンツ
 content string

ここにはニュースのコンテンツを入力します。
画像 (リンク)
 image string

ここには画像のリンクを入力します。
ティーザー
 teaser string

ここには自分のティーザーを入力します。
役職
 title string

ここには自分の役職を入力します。
公開済み
 published string

ここには公開した日付を入力します。

戻り値

プロキシ: バージョンを取得する

操作 ID:
ProxyVersionGet

現在のプロキシ バージョンを返します。

戻り値

メディア: ID でメディアを取得する

操作 ID:
MediaGetByID

ID で 1 つのメディアからメタデータを取得します。

パラメーター

名前 キー 必須 型 説明
MediumID
 mediumID True string

特定のメディアの情報を要求します。

戻り値

本文​​
mediaData

メディア: メディアをすべて取得する

操作 ID:
MediaGet

API トークンでアクセスできるメディアのメタデータをすべて取得します。

パラメーター

名前 キー 必須 型 説明
限度
 limit integer

ここで項目の件数を制限します。
オフセット
 offset integer

クエリのオフセットを設定します。

戻り値

名前 パス 型 説明
total
 total integer

見つかった資産の総数。
limit
 limit integer

返品される品目の数量。
offset
 offset integer

この数値から始まる項目を取得するために、現在定義しているオフセット。
data
 data array of mediaData

メディア: メディアを削除する

操作 ID:
MediaDelete

現在のコンテキストで指定したメディアを削除します。

パラメーター

名前 キー 必須 型 説明
MediumID
 mediumID True string

ID でメディアを削除します。 サーバーからすぐにリソースを削除しますが、CDN を無効化するまでは、resourceInfo.url に記載された URL を介して CDN がコンテンツを配信する可能性があります。

戻り値

ユーザー: ユーザーの一覧を取得する

操作 ID:
UserGetAll

API アクセス トークンに応じたユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
フィルターには SCIM 記法を使用できます
 filter string

フィルターには SCIM 記法を使用できます。
フィルターと組み合わせて全文検索できます
 query string

任意のプロファイル フィールドを、ここから検索できます。

戻り値

ユーザー: ユーザーを削除する

操作 ID:
UserDelete

指定したユーザーを削除します。

パラメーター

名前 キー 必須 型 説明
UserID
 userID True string

ユーザーに追加した場合、この ID は、Staffbase プラットフォームが自動で生成した UserID、または externalID のどちらかに基づきます。

戻り値

ユーザー: ユーザーを招待する

操作 ID:
UserPost

サインアップするメールをユーザーに送信します。

パラメーター

名前 キー 必須 型 説明
email
 email string

これはユーザーのメール アドレスです。
firstName
 firstName string

これはユーザーの名です。
lastName
 lastName string

これはユーザーの姓です。

戻り値

ユーザー: ユーザー情報を取得する

操作 ID:
UserGetByID

ユーザー ID で特定のユーザー情報を取得します。

パラメーター

名前 キー 必須 型 説明
UserID
 userID True string

ユーザーに追加した場合、この ID は、Staffbase プラットフォームが自動で生成した UserID、または externalID のどちらかに基づきます。

戻り値

本文​​
userData

ユーザー: ユーザー情報を更新する

操作 ID:
UserPut

ユーザー情報を更新します。

パラメーター

名前 キー 必須 型 説明
UserID
 userID True string

ユーザーに追加した場合、この ID は、Staffbase プラットフォームが自動で生成した UserID、または externalID のどちらかに基づきます。
id
 id string

ユーザーの ID
externalID
 externalID string

ユーザーの外部 ID
firstName
 firstName string

ユーザーの名
lastName
 lastName string

ユーザーの姓
publicEmailAddress
 publicEmailAddress string

ユーザーの公開電池メール
locale
 locale string

ユーザーのロケール
email
 value string

メール アドレス
プライマリ
 primary boolean

プライマリ メールですか?
groupIDs
 groupIDs array of string
position
 position string

ユーザーの役職
部署
 department string

ユーザーの部署
location
 location string

ユーザーの所在地
phoneNumber
 phoneNumber string

ユーザーの電話番号
作成済み
 created string

ユーザーの作成日
更新済
 updated string

ユーザーの更新日
アクティブ化
 activated string

ユーザーはアクティブですか?

戻り値

本文​​
userData

ユーザー: 復元メールを送信する

操作 ID:
UserPostRecovery

指定したユーザーに復元メールを送信します。

パラメーター

名前 キー 必須 型 説明
UserID
 userID True string

ユーザーに追加した場合、この ID は、Staffbase プラットフォームが自動で生成した UserID、または externalID のどちらかに基づきます。

戻り値

投稿: ID で投稿を取得する

操作 ID:
PostsGetByID

一連のコメントを含む指定した投稿を要求します。

パラメーター

名前 キー 必須 型 説明
PageID
 pageID True string

これは投稿の ID です。

戻り値

本文​​
postData

投稿: コメントを取得する

操作 ID:
CommentsGet

コメントの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
管理
 manage boolean

true に設定し、トークン ロールにコメントの管理を許可する場合 - 非公開のコメントも一覧に表示されます。
限度
 limit integer

返品すべき品目の数量 (既定値および最大値は 100)。
オフセット
 offset integer

オフセットを定義して、この数値から始まる項目を取得します。
フィルター​​
 filter string

部分的にサポートされている SCIM2 形式でフィルタリングします。 今のところ、フラット構造 (ネストされた句は無い) と、eq = 「等しい」、gt = 「より大きい」、ge = 「以上」、lt = 「より小さい」、le = 「以下」などの比較句のみがサポートされています。 サポートされているフィルター フィールドのコメント: 作成および更新されます。 これらのフィールド値は、UTC DateTime 文字列の表現または Unix エポックの長いミリ秒数で指定できます。 例 1: フィルター = ge は「2020-11-26T10:14:48.947Z」に、le は「2020-11-26T10:14:48.947Z」に更新されました。 この例では、DateTime 範囲フィルターが、ge および le 比較句とブール値の句を含む更新されたフィールドに適用されます。 例 2: フィルター = gt は「2020-11-26T10:14:48.947Z」に作成されました。 指定された日付の後に作成されたすべてのコメントを取得します。

戻り値

名前 パス 型 説明
total
 total integer

見つかったコメントの総数。
limit
 limit integer

返品される品目の数量。
offset
 offset integer

この数値から始まる項目を取得するために、現在定義しているオフセット。
data
 data array of object
id
 data.id string

これはコメントの ID です。
parentID
 data.parentID string

コメントの親の ID。投稿またはコメントのどちらか。
parentType
 data.parentType string

親の種類は、投稿またはコメントのどちらかです。
コメント テキスト
 data.text string

これはコメントのコンテンツ/テストそのものです。
投稿 ID
 data.rootID string

このコメントが関連する投稿の ID
著者
 data.author authorObject
total
 data.likes.total integer

これはコメントに付いた「いいね」の件数です。
isLiked
 data.likes.isLiked string

このコメントに「いいね」が付きましたか?
作成済み
 data.created string

コメントの作成日。
更新済
 data.updated string

コメントの更新日。
画像
 data.image imageObject

投稿: 投稿の一覧を取得する

操作 ID:
PostsGetAll

API トークンでアクセスできる投稿の一覧を取得します。

パラメーター

名前 キー 必須 型 説明
Query
 query string

投稿コンテンツの検索に使用できる文字列。
限度
 limit integer

返品すべき品目の数量 (既定値および最大値は 100)。
オフセット
 offset integer

オフセットを定義して、この数値から始まる項目を取得します。
管理可能
 manageable boolean

特定の投稿コンテンツ タイプのオプション フィルター。 既定ではフィルターしません。
ContentType
 contentType string

特定の投稿コンテンツ タイプのオプション フィルター。 (既定ではフィルターしません)

戻り値

名前 パス 型 説明
total
 total integer

見つかった投稿の総数。
制限
 limit integer

返品される品目の数量。
offset
 offset integer

この数値から始まる項目を取得するために、現在定義しているオフセット。
データ
 data array of postData

投稿: 投稿を削除する

操作 ID:
PostsDelete

システムから投稿を削除します。

パラメーター

名前 キー 必須 型 説明
PageID
 pageID True string

これは、API が定義した投稿 ID であるか、設定した場合は投稿の externalID です。

戻り値

名前 パス 型 説明
識別子
 identifier integer

削除の識別子。
statusCode
 statusCode integer

アクションの状態コード。
message
 message string

アクションのメッセージ。
type
 type string

アクションの種類。

投稿: 投稿を更新する

操作 ID:
PostsPut

投稿を更新します。変更済みフィールドのみ (増分)。

パラメーター

名前 キー 必須 型 説明
PageID
 pageID True string

これは、API が定義した投稿 ID であるか、設定した場合は投稿の externalID です。
externalID
 externalID string

オプション: ここには外部 ID を入力します。
locale
 locale string

ロケールを挿入します。例: de_DE、en_US など
コンテンツ
 content string

ここにはニュースのコンテンツを入力します。
画像
 image string

ここには画像のリンクを入力します。
ティーザー
 teaser string

ここには自分のティーザーを入力します。
役職
 title string

ここには自分の役職を入力します。
公開済み
 published string

ここには公開した日付を入力します。

戻り値

通知: 通知を送信する

操作 ID:
NotificationPost

指定したユーザーに通知を送信します。

パラメーター

名前 キー 必須 型 説明
accessorIds
 accessorIds array of string
locale
 locale string

ロケールを挿入します。例: de_DE、en_US など
肩書き
 title string

言語に依存したタイトルを挿入します。
リンク
 link string

オプション: ここにリンクを挿入します。

戻り値

名前 パス 型 説明
id
 id string

これは通知の ID です。
accessorIds
 recipients.accessorIds array of string

これは受信者 ID の一覧です。
コンテンツ
 content array of object
役職
 content.title string

ローカライズした通知のタイトル。
locale
 content.locale string

これはタイトルのロケールです。
リンク
 link string

これは通知のリンクです。
type
 type string

これは通知の種類です。
createdAt
 createdAt string

通知の作成日。
作成済み
 created string

通知の作成日。

定義

mediaData

名前 パス 型 説明
id
 id string

これは資産の ID です。
ownerID
 ownerID string

これは、この資産の所有者 ID です。
parentID
 parentID string

これは親メディア資産の ID です。
publicID
 publicID string

これは資産にアクセスするための公開 ID です。
type
 resourceInfo.type string

これは資産リソースの種類です。
バイト
 resourceInfo.bytes integer

これはリソースのサイズです (バイト単位)。
幅
 resourceInfo.width integer

これはリソースの幅です。
高さ
 resourceInfo.height integer

これはリソースの高さです。
url
 resourceInfo.url string

これはリソースの URL です。
format
 resourceInfo.format string

これはリソースの形式です。
mimeType
 resourceInfo.mimeType string

これはリソースの MIME タイプです。
fileName
 fileName string

これはメディアのファイル名です。
役職
 title string

これはメディア タイトルです。
ラベル
 label string

これはメディアのラベルです。
作成済み
 created string

資産の作成日。

userData

名前 パス 型 説明
id
 id string

ユーザーの ID
externalID
 externalID string

ユーザーの外部 ID
firstName
 firstName string

ユーザーの名
lastName
 lastName string

ユーザーの姓
publicEmailAddress
 publicEmailAddress string

ユーザーの公開電池メール
locale
 config.locale string

ユーザーのロケール
emails
 emails array of object

ユーザーのメール情報
email
 emails.value string

メール アドレス
プライマリ
 emails.primary boolean

プライマリ メールですか?
groupIDs
 groupIDs array of string
position
 position string

ユーザーの役職
部署
 department string

ユーザーの部署
location
 location string

ユーザーの所在地
phoneNumber
 phoneNumber string

ユーザーの電話番号
作成済み
 created string

ユーザーの作成日
更新済
 updated string

ユーザーの更新日
アクティブ化
 activated string

ユーザーはアクティブですか?

postData

名前 パス 型 説明
id
 id string

投稿の ID。
author
 author authorObject
目次
 contents array of object
コンテンツ
 contents.content string

ローカライズ済みの投稿コンテンツ。
画像
 contents.image imageObject
ティーザー
 contents.teaser string

ローカライズ済みの投稿ディーザー。
役職
 contents.title string

ローカライズ済みの投稿タイトル。
locale
 contents.locale string

これは項目のロケールです。
id
 channel.id string

これはチャネルの ID です。
ローカライズ
 channel.config.localization array of object
役職
 channel.config.localization.title string

これはローカライズ済みのチャンネル タイトルです。
locale
 channel.config.localization.locale string

これはチャネル タイトルのロケールです。
公開済み
 published string

投稿の公開日。
作成済み
 created string

投稿の作成日。
更新済
 updated string

投稿の更新日。

authorObject

名前 パス 型 説明
firstName
 firstName string

これは作成者の名です。
id
 id string

これは作成者の ID です。
lastName
 lastName string

これは作成者の姓です。
url
 avatar.original.url string

これは作成者のアバター画像の元の URL です。
幅
 avatar.original.width integer

これは作成者のアバター画像の元の幅です。
高さ
 avatar.original.height integer

これは作成者のアバター画像の元の高さです。
サイズ
 avatar.original.size integer

これは作成者のアバター画像の元のサイズです (バイト単位)。
format
 avatar.original.format string

これは作成者のアバターの元の形式です。
mimeType
 avatar.original.mimeType string

これは作成者のアバター画像の元の MIME タイプです。
作成済み
 avatar.original.created string

これは作成者のアバターの元の作成日です。
url
 avatar.icon.url string

これは作成者のアバター アイコンの URL です。
幅
 avatar.icon.width integer

これは作成者のアバター アイコンの幅です。
高さ
 avatar.icon.height integer

これは作成者のアバター アイコンの高さです。
format
 avatar.icon.format string

これは作成者のアバター アイコンの形式です。
mimeType
 avatar.icon.mimeType string

これは作成者のアバター アイコンの MIME タイプです。
url
 avatar.thumb.url string

これは作成者のアバターに対するサムの URL です。
幅
 avatar.thumb.width integer

これは作成者のアバターに対するサムの幅です。
高さ
 avatar.thumb.height integer

これは作成者のアバターに対するサムの高さです。
format
 avatar.thumb.format string

これは作成者のアバターに対するサムの形式です。
mimeType
 avatar.thumb.mimeType string

これは作成者のアバターに対するサムの MIME タイプです。
publicID
 avatar.publicID string

これは作成者のアバターの公開 ID です。

imageObject

名前 パス 型 説明
url
 original.url string

これは画像に使用する元の URL です。
幅
 original.width integer

これは画像に使用する元の幅です。
高さ
 original.height integer

これは画像に使用する元の高さです。
サイズ
 original.size integer

これは画像の元のサイズです (バイト単位)。
format
 original.format string

これは画像に使用する元の形式です。
mimeType
 original.mimeType string

これは画像に使用する元の MIME タイプです。
url
 original_scaled.url string

これは画像に使用する元の URL です。
幅
 original_scaled.width integer

これは画像に使用する元の幅です。
高さ
 original_scaled.height integer

これは画像に使用する元の高さです。
format
 original_scaled.format string

これは画像に使用する元の形式です。
mimeType
 original_scaled.mimeType string

これは画像に使用する元の MIME タイプです。
url
 compact.url string

これは縮小画像の URL です。
幅
 compact.width integer

これは縮小画像の幅です。
高さ
 compact.height integer

これは縮小画像の高さです。
format
 compact.format string

これは縮小画像の形式です。
mimeType
 compact.mimeType string

これは縮小画像の MIME タイプです。