次の方法で共有


Staffbase (プレビュー)

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

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 Staffbase サポート
URL https://www.staffbase.com
Email support@staffbase.com
コネクタ メタデータ
Publisher Staffbase GmbH
Web サイト https://www.staffbase.com
プライバシー ポリシー https://staffbase.com/en/privacy-policy/
カテゴリ 通信;人的資源

Staffbase コネクタ

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

[前提条件]

  • カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
  • 組織の Staffbase ライセンス
  • Staffbase プラットフォームでの組織の管理者の役割
  • 認証を構成するための API トークン
  • アプリケーションがホストされている Staffasbe インフラストラクチャに関する情報については、 support@staffbase.com にお問い合わせください。

サポートされている操作

ChannelsGetList

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

ChannelsGetPosts

指定したチャネル内の投稿の一覧を取得する

ChannelsPostPost

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

CommentsGet

Staffbase インスタンスからすべてのコメントを取得する

MediaGet

Staffbase インスタンスからすべてのメディアを取得する

MediaGetByID

ID でメディアを取得する

MediaDelete

ID でメディアを削除する

NotificationPost

ユーザーに通知を送信する

PostsGetAll

投稿の一覧を取得する

PostsGetByID

ID で投稿を取得する

PostsDelete

投稿を削除します

PostsPut

投稿を更新する

UserGetAll

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

UserPost

名、姓、および電子メールでユーザーを招待する

UserGetByID

ユーザー情報を取得する

User_delete

ID によるユーザーの削除

UserPut

ユーザー情報を更新する

UserPostRecovery

回復用メールを送信する

ProxyVersionGet

内部使用のためだけに、現在の API プロキシのバージョンを確認する

資格情報の取得

Staffbase プラットフォームと Power Automate で作成されたワークフローの間の基本認証には、API トークンが必要です。 Staffbase Experience Studio から API トークンを 生成 できます。

はじめに

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

  1. Power Automate で、[コネクタ] に移動します。
  2. Staffbase コネクタを検索します。
  3. Staffbase コネクタをクリックします。 コネクタを構成するためのダイアログが開きます。
  4. [API トークン] フィールドで、次の構文を使用して API トークンを追加します。

: 'Basic' と API トークンの間に空のスペースを追加する必要があります。

[ホスト ID] フィールドに、Staffbase プラットフォームがホストされているインフラストラクチャの識別子を入力します。

  • ドイツのインフラストラクチャ: de1
  • 国際インフラ: us1

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

既知の問題と制限事項

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

よく寄せられる質問

Staffbase コネクタを使用して自動化できるビジネス ワークフローは何ですか?

Staffbase コネクタを使用して、多くのビジネス プロセスを自動化できます。 たとえば、従業員のアプリまたはイントラネットで、他のツールでアクションが実行されたときと同様に、従業員に直接通知します。 このようなビジネス ユース ケースの詳細については 、こちらをご覧ください

Staffbase コネクタを使用して自動化されたワークフローを使い始めるのに役立つチュートリアルはありますか?

Staffbase には、Forms プラグインと Staffbase コネクタを使用して施設管理を自動化するチュートリアルが用意されています。 このセクションで設定する方法について説明 します

デプロイ手順

次のコマンドを実行し、プロンプトに従います。

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

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

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

名前 タイプ Description 必須
API-Key securestring Staffbase インスタンスの "API-Key" 正しい
ホスティング ID 文字列 ホスティング ID を指定する: hostingID 正しい

調整制限

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

アクション

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

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

チャネル: 指定されたチャネル内の投稿の一覧を取得する

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

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

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

プロキシ: バージョンの取得

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

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

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

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

現在のコンテキストで使用可能なすべてのメディアの説明を要求します。

メディア: メディアの削除

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

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

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

ユーザー: ユーザーの削除

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

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

ユーザーはサインアップ用の電子メールを受け取ります。

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

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

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

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

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

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

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

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

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

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

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

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

投稿: 投稿を削除します

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

投稿: 投稿を更新します

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

通知: 通知を送信します

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

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

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

戻り値

名前 パス 説明
トータル
total integer

検出されたチャネルの合計数。

limit
limit integer

返される項目の量。

オフセット
offset integer

この数値から始まる項目を取得するための現在定義されているオフセット。

データ
data array of object
id
data.id string

これはチャネルの ID です。

ローカライズ
data.config.localization array of object
title
data.config.localization.title string

ローカライズされたチャネル タイトル。

ロケール
data.config.localization.locale string

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

spaceID
data.spaceID string

チャネルが割り当てられている領域の ID。

作成済み
data.created string

チャネルの作成日。

公開
data.published string

