Intégration Coda

Bloc /embed

Coda supporte les embeds natifs via une commande slash, sans aucune configuration préalable. Ouvrez le doc Coda dans lequel vous souhaitez insérer le graphique, puis cliquez dans le corps du document à l'endroit exact où vous voulez que le graphique apparaisse.

Tapez /embed (barre oblique suivie du mot « embed ») dans l'éditeur. Coda affiche immédiatement une liste de suggestions. Cherchez et cliquez sur l'option « Embed » dans cette liste — elle peut aussi apparaître comme « Embed external content » selon la version de Coda. Une boîte de dialogue s'ouvre avec un champ de saisie d'URL.

Collez l'URL de votre embed Embases (au format https://embases.com/e/VOTRE_TOKEN pour un embed public, ou avec le paramètre ?key=... pour un embed privé) dans le champ de saisie. Appuyez sur Entrée ou cliquez sur le bouton de confirmation. Coda envoie une requête vers l'URL et charge le graphique directement dans le doc, en quelques secondes.

Alternative : Coda supporte aussi le glisser-déposer d'URL. Si vous avez l'URL de votre embed dans le presse-papiers, vous pouvez simplement la coller directement dans le doc Coda (sans taper /embed au préalable) — Coda détecte automatiquement qu'il s'agit d'une URL intégrable et propose de créer un bloc embed.

# URL publique
https://embases.com/e/VOTRE_TOKEN

# URL privée
https://embases.com/e/VOTRE_TOKEN?key=VOTRE_CLE

Taille et affichage

Une fois l'embed inséré dans votre doc Coda, vous pouvez ajuster sa taille pour l'intégrer harmonieusement dans votre contenu. Cliquez sur le bloc embed pour le sélectionner — des options de contrôle apparaissent au-dessus ou autour du bloc.

Pour modifier la hauteur du bloc, faites glisser la poignée de redimensionnement visible en bas du bloc embed vers le haut ou vers le bas. Vous pouvez aussi cliquer sur les boutons de taille prédéfinis qui apparaissent lorsque vous survolez le bloc : « Small » (petit), « Medium » (moyen) et « Large » (grand). Ces préréglages correspondent à des hauteurs approximatives de 200px, 350px et 500px respectivement.

Pour la largeur, Coda garde par défaut les blocs embed à la largeur du conteneur du doc (la colonne principale de contenu). Si vous souhaitez un affichage pleine largeur — particulièrement utile pour les graphiques larges ou les tableaux de bord — assurez-vous que votre page Coda n'utilise pas de mise en page en colonnes, ou créez une section dédiée sans colonnes pour y insérer le graphique.

Embeds dans les tables Coda

Coda offre une fonctionnalité particulièrement puissante : la possibilité d'insérer des embeds dans des cellules de tables. Cela vous permet de créer des tableaux de bord tabulaires où chaque ligne représente un projet, une période ou une entité, avec son graphique Embases associé affiché directement dans la table.

Pour utiliser cette fonctionnalité, ouvrez votre table Coda et ajoutez une nouvelle colonne. Lors du choix du type de colonne, sélectionnez le type « Embed » dans la liste des types disponibles (vous pouvez aussi partir d'un type « URL » et le transformer en « Embed »). Nommez cette colonne comme vous le souhaitez (par exemple « Graphique » ou « Dashboard »).

Dans les cellules de cette colonne, collez simplement l'URL de l'embed Embases correspondant à chaque ligne. Coda reconnaît automatiquement l'URL et affiche le graphique en miniature directement dans la cellule. En cliquant sur la cellule ou en élargissant la ligne, vous pouvez voir le graphique en plus grand. Pour les embeds privés dans les tables, stockez les URLs tokenisées complètes (avec ?key=...) dans les cellules — Coda les respecte et charge le graphique protégé.

Domain Whitelisting

Les docs Coda sont hébergés et chargés depuis le domaine coda.io. Si vous avez activé le Domain Whitelisting sur votre embed Embases, vous devez ajouter coda.io à votre liste de domaines autorisés pour que les embeds se chargent correctement dans vos docs.

Pour ajouter ce domaine, connectez-vous à votre dashboard Embases, ouvrez les paramètres de l'embed concerné, puis accédez à la section « Sécurité » → « Domaines autorisés ». Cliquez sur « Ajouter un domaine » et entrez coda.io. Cliquez sur « Enregistrer ». Rafraîchissez votre doc Coda pour vérifier que le graphique s'affiche maintenant correctement.

Note : les docs Coda publiés publiquement (partagés via un lien public ou intégrés dans d'autres pages via la fonctionnalité Share de Coda) sont également chargés depuis le domaine coda.io. Vous n'avez donc qu'un seul domaine à ajouter, qu'il s'agisse d'un doc privé ou d'un doc partagé publiquement.

# Domaine à ajouter
coda.io