# Copyright (C) 2012-2024 Zammad Foundation, https://zammad-foundation.org/ class TextModulesController < ApplicationController prepend_before_action :authenticate_and_authorize! =begin Format: JSON Example: { "id":1, "name":"some text_module", "user_id": null, "keywords":"some keywords", "content":"some content", "active":true, "updated_at":"2012-09-14T17:51:53Z", "created_at":"2012-09-14T17:51:53Z", "updated_by_id":2. "created_by_id":2, } =end =begin Resource: GET /api/v1/text_modules.json Response: [ { "id": 1, "name": "some_name1", ... }, { "id": 2, "name": "some_name2", ... } ] Test: curl http://localhost/api/v1/text_modules.json -v -u #{login}:#{password} =end def index model_index_render(TextModule, params) end =begin Resource: GET /api/v1/text_modules/#{id}.json Response: { "id": 1, "name": "name_1", ... } Test: curl http://localhost/api/v1/text_modules/#{id}.json -v -u #{login}:#{password} =end def show model_show_render(TextModule, params) end =begin Resource: POST /api/v1/text_modules.json Payload: { "name": "some name", "keywords":"some keywords", "content":"some content", "active":true, } Response: { "id": 1, "name": "some_name", ... } Test: curl http://localhost/api/v1/text_modules.json -v -u #{login}:#{password} -H "Content-Type: application/json" -X POST -d '{"name": "some_name","active": true, "note": "some note"}' =end def create model_create_render(TextModule, params) end =begin Resource: PUT /api/v1/text_modules/{id}.json Payload: { "name": "some name", "keywords":"some keywords", "content":"some content", "active":true, } Response: { "id": 1, "name": "some_name", ... } Test: curl http://localhost/api/v1/text_modules.json -v -u #{login}:#{password} -H "Content-Type: application/json" -X PUT -d '{"name": "some_name","active": true, "note": "some note"}' =end def update model_update_render(TextModule, params) end def search model_search_render(TextModule, params) end =begin Resource: DELETE /api/v1/text_modules/{id}.json Response: {} Test: curl http://localhost/api/v1/text_modules.json -v -u #{login}:#{password} -H "Content-Type: application/json" -X DELETE =end def destroy model_destroy_render(TextModule, params) end # @path [GET] /text_modules/import_example # # @summary Download of example CSV file. # @notes The requester have 'admin.text_module' permissions to be able to download it. # @example curl -u #{login}:#{password} http://localhost:3000/api/v1/text_modules/import_example # # @response_message 200 File download. # @response_message 403 Forbidden / Invalid session. def import_example csv_string = TextModule.csv_example( col_sep: params[:col_sep] || ',', ) send_data( csv_string, filename: 'text_module-example.csv', type: 'text/csv', disposition: 'attachment' ) end # @path [POST] /text_modules/import # # @summary Starts import. # @notes The requester have 'admin.text_module' permissions to be create a new import. # @example curl -u #{login}:#{password} -F 'file=@/path/to/file/Textbausteine_final2.csv' 'https://your.zammad/api/v1/text_modules/import?try=true' # @example curl -u #{login}:#{password} -F 'file=@/path/to/file/Textbausteine_final2.csv' 'https://your.zammad/api/v1/text_modules/import' # # @response_message 201 Import started. # @response_message 403 Forbidden / Invalid session. def import_start string = params[:data] if string.blank? && params[:file].present? string = params[:file].read.force_encoding('utf-8') end raise Exceptions::UnprocessableEntity, __('No source data submitted!') if string.blank? result = TextModule.csv_import( string: string, parse_params: { col_sep: params[:col_sep] || ',', }, try: params[:try], delete: params[:delete], ) render json: result, status: :ok end end