Compartir a través de

Almanac (publicador independiente) (versión preliminar)

Almanac está construyendo infraestructura colaborativa para servir a la creatividad humana. Con la herramienta wiki y flujo de trabajo más rápida, consolide sus documentos en una hermosa fuente de verdad organizada única.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Troy Taylor
URL https://www.hitachisolutions.com
Correo Electrónico ttaylor@hitachisolutions.com
Metadatos del conector
Publicador Troy Taylor
Sitio web https://almanac.io/
Directiva de privacidad https://almanac.io/privacy-policy
Categorías Colaboración; Contenido y archivos

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
ID del espacio de trabajo cuerda / cadena Identificador del área de trabajo de esta API. Cierto
Token de acceso (con el formato "Bearer yourAccessToken") securestring Token de acceso (con el formato "Bearer yourAccessToken") para esta API. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualización del acceso al documento

Actualice el acceso a un documento.
Actualizar información de carpeta

Actualice la información de una meta de carpeta.
Actualizar información del documento

Actualice la meta información de un documento.
Agregar acceso a documentos

Agregar acceso al documento.
Agregar propiedad de documento

Agregue una propiedad personalizada a un documento.
Crear carpeta

Crear una carpeta.
Crear elemento del manual

Agregue un elemento al manual.
Crear propiedad de documento

Cree una propiedad de documento en el nivel del área de trabajo.
Eliminación del acceso a documentos

Quite el acceso del documento.
Eliminar elemento de libro

Eliminar elemento del manual.
Eliminar propiedad de documento

Quite una propiedad personalizada de un documento.
Eliminar propiedad personalizada del documento

Elimine una propiedad personalizada del documento en el nivel del área de trabajo.
Importar documento

Importe un documento desde un origen externo.
Mover archivos

Mover archivos (documentos o carpetas) a una carpeta específica (en el mismo área de trabajo o diferente).
Obtención de accesos a documentos

Enumerar los accesos a documentos.
Obtener carpetas

Recuperar una lista de todas las carpetas.
Obtener documentos

Recupere la meta información de todos los documentos del área de trabajo.
Obtener elementos del manual

Recupera una lista de elementos del manual.
Obtener grupos

Recuperar grupos de usuarios.
Obtener importación

Recupere información sobre una importación existente.
Obtener información de carpeta

Recuperar una lista de la información de metadatos de carpeta.
Obtener información del documento

Recuperar la meta información de un documento.
Obtener manuales

Recupere una lista de los manuales del área de trabajo.
Obtener propiedades del documento

Enumerar las propiedades personalizadas del documento en el nivel del área de trabajo.
Obtener propiedades del documento

Enumerar las propiedades personalizadas del documento en el nivel de documento.
Obtener usuarios

Recuperar una lista de usuarios.
Obtener usuarios del grupo

Recuperar todos los usuarios de un grupo de usuarios.
Reemplazar el acceso a documentos

Reemplace el acceso a un documento.
Reemplazar información de carpeta

Reemplace una metainformación de carpeta.
Reemplazar la información del documento

Actualizar la meta información de un documento.

Actualización del acceso al documento

Id. de la operación:
PatchDocsDocIdAccessesId

Actualice el acceso a un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Permiso
 access[permission] True string

Permiso.
Id. de documento
 doc_id True integer

Identificador del documento.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de acceso a documentos
DocAccess

Actualizar información de carpeta

Id. de la operación:
PatchFoldersId

Actualice la información de una meta de carpeta.

Parámetros

Nombre Clave Requerido Tipo Description
Título de carpeta
 folder[title] True string

Título de la carpeta.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de carpeta
Folder

Actualizar información del documento

Id. de la operación:
PatchDocsId

Actualice la meta información de un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Title
 doc[title] True string

El título del documento.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de documento
Doc

Agregar acceso a documentos

Id. de la operación:
PostDocsDocIdAccesses

Agregar acceso al documento.

Parámetros

Nombre Clave Requerido Tipo Description
Permiso
 access[permission] True string

Permiso.
Tipo de descriptor de acceso
 access[accessor_type] True string

