03 - Developer Forum - Recent Threads

IshRemoteMcpServer with AI Toolkit or Continue extension in VSCode

Colin Ferguson — Fri, 23 Jan 2026 03:02:12 GMT

My request: Can you figure out how to get IshRemoteMcpServer to work correctly with either the AI Toolkit or Continue extensions in VSCode?

Here's the reason: Our corporate policies prevent us from using most external AI models such as github Copilot or Claude. So to test IshRemoteMcpServer with our internal Tridion Docs environments I have to set up a local LLM instance (ollama in my case) and get it running with VSCode. It’s very slow and periodically throws errors (because VSCode throws a fit if it can't see its native Copilot when chatting is occurring even to another LLM) but it (sort of) works… I can start the MCP server and see the ishremote commands in the Tools menu. The model seems to recognize them but absolutely will NOT actually execute them. For example, I tell it to start an ishremote session and it shows me how to write powershell code to do it.

So I thought I'd swap in a more powerful AI with better MCP tools handling. I set up an instance of ollama on a server with a decent GPU, and an LLM (llama2 for now) can now be addressed over port 11434 on that server. The problem now is that there is no way to configure a local LLM server in the native VSCode chat via a URL.

So I tried installing the AI Toolkit extension, which supports local configs like this. Then I configured IshRemoteMcpServer and started the server via the extension interface. The first time, it times out: Unable to connect to MCP Server 'IshRemoteMcpServer'. Error: MCP error -32001: Request timed out. Please verify your mcp.json configuration settings. MCP error -32001: Request timed out. The log file ended with:

{"Level":"Info","Message":"Starting MCP Server","Timestamp":"2026-01-22T21:36:02.1876440-05:00"}

The second time, I get Unable to connect to MCP Server 'IshRemoteMcpServer'. Error: Server's protocol version is not supported: 0.3.0. Please verify your mcp.json configuration settings. Server's protocol version is not supported: 0.3.0. The log file ended with:

{"Level":"Info","RequestId":1,"Request":"{\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-06-18\",\"capabilities\":{},\"clientInfo\":{\"name\":\"vsc-aitoolkit-IshRemoteMcpServer\",\"version\":\"0.28.2\"}},\"jsonrpc\":\"2.0\",\"id\":1}","Message":"Processing request","Timestamp":"2026-01-22T21:36:02.2585314-05:00"}

I tried the same exercise with the Continue extension and got exactly the same behavior.

Log file for the second case attached. The log file for the first case looks exactly the same, except it ends one line earlier.[View:/cfs-file/__key/communityserver-discussions-components-files/215/IshRemoteMcpServer.log:900:600]

RE: IshRemoteMcpServer with AI Toolkit or Continue extension in VSCode

Dave De Meyer — Thu, 26 Mar 2026 15:26:20 GMT

For your information...

ISHRemote v8.2 will be released soon announced over a blogpost on the community... besides the above ISHRemoteMcpServer with more progressive disclosure of tools (so less initial token usage), it will also contain support for recently released PowerShell 7.6.
You need a Prerelease of ISHRemote (8.2.0-preview274 or higher) for PowerShell 7.6 as previous versions of ISHRemote do not work.

RE: IshRemoteMcpServer with AI Toolkit or Continue extension in VSCode

Dave De Meyer — Mon, 26 Jan 2026 17:19:44 GMT

For others watching this thread and think what is "ISHRemoteMcpServer", Colin had a look at the prerelease. The work in progress is hiding in plain sight: https://github.com/RWS/ISHRemote/blob/master/Doc/ReleaseNotes-ISHRemote-8.2.md holding some animated gifs for inspiration. This is typically the source of the actual RWS Community blog post. But absolutely feel free to have a look already. The main goal for this first version is to have ISHRemoteMcpServer working in Visual Studio Code with standard solutions like Claude, Gemini, OpenAI, Mistral, etc

