Partager via

Almanac (Éditeur indépendant) (préversion)

Almanac construit une infrastructure collaborative pour servir la créativité humaine. À l’aide de l’outil wiki et de flux de travail le plus rapide, consolidez vos documents dans une belle source de vérité organisée.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Troy Taylor
URL https://www.hitachisolutions.com
Messagerie électronique ttaylor@hitachisolutions.com
Métadonnées du connecteur
Éditeur Troy Taylor
Site internet https://almanac.io/
Politique de confidentialité https://almanac.io/privacy-policy
Catégories Collaboration; Contenu et fichiers

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
ID de l’espace de travail ficelle ID d’espace de travail pour cette API. Vrai
Jeton d’accès (sous la forme « Bearer yourAccessToken ») securestring Jeton d’accès (sous la forme « Bearer yourAccessToken ») pour cette API. Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Ajouter un accès au document

Ajoutez l’accès au document.
Ajouter une propriété de document

Ajoutez une propriété personnalisée à un document.
Créer un dossier

Créez un dossier.
Créer un élément de manuel

Ajoutez un élément au manuel.
Créer une propriété de document

Créez une propriété de document au niveau de l’espace de travail.
Déplacer des fichiers

Déplacez des fichiers (documents et/ou dossiers) vers un dossier spécifique (dans un même espace de travail ou différent).
Importer un document

Importez un document à partir d’une source externe.
Mettre à jour les informations sur le document

Mettez à jour les métadonnées d’un document.
Mettre à jour les informations sur le dossier

Mettez à jour les métadonnées d’un dossier.
Mettre à jour l’accès aux documents

Mettez à jour l’accès à un document.
Obtenir des articles de manuel

Récupérez une liste d’éléments de manuel.
Obtenir des documents

Récupérez les métadonnées de tous les documents de l’espace de travail.
Obtenir des dossiers

Récupérez une liste de tous les dossiers.
Obtenir des groupes

Récupérer des groupes d’utilisateurs.
Obtenir des informations sur le document

Récupérez les métadonnées d’un document.
Obtenir des informations sur les dossiers

Récupérez la liste des métadonnées de dossier.
Obtenir des manuels

Récupérez la liste des manuels d’espace de travail.
Obtenir des utilisateurs

Récupérez une liste d’utilisateurs.
Obtenir des utilisateurs dans le groupe

Récupérez tous les utilisateurs d’un groupe d’utilisateurs.
Obtenir les accès aux documents

Répertorier les accès aux documents.
Obtenir les propriétés du document

Répertorier les propriétés personnalisées du document au niveau de l’espace de travail.
Obtenir les propriétés du document

Répertorier les propriétés personnalisées du document au niveau du document.
Obtenir l’importation

Récupérez des informations sur une importation existante.
Remplacer les informations de document

Mettez à jour les métadonnées d’un document.
Remplacer les informations de dossier

Remplacez les métadonnées d’un dossier.
Remplacer l’accès aux documents

Remplacez l’accès à un document.
Supprimer la propriété de document

Supprimez une propriété personnalisée d’un document.
Supprimer l’accès aux documents

Supprimez l’accès du document.
Supprimer un élément de classeur

Supprimer l’élément du manuel.
Supprimer une propriété personnalisée de document

Supprimez une propriété personnalisée de document au niveau de l’espace de travail.

Ajouter un accès au document

ID d’opération :
PostDocsDocIdAccesses

Ajoutez l’accès au document.

Paramètres

Nom Clé Obligatoire Type Description
Autorisation
 access[permission] True string

Autorisation.
Type d’accesseur
 access[accessor_type] True string

Type d’accesseur.
ID d’accesseur
 access[accessor_id] True integer

Identificateur d’accesseur.
ID de document
 doc_id True integer

Identificateur de document.

Retours

Modèle d’accès à la documentation
DocAccess

Ajouter une propriété de document

ID d’opération :
PostDocsDocIdProperties

Ajoutez une propriété personnalisée à un document.

Paramètres

Nom Clé Obligatoire Type Description
ID de propriété
 property_id True integer

Identificateur de propriété.
Valeur
 value string

Le type de param dépend du type de value propriété : 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id' : Integer }, propertyValue#ID 'multi_select' => { 'selected_item_ids' : Array[Integer] }, the selected PropertyValue#IDs 'case' => { 'checked' : Boolean } 'document' => { 'doc_id' : Integer }, the Document#ID 'person' => { 'user_ids' : Array[Integer] }, the User#IDs.
ID de document
 doc_id True integer

