Slack統合フォルダマッピングの管理
Slack統合フォルダマッピングの管理
このスクリプトは、BoxをSlackのコンテンツストアとして使用している場合に、SlackとBox間のフォルダマッピングの管理に役立ちます。現在のSlackチャンネルとBoxフォルダのマッピングのリストが作成されるため、入力用のcsvに基づいてマッピングを作成または更新できます。このスクリプトではすべての権限が維持されます。
詳細については、GitHubリポジトリで確認できます。
前提条件
スクリプトの複製
このGitHubリポジトリを複製するか、/examples
ディレクトリからファイルをダウンロードします
git clone https://github.com/box/boxcli.git
Windows
.NET Coreの最新バージョンのインストール
macOSおよびLinux
PowerShellをインストールします。pwsh
コマンドを実行して、インストール結果をテストします。
pwsh
どのディレクトリでこのコマンドを実行するかに応じて、出力が異なる場合があります。以下に例を示します。
PowerShell 7.2.5
Copyright (c) Microsoft Corporation.
https://aka.ms/powershell
Type 'help' to get help.
PS /Users/user/repos/boxcli/examples>
Box CLIのインストール
OAuth CLIの設定クイックスタートを使用して、Box CLIを構成してインストールします。使用しているユーザーが管理者または共同管理者であることを確認してください。
Enterprise構成
- 適切なSlackワークスペースやオーガナイゼーションでBox for Slackを構成してインストールします
- SlackのコンテンツレイヤーとしてのBoxが有効になっています
スクリプトの実行
ディレクトリを、スクリプトが格納されているフォルダ に変更します。この例では、Integration Mappings
フォルダになります。
rvb@lab:~/box-cli/examples/Integration Mappings$ pwsh
PowerShell 7.2.4
Copyright (c) Microsoft Corporation.
https://aka.ms/powershell
Type 'help' to get help.
PS /home/rvb/box-cli/examples/Integration Mappings>
EXTRACTを指定してスクリプトを実行すると、現在のマッピングが抽出されます:
./integration-mappings.ps1 -Action EXTRACT
または
UPDATEを指定してスクリプトを実行すると、現在のマッピングが更新されます:
./integration-mappings.ps1 -Action UPDATE
または
CREATEを指定してスクリプトを実行すると、新しいマッピングが作成されます:
./integration-mappings.ps1 -Action CREATE -MappingPath ./mapping_create_example.csv
デフォルトでは、csvファイルが./mappings.csvに保存され、./mappings.csvから読み込まれます。この場所を変更する場合は、次のように新しいパスを渡します:
./integration-mappings.ps1 -Action EXTRACT -MappingPath ./mappings_new_location.csv
パラメータを指定しなかった場合は、スクリプトによって、パラメータを入力するよう求められます。
スクリプトの実行が完了すると、以下のような出力が表示されます。
新しいチャンネルにマッピングを作成する際は、BoxフォルダID、SlackチャンネルID、およびSlackオーガナイゼーションIDを入力する必要があります。オーガナイゼーションIDの代わりにSlackワークスペースIDを使用できます。その場合は、csvの列見出しSlackOrgId
をSlackWorkspaceId
に置き換えます。
Starting Process
Applying new mappings
Output [...]
All bulk input entries processed successfully.
ログ
ログは、メインフォルダ内のlogs
フォルダに格納されます。以下のログファイルにアクセスできます。
Integration-mappings_all.txt
: すべてのログエントリが含まれています。Integration-mappings_errors.txt
: エラーのみが含まれています。
免責
このプロジェクトは、オープンソースの例を集めたものであるため、公式にサポートされている製品として扱わないでください。Box CLIの使用方法は、自己責任の下、例の情報源として利用してください。