Tipo de descriptor de acceso.
Identificador de descriptor de acceso
 access[accessor_id] True integer

Identificador del descriptor de acceso.
Id. de documento
 doc_id True integer

Identificador del documento.

Devoluciones

Modelo de acceso a documentos
DocAccess

Agregar propiedad de documento

Id. de la operación:
PostDocsDocIdProperties

Agregue una propiedad personalizada a un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de propiedad
 property_id True integer

Identificador de propiedad.
Importancia
 value string

El tipo de parámetro depende del tipo de value propiedad: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, propertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, el PropertyValue#IDs seleccionado 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, el Document#ID 'person' => { 'user_ids': Array[Integer] }, the User#IDs.
Id. de documento
 doc_id True integer

Identificador del documento.

Devoluciones

Modelo de propiedades de doc
DocProperty

Crear carpeta

Id. de la operación:
PostFolders

Crear una carpeta.

Parámetros

Nombre Clave Requerido Tipo Description
Título de carpeta
 folder[title] True string

Título de la carpeta.
Id. de carpeta principal
 folder[parent_folder_id] integer

Identificador de la carpeta primaria. Se creará en la raíz del área de trabajo si no se proporciona.

Devoluciones

Modelo de carpeta
Folder

Crear elemento del manual

Id. de la operación:
PostHandbooksHandbookIdItems

Agregue un elemento al manual.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de elemento
 handbook_item[type] True string

Tipo de artículo manual.
Posición del elemento
 handbook_item[position] integer

Anexa el elemento como última posición si no se proporciona.
Id. de elemento primario
 handbook_item[parent_item_id] integer

Id. de elemento primario con fines de anidamiento.
Id. de documento
 handbook_item[doc_id] True integer

Solo es necesario para los elementos de documento.
Título del elemento
 handbook_item[title] True string

Solo es necesario para los elementos de sección y vínculo.
Dirección URL del elemento
 handbook_item[url] True string

Solo es necesario para los elementos de vínculo.
Id. del manual
 handbook_id True integer

Identificador del manual.

Devoluciones

ManualItem Model
HandbookItem

Crear propiedad de documento

Id. de la operación:
PostProperties

Cree una propiedad de documento en el nivel del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de propiedad
 property[name] True string

Nombre de propiedad, que debe ser único por área de trabajo.
Tipo de propiedad
 property[type] True string

Tipo de propiedad.
Valor predeterminado para artículos
 property[default_for_articles] boolean

¿Agrega automáticamente esta propiedad a nuevos artículos? El valor predeterminado es False.
Formato de datos
 property[meta][date_format] string

Opcional para las propiedades de tipo date.
Formato de número
 property[meta][number_format] string

Opcional para las propiedades del número de tipo.
Permitir mencionar varias personas
 property[meta][allow_mentioning_multiple_people] boolean

Opcional para las propiedades de tipo person.
Notificar a la persona
 property[meta][notify_person] boolean

Opcional para las propiedades de tipo person.
Valores de propiedad
 property[property_values][][value] True array

Valores de propiedad.
Color
 property[property_values][][meta][color] array

Color.

Devoluciones

Modelo de propiedades
Property

Eliminación del acceso a documentos

Id. de la operación:
DeleteDocsDocIdAccessesId

Quite el acceso del documento.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de documento
 doc_id True integer

Identificador del documento.
identificación
 id True integer

Identificador.

Eliminar elemento de libro

Id. de la operación:
DeleteHandbooksHandbookIdItemsId

Eliminar elemento del manual.

Parámetros

Nombre Clave Requerido Tipo Description
identificación
 id True string

Identificador.
Id. del manual
 handbook_id True integer

Identificador del manual.

Eliminar propiedad de documento

Id. de la operación:
DeleteDocsDocIdPropertiesId

Quite una propiedad personalizada de un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de documento
 doc_id True integer

Identificador del documento.
identificación
 id True integer

Identificador.

Eliminar propiedad personalizada del documento

Id. de la operación:
DeletePropertiesId