チャネルの公開日。

更新
data.updated string

チャネルの更新日。

チャネル: 指定されたチャネル内の投稿の一覧を取得する

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

パラメーター

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

getChannels によって取得されたチャネル ID をここに挿入します。

極限
limit integer

返される項目の量 (既定値と最大 100)。

オフセット
offset integer

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

戻り値

名前 パス 説明
トータル
total integer

見つかった投稿の合計数。

limit
limit integer

返される項目の量。

オフセット
offset integer

この数値から始まる項目を取得するための現在定義されているオフセット。

データ
data array of postData

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

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

パラメーター

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

ここにチャネル ID を挿入します。

外部 ID
externalID string

省略可能: 外部 ID をここに入力します。

ロケール
locale string

de_DE、en_USなどのロケールを挿入します。

コンテンツ
content string

ニュースコンテンツをここに入力します。

イメージ (リンク)
image string

ここに画像のリンクを入力します。

ティーザー
teaser string

ここでティーザーを入力します。

title
title string

ここにタイトルを入力します。

公開
published string

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

プロキシ: バージョンの取得

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

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

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

パラメーター

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

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

戻り値

Body
mediaData

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

現在のコンテキストで使用可能なすべてのメディアの説明を要求します。

パラメーター

名前 キー 必須 説明
極限
limit integer

ここで項目の数を制限します。

オフセット
offset integer

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

戻り値

名前 パス 説明
トータル
total integer

検出された資産の合計数。

limit
limit integer

返される項目の量。

オフセット
offset integer

この数値から始まる項目を取得するための現在定義されているオフセット。

データ
data array of mediaData

メディア: メディアの削除

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

パラメーター

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

メディアを ID で削除します。 これにより、サーバーからリソースがすぐに削除されますが、CDN は引き続き、CDN が無効になるまで resourceInfo.url に記載されている URL を介してコンテンツを配信できます。

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

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

パラメーター

名前 キー 必須 説明
SCIM 表記を使用してフィルター処理できます
filter string

SCIM 表記を使用してフィルター処理できます。

フルテキスト検索をフィルターと組み合わせることができます。
query string

ここでは、任意のプロファイル フィールドで serach を実行できます。

ユーザー: ユーザーの削除

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

パラメーター

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

ID は、Staffbase プラットフォームによって自動的に生成される UserID または externalID (ユーザーに対して追加される場合) のいずれかに基づくことができます。

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

ユーザーはサインアップ用の電子メールを受け取ります。

パラメーター

名前 キー 必須 説明
メール
email string

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

ファーストネーム
firstName string

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

苗字
lastName string

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

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

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

パラメーター

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

ID は、Staffbase プラットフォームによって自動的に生成される UserID または externalID (ユーザーに対して追加される場合) のいずれかに基づくことができます。

戻り値

Body
userData

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

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

パラメーター

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

ID は、Staffbase プラットフォームによって自動的に生成される UserID または externalID (ユーザーに対して追加される場合) のいずれかに基づくことができます。

id
id string

ユーザーの ID

外部 ID
externalID string

ユーザーの外部 ID

ファーストネーム
firstName string

ユーザーの名

苗字
lastName string

ユーザーの姓

publicEmailAddress
publicEmailAddress string

ユーザーのパブリック電子メール

ロケール
locale string

ユーザーのロケール

メール
value string

電子メール アドレス

主要な
primary boolean

プライマリ メールですか?

groupIDs
groupIDs array of string
立場
position string

ユーザーの位置

部署
department string

ユーザーの部署

位置
location string

ユーザーの場所

phoneNumber
phoneNumber string

ユーザーの電話番号

作成済み
created string

ユーザーの作成日

更新
updated string

ユーザーの更新日

アクティブ
activated string

ユーザーはアクティブ化されていますか?

戻り値

Body
userData

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

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

パラメーター

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

ID は、Staffbase プラットフォームによって自動的に生成される UserID または externalID (ユーザーに対して追加される場合) のいずれかに基づくことができます。

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

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

パラメーター

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

これは投稿の ID です。

戻り値

Body
postData

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

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

パラメーター

名前 キー 必須 説明
Manage
manage boolean

true の場合、トークン ロールでコメントの管理が許可され、発行されていないコメントも一覧に表示されます。

極限
limit integer

返される項目の量 (既定値と最大 100)。

オフセット
offset integer

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

Filter
filter string