Now given your question Colin, it seems that your corporate policies put in a lot of limitations for you. As you probably noticed in my description I stepped away from the (less expensive, older) GPT-4.1 to more powerful (more expensive, recent) Claud Sonnet 4.5 because it simply gave me a lot better result. These results for me was its choice on when to execute something, but also its choices in how it approached co-writing a PowerShell script. That virtual assistant behaves differently, some suggests other execute more. That is something that ISHRemoteMcpServer does not really control. So you were right in switching the model 'out' or 'up'. There is no one-size fits all.

You mention "llama2" which is quite old, and even your suggestion "Continue" on https://docs.continue.dev/guides/ollama-guide mentions to use Llama 3.1 or Mistral or higher with MCP Tools. Can you try other more recent ones?

Regarding the MCP Protocol Version "0.3.0". I've updated the latest PowerShellGallery-hosted Prerelease (8.2.0-preview259), so you can update and try again. Hopefully the below story unblocks your efforts, and do not hesitate to write down some tips and tricks for people that have similar corporate policies. See https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle and in turn Update ISHRemoteMcpServer MCP Protocol Version from '0.3.0' to '2024-11-05' · Issue #228 · RWS/ISHRemote https://github.com/RWS/ISHRemote/issues/228

Best wishes,
Dave

RE: Use ISHRemote to iterate through folders of type ISHModule excluding folders with keywords

Dave De Meyer — Mon, 05 Jan 2026 09:13:05 GMT

Hi Ann,

Line 1 indeed only pushes folders of type "ISHModule" to the pipeline ('|') and eats/skips the non-ISHModule folders.

Line 2 looks superfluous to me.

Line 4 is a check on the folder name, so not the folder path.... So to compare to a file system; fname could hold "RWS" while its full folder path could be "C:\Program Files\RWS\"

So instead of using fname property, perhaps you can try fishfolderpath. It holds the path segments (without path separator \ or /). So to continue the above example it would hold "Program Files, RWS"

Or you could do an extra call like Get-IshFolderLocation -IshFolder $_ which would result in the full folder path with the path separators of your environment.

Best wishes,
Dave

Use ISHRemote to iterate through folders of type ISHModule excluding folders with keywords

Ann Jensen — Tue, 30 Dec 2025 13:09:02 GMT

Hi,

I am writing a script to collect list of topic GUIDs that live within any child folder of a give root folder in Tridion Docs but I want to exclude any folders that have keywords in their names like 'archive', 'test', and 'exclude'.

[embed:dc8ab71f-3b98-42d9-b0f6-e21e02a0f8e2:77b27a85-68f1-4e8c-a376-1f68b49c33b1:type=text&text=%24ishFolders%20%3D%20Get-IshFolder%20-IshSession%20%24ishSession%20-FolderPath%20%24ishFolder%20-FolderTypeFilter%20%40%28%22ISHModule%22%29%20-Recurse%20%7C%0AWhere-Object%20-Property%20IshFolderType%20-EQ%20-Value%20ISHModule%20%7C%0AWhere-Object%20%7B%0A%24_.fname%20-notlike%20%22%2ARetire%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2ADeprecate%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2ATest%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2AAdmin%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2ADelete%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2AObsolete%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2ADuplicated%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2AArchive%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2ANot%20in%20use%2A%22%20-and%0A%24_.fname%20-notlike%20%22%2Ado%20not%20use%2A%22%0A%7D]

On execution, I am still getting results of topics that live deep within folders that have keyword 'archive' in them. The folder with the keyword 'archive' in its name is not of type ISHModule and I am not sure how to exclude these parent folders and all their child folders.

Any advice appreciated,

Regards,

Ann

Using ishRemote, how can I get the DITA OT log file contents in a Get-IshEvent request?

Colin Ferguson — Thu, 23 Oct 2025 20:57:10 GMT

I dropped my question in the wrong forum, so I'm trying again :(

I wrote this little PowerShell routine to get the log for a specific event. I can get the detail, but I cannot figure out how to get the contents of the DITA-OT log file. Can you help me?

