Exact Onlineの品目で画像を一括コピー

このトピックでは、Exact Online の記事(article)間で画像を一括コピーする方法について説明します。これは、Exact Online の記事に関連付けられた画像をディスク上の個別ファイルにエクスポートするトピックと関連していますが、このコードでは画像を別の記事に保存します。

各記事には、Articles ページに表示されるメイン画像が1つあります。例:

また、複数の画像をドキュメントとして関連付けることもできます。その場合は、ドキュメントの「Item」として関連する記事を指定するだけです。

Exact Online の REST API には、記事用の画像をインポートする既知のメソッドはありません。記事用の Exact Online REST API(Items、ItemsBulk、ItemsIncremental)は、Exact Online 上の URL、ファイル名、コンテンツタイプなどのサムネイル情報を(読み取り専用で)表示します。Exact Online の XML API には、記事に画像を添付するための XML <Image> タグが用意されています。

以下のコードは、次の手順を実行します:

  • 画像を持つソース記事(Exact Online API では Items と呼ばれます)の範囲を選択する。
  • 画像を表示すべきなのに画像がないターゲット記事を特定する。
  • ThumbnailByUrl テーブル関数を使用して画像を取得する。
  • 更新対象のすべての記事について、大きな XML アップロードを構築する。
  • UploadXMLTopics を使用して、1回の大きなアップロードで画像をアップロードする。
  • UploadXMLTopics は、必要に応じてペイロードを分割し、Exact Online の API レートおよびサイズの制限内に収まるようにします。

小~中サイズの画像を Exact Online にアップロードする場合の一般的な実行時間は、1秒あたり5枚の画像です。

--
-- 画像が欠けている箇所に画像をアップロードする。
--
create or replace table xmlupload@inmemorystorage
as
select 'item-pictures.xml' filename
,      to_char(t.division) division
,      'Items' topic
,      xmlformat
       ( '<?xml version="1.0" encoding="utf-8"?>'
         || '<eExact xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="eExact-XML.xsd">'
	     || '<Items>'
         || t.xml
	     || '</Items>'
         || '</eExact>' 
       )
       filecontents
from   ( select itmorig.division
         ,      listagg
                ( '<Item ID="{' || itmvar.id || '}" code="' || itmvar.code || '" >'
                  || '<Image>'
                  || xmlelement
                     ( 'Name'
                     , itmorig.code
                       || '.'
                       || case 
                          when tnlorig.ImageContentType = 'image/jpeg' 
                          then 'jpg'
                          else 'bin'
                          end 
                     )
                  || '<BinaryData>' || base64_encode(tnlorig.imagecontents) || '</BinaryData>'
                  || '</Image>'
                  || '</Item>'
                , ''
                ) xml
         from   ItemsBulk itmorig
         join   ThumbnailByUrl(itmorig.pictureurl) tnlorig
         join   ItemsBulk itmvar
         on     itmvar.division = itmorig.division
         --
         -- 関連する記事を見つける。
         --
         and    itmvar.code like itmorig.code || '_%'
         --
         -- ターゲットのアイテムにはまだ画像がない。
         --
         and    itmvar.PictureName is null
         --
         -- ソース記事には画像がある。
         --
         where  itmorig.PictureName is not null
         --
         -- ソースを見つけるためにいくつかのフィルターを適用する。
         --
         and    itmorig.code = 'MYSOURCEARTICLE'
         group
         by     itmorig.division
       ) t

次に、大きな XML がアップロードされ、UploadXMLTopics の組み込みロジックによって約1MBずつのフラグメントに自動的に分割されます:

insert into UploadXMLTopics
( topic
, payload
, division_code
, orig_system_reference
, fragment_payload_flag
, fragment_max_size_characters
, fail_on_error
)
select topic
,      filecontents
,      division
,      filename
--
-- 最大1MB単位に分割を試みる。
--
,      true fragment_payload_flag
,      1000000 fragment_max_size_characters 
,      true fail_on_error
from   xmlupload@inmemorystorage
order 
by     division
,      filename

最後に、結果を確認します(fail_on_error が false の場合のみ必要です):

--
-- すべてが Exact Online に正しく読み込まれたことを確認する。
-- success = false となる行があってはならない。
--
select *
from   UploadXMLTopicFragments