{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"64333db5-997e-40f8-bcc8-597915c086ee"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"30b788a2-20b5-4669-86e1-6ed6d1425adc"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"What is Document Understand?","type":"text"}]},{"type":"paragraph","content":[{"text":"PIPEFORCE comes with a solution to automatically detect and extract data from a given (PDF) document using AI and displays those fields then on a form to the user. The user can then review and adjust the field values if required.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is especially useful for example for invoices in order to extract information from these PDF invoices and review them before they will be forwarded to the internal invoicing and approval process.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1097,"alt":"image.png","id":"a787301e-6a72-45a2-afe3-d8ea90d603f4","collection":"contentId-3251405184","type":"file","height":731},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]},{"type":"caption","content":[{"text":"The document understand review form in PIPEFORCE after a PDF invoice has been processed.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Currently PIPEFORCE supports Google Document Understand as AI backend to extract data from invoices as we had the best results with this while testing multiple solutions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In future we will extend this in a way, so also our built-in models and other providers can be used as well.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note: In production Google Cloud with location Germany (Frankfurt) is used. ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"How to execute it?","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to send a given PDF document to the Document Understand AI backend and to extract the required data, you can use the command ","type":"text"},{"text":"ai.document.understand","type":"text","marks":[{"type":"code"}]},{"text":" in your pipeline.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"}]},{"text":"The command alias ","type":"text"},{"text":"document.understand","type":"text","marks":[{"type":"code"}]},{"text":" can also be used the same way as ","type":"text"},{"text":"ai.document.understand.","type":"text","marks":[{"type":"code"}]},{"text":" depends on the version which one or both is supported.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This command will load the document, will validate the given understand config parameters, then sends the document and the instructions to the AI and finally returns a JSON response with the values extracted from the document which can be further processed in the pipeline.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example how to use this command in a pipeline:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - ai.document.understand:\n secret: DOCUMENT_UNDERSTANDING_GOOGLE\n provider: google\n input: $uri:drive:my-invoice.pdf\n config: {\n \"projectId\": \"my-project\",\n \"location\": \"de\",\n \"processorId\": \"3e05c9d1c5386f42\"\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"The parameters of the command are these:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"secret","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The name of the ","type":"text"},{"text":"secret","type":"text","marks":[{"type":"link","attrs":{"href":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545713210"}}]},{"text":" to be used to connect to the Document Understand AI backend.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"provider","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The AI backend to be used. There are different implementations possible:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"google","type":"text","marks":[{"type":"code"}]},{"text":" = Uses Google’s Document Understand cloud service (hosted in Germany if it is part of the enterprise plan).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = Uses a self-hosted AI model and the provided endpoint to solve this problem (coming soon). ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"input","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The input document to be send to the AI. Can be any ","type":"text"},{"text":"PIPEFORCE URI","type":"text","marks":[{"type":"link","attrs":{"href":"https://logabit.atlassian.net/wiki/spaces/PA/pages/3209068546"}}]},{"text":". If no ","type":"text"},{"text":"input","type":"text","marks":[{"type":"code"}]},{"text":" parameter is specified, the input document is expected in the body of the pipeline.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"config","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The configuration or prompt required by the AI backend to fulfill this document understand request and return the expected JSON. This configuration depends on the selected AI backend using the ","type":"text"},{"text":"provider","type":"text","marks":[{"type":"code"}]},{"text":" parameter. See the documentation of the provider. For Google Document Understand the parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"projectId","type":"text","marks":[{"type":"strong"}]},{"text":" = The Google Cloud project to be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"location","type":"text","marks":[{"type":"strong"}]},{"text":" = The location of the processor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"processorId","type":"text","marks":[{"type":"strong"}]},{"text":" = The pre-trained processor to be used for data extraction.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"How to review and approve the extracted data in a form?","type":"text"}]},{"type":"paragraph","content":[{"text":"In case you would like to let the Document Understand result review and approve by a human user, you can use forms and provide a review step in your app or workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"The first step is to create a form config and set ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"documentUnderstand","type":"text","marks":[{"type":"code"}]},{"text":" and the location to the ","type":"text"},{"text":"schema","type":"text","marks":[{"type":"code"}]},{"text":" as this example shows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n\t\"title\": \"Document Understand\",\n\t\"type\": \"documentUnderstand\"\n\t\"schema\": \"$uri:property:global/app/myapp/schema/document-understand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"In the next step create another JSON document, the schema for the document understand in order to configure the structure for the form and the mapping from document understand result fields to form fields.","type":"text"}]},{"type":"paragraph","content":[{"text":"See here an example of such a schema including the config section for field mapping:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"title\": \"Document Understand\",\n \"output\": \"...\",\n \"config\": {\n \"type\": \"invoice\",\n \"name\": \"My Invoice Field Detector\",\n \"fields\": [\n {\n \"id\": \"invoice_number\",\n \"mapping\": \"invoice_id\",\n \"label\": \"Invoice number\"\n },\n {\n \"id\": \"invoice_date\",\n \"mapping\": \"invoice_date\",\n \"label\": \"Invoice date\"\n },\n {\n \"id\": \"line_item\",\n \"mapping\": \"line_item\",\n \"label\": \"Invoice items\",\n \"columns\": [\n {\n \"id\": \"line_item/description\",\n \"mapping\": \"line_item/description\",\n \"label\": \"Description\"\n },\n {\n \"id\": \"line_item/quantity\",\n \"mapping\": \"line_item/quantity\",\n \"label\": \"Quantity\"\n },\n {\n \"id\": \"line_item/amount\",\n \"mapping\": \"line_item/amount\",\n \"label\": \"Amount\"\n }\n ]\n }\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"title","type":"text","marks":[{"type":"code"}]},{"text":" defines the header to be displayed when the form is shown. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" defines the type of document to be supported. This is by default ","type":"text"},{"text":"invoice","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"output","type":"text","marks":[{"type":"code"}]},{"text":" defines a PIPEFORCE URI where to write the final result JSON to after the form was confirmed.","type":"text"}]},{"type":"paragraph","content":[{"text":"The section ","type":"text"},{"text":"fields","type":"text","marks":[{"type":"code"}]},{"text":" defines the mapping of data fields extracted from the document to form fields. It is an array of JSON objects of these attributes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"The custom id of the form field and thus the name of the final JSON result. This can be any ASCII name. If not specified, the value of ","type":"text"},{"text":"mapping","type":"text","marks":[{"type":"code"}]},{"text":" attribute will be used by default.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mapping","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The id of the field coming from the Document Understand AI backend. See below the documentation of the backend about the available field id’s which can be extracted and their ids.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"label","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The label to be be displayed on the form field. If missing, the id will be used. This label can also be internationalized. See below.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Since this form feature is an optional add-on, make sure the secret ","type":"text"},{"text":"DOCUMENT_UNDESTANDING_GOOGLE","type":"text","marks":[{"type":"code"}]},{"text":" exists in your instance. If not, contact support.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Data fields ","type":"text"}]},{"type":"paragraph","content":[{"text":"By default the Google Document Understand AI backend is used (with server location in Germany) to extract data fields from documents. Below you can find a list of the most important fields which can be extracted from an invoice document using this AI backend. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c2b2df50-fe82-4e5d-9c79-ad6b49ea7ce0"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"Mapping Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"invoice_date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The date of the invoice","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"delivery_date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Date of delivery","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"invoice_id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Invoice number","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"purchase_order","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Invoice reference","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"receiver_name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Invoice recipient name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"receiver_address","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Invoice recipient address","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"ship_to_address","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"Shipment address","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"supplier_name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the supplier.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"supplier_iban","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The IBAN of the supplier.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"due_date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The due date of the invoice","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"net_amount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The invoice amount (net).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"total_amount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The total invoice amount.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"currency","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The currency used in the invoice.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"vat/tax_rate","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The tax rate used in the invoice.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"line_item","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"A single line item in the invoice.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"line_item/description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The description of the line item.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"line_item/quantity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The quantity of the line item.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[373.0]},"content":[{"type":"paragraph","content":[{"text":"line_item/amount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[387.0]},"content":[{"type":"paragraph","content":[{"text":"The amount of the line item.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For a full list of field mapping ids, see the invoice processor documentation: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cloud.google.com/document-ai/docs/processors-list#processor_invoice-processor"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You additionally add any of these fields into your fields mapping config as decribed in the example above.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"The output format","type":"text"}]},{"type":"paragraph","content":[{"text":"After the form was submitted, a JSON which contains the extracted fields and the document embedded as base64 will be created and stored at the location specified by the output path.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example of this outout document:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"fields\": {\n \"invoice_number\": \"12345\",\n \"invoice_date\": \"01.01.2024\",\n \"line_item\": [\n {\n \"line_item/description\": \"Some item\",\n \"line_item/quantity\": \"2\",\n \"line_item/amount\": \"13,99\"\n }\n ],\n ...\n },\n \"document\": {\n \"filename\": \"myinvoice.pdf\",\n \"contentLength\": 1234,\n \"contentType\": \"application/pdf\",\n \"contentEncoding\": \"base64\",\n \"content\": \"base64EncodedFileContent\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The field names will be the ","type":"text"},{"text":"field.id","type":"text","marks":[{"type":"code"}]},{"text":" as configured.","type":"text"}]},{"type":"paragraph","content":[{"text":"The document is a content reference JSON with the document data base64 encoded.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also see: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545320099"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Internationalizing Labels (i18n)","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to translate the labels of the form fields to different languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no ","type":"text"},{"text":"label","type":"text","marks":[{"type":"code"}]},{"text":" is given for a field, this label value will be used as default: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:document-understand/ ","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the id of the field. The UI expects this i18n key to exist. For example: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:document-understand/invoice_number ","type":"text"}]},{"type":"paragraph","content":[{"text":"In case the label starts with prefix ","type":"text"},{"text":"$uri:i18n:","type":"text","marks":[{"type":"code"}]},{"text":" then the value is replaced by the current i18n message key whereas the format of the i18n URI is this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"//","type":"text"}]},{"type":"paragraph","content":[{"text":"So ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" maps to the parameter ","type":"text"},{"text":"app","type":"text","marks":[{"type":"code"}]},{"text":" (optional), ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" (optional) maps to the ","type":"text"},{"text":"context","type":"text","marks":[{"type":"code"}]},{"text":" parameter of the command ","type":"text"},{"text":"i18n.message","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" maps to the the message key inside the JSON finally returned by the command. For example if user sets this label:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"label\": \"$uri:i18n:io.pipeforce.myapp/invoice/invoice_number\"","type":"text"}]},{"type":"paragraph","content":[{"text":"This would map to a message JSON which can be returned using the command ","type":"text"},{"text":"i18n.message?app=io.pipeforce.myapp&context=invoice","type":"text","marks":[{"type":"code"}]},{"text":". And inside this message JSON, the value of attribute ","type":"text"},{"text":"invoice_number","type":"text","marks":[{"type":"code"}]},{"text":" for the currently selected language will be returned:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"invoice_number\": \"Rechnungsnummer\",\n ...\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"If no ","type":"text"},{"text":" ","type":"text","marks":[{"type":"code"}]},{"text":"is given, ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" will be used by default.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is given, the context ","type":"text"},{"text":"default","type":"text","marks":[{"type":"code"}]},{"text":" will be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"So this example would expect the message entry ","type":"text"},{"text":"invoice_number","type":"text","marks":[{"type":"code"}]},{"text":" in a message JSON located in app ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" with context set to ","type":"text"},{"text":"default","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:invoice_number","type":"text"}]},{"type":"paragraph","content":[{"text":"And this will use the context ","type":"text"},{"text":"document-understand","type":"text","marks":[{"type":"code"}]},{"text":" inside the default app ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" (since the first part in the path is missing):","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:document-understand/invoice_number","type":"text"}]}],"version":1}

Browser not supported