Identificateur de document.

Retours

Modèle de propriété Doc
DocProperty

Créer un dossier

ID d’opération :
PostFolders

Créez un dossier.

Paramètres

Nom Clé Obligatoire Type Description
Titre du dossier
 folder[title] True string

Titre du dossier.
ID de répertoire parent
 folder[parent_folder_id] integer

ID du dossier parent. Est créé à la racine de l’espace de travail s’il n’est pas fourni.

Retours

Modèle de dossier
Folder

Créer un élément de manuel

ID d’opération :
PostHandbooksHandbookIdItems

Ajoutez un élément au manuel.

Paramètres

Nom Clé Obligatoire Type Description
Type d’élément
 handbook_item[type] True string

Type d’élément du manuel.
Position de l’élément
 handbook_item[position] integer

Ajoute l’élément comme dernière position s’il n’est pas fourni.
ID d’élément parent
 handbook_item[parent_item_id] integer

ID d’élément parent à des fins d’imbrication.
ID de document
 handbook_item[doc_id] True integer

Obligatoire uniquement pour les éléments de document.
Titre de l’élément
 handbook_item[title] True string

Obligatoire uniquement pour les éléments de section et de lien.
URL de l’élément
 handbook_item[url] True string

Obligatoire uniquement pour les éléments de lien.
ID du manuel
 handbook_id True integer

Identificateur du manuel.

Retours

HandbookItem Model
HandbookItem

Créer une propriété de document

ID d’opération :
PostProperties

Créez une propriété de document au niveau de l’espace de travail.

Paramètres

Nom Clé Obligatoire Type Description
Nom de la propriété
 property[name] True string

Nom de propriété, qui doit être unique par espace de travail.
Type de propriété
 property[type] True string

Type de propriété.
Valeur par défaut pour les articles
 property[default_for_articles] boolean

Ajoutez automatiquement cette propriété aux nouveaux articles ? La valeur par défaut est false.
Format données
 property[meta][date_format] string

Facultatif pour les propriétés de type date.
Format numérique
 property[meta][number_format] string

Facultatif pour les propriétés du numéro de type.
Autoriser la mention de plusieurs personnes
 property[meta][allow_mentioning_multiple_people] boolean

Facultatif pour les propriétés de la personne de type.
Notifier une personne
 property[meta][notify_person] boolean

Facultatif pour les propriétés de la personne de type.
Valeurs de propriété
 property[property_values][][value] True array

Valeurs de propriété.
Color
 property[property_values][][meta][color] array

Couleur.

Retours

Modèle de propriété
Property

Déplacer des fichiers

ID d’opération :
PostFilesMove

Déplacez des fichiers (documents et/ou dossiers) vers un dossier spécifique (dans un même espace de travail ou différent).

Paramètres

Nom Clé Obligatoire Type Description
ID de dossier
 folder_ids[] array

Identificateurs de dossier.
ID de documentation
 doc_ids[] array

Identificateurs de document.
ID du dossier de destination
 destination_folder_id integer

Identificateur du dossier de destination.
ID de l’espace de travail de destination
 destination_workspace_id integer

Identificateur de l’espace de travail de destination.

Importer un document

ID d’opération :
PostImports

Importez un document à partir d’une source externe.

Paramètres

Nom Clé Obligatoire Type Description
Fichier
 import[file] True file

Fichier à importer.
Origine
 import[source] True string

Source du fichier.

Retours

Importer un modèle
Import

Mettre à jour les informations sur le document

ID d’opération :
PatchDocsId

Mettez à jour les métadonnées d’un document.

Paramètres

Nom Clé Obligatoire Type Description
Titre
 doc[title] True string

Titre du document.
ID
 id True integer

Identificateur.

Retours

Modèle doc
Doc

Mettre à jour les informations sur le dossier

ID d’opération :
PatchFoldersId

Mettez à jour les métadonnées d’un dossier.

Paramètres

Nom Clé Obligatoire Type Description
Titre du dossier
 folder[title] True string

Titre du dossier.
ID
 id True integer

Identificateur.

Retours

Modèle de dossier
Folder

Mettre à jour l’accès aux documents

ID d’opération :
PatchDocsDocIdAccessesId

Mettez à jour l’accès à un document.

Paramètres

Nom Clé Obligatoire Type Description
Autorisation
 access[permission] True string

Autorisation.
ID de document
 doc_id True integer