I tried looking at IshEventData for the DITAOTLogFile event but the byte array is 0 in length.

$targetServer = "xxxxxx"

if($ishSession -eq $null) {
 $ishSession = New-IshSession -WsBaseUrl $targetServer
}

$requestedMetadata = Set-IshRequestedMetadataField -IshSession $ishSession -Name "EVENTID" -Level "Progress" |
 Set-IshRequestedMetadataField -IshSession $ishSession -Name "EVENTTYPE" -Level "Progress" |
 Set-IshRequestedMetadataField -IshSession $ishSession -Name "EVENTDATATYPE" -Level "Detail" |
 Set-IshRequestedMetadataField -IshSession $ishSession -Name "DETAILID" -Level "Detail"

$metadataFilter = Set-IshMetadataFilterField -IshSession $ishSession -Name "DESCRIPTION" -Level "Progress" -FilterOperator Like -Value "Publish process for GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx=3=HTMLOutput=en-us"

$eventLog = Get-IshEvent -IshSession $ishSession -RequestedMetadata $requestedMetadata -EventTypes "PUBLISH" -MetadataFilter $metadataFilter

$eventLog

Using ISHRemote to Identify Where Topics Are Used in Publications

Satoru Nakamura — Thu, 16 Oct 2025 08:23:41 GMT

Hello community,

I would like to find all publications that reference a specific topic (object) using ISHRemote.
If there's a cmdlet in the current ISHRemote version that supports this, I’d really appreciate your help.

I’m aware that the Publication Manager has a “Where Used” feature.
However, since I need to check a large number of topics, I hope to automate this process using a PowerShell script.

Background
In Tridion Docs, there are multiple topics with identical content but different GUIDs.
I want to identify which publications are using these topics.

I have already downloaded the files of topic from the Web Client search to my local environment.

Environment:
ISHRemote Version: 8.1.0
Tridion Docs Version: 15.2

Thanks as always for developing such powerful tools and for supporting the community.

RE: Using ISHRemote to Identify Where Topics Are Used in Publications

Satoru Nakamura — Thu, 16 Oct 2025 22:09:25 GMT

Hi Dave,

Thank you very much for your detailed and insightful explanation.

Your thorough description of the traversal from publication versions down to the topic level was extremely helpful in clarifying the process.
I truly appreciate your explanation of the two approaches—using Get-IShBaselineItem for a brute-force method and the more efficient API-based lookup.

Thank you again for taking the time to share your expertise.
It’s always a pleasure to learn from you.

RE: Using ISHRemote to Identify Where Topics Are Used in Publications

Dave De Meyer — Thu, 16 Oct 2025 11:31:18 GMT

Hi Satoru,

The true reference of a topic can only be found by navigation every publication version from the top of the tree all the way down to the leaf - your topic. Along traversing that tree, your publication version points to a root DITA Map, the baseline explicitly holds a version for that DITA Map (or implicitly autocompletes), when conditions evaluate to true your DITA Map points to DITA submaps, DITA submaps over versioning point to DITA Topics, DITA Topics to DITA Libraries, etc :)

The "Where Used" of Publication Manager takes some acceptable shortcuts and it checks if your topic is in a baseline assigned to a publication. Publication Manager upon opening of a publication version always adds all "used" content objects to a baseline which you typically Save to the CMS later. Publicaition Manager uses PublicationOutput 2.5 Containing behind the scene if I remember correctly.

To not keep you in suspense, there is no easy to consume cmdlet. Theoretically, to get you going, you could...

A. Iterate all your Publication Versions

Iterate all Publication Versions in your repository, in turn Get-IShBaselineItem and check if your topic GUIDs are in there. So a brute force iteration using the GUID-present-in-baseline premise.

$publicationOutputs = Get-IshFolder -FolderPath 'General\Mobile Phones Demo\Publications' | Get-IshFolderContent 
Get-IshBaselineItem -Id $publicationOutputs[0].fishbaseline_version_element | Where-Object -Property LogicalId -EQ -Value 'GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'

