Как создать перекрестную ссылку с одной страницы Confluence на другую с помощью REST?

Я пытаюсь опубликовать кучу автоматически сгенерированных страниц в Confluence используя REST< /а>. Страницы содержат перекрестные ссылки друг на друга, которые представляют собой простые теги, для которых я в настоящее время делаю дикие предположения относительно URL-адреса на основе целевого имени ("http://confluence.url/display/[пробел]/[имя]" или что-то с идентификатором).

В этом есть несколько недостатков:

  • Я угадываю URL-адрес, который включает логику кода там, где мне это не нужно.
  • URL-адрес, который я предполагаю, может измениться, когда надстройка, такая как Вид экрана прокрутки активирован
  • Система может быть не в состоянии различать гиперссылку (страница на внешнюю) и перекрестную ссылку (страница на страницу), например. для обнаружения неопределенных или потерянных страниц.

Я ищу способ создать правильную перекрестную ссылку с одной страницы на другую при создании/обновлении этих страниц через REST. Я пробовал:

  • Обычная гиперссылка HTML на URL-адрес страницы, который, как я предполагаю, нежелателен по причинам, описанным выше.
  • Использование «[Текст ссылки|ссылка+цель]» синтаксис, это просто отображает квадратные скобки на странице и не создает ссылку
  • Нахождение макроса для использования, но, похоже, для этого нет макроса. Макрос Anchors — это не то, что я ищу, поскольку он будет работать только для целевых ссылок на одной странице.

Я думаю, что смогу заранее разрешить все необходимые идентификаторы страниц. Кроме того, макросы, кажется, поддерживаются REST, поэтому макрос для перекрестных ссылок кажется идеальным.


person wybe    schedule 09.08.2017    source источник


Ответы (1)


Я нашел ответ на свой вопрос:

<ac:link>
    <ri:page ri:content-title="TheNameOfMyPage" />
    <ac:plain-text-link-body>Link text</ac:plain-text-link-body>
</ac:link>

https://community.atlassian.com/t5/Confluence-questions/How-to-insert-link-to-page-in-other-space-in-user-macro/qaq-p/582753

Обновление: Макрос ac:link документирован более формально здесь: https://confluence.atlassian.com/conf51/confluence-storage-format-336169254.html

person wybe    schedule 09.08.2017