Identificateur de document.
ID
 id True integer

Identificateur.

Retours

Modèle d’accès à la documentation
DocAccess

Obtenir des articles de manuel

ID d’opération :
GetHandbooksHandbookIdItems

Récupérez une liste d’éléments de manuel.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID du manuel
 handbook_id True integer

Identificateur du manuel.

Retours

response
array of HandbookItem

Obtenir des documents

ID d’opération :
GetDocs

Récupérez les métadonnées de tous les documents de l’espace de travail.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID du dossier
 folder_id string

Filtre facultatif : affiche uniquement les documents qui se trouvent à la racine de ce dossier.

Retours

response
array of Doc

Obtenir des dossiers

ID d’opération :
GetFolders

Récupérez une liste de tous les dossiers.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID de répertoire parent
 parent_folder_id string

Filtre facultatif : affiche uniquement les dossiers avec cet ID de dossier parent.

Retours

response
array of Folder

Obtenir des groupes

ID d’opération :
GetGroups

Récupérer des groupes d’utilisateurs.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.

Retours

response
array of Group

Obtenir des informations sur le document

ID d’opération :
GetDocsId

Récupérez les métadonnées d’un document.

Paramètres

Nom Clé Obligatoire Type Description
ID
 id True integer

Identificateur.

Retours

Modèle doc
Doc

Obtenir des informations sur les dossiers

ID d’opération :
GetFoldersId

Récupérez la liste des métadonnées de dossier.

Paramètres

Nom Clé Obligatoire Type Description
ID
 id True string

Identificateur.

Retours

Modèle de dossier
Folder

Obtenir des manuels

ID d’opération :
GetHandbooks

Récupérez la liste des manuels d’espace de travail.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.

Retours

response
array of Handbook

Obtenir des utilisateurs

ID d’opération :
GetUsers

Récupérez une liste d’utilisateurs.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.

Retours

response
array of User

Obtenir des utilisateurs dans le groupe

ID d’opération :
GetGroupsGroupIdUsers

Récupérez tous les utilisateurs d’un groupe d’utilisateurs.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID de groupe
 group_id True integer

Identificateur de groupe.

Retours

response
array of User

Obtenir les accès aux documents

ID d’opération :
GetDocsDocIdAccesses

Répertorier les accès aux documents.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID de document
 doc_id True integer

Identificateur de document.

Retours

response
array of DocAccess

Obtenir les propriétés du document

ID d’opération :
GetProperties

Répertorier les propriétés personnalisées du document au niveau de l’espace de travail.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.

Retours

response
array of Property

Obtenir les propriétés du document

ID d’opération :
GetDocsDocIdProperties

Répertorier les propriétés personnalisées du document au niveau du document.

Paramètres

Nom Clé Obligatoire Type Description
Page
 page integer

Décalage de page à récupérer.
Objets
 items integer

Nombre d’éléments à retourner par page.
ID de document
 doc_id True integer

Identificateur de document.

Retours

response
array of DocProperty

Obtenir l’importation

ID d’opération :
GetImportsId

Récupérez des informations sur une importation existante.

Paramètres

Nom Clé Obligatoire Type Description
ID
 id True integer

Identificateur.

Retours

Importer un modèle
Import

Remplacer les informations de document

ID d’opération :
PutDocsId

Mettez à jour les métadonnées d’un document.

Paramètres

Nom Clé Obligatoire Type Description
Titre
 doc[title] True string

Titre du document.
ID
 id True integer

Identificateur.

Retours

Modèle doc
Doc

Remplacer les informations de dossier

ID d’opération :
PutFoldersId

Remplacez les métadonnées d’un dossier.

Paramètres

Nom Clé Obligatoire Type Description
Titre du dossier
 folder[title] True string

Titre du dossier.
ID
 id True integer

Identificateur.

Retours

Modèle de dossier
Folder

Remplacer l’accès aux documents

ID d’opération :
PutDocsDocIdAccessesId

Remplacez l’accès à un document.

Paramètres

Nom Clé Obligatoire Type Description
Autorisation
 access[permission] True string

Autorisation.
ID de document
 doc_id True integer

Identificateur de document.
ID
 id True integer

Identificateur.

Retours

Modèle d’accès à la documentation
DocAccess

Supprimer la propriété de document

ID d’opération :
DeleteDocsDocIdPropertiesId

Supprimez une propriété personnalisée d’un document.

Paramètres