部分的なサポートを使用して SCIM2 形式でフィルター処理します。 現時点では、フラット構造体 (入れ子になった句なし) と eq = "equals"、gt = "greater than"、ge = "greater than or equals"、lt = "less than"、le = "less than or equals" などの比較句のみがサポートされています。 コメントでサポートされているフィルター フィールドは、作成および更新されます。 これらのフィールドの値は、UTC DateTime 文字列で表すか、Unix エポックのミリ秒単位で指定できます。 例 1: filter=updated ge "2020-11-26T10:14:48.947Z" を更新し、le "2020-11-26T10:14:48.947Z" を更新しました。 この例では、DateTime 範囲フィルターは、ge および le 比較句とブール句を含む更新されたフィールドに適用されます。 例 2: filter=created gt "2020-11-26T10:14:48.947Z" ポイントされた日付の後に作成されたすべてのコメントを取得します。

戻り値

名前 パス 説明
トータル
total integer

見つかったコメントの合計数。

limit
limit integer

返される項目の量。

オフセット
offset integer

この数値から始まる項目を取得するための現在定義されているオフセット。

データ
data array of object
id
data.id string

これはコメントの ID です。

parentID
data.parentID string

コメントの親の ID には、投稿またはコメントを指定できます。

親タイプ
data.parentType string

親の型には、投稿またはコメントを指定できます。

コメント テキスト
data.text string

これはコメントコンテンツ/テスト自体です。

post ID
data.rootID string

これは、このコメントが関連する投稿の ID です

作成者
data.author authorObject
トータル
data.likes.total integer

これは、コメントのいいね! の数です。

isLiked
data.likes.isLiked string

このコメントは気に入っていますか?

作成済み
data.created string

コメントの作成日。

更新
data.updated string

コメントの更新日。

イメージ
data.image imageObject

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

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

パラメーター

名前 キー 必須 説明
Query
query string

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

極限
limit integer

返される項目の量 (既定値と最大 100)。

オフセット
offset integer

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

管理
manageable boolean

指定された投稿コンテンツ タイプのオプション のフィルター。 既定では、フィルター処理は行われません。

コンテンツタイプ
contentType string

指定された投稿コンテンツ タイプのオプション のフィルター。 (既定値はフィルター処理しない)

戻り値

名前 パス 説明
トータル
total integer

見つかった投稿の合計数。

limit
limit integer

返される項目の量。

オフセット
offset integer

この数値から始まる項目を取得するための現在定義されているオフセット。

データ
data array of postData

投稿: 投稿を削除します

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

パラメーター

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

これは、API によって定義された投稿 ID か、post externalID を設定した場合のいずれかになります。

戻り値

名前 パス 説明
識別子
identifier integer

削除の識別子。

ステータスコード
statusCode integer

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

メッセージ
message string

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

type string

アクションの種類。

投稿: 投稿を更新します

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

パラメーター

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

これは、API によって定義された投稿 ID か、post externalID を設定した場合のいずれかになります。

外部 ID
externalID string

省略可能: 外部 ID をここに入力します。

ロケール
locale string

de_DE、en_USなどのロケールを挿入します。

コンテンツ
content string

ニュースコンテンツをここに入力します。

イメージ
image string

ここに画像へのリンクを入力します。

ティーザー
teaser string

ここでティーザーを入力します。

title
title string

ここにタイトルを入力します。

公開
published string

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

通知: 通知を送信します

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

パラメーター

名前 キー 必須 説明
accessorIds
accessorIds array of string
ロケール
locale string

de_DE、en_USなどのロケールを挿入します。

title
title string

言語に依存するタイトルを挿入します。

リンク
link string

Optinal: ここにリンクを挿入します。

戻り値

名前 パス 説明
id
id string

これは通知の ID です。

accessorIds
recipients.accessorIds array of string

受信者 ID の一覧です。

コンテンツ
content array of object
title
content.title string

ローカライズされた通知のタイトル。

ロケール
content.locale string

これはタイトルのロケールです。

リンク
link string

これが通知リンクです。

type string

これは通知の種類です。

createdAt
createdAt string

通知の作成日。

作成済み
created string

通知の作成日。

定義

mediaData

名前 パス 説明
id
id string

これは資産の ID です。

ownerID
ownerID string

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

parentID
parentID string

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

publicID
publicID string

これは、資産にアクセスするためのパブリック ID です。

resourceInfo.type string

これは資産リソースの種類です。

バイト
resourceInfo.bytes integer

これはリソース サイズ (バイト単位) です。

width
resourceInfo.width integer

これはリソースの幅です。

高さ
resourceInfo.height integer

これはリソースの高さです。

URL
resourceInfo.url string

これはリソース URL です。

format
resourceInfo.format string

これはリソース形式です。

mimeType(マイムタイプ)
resourceInfo.mimeType string

これは、リソース MIME の種類です。

fileName
fileName string

これはメディア ファイル名です。