Elimine una propiedad personalizada del documento en el nivel del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
identificación
 id True integer

Identificador.

Importar documento

Id. de la operación:
PostImports

Importe un documento desde un origen externo.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
 import[file] True file

Archivo que se va a importar.
Fuente
 import[source] True string

Origen del archivo.

Devoluciones

Importar modelo
Import

Mover archivos

Id. de la operación:
PostFilesMove

Mover archivos (documentos o carpetas) a una carpeta específica (en el mismo área de trabajo o diferente).

Parámetros

Nombre Clave Requerido Tipo Description
Identificadores de carpeta
 folder_ids[] array

Identificadores de carpeta.
Identificadores de documento
 doc_ids[] array

Identificadores de documento.
Id. de carpeta de destino
 destination_folder_id integer

Identificador de carpeta de destino.
Id. del área de trabajo de destino
 destination_workspace_id integer

Identificador del área de trabajo de destino.

Obtención de accesos a documentos

Id. de la operación:
GetDocsDocIdAccesses

Enumerar los accesos a documentos.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Id. de documento
 doc_id True integer

Identificador del documento.

Devoluciones

response
array of DocAccess

Obtener carpetas

Id. de la operación:
GetFolders

Recuperar una lista de todas las carpetas.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Id. de carpeta principal
 parent_folder_id string

Filtro opcional: solo muestra carpetas con este identificador de carpeta principal.

Devoluciones

response
array of Folder

Obtener documentos

Id. de la operación:
GetDocs

Recupere la meta información de todos los documentos del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Id. de carpeta
 folder_id string

Filtro opcional: solo se muestran documentos que se encuentran en la raíz de esta carpeta.

Devoluciones

response
array of Doc

Obtener elementos del manual

Id. de la operación:
GetHandbooksHandbookIdItems

Recupera una lista de elementos del manual.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Id. del manual
 handbook_id True integer

Identificador del manual.

Devoluciones

response
array of HandbookItem

Obtener grupos

Id. de la operación:
GetGroups

Recuperar grupos de usuarios.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.

Devoluciones

response
array of Group

Obtener importación

Id. de la operación:
GetImportsId

Recupere información sobre una importación existente.

Parámetros

Nombre Clave Requerido Tipo Description
identificación
 id True integer

Identificador.

Devoluciones

Importar modelo
Import

Obtener información de carpeta

Id. de la operación:
GetFoldersId

Recuperar una lista de la información de metadatos de carpeta.

Parámetros

Nombre Clave Requerido Tipo Description
identificación
 id True string

Identificador.

Devoluciones

Modelo de carpeta
Folder

Obtener información del documento

Id. de la operación:
GetDocsId

Recuperar la meta información de un documento.

Parámetros

Nombre Clave Requerido Tipo Description
identificación
 id True integer

Identificador.

Devoluciones

Modelo de documento
Doc

Obtener manuales

Id. de la operación:
GetHandbooks

Recupere una lista de los manuales del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.

Devoluciones

response
array of Handbook

Obtener propiedades del documento

Id. de la operación:
GetProperties

Enumerar las propiedades personalizadas del documento en el nivel del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.

Devoluciones

response
array of Property

Obtener propiedades del documento

Id. de la operación:
GetDocsDocIdProperties

Enumerar las propiedades personalizadas del documento en el nivel de documento.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Id. de documento
 doc_id True integer

Identificador del documento.

Devoluciones

response
array of DocProperty

Obtener usuarios

Id. de la operación:
GetUsers

Recuperar una lista de usuarios.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.

Devoluciones

response
array of User

Obtener usuarios del grupo

Id. de la operación:
GetGroupsGroupIdUsers

Recuperar todos los usuarios de un grupo de usuarios.

Parámetros

Nombre Clave Requerido Tipo Description
Página
 page integer

Desplazamiento de página para capturar.
Productos
 items integer

Número de elementos que se van a devolver por página.
Identificador de grupo
 group_id True integer

Identificador de grupo.

Devoluciones

response
array of User

Reemplazar el acceso a documentos

Id. de la operación:
PutDocsDocIdAccessesId

