discoverygarden / dgi_actions
与外部标识服务提供商的集成。
v1.8.0
2024-08-09 17:39 UTC
Requires
- islandora/islandora: ^1 || ^2
README
简介
提供了一种框架,以支持本地或使用外部服务进行标识的创建和删除。
要求
此模块需要以下模块/库
安装
按常规安装,有关更多信息,请参阅此。
配置
该模块及其子模块无需任何配置即可使用。以下是如何配置所包含的 dgi_actions_ark_identifier
的步骤。
实体配置
模块中使用的所有实体的主要配置概览位于 admin/config/dgi_actions
。
数据配置文件配置
数据配置文件实体包含构建服务请求时使用的数据。这些值从实体检索,并随HTTP请求传递。 EZID 提供了如何使用此功能的良好示例。
- 创建新的数据配置文件:
admin/config/dgi_actions/data_profile/add
。 - 为数据配置文件命名。
- 选择将从中检索数据的实体和捆绑。在此示例中,选择
node
和Repository Item
。 - 选择正在使用的
DataProfile
插件。在此示例中,选择ERC
。 - 对于三个
ERC
字段,选择要映射的字段。 - 保存数据配置文件。
服务数据配置
服务数据实体包含用于与外部API交互的配置。
- 创建新的服务数据:
admin/config/dgi_actions/service_data/add
。 - 为服务数据命名。
- 选择正在使用的
ServiceData
插件。在此示例中,选择EZID
。 - 填写由
EZID
插件提供的必填字段。 - 保存服务数据。
标识配置
标识将所有内容连接在一起。如果正在使用 ServiceData
和 DataProfiles
,则它们存储对上述配置实体的引用。同样,它们还存储创建的标识将放置的位置。
- 创建新的标识:
admin/config/dgi_actions/identifier/add
。 - 为标识命名。
- 选择将存储数据的实体和捆绑。在此示例中,选择
node
和Repository Item
。 - 选择将存储标识的字段。对于示例,选择您想要的任何字段。
- 如果需要,从下拉菜单中选择用于请求的
ServiceData
。对于示例,选择上面创建的一个。 - 如果需要,从下拉菜单中选择用于请求的
DataProfile
。对于示例,选择上面创建的一个。 - 保存标识。
操作配置
对于每个要创建和可选删除的标识,都需要一个操作。
- 创建新的操作:
admin/config/system/actions
。 - 在
创建高级操作
下,选择要配置的 mint 或 delete 操作。对于示例,选择Mint ARK EZID Identifier
。 - 选择操作将触发的标识实体并保存。
- 重复上述操作,而不是选择
Delete ARK EZID Identifier
并保存。
上下文配置
Drupal 的 Context 模块与条件和实体挂钩结合使用,以处理具有自定义条件的 minting 和删除,以检查实体是否已有持久标识。
- 创建新的上下文:
admin/structure/context/add
。 - 输入一个名称,并可选填写其他字段后保存。
- 配置创建标识符所需的条件。例如,创建两个条件:
节点包
和实体具有持久标识符
。将节点包
条件配置为查找存储库项
包和钩子内容
。将实体具有持久标识符
条件配置为使用上面创建的标识符
和钩子内容
。取反此条件,使得仅在标识符不存在时创建。 - 选择需要所有条件。
- 添加一个反应选择
创建标识符
。 - 在
实体
下选择上面创建的 mint 动作所对应的名称。 - 重复上述步骤,并选择
删除标识符
反应以及满足删除的条件。通常这仅仅是移除实体具有持久标识符
上的否定。
新集成
要创建新的标识符铸造集成,至少需要一个 MintIdentifier
动作。
如果需要,可以创建一个 DataProfile
插件、一个 ServiceDataType
插件和一个 DeleteIdentifer
动作。
故障排除/问题
遇到问题或已解决问题?请联系 discoverygarden。
维护者/赞助商
当前维护者
开发
如果您想为此模块做出贡献,请查看有用的 文档、开发者 部分,并在 Islandora.ca 上联系 discoverygarden。