title
title string

これはメディア タイトルです。

ラベル
label string

これがメディア ラベルです。

作成済み
created string

資産の作成日。

ユーザーデータ

名前 パス 説明
id
id string

ユーザーの ID

外部 ID
externalID string

ユーザーの外部 ID

ファーストネーム
firstName string

ユーザーの名

苗字
lastName string

ユーザーの姓

publicEmailAddress
publicEmailAddress string

ユーザーのパブリック電子メール

ロケール
config.locale string

ユーザーのロケール

メール
emails array of object

ユーザーの電子メール情報

メール
emails.value string

電子メール アドレス

主要な
emails.primary boolean

プライマリ メールですか?

groupIDs
groupIDs array of string
立場
position string

ユーザーの位置

部署
department string

ユーザーの部署

位置
location string

ユーザーの場所

phoneNumber
phoneNumber string

ユーザーの電話番号

作成済み
created string

ユーザーの作成日

更新
updated string

ユーザーの更新日

アクティブ
activated string

ユーザーはアクティブ化されていますか?

postData

名前 パス 説明
id
id string

投稿の ID。

作成者
author authorObject
contents
contents array of object
コンテンツ
contents.content string

ローカライズされた投稿コンテンツ。

イメージ
contents.image imageObject
ティーザー
contents.teaser string

ローカライズされた投稿ティーザー。

title
contents.title string

ローカライズされた投稿タイトル。

ロケール
contents.locale string

これは項目のロケールです。

id
channel.id string

これはチャネルの ID です。

ローカライズ
channel.config.localization array of object
title
channel.config.localization.title string

これはローカライズされたチャネル タイトルです。

ロケール
channel.config.localization.locale string

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

公開
published string

投稿の公開日。

作成済み
created string

投稿の作成日。

更新
updated string

投稿の更新日。

authorObject

名前 パス 説明
ファーストネーム
firstName string

これは著者の名です。

id
id string

これは作成者の ID です。

苗字
lastName string

これは著者の姓です。

URL
avatar.original.url string

著者アバター画像オリジナルURLです。

width
avatar.original.width integer

著者アバター画像の元の幅です。

高さ
avatar.original.height integer

著者アバター画像オリジナルの高さです。

size
avatar.original.size integer

これは、作成者のアバター 画像の元の sie (バイト単位) です。

format
avatar.original.format string

これは、作成者アバターの元の形式です。

mimeType(マイムタイプ)
avatar.original.mimeType string

これは、アターアバター画像オリジナル mimeType です。

作成済み
avatar.original.created string

これは、作成者アバターの元の作成日です。

URL
avatar.icon.url string

これは作成者アバター アイコンの URL です。

width
avatar.icon.width integer

これは作成者アバター アイコンの幅です。

高さ
avatar.icon.height integer

これは作成者アバター アイコンの高さです。

format
avatar.icon.format string

これは作成者のアバター アイコン形式です。

mimeType(マイムタイプ)
avatar.icon.mimeType string

これは作成者アバター アイコン mimeType です。

URL
avatar.thumb.url string

これは作成者アバターのサム URL です。

width
avatar.thumb.width integer

これは作成者アバターの親指の幅です。

高さ
avatar.thumb.height integer

これは著者のアバターの親指の高さです。

format
avatar.thumb.format string

これは作成者アバターのサム形式です。

mimeType(マイムタイプ)
avatar.thumb.mimeType string

これは、アターアバターサム mimeType です。

publicID
avatar.publicID string

これは作成者アバターのパブリック ID です。

imageObject

名前 パス 説明
URL
original.url string

これはイメージの元の URL です。

width
original.width integer

これはイメージの元の幅です。

高さ
original.height integer

これはイメージの元の高さです。

size
original.size integer

これは、イメージの元のサイズ (バイト単位) です。

format
original.format string

これはイメージの元の形式です。

mimeType(マイムタイプ)
original.mimeType string

これは、イメージの元の mimeType です。

URL
original_scaled.url string

これはイメージの元の URL です。

width
original_scaled.width integer

これはイメージの元の幅です。

高さ
original_scaled.height integer

これはイメージの元の高さです。

format
original_scaled.format string

これはイメージの元の形式です。

mimeType(マイムタイプ)
original_scaled.mimeType string

これは、イメージの元の mimeType です。

URL
compact.url string

これは画像のコンパクトな URL です。

width
compact.width integer

これは、画像のコンパクトな幅です。

高さ
compact.height integer

これは、画像のコンパクトな高さです。

format
compact.format string

これは、画像のコンパクトな形式です。

mimeType(マイムタイプ)
compact.mimeType string

これは画像コンパクト mimeType です。