Nom Clé Obligatoire Type Description
ID de document
 doc_id True integer

Identificateur de document.
ID
 id True integer

Identificateur.

Supprimer l’accès aux documents

ID d’opération :
DeleteDocsDocIdAccessesId

Supprimez l’accès du document.

Paramètres

Nom Clé Obligatoire Type Description
ID de document
 doc_id True integer

Identificateur de document.
ID
 id True integer

Identificateur.

Supprimer un élément de classeur

ID d’opération :
DeleteHandbooksHandbookIdItemsId

Supprimer l’élément du manuel.

Paramètres

Nom Clé Obligatoire Type Description
ID
 id True string

Identificateur.
ID du manuel
 handbook_id True integer

Identificateur du manuel.

Supprimer une propriété personnalisée de document

ID d’opération :
DeletePropertiesId

Supprimez une propriété personnalisée de document au niveau de l’espace de travail.

Paramètres

Nom Clé Obligatoire Type Description
ID
 id True integer

Identificateur.

Définitions

Utilisateur

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Prénom
 first_name string

Prénom.
Nom de famille
 last_name string

Nom.

Groupe

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Nom
 name string

Nom.
Descriptif
 description string

Description.
Accessibilité
 accessibility string

Accessibilité.

Propriété

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Nom
 name string

Nom.
Type
 type string

Type.
Valeur par défaut pour les articles
 default_for_articles boolean

Indique s’il faut par défaut pour les articles.
méta
 meta PropertyMeta
property_values
 property_values array of PropertyValue

PropertyMeta

Nom Chemin d’accès Type Description
Format numérique
 number_format string

Retourné uniquement et pertinent pour les propriétés du numéro de type.
Date Format
 date_format string

Uniquement retourné et pertinent pour les propriétés de la date de type
Autoriser la mention de plusieurs personnes
 allow_mentioning_multiple_people boolean

Retourné uniquement et pertinent pour les propriétés de la personne de type.
Notifier une personne
 notify_person boolean

Retourné uniquement et pertinent pour les propriétés de la personne de type.

PropertyValue

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
ID de propriété
 property_id integer

Identificateur de propriété.
Valeur
 value string

Valeur.
méta
 meta PropertyValueMeta

PropertyValueMeta

Nom Chemin d’accès Type Description
Color
 color string

Retourné uniquement pour les propriétés de type single_select et multi_select.

ManuelItem

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
ID du manuel
 handbook_id integer

Identificateur du manuel.
Type
 type string

Type.
Poste
 position integer

Position.
Titre
 title string

Uniquement pertinent pour les éléments de section et de lien.
URL
 url string

Uniquement pertinent pour les éléments de lien.
ID d’élément parent
 parent_item_id integer

Non null si l’élément est imbriqué.
ID de document
 doc_id integer

Uniquement pertinent pour les éléments de document.

Manuel

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Nom
 name string

Nom.

Dossier

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Titre
 title string

Titre.
ID de l’espace de travail
 workspace_id integer

Identificateur de l’espace de travail.
ID de répertoire parent
 parent_folder_id integer

Identificateur du dossier parent.

DocAccess

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
ID de document
 doc_id integer

Identificateur de document.
Autorisation
 permission string

Autorisation.
Type d’accesseur
 accessor_type string

Type d’accesseur.
ID d’accesseur
 accessor_id integer

Identificateur d’accesseur.
Hérité
 inherited boolean

Indique s’il est hérité.

DocProperty

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Modèle de propriété
 property Property
Valeur
 value string

Le type de propriété dépend du type de value propriété : 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id' : Integer }, propertyValue#ID 'multi_select' => { 'selected_item_ids' : Array[Integer] }, the selected PropertyValue#IDs 'case' => { 'checked' : Boolean } 'document' => { 'doc_id' : Integer }, the Document#ID 'person' => { 'user_ids' : Array[Integer] }, user#IDs.

Médecin

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
Titre
 title string

Titre.
ID de l’espace de travail
 workspace_id integer

Identificateur de l’espace de travail.
ID du dossier
 folder_id integer

Identificateur du dossier.
ID du propriétaire
 owner_id integer

ID d’utilisateur du propriétaire de la documentation.
Créé à
 created_at string

ISO8601 datetime mise en forme.
Mise à jour à
 updated_at string

ISO8601 datetime mise en forme.

Import

Nom Chemin d’accès Type Description
ID
 id integer

Identificateur
status
 status string
Modèle doc
 doc Doc