SaaS アプリ開発者ガイド

​

1 ローコード SaaS アプリ開発のエンドツーエンドプロセス

​

1.1 前提条件

​

1.2 SaaS 開発ワークベンチへのアクセス方法

​

1.3 対応する aPaaS プラットフォーム機能

• プラットフォーム機能：

​

2 メインアプリの設計

前提条件が完了したら、SaaS アプリの構築を開始できます。他の YiDA 組織で完全なソリューションを保有しており、それを直接 SaaS モードに切り替えたい場合は、YiDA プロダクト・エンジニアリングチームに連絡し、SaaS 環境への移行を申請してください。

1. SaaS 開発ワークベンチと現在プラットフォームが提供している機能を使用し、業務要件に合わせてアプリを設計します。例：

2. SaaS 製品に関連するベースライン業務データがあり、サブスクライブ後にサンプルデータをサブスクライバーに表示させたい場合は、この「ベースラインデータ」を入力し、「ベースライン業務データ」という単一のフォルダーに格納して管理してください（下記の例を参照）。

​

3 クールアプリの設計

​

4 アプリのリリース

​

4.1 アプリバージョン管理

• アプリの機能に変更があった場合は、新しいバージョンを作成できます。新しいバージョンはデフォルトで「未公開」状態です。「公開」をクリックしてバージョンをリリースします。

​

4.2 アプリ公開申請 — サードパーティアプリのリンク

​

ステップ 1：サードパーティアプリをリンク

​

ステップ 2：SaaS アプリ開発情報の入力

​

ステップ 3：SaaS アプリ設定項目の確認

(1) アプリ開発情報の確認

1. DingTalk Open Platform のサードパーティ社内アプリで、登録済みのサードパーティアプリを選択し、すべての機能設定項目が完了していることを確認します。未完了の項目があれば入力を完了させます。

(2) 権限管理

1. 「権限管理」メニューを選択します。標準的な SaaS 製品は以下の権限を選択し、「一括申請」をクリックする必要があります。

2. SaaS 製品が「統合と自動化 > コネクタノード」の「DingTalk 公式」コネクタを使用する場合は、YiDA チームに連絡し、選択する必要があるファーストパーティコネクタの権限を確認してください。

​

ステップ 4：セキュリティセルフチェックのスキップを自主申請

1. セルフチェックをスキップするには、以下のように「イベントとコールバック」を設定します。

private static final char[] HEX_ARRAY = "0123456789abcdef".toCharArray();

public static String bytesToHex(byte[] bytes) {
        char[] hexChars = new char[bytes.length * 2];
        for (int i = 0; i < bytes.length; i++) {
            int v = bytes[i] & 0xFF;
            hexChars[i * 2] = HEX_ARRAY[v >>> 4];
            hexChars[i * 2 + 1] = HEX_ARRAY[v & 0x0F];
        }
        return new String(hexChars);
    }

private static String decrypt(String input) throws NoSuchAlgorithmException {
        MessageDigest digest = MessageDigest.getInstance("SHA-256");
        byte[] hash = digest.digest(input.getBytes(StandardCharsets.UTF_8));
        // ハッシュを 43 文字の暗号化文字列に変換
        return bytesToHex(hash).substring(0, 43);
}

2. アプリセルフチェックの「セキュリティレビュー」内容を完了させます。セキュリティ受け入れ評価については、📎YiDA Cool SaaS セキュリティ受け入れガイド - ISV.pdf を参照してください。

​

4.3 Trial 組織管理

​

4.3.1 メインアプリの Trial テスト

一般ロジック：変更を行った後、ISV が新しいバージョンをリリースした場合、対象機能については顧客のローカル設定が優先されます。メインアプリの変更は子アプリに同期されません。変更を行わなかった場合、メインアプリの増分リソース変更は子アプリに同期されます。 承認フロー変更ロジック：

1. 子アプリが V0 をサブスクライブしており、メインアプリに未公開の V1 がある場合、V1 は子アプリのバージョン履歴に表示されません。
2. 子アプリがカスタマイズなしで V0 をサブスクライブしており、メインアプリが後に V1 にアップグレードした場合、子アプリは引き続きサブスクライブ済みの V0 を表示・実行します。
3. 子アプリが V0 をサブスクライブしてカスタマイズを行った場合、V0 の内部履歴バージョンと V1 のドラフトが作成されます。子アプリが新バージョンをサブスクライブした後は、現在のプロセスはメインアプリのアップグレードに追従しなくなります。
4. 上記のバージョンスコープには、バージョン内のすべての業務ルールや式が含まれます。

3. デフォルトで、メインアプリの「ベースライン業務データ」フォームのデータが子アプリに引き継がれ、ベースラインデータがそのまま動作します。変更にも対応しています。

​

4.3.2 クールアプリの Trial テスト

​

5 アプリ運用

​

5.1 バージョンアップグレード

1. デフォルトでは、アップグレード対象は現在公開中のバージョン以降にリリースされた最新のイテレーションです。
2. 複数の有料組織にまたがる一括バージョンアップグレードに対応しています。

リモート運用機能は近日公開予定です。

​

5.2 アプリアクティベーション権限付与ランディングページ

• PC 版とモバイル版の権限付与ランディングページを別々にアップロードします（チャンネルごとに 1 枚のみサポート）。
• アップロード後、「Trial アクセス URL」をコピーし、パートナー自主運営プラットフォーム > サードパーティ社内アプリ > 製品公開管理 > アプリ詳細 > 管理 > 「アプリ内権限付与設定」に移動します。統合が完了しセルフ受け入れが合格した後（👉 受け入れプロセスの詳細はこちら）、SaaS アプリを DingTalk 検索など、DingTalk のより多くのオンラインチャンネルで展開できるようになります。

​

6 FAQ