B. Use that Publication Manager WhereUsed API call

Over the API you can do a more efficient lookup, but you have to iterate all versions of your topic. So '1' below means version 1.

$xml = [xml]$ishSession.PublicationOutput25.Containing('GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx','1','')
$xml.ishobjects.ishobject

Best wishes,
Dave

RE: LastLogin data obtained by Find-IshUser cmdlet

Naoki Hirai — Wed, 15 Oct 2025 10:41:23 GMT

Hi Dave,

Thank you for your clarification. Now, I understand the last log-on timestamp of TD15 well.

As a temporary solution, I retrieved the last log-on timestamp from the Access Management DB table directory. I hope the Find-IshUser cmdlet will be enhanced in the future.

Best regards,
Naoki

LastLogin data obtained by Find-IshUser cmdlet

Naoki Hirai — Wed, 15 Oct 2025 02:53:07 GMT

Our company upgraded TD from TD14 to 15.2.0 last month (i.e. September, 2025).

I was monitoring the number of active users by gathering last login information with the PowerShell script as follows:

Find-IshUser -IshSession $ishSession | Select-Object username,fishemail,fusergroup,fishlastloginon | sort @{Expression="username";Descending=$false} | Export-Csv <CSV file path>

Before upgrading TD, we were using ISHSTS for login authentication. Now, we are using a cloud-based IdP for login authentication. When I executed the above PowerShell script today, I realized the fishlastloginon does not reflect the last login date logged in using the cloud-based IdP. It is believed that the last login date and time collected by the ISHRemote Find-IshUser cmdlet only pertains to login authentication using ISHSTS and Tridion Docs identity provider.

Could you let me how to obtain the last login date and time when logging in using both external IdP and Tridion Docs identity provider?

I'm using ISHRemove 8.1.0.

Thank you in advance for your help.

Kind regards,
Naoki

RE: LastLogin data obtained by Find-IshUser cmdlet

Dave De Meyer — Wed, 15 Oct 2025 06:41:10 GMT

Hi Naoki-san,

Have a look at User's Last Log On Timestamp Impact https://community.rws.com/product-groups/tridion/tridion-docs/b/weblog/posts/automating-on-tridion-docs---ishremote-v8-0-with-modern-authentication-is-now-available. When the identity provider is not the built-in one (like ISHID or earlier ISHSTS), the timestamp is indeed not maintained as the CMS is not offering the authentication anymore. And this is advised as external identity provider have this as their main business goal.