Reemplace el acceso a un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Permiso
 access[permission] True string

Permiso.
Id. de documento
 doc_id True integer

Identificador del documento.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de acceso a documentos
DocAccess

Reemplazar información de carpeta

Id. de la operación:
PutFoldersId

Reemplace una metainformación de carpeta.

Parámetros

Nombre Clave Requerido Tipo Description
Título de carpeta
 folder[title] True string

Título de la carpeta.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de carpeta
Folder

Reemplazar la información del documento

Id. de la operación:
PutDocsId

Actualizar la meta información de un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Title
 doc[title] True string

El título del documento.
identificación
 id True integer

Identificador.

Devoluciones

Modelo de documento
Doc

Definiciones

Usuario

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Nombre
 first_name string

Nombre.
Apellido
 last_name string

Apellidos.

Grupo

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Nombre
 name string

Nombre.
Description
 description string

Descripción.
Accessibility
 accessibility string

Accesibilidad.

Propiedad

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Nombre
 name string

Nombre.
Tipo
 type string

Tipo.
Valor predeterminado para artículos
 default_for_articles boolean

Indica si se debe establecer de forma predeterminada para los artículos.
meta
 meta PropertyMeta
property_values
 property_values array of PropertyValue

PropertyMeta

Nombre Ruta de acceso Tipo Description
Formato de número
 number_format string

Solo se devuelven y son relevantes para las propiedades del número de tipo.
Formato de fecha
 date_format string

Solo devuelto y relevante para las propiedades de tipo date
Permitir mencionar varias personas
 allow_mentioning_multiple_people boolean

Solo se devuelve y relevante para las propiedades de la persona de tipo.
Notificar a la persona
 notify_person boolean

Solo se devuelve y relevante para las propiedades de la persona de tipo.

PropertyValue

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Id. de propiedad
 property_id integer

Identificador de propiedad.
Importancia
 value string

Valor.
meta
 meta PropertyValueMeta

PropertyValueMeta

Nombre Ruta de acceso Tipo Description
Color
 color string

Solo se devuelven y son relevantes para las propiedades de tipo single_select y multi_select.

ManualItem

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Id. del manual
 handbook_id integer

Identificador del manual.
Tipo
 type string

Tipo.
Position
 position integer

Posición.
Title
 title string

Solo es relevante para los elementos de sección y vínculo.
URL
 url string

Solo es relevante para los elementos de vínculo.
Id. de elemento primario
 parent_item_id integer

No null si el elemento está anidado.
Id. de documento
 doc_id integer

Solo es relevante para los elementos de documento.

Manual

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Nombre
 name string

Nombre.

Carpeta

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Title
 title string

Título.
ID del espacio de trabajo
 workspace_id integer

Identificador del área de trabajo.
Id. de carpeta principal
 parent_folder_id integer

Identificador de carpeta principal.

DocAccess

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Id. de documento
 doc_id integer

Identificador del documento.
Permiso
 permission string

Permiso.
Tipo de descriptor de acceso
 accessor_type string

Tipo de descriptor de acceso.
Identificador de descriptor de acceso
 accessor_id integer

Identificador del descriptor de acceso.
Heredado
 inherited boolean

Si se hereda.

DocProperty

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Modelo de propiedades
 property Property
Importancia
 value string

El tipo de depende del tipo de value propiedad: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, propertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, el propertyValue#IDs seleccionado 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, el Document#ID 'person' => { 'user_ids': Array[Integer] }, el User#IDs.

Doc

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
Title
 title string

Título.
ID del espacio de trabajo
 workspace_id integer

Identificador del área de trabajo.
Id. de carpeta
 folder_id integer

Identificador de carpeta.
Id. del propietario
 owner_id integer

Identificador de usuario del propietario del documento.
Creado en
 created_at string

ISO8601 datetime con formato.
Actualizado en
 updated_at string

ISO8601 datetime con formato.

Import

Nombre Ruta de acceso Tipo Description
identificación
 id integer

Identificador
estado
 status string
Modelo de documento
 doc Doc