A very fluffy idea was to extend Find-IshUser cmdlet but we never got it to top of the backlog. There is some data available in Access Management (typically https://ish.example.com/ISHAM/). Theoretically it is possible to link the user profiles (from ISHCM) with the login information (from ISHAM), so combining the two data silos. This was one of the ideas behind adding the OpenAPI proxy to Access Management $ishSession.OpenApiAM10Client.UsersGetAsync().GetAwaiter().GetResult() which of course requires Access Management administrator api privileges.

Best wishes,
Dave

RE: How to Customize the Output of Tridion Docs Publications?

Naoki Hirai — Mon, 06 Oct 2025 04:03:16 GMT

Hi Raf san,

I'd like to watch the TXS 2020 Day 2: Integrating New Publishing Outputs SDL Tridion Docs presentation. However, video is not publicly available and requires a login to view. If it's appropriate, could you please share the login information with me via direct message?

Kind regards,
Naoki

How to Customize the Output of Tridion Docs Publications?

Jason Derulo — Wed, 26 Jun 2024 06:14:04 GMT

Hey Tridion Docs fam!

New to the scene here, and I'm tackling a project to customize the look and feel of our published content. Basically, I want our shiny new docs to match our company's branding perfectly.

Wondering if any of you customization wizards can lend a hand with these:

Tridion Tweaks: What are the best ways to go about customizing output in Tridion Docs?
Plugin Power? Are there any cool tools or plugins out there that can help me achieve this branding magic?
Future-Proofing: How can I make sure my customizations won't break when Tridion Docs updates?
Learning Resources: Any hidden knowledge stashes or detailed guides I should be checking out?

I also check this: https://community.rws.com/developers-more/salesforcedeveloper /tridiondocs-developers/b/knowledge_center_developer_blog/posts/sdltridiondocshtmloutputcustomization But I have not found any solution so, basically, any tips, tricks, or war stories from your experience would be a huge help! Thanks a ton in advance for your expertise.

Looking forward to crafting some seriously on-brand docs!

RE: Updating metadata on the publication version level

Charles Craig — Mon, 01 Sep 2025 09:15:11 GMT

That's great Dave, thanks for the thorough explanation!

best,

Charlie

Updating metadata on the publication version level

Charles Craig — Thu, 28 Aug 2025 22:47:31 GMT

Hi,

I have the following use case I need to implement ASAP. I have several large lists of pubs - the lists contain the GUIDs, the relevant versions, and metadata values that I need to write into a custom metadata field - FINFAPRODUCTMETADATA.

I've tried investigating IshRemote, but I haven't been able to accomplish this - I've been poring over the help files and any examples I can find here in the dev forum, but to no avail so far. Can this be done with IshRemote cmdlets? Or would it be better/easier to use the API wrapper, eg calls like $mySession.PublicationOutput25.Find?

Note I don't have any issues with general PS coding, eg the parsing of CSV files and such - the only problem I'm unable to solve is finding the correct way to find the objects in Tridion and then update the metadata field.

One last thing I was hoping for wrt to this project... I also need to update the metadata of any pub versions that are later than the version I'm targeting. I'm aware that the Version field is a text field - I can write my own comparator for that. I'm just hoping that someone could point me to a working code example for listing all the versions of a publication.

I'm on Tridion Docs 14sp4, btw, in case that matters. Thanks for any help!

RE: Updating metadata on the publication version level

Dave De Meyer — Mon, 01 Sep 2025 07:10:32 GMT

Hi Charlie,

Over the years ISHRemote defaults the -RequestedMetadata to human readable fields. The Id you are looking for is part of the System fields. The most optimal way to add this to the request is in the example below. Where I also gave you some inspiration for the PowerShell read-only PSNoteProperty shortcuts versus lengthy but still supported/correct Get-IshMetadataField usage.

PS C:\PRIVATE\OneDrive\CODE\ISHRemoteScript> $p=Get-IshPublicationOutput -LogicalId GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -RequestedMetadata (Set-IshRequestedMetadataField -Level Logical -Name FISHMBPRODUCT -ValueType Id)

PS C:\PRIVATE\OneDrive\CODE\ISHRemoteScript> $p[0] | Get-IshMetadataField -Level Logical -Name FISHMBPRODUCT -ValueType Id
VPRODUCTFAMILYTRIDIONSITES
PS C:\PRIVATE\OneDrive\CODE\ISHRemoteScript> $p[0] | Get-IshMetadataField -Level Logical -Name FISHMBPRODUCT -ValueType Value
Tridion Sites (200)

PS C:\PRIVATE\OneDrive\CODE\ISHRemoteScript> $p[0].fishmbproduct_logical_id   
VPRODUCTFAMILYTRIDIONSITES
PS C:\PRIVATE\OneDrive\CODE\ISHRemoteScript> $p[0].fishmbproduct_logical_value
Tridion Sites (200)

People that want more insights in what fields to use, check Get-IshTypeFieldDefinition or have a look on [Sample \- Descriptive, Basic and All Fields](github.com/.../ReleaseNotes-ISHRemote-0.7.md

Best wishes,
Dave

RE: Updating metadata on the publication version level

Charles Craig — Fri, 29 Aug 2025 13:17:58 GMT

One other quick query. The objects I'm editing have the ISHMetadataBinding data type. I am able to set these values correctly - ie when I replace the Value with a backend ID like /1/2/3/4, it's correctly stored, and I see the correct full text string when I open the publication properties, populated by the metadatabinding.

However, when I run this:
Get-IshMetadataField -IshSession $ishSession -Name "FINFAPRODUCTMETADATA" -Level Version -ValueType Value

The full text strings are retrieved instead of the IDs, which are what I need. What am I missing here? Changing the ValueType to element or ID doesn't help either.

Btw, the reason I need this because I've realized I need to get the existing value first, as multiple values are already in this metadata field in many cases.

Thanks for any help!

RE: Updating metadata on the publication version level

Charles Craig — Fri, 29 Aug 2025 10:20:21 GMT

Hi Dave,

Thanks so much for the quick reply, I was able to get it working by using your code as a starting point. Very much appreciated!

best,

Charlie

RE: Updating metadata on the publication version level

Dave De Meyer — Fri, 29 Aug 2025 07:02:38 GMT

Hi Charles,

Worth the read is RE: Using ISHRemote can I filter results where Version is less than or equal to a value?

Some code snippets giving the ASAP to unblock as inspiration. I tested them on 15.2.0 but I think they work on 14SP4/14.0.4 as well.

# As version is a string field, you can do an exact match
$requestedMetadata = Set-IshMetadataFilterField -Level Version -Name VERSION -FilterOperator Equal -Value '15'
Get-IshPublicationOutput -LogicalId GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -MetadataFilter $requestedMetadata
# As you are then updating the version level, it would be a good optimization to do that only once for that version and not for every PublicationOutput below (e.g. English PDF, French PDF, English...)

# Regarding version compare...
# FISHBRANCHNR is a system field which you need to explicitly get
# you get ALL of them all the time, if you specify $ishSession.DefaultRequestedMetadata='All'
$requestedMetadata = (Set-IshRequestedMetadataField -Level Version -Name FISHBRANCHNR)
$p = Get-IshPublicationOutput -LogicalId GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -RequestedMetadata $requestedMetadata

# to give you an idea of what we retrieved, print the below
# where the version is just an integer, no branched version, then fishbranchnr is zero... in turn you can use PowerShell -lt operator when cast to an [int]
$p | Select-Object ishref,version_version_value,fishbranchnr_version_value

# Below is a client-side, so in PowerShell calculation, when there are no branches
$p | ForEach-Object { 
        if (($_.fishbranchnr_version_value -eq '0') -and ([int]($_.version_version_value) -gt 10)) { Write-Output $_ }
    }

# when there are branches you could consider going 'manual selection' by
$p | Out-GridView -PassThru

Best wishes,
Dave

RE: In tridion docs, how to obtain user's name within the execution of WriteMetadataPlugin

Damian Jewett — Tue, 26 Aug 2025 19:48:59 GMT

Which version of Tridion Docs?

Have you tried using the Tridion Docs OpenAPI client from within your write plugin?

https://docs.rws.com/en-US/tridion-docs-main-documentation-1151795/openapi-web-services-samples-1159163

https://community.rws.com/product-groups/tridion/tridion-docs/b/weblog/posts/tridion-docs-openapi-how-to-make-the-first-call?CommentId=af926cf2-687d-4f2e-9b75-28cd6c9034d5&focus=true

We were able to retrieve user data when working with projects in one of our plugins. Pseudocode looked something like this:

projects = await tridionDocsClient.GetProjectListByProjectIdAsync(request);

...

fields = project["fields"];

foreach(field in fields)

{

value = field["value"];

if(value != null)

{

string userId = value["id"]?.ToString();

string name = value["title"]?.ToString();

In tridion docs, how to obtain user's name within the execution of WriteMetadataPlugin

Lihao Lei — Wed, 20 Aug 2025 09:08:58 GMT

Product: Tridion Docs 13.0.4630.2

When the user Jack is setting metadata of certain language object using desktop client, how does WriteMetadataPlugin capture the username Jack?

My situation: If Jack sets metadata (this metadata field is Language level) to certain language object, the WriteMetadataPlugin sets the same metadata to all language objects under the same GUID, but it causes recursive plugin calling, therefore I'm considering to distinguish from user-metadatasetting to plugin-metadatasetting, which requires capturing username.

(Given that the metadata field is not convenient to transformed into Logical level, nor convenient to set up a new Logical metadata field.)

How to use the API to get a list of publications with conditions set on them.

Akheil Jain — Fri, 13 Jun 2025 12:56:49 GMT

We are troubleshooting some issues in our 15.1.2 environment and are in need to find a list of publications which have conditions set on them vs. contain content with conditions. Couldn't figure out which field or class to use from the API to achieve this. TIA

RE: How to use the API to get a list of publications with conditions set on them.

Akheil Jain — Fri, 15 Aug 2025 16:37:07 GMT

Hi Dave, thank you for that information, it was very helpful in understanding the architecture of Docs. To clarify my question I tried to run a API call to GetMetadata on a publication object and specified FISHCONTEXTS as a requested field and received an error (Usage of Field "FISHCONTEXTS" during a "READ" action is not allowed. 108001; ActionProtectedField). This throws a wrench in my plan to get a list of all publication version objects which has conditions (FISHCONTEXTS field not empty).
TIA

Issue with publishing pubs with imported non-specialized topics and map via Oxygen Publishing Engine plugin. Tridion Docs 15.1

Mario Madunic — Fri, 20 Sep 2024 14:53:01 GMT

Tridion Docs 15.1

Oxygen Publishing Engine

Transtype: pdf-css-html5

I've been working with Oxygen's Publishing Engine in Tridion Docs. I have been able to publish the test content that comes with Tridion Docs (Safety Recall 2008 Sport 2...) to PDF (transtype pdf-css-html5). I imported some of our test content; a simple map with 3 topics, 2 pngs, and an svg. All imported no issue. However when I publish to transtype pdf-css-html5, the publish fails. (The test content publishes successfully when using transtype ishpdf.)

I get the following error in the dita-ot log:

gen-list:
 [gen-list] [DOTJ037W][WARN] The XML schema and DTD validation function of the parser is turned off. Please make sure the input is normalized DITA with class attributes included, otherwise it will not be processed correctly.
 [gen-list] Using Xerces grammar pool for DTD and schema caching.
 [gen-list] Processing file:/C:/InfoShare/Data/Publish/Data/4s1plusanpr/work/1/en/GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.ditamap
 [gen-list] Processing file:/C:/InfoShare/Data/Publish/Data/4s1plusanpr/work/1/en/GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.xml
Error: Failed to run pipeline: The entity -//SDL//DTD DITA Topic//EN / file:///C:/InfoShare/Web/Author/ASP/DocTypes/dita-sdl/1.3/dtd/technicalContent/dtd/sdlTopic.dtd cannot not be resolved through catalogs. For security reasons files that are not listed in the DITA-OT catalogs and are not located in the DITA-OT directory are not read. You can disable this restriction by setting "-Dargs.disable.security.checks=yes" in the command line or the Oxygen transformation configuration dialog, the "Advanced" tab, in the "JVM Arguments" text field. Make sure all the input files come from a trusted source.

The path to the dtd is correct. I've added the files at InfoShare/Web/Author/ASP/DocTypes/dita-sdl/1.3/dtd into a base plugin including the catalog, using an extension point. I reran dita --install to pick up them up and still getting the same issue.
What am I missing? Any pointers appreciated in resolving this.


 the topic
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE topic PUBLIC "-//SDL//DTD DITA Topic//EN" "topic.dtd"[]> <!-- Original file name: slide001.dita --><topic id="GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" xml:lang="en"> <title id="GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">Front Cover</title> <body> <fig> <image href="GUID-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" alt="" format="svg" /> </fig> </body> </topic>